Feature Pack 6 or later

Adding support for the IBM Web Content Manager Multilingual Solution

The IBM Web Content Manager Multilingual Solution is a set of tools that are used to manage translated versions of a store. If your store requires that content be available in multiple languages, add the IBM Web Content Manager Multilingual Solution to the integration between WebSphere Commerce and IBM Web Content Manager.

For more information, see IBM Web Content Manager Multilingual Solution.

Before you begin

To display content in multiple languages for a store, the languages must be supported for that store within Management Center. Ensure that you update the store information in Management Center to support the languages that content can be retrieved for within IBM Web Content Manager.

Procedure

  1. On your WebSphere Portal machine, enable the IBM Web Content Manager Multilingual Solution.
    1. Open a command-line utility. Go to the following directory:
      • WP_installdir\ConfigEngine
    2. Run the commands to install and deploy the solution extensions:
      • ConfigEngine.bat register-wcm-mls -DWasPassword=mypassword -DPortalAdminPwd=myadminpassword
      • ConfigEngine.bat deploy-wcm-mls -DWasPassword=mypassword -DPortalAdminPwd=myadminpassword
    3. Restart the WebSphere Portal Server.
  2. Install the wcm.wcs.integrator samples.
    1. In the command-line utility, navigate to the following directory:
      • WP_installdir\ConfigEngine
    2. Run the command to install the samples
      • ConfigEngine.bat deploy-wcm.wcs.integrator-samples -DWasPassword=your_WebSphere_Application_Server_password -DPortalAdminPwd=your_WebSphere_Portal_Admin_password
    3. Restart the WebSphere Portal Server.
  3. Prepare the libraries and set permissions
    1. Log in to WebSphere Portal as an administrative user.
    2. Click Applications > Web Content Management.
    3. Expand Preferences. Click Edit Shared Settings.
    4. Expand Library Selection. Select the libraries for the WebSphere Commerce integration with IBM Web Content Manager. Add the libraries to the list of Selected Libraries.
    5. Click OK. In the Library Explorer view, ensure that the libraries display.
      Note: This library has samples for each content type. If you want to add content to a library, add the content before you make any local copies of the library. For more information about adding content to a library, see the topic "Creating content items" in the IBM WebSphere Portal product help.
    6. Add the WebSphere Commerce administrative users to the IBM Web Content Manager administrative role, and the authenticated users to the user role for the library.
      For more information about creating a library, see the topic "Defining roles within a library" in the IBM WebSphere Portal product help.
  4. Create the Multilingual Solution libraries in different languages.
    1. Click Administration > Portal Content > Multi Locale Solution Library Copy.
    2. Select the language that you want to use as the locale.
    3. Type in the new library name with the convention your_library_name_language.
      For example, AuroraEsite_fr for a library with content in French.
    4. Click Copy.
    5. Repeat the preceding substeps to create libraries in all of the language that you require.
  5. Update the Multilingual Solution references.
    1. Open the IBM Web Content Manager application.
    2. Open the multilingual configuration library.
    3. In this library, click Content > ConfigurationHome > ConfigurationData. Click your library.
    4. Open the LocalizedConfiguration file for editing.
    5. Add the libraries that you created to the Content Libraries and Content Library Owners lists.
      1. Scroll to the Content Libraries section.
      2. Add the libraries that you created after your default content library separated by commas. For example, AuroraESite_en, AuroraEsite_fr, AuroraEsite_de
      3. Scroll to the Content Library Owners section.
      4. Add the libraries that you created after your default content library in a list, adding =wcsadmin@aurora.com after each library.
    6. Click Save and Close.
  6. Edit the IBM Web Content Manager preference for the WebSphere Commerce portlet application. Set the value for this preference to be the names of the language libraries that you want to use in WebSphere Commerce.
    For more information about adding a preference to a library, see the topic "Modifying portlet settings" in the IBM WebSphere Portal product help.
  7. On your WebSphere Commerce server, verify that the Multilingual Solution links work successfully.
    1. Open the Marketing tool.
    2. From the toolbar, click the New icon Create New icon; then select Content.
    3. For the Associated asset table, select URL in the dropdown menu. Select the Edit managed content button next to the URL entry in the table. The punch-out window to IBM Web Content Manager opens.
    4. Use the punch-out window to select a piece of content in IBM Web Content Manager from one of the Multilingual Solution libraries and save your selection.
      Ensure that the URL to the content you selected in IBM Web Content Manager displays in Management Center.
    5. Save your content.
    6. Right-click the URL in the Associated asset table. Click Open.
      The properties for the URL display. Ensure that links for each language that the content is available for displays in the properties view.