Skip to content

Post and Article Widgets

This page covers the widgets for posts, news and blog content written in the content management system. For each one it gives the steps to place it and the settings its form offers, in the words the form uses, so you can tell before you start which records and images you need to have ready.

Your job, and the screen for it

The jobScreen or tabRead
Add one of these widgets to a pageDesign Panel › Elements › Posts & ArticlesConfiguration
Change a widget that is already on the pageClick it on the canvas, Design Panel › Selected NodeIts section under Configuration
Know which settings need an ID, JSON or rich textSelected NodeFields
Make a change reach the shopSAVE NODE, then PublishConfiguring Widgets
Find out why a widget shows nothingTroubleshooting

Overview

The Posts & Articles group in the Elements tab holds 10 widgets. This page describes 9 of them: blog-dashboard-widget, card-slider-widget, news-details, news-list, popup-post-widget, post-category-card, post-category-slider, post-category-tab, post-display. The other one is a layout built for one shop and is not described here. The text and images of a post are written in the Content Management System; these widgets choose which posts to show and how. Placing, saving and publishing work the same for every widget and are explained once in Configuring Widgets in the Website Builder; this page adds what is particular to each widget.

Where it fits

BeforeThese widgetsAfter
You can open the Website Builder and the page exists — User Permission Manager, Layout InstancePlaced on a page and configuredShoppers see them on the storefront after Publish

Screens and menus

Open a page from the Layout Manager tile. In the Design Panel, the Elements tab lists these widgets under Posts & Articles, each with its one-line description; the search box matches the description too. Clicking a placed widget on the canvas opens its settings in Selected Node.

Configuration

Before you can use it

  • Everything in Configuring Widgets › Before you can use it: CP Commerce Admin for your login, and the records the widgets point at.
  • Check Platform before you drop a widget: it is added to that platform’s version of the page only.

blog-dashboard-widget

Blog dashboard.

  1. In Elements, open Posts & Articles (or search blog-dashboard-widget) and drag blog-dashboard-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Content category (pick from list); Header; No item message; Blog post page (pick a page); Per row listing; Per row listing md; Loader type
    • Button style — Color; Background
    • Widget title style — Color; Show widget title
    • Post style — Color
    • Scroller options — Scroller height; Color; Background color; Padding top; Padding bottom; Padding left; Padding right
    • Scroller options › Button config — Background; Shadow; Font family; Font; Icon; Button Background; Button font; Link font
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

card-slider-widget

Post cards carousel.

  1. In Elements, open Posts & Articles (or search card-slider-widget) and drag card-slider-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Activity category (pick from list); Posts details (JSON)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

news-details

Details of one news item.

  1. In Elements, open Posts & Articles (or search news-details) and drag news-details onto the page.
  2. Selected Node shows This widget has no settings to configure. The widget reads nothing from its settings; give the node a recognisable Name if you like.
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

news-list

News list.

  1. In Elements, open Posts & Articles (or search news-list) and drag news-list onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — News details page (pick a page)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

popup-post-widget

Post shown in a popup.

  1. In Elements, open Posts & Articles (or search popup-post-widget) and drag popup-post-widget onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Popup posts (comma-separated)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

post-category-card

Posts as cards by category.

  1. In Elements, open Posts & Articles (or search post-category-card) and drag post-category-card onto the page.
  2. In Selected Node, fill in the widget’s form: Content Category (which posts), Display Title, the widths of the Image and Content columns, and the Color and Font of the header and of the content; the posts of the category are listed to arrange. Under More settings at the bottom of the form:
    • Card styling — Fixed card size
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

post-category-slider

Posts carousel by category.

  1. In Elements, open Posts & Articles (or search post-category-slider) and drag post-category-slider onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Display title; Content category (pick from list); View more page (pick a page); Container; Slides per view; Autoplay; Slides per view desktop; Slides per view tablet
    • View button — Hidden; Color; Background; Text; Font; Weight; Size
    • Card styling › Header — Color; Font
    • Card styling › Content — Color; Font
    • Card styling — Image height; Image width; Display read more; Height; Shadow; Border radius; Background
    • Card styling › Border — Border color; Border style; Border width
    • Card styling › Size — Image; Content
    • Title — Color; Font; Size; Weight
    • Slide button — Color; Background
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

post-category-tab

Posts grouped in category tabs.

  1. In Elements, open Posts & Articles (or search post-category-tab) and drag post-category-tab onto the page.
  2. In Selected Node, fill in the settings you need — leave the rest empty to keep the widget’s own behaviour:
    • General — Content category (pick from list)
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

post-display

Displays a single post.

  1. In Elements, open Posts & Articles (or search post-display) and drag post-display onto the page.
  2. Selected Node shows This widget has no settings to configure. The widget reads nothing from its settings; give the node a recognisable Name if you like.
  3. Click SAVE NODE, then Preview and Publish (Steps 4 and 5).

Fields

The settings are listed with each widget above, in the form’s own words. Colours, lists and JSON behave as described in Configuring Widgets › Step 3.

Settings marked (pick a page) — their labels end in page — open a list of your pages when you click them and fill in the page’s address, /page/ and its code. You can also type any link instead, such as a full https:// address. Left empty, the widget uses its own default page where it has one.

The settings that pick a record, take JSON or hold rich text:

KindWhereWhat to know
Typed as JSONcard-slider-widget › Posts detailsInvalid JSON shows JSON is invalid and is not saved; the last valid value stays
Activity categoriescard-slider-widget › Activity categoryPick the activity category by name. A saved one that is not in the loaded list shows as Not in the list — saved ID …; publish, then reload, before you replace it — a reload loses unpublished changes
Content categoriesblog-dashboard-widget › Content category; post-category-slider › Content category; post-category-tab › Content categoryPick it from the website’s content categories, the ones posts are filed under in the content management system. A saved one that is not in the loaded list shows as Not in the list — saved ID …; publish, then reload, before you replace it — a reload loses unpublished changes

Lifecycle and effects

SAVE NODE keeps a change in your browser tab only; Publish sends the page to the shop, and a reload before publishing loses the change. A setting left empty is not saved and the widget uses its own behaviour for it; opening a widget and saving without changes leaves its stored settings as they were. The full sequence is in Configuring Widgets › Lifecycle and effects.

Related applets

Troubleshooting

SymptomCauseFix
The widget is empty on the shopA record it shows is missing or inactiveCheck the records its pickers point at
A change is gone after reloadThe page was not publishedRedo it and Publish before leaving
It shows on desktop but not on phonesIt was added on a desktop platform onlySwitch Platform and add it there too
SAVE NODE does nothingWidget Config (JSON) holds invalid JSONFix or undo the JSON
A picker shows Not in the list — saved ID …The record it saved was deleted, belongs to another website, or is not in the list as loadedPublish what you have first (a reload loses unpublished changes), then reload; if it still shows, check the record before you pick a replacement
A picker shows The list is empty or could not be loadedNothing of that kind exists yet, or loading failedCreate the record first, or reload the page

Related documentation

Last updated on