Comment personnaliser le graphisme d'un site
13
pages
Latin
Documents
Le téléchargement nécessite un accès à la bibliothèque YouScribe Tout savoir sur nos offres
13
pages
Latin
Documents
Le téléchargement nécessite un accès à la bibliothèque YouScribe Tout savoir sur nos offres
Publié par
Langue
Latin
Comment personnaliser le graphisme d’un site
qui utilise les plugins relatifs aux fonctions de base de GISEH
MEEDDM - C. Imberti
12/02/2010
SOMMAIRE
1. INTRODUCTION........................................................................................................................................................... 2
2. COMMENT PERSONNALISER LE GRAPHISME D’UN SITE............................................................................. 3
2.1 CREER UN PLUGIN EN COPIANT L’UN DES PLUGINS « CHARTE GRAPHIQUE … »......3
2.2 DONNER UN NOM ET UNE DESCRIPTION A CE NOUVEAU PLUGIN.................................................................3
2.3 MODIFIER LA FEUILLE DE STYLE DE CE NOUVEAU PLUGIN..........4
2.4 AJOUTER DES IMAGES DANS CE NOUVEAU PLUGIN..........................................................4
2.5 SURCHARGER UN SQUELETTE EXISTANT ..........................................................................................................5
2.6 AJOUTER UN SQUELETTE DANS CE NOUVEAU PLUGIN...................7
2.7 MODIFIER LA LISTE DES RACCOURCIS OU DES FORMES7
2.8 AJOUTER DES RACCOURCIS OU DES FORMES.....................................................................................................7
2.9 POUR ALLER PLUS LOIN ........................................7
3. ANNEXES ........................................ 8
3.1 BALISES, FILTRES ET CRITERES ADDITIONNELS.................................................................. ...
Publié par
Langue
Latin
Comment personnaliser le graphisme d’un site qui utilise les plugins relatifs aux fonctions de base de GISEH MEEDDM - C. Imberti 12/02/2010 SOMMAIRE 1. INTRODUCTION........................................................................................................................................................... 2 2. COMMENT PERSONNALISER LE GRAPHISME D’UN SITE............................................................................. 3 2.1 C REER UN PLUGIN EN COPIANT L ’ UN DES PLUGINS « C HARTE GRAPHIQUE
» ......................................3 2.2 D ONNER UN NOM ET UNE DESCRIPTION A CE NOUVEAU PLUGIN .................................................................3 2.3 M ODIFIER LA FEUILLE DE STYLE DE CE NOUVEAU PLUGIN ..........................................................................4 2.4 A JOUTER DES IMAGES DANS CE NOUVEAU PLUGIN ..........................................................................................4 2.5 S URCHARGER UN SQUELET TE EXISTANT ..........................................................................................................5 2.6 A JOUTER UN SQUELETTE DANS CE NOUVEAU PLUGIN ...................................................................................7 2.7 M ODIFIER LA LISTE DES RACCOURCIS OU DES FORMES ...................................................................................7 2.8 A JOUTER DES RACCOURCI S OU DES FORMES .....................................................................................................7 2.9 P OUR ALLER PLUS LOIN ........................................................................................................................................7 3. ANNEXES ........................................................................................................................................................................ 8 3.1 B ALISES , FILTRES ET CRITERES ADDITIONNELS ...............................................................................................8 3.2 E XEMPLES DE FICHIERS XML DE PARAMETRAGE ............................................................................................9
MEEDDM - C. Imberti
1
1. Introduction Les plugins correspondants aux fonctionnalités de base de Giseh sont les suivants : -le plugin « ciparam : Configurateur de squelettes » -le plugin « cisquel : Squelettes de base avec 3 colonnes » -les plugins « Charte graphique
»
MEEDDM - C. Imberti
2
2. Comment personnaliser le graphisme d’un site 2.1 Créer un plugin en copiant l’un des plugins « Charte graphique
» Une fois que les fichiers des plugins correspondants aux fonctions de base de Giseh auront été copiés, l’arborescence du site sera similaire à celle-ci :
Créer un plugin en copiant l’un des plugins « Charte graphique
». Par exemple, créer, dans le dossier « plugins », un sous dossier « monpremierplugin » (le nom est libre sous réserve qu’il ne corresponde pas à un plugin existant). Ensuite, copier tout le contenu du dossier « graphisme_bleu_arrondi » (y compris ses sous dossiers) dans le dossier « monpremierplugin ». 2.2 Donner un nom et une description à ce nouveau plugin Ouvrer le fichier plugin.xml qui se trouve dans le dossier « monpremierplugin . » Remplacer : <nom>Charte graphique bleue avec des arrondis</nom> par exemple par : <nom>Charte graphique personnalisée</nom> puis remplacer : <description>Graphisme bleu arrondi.</description> par exemple par : <description>Description de ma charte graphique</description> <plugin> <nom> Charte graphique bleue avec des arrondis </nom> <lien></lien> <version>1.0</version> <version base>1.0</version base> _ _ <etat>test</etat> <description> Graphisme bleu arrondi. </description> <prefix>charte</prefix> <install>base/charte install.php</install> _ <necessite id="SPIP" version='[2.0.9;]' /> <necessite id="cisquel" version='[1.0;]' /> </plugin> Attention : ne pas modifier la ligne <prefix>charte</prefix>
MEEDDM - C. Imberti
3
2.3 Modifier la feuille de style de ce nouveau plugin Le fichier de la feuille de style se trouve dans le dossier « _css » et se nomme « style_site.css ». Il convient de conserver ce nom de fichier ainsi que le nom du dossier. La feuille de style est organisée de la manière suivante : Structure En tête ---Milieu (colonnes gauche, centrale et droite) -Contenu (colonne centrale) -Menu gauche -Menu droit -Pied de page Styles -Styles globaux -Arrondis Menu principal --Menu déroulant -Barre de progression -Menu 1 -Menu 2 -Rechercher -Contenu - commun -Contenu - Rubrique Contenu - Page d'accueil --Pied -Article photo -Formulaire -Tableau -Forums -Forums hiérarchiques Style agenda - Plan --Galerie d'images Styles propres de SPIP Pour le portage sous SPIP 2 -Structure générale des formulaires -Réponses, prévisualisation et erreurs -Variantes et cas particuliers
Remarque : Par rapport à la feuille de style style site_intraano bleu 1024.css de Giseh version 2.4, des lignes ont _ _ _ été ajoutées à la fin de la feuille de style, à partir du titre suivant : /* ------------------------------------------ */ /* Pour le portage sous SPIP 2 */ /* ------------------------------------------ */ 2.4 Ajouter des images dans ce nouveau plugin Les images se trouvent dans le dossier _ mage convient de conserver ce nom de dossier. « i s ». Il
MEEDDM - C. Imberti
4
2.5 Surcharger un squelette existant Il convient de recopier un squelette du plugin « cisquel » dans notre nouveau plugin. Attention : il ne faut pas modifier les fichiers situés dans le plugin « cisquel ». Dans le plugin « cisquel », les squelettes sont soit à la racine du plugin, soit dans l’un des dossiers : contenu, extra, navigation, noisettes.
Si, par exemple, on souhaite modifier le squelette de la pa e d’accueil, il convient de recopier le fichier cisquel/sommaire.html dans le dossier du nouveau plugin et de modifier cette copie.
MEEDDM - C. Imberti
5
Le squelette article.html, du plugin « cisquel : Squelettes de base avec 3 colonnes », comprend désormais 9 inclusions, dont 3 varient en fonction de l’article (la colonne de gauche, la colonne de droite et les commentaires). Les nouvelles inclusions sont entourées en gras dans le schéma suivant : Plugin des squelettes de base : page d'un article (article.html)
noisettes/ recherche gauche.html _ navigation / article.html
noisettes/head.html noisettes/haut.html
contenu /article.html noisettes/commentaire.html
extra /article.html
noisettes/ compteur_article.html noisettes/pied.html La plupart des formes d’article diffèrent uniquement par le contenu de leur colonne centrale. Aussi, afin de factoriser l’ensemble de la page hors colonne centrale, le contenu de la colonne centrale (hors commentaires) fait l’objet d’une inclusion. Les formes seront donc pour la plupart dans le dossier « contenu », ce qui favorise la factorisation des squelettes. Lorsqu’une forme d’article ou de rubrique diffère au-delà de sa colonne centrale (par exemple la forme de rubrique « avec une image cliquable dans le texte de la rubrique »), elle devra être placée à la racine du plugin. Le mécanisme d’aiguillage entre les squelettes, du plugin « ciparam : Configurateur de squelettes » gère ces deux cas de figure.
MEEDDM - C. Imberti
6
2.6 Ajouter un squelette dans ce nouveau plugin Si l’on souhaite ajouter un squelette à ce nouveau plugin, il convient de le placer à la racine du plugin, sauf s’il s’agit d’une forme d’article ou de rubrique, que l’on placera dans le sous dossier « contenu ». 2.7 Modifier la liste des raccourcis ou des formes Il convient de créer un dossier « ciparam / » dans le nouveau plugin et d’y recopier le fichier concerné _ du plugin « cisquel », puis de modifier cette copie : _ciparam/formes-articles fr.xml _ _ciparam/formes-rubriques_ fr.xml _ciparam/raccourcis-articles fr.xml _ _ciparam/raccourcis-rubriques fr.xml _ _ciparam/raccourcis-syndic_fr.xml Cette copie sera prise en compte à la place de la liste de raccourcis ou de formes des squelettes de base. Ceci permet d’ajouter et de retirer des raccourcis (ou des formes) voire de modifier le libellé d’un raccourci existant, puisque c’est la liste des raccourcis de la variante qui est prioritaire. Ceci est également valable pour les autres fichiers XML qui figurent en annexe. 2.8 Ajouter des raccourcis ou des formes Si on souhaite uniquement ajouter des formes ou des raccourcis, il convient d’ajouter (dans le nouveau plugin) le préfixe «ajout-» au fichier XML, et de mettre dans ce fichier uniquement les formes à ajouter (cf. annexe), ces formes additionnelles seront prises en compte dans la liste déroulante qui permet de choisir la forme. Idem pour l’ajout de raccourcis. Par exemple : _ciparam/ajout-formes-articles_fr.xml <?xml version="1.0" encoding="iso-8859-1"?> <item><nom>maformearticle</nom><description>Description de la forme d’article</description></item> 2.9 Pour aller plus loin Comme pour tout plugin, on peut créer : -des options ; -des fonctions ; -des balises ; -des filtres ; -des critères. Et bien sûr, on peut utiliser des pipelines, etc. La documentation est consultable sur le site : http://programmer.spip.org/ MEEDDM - C. Imberti
7
3. Annexes 3.1 Balises, filtres et critères additionnels 3.1.1 Des balises (surchargeables) Certaines informations renseignées dans le formulaire de configuration des squelettes, sont exploitées par des balises additionnelles utilisables dans les squelettes : _ _ -CIPARAM MOTCLE ACCUEIL _ _ -CIPARAM NOM BANDEAU _ _ -CIPARAM ABONNEMENT XITI -CIPARAM_AFFICHER (pour un affichage conditionnel en fonction du paramétrage du site). Un fichier XML masquer_fr.xml », qui liste différents items que l’on peut masquer ou non, pourra « être utilisé par une variante. Dans le squelette de la variante on vérifiera si certains items doivent être masqués ou non avant d’afficher la partie concernée, grâce à cette balise CIPARAM AFFICHER. Cela permet de réduire de 10 le nombre de chartes graphiques intranet _ (intraext x 5 couleurs, intraano x 5 couleurs). Par ailleurs, c’est une meilleure solution que de masquer la partie concernée via la feuille de style. Comme une seule variante pourra être active, la surcharge de ces balises est possible. A noter que deux autres balises figurent à titre de réservation : -CIPARAM_IMAGE_BANDEAU (réservation pour les multi-sites) -CIPARAM_LOGO_ARI (réservation pour la signalétique des accès restreints) 3.1.2 Un critère supplémentaire Le nombre d’actualités renseigné dans le formulaire de configuration des squelettes, est exploité par le critère additionnel « ciparam_nombreactu » qui est utilisable dans les squelettes. 3.1.3 Des filtres supplémentaires pour les problèmes de volumétrie de rubrique ciparam_plan ($tableau) Ce filtre construit le plan du site à partir du tableau des rubriques concernées, qui lui est passé en paramètre. Chaque ligne du tableau passé en paramètre de la fonction doit comprendre #ARRAY{id_parent,#ID_PARENT,id_rubrique,#ID_RUBRIQUE,titre,#TITRE} ciparam_menu($tableau_rubriques_niveau1, $tableau_rubriques_niveau2, $tableau_rubriques_niveau3, $variante='') Ce filtre renvoi le menu déroulant à partir de 3 tableaux des rubriques concernées Chaque ligne des tableaux passés en paramètre de la fonction doit comprendre #ARRAY{id_parent,#ID_PARENT,id_rubrique,#ID_RUBRIQUE,titre,#TITRE} Si le paramètre $variante est égale à ‘menu2’, alors c’est le menu utilisant jquery qui est renvoyé.
MEEDDM - C. Imberti
8
3.2 Exemples de fichiers XML de paramétrage 3.2.1 Exemples des fichiers XML situés dans le plugin des squelettes de base. Ces fichiers sont situés dans le sous dossier « ciparam » du plugin des squelettes de base _ (« cisquel »). formes-articles fr.xml _ <?xml version="1.0" encoding="iso-8859-1"?> <item><nom>_articlesmememotcle</nom><description>Avec des liens vers les articles ayant l'un de ses mots clés</description></item> <item><nom>_comarquage</nom><description>Le texte est issu d’un autre site par comarquage</description></item> _ m><descr p on>Article sur lequel on peut ajouter et lire des <item><nom> commentaire</no i ti commentaires</description></item> _ page</nom><description>On peut ajouter et lire des c <item><nom> commentaireautre ommentaires sur une autre page</description></item> <item><nom> liensutiles</nom><description>Avec des liens vers les sites référencés dans la rubrique</description></item> _ <item><nom> motcle</nom><description>Avec sa liste des mots-clés en bas de page</description></item> _ <item><nom>_photo</nom><description>Article sous forme de reportage photo</description></item> <item><nom>_photomosaique</nom><description>Reportage photo en mosaique</description></item> <item><nom>_phototheque</nom><description>Galerie de photos</description></item> <item><nom>_sommaireautomatique</nom><description>Avec un sommaire automatique des intertitres</description></item> formes-rubriques_fr.xml <?xml version="1.0" encoding="iso-8859-1"?> <item><nom>_2colonnes</nom><description>Les sous rubriques sont présentées sur 2 colonnes</description></item> <item><nom>_3colonnes</nom><description>Les sous rubriques sont présentées sur 3 colonnes</description></item> <item><nom>_avecactualite</nom><description>Rubrique avec gestion des actualités</description></item> <item><nom>_calendrier</nom><description>Calendrier</description></item> <item><nom>_cartesites</nom><description>Avec une image cliquable dans le texte de la rubrique (dépt, ...)</description></item> _ /nom><description>Avec une image cliquable dans le texte (une liste <item><nom> cartesites2< déroulante)</description></item> <item><nom>_cartesites3</nom><description>Avec une image cliquable dans le texte (sans liste déroulante)</description></item> <item><nom>_espacededie</nom><description>Forme Espace dédié</description></item> <item><nom>_etablissements</nom><description>Pour présenter une liste d‘établissements ou autre</description></item> <item><nom> etablissements2</nom><description>Pour présenter une liste d‘établissements ou autre _ (variante)</description></item> <item><nom> forum</nom><description>Forums (avec un forum par article)</description></item> _ _ ique</nom><descripti orums hiérarchiques (en plus on peut répondre à une <item><nom> forumhierarch on>F réponse)</description></item > <item><nom> multirubricage</nom><description>Rubrique simulant un multirubricage</description></item> _ <item><nom>_multirubricagetrirubrique</nom><description>Rubrique simulant un multirubricage (tri par rubrique)</description></item> <item><nom>_redirection</nom><description>Redirection : affiche directement le dernier article (redirection)</description></item> <item><nom> sansarticle</nom><description>Les sous rubriques et les articles ne sont pas affichés</description></item> _ <item><nom> souspageaccueil</nom><description>Forme de sous page d'accueil (paramétrable)</description></item> _ <item><nom>_syndication</nom><description>Consacrée aux actualités d’autres sites par syndication</description></item> <item><nom> syndicationtexte</nom><description>Affiche le texte d'un article d'un autre site par _ syndication</description></item> <item><nom>_tableau</nom><description>Tableau : présente les articles dans un tableau</description></item> <item><nom>_textearticle</nom><description>Affiche directement le texte de ses articles</description></item> <item><nom>_textearticlepagination</nom><description>Affiche directement le texte de ses articles (avec pagination)</description></item> <item><nom>_textearticleunparpage</nom><description>Affiche directement le texte de ses articles (un par page)</description></item> MEEDDM - C. Imberti
9
