Help > Web Development > Customizing Websites > Site Designer

Site Designer

The Perceptive Enterprise Search Site Designer allows you to quickly change certain aspects of a website without modifying the HTML. A website has to be "designer aware" to support these customizations.

The default Perceptive Enterprise Search website and new websites created with Perceptive Enterprise Search are automatically "designer aware". If you are importing an existing Perceptive Enterprise Search 8 website it will not be supported by the designer without modification.

There are two main parts to the site designer, "named sections" and "variables". A named section is an area of the website that you can simply choose to display or hide. This enables you to build feature rich templates and allow a site administrator to choose whether they want a particular section to show or not. A "variable" enables you to output a stored value onto the web page. For example, by storing the site name in a variable there is only one place to edit the name and have the change be automatically reflected across the entire site.

Variables

Each variable is outputted using the {Var} symbol. Use this symbol wherever you want the variable to be substituted. For example, to substitute the site name, use the following:

<head>
<title>{VAR name="SiteName" default="Perceptive Enterprise Search Site"}</title>
</head>

The default websites are pre-configured with the following variables:

SiteNameStores the website's name, usually displayed in the site's header.
Relevance.StyleOverride for the relevance bar style; values of either Default, Stars or Boxes.
Relevance.ColorSpecifies the color to use when rendering the relevance bar on Default or Boxes Mode.

Named Section

Each named section must be defined in the HTML of the particular web page or template. Named sections can be nested; multiple sections of the web page can be defined as the same section. To define a block of HTML as a named section surround it with the following:

{Section name="NameOfSection"}
...
{SectionEnd}

For example, to mark the entities section, use the following:

{Section name="Entities"}
  <b>Entities</b>
  {EntityList MaxItemsPerType="10"}
{SectionEnd}

The default websites are pre-configured with the following sections:

Home Page
ConceptShow the concept taxonomy on the front page
SearchOptionsDisplay the search options
SearchOptionMnuDisplay the menu-assisted search option
SearchOptionAdvDisplay the advanced search option
SearchOptionNatDisplay the natural language search option
Search Options
SearchStemDisplay the option to allow stemming.
SearchSoundsDisplay the option to allow sounds like.
FiltersDisplay the filter options
SearchConflateDisplay the conflation options
SearchThesaurusDisplay the thesaurus options.
Result List
SortBarDisplay the sort bar on the result list.
PageSelectionDisplay the page selection bar.
NavPanelDisplay the navigation panel.
CategoriesDisplay the categories list.
EntitiesDisplay the entities for the result list.
SubscribeDisplay the subscribe to search link.
Result List Items
DocIconDisplay the icon for each document.
DocRelevanceDisplay the relevance bar for each document.
DocDateDisplay the date for each document.
DocSizeDisplay the file size for each document.
DocHitsDisplay the hit count for each document.
DocFilenameDisplay the filename for each document.
Document View
DocumentNavigationBarDisplay the document view bar (Browse, Detail etc).
DocumentHeaderDisplay the document header, including icon and filename.
DocumentSearchTermsDisplay the search terms for the document.
DocumentEntitiesDisplay the entities for the document.

How Perceptive Enterprise Search stores customizations

The customization options for a website are stored in the website's Site.cfg file, which is located in the website's folder in Perceptive Enterprise Search\WebSites\SiteName. This file is an XML file and MUST be well-formed for Perceptive Enterprise Search to be able to open it.