Screens

A screen is a page of portal content. When the portal page is first loaded, the Home screen is initially shown (Home.jsp).

Other screens can also be displayed, including the Login screen and the Error screen. Selection of screens is determined by links or buttons on the toolbar, which is provided by a theme. The Home screen includes the <portal-core:pageRender/> tag, which renders the pages layout and content.

Creating links to a custom screen

Portlet content is rendered only within the Home screen. However, you can provide content in other screens that you create. For example, you could create an introductory screen that displays a multimedia greeting to users before they log in to the portal site. The <portal-navigation:url screen="name"/> tag is used to create the link to the JSP in the /screens directory. The name value must be the name of the screen JSP file without the .jsp extension.

In the following example from banner_toolbar.jspf, a URL to the ForgotPassword screen is created for the HREF attribute of the link.

   <%-- forgot password button --%>
   <portal-logic:if loggedIn="no" notScreen="ForgotPassword">
      <% if (firstButton) { firstButton = false; } else { %> | <% } %>
      <a class="wpsToolBarLink" href='<portal-navigation:url screen="ForgotPassword" home="public"/>'>
         <portal-fmt:text key="link.password" bundle="nls.engine"/>
      </a>
   </portal-logic:if>

Parent topic:

Layout of the portal page

---