Portlet Types

Many portlet types are available for use in the School of Medicine web system.

Standard & Content Area Portlets

The following portlets can be placed in the standard portlet ares (in the first and third columns) as well as the content area.

 

Calendar Portlet

The calendar portlet shows the current month with the ability to navigate between months using the next/previous month arrows.  The current day is highlighted with an orange border.  Days containing events are shown in orange and will link to a list of events for that day.  Only events in the published state will appear in the calendar portlet.   

Portlet - Calendar


Carousel Portlet

Carousels display the content of a collection as a slideshow.

Portlet - Carousel

Creating a Carousel Portlet

  • You will first need to create a Collection. Be sure to remember the name you assign to the collection.
  • Go to the page where you wish to display a carousel portlet.
  • Click on the green Manage Portlets bar located under the first and third column.
    Manage Portlets 
  • From the Add portlet... drop-down menu, select Carousel portlet.
    Add Portlet 
  • On the resulting Add Carousel Portlet page
    • In the Portlet header field, enter a title for your new portlet.
    • In the Target collection search box, type the name, or part of the name, of an existing collection.  Click search.  Collections that contain the search term will appear.
    • Select the radio button of the collection that you wish to use.
    • You can Limit how many items will display in the portlet.
    • Hide controls allows you to take away the navigation arrows and radio buttons.
    • Timer allows you to customize the speed at which the slides are cycled.

Collection Portlet

Collection PortletThe Collection Portlet allows you to display the results of a Collection. You must have a Collection previously created when you add this Portlet, then you can specifying the Collection to be used. 

    • You will first need to create a Collection. Be sure to remember the name you assign to the collection.
    • Go to the page where you wish to display the collection portlet.
    • Click on the green Manage Portlets bar located under the first and third column. 
      Manage Portlets
    • From the Add portlet... drop-down menu, select Collection portlet
      Add Portlet 
    • On the resulting Add Collection Portlet page
      • In the Portlet header field, enter a title for your new portlet.
      • In the Target collection search box, type the name, or part of the name, of an existing collection.  Click search.  Collections that contain the search term will appear.
      • Select the radio button of the collection that you wish to use.
      • You can Limit how many items will display in the portlet.
      • The Select random items option will randomly select items from the collection to display in the portlet.
      • Checking the Show more... link box will create a link at the bottom of the Collection portlet to the complete list of the Collection items.
      • The Show dates option will display the effective dates of all items in the collection.  

       


          Lineage Events Portlet

          Portlet - EventsThe Lineage events portlet displays upcoming events provided that you have published Events on your site.  It's called a "Lineage" portlet because it allows you to choose whether to include or exclude items that exist on child sub-sites.  Only events in the published state, that will occur in the future, will appear here.  This portlet should be enabled by default on your site; but if it somehow gets deleted, you can always add it back. This portlet will disappear if there aren't any events, published events or future events on your site.  We recommend adding all events to the 'Events' folder located at the root of your site.  

          To add this portlet:

          • Add a title allows you to specify your own portlet title.
          • In the Number of items to display field, enter the number of events you wish this portlet to display.
          • Leave the Workflow state field set to Published.
          • Check the Exclude subsites box, if you don't want any events of subsites to appear in your events portlet.

          Lineage News Portlet

          Portlet - NewsThe Lineage news portlet displays the most recent news items provided that you have published News on your site.  All news items displayed in the news portlet must be added to the 'News' folder, located at the root of your site. The Lineage news portlet is enabled by default on your site; but if it somehow gets deleted, you can always add it back.  This portlet will disappear if there aren't any published News items on your site.  We recommend adding all news items to the 'News' folder located at the root of your site.

          To add this portlet:

          • Add a title allows you to specify your own portlet title.
          • In the Number of items to display field, enter the number of news items you wish this portlet to display.
          • Leave the Workflow state field set to Published.
          • Check the Exclude subsites box, if you don't want the news of any subsites to appear in the news portlet.

          Lineage Recent Portlet

          Portlet - Recent ChangesThe Lineage Recent portlet displays recent site changes.  It only appears to those who are logged in.

          • In the Number of items to display field, enter the number of recent items you wish this portlet to display.
          • Check the Exclude subsites box, if you don't want subsites' recent items to appear in your recent portlet.

          Lineage Review Portlet

          Portlet - Review ListThe Review List Portlet displays a list of items that have been submitted for review. This portlet is only visible for logged-in users with 'Reviewer' permission or higher on your site.  The Lineage review portlet displays items which have been submitted for publication by users who do not have publishing permission.  Until a reviewer (or higher) publishes those items, content in the pending review state will not be visible to site visitors.  This portlet is useful for the site manager, since it collects and displays a list of all content that needs to be reviewed and published.  This portlet only displays itself when there is content items (pages, news items, etc.) on your site that are in the pending review state.

          • Check the Exclude subsites box, if you don't want the pending review items of a subsite to appear in the portlet.

          Lineage Search Portlet

          Portlet - Site Search

          The Lineage Search Portlet allows you to place a search box on your site that will only search for content within your site.  This differs from the search box in the main School of Medicine banner, as that box searches all School of Medicine and UNC Health Care websites.  The lineage search portlet is especially useful if you have a large site and think users will need to search for specific content.

          To add this portlet:

          • Leave the Enable LiveSearch box checked, if you'd like new content items to be added to search results as they are created.
          • In the Add a title field, enter a title to display above your search portlet.
          • Leave the Exclude subsites box checked, if you don't want the content from a subsite to appear in the search results.

          Login Portlet

          There are some instances where site login should be more prominent—perhaps when users need easy access to an intranet folder. The Login portlet works just like the usual site login.

          • If a user forgets their password, the "Forgot your password" link directs them to main campus for ONYEN password help.

          RSS Feed Portlet

          Portlet - RSSThe RSS Feed Portlet allows you to display an RSS Feed.  RSS (Rich Site Summary) is a technology for communicating dynamically-updated web content listings.  RSS feeds are basically lists of news headlines that update automatically. Many news sites, blogs and other online publishers syndicate stories using these RSS feeds. 

          RSS feed portlet settings include:

          • In the Title field, enter the title you'd like the portlet to display.  If you leave this field blank, the title of the feed will be used.
          • In the Number of items to display field, enter the number of events you wish this portlet to display.
          • In the URL of RSS feed field, enter the URL of the RSS feed you'd like to use (sometimes this will end with .XML, but not always).
          • Leave the Feed reload timeout field set to 100, unless you want the page to auto-refresh more or less often (not recommended).

          Static Text Portlet

          Portlet - Static TextA static text portlet is a portlet that can contain anything you want: custom text, images, etc (just like the body of a page.)  You can make a static text portlet look like regular page content on a white background by omitting the portlet border. 

          • In the Portlet header field, enter a title for your new portlet.
          • The Text area is where you will enter the content you wish to highlight. The Text section allows you to easily edit and style your content using the web system's visual editor. You can use the buttons and tools that appear to add basic formatting to your text. 
          • Checking the Omit Portlet Border option will remove the portlet header and footer and will remove the background and border coloring so that the portlet displays on a white background.  If you have the Omit Portlet Border option check and wish to display a title: 
            • Add the text for the title to the editor / Text box area.
            • Style the text as a Heading 2 from the Style... drop-down list of the editor.
            • If you wish the title to be blue you can select it and assign it the Text Blue style from the Style... drop-down list.

          Portlets Exclusive To the First and Third Columns

          Navigation Portlet

          The Navigation Portlet allows users to navigate your site with ease by providing a structured "site map", or navigation tree.  It displays the name of the content (folders, pages, etc.) that you add to your site.  By default the navigation will display up to four levels deep.  

          It is required that all sites leave the navigation as the first/uppermost element of the first column.  Any other portlets added to the first column must be placed below the navigation. 

          View more information on building the navigation.

          View more information on re-adding the navigation.

           


          Portlets Exclusive To The Content Area

          Collection Portlet (Content Well)

          portletCollection_content_well.jpgThe content well collection portlet differs from an ordinary collection portlet, in that it shows titles and descriptions, as well as photos (when a Collection captures News Items).  A collection must be created before adding this portlet to your site. 

          The following portlet options are available:

          • In the Portlet header field, enter a title for your new portlet.
          • In the Target collection search box, type the name, or part of the name, of an existing collection.  Click search.  Collections that contain the search term will appear.
          • Select the radio button of the collection that you wish to use.
          • You can Limit the number of items that will be appear in the portlet.
          • The Select random items option will randomly select items from the collection to display in the portlet
          • Checking the Show more... link box will create a link at the bottom of the Collection portlet that will link to the complete list of collected items.
          • The Show dates option will display the effective dates of all items in the collection.

           


          RSS Portlet (Content Well)

           


          UNC SOM Landing Page Carousel

           

          Related content
          Collections
          Styling Content