PolyCMS Theme: Head Random Configuration Guide for RISE CRM
Head Random is the default Bootstrap 5 theme bundled with PolyCMS for RISE CRM and located at plugins/polycms/themes/head-random/. Automatically installed and activated on setup, it delivers a responsive multi-column blog layout, customizable Hero Section, category filter tabs, widgetized sidebar and footer zones, built-in English and Vietnamese theme translations, and a full options panel under Appearance > Theme Options.
Core Theme Capabilities
- Bootstrap 5 Responsive Grid: Adapts cleanly across desktop, tablet, and mobile screens with a collapsible mobile navigation drawer.
- Customizable Hero Banner: Dedicated homepage hero section with dynamic
{company}placeholder support and an optional call-to-action button. - Flexible Post Grid & Filters: Switch between 1, 2, 3, or 4 posts per row and enable interactive category filter tabs on the blog homepage.
- Granular Content Visibility Controls: Toggle featured images, excerpts, excerpt character lengths, category image badges, tags, and single post/page metadata independently.
- Built-In Scroll Helpers: Floating scroll-to-top button (configurable separately for frontend and admin) plus smooth auto-scroll when navigating pagination links.
- Bilingual Theme Language Pack: Loads localized theme strings automatically from
plugins/polycms/themes/head-random/languages/(English and Vietnamese included out of the box) via the_tl()helper.
Managing and Configuring Theme Options
Verify that Head Random is active under Appearance > Themes (/polycms/themes), then open Appearance > Theme Options (/polycms/theme-options). All Head Random settings are stored in {db_prefix}blog_theme_options and retrieved inside templates using headrandom_option($key, $default).
Branding
- Site Logo: Upload a custom brand mark (recommended
40x40px). When left empty, the header falls back to your RISE CRM company initial. - Blog Title: Custom header title supporting the
{company}placeholder to pull your RISE CRM company name automatically.
Hero Section
- Show Hero Section: Enable or disable the hero banner on the blog homepage.
- Hero Title: Headline supporting the
{company}placeholder (defaults to"Welcome to {Company}"when blank). - Hero Subtitle: Supporting lead copy displayed below the hero title.
- CTA Button Text & URL: Optional primary button displayed inside the hero banner (leave text empty to hide the button).
Layout & Appearance
- Posts per Row: Choose
1 Column,2 Columns(default),3 Columns, or4 Columnsfor post archive grids. - Menu Alignment: Align main header navigation items
Left,Center,Right(default), orSpace Between. - Show Category Filter & Max Categories in Filter: Toggle homepage category filter tabs and set the maximum count (
3to15, default8). - Show Excerpt & Excerpt Length: Toggle post excerpts on listing cards and control maximum character length (
50to500, default150).
Archive & List Elements
- Show Featured Image: Toggle featured thumbnails across post lists, category/tag/author archives, and search results.
- Show Post Meta: Toggle date, author, and category metadata on archive cards.
- Show Category Label on Featured Image: Overlay a category badge on each post card thumbnail.
- Show Tags: Display assigned post tags directly on listing cards.
Single Detail Elements
- Show Single Post Meta: Default visibility of metadata on single post views (can be overridden per post).
- Show Single Page Meta: Default visibility of metadata on static page views (can be overridden per page).
Social Links
- Social Media Links Repeater: Add, edit, remove, and drag-to-reorder social links for Facebook, Twitter / X, Instagram, Pinterest, YouTube, TikTok, LinkedIn, GitHub, or Other with optional display labels.
Footer
- Footer Description: Short brand summary displayed beneath the footer logo.
Scroll & Navigation
- Scroll to Top Button (Frontend / Admin): Independently enable or disable the floating scroll-to-top button on public blog pages and admin screens.
- Auto Scroll on Pagination: Automatically scroll smoothly back to the top of post listings when clicking pagination controls.
- Icon Color, Background Color & Button Size (px): Customize icon hex color (default
#ffffff), background color (falls back to primary brand color), and circular button dimensions (20to80px, default40).
Theme Directory and Template Files
All Head Random files reside in plugins/polycms/themes/head-random/:
| File / Folder | Purpose |
|---|---|
style.css |
Theme metadata header (Theme Name, Version, Author, Text Domain, Requires PolyCMS). |
functions.php |
Theme bootstrap: loads theme translations (_tl()), registers headrandom_option(), and enqueues frontend scroll-to-top scripts. |
theme-options.php |
Declarative field definitions rendered inside Appearance > Theme Options. |
blog-homepage.php |
Dedicated blog homepage template with Hero Section, category filter tabs, and responsive post grid. |
index.php |
Default fallback archive template. |
single.php |
Individual blog post layout with featured image, author metadata, tags, and threaded comments. |
page.php |
Static page layout compatible with classic TinyMCE content and fullscreen MTBuilder designs. |
category.php, tag.php, author.php |
Taxonomy and staff author archive templates. |
search.php |
Frontend keyword search results view. |
404.php |
Branded not-found template when no matching page or post exists. |
header.php, footer.php |
Shared site header (navigation, branding, search) and footer templates. |
partials/ |
Reusable template partials shared across listing and detail views. |
languages/ |
Bundled english and vietnamese theme translation files (headrandom_lang.php). |
assets/, dist/ |
Source stylesheets/scripts and compiled production theme assets. |
Widget Areas and Navigation Menus
Head Random renders the two widget zones registered by PolyCMS core:
- Sidebar (
sidebar): Displays blog widgets (such as Search, Latest Posts, Popular Posts, Categories, Tags Cloud, Archive, Author, Custom HTML, or Menu) alongside content views. - Footer (
footer): Displays footer widget columns consistently across all frontend pages.
Configure active widgets at Appearance > Widgets (/polycms/widgets) and assign header or footer navigation links at Appearance > Menus (/polycms/menus).
Safe Customization Recommendations
- Use Theme Options First: Adjust branding, hero copy, column counts, card badges, social links, and scroll controls directly in Appearance > Theme Options so your configuration persists cleanly in
{db_prefix}blog_theme_optionsacross plugin upgrades. - Use MTBuilder for Landing Pages: Keep Head Random as your global header/footer shell and design custom campaign pages inside PolyCMS > Pages -> Edit with MTBuilder.
- Duplicate for Deep Code Changes: Avoid modifying files directly inside
plugins/polycms/themes/head-random/if you plan to upgrade PolyCMS later. Instead, clone the theme into a new folder insideplugins/polycms/themes/with a unique slug andTheme Nameinstyle.css.
Related Documentation
- PolyCMS Theme Management for RISE CRM - Upload, activate, preview, and switch themes under Appearance > Themes.
- Widgets and Sidebars in PolyCMS - Configure all 9 built-in widgets inside the
sidebarandfooterareas. - PolyCMS Menu Builder Guide - Build navigation menus rendered in the Head Random header and footer.
- Building a Custom Theme for PolyCMS - Developer guide for building your own custom RISE CRM PolyCMS theme.