16 December, 2011

Localization in Umbraco, Item Page field localization




Umbraco is one of the most deployed Web Content Management Systems on the Microsoft stack. It's in the top five most popular server applications and among the ten most popular open source tools in general.

You can directly download and start using it from http://www.umbraco.com

If you have not used the application yet, its always worth trying it once. I am sure you will love it.

Well, for the first time users, Umbraco provide step by step instruction for initial set up, once you are done you can use some sample template or create a blank website.


To know more on umbraco, Please refer below links
http://our.umbraco.org/wiki/how-tos/a-complete-newbie's-guide-to-umbraco
http://umbraco.com/help-and-support/video-tutorials/getting-started?freeVideos=1
http://our.umbraco.org/wiki/how-tos/getting-started-with-umbraco-what-is-next-after-you-install
http://our.umbraco.org/wiki/install-and-setup


I have created a blank website, Now we will go step by step.

  • First create the home page template.

  • I created the document type with same name, and some properties, like, Page title, and page content, with two tabs, one for English and one for Malayalam
  • Now you are Good to go for localization, but with few changes in your properties, You can insert the page field of your property using umbraco page field utility.
                      <umbraco:Item field="pageTitle" runat="server" />

  • To apply the localization on fields, we have to customize our on item field as below, 
    • Write a class Item by implementing umbraco.presentation.templateControls.Item
  public class Item : umbraco.presentation.templateControls.Item
    {
        [Bindable(true)]
        [Category("Umbraco")]
        [DefaultValue("")]
        [Localizable(true)]
        public new string Field
        {
            get
            {
                return base.Field;
            }
            set
            {
                umbraco.cms.businesslogic.web.Document objCurrentDocument = new umbraco.cms.businesslogic.web.Document(umbraco.NodeFactory.Node.GetCurrent().Id);
                string locale = Utils.GetLanguageCode(HttpContext.Current.Request["locale"]);
                if (locale == "ENG")
                {
                    locale = "";
                }
                else
                {
                    locale = "_" + locale;
                }
                string sNewField = string.Format("{0}{1}", value, locale);
                if (objCurrentDocument.getProperty(sNewField) != null && objCurrentDocument.getProperty(sNewField).Value != null && !string.IsNullOrEmpty(objCurrentDocument.getProperty(sNewField).Value.ToString()))
                {
                    value = sNewField;
                }
                base.Field = value;
            }
        }
    }
  • Register this class on the template as below 
    <%@ Register Assembly="site" Namespace="site.UmbracoUsercontrols"
    TagPrefix="Cumbraco" %>
  •  Well, Now you can directly use the utility  as below.
<title><Cumbraco:Item field="pageTitle" runat="server" /></title>
  •  Now we can create  home page as below content 
 
The localized page can be seen as below
Umbraco one of the fastest growing platforms for building websites. I suggest to just use it, I am sure you will love it.

0 comments:

Post a Comment