Adding a new group to a Ribbon toolbar tab

Add a group (a named set of controls) to a tab in the Ribbon toolbar as a container for your custom controls, or to organize controls differently.

Procedure

  1. Open the configuration file of your custom Editor in a plain-text or XML editor.
  2. In the extensions section, locate the ext:ribbontoolbars section. Inside this section, create or find an <ext:add> element.
  3. Find out the ID of the Ribbon toolbar tab that you want to create this group in: either a built-in Ribbon toolbar tab or one of the custom tabs you added, listed as an ext:extension element with its pageid and assignid set to the same value.
  4. For each group you want to create on a Ribbon toolbar tab, insert a new ext:extension element inside the <ext:add> element and set it up as follows:
    <ext:extension pageid="RibbonTabID" name="My Group" assignid="MyGroupID" insertbefore="AnotherGroupID">
      <ext:group/>
      <ext:apply>
        <ext:view name="DashboardView">
          <ext:control id="DashboardToolbar" />
        </ext:view>
      </ext:apply>
    </ext:extension>

    where RibbonTabID identifies the Ribbon toolbar tab you want to add this group to, My Group is the display name of the group you want to create, MyGroupID is the internal idenfitier for your group, and AnotherGroupID refers to the Ribbon toolbar tab to the left of which you want to insert your tab (omit insertbefore to make your Group the rightmost Group). If you want to add a Group to an existing Ribbon tab, you can find out its ID by examining the HTML of a Web page that displays the tab (the IDs of Ribbon tabs end in the word 'Page'). ext:view refers to the specific Ribbon toolbar and view that you add this new Group to.

  5. By default, a new Group can contain controls similar to the ones in other Groups. To make completely new and custom controls in your Group, create an ASCX control that inherits from the class Tridion.Web.UI.Controls.TridionUserControl, and implement your custom control. Refer to the GUI Extension API reference documentation for details. If you do this, set the contents of ext:control to this ASCX control.
  6. Save and close your configuration file and restart the Content Manager Explorer Web application.