Support Forum
Please report any issues with themes in this forum.
See the svn topic for details on how to check out the current themes folder. You will need at least the 'default' theme which the install will set as your current theme.
All themes must reside in a folder which will default to being located under wp-content. You can change the location of this folder in the forum admin 'WP Integration > Storage Locations' panel. Each theme then requires its own folder with a strict layout. See the 'default' theme as an example of this.
There are three distinct folders in a theme folder. These are 'images' which must contain all of the graphics and icons used by the theme; 'styles' which contains the CSS files (and it's own optional 'images' folder for graphics defined in the theme CSS) and an 'overlays' folder which we will discuss later; and 'templates' which contain the templates that SP will use for display.
Styles
The reset.css file should be included in any theme. The main CSS file is actually a php file and should have the same name as the theme itself. If you examine the default.php file you will see that it includes the reset CSS. You will also see that it contains many echo statements for colours and other rules. These are resolved at run time and are pulled in from the user selected 'overlay' file. Each 'overlay' file defines a set of colours and other rules so a single theme can have many overlays simply to change the colours, borders, fonts etc.
Note especially the use of the #spMainContainer id which is the main div that SP uses for displaying it's page. It is recommended that any new theme retains the names of IDs used in default.
Templates
Once again, the 'default' theme defines the minimum set of templates required for a fully functional base SP install. These mainly speak for themselves.
The best way to see how a template works is to dissect one of the 'default' theme templates. Any php or direct html can be employed. The available template functions are all located in matching files located in the /forum/content/ folder of SP. Functions can also be used, of course, from SP plugins. We have no documentation yet but a look through the template functions will reveal the list of available parameters available to each one.
Of particular note are the defining of columns. SP Version 5 has removed the use and need for tables so columns are required to pass a width argument. This can be defined as a percentage or pixel value.
It is recommended that the names and ids used for sections and columns are retained.
There is much that is needed to be documented to aid the creation of themes but that will come in due course. For now please experiment. Make a copy of the 'default' theme with a new, unique name. And use this forum for questions, recommendations and requests. We are sure to have missed something!
Thanks for helping.
 |
YELLOW
SWORDFISH
|
some additional information...
within your theme directory, there are two files you need to have... the primary one is a spTheme.txt file which defines your theme... the format for this file is:
Simple:Press Theme Title: Default Version: 1.0 Theme URI: https://simple-press.com Description: A Simple:Press theme Author: Andy Staines & Steve Klasen Author URI: https://simple-press.com Stylesheet: default.php Screenshot: spTheme.jpg Colors: silver, sky-blue, black-gold, ice, fools-gold, caribbean, berries-n-cream, easter-eggs, light-of-the-angels, gin-and-tonic, late-summer, wintery-blue, pink-lady, in-the-money Simple:Press Versions: 5.0 and above
Most of those fields are self explanatory... the Screenshot image file is the second file that needs to be in your theme directory...
the Colors label have to do with color overlays... they are completely optional but give you a way to easily provide different color variations of your theme... we will cover those in another topic...
In Andy's post, he said you need to provide a main stylesheet that is a php file... that is not quite correct... the stylesheet file could be a .css file. The php variant is what allows one to do the color overlays... whatever you choose, make sure to put the file name in the Stylesheet section of the spTheme.txt file.
worth noting that in our themes we have a couple of subdirectories under the styles directory... these are images and overlays...
overlays would contain the various different color overlays you want to provide (optional) for your theme...
images contains any stylesheet used images... mostly for different overlays... so theme/images is for general images like icons... theme/styles/images for different overlay images...
for the theme template files under templates, in addition to template files for core views, you can also include and template files you want to define for plugins, such as the private messaging plugin... plugins will provide a default template file for display, but it will check the theme first to see if a custom one has been defined.
Visit Cruise Talk Central and Mr Papa's World
and just to add, the theme and permissions are totally separate... that is, permissions have no idea or care what theme is loaded and vice versa... obviously a enterprising theme author could create new permissions within the theme itself, but my statement holds for the themes we offer...
Visit Cruise Talk Central and Mr Papa's World
I will look into it see if I can see a problem, too
website about design logo : thiet ke
1 Guest(s)