wkp_Themes

Dernière modification : 2007/11/05 21:55
wkp_Themes est un plugin permettant de proposer plusieurs thèmes d'affichages à l'utilisateur de WiKiss.

nécessite WiKiss 0.3rc1 ou supérieure

Téléchargement

Installation

  1. décompressez l'archive dans le répertoire de WiKiss

Fonctionnement

Le sélecteur de thèmes liste les thèmes présents dans votre installation :
  • si le plugin est installé et que le répertoire themes existe, les fichiers template.html et style.css à la racine de votre Wiki seront ignorés ;
  • defaut : le thème qui sera choisit par défaut par WiKiss ;
  • la liste des autres fichiers template présents dans le sous-répertoire themes.
Lorsque l'utilisateur choisit un thème, un cookie est enregistré sur son ordinateur afin de conserver son choix.

Désinstallation

Pour désactiver le plugin thème vous avez deux possibilités :
  • renommer le fichier wkp_Themes.php situé dans le répertoire plugins (par exemple en _wkp_Themes.php), c'est la méthode conseillée ;
  • renommer le répertoire themes.
Pour supprimer complètement le plugin :
  1. effacez le fichier plugins/wkp_Themes.php ;
  2. effacez le répertoire themes.
WiKiss utilisera alors les fichiers template.html et style.css présents à la racine de votre installation.

Écrire un thème

Pour écrire un thème destiné à WiKiss, il vous faut un fichier de template et un de style :
  • xxx.html le template ;
  • xxx.css le fichier de style.
Ceux-ci doivent être placés dans le répertoire themes créé lors de l'installation du plugin.

Le fichier template est une page HTML qui contient un certain nombre de balises encadrées par une paire d'accolades. Celles-ci sont remplacées par les valeurs propres à votre wiki, dans la page affichée.
Vous pouvez trouver la liste des balises spéciales dans la documentation de configuration
Chaque fichier template doit contenir la balise {THEME_LIST} afin d'afficher le sélecteur de thème.

Le fichier de style CSS est facultatif et doit être référencé par votre template.