Site Config Configuration

The Site Config configuration file allows you to specify which items can be accessed from the dropdown list in Site Config -> Configuration.

To find this configuration xml through studio follow the next instructions:

  1. Click on siteConfig located in the Sidebar.

  2. Choose Configuration from the menu.

  3. Select Configurations.

Configurations - Open Configurations

Sample

Here’s a sample config-list.xml file:

SITENAME/config/studio/administration/config-list.xml
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
<?xml version="1.0" encoding="UTF-8"?>
<!--
    This file configures the list of configurations available in the SiteConfig section for this site/blueprint.

    For every configuration you'd like to make editable, you need:
        <file>
            <path />
            <title />
            <description />
            <samplePath />
        </file>

    The elements are:
    - path: the path to the file. This path is rooted in /config off the base of the site/blueprint
    - title: the title of this file. This should be a key into the string-table in Studio's localization string table
        "base.js", if no entry is found, Studio will use the string you have here as is
    - description: the description of this file.  This should be a key into the string-table in Studio's localization
        string table "base.js", if no entry is found, Studio will use the string you have here as is
    - samplePath: the path to a sample file to help the user update the file
-->
<config>
    <files>
        <file>
            <path>/studio/site-config.xml</path>
            <title>confTabSiteConfiguration</title>
            <description>confTabSiteConfigurationDesc</description>
            <samplePath>/studio/administration/samples/sample-site-config.xml</samplePath>
        </file>
        <file>
            <path>/studio/context-nav/sidebar.xml</path>
            <title>confTabSidebarConf</title>
            <description>confTabSidebarConfDesc</description>
            <samplePath>/studio/administration/samples/sample-sidebar.xml</samplePath>
        </file>
        <file>
            <path>/studio/form-control-config/rte/rte-setup.xml</path>
            <title>confTabRTEConf</title>
            <description>confTabRTEConfDesc</description>
            <samplePath>/studio/administration/samples/sample-form-control-rte-setup.xml</samplePath>
        </file>
        <file>
            <path>/studio/preview-tools/components-config.xml</path>
            <title>confTabPreviewComponentsConf</title>
            <description>confTabPreviewComponentsConfDesc</description>
            <samplePath>/studio/administration/samples/sample-preview-components-config.xml</samplePath>
        </file>
        <file>
            <path>/studio/targeting/targeting-config.xml</path>
            <title>confTabTargetingConfiguration</title>
            <description>confTabTargetingConfigurationDesc</description>
            <samplePath>/studio/administration/samples/sample-targeting-config.xml</samplePath>
        </file>
        <file>
            <path>/studio/preview-tools/panel.xml</path>
            <title>confTabPreviewPanelConf</title>
            <description>confTabconfTabPreviewPanelConfDesc</description>
            <samplePath>/studio/administration/samples/sample-preview-panel.xml</samplePath>
        </file>
        <file>
            <path>/studio/workflow/notification-config.xml</path>
            <title>confTabNotificationConf</title>
            <description>confTabNotificationConfDesc</description>
            <samplePath>/studio/administration/samples/sample-notification-config.xml</samplePath>
        </file>
        <file>
            <path>/studio/permission-mappings-config.xml</path>
            <title>confTabPermissionsMappings</title>
            <description>confTabPermissionsMappingsDesc</description>
            <samplePath>/studio/administration/samples/sample-permission-mappings-config.xml</samplePath>
        </file>
        <file>
            <path>/studio/role-mappings-config.xml</path>
            <title>confTabRoleMappings</title>
            <description>confTabRoleMappingsDesc</description>
            <samplePath>/studio/administration/samples/sample-role-mappings-config.xml</samplePath>
        </file>
        <file>
            <path>/studio/environment/environment-config.xml</path>
            <title>confTabEnvironmentConfiguration</title>
            <description>confTabEnvironmentConfigurationDesc</description>
            <samplePath>/studio/administration/samples/sample-environment-config.xml</samplePath>
        </file>
        <file>
            <path>/studio/data-sources/cmis-config.xml</path>
            <title>confTabCMISConfiguration</title>
            <description>confTabCMISConfigurationDesc</description>
            <samplePath>/studio/administration/samples/sample-cmis-config.xml</samplePath>
        </file>
        <file>
            <path>/studio/context-nav/contextual-nav.xml</path>
            <title>confTabContextualNavigationConf</title>
            <description>confTabContextualNavigationConfDesc</description>
            <samplePath>/studio/administration/samples/sample-contextual-nav.xml</samplePath>
        </file>
        <file>
            <path>/studio/administration/site-config-tools.xml</path>
            <title>confTabSiteConf</title>
            <description>confTabSiteConfDesc</description>
            <samplePath>/studio/administration/samples/sample-site-config-tools.xml</samplePath>
        </file>
        <file>
            <path>/studio/administration/config-list.xml</path>
            <title>confTabConfigurations</title>
            <description>confTabConfDesc</description>
            <samplePath>/studio/administration/samples/sample-config-list.xml</samplePath>
        </file>
        <file>
            <path>/studio/mime-type.xml</path>
            <title>Mime Types</title>
            <description>mime Types</description>
            <samplePath>/studio/administration/samples/sample-mime-type.xml</samplePath>
        </file>
    </files>
</config>

Description

List of available configuration tags

Tag
Description
files
This tag contains each file.
file
This tag contains the configuration of each file.
path
Path where the system will find the specific xml file
title

This tag refers to file title. It will be showed in the configuration
dropdown at the top of the page. See #1 in the image above
description

This tag refers to file description. It will be showed to explain the file
functionality. See #2 in the image above
samplePath

Path where the system will find an example of the specific xml.
See #3 in the image above

Sample File

You can click on the View Sample button to see a configuration file example.

Basic Configuration Sample

Adding a new configuration file

To add a new configuration file please follow the steps below.

  1. Add file tags to the configuration list xml file (config-list.xml).

    SITENAME/config/studio/administration/config-list.xml
        <file>
                <path>/workflow-config.xml</path>
                <title>Workflow Configuration</title>
                <description>Defines workflows available in the system</description>
                <samplePath>/administration/samples/sample-workflow-config.xml</samplePath>
        </file>
    
    Basic Configuration Step 1
  2. Click on the Save button

    Basic Configuration Step 2
  3. Go to configuration tab, then open the dropdown and finally look for your new configuration file

    Basic Configuration Step 3