Skip navigation.
Downloads | Product Documentation | Support

Using the Visitor Tools

# Adding Visitor Tools to a Custom Application

# Adding Visitor Tools to a New Portal Application

When you add a Portal Web project to an enterprise application in WebLogic Workshop (or install Portal into an existing non-Portal Web project), the Portal project includes a set of JavaServer Pages (JSPs) and other files that enable visitors to set properties on personalized views of the portal.

Use the following procedure to add these visitor tools to a new portal application, which can then be customized.

1. In WebLogic Workshop Platform Edition, open the `.portal` to which you want to add the Visitor Tools.
2. In the Portal Designer, select the main book.

Figure 2-1 Select Main Book

3. In the Property Editor for the main book, set the Editable property to Edit in Menu. The Mode Properties heading is added to the available properties.
4. Click on the Content URI and browse to the `/visitorTools/visitorTools.portion` file.
5. After you create a new desktop in the WebLogic Administration Portal using the `.portal` file as a template, the edit icon will appear on the main book when you run the desktop. Clicking this icon takes the user to the Visitor Tools.

Note: The Visitor Tools JSPs only work when the portal server is running, and must be accessed by a user logged into the desktop. The Visitor Tools are not visible when running the `.portal` file in the WebLogic Workshop development environment.

## Related Topics

"Creating a Portal Application and Portal Web Project" in the WebLogic Workshop help system at http://e-docs.bea.com/workshop/docs81/doc/en/portal/buildportals/addPortalApp.html.

"Adding Visitor Tools to Portals" in the WebLogic Workshop help system at http://e-docs.bea.com/workshop/docs81/doc/en/portal/buildportals/visitorToolsAdd.html.

"Create a Desktop" in the WebLogic Administration Portal help system at http://e-docs.bea.com/wlp/docs81/adminportal/help/PM_DesktopCreate.html.