Portlet Types
Warning: The similarly-named portlets listed in this box should not be added to your web site:
- "Events"
- "News"
- "Recent items"
- "Review list"
- "Search portlet"
- "Classic portlet"
They lack the enhanced features contained in the SOM portlets explained below.
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 links to a list of events for that day. Only events in the published state will appear in the calendar portlet.
[top]
Collection Portlet
A collection portlet is a way of displaying items from a collection in a portlet view. Because of this, the collection must be created before adding the collection portlet to your site. When you do create the collection portlet, the following options are available:
- In the Portlet header field, enter a title for your new portlet.
- Under Target collection, your available collections should now appear in a 'Search results' box. Select the collection that you want to appear as a portlet, and save your changes.
Note: the left and right columns have a fixed width, so tables, image and links should not exceed 150 pixels. - You can also set how many items that will be shown in the portlet. Similar to the News and Events portlets, checking the Show more... link box at the bottom of the Collection portlet will create a link to the complete list of the Collection items.
Tip: Don't see any collections in the menu? Make sure you've added a collection.
[top]
Lineage Events Portlet
The Lineage events portlet shows imminent upcoming events that are in the published state. It's called a "Lineage" portlet because it allows you to choose whether to include or exclude items that exist on child sub-sites! Remember, 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. You'll need make these settings:
- 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 subsites' events to appear in your Lineage events portlet.
[top]
Lineage News Portlet
The Lineage news portlet shows the most recent news items that are in published state. All news items displayed on 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. You'll need make these settings:
- 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 subsites' news to appear in your news portlet.
[top]
Lineage Recent Portlet
The Lineage Recent portlet displays recent site changes to those who're logged in. When you add it:
- 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 items portlet.
[top]
Lineage Review Portlet
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, nothing in the review portlet will be visible on your site. This portlet is useful for the site manager, since it collects and displays a list of all content awaiting approval.
- Check the Exclude subsites box, if you don't want subsites' recent items to appear in your review portlet.
[top]
Lineage Search Portlet
The Lineage search portlet is a way to search only within your site. This differs from the 'Search Site' search box in the main School of Medicine banner, as that box searches all School of Medicine and UNC Health Care websites. The SOM search portlet is especially useful if you have a large site and think users will need to search for specific content items. When you add it:
- 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 subsites' search results to appear in your search portlet.
[top]
Login Portlet
There are some instances where site login should be more prominent—perhaps when users need easy access an intranet folder. The Login portlet works just like the usual site login, and functions as a shortcut.
- If a user forgets their password, the "Forgot your password" link directs them to main campus for ONYEN password help.
[top]
RSS Feed Portlet
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, which you'll need in order to publish feed portlets on your site. You can find a feed URL (i.e. http://news.unchealthcare.org/news/aggregator/RSS) on any site that provides it by looking for an
RSS icon, or you can search for feeds using a service like Google Reader or Feedage.com. RSS feed portlet settings include:
- In the Title field, enter the title you'd like the portlet to display. You may leave this blank, if you the RSS feed already has a title you like.
- 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 add (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 often (not recommended).
[top]
Static Text Portlet
A static text portlet is a portlet that can contain custom text, images, etc. and is useful for highlighting information, announcements, etc. that you wish to feature on your site. When you add it:
- 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 CMS' built-in visual editor. You can use the buttons and tools that appear to add basic formatting to your text. Note: the left and right columns have a fixed width, so tables, image and links should not exceed 150 pixels.
- If you check Omit portlet border, the default site background shows through (blue on the left, and white on the right).
[top]
Flash Movie Portlet
150 px wide. Note that you must first upload the SWF file to your site, in order to create a Flash movie portlet. When you add it:
- Select your Flash movie from the Flash Movie drop-down menu.
Tip: Don't see any Flash movies in the menu? Make sure you've uploaded your SWF file.
[top]
