A handy helper method and class for you

Getting related links from an umbraco page can be quite tricky, especially if you want to get them in the controller.

This post gives you a handy little helper method to turn your related links property into a C# class object to make it easier to work with.

using System.Collections.Generic;
using Umbraco.Core.Models;
using Newtonsoft.Json.Linq;
using Umbraco.Web;
namespace CodeShare.Library.RelatedLinks {     public class RelatedLink     {         public string Text { get; set; }         public string Url { get; set; }         public bool NewWindow { get; set; }         public string Target { get { return NewWindow ? "_blank" : null; } }
        public RelatedLink(string text, string url, bool newWindow)         {             Text = text;             Url = url;             NewWindow = newWindow;         }     }
    public static class Helper     {         public static List<RelatedLink> GetRelatedLinks(IPublishedContent contentItem, string propertyAlias)         {             List<RelatedLink> relatedLinksList = null;             UmbracoHelper uHelper = new UmbracoHelper(UmbracoContext.Current);             IPublishedProperty relatedLinkProperty = contentItem.GetProperty(propertyAlias);
            if (relatedLinkProperty != null && relatedLinkProperty.HasValue && relatedLinkProperty.Value.ToString().Length > 2)             {                 relatedLinksList = new List<RelatedLink>();                 JArray relatedLinks = (JArray)relatedLinkProperty.Value;
                foreach (JObject linkItem in relatedLinks)                 {                     string linkUrl = (linkItem.Value<bool>("isInternal")) ? uHelper.NiceUrl(linkItem.Value<int>("internal")) : linkItem.Value<string>("link");                     bool newWindow = linkItem.Value<bool>("newWindow");                     string linkText = linkItem.Value<string>("caption");                     relatedLinksList.Add(new RelatedLink(linkText, linkUrl, newWindow));                 }             }
            return relatedLinksList;         }     } }

Here is how you can use it in your code.

using CodeShare.Library.RelatedLinks;

List<RelatedLink> relatedLinks = Helper.GetRelatedLinks(CurrentPage, "yourRelatedLinksPropertyAlias");

You will then have a link of RelatedLink objects giving you access to the properties on it such as Text, Url, NewWindow and Target.

If you find it useful, please bookmark and share this post.

Want to thank me?

If I've helped you out and you want to thank me, why not buy me a coffee?

About the author

Paul Seal

Umbraco MVP and .NET Web Developer from Derby (UK) who specialises in building Content Management System (CMS) websites using MVC with Umbraco as a framework. Paul is passionate about web development and programming as a whole. Apart from when he's with his wife and son, if he's not writing code, he's thinking about it or listening to a podcast about it.

Related Posts

How to ignore a file locally in git without ignoring it from the repository

This post shows you how you can ignore a file in git locally without ignoring it from the repository…

Read Post

How to get the picked item name in Stacked Content and Nested Content using ncNodeName

This post shows you how you can get the name of the picked item in Nested Content or Stacked Content…

Read Post

How I use source control for my Umbraco website source code and media

In this post I share my approach to using source control for my Umbraco website source code and medi…

Read Post

How to solve the error "Could not load file or assembly 'Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=2.0.0.0 ..."

This post will show you how to solve the error "Could not load file or assembly 'Microsoft.CodeDom.P…

Read Post