Theme Authors: Change to theme_info.xml

[Thantos]

Following SMF 1.1 we plan to give themes some better treatment through the Administration Center.

In order to do this we need to add a couple of items into the theme_info.xml file.

The first is an identification for the theme.  This will allow us to uniquely identify each theme.  In order to do this we will be adding an <id> entity.  The naming scheme we recommend for this is to have your name, followed by a colon, followed by the name of the theme.  For example the Classic YaBB SE theme would be:

Code Select Expand

<id>smf:classic</id>

The second addition is an entity to control which version of the theme it is.  This will allow us to know if the theme is a newer version then what the user has.  We will be adding the <version> entity in order to do that.  An example would be:

Code Select Expand

<version>1.1 RC2</version> or

Code Select Expand

<version>4.023</version>
Please note that your theme version doesn't need to have anything to do with the version of SMF it is for.

These changes will not be in affect for SMF 1.0 or SMF 1.1.  However since the addition of those fields will not interfer in those versions we will be updating the theme site in the coming week to look for and require both of those fields in all new themes.

Existing themes will have those two fields set when a new file is uploaded.

If you have any questions please feel free to ask.

Here is an example for the Classic YaBB SE theme's theme_info.xml

Code Select Expand


<?xml version="1.0"?>
<theme-info xmlns="http://www.simplemachines.org/xml/theme-info" xmlns:smf="http://www.simplemachines.org/">
<!-- For the id, always use something unique - put your name, a colon, and then the package name. -->
<id>smf:classic</id>
<version>1.1 RC2</version>
<!-- Theme name, used purely for aesthetics. -->
<name>Classic YaBB SE Theme</name>
<!-- Author: your email address or contact information.  The name attribute is optional. -->
<author name="Simple Machines">[email protected]</author>
<!-- Website... where to get updates and more information. -->
<website>http://www.simplemachines.org/</website>
<!-- Template layers to use, defaults to "main". -->
<layers>main</layers>
<!-- Templates to load on startup.  Default is "index". -->
<templates>index</templates>
<!-- Base this theme off another?  Default is blank, or no.  It could be "default". -->
<based-on></based-on>
</theme-info>


Thank you for your cooperation.

[Deaks]

ok im just up but do we (theme authors) need to add these to themes already on database.  If you covered it I appologise

[Thantos]

Aye you'll need to update your themes that are currently in the database.  I'll post to this topic (and probably edit the first post) once the theme site has been updated.

[Deaks]

ah ok thanks

[Crip]

OK..I see what my problem has been now when submitting.. thanks for the info_-