Umbraco User's Guide

The first guide to show you how to power your site using Umbraco.

More companies are turning to the power and simplicity of Umbraco's web content management system to build robust, customized sites. Written by leaders in the Umbraco community, this invaluable guide takes you through every aspect of this open source tool. Code samples using XHTML, CSS, XSLT, and C# are integrated throughout the pages to illustrate key concepts that you can apply. As you work through the chapters, you'll progress from building a basic Umbraco site to a sophisticated one that meets the needs of your organization.

Umbraco User's Guide:

• Explains how to install Umbraco and walks you through its XML structure

• Discusses how to create templates while building your understanding of layouts

• Offers best practices for developing content, designing types, organizing templates, and using the rich text editor

• Walks you through XSLT and .NET controls

• Helps you build sample applications and troubleshoot any issues that arise

• Covers how to create your own classified ads site by combining document types, templates, styles, macros, and more

Auteur

Nik Wahlberg is the founder of Scandia Consulting, a full-service consultancy specializing in custom web application development. He is a Level 2 Certified Umbraco Professional. Paul Sterling is a member of the Umbraco Core Team and the creator of the Umbraco Store. He is also the founder of the Commerce for Umbraco open source project. Wrox guides are crafted to make learning programming languages and technologies easier than you think, providing a structured, tutorial format that will guide you through all the techniques involved.

Résumé
The first guide to show you how to power your site using Umbraco. More companies are turning to the power and simplicity of Umbraco's web content management system to build robust, customized sites. Written by leaders in the Umbraco community, this invaluable guide takes you through every aspect of this open source tool. Code samples using XHTML, CSS, XSLT, and C# are integrated throughout the pages to illustrate key concepts that you can apply. As you work through the chapters, you'll progress from building a basic Umbraco site to a sophisticated one that meets the needs of your organization.

Umbraco User's Guide:

• Explains how to install Umbraco and walks you through its XML structure
• Discusses how to create templates while building your understanding of layouts
• Offers best practices for developing content, designing types, organizing templates, and using the rich text editor
• Walks you through XSLT and .NET controls
• Helps you build sample applications and troubleshoot any issues that arise
• Covers how to create your own classified ads site by combining document types, templates, styles, macros, and more

Contenu

Introduction xxi

Part I: Creating Your First Site With Umbraco

Chapter 1: Installing for the First Time 3

Installing Umbraco 3

Installing Umbraco using the Microsoft Web Platform Installer 4

Installing Umbraco Manually 12

Tips for Installing Umbraco in Special Environments 18

Debugging in a Development Environment 18

Security Settings in a Production Environment 19

Other Installation Scenarios 19

Upgrading Umbraco 19

Performing a Patch Upgrade 19

Performing a Version Upgrade 21

Utilizing Umbraco Starter Kits 21

Installing a Starter Kit 22

Simple Starter Kit 23

Blog Starter Kit 24

Personal Starter Kit 24

Business Starter Kit 24

Extending the Starter Kits 24

Applying and Manipulating Umbraco Skins 25

Customizing a Skin 26

Modifying a Simple Umbraco Skin 27

Finding and Installing Umbraco Modules 29

Take Home Points 30

Chapter 2: The Umbraco Approach 31

Separating Content and Structure 32

Understanding the Umbraco Backoffi ce Structure 32

Creating a User with Restricted Access 33

Umbraco Content Tree 35

Umbraco Building Blocks 37

Users 42

Functions and Properties 42

User Types 44

Setting Up a New Dictionary Label 44

Permissions 45

Setting Up a User for Access to Multiple Start Nodes 46

Media 47

Settings 49

Developer 50

Members 50

Creating a Member Group 51

Creating a Member Type 52

Translation 52

Take Home Points 53

Chapter 3: Document Types 55

The Data Model 56

Flexible Content Structure 57

Creating a Document Type 57

Restricting the Type of Content 62

Using Parent Document Types 64

Working with Document Types Outside of Umbraco 67

Exporting a Document Type 67

Importing a Document Type 68

Exporting Document Types as Plain Old CLR Objects 68

Using Document Type Properties 70

Built-in Properties 70

Properties with Special Meaning 71

Take Home Points 72

Chapter 4: Templates, Markup, and Master Pages 73

Building Website Structure using Templates 74

How Templates Build Layout and Structure 74

Creating Templates With Umbraco 76

Defining Markup 78

Creating Markup Using the Umbraco UI 78

Creating the Master Base Template 79

Creating the Textpage Template 80

Populating the Placeholder for the Textpage.Master File 81

Using Special Umbraco Tags 82

Applying the Template 85

Nesting and Inheritance with ASP.NET Master Pages 86

Umbraco and Your Markup 88

You Get What You Put In A Good Thing 88

Using AltTemplate 89

Changing the Document Type using AltTemplate 89

The No Template Effect 92

Styles and Scripts 94

Defining Your Styles 94

Layout and Organization 94

Handling Images 99

Styles and the Rich Text Editor 99

Using Scripts 102

Take Home Points 103

Chapter 5: Using Macros 105

Introduction to Umbraco Macros 105

Macro Parameters 108

Rendering Macros In Your Site 110

XSLT Powered Macros 111

About XSLT 111

Using the Built-in XSLT Templates 112

Creating an XSLT Macro 116

Using XSLT Extensions to Make Macros Richer 118

Going Further with XSLT 121

Output an Image from the Media Library 121

Grouping Output by Date 124

.NET User Controls 128

Support for the .NET DLR 129 IronPython 129<...