• Welcome to SMF 2.1 testing warzone. Please login or sign up.
Feb 19, 2019, 10:00 am


SMF - Just Installed!


Started by Gwenwyfar, Jul 07, 2018, 10:31 pm

Previous topic - Next topic

0 Members and 1 Guest are viewing this topic.


The following is a collection of guides and tutorials about how to create a custom theme for SMF. If you don't know where to start, we recommend viewing the Basic theme guide.

When following those guides, note that little has changed in the creation of themes between 2.0.x and 2.1. Most of the differences are in the themes themselves (curve and curve2).

Creating and understanding themes
Creating multi-style themes
List of templates and their functions

If you have any questions or need help while editing your theme or making a new one, post a new topic here. Remember that the clearer you are, the better we will be able to help you :)


So you want to make a theme (or you already made one!) and want to submit it to the theme site. All themes submitted to the theme site will first go through a review process before they receive an approved status and are shown in searches. If a problem is found during the review, you will be asked to fix it before proceeding. Here's how to get your theme ready:

Required folders
  • css: This folder should have all your custom css files, as well as a copy of rtl.css.
  • images: Images folder containing all images used by your theme.
  • scripts: The theme.js file should be in this folder. You can use this file to add any custom js, or you may add your own files.
  • languages: This should contain the Settings.english.php file, which is where you can edit the description for your theme. You can include other language files for your theme here, but english should always be available. If you are using any custom strings, these can be added in ThemeStrings.english.php. This file will load by default when available.

Required files
  • theme_info.xml: This file contains data about your theme. You can download a template below. Both 2.0.x and 2.1 use the same file. (More about theme_info.xml)
  • license.txt: This file should contain license information for your theme, and any other licensed work you have used in your theme (ex: images). For help with choosing a license, see the wiki page on Customization Licenses and this topic. You can use any license you want to, or write your own license.
  • images/thumbnail.gif: A preview thumbnail of your theme. Preferably, you should use the same size as the default thumbnail.
  • index.php: A copy of the default file.

Theme guidelines
And of course, your theme should comply with the guidelines outlined here.

And finally, once you have made your theme, time to package it! For the theme to install correctly, you should package only the root files and folders. Compress it into a .zip or .tar.gz file and it's ready to go. If you package is inside a main folder, your theme will not work.

To submit your theme, simply go to the theme site and post a new theme.

If you have any questions about the approval process or guidelines, you can ask here or send a PM to someone in the customization team.

Quick Reply

With Quick-Reply you can write a post when viewing a topic without loading a new page. You can still use bulletin board code and smileys as you would in a normal post.

Warning: this topic has not been posted in for at least 42 days.
Unless you're sure you want to reply, please consider starting a new topic.

Note: this post will not display until it's been approved by a moderator.


Shortcuts: ALT+S save/post or ALT+P preview