Widgets and Sidebars in PolyCMS for RISE CRM
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:
- Navigate to Appearance > Widgets (
/polycms/widgets) in the RISE CRM sidebar. - Select a Widget Area - Choose a target zone registered by your active theme (such as Blog Sidebar or Footer Widgets).
- Add Widgets - Drag any widget from the available widget list into the desired Widget Area.
- 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.
- Reorder - Drag widgets vertically inside a Widget Area to change their render sequence.
- 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
- PolyCMS Theme Management for RISE CRM - Activate and manage themes that provide Widget Areas.
- PolyCMS Bundled Theme: Head Random for RISE CRM - Detailed guide to the
sidebarandfooterareas in Head Random. - Building a Custom Theme for PolyCMS for RISE CRM - Register custom Widget Areas in your own themes.
- PolyCMS Creating Custom Shortcodes for RISE CRM - Developer guide for registering custom shortcodes with
polycms_register_shortcode().