Installing a new theme

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 2.2. Up-to-date documentation for the latest stable version is available here: Installing a new theme.

A site administrator who has access to the Moodle code can easily install a new theme Moodle theme. Once installed, the theme will be available via the appropriate site, category, course or activity menu.

Custom themes are available for download from the Moodle Plugins directory.

Steps to install a new theme in the code

In this example, we will install a new theme that has been made by someone else.

  1. Download the zip file of the theme
    Select the theme
  2. Extract to its own named folder
    Select the theme
  3. Using your FTP program, upload this folder to the /theme folder of your Moodle installation
    Upload the unzipped file
  4. Ensure the new theme folder and its contents are readable by the webserver. Change the Read and Write permissions for the files and folder. Incorrect permissions may prevent display of the newly installed theme.
    1. For example in Linus use the CHMOD command in set the permissions to 755 - Owner read/write/execute, Group read/execute, Everyone read/execute.
  5. Go to Site administration > Notifications to see if the new theme requires any decisions or updating of Moodle code.

Now you or others can select the new theme.

Steps to change the theme

In this example, we will change our site theme to a new one that we added. Your role will require the permissions to allow you to change themes. Remember that themes can be changed in many contexts in Moodle.

You may select different themes depending upon the device that will be viewing Moodle. For example, you might have one theme for computers with monitors and another for mobile phones and another for tablets.

  1. Go to the Settings block
  2. Open Settings > Site administration > Appearance > Themes > Theme Selector link
    Open the Appearance > Theme selector page
  3. Click on "Clear theme caches" button
    Click the Clear theme caches button
  4. Click on the "Select theme" button on the right of the current theme being used for the device
    Click the Clear theme caches button
  5. Scroll down to find the theme you wish to use
  6. Click the "Use theme" button next to that theme
    Click the Use theme button
  7. Moodle will tell you it has been saved as the default theme
    Checking if the theme is the one selected
  8. Check your Moodle site by going to the Moodle site's home page.
  9. You may have to refresh your browser to see the new theme.