Utilisation de modèles / gabarits

Date 10/01/2013 | Sujet : Documentations

Bonjour,

Beaucoup d'entre vous réalisent des sites web avec un contenu qui, pour certaines rubriques auraient besoin d'uniformisation.

Il s'agit ici de vous indiquer assez simplement comment créer des modèles (ou gabarit) de fiches (fiche cuisine, fiche livre, fiche cinéma, fiche voiture).
L'intérêt est multiple :
- Uniformiser vos pages "fiches"
- Ne pas recréer une page qui pourrait être déjà préformatée et pré-remplie
- Utiliser aisément vos gabarits disponibles afin de les remplir en vue de créer une news ou tout autre document.

Je vous indique ici la procédure (en 5 étapes) :

1 - Activation de l'éditeur TinyMCE pour les modules
2 - Ajout du bouton "Insérer un modèle prédéfini"
3 - Création des fichiers gabarits
4 - Création d'un fichier de définition des gabarits
5 - Dépôt des fichiers sur le serveur
6 - Utilisation



1 - Activation de l'éditeur TinyMCE pour les modules (c'est l'éditeur en démo ici)
Administration / Préférences / Paramètre du système / Paramètres de l'éditeur de texte / Editeur de texte pour l'ensemble des modules : tinymce
(ou bien choisissez comme éditeur par défaut TinyMCE pour le module que vous souhaitez utiliser, dans les préférences du module en question).


2 - Ajout du bouton "Insérer un modèle prédéfini"

Modification du fichier /class/xoopseditor/tinymce/settings.php :
Ligne 70, changez
"paste,fullscreen,visualchars,nonbreaking,inlinepopups",
en
"paste,fullscreen,visualchars,nonbreaking,inlinepopups,template",

puis ligne 85
"theme_advanced_buttons4" => "xoopsimagemanager,xoopsemotions,xoopsquote,xoopscode,xoopsmlcontent",
en
"theme_advanced_buttons4" => "xoopsimagemanager,xoopsemotions,xoopsquote,xoopscode,xoopsmlcontent,template",
"template_external_list_url" => '/_uploads/gabarits/liste-gabarits.js',

(On indique ici que les gabarits vont se situer dans le dossier /_uploads/gabarits et que le fichier de définition des gabarits se nomme liste-gabarits.js


3 - Création des fichiers gabarit

Ces fichiers sont au format html et ne doivent contenir aucune balise < html >, < body > ou
<head >

Ici on crée 2 fichiers html :
- fiche-cuisine.html,
- fiche-livre.html.
Il faut soigner la présentation de ces fichiers, fixer les tailles et les positions des éléments...
Par exemple, pour la fiche cuisine, vous pouvez créer une fiche avec :
Titre de la recette :
Ingrédients :
Difficulté :
Temps de préparation :
Le tout à placer judicieusement.


4 - Création d'un fichier de définition des gabarits

Ici on crée un fichier de définition des gabarits
Contenu du fichier liste-gabarits.js :
// JavaScript Document

var tinyMCETemplateList = [ 

// Nom, URL, Description

["Fiche cuisine""/_uploads/gabarits/fiche-cuisine.html""Gabarit pour fiche cuisine."],

[
"Fiche Livre""/_uploads/gabarits/fiche-livre.html""Gabarit pour fiche livre."] ];



5 - Dépôt des fichiers sur le serveur

Déposez sous /_uploads/gabarits vos fichiers
- liste-gabarits.js
- fiche-cuisine.html,
- fiche-livre.html.
- index.html (à prendre en copie depuis un autre dossier)


6 - Utilisation

Il suffit d'aller dans le module (news par exemple), cliquez sur l'icône "Insérer un modèle prédéfini" puis dans la nouvelle fenêtre, choisissez le gabarit dont vous avez besoin ("fiche cuisine" pour créer votre recette de tarte à la pomme, par exemple).

Et voilà ! Ça vous plait ?

S'il vous plaît, faites-le moi savoir, ça fait toujours plaisir...

PS 1 : un grand merci à montuy337513 pour son aide énorme, sur les forums de XOOPS France.

Ps 2 : ça serait sympa de proposer cela par défaut dans les prochaines version de XOOPS, sans avoir besoin d'intervenir dans les fichiers, non ?



Cet article provient de Communauté Francophone des Utilisateurs de Xoops
http://www.frxoops.org

L'adresse de cet article est :
http://www.frxoops.org/modules/news/article.php?storyid=1928