Umbraco Gems, Hints and Tips

By Adam Perry, 6/24/2008

Rating

• &nbps;
• 1
• 2
• 3
• 4
• 5

Description

Having only used Umbraco for a couple of weeks, it was great to have the opportunity to attend the Codegarden event. This was an opportunity to meet other developers and to learn about Umbraco.

It was also an opportunity to pick up some helpful hints and tips, which I’ve documented here.

Download

Download item
Downloaded 185 time(s).

Comments

• Adam Perry says:

  This doesn't work as its an RTF file; when you download it, you get a file with "name.rtf.html"
  
  Here is a text only version.

  Adam Perry attached a file to this comment: download or viewControl your URLs It is possible to override the default url generated by Umbraco (based on the document Name).  To do this, you must add a field named “umbracoUrlName” (of data type “Textstring” to your Document Type). When entering/editing content, the value entered for “umbracoUrlName” will be used to create the filename portion of the URL (”filename.aspx”). Multiple URLs for the same document If you add a field named “umbracoUrlAlias” to the Document Type, this can be used to specify alternative URLs for a document.  Again, this field should have the “Textstring” datatype.  Multiple aliases can be specified - they can be comma-separated. Tokens in Templates Umbraco allows you to specify tokens when passing information to Macros within templates.  Tokens are then replaced at runtime with suitable content. Tokens are placed inside square brackets [...].  The tokens which were discussed were: [#pageID]
This token will be replaced with the ID of the current page. [#key]
Pull the dictionary item with the specified key [@name]
return the value of Request(name); for example, from either the query string or from a POST request [%name]
return a value from Session.  Session information can be set using XSLT if required, using the umbraco library functions.  For example,
<xsl:variable name="sessionVar" select="umbraco.library.setSession('name','value')" /> [$recursive]
returns the value of a field named “recursive”.  If this field is not found, or is empty, Umbraco will search for a parent document which has a field named “recursive” which is not empty. Recursive Fields When inserting a field into a template, the dialog has a “Recursive” check box.  If this is ticked, the [$recursive] functionality described above is activated: If this field is not found, or is empty, Umbraco will search for a parent document which has a field named “recursive” which is not empty. Struggling with XSLT? Take a peek at the Umbraco XML file You can view the XML which is parsed by the XSLT processor.  Simply locate the “data/umbraco.config” file on the Umbraco IIS server.  This can be used to develop and even debug XSLT in Visual Studio. umbracoNaviHide Many XSLT functions and templates refer to a document property called “umbracoNaviHide”.  If you include this property (as a true/false data type) in your documents, you can hide the document/content node from XSLT queries which adhere to this convention. Multiple Domains You can have multiple domains point to the same Umbraco site.  Right-Click on the site root node, choose Copy, and tick the “Relate” check box.  The copied site can then be associated with a different domain name.  Updates to the copy/original site will be mirrored in the original/copied site. Multilingual Sites Insert an Umbraco field into a template.  The name of the field should begin with the ‘#’ character.  The rest of the field name will be treated as a dictionary key, and the dictionary value will be used in place of the field. Scheduled Tasks Scheduled tasks can be configured by editing the web.config file.  This will cause a particular aspx page to be executed at a regular interval. Insert Images without using XSLT It is possible to insert images without using XSLT! Unfortunately, my notes on this one turned out to be innaccurate.  So I asked the guys on the Umbraco forum for help and this is what they came up with: <img src='<umbraco:Item field="umbracoFile" nodeid="1072" runat="server"></umbraco:Item>' /> It should also be possible to use “insertTextBefore” and “insertTextAfter”, however this is not currently working on my copy of Umbraco v4.  The modified syntax would then be: <umbraco:Item field="umbracoFile" nodeid="1072" insertTextBefore="<img src='" insertTextAfter="' />" runat="server"></umbraco:Item>