CMSEditModeButtonAdd

The CMSEditModeButtonAdd control displays a button that allows content editors to add new pages. The button only appears in the Edit mode of the Pages application and in On-site editing mode.

Getting started

The following tutorial shows how to display a button that creates new news pages on an ASPX page template:

1. Create a new ASPX page template.

2. In Visual Studio, drag the CMSEditModeButtonAdd control from the toolbox onto the page template’s form.

3. Set the following properties for the control:

   • ClassName: CMS.News
   • Path: /News

<cms:CMSEditModeButtonAdd ID="CMSEditModeButtonAdd1" runat="server" Path="/News" ClassName="CMS.News" />

4. Switch to the template’s code behind and using statements referring to the following namespaces:

   Copy

   
   
   
    using CMS.PortalEngine;
    using CMS.Helpers;
    using CMS.DocumentEngine.Web.UI;
    using CMS.Base.Web.UI;
   
   
    

5. Add the following code to the Page_Load method:

   Copy

   
   
   
    // Registers the edit mode button script
    if (!PortalContext.ViewMode.IsLiveSite())
    {
        ScriptHelper.RegisterClientScriptBlock(this, typeof(string), ScriptHelper.EDIT_DOCUMENT_SCRIPT_KEY, CMSControlsHelper.EditDocumentScript);
    }
   
   
    

   The code above is required if you wish to use the control individually on an ASPX page template.

6. Create a page based on the template in the Kentico administration interface.

If  you view the page in the Edit mode of the Pages application, the control displays a button that allows you to add news pages.

Clicking the button redirects you to the form where you can create the news pages.

Configuration

You can set the following properties for the CMSEditModeButtonAdd control:

Appearance and styling

The appearance of the CMSEditModeButtonAdd control is determined by the CMSEditModeButtonAdd CSS class.

The recommended place to define the class is in a Kentico stylesheet using the CSS stylesheets application.

You can apply stylesheets to:

• Entire websites
• Individual pages that contain the control