Creating custom themes for October CMS

Posted on 22-11-2017 by Nadir Latif


October CMS is a content management system based on Laravel Php Framework. It allows developing websites and web applications. It supports custom themes and plugins. In this article I will describe my experience with developing a custom theme for the October CMS.


To install the October CMS, we need to first ensure that our server meets the minimum requirements. October CMS requires Php 7 and higher and the following Php extensions: PDO, CURL, OpenSSL, Mbstring, Zip and the Php GD library.

The first steps in the installation process is to download the installation zip file to the web root directory. The zip file should be unzipped and write permissions should be given to the extracted files and folders. Next the install.php script should be opened in the browser. This will start the installation wizard. The wizard will ask for the database information as well as the admin user name and password. The wizard will then download the main files. Once the wizard ends, the installation files should be removed from the server.

October CMS supports task scheduling. For this it requires adding the following entry to the crontab file: * * * * * php /path/to/artisan schedule:run >> /dev/null 2>&1.


The main features of the October CMS are described on the October CMS website. October CMS is built on top of the Laravel Php framework. It supports the Twig template engine which is used to render web pages. It supports building pages using page components. A page component can be an item such as list of most recent posts. The October CMS can be extended using plugins. It has an easy to use administrative interface and supports easy creation of backend pages for plugins.

The October CMS provides a simple Ajax framework. It also provides the Builder plugin, which allows easily creating fully functional plugins. The October CMS uses file based templates. It also includes a built in asset combiner which allows combining CSS and JavaScript files.

The October CMS provides a markplace for third party plugins and themes. Another useful features of the October CMS is that it allows plugin and core updates to be installed easily. It also has a translate plugin that allows easy translation of content

Developing custom themes

Developing a custom theme for October CMS is quite easy. The CMS provides a built in theme called demo. A good starting point for developing the custom theme is to copy the demo theme folder and change the name of the folder to the new theme name.

The theme folder contains the following subfolders:

The templates files inside the layout, page and partial folders can contain upto three sections, which are configuration, php and twig sections. Each section should end with '==' on a new line.

Each theme can be managed from the October CMS backend. The backend allows editing the template files in a html editor as well as placing the theme in maintenance mode.


The October CMS is a feature rich CMS that is easy to use and extend. It is suitable for developing websites and web applications