If you have checked out the the Learn Moodle MOOC, you will have noticed its unique theme.  The theme is a custom version of the Bootstrap theme and is the creation of Barbara Ramiro,  ‎the Web and Graphic Designer at Moodle HQ.

Post Pages - Post Inline - WIRIS

If you are interested in replicating the look of the MOOC on your own test or production site, you will be pleased to know that the theme is available on Github: https://github.com/barbararamiro/moodle-theme_learnmoodle.

learnmoodle theme
The theme installed on the Author’s Moodle 2.5 site.

To install the theme, download and extract the zip file. A folder named moodle-theme_learnmoodle-master will be created. Rename the folder to learnmoodle and upload it to your moodle/theme folder.

Another reason to download this theme is its instructive README.txt found inside the zip file. If you are a budding theme designer, you will be pleased to know that the text file walks you through the steps to create a new theme by customising the learnmoodle theme. The section below is the complete README.txt instructions.


/* How to copy and customise this theme.

This document describes how to copy and customise the Learnmoodle (bootstrapbase) theme so that
you can build on this to create a theme of your own. It assumes you have some
understanding of how themes work within Moodle 2.5, as well as a basic understanding
of HTML and CSS.

Getting started

From your Moodle theme directory right click on learnmoodle and then copy and paste back
into your Moodle theme directory. You should now have a folder called Copy of learnmoodle.
If you right click this folder you are given the option to Rename it. So rename this
folder to your chosen theme name, using only lower case letters, and if needed,
underscores. For the purpose of this tutorial we will call the theme ‘learnmoodletheme’.

On opening ‘learnmoodletheme’ your you will find several files and sub-directories which have
files within them.

These are:

Where all the theme configurations are made.
(Contains some elements that require renaming).
Where all the functions for the themes settings are found.
(Contains some elements that require renaming).
Where all the setting for this theme are created.
(Contains some elements that require renaming).
Where the version number and plugin component information is kept.
(Contains some elements that require renaming).
This directory contains all language sub-directories for other languages
if and when you want to add them.
This sub-directory contains your language files, in this case English.
This file contains all the language strings for your theme.
(Contains some elements that require renaming as well as the filename itself).
This directory contains all the layout files for this theme.
Layout file for front page and general pages combined.
This directory contains all the CSS files for this theme.
This is where all the settings CSS is generated.
This directory contains a screen shot of this theme as well as a favicon
and any images used in the theme.

Renaming elements

The problem when copying a theme is that you need to rename all those instances
where the old theme name occurs, in this case learnmoodle. So using the above list as
a guide, search through and change all the instances of the theme name
‘learnmoodle’ to ‘learnmoodletheme’. This includes the filename of the lang/en/theme_learnmoodle.php.
You need to change this to ‘theme_learnmoodletheme.php’.

Installing your theme

Once all the changes to the name have been made, you can safely install the theme.
If you are already logged in just refreshing the browser should trigger your Moodle
site to begin the install ‘Plugins Check’.

If not then navigate to Administration > Notifications.

Once your theme is successfully installed you can select it and begin to modify
it using the custom settings page found by navigating to…
Administration > Site Administration > Appearance > Themes >>
and then click on (Learnmoodletheme) or whatever you renamed your theme to,
from the list of theme names that appear at this point in the side block.

Customisation using custom theme settings

The settings page for the Learnmoodle theme can be located by navigating to:

Administration > Site Administration > Appearance > Themes > Learnmoodle

Previous articleMidwest Moot Program Announced – nearly 60 sessions to choose from
Next articleWeek 2’s Webinar for #LearnMoodle is available


  1. I tried creating a custom theme from the Learn Moodle theme as per the included readme.txt and it gave me a blank screen.

    (copied the theme folder and changed all the theme names.)

    Also tried using using the learn moodle theme and added my own custom logo, but it doesn’t show up.

    Running Moodle 2.5.2 (Build: 20130909) Version 2013051402
    on a local version of Apache

  2. Hey Woola, check out your web server’s error.log file.
    It did this for me first go and I’d missed the theme name in the functions in layout/columnsX.php files. error.log file pointed me exactly at it.


Please enter your comment!
Please enter your name here

This site uses Akismet to reduce spam. Learn how your comment data is processed.