Configure the behavior of Gallery widgets by checking out
and editing gallery-config.xml. Galleries are
community widgets that display thumbnails of files such as photos,
videos, and office documents.
About this task
Check out gallery-config.xml, edit
the gallery configuration properties, and then check the file back
in.
Procedure
To edit the gallery configuration properties, complete
the following steps.
- Start the wsadmin client.
- Use the wsadmin client to access and check out the IBM® Connections configuration files:
-
Enter the following command to load the IBM Connections
configuration file: execfile("connectionsConfig.py")
If you are prompted to
specify a service to connect to, type 1 to
select the first node in the list. Most commands can run on any node.
If the command writes or reads information to or from a file by using
a local file path, you must select the node where the file is stored.
This information is not used by the wsadmin client when you are making
configuration changes.
- Enter the following command to check out the gallery-config.xml configuration
file:
LCConfigService.checkOutGalleryConfig("working_directory","cell_name")
Where:
- working_directory is the temporary working directory to which the
configuration XML and XSD files are copied and are stored while you change them. Use forward slashes
to separate directories in the file path, even if you are using the Microsoft™
Windows™ operating
system.
Note: AIX®, and Linux™ only: The
directory must grant write permissions or the command does not run
successfully.
- cell_name is the name of the WebSphere® Application Server cell that
hosts the IBM Connections application.
If you do not know the cell name, type the following command while
in the wsadmin command processor: print AdminControl.getCell()
Note: This
input parameter is case-sensitive.
For example:
- AIX or Linux: LCConfigService.checkOutGalleryConfig("/opt/temp","foo01Cell01")
- Microsoft Windows: LCConfigService.checkOutGalleryConfig("c:/temp","foo01Cell01")
- Open gallery-config.xml in an editor
and edit any of the configuration properties that are outlined in
table 1.
Table 1. Configuration properties
Configuration property |
Description |
Possible values |
Default |
maxNumberOfEntries |
The maximum number of thumbnails to show in
the Gallery. |
Any positive integer. |
12 |
maxNumberOfRows |
The maximum number of rows of thumbnails to
show in the Gallery. |
Any positive integer. |
2 |
sources |
The types of folders to show in the gallery.
If sources is set to communityFolders,
only folders that are created in this community can be displayed in
the Gallery. If sources is set to communityFolders,personalFolders,
personal folders that are shared with the community can also be displayed
in the Gallery. Note: If personal folders can be displayed in the
Gallery, then community folders must also be displayed in the Gallery |
communityFolders or communityFolders,personalFolders |
communityFolders,personalFolders |
- Save gallery-config.xml and check
it in using the following command:
LCConfigService.checkInGalleryConfig("working_directory",
"cell_name")
- Type the following command to deploy the changes:
synchAllNodes()
- To exit the wsadmin client, type exit at
the prompt.
- Stop and restart all of the IBM Connections
application servers.