PLUGIN TEMPLATES "A LA SPIP" POUR THELIA ---------------------------------------- Ce plugin vous permet d'utiliser des templates spécifiques pour chaque rubrique produit, dossier et contenu, à l'aide d'une simple convention de nommage de fichier. Contact et support: Franck Allimant / CQFDev (www.cqfdev.fr). Sujet du plugin sur le forum Thelia: http://forum.thelia.fr/viewtopic.php?id=4835 .oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo. UTILISATION ----------- Le plugin utilise les ID des rubriques ou des dossiers pour sélectionner un template HTML, d'un suffixe '+y', '=x' ou '-x', x étant l'ID de la rubrique ou du dossier, et y l'ID d'un contenu ou d'un produit Si le plugin trouve le template +y, il l'utilisera pour l'affichage du produit ou du contenu dont l'ID est y. Si le plugin trouve le template =x, il l'utilisera pour l'affichage du dossier ou de la rubrique dont l'ID est x. Si le plugin trouve le template -x, il l'utilisera pour l'affichage du dossier ou de la rubrique dont l'ID est x, ainsi que pour toutes les sous-éléments. Exemples pour les rubriques: vous souhaitez utiliser un template spécifique à la rubrique ID=1, et à elle seule: créez un template nommé rubrique=1.html vous souhaitez utiliser un template spécifique à la rubrique ID=1, et à toutes les sous-rubriques de cette rubrique: créez un template nommé rubrique-1.html Exemple pour les produits: vous souhaitez utiliser un template spécifique au produit ID=5 créez un template nommé produit+5.html vous souhaitez utiliser un template spécifique aux produits appartenant à la rubrique ID=4 et à elle seule, créez un template nommé produit=4.html vous souhaitez utiliser un template spécifique aux produits appartenant à la rubrique ID=4 ou une de ses sous-rubriques, créez un template nommé produit-4.html Pour les dossiers et les contenus, le principe est le même, en utilisant des templates nommés dossier-x.html (ou dossier=x.html), et contenu+y.html. ALIAS ----- Si pour vous les ID ne sont pas assez parlants, il est possible de définir un alias pour les produits, rubriques, dossiers et contenu. Vous pouvez alors utiliser cet alias pour nommer vos fichiers au lieu d' l'identifiant. Par exemple, si le produit ID=23 à pour alias "bottes", vous pouvez nommer le template spécifique de ce produit: produit+bottes.html au lieu de: produit+23.html PERDU(E) ? ---------- Si vous ne comprenez pas exactement l'algorithme de choix du template, vous pouvez activer un mode 'debug' dans le B.O. du plugin, afin de voir précisément comment les templates sont trouvés. Lors de l'affichage d'une page de votre site, une trace de la recherche effectuée par le plugin sera affichée: Examen du paramètre URL ref Examen de l'objet Produit ID=exemple_decors_coffre_1 Test de l'existence du template squelettes/mymini/produit=6.html Test de l'existence du template squelettes/mymini/produit-6.html Examen du paramètre URL id_rubrique Examen de l'objet Rubrique ID=4 Test de l'existence du template squelettes/mymini/produit=4.html Test de l'existence du template squelettes/mymini/produit-4.html Examen de l'objet Rubrique ID=7 Test de l'existence du template squelettes/mymini/produit=7.html Test de l'existence du template squelettes/mymini/produit-7.html Template final: squelettes/mymini/produit.html Pensez à désactiver le mode debug avant de mettre votre site en ligne ! .oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo.oOo. HISTORIQUE ---------- 17-08-2010: 1.0.0 : Version initiale 09-11-2010: 1.0.1 : Correction d'un bug sur les contenus 03-01-2011: 1.0.2 : Correction d'un autre bug sur les contenus 10-01-2011: 1.0.3 : Correction d'une boucle infinie si l'ID de l'objet recherché n'existe pas. 31-01-2011: 1.0.4 : Mise en place du mode debug, affinement de l'algorithme de recherche du template. 19-04-2011: 1.1.0 : Support de Thelia 1.5, nouvelles règles pour trouver les templates produit et contenus, afin d'éviter des confusions entre ID de dossier/ ID de contenu et ID produit/ID rubrique Utilisation possible d'un alias sur chaque objet 09-08-2011: 1.1.1 : Correction de "Quand j'accède à la rubrique 1, cela charge bien rubrique=1.html, par contre, quand je charge la rubrique 2, ou 3, cela charge rubrique=1.html au lieu de rubrique.html. 25-08-2011: 1.2 : Ajout d'une interface d'administration permettant de gérer l'activation du plugin et d'un mode debug 25-08-2011: 1.2.1 : Résolution d'un conflit avec le plugin Multisquelettes. 31-08-2011: 1.2.2 : Résolution d'un conflit dans le back office. -- Fin du fichier LISEZMOI.txt