Try our conversational search powered by Generative AI!

AI OnAI Off
Loading...
Area: Optimizely CMS
ARCHIVED This content is retired and no longer maintained. See the latest version here.

Recommended reading 

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

NameDefault ValueDescription
name   Required. The class name, including namespace, of the gadget to be disabled.

<templates>/<add> Element Attributes

NameDefault ValueDescription
forRoles   Required. Comma-separated list of roles for which the template should apply.

<tabs>/<add> Element Attributes

NameDefault ValueDescription
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

NameDefault ValueDescription
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

NameDefault ValueDescription
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

NameDefault ValueDescription
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

NameDefault ValueDescription
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

NameDefault ValueDescription
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

NameDefault ValueDescription
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

NameDefault ValueDescription
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

NameDefault ValueDescription
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.
Do you find this information helpful? Please log in to provide feedback.

Last updated: Jul 09, 2014

Recommended reading