Skip to content

Widget Display

Ben Gillbanks edited this page Sep 7, 2019 · 6 revisions

Use the widget display settings to set when which pages widgets should appear on.

The display settings uses a custom rules box where you can enter a set of rules that define when rules should appear.

  • Each widget can have multiple rules.
  • The rules are tested in order. As soon as a rule is positive the checks stop and the widget is displayed.
  • If no rules are true the widget will be hidden.
  • If there are no rules the widget will be displayed.

Rule format

The rules are structured in the format as CSS properties. A name, optionally followed by a colon and then comma separated parameters, ending with a semicolon.

If there's a single rule then you don't need the semicolon.

Rules

  • home Display on the homepage. No parameters.
  • single Display on any singular post type. Posts, pages, and any custom post types. The parameters can contain a list of ids to restrict the display to pages with those ids.
  • archive Display on any archive page.
  • postType Display on pages with the specified post type. The parameters should be a list of post types.

Examples

  • home Only display on the homepage.
  • home; archive Display on the homepage and archive pages.
  • postType: post Display on single posts and post archives. Not pages.

Clone this wiki locally