Fork me on GitHub

Page (1) 2 3 4 »

La surcharge des templates
19
200605
Septembre
  alain01 Documentations 29155

Nous allons ici aborder la notion de surcharge de templates, apparue depuis la version 2.0.14 de XOOPS.
Il s'agit dans cet article d'en comprendre le principe et de le vérifier par 2 exemples didactiques.

Tout d'abord détaillons le mot template :
Les templates permettent d’afficher des données (ordre, position, affichage conditionnel,…)
L’utilisation des templates permet de séparer le traitement des données de leur affichage ; on peut ainsi modifier la présentation
des données, sans toucher au code, en modifiant simplement le template.

XOOPS est fourni avec ses templates (module system, + de 26 fichiers) et notamment :
- system_redirect.html (page de redirection)
- system_siteclosed.html (page de fermeture du site)
- system_block_login.html
- system_block_online.html (bloc de login)
- system_block_comments.html (bloc des commentaires)...

Chaque module également, arrive avec son lot de templates (pages et blocs).

Exemple :
Le module News (15 templates) avec notamment :
- news_archive.html (page des archives)
- news_block_new.html (bloc articles récents)
- news_block_top.html (bloc articles les plus lus)...

Pour voir coté admin ces templates, allez dans la partie admin system / templates et cliquez sur liste pour le module qui vous intéresse dans le jeu de template default.
Vous y trouverez en partie supérieure les templates des pages puis les templates de blocs

Si ces pages et ces blocs ne vous conviennent pas tout à fait, vous avez la possibilité de les modifier en utilisant la nouvelle fonctionnalité apportée depuis la version 2.0.14 de XOOPS :
La surcharge des templates.

Pour mémoire, voila un extrait de l'article annonçant la sortie de XOOPS 2.0.14 on pouvait lire :
Citation :


Les designers peuvent ajouter des templates personnalisés à leurs thèmes qui peuvent être utilisés en remplacement de celui défini par défaut.
Pour exploiter cette fonction, les templates doivent être créés dans des sous-dossiers du thème à l'identique de la structure des dossiers des modules :
Pour surcharger :
system_userinfo.html (template situé dans modules/system/templates/system_userinfo.html) vous devez créer votre version personnalisée dans :
votre_dossier_theme/modules/system/system_userinfo.html

pour surcharger :
system_block_login.html (template situé dans modules/system/templates/blocks/system_block_login.html), vous devez créer votre version personnalisée dans :
votre_dossier_theme/modules/system/blocks/system_block_login.html


Explication :

Dorénavant, vous n'avez plus besoin de cloner un jeu de template, utilisez le jeu de template par défaut (obligatoire), et installez sous votre_dossier_theme la structure des templates de votre module.

Avantages :
- En cas de MAJ du module, vos fichiers modifiés ne seront pas écrasés
- Seuls les templates à modifier seront installés sous le dossier de votre thème
- La lisibilité des templates personnalisées est immédiate et compréhensible de part la simplicité de la structure des dossiers conteneurs
- Grande souplesse d'utilisation
- Vous pourrez trouver/fournir très facilement des thèmes avec un pack de surcharges existant (bloc login, bloc recherche...)

Page 2 : Exemple didactique 1
Page 3 : Exemple didactique 2
Page 4 : Remarques et surcharges d'images et de css...
Note: 8.00 (2 votes) - Noter cet article -
Page (1) 2 3 4 »

Partager Twitter Partagez cette article sur GG+
Format imprimable Envoyer cet article à un ami
Les commentaires appartiennent à leurs auteurs. Nous ne sommes pas responsables de leur contenu.
Xoops accro
Inscrit le: 18/01/2004
De: Ma Caverne
Contributions: 2839
Marco Posté le: 05/09/2006 01:21  Mis à jour: 05/09/2006 01:21
 Re: La surcharge des templates
smack !


marco
Xoops accro
Inscrit le: 15/07/2004
De:
Contributions: 4763
blueteen Posté le: 05/09/2006 08:22  Mis à jour: 05/09/2006 08:22
 Re: La surcharge des templates
limpide (cool
Supporter Xoops
Inscrit le: 10/08/2004
De: Tours
Contributions: 573
Didier Posté le: 05/09/2006 08:53  Mis à jour: 05/09/2006 08:53
 Re: La surcharge des templates
Devoirs fais : impeccable, simple ... ca va nous faire gagner du temps tout ca...
Régulier
Inscrit le: 04/02/2003
De:
Contributions: 203
lolothom Posté le: 05/09/2006 11:24  Mis à jour: 05/09/2006 11:24
 Re: La surcharge des templates
Hello

frxoops.fr c'est vraiment les meilleurs :banane:
Aspirant
Inscrit le: 22/02/2006
De: Strasbourg
Contributions: 40
rastanouno Posté le: 05/09/2006 12:10  Mis à jour: 05/09/2006 12:10
 Re: La surcharge des templates
je n'ai pas tout vraiment compris mais ca a l'air pratique, je vais lire plus doucement pour en comprendre les aboutissent...
:xfsuper:
Supporter Xoops
Inscrit le: 09/01/2005
De: Breizh
Contributions: 16972
Kris Posté le: 05/09/2006 20:39  Mis à jour: 05/09/2006 20:40
 Re: La surcharge des templates
Bien Alain

En compléments de l'article, je veux indiquer que la surcharge peut être également utiliser pour les feuilles de style css (possibilité de créer une feuille spécifique pour les templates d'un module), et pour les images.
Ci-dessous extrait de la releases note de la version 2.0.15 :
Citation :
Output resources overriding for developers

To allow theme designers to customize images or stylesheets, you have to use the new theme class and xoImgUrl templates plug-in.

* Scripts and stylesheets can be declared to XOOPS using the theme class addScript and addStylesheet methods. The theme instance is available after the inclusion of header.php by using the $xoTheme global variable, and in a template variable of the same name:
<{$xoTheme->addStylesheet('modules/newbb/style.css')}>
* Images and medias URLs have to be generated by using the xoImgUrl plug-in in your templates:
<img src="<xoImgUrl modules/newbb/images/reply.png}>" alt="reply" />

Output resources overriding for designers

Designers can also provide custom versions of most output-related resources using a mechanism similar to the one available to templates, for modules that support this.

* To create a custom stylesheet that will replace modules/newbb/style.css, create your customized file in
<yourthemefolder>/modules/newbb/style.css
* To create a custom image that will replace modules/newbb/images/reply.png, create your customized file in
<yourthemefolder>/modules/newbb/images/reply.png


Que voulez vous demander de plus

Merci Pascal champagne

ps : un tutoriel flash ou vidéo devrait être réalisé dans le mois
Supporter Xoops
Inscrit le: 02/08/2005
De:
Contributions: 91
Young Posté le: 06/09/2006 00:10  Mis à jour: 06/09/2006 00:10
 Re: La surcharge des templates
:pardon: Nous ne pouvons que nous incliner devant tant de travail et de simplicité !!!!

Alors je ne dirai qu'une seul chose...
Votre enthousiaste doit être partager, faîtes un petit don de quelques euros !
C'est juste sur la page d'accueil... sur la droite

Encore BRAVO à toute l'équipe !!!!
:xfsuper:
Semi pro
Inscrit le: 05/06/2004
De:
Contributions: 750
Niluge Posté le: 06/09/2006 20:06  Mis à jour: 06/09/2006 20:06
 Re: La surcharge des templates
Une petite précision : la surcharge des images et fichiers css ne fonctionne que si les modules ont été recodés pour être compatible.

Sinon merci pour ce super tuto alain01 !
Xoops accro
Inscrit le: 25/02/2004
De: Région parisienne
Contributions: 2526
DuGris Posté le: 07/09/2006 08:23  Mis à jour: 07/09/2006 08:23
 Re: La surcharge des templates
Une petite précision : la surcharge des images et fichiers css ne fonctionne que si les modules ont Ã©té recodés pour Ãªtre compatible.


Tu y vas fort, ca fonctionne sans avoir à "recoder" les modules, il suffit juste d'adapter les templates !!!
Semi pro
Inscrit le: 05/06/2004
De:
Contributions: 750
Niluge Posté le: 07/09/2006 20:54  Mis à jour: 07/09/2006 20:54
 Re: La surcharge des templates
Bwarf les templates c'est du code du module quand même!

Enfin en effet si le module est pas mal codé il n'y a qu'à toucher au templates.
Xoops accro
Inscrit le: 25/02/2004
De: Région parisienne
Contributions: 2526
DuGris Posté le: 08/09/2006 08:38  Mis à jour: 08/09/2006 08:38
 Re: La surcharge des templates
@Niluge: et oui il y a bien une différence entre adapter un template et recoder un module, les utilisateurs de xoops (non développeur) savent de quoi je parle !!!
Admin Frxoops
Inscrit le: 04/02/2003
De: Belgique
Contributions: 3376
Solo71 Posté le: 08/09/2006 21:47  Mis à jour: 08/09/2006 21:47
 Re: La surcharge des templates
Puissant! Et je sais de quoi je parle.
Admin Frxoops
Inscrit le: 16/05/2003
De: Rhone-Alpes
Contributions: 4051
alain01 Posté le: 09/09/2006 00:49  Mis à jour: 09/09/2006 00:49
 Re: La surcharge des templates
Merci à tous pour vos commentaires très enthousiastes.
Tout le mérite va en réalité à Skalpa qui a développé ces fonctionnalités supplémentaires qui vont devenir, et je n'en doute pas, très rapidement indispensables.

je vous invite à consulter à nouveau cet article et en particulier la page 4 où j'apporte des précisions notamment sur la surcharges des images.

Merci
Supporter Xoops
Inscrit le: 09/01/2005
De: Breizh
Contributions: 16972
Kris Posté le: 09/09/2006 13:32  Mis à jour: 09/09/2006 13:32
 Re: La surcharge des templates
:xfsuper:
Régulier
Inscrit le: 09/04/2006
De:
Contributions: 423
Ankyo Posté le: 22/09/2006 17:49  Mis à jour: 22/09/2006 17:49
 Re: La surcharge des templates
Merci pour ce tuto, ça marche super bien bravo à celui qui a eu l'idée de créer cette fonction sous xoops (cool
Régulier
Inscrit le: 23/03/2005
De:
Contributions: 408
lasco Posté le: 27/09/2006 07:41  Mis à jour: 27/09/2006 07:41
 Re: La surcharge des templates
superbe tuto

merci alain
Régulier
Inscrit le: 26/04/2003
De: Geneve - Suisse
Contributions: 129
Gigamaster Posté le: 28/09/2006 02:45  Mis à jour: 28/09/2006 02:45
 Re: La surcharge des templates
Le seul défaut du "vieux système" était l'éditeur et l'impossibilité de "prévisualiser" les templates modifiés.

Il y a une estimation, ou résultats du gain de performances ou d'usabilité?

Parce que Xoops avait déjà là possible de "cloner" les templates d'un module, qui plus est, editables dans l'administration. Et ensuite d'utiliser un theme associé à un jeu de templates.
:roll:
Régulier
Inscrit le: 16/08/2006
De:
Contributions: 308
H-hich Posté le: 02/12/2006 00:12  Mis à jour: 02/12/2006 00:12
 Re: La surcharge des templates
Bonjour, je tiens a vous remercier pour ce dossier, qui m'a l'air tres pratique, des que j'aurai du temps pour m'y mettre je l relirer profondement.

Je me permet de poster une question qui paraitra idiote, mais j'aimerai savoir ou trouver l'icone jaune de phylactere qu'on trouve dans ce tuto en page 2, pour remplacer le peu esthetique rond blanc de base.

Merci.
Admin Frxoops
Inscrit le: 16/05/2003
De: Rhone-Alpes
Contributions: 4051
alain01 Posté le: 02/12/2006 07:27  Mis à jour: 02/12/2006 07:27
 Re: La surcharge des templates
Bonjour H-Hich,
Merci.

Pour le phylactère, on peut le voir sur la page principale du site de la Ligue Rhône-Alpes de volleyball
Propulsé avec XOOPS | Graphisme adapté par Tatane, Grosdunord, Montuy337513

27 Personne(s) en ligne (1 Personne(s) connectée(s) sur Articles) | Utilisateur(s): 0 | Invité(s): 27 | Plus ...