A book for developers
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Chapter 0 GitHub changed how they handle things :( Sep 5, 2017
Chapter 01 - Welcome to the World of Umbraco 7 Update 01 - Core Team.md Sep 5, 2017
Chapter 02 - Backoffice Orientation Update 03 - Settings Section.md Apr 12, 2018
Chapter 03 - Document Types, Templates and Data Types Update 01 - Document Types.md Oct 24, 2017
Chapter 04 - Get and Set Content Programattically in Umbraco Fixed spaces and %20s Sep 30, 2017
Chapter 05 - Helpers, Contexts and Service API's Fixed spaces and %20s Sep 30, 2017
Chapter 06 - Surface, WebAPI and RenderMVC Controllers GitHub changed how they handle things :( Sep 5, 2017
Chapter 07 - Forms GitHub changed how they handle things :( Sep 5, 2017
Chapter 08 - Custom Errors GitHub changed how they handle things :( Sep 5, 2017
Chapter 09 - Searching with Examine Update 01 - Built-in Functionality.md Oct 7, 2017
Chapter 10 - First and Third-Party Packages Update 01 - Core Property Value Converters.md Apr 17, 2018
Chapter 11 - Working with AngularJs for Customizing the Backoffice Merge pull request #56 from duymon178/patch-4 Apr 18, 2018
Chapter 12 - Multisite Configuration Update README.md Jan 25, 2018
Chapter 13 - Patterns and Anti-patterns Fixed up some more markdown headers: #46 May 29, 2017
Chapter 14 - Request Routing GitHub changed how they handle things :( Sep 5, 2017
Chapter 15 - Umbraco Event Handling GitHub changed how they handle things :( Sep 5, 2017
Chapter 16 - Custom Sections, Trees and Actions GitHub changed how they handle things :( Sep 5, 2017
Chapter 17 - Troubleshooting Update README.md Oct 7, 2017
Chapter 18 - Creating a Package GitHub changed how they handle things :( Sep 5, 2017
Chapter 19 - Extras Fixed spaces and %20s Sep 30, 2017
Chapter 20 - Azure GitHub changed how they handle things :( Sep 5, 2017
assets Add files via upload Oct 26, 2017
z-Appendix A - Installing IIS Used a regex to programmatically fix all markdown headers: #46 May 29, 2017
z-Appendix B - Installing Visual Studio Express Used a regex to programmatically fix all markdown headers: #46 May 29, 2017
z-Appendix C - Installing Umbraco Update README.md Sep 5, 2017
z-Appendix D - Config Files Fixed spaces and %20s Sep 30, 2017
z-Appendix E - GitHub Fixed spaces and %20s Sep 30, 2017
z-Appendix F - Node.js Used a regex to programmatically fix all markdown headers: #46 May 29, 2017
z-Appendix G - Installing SQL Server Used a regex to programmatically fix all markdown headers: #46 May 29, 2017
.gitignore Add .gitignore and change overview.md's to readme.md's Mar 3, 2015
README.md Update README.md Oct 26, 2017

README.md

Learn Umbraco 7

7377960988_7c087be22e_o.jpg

Photo by: Doug Robar

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

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. You can also install Bookshelf with NuGet.

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

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:

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.

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](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 :)