Adding your own CustomActionGroup to Central Administration


I’ve mainly written this blog as I’ve only done this once and can imagine it will be something I will need again in the future but not remember what project I did it in. Therefore I’m putting the concept in this blog for reference later.

The basic concept is that I want an area in SharePoint Central Administration that holds my custom utilities. It will sit inside the Application Management section of Central Administration. Where it sits all depends on the Location property.

In my solution I will have an elements file. This file will contain the following CustomActionGroup called “Utitlites”. It will also include a picture, which is stored within the _layouts/images directory. This can be part of this project, or previous placed there from a past project. The picture must be a 32×32 pixel using png format.


<CustomActionGroup Id="CannonFodderUtilities"
Location="Microsoft.SharePoint.Administration.Applications"
Title="Utitilies"
Sequence="80"
ImageUrl="/_layouts/15/images/CannonFodder/CannonFodderLogo.png"
xmlns="http://schemas.microsoft.com/sharepoint/" />

Note: Above is based on SharePoint 2013. If using SharePoint 2010 the ImageUrl would be “_layouts/images/CannonFodder/CannonFodderLogo.png”

Once you have created the group you can then reference this group in you CustomAction. The custom action doesn’t have to be in the same solution, feature or even elements file. Just as long as it is in the SharePoint farm, and you reference the Group you named it in the CustomAction Group it will work. Below is the code to create 2 CustomAction links to 2 custom links.


<CustomAction Id="CannonFodderUtilitity1"
GroupId="CannonFodderUtilities"
Location="Microsoft.SharePoint.Administration.Applications"
Sequence="10"
Title="CannonFodder Utility 1"
Description="">
<UrlAction Url="_admin/Cannonfodder/CustomUtilityPage1.aspx" />
</CustomAction>

<CustomAction Id="CannonFodderUtilitity2"
GroupId="CannonFodderUtilities"
Location="Microsoft.SharePoint.Administration.Applications"
Sequence="10"
Title="CannonFodder Utility 2"
Description="">
<UrlAction Url="_admin/Cannonfodder/CustomUtilityPage2.aspx" />
</CustomAction>

As you can from the below screenshot, I’ve made the Utilities link at the bottom of the Application Management page.

For a full list of Location and GroupId can be found at the following Microsoft Link. http://msdn.microsoft.com/en-gb/library/bb802730(v=office.14).aspx

Advertisements