LearnUmbraco7

KO | EN

gitlite — search

#javascript #hacktoberfest #react #typescript #golang #android #machine-learning #rust #linux #cli #vue #awesome-list #openai #open-source

(★ 205)

A book for developers

File Explorer

Download Latest Version (.zip)

- 7377960988_7c087be22e_o.jpg
- content.jpg
- - 4372945716_0cecd1e8c2_o.jpg
  - 9026576438_2b6993f317_o.jpg
- 01 - Developer Tools.md
- README.md
- - 15101926851_bd53bbf155_o.jpg
  - 15930521975_013c7c300d_o.jpg
  - 9024347315_8f5df45da8_o.jpg
  - codegarden.png
  - our.png
  - skrift.png
  - uhangout.png
  - umbtv.png
  - uwestfest.png
- 01 - Core Team.md
- 02 - Community.md
- README.md
- - 8656703331_63be55c15c_o.jpg
  - backoffice.png
  - context-menu.png
  - developer.png
  - mediasection.png
  - members.png
  - rte-formats.png
  - rte-styles.png
  - settings-dictionary.png
  - settings-stylesheets.png
  - settings-templates.png
  - users.png
- 01 - Content Section.md
- 02 - Media Section.md
- 03 - Settings Section.md
- 04 - Developer Section.md
- 05 - Users Section.md
- 06 - Members Section.md
- README.md
- - 9024299167_a34d0645ff_o.jpg
  - datatypes.png
  - doctypes.png
  - doctypes2.png
- 01 - Document Types.md
- 02 - Data Types.md
- 03 - Templates.md
- 04 - Mapping a Doctype to a Custom Model.md
- README.md
- - 5838817600_1da1563821_o.jpg
- 01 - IPublishedContent.md
- 02 - IContent.md
- README.md
- - 5852022211_66215f281b_o.jpg
- 01 - ApplicationContext.md
- 02 - UmbracoContext.md
- 03 - DatabaseContext.md
- 04 - UmbracoHelper.md
- 05 - Content Service.md
- 06 - Content Type Service.md
- 07 - Data Type Service.md
- 08 - Media Service.md
- 09 - Member Service.md
- 10 - Member Type and Member Group Services.md
- 11 - IOHelper.md.md
- 12 - LogHelper.md
- 13 - File Service.md
- 14 - Other Services.md
- README.md
- - 7406995468_f8571506c6_o.jpg
- 01 - RenderMVC Controllers.md
- 02 - Surface Controllers.md
- 03 - WebAPI Controllers.md
- README.md
- - 3653781374_ee4a82dbde_o.jpg
- 01 - Integrating Umbraco with MVC Forms.md
- README.md
- - 13391630085_c499d63302_o.jpg
  - custom-errors.png
- 01 - Custom Error Setup.md
- README.md
- - 8128163522_b9b703092e_o.jpg
  - examine-complex.png
  - examine-events.png
  - examine-rebuild.png
  - examine-search-tool.png
  - munged.png
- 01 - Built-in Functionality.md
- 02 - Search Results.md
- 03 - Debugging with Luke.md
- 04 - Custom Data Sources.md
- README.md
- - 9026574602_d1d9d142bb_o.jpg
  - archetype.png
  - diplo-log.png
  - merchello.png
  - nuget.png
  - package-install.png
- 01 - Core Property Value Converters.md
- 02 - uSync.md
- 03 - Archetype.md
- 04 - Merchello.md
- 05 - Courier.md
- 06 - Diplo Trace Viewer.md
- 07 - Azure Blob Storage Provider.md
- README.md
- - 7377957044_76c6714b63_o.jpg
  - editorState.png
  - entityResource.png
  - hidetab.png
  - notification-success.png
- 01 - Manifest.md
- 02 - The View and Directive.md
- 03 - AngularJs Umbraco Services and Resources.md
- 04 - URL Picker Property Editor.md
- 05 - More Than Property Editors.md
- 06 - Interceptors.md
- README.md
- - 13391452355_aed8eb7c54_o.jpg
  - domain-menu.png
  - domain-setup.png
  - multisite.png
- 01 - Domain Setup.md
- 02 - Using Sub-folders for Templates.md
- README.md
- README.md
- x - Do not abuse UrlRewriting.config.md
- x - Organizing Content in the Tree.md
- x - Organizing Document Types for Inheritance.md
- x - Use Value Converters.md
- - 14471765193_4a71215629_o.jpg
- 01 - Request Pipeline.md
- 02 - Alternate Templates.md
- README.md
- - 14918466648_e510fd420d_o.jpg
- 01 - Event Registration.md
- README.md
- - 13391598663_b2f0f68f87_o.jpg
  - custom-section-plugins.png
  - custom-section.png
  - menu-actions.png
- 01 - Create a Section.md
- 02 - Create a Tree.md
- 03 - Custom Tree Menu Actions.md
- 04 - Custom IAction.md
- README.md
- - 14428541106_9e3d6e049b_o.jpg
  - republishsite.png
- README.md
- - 7406997008_836c445ff9_o.jpg
  - package-create.png
- 01 - Built-In.md
- 02 - Create a NuGet Package.md
- README.md
- - 7371138442_630c24b8b1_o.jpg
  - hockey-puck.png
  - image-cropper.png
  - pagination.png
- 01 - PagedList.md
- 02 - Sitemap.md
- 03 - RSS.md
- 04 - Custom Membership Providers.md
- 05 - Image Processor.md
- 06 - Global.asax.md
- 07 - Slack Integrations.md
- README.md
- - 14434411872_fd5c69b77c_o.jpg
  - azure.png
  - topology.png
- 01- Slots.md
- 02 - Azure Configuration.md
- 03 - File System Provider.md
- 04 - Fixing Image Processor with Umbraco.md
- 05 - Wiring Up Image Processor Cache.md
- README.md
- - 16397177094_574e2f4ef1_o.jpg
  - iis-install.png
- README.md
- README.md
- - 14435732345_b3d6799cff_o.jpg
  - extensions.png
  - root.png
  - solution-explorer.png
  - src.png
  - umbraco.png
  - Umbraco7InstallPage1.png
  - Umbraco7InstallPage2.png
  - VisualStudioNewProject.png
  - VisualStudioNewProjectStep2.png
- 01 - Anatomy of an Umbraco Project.md
- README.md
- - 15744504499_2439978fe4_o.jpg
  - slowcheetah.png
- 01 - Web.Config.md
- 02 - UrlRewriting.config.md
- 03 - Applications.config.md
- 04 - Trees.config.md
- 05 - Dashboard.config.md
- 06 - FileSystemProviders.config.md
- 07 - Log4Net.config.md
- 08 - UmbracoSettings.config.md
- 09 - Others.md
- 10 - Environment Specific Configs.md
- README.md
- - 16683508582_3ca71d1946_o.jpg
  - git-extensions.png
  - issues.png
- 01 - Terms.md
- 02 - Branching.md
- 03 - gitignore.md
- 04 - Git Extensions.md
- 05 - Contribute to a Project.md
- 06 - Command Line.md
- README.md
- - 14272076400_cc38812b9a_o.jpg
- README.md
- - 14451635585_a9830652f7_h.jpg
- README.md
.gitignore
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Learn Umbraco 7

![7377960988_7c087be22e_o.jpg](https://raw.githubusercontent.com/kgiszewski/LearnUmbraco7/master/assets/7377960988_7c087be22e_o.jpg)
>Photo by: Doug Robar

**This project is at a stopping point. Pull requests still taken.**

**Umbraco 8 is now available, for further information please visit: https://umbraco.com/**

## Not Official
This repo started as a side project to get some co-workers up to speed on Umbraco as told through another developers point of view limited to the scope of version 7.  The official documentation is located here: https://github.com/umbraco/Umbraco4Docs and should be used as the source of truth.  The official documentation covers other versions of Umbraco as well as version 7.

*Learn Umbraco 7* is a crowd authored book with the purpose of onboarding new Umbraco developers for free.  This book isn't intended to be a resource guide, please refer to the official Umbraco documentation for that.  This book is a narrative of different topics in the Umbraco 7 realm.

This book is downloadable despite not being complete. It's completeness is hovering around 90% and is updated as new features of Umbraco 7 are released.  Please consider writing a section :)  You can find the TODO list here: https://github.com/kgiszewski/LearnUmbraco7/issues

You can view this book right inside the Umbraco 7 backoffice using [Umbraco Bookshelf](https://our.umbraco.org/projects/backoffice-extensions/bookshelf).  You can also install Bookshelf with [NuGet](https://www.nuget.org/packages/UmbracoBookshelf/).

## Target Audience
This book is targeted for readers who:

* Have developed web applications in other languages
* Have little or no experience with Umbraco
* Have some experience with .NET
* Have some experience with the client languages Javascript, HTML and CSS
* Need help in deciding whether to take the plunge into Umbraco

This book is not intended for readers who:

* Have no web developing experience
* Are looking for an editor (user) perspective

## Targeted Skills and Technology
* Installation of developer tools: Visual Studio Web Express
* Installation of Umbraco via NuGet
* Installation and development of plugins
* Common Umbraco Patterns
* Common Umbraco Anti-patterns
* Client languages and frameworks: HTML, Javascript, CSS, AngularJs, Underscore.js
* Server languages and frameworks: C#, ASP.NET, MVC
* Data: SQL CE, MSSQL Express and SSMS
* Hosting: Internet Information Services (IIS), Win Server

## A video to get you started!

Click the image below to begin a series of videos to get you immersed into the Umbraco backoffice!

[![Get started video](https://raw.githubusercontent.com/kgiszewski/LearnUmbraco7/master/assets/content.jpg)](https://youtu.be/bwqZ5b_ZVKo)

## License
Content in this repository is freely available to read and use for non-commercial uses. It may not be reproduced or used for commercial use without consent. All rights are reserved and copyrighted by the contributors.  All images and files are copyrighted by their respective owners.  All logos are trademarked by their respective owners.  Please seek permission to use before using any materials for any other purposes.

## Contribute
If you wish to contribute to the book, you may do so by submitting a pull request to this repository. You can send us a simple spelling correction, a section or even an entire chapter. By contributing you agree in full to the Contributor Agreement described below.

## Contributor Agreement
The purpose of this book is to provide free information to those who want to know. By submitting any content, you affirm and agree the following:

* The contribution is completely original and not taken from any source from which you do not possess the copyright 
* You agree to allow your contribution to be used for any purpose by the repository owners in a non-commercial way

## Style Guide

#### Structure
The structure of this books is the following:

* `Chapter` - Chapters are folders named as `{Chapter Number} - {Chapter Name}` 
    * `Section` - A section is a markdown file named as `{Section Number} - {Section Name}.md`
    * `Assets` - A folder for media (to hold images/pdfs for this chapter) named as `assets`
    * `Readme.md` - All folders are required to have one and this serves as an overview page

#### Do Use Markdown
Everything should be written in markdown and not HTML.  If you are not familiar with markdown, please use these references:

* https://help.github.com/articles/markdown-basics/
* https://help.github.com/articles/github-flavored-markdown/

#### Do Use Root Relative, Current Relative or External Links
Use links that are rooted from the top level like so `[click me](/LearnUmbraco7/01%20-%20Chapter%200/readme.md)`.

#### Do Not Use Relative Paths with Double Dots
These type of links `[click me](../01%20-%20Chapter%200/readme.md)` are useful normally, but create a security issue when downloaded into things like [Umbraco Bookshelf](https://github.com/kgiszewski/UmbracoBookshelf).
>Side note, Umbraco Bookshelf ignores these types of links.

#### Do Split Things Up
Try to split chapters into logical sections.

#### Do Use the Assets Folder
Each chapter has an `assets` folder where your pdf and image files should go.

When linking assets, use relative paths like `![my image](https://raw.githubusercontent.com/kgiszewski/LearnUmbraco7/master/assets/myimage.png)`.

#### Do Use Blockquotes for Callouts
Need to call something out?  Use a blockquote.

#### Do Use Code Literals and Namespaces
Use code blocks when showing code.  Always include namespaces for C#.

## So what should you contribute?
Each chapter and section has TODO lists associated with them as well as general outlines of future content. Feel free to tackle any of those or submit other TODOs.  Here are some other examples of what you can contribute:

* Sample Code
* Diagrams
* Photos from the Umbraco World
* Editing by reading, correcting and clarifying; if it's wrong say so :)

Each person that has been assimilated into Umbraco has a unique opportunity to contribute in some way.  We have a TODO list here: https://github.com/kgiszewski/LearnUmbraco7/issues

## A Note to Grammar Nazis
Writing narrative text is not our best skill so if you see an issue with overall organization, grammar, spelling and/or other issues; we expect a pull-request to fix the issues :)

LearnUmbraco7

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

LearnUmbraco7

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README