Content widgets are snippets of structured information that you can insert into any WYSIWYG field in your application. WYSIWYG fields are available throughout OroCommerce; for example, in category descriptions, on edit pages of products, content blocks, and landing pages.
There are three content widget types:
- An Image Slider
- A Contact Us form
- A Copyright
- A Product Mini Block
- A Product Segment
Each of these widget types has a different set of options.
Please keep in mind that:
Whenever you modify a content widget, changes are applied everywhere the widget is used.
Create a Content Widget
To create a new content widget:
Navigate to Marketing > Content Widgets in the main menu.
Click Create Content Widget on the top right.
If you have more than one organization in your OroCommerce application, first select which organization to add a new content widget to.
Depending on the widget type, form fields are different:
- Contact Us Form - Enables you to add a standard Contact Us form.
- Image Slider - Enables you to configure and add an image slider.
You can add as many slides as necessary by clicking Add at the bottom of the Slides section.
- Copyright - Enables you to add a full or shortened version of a copyright notice.
Product Mini Block - Enables you to add a block with product information with or without prices, and/or the Add to Shopping List button.
Product Segment - Enables you to add a product segment content widget, and configure how many max and min items to show, whether to use slider on mobile, and show the Add to Shopping List button in the storefront. Only segments with type Product are listed in the Segment field dropdown. You can modify an existing segment or create a new one under Reports&Segments > Manage Segments.
Once you have provided all widget-specific details, click Save and Close.
Each content widget may have various representations in the form of layouts. Layouts are defined by developers using the existing layout update functionality, which enables you to alternate between the pre-configured designs for each widget in the back-office.
Please be aware that layouts are theme-specific. For more information, please refer to the CMS bundle documentation.
Add a Content Widget to WYSIWYG Fields
You can add content widgets to WYSIWYG fields in your OroCommerce application, like content blocks, landing pages, etc.
To add a content widget to a field, drag the content widget element from the editor’s manager panel, and drop it to the required location of the content field.
All landing pages and content blocks where content widgets were used, are displayed in the Usages section of each content widget.