SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

290 Plugins, 198 contribs On SPIP-Zone, 103 visitors now

Home > Templates > Tools for Templates > SKtheme > Plugin : Sktheme

Plugin : Sktheme

Theme manager for spip 1.9.2

21 December 2006 – by skedus – commentaires

All the versions of this article: [English] [français]

11 Votes

-  Plugin Name : sktheme
-  Version : 0.6 (1.0 simple version http://skedus.free.fr/spip/spip.php...)
-  Author : Team work on SPIP-Zone
-  Licence : GPL
-  SPIP Compatibility : SPIP 1.9 and 1.9.1
-  Site example : Skedus Land
-  Main features :

  • Manage theme directories for squelette (bone) and css distribution
  • Public space theme switcher

Installation

-  First you need to get a .zip distribution, either here below or on spip-zone for a more recent version
-  Unzip the file sktheme-0.6-plugin.zip (which will give you a sktheme directory)
-  Upload this directory sktheme (and its content ;-) ) in the plugin directory to your SPIP site root (you should create this plugin directory if necessary)
-  In the menu Configuration->Manage plugins of the private area, select the Sktheme plugin to activate it.

You are now ready to configure the plugin: use Configuration->Manage themes in the private area.

  1. Choose a squelette distribution (at the beginning you don’t really have any choice because only the official distribution dist is available, but don’t worry: you will be able to add some others).
  2. As soon as you select a squelette distribution the habillage (meaning the color, look, css) list will be updated with the available options. (Once again, at first not a lot of choice, only dist but we will see later how to add some others.)

For those who want to go quick, quick, quick!

Sometime a demo is better than a boring explanation, and you can test the themes directory example by doing this:

  1. Download the file sktheme-0.6-themes.zip
  2. Unzip the file (which gives you a themes directory)
  3. Upload this directory to your SPIP root directory
  4. Go back to the private area and navigate to Configuration->Manage theme
  1. Select a new habillage (these habillage (css) styles are based on the official squelette (template) distribution)
  2. Validate

Your public space has changed! Magic, isn’t it ?

Principle

Let’s see how it works — it is quite simple :
-  The idea is to use the SPIP search directory mechanism.
-  Define a theme as squelettes (template) + a habillage (css)

The search order will be then:

  1. habillage directory (one directory per habillage) [1]
  2. squelette (one directory per squelette distribution) [2]
  3. squelettes directory (if you have one)
  4. dist directory (Official squelette directory of SPIP)

Sktheme allows you to choose the location for the first two (see the plugin configuration page in the private area). themes is the default value for both.

Note: you can choose to have 2 different locations or not, it’s up to you.

Tips:

It is possible to put a template (squelette) such sommaire.html in the habillage directory. Then not only the look but also the page structure will change when you switch from one habillage to another.
Well this is not what sktheme is supposed to handle but it works: SPIP is so good ;-)

To distinguish between squelettes directory and habillage directory, Sktheme is using a file call theme.xml [3]. This file needs to exist in each directory and allows sktheme to keep up-to-date the list of available habillages and squelettes in the private area.

The switcher

On Spip-zone you can find many useful things, that is nothing new :-),
I found a nice plugin call switcher written by Fil which allows you to have several template directories and to switch from one to another (mainly to test and check templates). Modifying this plugin to handle the two extra directories, we can add a theme switcher to sktheme.
Thanks to Fil then, sktheme has its own switcher.

WATCH OUT
As the sktheme switcher is based on the same principle as Fil’s switcher, you cannot use both. So if you want to use sktheme, please disactivate the switcher plugin first.

The sktheme switcher is activated in the configuration page. You can chose to activate it for administrator or for everyone as you want.

As soon as the switcher is activated, a new menu is available at the top of your public area.

Balise

Skteme comes with a new tag that you can introduce in your bones.

-  #SKTHEME_HABILLAGES_SWITCHER: this tag include a new menu for switching from one habillage to another. Then your users can choose.

Themes creation

-  build your templates as usual.
-  place the result in a directory
-  then create a theme.xml file for sktheme

It is easier to take a look at the example in the zip below.

I hope that this plugin will be useful to you.

WATCH OUT:

In order to simplify Sktheme usage a new version is available
on : http://skedus.free.fr/spip/spip.php...

This version only modify the habillage.css file but add some colors to your SPIP distribution, Well just enough to start fast and to want more ;-)

Footnotes

[1a habillage directory is located in the habillage directory defined in the sktheme configuration page

[2a squelette directory is located in the squelette directory defined in the sktheme configuration page

[3This file is described in the online documentation of the sktheme plugin

updated on 27 March 2009

Back to top

Your comments

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Add a document

Back to top

Here they're talking

  • (fr) Jeux pour SPIP 3

    27 juillet 2012 – 53 commentaires

    Un portage pour SPIP 3 du plugin Jeux a été fait. Explications et nouveautés. Cet article concerne une mise à jour du plugin Jeux dont la description complète est disponible ici : Des jeux dans vos articles !. Le code du plugin Jeux est un code (...)

  • (fr) Plugin Vidéo(s)

    23 novembre 2010 – 704 commentaires

    Interface de gestion et modèle d’insertion des vidéos : Dailymotion Vimeo Youtube Modèle de la balise HTML5 video avec alternative flash html5media : Lecture HTML5/Flash pour tout navigateur des fichiers MP4/H264/Ogg/WebM/Mkv Support mobile, iPad, (...)

  • (fr) Vidéo Accessible

    6 avril 2011 – 168 commentaires

    Un plugin pour faciliter la diffusion de vidéos accessibles. Accessibilité des vidéos Accessibilité de la vidéo Afin d’être pleinement accessible, une vidéo (composée d’images et de sons) doit répondre à plusieurs critères. Le critère de base est (...)

  • (fr) Groupes de mots clés arborescents

    26 juillet 2012 – 37 commentaires

    Ce plugin permet de gérer une arborescence de groupes de mots clés. Les sous groupes de mots héritent des propriétés du groupe racine (sur quoi peut on le lier ? peut il y avoir un ou plusieurs mots). Les formulaires de liens qui permettent de lier (...)

  • (fr) Mailshot

    16 janvier 2013 – 336 commentaires

    Ce plugin prend en charge l’envoi en nombre d’info-lettres par email. Mailshot permet l’envoi en nombre d’emails au moyen d’un SMTP (ou d’un service externe) dédié à cet effet. Il permet de limiter la cadence d’envoi. Enfin, ce plugin implémente la (...)