Adjusting Page Properties

So far, you’ve learned to add new pages to a wiki node and create child pages for it. Now, you will learn to set the various page properties. The properties are maintained for each page individually, so you first need to select the page you want to modify. To look up the page’s current properties and set new values for them, use the Properties icon shown in the top-right corner of the page (see Figure 7-17).

 

When you click the Properties icon of the selected page, you will bring up the following tabbed options:

• General

• History

• Incoming Links

• Outgoing Links

• Attachments

We will now look at each of these options in detail.

The General properties tab of a typical wiki page is shown in Figure 7-18.
 

 

The General properties screen shows several generally useful properties and also allows you to perform certain actions on the selected page. We’ll now look at the interpretations of the various properties and actions:

• Title: This displays the page title.
 

 

• Format: This shows the page format, which can be either HTML or Creole.
 

 

• Latest Version: This shows the version number for the last edit to the page.
 

 

• Created By: This shows the page creator, plus the date and time of creation.
 

 

• Last Changed By: This shows the user who edited the page last, plus the date and time of the last edit.
 

 

• Attachments: This shows the number of files attached to the current page. As I mentioned earlier, the page creator or anybody having requisite permissions can attach supporting documents to a page.
 

 

• RSS Subscription: This property lets you choose whether to view the page in Atom 1.0, RSS 1.0, or RSS 2.0. When you view the page in RSS, you will see all of a page’s versions displayed in a browser window
 

 

• Email Subscription: This shows your subscriptions to the page and the wiki. If you are not currently subscribed, you can subscribe by clicking the Subscribe link to the right of the desired option. After you subscribe, the link changes to Unsubscribe so you can unsubscribe to the feed at any time. (This property is accessible only to users who have the permission to subscribe.)
 

 

• Advanced Actions: This provides you four important actions:

 

• Permissions

• Copy 

• Move 

• Delete

The Advanced Actions property lets you set user permissions on a page, copy a page under a new name, move a page to another location, or simply delete a page. Let’s look at each action in detail.

You saw in earlier chapters how to set permissions for users with different roles; the process for setting permissions on a wiki page is similar. To set the permissions, follow the steps listed here:

1. Click the Permissions link under the Advanced Actions option. You will see the list of roles and permissions assigned to each role.

 

2. Look up the Available roles under Regular Roles and Community Roles and select the desired role for which you want to set permissions.

 

3. Click the Update Permissions button to look up the available permissions for assignment:

 

a. Add Discussion
b. Delete 

c. Permissions 

d. Subscribe 

e. Update 

f. View

The permissions in the preceding list have the same meanings as the ones associated with the other Liferay applications that you studied in earlier chapters. The Add Discussion permission allows you to post replies. The Delete permission lets you delete an entry. The Permissions option enables the user to assign rights to other users. The Subscribe option enables the user to subscribe to a feed. The Update option allows the user to modify the entry. The View option, which by default is a required feature, allows the user to view the entry.

Selecting this option under Advanced Actions in the General properties tab allows you to copy the page under the new name. When you click the Copy link, a new page opens in the page editor with no name assigned to it. All the contents of the selected page are copied into the new page, except for the page name. You just need to enter the desired name for the page and click the Save button. The new page now appears in the list of pages available on the wiki. These newly added pages are not linked to any other page, so they’re essentially “orphan” pages at this point.

Selecting the Move action facilitates the following:

• Renaming the page

 

• Changing the page’s parent

When you select the Move action, the page opens with tabs called Rename and Change Parent (see Figure 7-20).

 

To rename the page, simply enter the new name in the New Title edit box and click the Rename button. The page will now be saved under its new name.

To move the page under a different parent, follow the steps listed here:

1. Select the Change Parent tab to pull up the screen shown in Figure 7-21.
 

 

2. Select the desired parent from the New Parent drop-down list.

 

3. Click the Change Parent button. This moves the current page under the new parent.

Clicking the Delete option under Advanced Actions deletes the current page after the application asks for your confirmation to do so.

The History page-properties option displays the history of all your edits to the current page. Each time you edit a page and save it, the Wiki application assigns a new version number to the page. Both the original and revised pages are saved under their respective version numbers. Rather than saving the full page, the Wiki application saves only the changes made to the page. You can always request to see the changes made between each version (see the “Comparing Versions” section following the “Viewing” section). First, let’s look at how to display the different versions of a selected page.

When you select the History tab, you see the screen shown in Figure 7-22. 
 

 

As you can see in Figure 7-22, the screen displays a list of all different versions of the page. For each entry, you’ll see the following information: 

• Page: This displays the page name. 

• Revision: This shows the revision number. 

• User: This shows the person who revised the page. 

• Date: This shows the date and time of revision. 

• Summary: This shows the summary of changes made with respect to the previous version. 

Also note the Revert button to the right of each entry. It allows you to revert your wiki page back to the selected version. 

As you saw in the preceding “Viewing” section, the Summary column summarizes the changes you have made to a page. You can get more information about the changes by asking for a detailed comparison between versions. To do so, perform the following steps: 

1. Select the two versions that you want to compare by marking the corresponding check boxes on the History page. 

 

2. Click the Compare Versions button to display the detailed list of changes in the window.

Follow these steps to add a few pages and to create interconnecting links: 

1. Open the FrontPage page for editing. 

 

2. You must use Creole syntax for editing, so confirm that you are in Creole mode. 

 

3. Add a link by typing [[Fundamental Analysis Research]] in the editor’s body-text window. This would create a link to the page called Fundamental Analysis Research after you save your edits—if that page were to exist. But you do not have a page with this name, so the application creates the link and shows it in red. Clicking this link opens the new document in which you can add your contents. Save your edits. 

 

4. Now, you will add one more link from this page (Fundamental Analysis Research) to another new page. 

 

5. Follow the procedure in step 3 to add a new page called Fundamental Analysis Report with an interconnecting link between the two pages. 
 

 

You have now set up the required pages and the interconnected links. You will examine the display of these links in the next section. 

Open the Fundamental Analysis Research page. Click the Properties icon and select the Incoming Links tab.

The Outgoing Links option is similar to the Incoming Links option, except that it shows the outgoing links instead. To view the outgoing links, open the FrontPage page. Click the Properties icon and select the Outgoing Links tab. You will see an outgoing link to the Fundamental Analysis Research page. 

When you click the Attachments properties tab, you will see a screen similar to the one shown in Figure 7-25. 
 

The screen in Figure 7-25 shows all current attachments on the page. You can add new attachments to it by using the Add Attachments button, or you can remove an existing attachment by clicking the Delete button associated with the unwanted file.