Back to Main Site

Widgets and Sidebars in PolyCMS for RISE CRM

Last updated on Nov 22, 2026 11:41 AM 11:41 AM 1,792.06 ms

Widgets are modular content blocks that populate theme-defined Widget Areas such as blog sidebars and footer zones without touching template code. Managed under Appearance > Widgets (/polycms/widgets) and stored in {db_prefix}blog_widgets, PolyCMS for RISE CRM ships with 9 built-in widget classes in plugins/polycms/widgets/ plus 3 dynamic shortcodes for embedding live post grids inside articles and pages.

Built-in Widgets (9 Classes)

All 9 core widget classes are bundled inside plugins/polycms/widgets/ and ready to drag into any theme widget area:

Widget Class File Description
Latest Posts Latest_Posts_Widget.php Displays recent published articles with thumbnails, publication dates, and configurable post count (1 to 20)
Popular Posts Popular_Posts_Widget.php Ranks and displays the most-viewed articles based on recorded view counts
Categories Categories_Widget.php Renders categories as a hierarchical tree or flat list with optional post count badges
Tags Cloud Tags_Cloud_Widget.php Displays a visual tag cloud with proportional sizing based on tag frequency
Archive Archive_Widget.php Lists monthly or yearly publication archives in dropdown or list format
Author Bio Author_Widget.php Displays the author avatar, short biography, and social profile links
Live Search Search_Widget.php Provides an AJAX-powered live search input with instant dropdown results
Custom HTML Custom_HTML_Widget.php Embeds raw HTML, custom styling, newsletter forms, or third-party widgets (such as maps or banners)
Menu Widget Menu_Widget.php Outputs any navigation menu configured in Appearance > Menus

Configuring Widgets

To add, edit, or reorder widgets on your site:

  1. Navigate to Appearance > Widgets (/polycms/widgets) in the RISE CRM sidebar.
  2. Select a Widget Area - Choose a target zone registered by your active theme (such as Blog Sidebar or Footer Widgets).
  3. Add Widgets - Drag any widget from the available widget list into the desired Widget Area.
  4. Configure Settings - Click an added widget to expand its configuration form:
    • Set a custom Widget Title displayed as the block heading on the frontend.
    • Adjust widget-specific options such as item limit, category filter, display mode, or selected menu.
  5. Reorder - Drag widgets vertically inside a Widget Area to change their render sequence.
  6. Save - Click Save to persist your changes to {db_prefix}blog_widgets.

Theme Widget Areas

Available Widget Areas depend on your active theme. The bundled Head Random theme (plugins/polycms/themes/head-random/) registers two core widget areas:

  • sidebar (Blog Sidebar) - Right-hand sidebar displayed alongside blog archive feeds and single post pages.
  • footer (Footer Widgets) - Responsive multi-column footer zone rendered across all public CMS pages.

Custom themes can register additional widget areas tailored to landing pages, documentation layouts, or headers.

Built-in Shortcodes (3 Core Handlers)

Alongside sidebar widgets, PolyCMS includes 3 core shortcodes located in plugins/polycms/shortcodes/. Registered via polycms_register_shortcode($tag, $callback) and parsed dynamically via polycms_do_shortcode($content), shortcodes let you drop live post collections directly into any post or page body.

Shortcode Supported Parameters Description
[polycms_post] id, slug, layout (card, list, compact), show_thumbnail, show_excerpt Embeds one or more specific posts inside an article or static page
[polycms_category] slug, count, columns (2, 3, 4), order (DESC, ASC), orderby (date, views) Renders a responsive Bootstrap 5 post grid filtered by category
[polycms_tag] slug, count, columns Renders a post grid matching a specific tag slug

Example Shortcode Usage

Insert shortcode syntax directly inside the TinyMCE editor when writing a post or page:

[polycms_category slug="tutorials" count="6" columns="3" orderby="date" order="DESC"]

When visitors load the page on the frontend, PolyCMS parses the shortcode automatically and renders live matching articles.

Related Documentation