Desktop User Guides > Professional > Using UNICOM Intelligence Professional > Using UNICOM Intelligence Professional to develop interviews > Using the Gallery > Adding custom Gallery items
 
Adding custom Gallery items
The Gallery is completely configurable. You can add library items or sections to the existing Gallery. You can also remove the existing Gallery and create a custom Gallery. The Gallery is simply a different view of Library items (the Gallery and Library use the same directory). However, the Gallery uses additional files to support the Gallery display and filtering.
The easiest way to familiarize yourself with modifying the Library is by simply exploring the existing library. The Library is located at the library file location that is specified in the Options dialog's Library tab (via the Tools menu). The Library contains separate directories for each section (by default Functionality, Questions, Survey Fragments, and Templates). The Library also contains the GalleryInformation directory and the Library.xml file.
The Library.xml file describes the sections displayed on the main page as well as the section items at the top of the browser page. The Library.xml sections must be accompanied by a directory of library items. Each section typically has a subdirectory in the Library folder. For example, the Library.xml file describes a Survey Fragments section that is associated with the Survey Fragments directory. For more information about the Library.xml file, see Adding custom Gallery items.
The GalleryInformation subdirectory typically contains the section images on the main page. The subdirectory also contains the Template.dcprop file, which is used for any library item that does not have an associated .dcprop file. The GalleryInformation\DefaultThumbnails directory contains the default thumbnails used if a library item does not have an associated .dcprop file or if the Thumbnail tag for the associated .dcprop file is empty.
Each section has an associated directory. The section directory contains the Section.xml file that defines the tags and tag layout for the section. Tags can be defined differently for each section (for example, this allows different tags to be used to describe templates versus questions). For more information on the Section.xml file, see Adding custom Gallery categories.
The sections directories also contain library items and subdirectories. The directory layout for each section is used in the Library view. This allows directories to organize the library items for the Library view. The .dcprops files are used to organize library items for the Gallery view.
See also
Adding new library items
Creating thumbnails and screen captures
Adding custom Gallery items
Adding custom Gallery categories
Using the Gallery
Adding new library items
To add a new library item, save your NewItem.mdd or NewItem Wizard.mdd to the section directory or to a subdirectory that provides a logical Library structure. “Wizard” is typically used in the library item name to help users who use accessibility technologies to easily identify that a wizard will be run when the item is selected. Save associated files to the NewItem.mdd_files (or NewItem Wizard.mdd) subdirectory and reference them solely from that directory. When a wizard is associated with the library item, it can be saved in the NewItem.mdd_files subdirectory or in the QWzd subdirectory.
For more information, see Creating questionnaire wizards for UNICOM Intelligence Author.
Create a NewItem.dcprop (or NewItem Wizard.dcprop) file to describe the NewItem.mdd and save any files required by the .dcprop into the NewItem.gallery_Files directory. For more information on the .dcprop file, see Adding custom Gallery items.
See also
Adding custom Gallery items
Creating thumbnails and screen captures
It is useful to use existing images as a template for size and shape when creating thumbnails and screen captures for display in the Gallery. As an example, you can use the images that are in the \Library\Functionality\Change Language Wizard.gallery_Files directory.
When creating new thumbnails or screen captures, use the following image dimensions:
Thumbnails: 75 x 100 pixels
Screen captures: 330 x 380 pixels
See also
Adding custom Gallery items
Adding custom Gallery items
You can add new Gallery items by creating a Gallery used.dcprop file and folder. For example:
NewItem.mdd
  NewItem.dcprop
  NewItem.gallery_Files
The *.dcprop file information is as follows:
<?xml version="1.0" encoding="utf-8"?>
<LibraryItem>
  <Title Language="en">NewItem</Title>--------------> Item title.
  <Thumbnail> NewItem.png</Thumbnail>---------------> Item thumbnail that
must be in the
NewItem.gallery_Files
folder. The default
thumbnail is used when
this section is empty.
  <Description Language="en">Ranking</Description>--> Item description.
  <Notes Language="en">Ranking</Notes>--------------> Item notes.
  <Requirements Language="en">None</Requirements>---> Item requirement.
  <Screenshots>
    <Screenshot>------------------------------------> When the library
includes screenshots, a
<Screenshot> section
should be added.
      <Url>NewItemSnapshot.png</Url>----------------> Relative screenshot
image path. The image
must be in the
NewItem.gallery_Files
folder.
      <Caption Language="en">NewItem</Caption>------> Name of the screenshot.
    </Screenshot>
  </Screenshots>
  <Tags>
    <Tag>GridNumeric</Tag>-------------------------------> Tag of the item.
This will be used
in the filter
option feature, and
should be
consistent with Tag
ID.
    <Tag>Ranking</Tag>
    <Tag>en-us</Tag>
  </Tags>
  <Author>
     UNICOM Systems, Inc.
  </Author>
  <Copyright>Copyright @2012</Copyright>
</LibraryItem>
Notes
When adding a new tag in the dcprop file, it is better to add the tag to the Section.xml file that is located under the library category's root folder. For example:
Library
-----Question
                -----Section.xml
When a tag is not defined, or a tag is not in the Section.xml file, the gallery will use Untagged as the default tag value.
See also
Adding custom Gallery items
Adding custom Gallery categories
The following steps outline the process of creating new library item categories (functionality, questions, templates and so on). The categories display as items in main pages, and as section items at the top of the browser page.
1 Modify the library.xml file.
<Library>
<Categories>
<Category>
<Name Lang = "en">Survey Fragments</Name>
<Thumbnail>GalleryInformation\Survey Fragments.png</Thumbnail >
<Path>Survey Fragments</Path>
</Category>
<Category>
<Name Lang = "en">Questions</Name>
<Thumbnail>GalleryInformation\Controls.png</Thumbnail >
<Path>Questions</Path>
</Category>
<Category>
<Name Lang = "en">Functionality</Name>
<Thumbnail>GalleryInformation\Functionality.png</Thumbnail >
<Path>Functionality</Path>
</Category>
<Category>
<Name Lang = "en">Layouts</Name>
<Thumbnail>GalleryInformation\Layouts.png</Thumbnail >
<Path>Templates</Path>
</Category>
</Categories>
<Category>
<Name Lang = "en">Customer</Name>-----> The name of the new
library category.
<Thumbnail>
GalleryInformation\Customer.png
</Thumbnail >-------------------------> Default category thumbnail.
If the item in this category
does not have a dcprop, this
will be used in default
dcprop
<Path>Customer</Path>----------------> Relative category path.
</Category>
</Categories>
</Library >
2 Define the <Section> section's <Tags> values for the new category.
<Section>
<Tags>
<Name Language = "en">Question Types</Name>
<Tag>
<ID>SingleResponse</ID>------------------------>Tag ID.
<Name Language = "en">Single Response</Name>--->Tag Name. This also
supports multiple
languages.
<Tag>
</Tag>
</Section>
See also
Adding custom Gallery items