The Widget Studio can be accessed in the Control Panel via Site Administration > Widget Studio > Manage Widgets.
Browsing Widgets
The list of widgets shown when first accessing "Manage Widgets" includes all installed widgets, including Factory Defaults and custom widgets.
The list can be filtered by:
- The widget type:
- all: All widgets
- user installed: widgets that were created or imported via Widget Studio
- default: Factory default widgets provided by the platform or third-party plugins
- default (user edited): factory default widgets which have been customized via Widget Studio
- The theme version:
- any: any theme version
- default: widgets that have a generic non-theme-specific version
- [Theme Name]: widgets that have a version specifically for the theme name selected
- Text search - text that matches a widget's name or description
Importing Studio Widgets
Widgets can be installed from widget export files by clicking Import Widgets. A single widget export file can be selected (which can potentially contain multiple widgets). A confirmation will be shown before installation like the following
Widgets being imported that match existing installed widgets prompt for whether they should overwrite via a checkbox for each. When selected, imported widgets add a custom version on top of matching factory defaults or simply overwrite matching custom widgets. When not selected, widgets will still be imported, but under a new, different, name.
Widgets that do not match existing installed widgets are also listed, but not selectable.
Exporting Studio Widgets
Any widget, whether Factory Default or Custom, can be exported via Manage Widgets. A widget export includes widgets' script, configuration, attachments, and resources. A single export file can contain multiple widgets.
To produce a widget export select Export when hovering over a single widget line item. Alternatively, multiple widgets can be exported in a single file by checking widget checkboxes and then selecting Export Selection in the right sidebar.
Editing existing Studio Widgets
Any widget can be edited by clicking on its name or by selecting Edit when hovering over the widget. Factory defaults allow editing without touching the original factory versions.
Creating new Studio Widgets
New widgets can be created by clicking Create New Widget
Deleting or Reverting changes to Studio Widgets
Custom widgets can be fully deleted. Factory defaults cannot be deleted, but customized versions of factory defaults can be reverted back to their original.
To delete or revert a widget (depending on its type), select Delete or Revert when hovering over a single widget line item. Alternatively, multiple widgets can be deleted and/or reverted at once by checking widget checkboxes and then selecting Delete/Revert Selection in the right sidebar.
Importing and exporting of Studio Widget Language Resources
Widget exports include all resources used by those widgets. But the Widget Studio also allows for exporting and importing only the language resources for widgets.
To export a widget language resources, check at least one widget and then select Export Selection Resources in the sidebar. The produced file is an XML export of all resource strings for all defined languages used by the selected widgets.
To import a widget language resource, select Import Resources in the sidebar and choose a widget resource file.