Documentation Center

Customizing a new Ribbon toolbar tab

If you want to create a Ribbon toolbar tab that behaves differently from a normal Ribbon toolbar tab (which has Groups containing buttons), use the <ext:pagetype> element in a Ribbon toolbar tab extension configuration to specify your own custom client-side implementation of the tab.

Procedure

  1. First, ensure that you have configured a Ribbon toolbar tab in your custom Editor's configuration file.
  2. Create a JavaScript class that inherits from Tridion.Controls.RibbonPage and defines your custom implementation of the Ribbon tab. At the end of the file, call Tridion.Controls.Deck.registerPageType to register this new type of Ribbon tab under a specific name.
  3. Save this file as a .js file and add it to your Visual Studio solution.
  4. Create a new cfg:group element for this JavaScript file in your custom Editor's configuration file, and give it a dependency on the Ribbon Toolbar group in Content Manager Explorer.
  5. Add a ControlResources attribute to the server-side class for ASCX control, and set it to the name of this new resource group.
  6. In the ext:extension element that defines the Ribbon toolbar tab you want to customize, set ext:pagetype to the name under which you registered your new type of Ribbon tab.