Setting Application Properties

To set the application-level properties, return to full-application view if you are still within the application. Click the Configuration button on the top-right corner of the screen. You will see the following tabbed options:

• Setup

 

• Permissions

 

• Export/Import

 

• Sharing

When you select the configuration option in the application menu, the first tab that you see is the Setup tab 

Here, you will see the five tabbed options for setup: 

• Email From 

 

• Page Added Email 

 

• Page Updated Email 

 

• Display Settings 

 

• RSS 

The Email From option allows you to set the sender information for messages that the application sends to an outsider. Usually, the application will send automatic mail notifications to its e‑mail subscribers whenever a new page is added or updated on the wiki. As Figure 7-26 shows, this screen accepts the Name and Address of the sender. After entering this information, you can save your changes by clicking the Save button. The mail notifications will now carry this sender information in each message. 

The Page Added Email option asks you to enter the subject, body, and signature for the message format. Whenever a new page is added to the wiki, the application will generate a mail message using the format defined on this page. 

The Page Updated Email option allows you to set the subject, body, and signature information as you did in the Page Added Email case. The application will use the defined format for composing notification messages that alert users to page updates. 

You can adjust the following settings on this screen: 

• Enable Comments: By marking this check box, you allow the users to post their comments on wiki pages. Of course, a user must have the Add Discussion permission to do this. 
 

 

• Enable Comment Ratings: Selecting this option allows the users to rate the comments entered by other users. 
 

 

• Visible Wikis: The two list boxes under this heading display which wikis are visible and which are hidden from view. You can move the entries from one list box to another with the help of the right and left arrows. 

Using the RSS option, you can customize the RSS output. You can set these two parameters for the RSS output: 

• Maximum Items to Display: From the drop-down list, you can select a discrete value ranging from 1 to 100. 
 

 

• Display Style: You can choose whether to display a page’s full content, its abstract, or its title only. 

The Permissions tab lets you set the user permissions at the application level. As with Liferay’s other applications, you can set the permissions for both Regular and Community roles. For each type of role, you can view the currently assigned and available permissions. The following three permissions are available at the application level for all types of roles: 

• Add Node 

 

• Configuration 

 

• View 

The Add Node permission, as the name suggests, allows the user to add a new node to the wiki. The Configuration permission assigns the user rights to configure the Wiki application itself. The View permission allows the user to view the wiki pages; this is the bare-minimum permission required by any user to use the application effectively. 

Whereas some of the tabbed options in the Wiki application also appear elsewhere in Liferay, you haven’t yet encountered the Export/Import tab because it is either unavailable or insignificant in the other applications you’ve seen so far. When you select this option, you will see two secondary tabs: 

• Export: Allows you to export your configuration settings and data 

 

• Import: Allows you to import previously saved configuration settings and data 

The Export option allows you to save not only the configuration, but also the data. While exporting the data, you can select the date range for the selection of data. You can also export the permissions assigned to users. 

The Import tab displays a list of items that you can import into the wiki 

After you have set the desired import parameters, you will need to locate and select the file for import using the Browse button. After you are satisfied with the settings, click the Import button to import data and settings from the selected archive file into the wiki. 

The Sharing option allows you to share the current application with any other web site or on Facebook. 

The Wiki application offers some other useful functionality for the effective use of wikis. Specifically, it lets you view a list of the following: 

• Recent Changes  

 

• All Pages 

 

• Orphan Pages 

You will notice the presence of these three links at the topright corner of the application screen 

When you click the Recent Changes link, you will see all the pages that have undergone recent changes. 

For each entry in the list, the following details are listed: 

• Page: Page name; it might change between revisions if a user has edited the name 

 

• Revision: Revision number 

 

• User: User who made the change 

 

• Date: Date and time on which the changes were made 

 

• Summary: Summary of changes made with respect to the previous version 

Also note the Actions button that appears with each item listed. If you click it, you will see a list of typical operations: 

 

All Pages

Selecting the All Pages option displays a list of all pages in the wiki. The list displays similar information to what’s shown in the Recent Changes list. On each entry, you can perform any or all of the actions described in the previous section. Additionally, you can add a new wiki page by clicking the Add Page button. 

The Orphan Pages option displays the list of orphan pages, which are pages with no parent connections. Because a wiki is community-run, it’s likely that users will move pages from one location to another. Doing this can result in pages that are no longer associated with a parent page. So even though these pages exist in the system, users cannot navigate to them. Thus, in a way, orphan pages are useless to us. You must either move them back to their original locations or simply remove them from the system. You will be able to do so using the Actions button against each orphan page.