Technical Note: Managing Sun Java System Portal Server 7.1 Update 1 Blog Portlet

Portlet Preferences

This section describes Blog portlet's portlet preferences.

appUrl

Set this to the APP endpoint of the Roller server instance. If not set, the portlet will assume manual configuration mode, regardless of the configMode preference value. To set this, specify the HTTP or HTTPS URL, or the empty string. By default, this is set to http://localhost:8080/roller/roller-services/app.

appEntriesUrl

Set this to the APP entries URL of the weblog that the portlet should manage. This preference can either be configured by the portal administrator for a group of users (per organization, per role), entered directly by the user (in manual configuration mode), or derived from the appUrl and handle preferences (in wizard configuration modes). Blog provisioning will set this preference to point to the community weblog. To set this, specify the HTTP or HTTPS URL. By default, this is set to http://localhost:8080/roller/roller-services/app/entries/junkyard.

appUserName

Set this to a Roller user name that has author privileges on the weblog pointed to by the preference appEntriesUrl. This preference can either be configured by the portal administrator for a group of users (per organization, per role), entered directly by the user (in manual configuration mode), or gathered from the user (in wizard configuration modes). Blog provisioning will set this preference to point to the shared weblog user account for the community. To set this, specify the Roller user name. By default, this is set to jtb.

appUserPassword

Set this to the password of the user account pointed to by the preference appUserName. This preference can either be configured by the portal administrator for a group of users (per organization, per role), entered directly by the user (in manual configuration mode), or gathered from the user (in wizard configuration modes). Blog provisioning will set this preference to the generated, random password of the shared community weblog user account. The password can be plain or encrypted depending on the value of the encryptedPasswords preference. To set this, specify the Roller user password. By default, this is set to iplanet.

aappUrl

Set this to the AAPP endpoint of a Roller server instance. If not set, the portlet will assume manual configuration mode regardless of the configMode preference value. To set this, specify the HTTP or HTTPS URL, or the empty string. By default, this is set to http://localhost:8080/roller/roller-services/aapp.

aappUserName

Set this to a Roller user account name that has the admin role in Roller. By default, this is set to jtb.

aappUserPassword

Set this to a password that matches the user account set in the aappUserName preference. The password should either be plain or encrypted depending on the value of the encryptedPasswords preference. To set this, specify the Roller user password for the user specified in the aappUserName preference. By default, this is set to iplanet.

handle

Set this to the weblog handle of the weblog pointed to by the appEntriesUrl preference. This preference is only relevant when the portlet is in wizard or wizard-user-only configuration mode. It can otherwise be left blank. To set this, specify the Roller weblog handle. By default, this is set to junkyard.

configMode

Set this according to the desired configuration mode. This preference is set to wizard-user-only mode in the community templates. Values can be manual, wizard, or wizard-user-only. For more information, see Use Cases. By default, this is set to manual.

memberPermission

Set this to the role that should be given when user accounts are added as members to weblogs in wizard or wizard-user-only configuration modes. This preference is set to ADMIN in the community templates for the owner, and AUTHOR in community templates of the members. Values can be ADMIN, AUTHOR, or VISITOR. By default, this is set to AUTHOR.

userUrl

Set this to the user access URL of a Roller server instance. This preference is used to give end users a link to the Roller server instance. To set this, specify the HTTP or HTTPS URL By default, this is set to http://localhost:8080/roller.

searchUrl

Set this the URL of a Portal search server instance. If not set, the portlet will not index weblog posts. In the community template, the value of this preference is a token that is replaced when the community is created. To set this, specify the HTTP or HTTPS URL. By default, this is set to http://localhost/search1/search.

searchDatabase

Set this to the name of the search database to use to index blog entries. In the community template, the value of this preference is a token that is replaced when the community is created. Values for this must be a string. By default, this is set to blog.

encryptedPassswords

Set this to true to assume encrypted password storage, or false for plain password storage. See Configuring Security for more information. To set this, specify the boolean value of true or false. By default, this is set to false.

pageSize

Set this to the number of weblog entries to display per page. The value is an integer and by default, this is set to 8.

refreshInterval

Set this to the number of seconds to delay weblog content refresh. A value of 0 refreshes weblog content on every page refresh. A value of -1 means never refresh. When the user modifies weblog content through the portlet (post, edit, delete), the content is refreshed regardless of the refresh interval. The value is an integer and by default, it is set to 1200.