Datasheet

Finding and Installing Umbraco Modules

<umbraco:Macro Alias=”RunwayTopNavigation” runat=”server” />

</div>

</asp:contentplaceholder>

In this way an Umbraco skin can insert the HTML needed to achieve the desired styling without

affecting the function of the starter kit site in any way.

Typically, a skin should only change the CSS and related images and script for a site. If needed, a

skin may also change small snippets of HTML, such as to add an ID to an HTML element or cre-

ate a new

<div> for layout control. In this way, skins are kept as independent of a starter kit site’s

markup as possible and maintain maximum ﬂ exibility. A skin may also introduce a unique set of

scripts, generally JavaScript, to add functionality related to the skin. In addition, a skin may include

images used for layout and styling.

FINDING AND INSTALLING UMBRACO MODULES

Umbraco modules are small pieces of functionality that are compatible with the Umbraco starter

kits and are open-source licensed so that you may change the way the modules work if you

want. When you install an Umbraco starter kit, such as the Simple starter kit, some modules are

installed for you. The top navigation, contact form, and feed viewer are all examples of Umbraco

modules.

Umbraco modules are simply Umbraco macros speciﬁ cally designed to work seamlessly with

Umbraco starter kits. The modules may have dependencies on speciﬁ c starter kit markup, such

as an HTML element

id or a content placeholder id. In most cases, you can also use Umbraco

modules with Umbraco sites that are not based on Umbraco starter kits. Most Umbraco modules

are created without compiled code, which allows you to investigate the module or to alter it for

your own speciﬁ c use. Some modules use XSLT, which you can ﬁ nd in the

/xslt/ folder in your

Umbraco site’s root. Other modules use ASP.NET, generally C#, code, which is either in the

/app_code/ or /usercontrols/ folder in your Umbraco site’s root.

Some Umbraco modules are installed when you install an Umbraco starter kit.

You can install Umbraco modules directly from the Umbraco Skin editor. When working with the

Skin editor for an Umbraco starter kit, do the following:

1. Click the Insert Module button from the toolbar. A list of available modules appears as

shown in Figure 1-27.

2. Select a module and then click the area on the page labeled with Module Placeholder where

you want to locate the module.

c01.indd 29c01.indd 29 4/16/2011 2:34:28 PM4/16/2011 2:34:28 PM