Add Links to Promoted Actions (en)

Add Links to Promoted Actions de Title
, ,

Promoted Action Links (e.g. Share, Follow, SYNC and EDIT) are displayed under the normally blue Delta Suitebar (Skydrive, Sites and Newsfeed).

If you want to add a link you have to overwrite the Promoted Actions Delegate Control and publish the solution to your farm.

I don’t know any out of the box way to do this, so please follow the stepby-step guide below.

1. Create a new SharePoint 2013 projekt (1) and give it the name: PromotedActions_Sample (2).

Add Links to Promoted Actions (en)_1


2. Publish it as an farm solution

Add Links to Promoted Actions (en)_2


3. Add a new element.
a. Right click on the project (1)
b. Add (2)
c. New element(3)

Add Links to Promoted Actions (en)_3


4. Add a new User Control Element (1) with the name: MyCustomPromotedAction

Add Links to Promoted Actions (en)_4


The solution explorer should now look like this:

Add Links to Promoted Actions (en)_5


5. Replace the PromotedLinksDelegateCtrl file with the code below:


<%@ Assembly Name=”$SharePoint.Project.AssemblyFullName$” %>
<%@ Assembly Name=”Microsoft.Web.CommandUI, Version=, Culture=neutral, PublicKeyToken=71e9bce111e9429c” %>
<%@ Register Tagprefix=”SharePoint” Namespace=”Microsoft.SharePoint.WebControls” Assembly=”Microsoft.SharePoint, Version=, Culture=neutral, PublicKeyToken=71e9bce111e9429c” %>
<%@ Register Tagprefix=”Utilities” Namespace=”Microsoft.SharePoint.Utilities” Assembly=”Microsoft.SharePoint, Version=, Culture=neutral, PublicKeyToken=71e9bce111e9429c” %>
<%@ Register Tagprefix=”asp” Namespace=”System.Web.UI” Assembly=”System.Web.Extensions, Version=, Culture=neutral, PublicKeyToken=31bf3856ad364e35? %>
<%@ Import Namespace=”Microsoft.SharePoint” %> 
<%@ Register Tagprefix=”WebPartPages” Namespace=”Microsoft.SharePoint.WebPartPages” Assembly=”Microsoft.SharePoint, Version=, Culture=neutral, PublicKeyToken=71e9bce111e9429c” %>
<%@ Control Language=”C#” AutoEventWireup=”true” CodeBehind=”MyCustomPromotedAction.ascx.cs” Inherits=”PromotedActions_Sample.ControlTemplates.PromotedActions_Sample.MyCustomPromotedAction” %>
<a title=”Display your checked out Items” class=”ms-promotedActionButton” style=”display: inline-block;” href=”http://sp13/teams”>
<span class=”s4-clust ms-promotedActionButton-icon” style=”width: 16px; height: 16px; overflow: hidden; display: inline-block; position: relative;”>
<img style=”top: 0px; position: absolute;” alt=”Share” src=”http://sp13/PublishingImages/CheckedOut.png”/>
<span class=”ms-promotedActionButton-text”>Display your checked out Items</span>

Add Links to Promoted Actions (en)_6


6. Now add a new empty element (1) and type in the name: PromotedActions (2)

Add Links to Promoted Actions (en)_7


Replace the contont of the element with the code:

<?xml version=”1.0? encoding=”utf-8??>
<Elements xmlns=””>
<!– Adding DelegateControl reference to our custom PromotedActions Delegate Control –>
<Control ControlSrc=”/_controltemplates/15/PromotedActions_Sample/MyCustomPromotedAction.ascx”
Sequence=”1? />

7. Now build and deploy the project.
8. If you did everything right you should get something like:

Add Links to Promoted Actions (en)_8


Hint: If you change the name of the project, User Control element or the empty element make sure that the .ascx and the .xml files are correct,
because in those are the references to everything else.

I created two icons which are free to use so you get a good icon next to your link.
If you want to use your own icons make sure that the mayimum height ist 16px.

If you want to get my two icons, dont be afraIT and get them for free here.

Leave a Reply

Your email address will not be published. Required fields are marked *