PolyCMS Theme Management for RISE CRM
Themes define the complete visual identity, Bootstrap 5 layout structure, widget zones, and menu locations of your public website powered by PolyCMS for RISE CRM. Managed under Appearance > Themes (/polycms/themes) and customized via Appearance > Theme Options (/polycms/theme-options), all themes reside in {rise_crm_root}/plugins/polycms/themes/ with support for ZIP upload security scanning, session-based live preview, and upgrade-safe Child Themes.
Navigating the Themes Dashboard
Open Appearance > Themes in the RISE CRM sidebar to inspect all installed themes in Grid View or List View. Each theme card displays:
- Theme name, version number, and author information
- Thumbnail preview and description
- Active or Inactive status badge
- Activate / Deactivate controls
- Preview button for live session-only testing
- Download (ZIP export) and Delete actions for inactive themes
- Direct Theme Options link for the active theme
Theme metadata and custom option values are persisted in {db_prefix}blog_themes and {db_prefix}blog_theme_options (default rise_blog_themes and rise_blog_theme_options).
Installing a Theme
You can install new themes through the admin panel or directly via server file access.
ZIP Upload (Recommended)
- Navigate to Appearance > Themes (
/polycms/themes). - Click Upload Theme.
- Choose your theme package
.ziparchive. - PolyCMS validates the archive, runs security scans, and extracts the files into
{rise_crm_root}/plugins/polycms/themes/. - Click Activate on the newly installed theme card to switch your live frontend.
Manual Installation
Extract your theme directory and upload it via SFTP or your hosting file manager directly into:
{rise_crm_root}/plugins/polycms/themes/your-theme-slug/
Reload Appearance > Themes and PolyCMS detects the theme automatically.
Built-in Theme Upload Security
Every theme ZIP uploaded through Appearance > Themes passes through server-side security verification before extraction:
- Scans PHP files to detect and reject dangerous execution functions.
- Validates allowed file extensions inside the archive.
- Enforces
polycms_validate_file_pathchecks to prevent ZIP slip and directory traversal attacks.
Customizing Active Themes with Theme Options
Navigate to Appearance > Theme Options (/polycms/theme-options) to adjust visual branding for the currently active theme without writing code. Supported settings panels (with URL hash deep-linking for fast tab bookmarking) typically include:
- Site logo and browser favicon uploads
- Brand color schemes, typography, and layout preferences
- Header and footer configuration
- Social media profile links
- Custom CSS injection for targeted styling overrides
Theme developers can expose custom controls using the PolyCMS Theme Options API.
Bundled Theme: Head Random
PolyCMS for RISE CRM ships with the production-ready Head Random theme installed at plugins/polycms/themes/head-random/:
- Clean, responsive layout built with Bootstrap 5
- Dark navigation header with logo branding and integrated search
- Mobile-friendly hamburger navigation
- Two registered Widget Areas (
sidebarandfooter) - Built-in English and Vietnamese theme language files
- Dedicated Theme Options panel and SEO-optimized semantic templates
See the Head Random Theme Guide for a full walkthrough of its configuration options.
Theme Preview Mode
Test design changes safely before switching your public website using Theme Preview Mode:
- On Appearance > Themes, click Preview on any inactive theme.
- PolyCMS activates a session-scoped preview visible strictly to your logged-in staff session.
- Public visitors continue viewing your active production theme with zero disruption.
- A floating preview bar appears on the frontend with a one-click button to exit preview mode (
clear_preview) or proceed to full activation.
Child Themes
PolyCMS supports Child Themes so developers can override specific templates or CSS styles without losing changes when updating a parent theme:
- Create a new folder under
plugins/polycms/themes/(for example,plugins/polycms/themes/head-random-child/). - Add a
style.cssfile containing aTemplateheader referencing the parent theme directory slug:
/*
Theme Name: Head Random Child
Template: head-random
Version: 1.0.0
*/
- Activate the child theme in Appearance > Themes. PolyCMS resolves templates in cascade order, checking your child theme folder first and falling back automatically to the parent theme for any files you did not override.
Template Hierarchy
When rendering a public URL, PolyCMS resolves theme PHP template files in the following fallback order:
single.php -> Individual blog post view
category.php -> Category archive page
tag.php -> Tag archive page
page.php -> Standard static page
archive.php -> Date or author archive view
search.php -> Frontend search results
index.php -> Universal fallback template
Themes can also ship custom named page templates (for example, page-contact.php or page-landing.php), which automatically appear as selectable layout options inside the Page Editor.
Related Documentation
- Building a Custom Theme for PolyCMS for RISE CRM - Complete developer reference for building custom themes and Theme Options.
- PolyCMS Bundled Theme: Head Random for RISE CRM - Customize the default bundled theme.
- Widgets and Sidebars in PolyCMS for RISE CRM - Populate theme-defined Widget Areas.
- PolyCMS Menu Builder Guide for RISE CRM - Assign navigation menus to theme locations.