PolyCMS Theme: Head Random — Configuration Guide

Last updated on May 15, 2026 11:20 PM

Overview

Head Random is the default theme bundled with PolyCMS. It provides a modern, responsive blog layout built with Bootstrap 5, featuring a dark header, search integration, sidebar widget areas, and mobile-friendly navigation.

Theme Features

Responsive design adapting to desktop, tablet, and mobile
Dark header with site logo and navigation
Built-in search form in header
Right sidebar with configurable widget areas
Clean typography optimized for reading
SEO-friendly HTML markup
Bootstrap 5 grid system
Mobile hamburger menu navigation
Post metadata display (date, author, reading time, views)
Category and tag labels on posts
Pagination for archive pages
Comment section with threaded replies

Theme Options

After activating Head Random, access Theme Options from Blog > Themes > Theme Options:

General Settings

Site Logo — Upload a custom logo displayed in the header.
Favicon — Custom favicon for browser tabs.
Site Description — Tagline shown below the site logo.

Layout Options

Sidebar Position — Choose left, right, or no sidebar.
Posts Per Page — Number of posts displayed on archive pages.
Show Featured Image — Toggle featured image display on single posts.

Header & Footer

Header Background — Customize header color or gradient.
Footer Text — Custom copyright or footer message.
Social Links — Add social media profile URLs for header/footer icons.

Custom CSS

Custom CSS — Inject additional CSS rules to fine-tune styling without editing theme files.

Template Files

Head Random includes these template files:

File	Purpose
`index.php`	Default template / blog archive
`single.php`	Individual post view
`page.php`	Static page template
`category.php`	Category archive
`tag.php`	Tag archive
`search.php`	Search results
`archive.php`	Date-based archives
`header.php`	Site header (included in all templates)
`footer.php`	Site footer (included in all templates)
`sidebar.php`	Sidebar widget area
`comments.php`	Comment display and form

Widget Areas

Head Random registers two widget areas:

Blog Sidebar — Rendered on the right (or left) side of archive and single post pages.
Footer Widgets — Rendered in the footer zone across all pages.

Configure widgets via Blog > Widgets.

Customization Tips

Use Theme Options > Custom CSS for minor styling tweaks.
For major layout changes, consider building a custom child theme.
Override specific templates by creating a child theme with matching template filenames.