Prime 365 News 2.0 App

Todd Chessum -

The Prime 365 News 2.0 App allows you to aggregate and display news and/or announcements in a variety of attractive, mobile friendly ways.

news-web-part.gif

This article has been broken up into the following sections:

If you're looking for a simple way to Crop and Resize images for use in the New app, please take a look at our Cropping and Resizing News Images article. If you're uncertain as to what size your news images should be, go ahead and take a look at the What size should I make my News images? article.

Requirements and Activation

To get the most out of the Prime 365 News 2.0 app, you'll need to create and populate both a Emgage | Prime News List and a Emgage | Prime News Source list with a few sample news items. This process is explained in the sections below.

To activate the News app on your site, navigate to Add an App in the SharePoint Ribbon or to Site Contents > Add an App, and search for the Emgage | Prime News List and Emgage | Prime News Source List.  Provide names for both lists to Activate the "Emgage | News App 2.0."

Your_Apps.png

Creating a News List

In order to display an item in the News app, it must first be added to a News list. The following steps walk through creating a News list and adding news items.

  1. Navigate to Site Contents on the site you'd like to apply the News app (Click the Settings Gear located in the SharePoint Ribbon and then click on Site Contents).

    site-contents.jpg

  2. Click on add an app.

    add-an-app.jpg

  3. Find and Select the Emgage | Prime News List template. In the dialog box that appears input a Name for your news list (ex: Corporate News) and click the Create button. This will create the news list. Feel free to create more than one news list if you'd like (ex: HR News, Company Events, etc.). 

    Your_Apps_2.png

  4. From Site Contents click the newly created news list to open the all items view and select Add new item.

    add-new-item.jpg

  5. Fill in the fields accordingly (see field descriptions below the image), then click the Save button.

    Company_News_-_New_Item.png

    Title:  Enter the title of your news item.

    Body:  Enter the details of your news item.

    Image:  Enter the URL of an image you would like display with your news item.

    Link Options:  Select whether you would like your news item to: Link to list item popup (opens SharePoint view item dialog), Link to supplied URL (links to the URL supplied in the Link field), or Does not link.

    Link:  Enter the URL you would like the news item to link to (applied to the "Links to supplied URL" link option only).

    Open in new window:  Select this option if you would like news item link to open in a new browser window/tab (applied to the "Links to supplied URL" link option only).

    Expires:  Set an expiration date for the news item. The item will no longer display in the News app after this date has past.

  6. Your news list will now contain the news items you just created. Go ahead and create at least two news items with unique images if you'd like to preview the news cycle options.

    news-items.jpg

Creating a News Source

The News Source list will be used to define which News Lists are available as sources for a given News app instance. This allows for aggregation of news items from various lists within a single News app. The following steps walk through creating a News Source list and the addition of News Lists as sources.

  1. Navigate to Site Contents on the site you'd like to apply the News app (Click the Settings Gear located in the SharePoint Ribbon and then click on Site Contents).

    site-contents.jpg

  2. Click on add an app.

    add-an-app.jpg

  3. Find and Select the Emgage | Prime News Source List list template. In the dialog box that appears input a Name for your news source (ex: Main Page News Source) and click the Create button. This will create your news source list. Feel free to create more than one news source list if you'd like (ex: Side Bar News Source, All Departments News Source, etc.). 

    Your_Apps_4.png

  4. From Site Contents click your newly created news source list to open the all items view and select Add new item.

    add-new-item.jpg

  5. Now fill in the fields accordingly (see field descriptions below the image), then click Save.


    Homepage_News_Sources_-_New_Item.png

    Title:  Enter the display title of your news source item. This will be displayed when selecting news sources while configuring the News app.

    NewsType:  Select whether the new source is a SharePoint list or an RSS Feed. In this article we are using a SharePoint List.

    URL:  The URL of the News list or RSS feed from which news items will be sourced.

    SharePoint List

    For a SharePoint list, simply open a new browser tab, navigate to Site Contents and click on the desired news list, then copy the URL from your browsers URL bar after the all items view of the list opens.

    RSS Feed
    For an RSS feed, simple copy and past the RSS Feed URL into this field.

    MaxItemsToShow:  Select how many items from the news source you would like to have displayed.

  6. Your news source list will now contain the news source items you just created. Go ahead and add another news source if you have multiple News list created.

    news-source-items.jpg

Adding the News 2.0 App

Now that you have content created, you're ready to put the News app to use! The News app can be added to a page using the following steps:

  1. Place the page you would like to add the News app to in Edit mode by either selecting Edit from the SharePoint Ribbon, or Edit page from the Site Settings dropdown (pictured below).

    edit-page.jpg

  2. The page is now in Edit mode. To add the News app to a web part zone click on Add a Web Part in the desired zone (pictured below). To add a News app to a content zone, select the Insert tab in the SharePoint Ribbon and click the Web Part ribbon item.

    add-a-web-part.jpg

  3. The SharePoint Ribbon will expand to display two columns titled Categories and Parts. Under Categories select the Apps folder and then choose News 2.0 from the Parts section. Now click the Add button or press the Enter key to add the app.

    NOTE: If the News 2.0 app is not available, please review the Creating a News Source step in this article to ensure a News Source was added to your site.

    Root_2.png

  4. Congratulations! You have successfully added the News 2.0 app. The News 2.0 app will display an error message as it has not yet been configured. Now it's time to configure the News 2.0 app and connect it to the content we created in the previous sections.

    news-web-part-added.jpg

Configuring the News 2.0 App

The News 2.0 app can be configured using the apps tool pane as follows:

  1. Click the Admin gear located in the bottom corner of the News 2.0 app instance you would like to administer.
  2. Select the desired Source List, Display Style, Items Per Page, Cycle Preferences, Cycle Interval, Content options, Body Preview Length, and Refresh Interval.  Please review the following information while configuring the app:

    Root_3.png

    Source List:  Select the News source list (created in the Creating a News Source section) you'd like to use for this News app instance. Only valid News Source lists will be displayed as options.

    Display Style:  Select the style you'd like the News app to use when displaying news items. A brief description and sample of each style is shown below:

    Stacked
    Displays the Title and Body of multiple news items stacked below a single image area, which displays the Image associated with the currently highlighted news item. The highlight and image change at the specified cycle interval.

    news-stacked.jpg

    Image on Left
    Displays the Image, Text, and Body of multiple news items stacked, with the image aligned to the side of the text. Try this one with the Show Image option unchecked for displaying RSS feeds, or news items without images.

    news-image-on-left.jpg

    Image on Top
    Displays the Image, Title, and Body of one or more news items (dependent upon Items per page setting and web part zone width), and cycles through additional items by sliding them in from the side. This style is also know as a Carousel. Try this style with just the Show Image option selected.

    news-image-on-top.jpg

    Text Overlay
    Displays the Title and Body overlaid atop the news item Image. This one is my favorite! Note: The Emgage Webparts section of the Prime Stylizer provides options for controlling the overlay background and text colors for this style.

    news-text-overlay.jpg

    Items Per Page:  The number of news items to include per page. If the number of news items is greater than the items per page value, then pagination will be enabled.

    Cycle Preferences:  Controls whether the News app cycles through only the items on the current page (Cycle page items), or through all items on all pages.

    Cycle Interval (seconds):
      The time interval at which the News app cycles through items. We recommend somewhere between 3 - 7 seconds.

    Show Image, Show Title, Show Body:
      Use these options to fine tune how news items display by selecting whether or not the items Image, Title, or Body is shown. By default all options are selected/checked. Note that for certain Display Styles some option may not be editable.

    Body preview length (characters):
      Number of characters to that will be shown from the news items body field before the text in truncated. Use this option to control the length of body text displayed by the News app.

    Refresh Interval:  Refresh interval for the apps cache. Default is 30 minutes (recommended).

  3. Configure the above options as desired, then click on OK to save changes. Note: You may need to save the page before you see the selected configuration options applied to the News 2.0 app.

Administering the News App 

The final step is to select which news source(s) should be displayed in the News app. This is performed from the News 2.0 app instance as follows:

  1. Click the Admin gear located in the bottom corner of the News 2.0 app instance you would like to administer.

    Root_5.png

  2. This will open the apps admin panel, where you can select which source(s) you would like to have the News app display items from.

    news-select-source.jpg

  3. Clicking once on a source selection checkmark will select that source for your user only. This allows users to subscribe to just the news items they find relevant.

    news-check-source.jpg

  4. Clicking again (twice) on the source selection checkmark will lock in that source for all users. Note that only members of the Prime News Manager group have the option the "check-lock" a new source. This group was created when the News 2.0 app feature was activated and can be accessed by navigating to Site settings > People and groups, selecting More... from the side nav, and paging through the available groups until you've found the Prime News Manager group. Click the group name to edit the groups membership.

    news-lock-source.jpg

  5. When the news sources have been configured to your liking, click the Done button to save.

    news-two-sources.jpg

  6. Congratulations! The News app is now configured!

    news-web-part.gif 

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk