Tuesday, 18 June 2013

Personalize the Welcome portlet

The Welcome portlet, and its Manager counterpart, are predefined portlets available to all users and managers, as per standard configuration of the Home and My Team portals.

Digging down the System Administration guide, you can find out that these portlets can displays formatted text and images with a very rich syntax, similar to a wiki markup entry.

For example, you can use the exclamation mark to format headings:
  • Heading: 1, 2 or 3 exclamation marks followed by text displays the text as a large heading (! for smaller, !!! for larger headings)
If we entered this text in the data field of the Welcome portlet, it would be displayed as for the following picture.
     !!!Welcome to Saba
     !!This is your Learning Management System
     !Home
     Normal text here



Do you want to make your text bold or italic?
  • Bold: 2 underscores on both sides of text displays the text in bold
  • Italic: 2 single quotes around text displays the text in italic
For example:
     This is __very__ important. ''Please'' read it carefully.


Please note that you have to enter twice the single quote sign ' and not the double quote sign ".
What about bullet and numbered lists? C'est plus facile!
  • Bullet list: An asterisk followed by text displays the text as a bullet list
  • Numbered list: A hash symbol followed by text displays the text as a numbered list
And you can combine formatting as in the following example:
     Please follow these steps in order:
     # Log in with your username and password
     # Go to ''My Learning'' page
     # Launch the WBT by clicking on the __Launch__ button


Replace the # sign with the * to have a bullet list instead of a numbered list.

4 hyphens display a horizontal line the width of the portlet.
     First paragraph
     ----
     Second paragraph


Last but not the least, if you are after embedding images and links to external web sites or documents, you can use the square bracket syntax:
  • URL: Square brackets surrounding a URL displays the URL as an active hypertext link; a display text can be specified instead of the actual URL by separating the label from the URL with the | (pipe) sign
  • Image: Add the {Image} tag and the src attribute as in the example below
A few examples:
     Display the actual URL: [http://www.nasa.gov]
    
     Display a label as a hyperlink: [NASA|http://www.nasa.gov]

     Embed an image:
     [{Image src='http://upload.wikimedia.org/wikipedia/commons/2/25/Nasa-logo.gif' width='100' height='85' align='left' border='0' link='http://www.nasa.gov'}]


Please note that to enable hypertext links to function correctly, you must include http:// in the URL.


Salutacions cordials
Saba Guru