Change media gallery image sizes 

Set maximum sizes for photo and video file preview images in media galleries. For example, lower the maximum size on preview images in the widget in the community home page to allow more images to display in the widget. Or increase the maximum size if the thumbnail images are too small for your client. This is optional.

Before you begin

To edit configuration files, use the IBM WAS wsadmin client. See Starting the wsadmin client for details.

About this task

Images that are larger than the specified container size are resized. For example, if the specified maximum size is 100x100 and a user uploads a 10x10 image, its size will not change. But if the user uploads a 150x150 image, it will be resized to 100x100.

You can change three maximum size properties:

For example, to change the maximum image size in the preview dialog and summary page to 900x900, change the detailview width and height properties from 450 to 900.


To configure photo sizes in the media gallery...

  1. Open the events-config.xml file, which is not checked out as part of the wsadmin check out command used to access the other core configuration files. You must retrieve the file from the file system on the system hosting the deployment manager.

    1. Go to the following directory on the system hosting the deployment manager:


        For example:


    2. Make a backup copy of the events-config.xml file in case you need to revert back to it.

    3. Open the events-config.xml file in a text editor.

  2. In the following postHandler element, edit the width and height values as measured in pixels:

      <postHandler enabled="true" invoke="ASYNC" name="PhotoRenditionEventHandler" class=""> 
      <property name="thumbnailviewwidth">78</property> 
      <property name="thumbnailviewheight">78</property> 
      <property name="galleryviewwidth">120</property> 
      <property name="galleryviewheight">120</property> 
      <property name="detailviewwidth">450</property> 
      <property name="detailviewheight">450</property> 

  3. Update the value of the version stamp configuration property to force users' browsers to pick up this change. See Required post-customization step for more details.

  4. Save and close the events-config.xml file.

  5. Synchronize the change you made to the configuration file on the deployment manager to the other nodes by completing the following steps:

    1. Log into the WAS admin console of the deployment manager using administrator credentials.

    2. Expand System Administration, and then click Nodes.

    3. Select the check box next to each node in your deployment, and then click Full Resynchronize.

  6. Stop and restart IBM Connections.

  7. If your files event content directory is not the same as the files content give the WebSphere Variable ${FILES_EVENT_CONTENT_DIR} the same value as ${FILES_CONTENT_DIR}:

    1. Log in to the WebSphere Administrative Console.

    2. Expand Environment and then click WebSphere Variables.


    4. In the Value field type ${FILES_CONTENT_DIR}.

    5. Restart the News application.

What to do next

To troubleshoot, enable tracing for:* See the IBM WAS documentation.

Parent topic

Configure media galleries

September 19, 2011 9:58:44 AM


Sep 19, 2011 9:58:44 AM 3 Aug 11, 2011 1:36:21 PM 2 Aug 11, 2011 1:30:02 PM 1