Back to Main Site

PolyCMS Theme: Head Random Configuration Guide for RISE CRM

Last updated on Nov 22, 2026 10:49 AM 10:49 AM 1,934.06 ms

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, or 4 Columns for post archive grids.
  • Menu Alignment: Align main header navigation items Left, Center, Right (default), or Space Between.
  • Show Category Filter & Max Categories in Filter: Toggle homepage category filter tabs and set the maximum count (3 to 15, default 8).
  • Show Excerpt & Excerpt Length: Toggle post excerpts on listing cards and control maximum character length (50 to 500, default 150).

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 (20 to 80 px, default 40).

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_options across 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 inside plugins/polycms/themes/ with a unique slug and Theme Name in style.css.

Related Documentation