Collated Department News Widget - Akumina Community

Collated Department News Widget

Estimated reading time: 2 min


Main Features

  • Displays news items from specified departments (subsites)
  • If UserContext is enabled, displays the news item from the current user’s department in the lead (top) position.
  • If more departments than slots available, does a random display of 4 sites (configurable)
  • Each item is linked to the FriendlyURL

Uses Content Type: (click to view content type definition)


Widget Properties Example Instance


Property Details
isroot If unchecked, the list which contains the data for this instance is on the current site.

If checked, the list which contains the data is on the root of the Site Collection.

selectfields The data fields (columns) from the SharePoint list that the widget should retrieve for use in this instance.

For this example, the selectfields = Title,Image,FriendlyUrl

ispaging If false, the widget will not display paging controls

If true, the widget will display paging controls (if implemented by developer in widget)

pagesize Sets the number of items to display on each page IF paging is enabled.
listname Name of the SharePoint list that contains the data to be displayed for this instance.
callbackmethod The callbackmethod is set by the developer of the widget. No value is required for this instance type.
isasynccallback Value for this type of instance = false
viewxml The viewxml contains any special manipulation of the data that needs to be done by the widget BEFORE it gets render by the specified view.  In this case, the viewxml is set to the following string:

<View><Query><OrderBy><FieldRef Name=’Start_x0020_Date’ Ascending=’FALSE’></FieldRef></OrderBy><Where><And><Leq><FieldRef Name=’Start_x0020_Date’ ></FieldRef><Value IncludeTimeValue=’TRUE’ Type=’DateTime’><Today ></Today></Value></Leq><Or><Geq><FieldRef Name=’Expires’ ></FieldRef><Value IncludeTimeValue=’TRUE’ Type=’DateTime’><Today ></Today></Value></Geq><IsNull><FieldRef Name=’Expires’ ></FieldRef></IsNull></Or></And></Where></Query><RowLimit>1</RowLimit></View>

callbacktype Value for this type of instance = customdataload
siteslist For this widget, you can specify the list of departments/sub-sites from which you want to display news items.  If you specify more than four departments, the widget will pull from four departments randomly.

To specify departments, add in the ‘URL’ value (not name) for the department using the following format


NOTE: If targeting is enabled, the lead article will be displayed from the current users Department as defined in their User profile.  If their department is not in the list of available departments, then the widget will default to displaying random departments.

cacheinterval Sets the time (in secs) that the data should be saved in the local browser cache of the current user.

0 = do not cache the data for this widget

-1 = use the default caching strategy set in the Digital Workplace configuration

[whole number] = cache for specified time (secs)

dependencies This field designates if this instance depends on any other widget definition. In this case, it depends upon the “GenericListWidget”
VIEW View Name = HomePage-DeptNews

View Template URL =



Was this article helpful?
Dislike 0
Views: 168