ShowTable of Contents
IBM® Web Content ManagerTM
(WCM), formerly known as Lotus® Web Content Management, is used to create, manage, and deliver Web content that enables organizations to increase the efficiency and accuracy of their Web site deployments. Content is created by use of the default or customized Web content authoring portlet and is delivered by use of content viewer portlets, servlets, or pre-rendering sites to HTML.
Various features of WCM are summarized as follows:
- A clear segregation between the layout and design elements from that of the content of a Web site. This implies that one can change the layout and design of a Web page without changing the content, and vice versa. Design features such as navigation of a Web site are generated automatically by use of predefined elements and components.
- A Web content authoring system enables content creators to author content for the site without bothering about the design and layout of the Web site. These systems are designed to deliver personalized Web content authoring experiences to users.
- Web content from third-party content management systems can also be imported and presented from within the WCM system. You can do this by using Web Content Integrator, which consumes content in RSS feed format, and can also use WebDAV to import content from a file system.
- WCM features include version control, change management and approval, multi-item projects, and user-defined folders to group content items, which simplifies maintenance and management of Web content.
IBM New Site Wizard
- WCM includes a set of pre-installed content libraries that allow you to enrich a Web site with blog and wiki features to tap into the power of social collaboration and networking.
The New Site Wizard helps less-experienced users create personalized Web sites quickly in WCM. The package includes a WAR file along with supporting files and directories that can be downloaded from the IBM Lotus and WebSphere Portal Business Solutions Catalog
The New Site Wizard becomes available as a portlet after the WAR file is installed as an application in IBM WebSphere® Portal. Upon being added to a page in Portal, the portlet provides an intuitive graphical user interface that prompts the user to specify the minimum, mandatory information required to generate a site.
Before we begin, note the following prerequisites:
Figure 1. Package contents
- IBM Web Content Manager should be installed. Refer to the “Installing and Migrating” sections of WebSphere Portal and IBM Web Content Manager product documentation for detailed installation steps.
- Download the New Site Wizard package from the IBM WebSphere Portal Business Solutions Catalog and save it. The package contains two folders named wp6.1.x and wp7.0.x for Portal versions 6.1.x and 7.0.x, respectively. The contents of each folder are shown in figure 1.
Before installing the portlet and using the Wizard to create sites on demand, we need to run the “configure-express” task, using the ConfigEngine framework. This task basically creates the required artifacts in WCM that enable you to use the Wizard to create sites using pre-defined templates. The artifacts include default Web content libraries and required WCM components, templates, and default content.
Before running this task, however, we must edit the wkplc.properties, wkplc_comp.properties, or wkplc_dbdomain.properties file, (depending on the version of product being used). These properties files are located in the <wp_profile>/ConfigEngine/properties folder. Here are the steps:
- First, make a backup of these files and then open the wkplc.properties file in an editor.
- Look for “WasPassword” and specify the WebSphere Application Server (WAS) password against this parameter; also, look for “PortalAdminPwd'' and specify it in the file as well.
- Similarly, open wkplc_comp.properties or wkplc_dbdomain.properties and key-in the database passwords for all dbdomains in Portal. The parameter would look like “<dbdomain>.dbPassword”, for example, “jcr.dbPassword”.
Note that we could specify these passwords at the command line while issuing the command, using the syntax -D<paramName>=<paramValue>. However, since there are so many passwords required, to avoid typographical errors, it is recommended to edit the files for these password and remove them once task is successfully executed.
4. To run the task, navigate to the path, <wp_profile>/ConfigEngine, on a command prompt and issue the command using the below syntax:
This syntax assumes that the passwords have been updated in the respective properties files. If not, specify the passwords at the command line using the syntax stated above.
Once the task completes successfully, we can begin to install the Wizard WAR file.
Installing the WAR file in WebSphere Portal
To do this, follow these steps:
1. Log in to WebSphere Portal as an administrator and, on the Home page, click the Administration link at the top (see figure 2).
Figure 2. Portal Home page
2. On the Administration page, click Web Modules (see figure 3), and then on the right-hand pane, click the Install button (see figure 4).
Figure 3. Administration page
Figure 4. Administration page with WebModules listing
3. On Manage Web Modules page, select the New Site Wizard WAR file, using the Browse button to browse to the file path on the local machine (see figure 5).
Figure 5. Manage Web Modules page
4. Click Finish to complete the installation of the WAR file (see figure 6).
Figure 6. View WAR file contents page
This successfully installs the Wizard WAR file as a Web Module (see figure 7). The application is now available as a portlet that can be added to Portal pages, which we discuss in the next section.
Figure 7. Manage Web Module page with successful installation message
Adding the wizard portlet to the Portal page
To do this:
Figure 8. Manage Pages with ContentRoot
- On the Administration page, select Manage Pages on the left-hand navigation pane (see figure 8); the existing pages in Portal are displayed.
- We can create a new page or select an existing page to which to add this wizard portlet. To do this, click ContextRoot (starting point for all pages in Portal) and browse to the Administration page.
3. We can relate the pages listed under Administration with the links in the left-hand pane that we get on the Administration page. Click the New Page button to create a new page on which to add the portlet (see figure 9).
Figure 9. Page listing of Administration Page
4. The Page Properties window displays; enter the values for the Title, Unique Name, and Friendly URL Name fields for the new page (see figure 10). Click OK.
Figure 10. Page Properties window
5. The Site Creation Wizard page is created and displays in the list of pages under the Administration page. Click the pencil icon on the right-hand side in the row listing the Site Creation Wizard, to add the wizard portlet to the page (see figure 11).
Figure 11. Manage Pages window with Site Creation Wizard page
6. In the Edit Layout page, click the Add Portlets button to add the portlet to the page (see figure 12).
Figure 12. Edit Layout page to add portlets
7. Enter part of the name or title (here, “New”) in the Search box and click the Search button. The results list the portlet as “New Site Wizard”; check the box and click OK (see figure 13).
Figure 13. Search for portlets to be added
8. The portlet is added successfully and can be seen on the page (see figure 14). If you like, you can add more portlets to the page similarly; when you are finished, click Done.
Figure 14. Edit Layout page with New Site Wizard portlet added
9. The page “Site Creation Wizard” can be seen in the left-hand pane along with the other pages (see figure 15). Click on the page title to use the Wizard.
Figure 15. Administration Page with Site Creation Wizard page listed
Using the Wizard to create sites
Now that the portlet has been added to the page, the Wizard is ready to be used:
1. Select the Site Creation Wizard page; the Welcome page displays (see figure 16). Click the “Lets get started” link to begin.
Figure 16. New Site Wizard Welcome page
2. On the next page, the Wizard asks for details about the new Web site, such as the name of the company and the administrator for the site. After entering the details, click Next (see figure 17).
Figure 17. Site details page
3. The next page shows the defaults templates available for the site. The Basic, Basic with Policies, and Intranet content site templates are shown in figures 18, 19, and, 20, respectively. You can select any of these based on your requirements; however, note that artifacts are created in WCM only for Internet and Intranet templates.
Figure 18. Basic template
Figure 19. Basic with Policies template
Figure 20. Intranet content site template
4. Let's select the Internet content site template, and click the “Create your site” button to start creating our Web site (see figure 21).
Figure 21. Internet content site template
5. The next pages show the progress of Web site being created as it imports content from WCM (see figures 22 and 23).
Figure 22. Importing content
Figure 23. Creating pages
6. When the Web site creation is complete, a page displays with options to launch the site or to start the creation process again (see figure 24).
Figure 24. Site creation complete
7. Clicking the “Go to my site” link takes you to the public Home page of your newly created Web site. This is what appears to a normal user; you can log in to the site using administrator credentials via the Log In link on the top-right corner of the page (see figure 25).
Figure 25. Public Home page of the new Web site
8. Once you are logged in and hover your mouse on contents of the page, you can see in-line editing options for that content that help you to better manage your content (see figure 26).
Figure 26. Home page of Web site for admin users
9. When you click the Edit for Product One, a pop-up window opens containing all the attributes for the content. Update the display title, and select Save and Close from the Save drop-down menu (see figure 27).
Figure 27. Edit window for Product One
10. Once the page reloads, the changes are reflected (see figure 28).
Figure 28. Home page with display title change for Product One
11. You have some limited administration options for this new Web site; for example, you can define access control for users of the site and define URI mapping (see figure 29).
Figure 29. Administration page for the Web site
You can see how easy it is to create a Web site using the Wizard. The site is created as a virtual portal, which is a portal interface using the same resources as that of a parent portal, but it provides options to customize the portal per user requirements and offers limited administration options.
For more information on virtual portals, refer to the “Multiple virtual portals” topic in the WebSphere Portal Product Documentation.
A Web site created by use of the Wizard creates and uses content from the WCM system. In this section we explore the WCM artifacts created for this so that you can better understand how sites are created using artifacts of WCM:
Figure 30. Web Content Libraries window
- On the Administration page, under Portal Content in the left-hand pane, select Web Content Libraries; this lists all the libraries that exist in WCM (see figure 30). We used the name “PortalCompany”, hence a library with this name can be seen in the list.
- Internet Web Content 7.0.0 and Intranet Web Content 7.0.0 were created when we ran the configure-express task at the beginning of this exercise, and these are used as template sources for any internet or intranet site that is created with the Wizard; others are default libraries that come with the WCM product.
3. To go to WCM, click Applications on top of the Home page, and select “Web Content Management” from the Content drop-down list (see figure 31).
Figure 31. Applications page
4. The Library Explorer window that opens lists the libraries that we can explore using the Authoring Portlet, in which we create, edit, and view WCM artifacts and components (see figure 32).
Figure 32. WCM Library Explorer window
5. Notice that this list doesn't include the “Library PortalCompany” created by us. To add it to the Explorer, click Preferences and then click Configure (see figure 33).
Figure 33. Library Explorer page with Preferences options
6. This takes you to the Configure page showing various configuration options. Expand the Library Selection section, select Library PortalCompany from the Available Libraries list, and click the Add button (see figure 34).
Figure 34. Configure window of Library Explorer
7. The Library is added to the Selected Libraries list; click OK to return to Library Explorer page (see figure 35).
Figure 35. Configure window with Library TestCompany in list
The Library now appears in the list of available libraries that can be explored by use of the Authoring Portlet (see figure 36).
Figure 36. Library Explorer with Library TestCompany
8. Select Library PortalCompany, expand Item Views on the left-hand side, and then select All Items --- All --- All Types, to see all the items created to build this Web site (see figures 37 and 38).
Figure 37. All Items select options
Figure 38. All Items view for Library TestCompany
9. You can click on individual items to explore and understand more about their usage. Alternatively, you can navigate starting from Library and then selecting components and items below it, to understand their flow and usage (see figure 39).
Figure 39. Items below Library TestCompany
Figure 40 shows the list of products that were seen on the Home page of the PortalCompany Web site. We navigated to the list, using the Library explorer path, Libraries --- Library PortalCompany --- Content --- Internet --- Home --- Products.
Figure 40. Content Items for Products under Homepage
You should now be able to create, manage, and edit your own WCM Web sites using the New Site Wizard.
IBM Web Content Manager Product page:
Product Documentation for IBM Web Content Manager:
Learn how to create portal sites on demand:
WebSphere Portal 7 documentation:
About the author
completed his Master of Computer Application (M.C.A.) degree from Motilal Nehru National Institute of Technology (MNNIT), Allahabad, before joining IBM as a Software Developer. He has worked on the Java Content Repository (JCR) team for the past three years, focusing on the dbutils and migration components of JCR. You can reach him at email@example.com