Widgets
categoryUser Guide
edit_calendar31 Mar 2026
Display Management with Widgets
Widgets provide a flexible, modular way to add content and functionality to your site's sidebars and footers. GeniXCMS's Widget Engine supports 3 core types: Built-in, Module-based, and Custom HTML.
🎨 Managing Widget Placement
To configure your site's dynamic functional blocks:
- Navigate to Appearance > Widgets in the left sidebar.
- The Widget Manager displays two primary columns:
- Available Widgets: A library of all registered widgets (e.g., Categories, Recent Posts, Search).
- Widget Areas: The specific sidebar or footer zones defined by your current active theme.
🏗️ Assigning a Widget
Assigning a widget to your theme's frontend is a 3-step process.
- Select Widget: In the Available Widgets column, choose the widget you wish to activate.
- Dispatch: Use the dropdown associated with that widget to select the Target Widget Area (e.g.,
Main Sidebar). - Completion: Click Add Widget to instantly publish that functional block to the frontend.
🛠️ Specialized Widget Types
GeniXCMS 2.0.0 supports several distinctive widget types:
| Widget Type | Best Use Case |
|---|---|
| System Managed | Core features like Recent Posts, Categories, and Site Search. |
| Module-bound | Functionality provided by active modules (e.g., Newsletter Signup, Contact Map). |
| Custom HTML | Allows users to paste their own code (e.g., Advertisement scripts, Social feeds). |
⚙️ Widget Configuration
Many widgets can be fine-tuned after placement. In the Widget Areas column, you can:
- Configure: Adjust specific settings like titles, number of posts to display, or custom HTML content.
- Reorder: Use the up/down arrows to change the vertical stack within a sidebar.
- Remove: One-click deletion of a widget from its assigned area.
lightbulb
TipDeveloper Hint: If your active theme doesn't show enough sidebar areas, you can register new ones in your theme's
function.php using Theme::registerSidebar('ID', 'Name');.priority_high
ImportantSecurity: When using Custom HTML widgets, the framework's Content Security Policy (CSP) still applies. If you are pasting external scripts (like Google Adsense), ensure the provider's domain is whitelisted in Security Settings.