Interactive Widgets
This section describes how to insert our custom interactive widgets into a Heretto portal page. Interactive widgets (also called the widget configurator) are used in MinistryPlatform content, but could be used with any product with advanced planning and development assistance.
Interactive widgets are based on existing json code provided by our developers. Administrators, website builders, use the widget configurator's to build code useful for inserting into their website. For more information about how customers use them, search MinistryPlatform content for "widget" or "widget configurator".
1There are three options of inserting a widget:
"All" Widget - this lists all widgets into the drop-down selector and loads the first one by default.
- Default Widget - this lists all widgets into the drop-down selector and loads the widget based on the
indexthat is set on the topic'ssection. - Single Widget - this does not show a drop-down selector, it loads the widget based on the
indexthat is set on the topic'ssection.Tip: Since we are utilizing a DITAsectionto insert the widgets, you can still add any DITA element inside thatsection. These elements will appear on top of the widget.To insert a widget, add a section with an
outputclassofacst-widget. To make it a Default Widget, just add anotheroutputclass(separated by space)default-xwhere x is theindex. To make it a Single Widget, usesingle-x.Note: Widgetindexstarts from 0.Note: Widgets loaded from the JSON file are being sorted alphabetically in the code.Tip: Yes, you can insert multiple widget sections in one topic. Just like this one!
Example Widgets
This concept provides an overview of various example widgets, including the "All" Widget, Default Widget, and Single Widget, along with their respective DITA code configurations.
"All" Widget
DITA Code: <section outputclass="acst-widget"></section>
Default Widget
DITA Code: <section outputclass="acst-widget default-3"></section>
Single Widget
DITA Code: <section outputclass="acst-widget single-5"></section>
Developer Updates to the Widget Configurator
This task outlines the steps for updating the widget configurator with a new JSON file URL to resolve CORS issues and ensure the Help Center widget displays updated fields.
- A developer on the MinistryPlatform team must update the JSON file and provide you with a new URL to that file.
- Obtain the URL for the new JSON file from the MP developer.
- Contact the Content Lead to coordinate scheduling with the Heretto portal team to update the fields. Heretto will need the URL before they can do the work.