Configuring episerver.shell (CMS 8) | Optimizely Developer Commun

This is a pseudo code description of the element structure of the <episerver.shell> section in EPiServer framework. Refer to the Configuration section for an explanation of the syntax used in the description of the configuration elements.

Each element name below is also a link leading to the detailed information for that element.

<episerver.shell>   
   <dashboard>
   <navigation>
   <protectedModules>
   <publicModules>
</episerver.shell>

<dashboard>

XML

 <dashboard defaultService="string" >
   <disabledGadgets>
      <add name="string" /> 
      ... 
   </disabledGadgets> 
  <templates> 
      <add forRoles="string" > 
          <tabs>
             <add layout="string"
                  name="string" >
                   <gadgets>
                      <add column="int"
                           name="string" >
                   </gadgets>
             </add>
             ...
          </tabs>
          ...
   </templates>
</dashboard>

<disabledGadgets>/<add> Element Attributes

Name	Default Value	Description
name		*Required*. The class name, including namespace, of the gadget to be disabled.

<templates>/<add> Element Attributes

Name	Default Value	Description
forRoles		*Required*. Comma-separated list of roles for which the template should apply.

<tabs>/<add> Element Attributes

Name	Default Value	Description
layout		*Required*. The name of the layout to be used on this tab. Example: “2 Column”.
name		*Required*. The name of the tab.

<gadgets>/<add> Element Attributes

Name	Default Value	Description
column		*Required*. The zero-based index of the column in which this gadget should be placed.
name		*Required*. The class name of the gadget, including namespace.

<navigation>

XML

<navigation>
   <add alignment="MenuItemAlignment"
        menuItemType="MenuItemType"
        menuPath="string"
        sortIndex="int"
        target="string"
        text="string"
        url="string" />
  ...<br /></navigation>

<navigation> Element Attributes

Name	Default Value	Description
alignment	MenuItemAlignment.Left	The alignment of the menu item. Possible values are Left and Right.
menuItemType	MenuItemType.Link	The type of this menu item. Possible values are Link, Section and DropDown. Link items must be children of container items, either a Section or a DropDown. The hierarchy of menu items is controlled by via the menuPath attribute.
menuPath		*Required. The menu path/key of this menu item. The path defines the structure and is also the unique key to this menu item. “/global/” refers to the full menu area, menuPath* must start with “/global/” to be visible in the menu. Example: the following configuration will create one new menu section containing one link. XML `<add text="MySection" menuPath="/global/mySection" menuItemType="Section" /> <add text="MySectionLink" menuPath="/global/mySection/myLink" url="/folder/file.aspx" />`
sortIndex		The sort index of this menu item. Menu items are sorted from low to high within each section.
target		The frame in which to open the linked file.
text		*Required*. The text that should appear in the menu item.
url		The URL of the file to be opened.

<protectedModules>

XML

<protectedModules autoDiscovery="AutoDiscoveryLevel"
                  rootPath="string" >
  <add clientResorcePath="string"
         name="string"
         resourcePath="string" >
    <assemblies>
     <add assembly="string" />
     ...
    </assemblies>
  </add><br />  ...
</protectedModules>

<protectedModules> Element Attributes

Name	Default Value	Description
autoDiscovery	AutoDiscoveryLevel.Minimal	Option for probing the the module folder and load of module assemblies automatically on start-up. Possible values are: Minimal will only load modules configured by web.config and associate assemblies explicitly configured in web.config. Modules auto-discover modules in the module directory and load assemblies defined in the module’s module.config file and load assemblies located in the module’s bin directory in addition to those defined in the module’s module.config file.
rootPath		*Required*. The root path below which module directories are located.

<protectedModules>/<add> Element Attributes

Name	Default Value	Description
clientResourcePath		The client resource path. If no value is specified the resourcePath is used.
name		*Required. The name of the module/folder. If no resourcePath* value is specified the name value is combined with the rootPath value to form the path to the module folder.
resourcePath		The path to the module directory.

<assemblies>/<add> Element Attributes

Name	Default Value	Description
assembly		*Required*. An assembly to load and associate with the module. The assemblies listed in this collection may be combined with assemblies defined by the module depending on the auto discovery option.

<publicModules>

<publicModules autoDiscovery="AutoDiscoveryLevel"
               rootPath="string" >
   <add clientResorcePath="string"
        name="string"
        resourcePath="string" >
      <assemblies>
         <add assembly="string" />
         ...
      </assemblies>
   </add>
   ...
</publicModules>

<publicModules> Element Attributes

Name	Default Value	Description
autoDiscovery	AutoDiscoveryLevel.Minimal	Option for probing the the module folder and load of module assemblies automatically on start-up. Possible values are: Minimal will only load modules configured by web.config and associate assemblies explicitly configured in web.config. Modules auto-discover modules in the module directory and load assemblies defined in the module’s module.config file and load assemblies located in the module’s bin directory in addition to those defined in the module’s module.config file.
rootPath		*Required*. The root path below which module directories are located.

<publicModules>/<add> Element Attributes

Name	Default Value	Description
clientResourcePath		The client resource path. If no value is specified the resourcePath is used.
name		*Required. The name of the module/folder. If no resourcePath* value is specified the name value is combined with the rootPath value to form the path to the module folder.
resourcePath		The path to the module directory.

<assemblies>/<add> Element Attributes

Name	Default Value	Description
assembly		*Required*. An assembly to load and associate with the module. The assemblies listed in this collection may be combined with assemblies defined by the module depending on the auto discovery option.