Content Editor

Visual components made available to users in the Content Editor.

Context Menu

The Context Menu integration reveals a list of options to the user in the context menu under a special node called Scripts. The Sitecore rules engine may be used to control visibility and enabled state. The script is only executed when the option is clicked.

1. Begin by adding a new script to the Context Menu library. The name of the script will appear in the context menu.

2. Edit the script to perform the appropriate actions. The script can run in the background and show dialogs.

3. Change the icon of the item to match the script purpose.

4. Configure any Enable or Show rules as needed.

Note: Examples included in the following modules

• Authoring Instrumentation

• Copy Renderings

• Index On Demand

• Media Library Maintenance

• Package Generator

  

• Task Management

See how Adam added context menu PowerShell scripts.

Gutter

The Gutter integration reveals a visual notification to the user in the far left gutter. The Sitecore rules engine may be used to control enabled state.

1. Begin by adding a new script to the Gutters library.

2. Edit the script to create a new instance of Sitecore.Shell.Applications.ContentEditor.Gutters.GutterIconDescriptor if the right conditions are met.

   • Set the Icon, Tooltip, and Click properties.

   • Return the gutter object

3. Configure any Enable rules to ensure the script runs only when necessary.

4. Rebuild the gutter integration from within the ISE.

   • Settings tab

   • Integration chunk

   • Sync Library with Content Editor Gutter command

Note: Examples included in the following modules

• Publishing Status Gutter

  

Insert Item

The Insert Item integration reveals a list of options to the user in the context menu under the node called Insert. The Sitecore rules engine may be used to control visibility and enabled state. The script is only executed when the option is clicked.

1. Begin by adding a new script to the Insert Item library. The name of the script will appear in the context menu.

2. Edit the script to perform the appropriate actions. The script can run in the background and show dialogs.

3. Change the icon of the item to match the script purpose.

4. Configure any Show rules as needed.

Note: Examples included in the following modules

• Task Management

  
• Platform

Ribbon

The Ribbon integration reveals commands to the user in the ribbon. The Sitecore rules engine may be used to control visibility and enabled state. The script is only executed when the option is clicked.

1. Begin by adding a new child script library to the Ribbon library; we'll refer to this library as the Tab library. Choose a name that matches an existing tab to be used, such as Home or Developer, or a new name to create a new tab.

2. Add a child script library to the Tab library; we'll call this the Chunk library. Choose a name such as Edit or Tools.

3. Add a new script to the Chunk script library; we'll refer to this library as the Command library. The name of the script will appear in the ribbon chunk as a command.

4. Optionally add a short description on the item, which is found as a standard field on the item. The description will appear as a tooltip on the ribbon button.

5. Edit the script to perform the appropriate actions. The script can run in the background and show dialogs.

6. Change the icon of the item to match the script purpose.

7. Configure any Enable or Show rules as needed.

Ribbon Script Library Structure

Example: The following script gets the selected Context Menu item and displays an alert using the item name.

# Use the notation "." to get the current directory/item.
$item = Get-Item -Path .
Show-Alert -Title $item.Name

Button Size:

There is a way to generate small buttons and combo buttons. You simply need to prefix the script name and SPE will generate accordingly.

• Small$[SCRIPT_NAME]

• Combo$[SCRIPT_NAME]

• SmallCombo$[SCRIPT_NAME]

Small and Combo Buttons

Buttons in the Ribbon

See the birth of extending the Sitecore ribbon with powershell scripts by Adam.

Check out an example of the 5 steps to extending the Sitecore ribbon in the wild by Toby.

Contextual Ribbon

Similar to the Ribbon integration, this provides a way to show buttons when certain contextual conditions are met. Most common is with media items. The steps are the same as with the standard Ribbon, but the structure is slightly changed.

In the following example, we have a ribbon button that appears whenever the selected item in the Content Editor is a media item. Take note of the "Optimize" button.

Contextual Ribbon Command

The ribbon structure would look like the following:

Script Library Structure

Warning

The Warning integration reveals a notification to the user above content. The Sitecore rules engine can be used to control visibility and enabled state. The scripts are only executed when the rule is met and the command is clicked.

1. Begin by adding a new script library to the Warning library.

2. Edit the script to perform the appropriate actions. The script can run in the background and show dialogs.

3. The warning notification title, text and icon should be configured in the script.

   • Include options to the warning by adding one or more secondary scripts to the script library.

4. Configure any Enable rules to ensure the script only runs when required.

Note: Examples included in the following modules

• License Expiration - disabled by default

License Expiration Warning

Alan provided a nice example here on setting up the warning with commands.