Adding pre-defined default feeds

Administrative users can add pre-defined news feeds via the portlet UI.

Mapping Portal Roles

In order to use the administrative features available in the NewsReader portlet, you will need to map a uPortal group to the "newsAdmin" portlet role. In the example below, the portlet maps this administrative role to the "Portal Administrator" role in uPortal. One could also map the role to a specially configured news administration role or to a PAGS group.

Example Role Mapping in src/main/webapp/WEB-INF/portlet.xml
    <portlet>
        <portlet-name>news</portlet-name>

        . . . 

        <!-- Administrative role mapping.  This mapping is required if you want to use the administrative features. -->
        <security-role-ref>
            <role-name>newsAdmin</role-name>
            <role-link>Portal Administrators</role-link>
        </security-role-ref>
        <!-- Additional roles for assigning default calendars.  Any roles you wish to use must be assigned keys here. -->
        <security-role-ref>
            <role-name>everyone</role-name>
            <role-link>Everyone</role-link>
        </security-role-ref>
        <security-role-ref>
            <role-name>student</role-name>
            <role-link>Students</role-link>
        </security-role-ref>
        <security-role-ref>
            <role-name>faculty</role-name>
            <role-link>Faculty</role-link>
        </security-role-ref>
        <security-role-ref>
            <role-name>staff</role-name>
            <role-link>Staff</role-link>
        </security-role-ref>
    </portlet>

Adding Feeds

An Administrator can add a new feed by clicking the "administration" link. This link will open a new form allowing you to add a new feed, as well as details about that feed. Enter a feed name displayed to the user and select the feed class (currently only Rome Adapter is available). You can add roles defined role-link entries in the portlet.xml.  If a user is a member of one of the default roles listed, the feed will be enabled by default.  If the user has portlet permissions that allow them to edit the portlet, users can deselect any feeds they do not want, and all users regardless of their role will see this feed in the list of built in feeds and can add it if they wish.  For the Rome Adapter, add a parameter 'url' that is the feed url to access.

As an example, we could add Apereo's News feed as a basic news feed.  it requires one parameter of "url", which for this feed is http://www.jasig.org/taxonomy/term/163/all/feed. In the screenshot below, we've configured the feed to be available to the user group "Everyone".

Common Portlet Configuration

NewsReader preferences are shared among ALL instances of NewsReader portlets.  You cannot create different feeds in two different instances of NewsReader portlets.