Available in OroCommerce

Content Widgets

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:

You can:

  • Edit content widgets from the grid and view page.

You cannot:

  • Delete a widget if it is used in a content block or a landing page.
  • Change widget type for an already existing widget

Note

Whenever you modify a content widget, changes are applied everywhere the widget is used.

Create a Content Widget

To create a new content widget:

  1. Navigate to Marketing > Content Widgets in the main menu.

  2. Click Create Content Widget on the top right.

    Note

    If you have more than one organization in your OroCommerce application, first select which organization to add a new content widget to.

  3. Depending on the widget type, form fields are different:

    • Contact Us Form - Enables you to add a standard Contact Us form.
    Contact us content widget form
    • Image Slider - Enables you to configure and add an image slider.
    Image slider content widget form

    Note

    You can add as many slides as necessary by clicking Add at the bottom of the Slides section.

    Image slider content widget form
    • Copyright - Enables you to add a full or shortened version of a copyright notice.
    Copyright content widget form
    • Product Mini Block - Enables you to add a block with product information with or without prices, and/or the Add to Shopping List button.

      A product mini block form
    • 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.

      A product mini block form
  4. Once you have provided all widget-specific details, click Save and Close.

    Content widget view page

    Hint

    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.

    Select Layouts 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.

Adding a content widget to a WYSIWYG field

All landing pages and content blocks where content widgets were used, are displayed in the Usages section of each content widget.

Landing page linked to a content widget displayed in the Usages section