Image	Code à utiliser
	`images/objet-simple.png`
	`images/objet-liste-contenus.png`
	`images/objet-liste-contenus-dates.png`
	`images/composition-cours.png`
	`images/composition-tableau.png`
	`images/composition-test.png`

SPIP-Contrib

Réservations multiples

Rainer Müller — 2018-07-04T15:16:05Z

Permettre aux utilisateurs d'effectuer de réservations multiples (réserver pour plusieurs personnes à la fois ou réserver un événement plusieurs fois)

Dépendances

Introduction

Il y a deux manières de multiplier les réservations.

En réservant pour plusieurs personnes
En réservant un événement plusieurs fois

Configuration

Par défaut aucun mode de multiplication est activé. Il vous faut donc les activer via le panneau de configuration du plugin.

Si vous activez l'inscription de plusieurs personnes, vous pouvez limiter le nombre de personnes qui peuvent être ajoutées.

Formulaire public

Si la réservation pour plusieurs personnes est activée, l'icône

permet d'enregistrer les données de la/les personne/s supplémentaire/s. Les éventuels champs extras auteurs seront disponibles pour les personnes supplémentaires.

Il est possible d'ajouter autant de personnes que définit dans la configuration.

Si vous permettez de préciser le nombre de réservation, un champ additionnel “Quantité” apparaît lors de la sélection de l'événement.

Promotions

Ensemble avec le plugin promotions il est possible d'offrir des promotions en cas de réservations multiples.

#POPUP : une popup propre pour SPIP

PieroWbmstr — 2010-09-12T20:27:11Z

Gestionnaire de spip-popup

Il est clair que les fameuses fenêtres popup ne sont pas recommandables...
Mais on en a souvent besoin tout de même, pour renvoyer vers des conditions d'utilisation, une définition de mot etc, sans quitter la page courante.

Ce plugin propose la gestion d'une fenêtre popup unique, accessible et “bien gérée” pour SPIP.

Une page de démonstration est disponible : http://demo-spip3.ateliers-pierrot.....

Installation

Téléchargez l'archive 'zip' de cette page vers le dossier de plugins de votre SPIP
Installez le plugin depuis votre espace privé comme expliqué ici : https://www.spip.net/fr_article3396.html
Si vous avez CFG, accédez à la page du plugin via le bouton de l'onglet 'Configuration' de l'espace privé (réservé aux webmestres du site).

A noter qu'il existe une version du plugin sous forme de lame pour le Swiss Knife compatible SPIP 3. Voyez la note en fin d'article pour plus d'information.

Utilisation de la balise

En activant ce plugin, vous pourrez utiliser la balise #POPUP comme ceci :

texte du lien

avec les options suivantes :
- objet SPIP : le type et l'identifiant de l'objet SPIP à afficher dans la fenêtre, par exemple : 'article1' ou 'id_article=1',
ou URL distante : une URL complète vers un site distant,
- squelette : le squelette utilisé pour la popup (optionnel) ; le panneau de configuration du plugin permet de définir un squelette général (un squelette par défaut est proposé avec le plugin, cf. plus bas),
- width : la largeur de la fenêtre (en pixels - optionnel) ; le panneau de configuration du plugin permet de définir une largeur par défaut,
- height : la hauteur de la fenêtre (en pixels - optionnel) ; le panneau de configuration du plugin permet de définir une hauteur par défaut,
- titre : le titre (bulle d'aide au passage de la souris) ajouté au lien.

Depuis la révision SVN 45840 (version 1.1 du 24/03/2011), la balise accepte en premier argument une URL complète d'un site distant. Dans ce cas, et même si le second argument est précisé, le lien renvoyé ouvrira l'URL en question sans tenir compte d'un quelconque squelette puisqu'on part alors du principe qu'il ne s'agit pas d'un site SPIP. Cela autorise donc à ouvrir un site distant en fenêtre popup. Attention cependant : la popup générée par ce plugin est unique (deux liens successifs s'ouvriront dans la même fenêtre).

La balise renvoie le lien nécessaire pour ouvrir la popup, sous forme de fonction javascript comme argument “onclick” ajouté au lien (cf. plus bas), de sorte que le lien reste accessible pour les personnes n'ayant pas javascript sur leur navigateur (cf. Accessibilité).

Utilisation dans les articles

Vous pouvez également intégrer des liens popup dans les textes de vos articles (ou de tout objet SPIP) en utilisant les modèles 'popup' et 'popup_img' [1].

Pour les utiliser, écrivez dans vos textes :

OU

Ces appels seront automatiquement transformés en lien ouvrant une popup si les deux premiers arguments sont présents (à défaut, le modèle ne renverra rien).

Le modèle 'popup_img' génère un aperçu classique d'un document SPIP (de type image de préférence) ouvrant une popup au même titre qu'un lien [2].

MAJ du 15/05/2012 - La plugin ajoute maintenant un bouton à la barre d'édition de SPIP pour vous aider à créer des liens popup, sous le bouton de création des liens classiques [3].

Squelette par défaut

Un squelette SPIP est proposé avec le plugin présentant le contenu de tout objet éditorial passé en argument d'URL. Vous pouvez ainsi présenter le contenu d'un article, d'une brève, d'un auteur, d'un mot ou d'un site référencé.

Le squelette proposé est une adaptation des squelettes de la distribution simplifiée au maximum :
- reprise d'un en-tête de page simpliste présentant le logo et le nom du site ainsi qu'un lien 'fermer' (pour qu'il soit disponible de suite pour l'internaute),
- un pied de page réduit aux seuls liens utiles pour la popup ('imprimer', 'retour en haut' et 'fermer'),
- une zone de contenu sans colonne de navigation ni exta, présentant sur toute sa largeur le contenu de l'obet SPIP.

Certains styles CSS sont prédéfinis (notamment pour les liens d'en-tête et de pied de popup). Vous pouvez personnaliser ces styles en éditant le fichier “popup_spip_styles.html”.

NOTE
Une fonction est définie pour rediriger automatiquement les liens des objets SPIP vers la fenêtre principale et fermer la popup (cf. Documentation technique).

Configuration

Une page de configuration du plugin est disponible si vous utilisez le plugin CFG (mais ce n'est pas obligatoire [4]).

Le panneau de configuration du plugin propose quatre réglages généraux :
- le squelette utilisé par défaut pour la popup (le squelette “popup_defaut.html” initialement, mais vous pouvez bien évidemment indiquer un autre squelette, cf. plus bas),
- le nom javascript qui sera donné à la fenêtre (par défaut “popup”) qui peut vous permettre d'échanger des informations entre la fenêtre principale et la fenêtre popup dans vos scripts javascript,
- la largeur et la hauteur de la fenêtre, que vous pouvez modifier à chaque appel de la balise (3em et 4em arguments).

Squelette(s) personnalisé(s)

Vous pouvez bien entendu, c'est même conseillé, créer votre propre squelette de popup. Vous pouvez même créer un set de squelettes, en précisant à chaque appel de la balise le squelette choisi en 2^nd argument (cela peut permettre de créer un squelette par objet SPIP).

Quelques conseils

Pour rester dans une pratique web respectueuse de l'internaute, il est recommandé de conserver les liens d'en-tête et de pied définis dans le squelette par défaut : 'Fermer' et 'Retour en haut'. Le lien permettant de fermer la fenêtre est notamment vivement conseillé!

Documentation technique

Ce plugin nécessite que vos squelettes utilisent la balise #INSERT_HEAD [5]!

La balise retourne un code complet. Par exemple :

texte du lien

renverra :

texte du lien

Attention à ne pas cumuler de balises “onclick” ou “title” lorsque vous utilisez la balise!

Le plugin charge en en-tête de page le fichier de fonctions javascripts “javascript/spipopup.js”. Ces fonctions sont en charge de gérer l'ouverture de la nouvelle fenêtre, sa fermeture, les liens de retour vers la fenêtre principale etc [6]. En cas de conflit, nous vous renvoyons au code de ce fichier où chaque fonction est commentée (autant que possible). Chaque nouveau clic sur un lien popup s'ouvrira dans la même fenêtre externe (si elle est déjà ouverte).

Un filtre est défini dans le plugin pour rediriger automatiquement les liens des objets SPIP vers la fenêtre principale et fermer la popup : la fonction “popup_liens_retour()”. Ce filtre renvoie le lien vers la fenêtre principale et ferme la popup lorsqu'il s'agit d'une URL absolue, mais charge les liens vers les objets SPIP dans la popup (en utilisant le même squelette que la page courante).
Pour l'utiliser sur un texte d'article par exemple, notez dans votre boucle :

[(#TEXTE|popup_liens_retour| ... autres filtres)
]

Accessibilité

L'ouverture de la fenêtre externe se fait grâce à un attribut “onclick” sur les liens concernés, ce qui permet de conserver la nature de l'attribut “href” (qui n'est pas du javascript) afin de pouvoir visualiser ou copier l'URL de destination. Cet attribut “href” contient l'URL classique vers l'objet SPIP demandé, dans son squelette normal. Cela autorise donc l'utilisateur qui n'aurait pas javascript sur son navigateur à visualiser le contenu de destination. De plus, une information du type “Nouvelle fenêtre” est ajoutée à l'attribut “title” des liens, pour informer les internautes qu'il s'agit d'une fenêtre externe.

Merci à goetsu (cf. son commentaire) et marcimat (cf. son commentaire) pour leurs brillantes remarques sur la question (la première version du plugin n'intégrait pas ces fonctionnalités) !

Lame pour le Couteau Suisse

Une version de ce plugin est proposée sous forme de lame pour Swiss Knife. Ce plugin, compatible avec SPIP 3 (encore en développement à ce jour), permet donc d'utiliser la fonctionnalité proposée par #POPUP au sein de SPIP3.

La lame est disponible en téléchargement à l'adresse suivante : http://files.spip.org/spip-zone/pop....

Évolutions à venir (ou à faire ...)

~~trouver un moyen de permettre des liens popup dans les textes d'article (raccourci typo à créer),~~
travailler le squelette proposé (~~notamment fil d'ariane avec retour en fenêtre initiale~~),
permettre de régler la fermeture de la fenêtre dans la fonction 'popup_liens_retour()'
gérer des identifiants de fenêtres pour en autoriser plusieurs

[1] Attention à ne pas abuser de l'utilisation des fenêtres popup. Ces fenêtres sont très déconseillées par le W3C et il y a lieu de les utiliser dans le respect des habitudes des internautes.

[2] Merci à Natacha de Courcelles Design pour ce modèle.

[3] Depuis la version 1.31.1 de la version pour SPIP2 et 1.4.1 de la version pour SPIP3.

[4] Si vous n'utilisez pas le plugin CFG et que vous souhaitez tout de même modifier les valeurs par défaut, éditez le fichier 'spipopup_options.php' à la racine du plugin et modifiez les valeurs définies en tête de fichier.

[5] C'est le cas de la distribution standard de SPIP.

[6] Une fonction renvoyant les dimensions et la position exacte de la nouvelle fenêtre peut être intéressante pour d'autres outils : “_window_size()”.

'Menus' - a menu builder/manager plugin for SPIP

Loiseau2nuit, RastaPopoulos — 2009-08-18T10:47:00Z

For whoever is not using the 'Menus' plugin, webmasters has to manage all website's menus, having them hand-coded in the templates, leaving website admins & writers unable to edit them, and forced to multiple support requests, each time they need a menu entry created/modified somewhere.
Besides, when you need to add static links (to any specific or external web page), aside from any SPIP request, you have to code their full html into the menu template file.

This 'Menus' plugin aims to let you easily create and manage website's menus, in a fancy user-friendly interface, directly within the admin area.

Are you new to SPIP ?
SPIP is a modern, collaborative and multilingual PHP publishing system and web development framework.
See : spip.net

Attention ! This plugin does NOT actually process any design or styling. It just lets you easily build menus and generates their HTML display.

For everything related to menu styles, check your templates out or see some dedicated (and compliant) plugins, such as

Animated dropdown menu
Menu Déroulant 2 (a simple dropdown menu)
Menu Accordéon 2 (an accordion jquery menu)
jQuery Superfish menu (animated dropdown menu)

How to install 'Menus' plugin

Download the ZIP package and upload its content into your plugins/ directory. Then you'll have to enable it in the admin area: Configuration > Manage plugins.
Read more on how to install a plugin for SPIP

You should also have the Bonux for SPIP 3.* plugin installed & enabled.

The plugin adds a new entry in the SPIP admin menu: Templates > Website's menus

The admin page lists all your menus and lets you create new ones:

First you will have to identify your menu.
Let's give your menu a title and a mandatory text identifier, which will let you easily call for it wherever you need it (because while coding your templates, it's hard to know in advance what will a menu's numeric ID actually be).
Thanks to this identifier, you won't have to edit your templates multiple times. Besides, you also can provide a CSS class to the first generated UL element. This, letting you style that element, according to any other 'menu display'-related plugins (e.g. specific class to generate specific jQuery effect) ...

You can then start building the menu with your own entries:

Entry types

'Menus' comes with more than 10 entry types, already offering to build most of common menu types.
Feel free to suggest your own !

Here is a brief description of some available entry types :

Simple hypertext link

This entry creates a link to any chosen URL, with a link text.

SPIP objects

Creates links to any SPIP object (article, section, keyword, ...) or any plugin-induced new object (ex. organisation, contact, ...)

Dynamic sections/articles tree

Displays a tree-menu of any chosen 'root' section by simply providing it's ID, and a maximum display level for sub-sections, excluded elements' ID if any, sort options, ... You can also choose to include articles in the display.

How to edit an entry ?

If you already added a menu, you'll see its entries as following:

You can then:

re-order those entries,
delete any of them,
change their settings as wished,
add sub-level menus to entries allowing them,
...

How to use menus in your website ?

To show a menu on your website, simply add this code in the template of your choice:

#INCLURE{fond=inclure/menu, env, identifiant=}

You can also easily test your menu, clicking on “see online” button or, accessing https:///spip.php?menu

How to export menus to another SPIP website ?

Let's say you're you are re-organizing all menus on a local working copy of your website. If you wan to report those modifications online, you can export your local menus as a YAML file, that you'll be able to re-import from your production website [1]

This feature needs YAML V2 plugin for SPIP 3.* installed & enabled:
As soon as it is, a new “export this menu” icon appears.

Save it on your computer

On the destination website, create a new empty menu with the same text identifier (or, if it already exists : delete & replace it). If YAML plugin is enabled, a dialog box offering to choose files should be displayed.

Overwriting `menus/.html` file types

If, for any reason you need to overwrite a menus/*.html file or even the entire directory, be sure to also copy the XML description files that comes with. The plugin actually needs those files to be in the same directory as the working HTML files.

[1] The 2 SPIP websites should ideally run the same version to avoid any error

Définitions et FAQ, version 3

Eric Lupinacci — 2015-05-01T11:20:32Z

Écrire rapidement des listes de question-réponse sous forme de FAQ, sans se prendre la tête.

Ce plugin est une extension de Textwheel ; il ajoute de nouveaux raccourcis typographiques permettant de générer rapidement une FAQ proprement présentée et basée sur les listes de définitions (dl, dt, dd).

Installation et compatibilité ascendante

Cette nouvelle branche v3 fonctionne directement en SPIP 3 (Textwheel étant distribué par défaut).

Cette branche apporte de nouvelles fonctions au plugin, mais assure une compatibilité ascendante parfaite avec la fonction d'article-FAQ de la branche v2 précédente documentée dans l'article Définitions et FAQ. De même, la fonction de rubrique-FAQ est toujours supportée.

Utilisation de base

Le contenu d'une FAQ est inséré entre des marqueurs qui se dégradent lorsque le plugin n'est plus actif : les balises deviennent juste invisibles et il ne reste que la liste à l'intérieur.

Une question commence par une nouvelle ligne, le premier caractère de la ligne devant être un point d'interrogation «?». Tout le texte inscrit depuis la ligne suivante jusqu'à la prochaine question ou la fin de la FAQ est considéré comme la réponse.

 ? Libellé de la première question ? Texte de la réponse. Ce texte peut contenir tout type de raccourcis et de structures (tableau, listes, paragraphes...). Le texte se termine à ligne précédent la question suivante. ? Libellé de la dernière question ? Le texte de la réponse se termine cette fois à la ligne précédente, la balise de fin de FAQ.

Utilisation avancée

Cette nouvelle branche v3 apporte aussi des fonctionnalités avancées :

catégorisation des questions ;
insertion d'un titre regroupant une séquence de questions ;

Toutes ces informations complémentaires s'écrivent à la suite du titre de la question, séparée par un espace.

Catégories

Toute information écrite #tag est considérée comme une catégorie à partir du moment où «tag» est une chaine alphanumérique.

Pour chaque question, la liste des étiquettes est collectée et affichée précédée d'un petit caractère habituel pour les tags. Si un tag correspond au titre d'un mot-clé SPIP, alors il est affiché comme un lien vers la page mot-clé associée.

Titres

Un titre est détecté par le caractère «:» en début de ligne. Tout le reste de la ligne constitue le libellé. Il est possible d'insérer plusieurs titres dans une même FAQ et donner ainsi l'impression d'une série de FAQ thématiques.

Intégration au Porte-plume

Cette nouvelle branche v3 permet aussi d'utiliser la barre d'édition du Porte-plume pour ajouter une FAQ, une question ou un titre. Un bloc spécial d'édition est dédié aux FAQ et propose un bouton par fonction.

Configuration

Le plugin possède aussi un formulaire de configuration qui permet d'ajuster le comportement des FAQ comme le fait d'attacher des ancres aux questions, d'utiliser ou pas les CSS fournis par le plugin ou la fonction de pliage-dépliage des questions.

Exemple

Édition directe 3

Rainer Müller — 2011-10-16T13:25:50Z

Ce plugin permet d'éditer directement l'article depuis la page de l'objet dans l'espace privé.

Principe

Quand on désire éditer un objet spip, on arrive d'abord sur sa page d'accueil où est affiché une prévisualisation de son contenu, puis il faut appuyer sur le bouton éditer afin d'arriver à l'écran d'édition de l'objet.

Ce plugin permet d'éditer l'objet directement depuis sa page d'accueil, toutes les manipulations des objets SPIP éditables (modifications, ajouter des mots clés, auteurs, etc.) peuvent désormais se faire depuis une seule page.

Il existe aussi une version de ce plugin pour SPIP 2.

Le plugin détecte automatiquement tous les objets éditables, déclarés via la pipeline lister_tables_objets_sql.

Installation

Le plugin s'installe comme n'importe quel plugin.

Il nécessite d'installer et activer également le plugin Saisies.

Configuration

Par défaut, tous les objets déclarés sont affichés en édition directe.
Dans le panneau de configuration (“Configuration”/“Edition directe”), il est possible de choisir les objets à afficher en édition directe.

Nouveau !
Cette configuration de base peut être adapté par l'utilisateur pour chaque objet disponible

Pour Développeur

Une pipeline permet d'influencer sur l'activation de l'édition directe. Ce qui permet par exemple de la restreindre à une rubrique ou d'ajouter d'avantage de critères.

$pipeline= pipeline('edition_directe_controle',array( 'args'=>array( 'objet'=>$objet ), 'data'=>$config ));

$config étant un array des objets choisis pour l'édition directe via cfg

Attention le tableau pour $config doit se composer de la manière suivante: array(0=>'nom_objet')

Des jeux dans vos articles !

Maïeul, Patrice Vanneufville — 2006-12-08T23:38:54Z

Le plugin “Jeux” permet d'insérer dans vos articles des jeux ou des exercices de toute sorte.

Sommaire

* ">Généralités sur le plugin “Jeux” *

- Auteurs :
Patrice VANNEUFVILLE
Maïeul ROUQUETTE (gestion des scores)

- Point de départ :
Le 2 décembre 2006

- Compatibilité :
Toutes version de SPIP v3.0.x ou v2.x.x
Pour Spip 1.9, voir ici

- Téléchargements disponibles sur la Spip-Zone :
• «Jeux pour SPIP v3.0 mini
• «Jeux pour SPIP v2.0 mini»
• «Jeux pour SPIP v1.92 maxi».

Mise en place du plugin :
https://www.spip.net/article6841.html

- Langues :
Pour l'instant, français et un peu d'anglais ou d'italien. Vos traductions sont les bienvenues !
La version pour SPIP v3 est multilingue. Pour les traductions c'est ici : http://www.spip.net/rubrique4.html.

Description : Ce plugin permet de générer de multiples jeux ou exercices à l'intérieur d'un article SPIP (qcm, mots croisés, pendu, devinettes, ...). Il parse le code des jeux tapé dans SPIP, stocke les divers éléments caractéristiques et retourne le code HTML mis en forme.

Dépendances :

Les styles CSS et les fonctions JavaScript du plugin sont insérés grâce à la balise #INSERT_HEAD qui doit absolument être présente (en un seul exemplaire) dans le header de vos squelettes (entre les balises et des fichiers HTML). Si vous ne trouvez pas cette balise dans vos codes et que les jeux n'ont pas l'apparence voulue, le plugin “Le Couteau Suisse” permet d'insérer automatiquement cette balise sans manipulation de votre part grâce à l'outil “Balise #INSERT_HEAD”.

Surcharges :

Vous pouvez modifier l'apparence des jeux prévue par défaut en surchargeant le fichier jeux.CSS.html directement dans votre squelette. Commencez par recopier ce fichier à la racine de votre squelette, puis modifiez les différents styles en fonction de vos préférences.

De même, pour un jeu donné, vous pouvez reproduire cette surcharge avec les fichiers CSS présents dans le dossier mesplugins/jeux/styles/ à recopier/modifier dans le dossier messquelettes/styles/. A l'heure actuelle, quatre jeux possèdent un fichier de styles propre : qcm, pendu, mots croisés et sudoku.

Ce mécanisme de surcharge évite de toucher aux fichiers originaux que vous pourrez mettre à jour sans soucis à l'avenir.

L'affichage du score d'un jeu est surchargeable grâce à l'utilisation d'un fonds. Le fichier à recopier/modifier est : fonds/jeu_score.html.

L'affichage d'un bouton 'Corriger' ou 'Recommencer' est également surchargeable (dès la version 2.2.0 du plugin). Les boutons sont ici calculés sur la base d'un fond HTML :
fonds/bouton_{$item}.html. Les fonds livrés nativement dans le plugin sont actuellement :
- Pour la correction : bouton_corriger.html
- Pour la réinitialisation du jeu : bouton_recommencer.html, bouton_reinitialiser.html, bouton_rejouer.html

Syntaxe dans l'article :

Dans le texte de l'article, le code des jeux doit se trouver entre les balises “” et “”. Ce code est lui-même composé de séparateurs (par ex. : [titre]) placés entre les paragraphes de code.
Evitez de mélanger les séparateurs spécifiques appartenant à des jeux différents dans le code d'un jeu unique.
Les paragraphes de code peuvent parfois contenir des raccourcis typographiques.

Un exemple simple :

 [titre] La devinette du jour [devinette] Comment appelle-t-on un patron de la nouvelle économie ? [reponse] Un e-responsable

Séparateurs spéciaux :

- [titre] : utile pour la plupart des jeux
- [texte] : permet d'insérer un contenu placé tel quel dans le résultat du jeu, par exemple une image ou une séparation mieux marquée entre deux blagues ou deux questions d'un qcm...
- [copyright] : permet d'insérer une mention de Copyright, configurable par CSS.
- [config] : certains jeux peuvent avoir besoin de paramètres de configuration (affichage, difficulté, indices, etc...). Ce séparateur est suivi de lignes sous la forme : parametre = valeur ou Paramètre = valeur (car le plugin est insensible aux accents et aux majuscules).
- [score] : affichage des commentaires de scores. Reportez-vous au paragraphe dédié [ci-dessous.

Attention : afin d'éviter les mauvaises surprises de présentation (sommaires, rubriques, backends, ...) ou les solutions de vos jeux qui apparaissent dans les résumés d'articles, pensez bien :
- soit à placer une introduction dans votre article entre les balises et
- soit à remplir le descriptif de l'article.
- soit activer dans le plugin Le Couteau Suisse la lame “Balise #INTRODUCTION”.

Petite note aux usagers de FCKEditor ; ne pas oublier d'ajouter la ligne suivante dans fckconfig.js :

FCKConfig.ProtectedSource.Add(//gi);

Liens utiles : Grâce à Olivier Gautier, visitez http://spip.ac-rouen.fr/?article37 afin d'avoir un tutoriel sur : installer le plugin jeux, créer un pendu, créer un QCM ou QRM, créer un texte à trous.

Modules actuels :

- Insérer un QCM (ou un quiz...)
- Insérer une grille de mots-croisés
- Insérer une grille de sudoku
- Insérer un exercice à trous
- Insérer un jeu de points à relier
- Insérer une poésie
- Insérer une citation ou une blague
- Insérer une devinette ou une charade
- Insérer un diagramme de positions d'échecs
- Insérer un jeu de pendu
- Insérer un jeu multiple (grappe de jeux)
- #
- Forum

Formulaires Ajax :

Si votre version du plugin est supérieure à la 1.1 et que celle de votre SPIP est supérieure à la 2.0, alors les jeux peuvent fonctionner en Ajax. C'est à dire qu'il n'y a plus besoin de recharger toute la page lorsqu'on veut voir la correction.

Pour appeler (sous SPIP >=2.1 et plugin Jeux mis à jour) un jeu en utilisant l'API CVT de SPIP, il faut d'abord créer le jeu en partie privée, puis utilier dans vos articles le raccourci suivant : (XX est l'id du jeu).

Collaboration avec d'autres plugins :

- Le plugin CFG (optionnel) pour la configuration des résultats
- Le plugin Le Couteau Suisse (optionnel) pour la balise #INTRODUCTION et la gestion des jeux supprimés.
- Le plugin Corbeille (optionnel) pour la gestion des jeux supprimés.
- Le plugin Crayon (optionnel) pour éditer des jeux enregistrés en base. Le plugin vous offre une page de test : jeu.html. Si votre jeu a pour id XX, alors vous pourrez le crayonner et le tester directement en tapant l'adresse suivante : www.monsite.toto/?page=jeu&id_jeu=XX.

Remerciements :

- Mathieu GIANNECCHINI : à l'origine des QCM (questions à choix multiples)
- Maïeul ROUQUETTE : à l'origine des mots-croisés
- François SCHREUER : à l'origine des diagrammes d'échecs
- Peut-être vous ? N'hésitez pas à proposer vos projets.

Il reste encore à faire :

- Ajouter de nouveaux jeux
- Ajouter de nouvelles traductions (sous SPIP>=3.0, utilisez l'interface de traduction suivante : http://www.spip.net/fr_rubrique4.html).

Commentaires de scores :

Afin d'afficher un commentaire en fonction du score obtenu, utilisez le séparateur optionnel [score]. Vous devez ici définir des catégories de résultats, soit en nombres de points, soit en pourcentages, selon la syntaxe suivante : “XX%:”, “XXpt:” ou “XXpts:” (où XX est un nombre au début d'un paragraphe). En gros, une ligne commençant par “XXpts:” signifie : voici le commentaire affiché si vous atteignez les XX points. Un peu comme un seuil de déclenchement.

Voici un premier exemple sur un jeu de 6 points, avec 5 catégories de résultats (0 point, 1 ou 2 points, 3 ou 4 points, 5 points et 6 points) :

[score] 0pt: Vous devez vraiment réviser. Recommencez ! 1pt: Vous n'avez pas la moyenne. Recommencez ! 3pts: Votre score peut encore être amélioré. Recommencez ! 5pts: Presqu'un sans faute. Félicitations ! 6pts: Vous êtes vraiment un as. Félicitations !

Voici comment sont choisis les commentaires ci-dessus en fonction du score :

Score obtenu :	0 pt	1 ou 2 pts	3 ou 4 pts	5 pts	6 pts
Commentaire :	"0pt:“	”1pt:“	”3pts:“	”5pts:“	”6pts:"

Voici un second exemple en pourcentage avec 4 catégories :

[score] 0%: Il est urgent de réviser. Recommencez ! 30%: Vous n'avez pas la moyenne... Recommencez ! 50%: Ce n'est pas encore parfait... Recommencez ! 100%: Vous êtes vraiment un as. Félicitations !

Voici comment sont choisis les commentaires ci-dessus en fonction du score :

Score obtenu :	0% à 29.99%	30% à 49.99%	50% à 99.99%	100%
Commentaire :	"0%:“	”30%:“	”50%:“	”100%:"

Enregistrements des scores / jeux en base de donnée :

Le plugin permet aussi d'enregistrer en base les scores des joueurs. Voir ici pour plus d'informations.

* Insérer un QCM (ou un quiz...) *

- module : qcm.php
- séparateurs obligatoires : [qcm] (ou [quiz]), [qrm]
- séparateurs optionnels : [titre], [texte], [copyright], [score]
- plusieurs [qcm] ou [qrm] entre entre et : oui
- paramètres de configuration par défaut :

trou=auto // taille du trou affiche en cas de proposition unique Une_par_une = non // affiche les questions une par une Corrections = oui // corrige chaque réponse (juste ou fausse) et affiche les précisions éventuelles Solution = non // donne la(les) bonne(s) réponse(s) lors de la correction Points = oui // affiche éventuellement les points dans les questions Max_radios = 5 // nombre maximal de boutons radios affiches avant le choix d'une liste deroulante Colonnes = 1 // nombre de boutons (type radio ou a cocher) par ligne Bouton_corriger = corriger // fond utilise pour le bouton 'Corriger' Bouton_refaire = reinitialiser // fond utilise pour le bouton 'Reset'

- [qcm] est l'abréviation de “questions à choix multiple, mais réponse unique”. Moins de 5 propositions de réponse sont présentées sous forme de bouton radio et sous forme d'une liste au-delà. L'utilisateur ne peut donc choisir qu'une seule réponse à chaque question, même si plusieurs propositions peuvent être justes.
- [qrm] est l'abréviation de “questions à réponses multiples”. Les propositions sont présentées sous forme de cases à cocher. L'utilisateur peut donc choisir de cocher plusieurs réponses pour une même question. Par défaut, les réponses justes rapportent 1 point et les réponses fausses -1 point. Le score final ajoute les points de chaque proposition.
- [quiz] est un équivalent à [qcm].

Dans le paragraphe précédé par [qcm] ou [qrm], la syntaxe est la suivante :

Q Intitulé de la question P1 Texte de la proposition 1 P2 Texte de la proposition 2 ... Pi Texte de la proposition i Rj (indique que la bonne réponse est la proposition j)

Donc, si la bonne réponse est la proposition 2 on indiquera “R2”.

Attention, les majuscules sont requises pour : “Q, Pi et Ri”.

Il est possible de préciser les points attribués à chaque réponse :

P1.-2 Texte de la proposition 1 à -2 points P2.4 Texte de la proposition 2 à 4 points R2

Veuillez à ce que la bonne réponse attribue toujours le nombre maximal de points.

S'il faut expliquer le choix (bon ou mauvais) de l'utilisateur lors de la correction, on peut ajouter des commentaires :

P1 Proposition 1|Et un commentaire 1 ! P2 Proposition 2|Et un commentaire 2 !

Si plusieurs bonnes réponses sont possibles, il suffit de séparer les Ri par un espace :

R1 R3 R4

En fonction du nombre de questions posées, il faut prévoir plusieurs paragraphes précédés des séparateurs “[qcm]” ou “[qrm]”.

Un exemple :

 [titre] Un titre pour le QCM ! [qcm] Q Une question bla bla P1 Une proposition 1 P2 Une proposition 2 P3 Une proposition 3 (la bonne réponse) R3 (la réponse 3 est la bonne !) [qcm] Q Une question encore P1.2 Une proposition à 2 points (la bonne réponse) P2 Une proposition 2|Lisez bien la question... R1 [qrm] Q Une question pour finir P1 Une proposition 1|En effet 1 ! P2 Une proposition 2|En effet 2 ! P3 Une proposition 3|Lisez bien la question... R1 R2

Cas particulier : si l'utilisateur doit lui-même taper la réponse, il suffit d'une question “Q” et d'une proposition “P”. Exemple :

 [qcm] Q Citez une planète du système solaire : P Mercure Vénus Terre la+Terre Mars Jupiter Saturne Uranus Neptune

La liste des mots valides à placer après “P” peut accepter les séparateurs usuels : retours à la ligne, tabulations, espaces, virgules, points-virgules ou points.
Pour en savoir davantage sur la syntaxe des listes de mots, lisez le paragraphe “Insérer un exercice à trous” ci-dessous.
Ici, la gestion des points et des précisions est toujours possible :

P.4 Mercure Vénus Terre la+Terre Mars Jupiter Saturne Uranus Neptune|Saviez-vous que Pluton n'est plus une planète ?

Un QCM en démo : http://www.ensemble-claudio-monteve...

* Insérer un exercice à trous *

- module : trous.php
- séparateurs obligatoires : [texte] & [trou]
- séparateurs optionnels : [titre], [copyright], [config], [score]
- plusieurs [trou] entre et : oui
- paramètres de configuration par défaut :

taille=auto	// taille des trous indices=oui	// afficher les indices ? Couleurs = oui // appliquer des couleurs sur les corrections ? Solution = non // donne la(les) bonne(s) réponse(s) lors de la correction Bouton_corriger = corriger // fond utilise pour le bouton 'Corriger' Bouton_refaire = recommencer // fond utilise pour le bouton 'Reset'

Un exemple :

 [texte] Ceci est un exemple de closure (exercice à trous). L'utilisateur doit entrer ses [trou]réponses[texte] dans les espaces vides. Pour chaque mot manquant, plusieurs réponses correctes peuvent être acceptées. Par exemple, ce [trou] trou, vide, blanc [texte] autorise les réponses "trou", "vide" ou "blanc". [config] Indices = oui Solution = oui

Avec la correction et les couleurs :

Liste des mots :

La liste des mots à placer après [trou] peut accepter les séparateurs usuels : retours à la ligne, tabulations, espaces, virgules, points-virgules ou points.

- Pour une expression comprenant des espaces, utiliser les guillemets ou le signe +
Par exemple : "afin de" est équivalent à : afin+de
Les minuscules ou majuscules peuvent être utilisées indifféremment pour les réponses ou les propositions.
- Pour une expression sensible à la casse, ajouter “/M” en fin d'expression :
Par exemple : "la France/M" (ou : la+France/M)
- Pour une expression régulière (RegExp), utiliser les guillemets et les virgules comme séparateur :
Par exemple : ",stylo(graphe)?,"
- A propos de la casse, voici quelques expressions équivalentes :
"la France/M", la+France/M, ",la France,"
ou, sans casse : "la France", la+France, la+france, ",la france,i"
- Pour un affichage lisible des indices, veillez à ce que la première expression ne soit pas une expression régulière...

Autre exemple :

 {{Tape les mots ou les expressions suivantes:}} - élève : [trou]élève[texte] - Noël : [trou]Noël/M[texte] - Elle arrive à l'école. : [trou]Elle+arrive+à+l'école./M[texte] - Où es-tu ? : [trou]Où+es+tu+?/M[texte] - Je suis là ! : [trou]Je+suis+là+!/M[texte] - (3x10)-4+2=28 : [trou]"(3x10)-4+2=28"[texte] - http://ecole-ybarau : [trou]"http://ecole-ybarau"[texte] - mon.adresse@barau.fr : [trou]"mon.adresse@barau.fr" [config] Indices = non Solution = oui

* Insérer un jeu de Points à relier *

- modules : relier.php, relier.js et relier.css
- séparateur obligatoire : [gauche]
- séparateurs optionnels : [droite] [solution] [config] [texte] [titre] [copyright]
- paramètres de configuration par défaut :

Couleur lignes = rouge // couleur lors du jeu Couleur erreurs = noir // couleur lors de la correction Espace vertical = 40 // espace vertical entre les points (en pixels) Espace horizontal = 140 // espace horizontal entre les points (en pixels) Marge horizontale = 30 // marge droite et gauche (en pixels) Transparence = non // couleur de transparence des images Recadre auto = non // recadrage automatique des images Compteur = non // Affichage d'un compteur de secondes Aléatoire = non // mélange des colonnes de droite et de gauche Tout relier = oui // faut-il relier tous les points pour la bonne réponse ?

Exemple visuel :

Dont voici le code :

 [config] Aléatoire = oui Compteur = oui [titre] Traductions Français/Allemand [gauche] la voiture l'ordinateur l'horloge l'école le vélo les devoirs les amis la mer les vacances la casquette [droite] die Uhr das Fahrrad das Meer der Computer die Schule die Hausaufgaben die Ferien die Freunde die Mütze das Auto [solution] 10, 4, 1, 5, 2, 6, 8, 3, 7, 9

Comme vous pouvez le constater, la syntaxe est très simple :

Le séparateur [gauche] précède la liste des éléments de la colonne de gauche (un élément par ligne)
Le séparateur [droite] précède la liste des éléments de la colonne de gauche (un élément par ligne)
Le séparateur [solution] précède la solution (liste de nombres séparés par des virgules).

Veillez noter que le retour à la ligne manuel SPIP (“_” en début de ligne) est possible à l'intérieur d'un libellé d'élément. Par exemple la liste suivante contient 3 éléments à placer dans la colonne de droite :

[droite] {{C'est un point d'orgue}} {{Il augmente la durée de la _ note placée sous ce signe}} {{On joue plus fort la note _ placée sous ce signe}}

La solution a trois syntaxes possibles :

Syntaxe exhaustive :
[solution] 1=3, 4=2, 3=2, 2=5, 5=4
Il faut lire cette ligne comme ceci : le 1er élément de gauche doit être relié au 3e élément de droite, le 4e élément de gauche doit être relié au 2e élément de droite, etc.
Syntaxe simplifiée :
[solution] 1=5=2=3, 2=4=6
équivalente à :
[solution] 1=5, 1=2, 1=3, 2=4, 2=6
Syntaxe très simplifiée :
[solution] 5, 2, 3, 4, 1
équivalente à :
[solution] 1=5, 2=2, 3=3, 4=4, 5=1

Si la solution n'est pas spécifiée (séparateur [solution] absent), alors le plugin considère que le 1er élément de la colonne de gauche doit être relié au 1er élément de la colonne de droite, et idem pour tous les autres éléments. Exemple par défaut d'un jeu qui aurait 5 éléments dans chaque colonne, et dont la solution ne serait pas spécifiée :
[solution] 1, 2, 3, 4, 5

L'option “tout relier” :

Cette option permet d'autoriser des points non reliés, comme dans l'exemple suivant, où le joueur doit trouver exactement les 3 bonnes réponses :

Dont le code source est :

 [titre] Jeu 1 : Théorie: reconnaissance de symboles [texte]  Sauras-tu retrouver la (ou les) définition(s), ainsi que le nom de ce symbole ? {{Relie les points !}} [gauche]  [droite] {{C'est un point d'orgue}} {{C'est un point d'orme}} {{C'est un point d'arc}} {{Suspendre la pulsation}} {{Augmenter la durée de la _ note placée sous ce signe}} {{Jouer plus fort la note _ placée sous ce signe}} {{Jouer moins fort la note _ placée sous ce signe}} [solution] 1=1=4=5 [config] Espace vertical = 54 Espace horizontal = 100 Compteur = non Aléatoire = oui Transparence = blanc Recadre auto = 80% Tout relier = non

Un cas particulier : une seule image !

Le plugin peut créer un jeu de points à relier sur la base d'une seule image fixe préparée à l'avance. Seuls les points sont placés automatiquement à l'affichage du jeu.

Dans ce cas, le séparateur [droite] n'est pas utilisé, et le séparateur [gauche] est utilisé de cette façon :

Syntaxe générale : imageNNNN (nbPtsG, nbPtsD) (offsetX%, offsetY%) (margeG%, margeD%) Exemple : [gauche] image1341 (7, 7) (10%, 15%) (7.5%, 7.5%) ou : [gauche] image1341 7, 7, 10%, 15%, 7%, 7% ou : [gauche] image1341 7 7 10% 15% 7% 7%

Significations :
- NNNN : identifiant du document SPIP utilisé (une image dans ce cas !)
- nbPtsG : nombre de points à relier qu'il faut créer à gauche
- nbPtsD : nombre de points à relier qu'il faut créer à droite
- offsetX% : pourcentage de distance horizontale entre les deux colonnes de points
- offsetY% : pourcentage de distance verticale entre les points
- margeG% : pourcentage de distance entre le bord gauche et la colonne de points de gauche
- margeD% : pourcentage de distance entre le bord haut et le premier point du haut

À noter :
- Les 6 nombres figurant après l'identifiant de l'image sont obligatoires et ne peuvent être mélangés.
- Le pourcentage (“%”) est obligatoire pour les 4 derniers nombres
- Les caractères non numériques qui séparent les 6 nombres obligatoires sont au choix.
- L'image étant figée, l'option “Aléatoire” ne doit surtout pas être utilisée.

Voici un exemple de code :

 [titre] Jeu 2 : Pierre et le loup – Sergueï Prokofiev [texte] {{Relie le personnage à l'instrument qui le représente dans l'œuvre !}} [gauche] image2089 7 7 41% 13.9% 27% 9.5% [solution] 6, 4, 5, 7, 1, 2, 3 [config] Transparence = blanc

Et voici l'image d'origine (à gauche) qui sert de support au jeu (à droite) :

* Insérer une poésie *

- module : textes.php
- séparateurs obligatoires : [poesie]
- séparateurs optionnels : [titre], [auteur], [recueil]
- plusieurs [poesie] entre et : non
- paramètres de configuration par défaut : aucun

Un exemple :

 [titre] Messieurs les petits oiseaux [poesie] Messieurs les petits oiseaux, On vide ici les assiettes ; (...) Venez donc manger et boire, Messieurs les petits oiseaux. [auteur] Victor HUGO [recueil] L'art d'être grand père, 1877

* Insérer une citation ou une blague *

- module : textes.php
- séparateurs obligatoires : [citation] ou [blague]
- séparateurs optionnels : [titre], [auteur] ou [recueil]
- plusieurs [citation] ou [blague] entre et : oui
- paramètres de configuration par défaut : aucun

Un exemple :

 [citation] L'amour est aveugle, il faut donc toucher. [auteur] Proverbe brésilien

* Insérer une devinette ou une charade *

- module : devinettes.php
- séparateurs obligatoires : [devinette] ou [charade]
- séparateurs optionnels : [reponse], [titre], [texte], [config]
- plusieurs [devinette] ou [charade] entre et : oui
- paramètres de configuration par défaut :

reponse = oui	// afficher la réponse ? envers = oui // retourner la réponse ? taille = 10	// taille de la police utilisée

Deux exemples :

 [devinette] Comment appelle t-on un patron de la nouvelle économie ? [reponse] Un e-responsable [devinette] Quel est le point commun entre un contrôleur des impôts et un spermatozoïde ? [reponse] Tous les 2 ont 1 chance sur 3 millions de devenir un jour un être humain. [config] Réponse = oui   [titre] Pour les enfants... [charade] {{Mon premier}} se dirige quelque part. {{Mon deuxième}} est la moitié d'un cheveux. {{Mon tout}} vit à la ferme. [reponse] La vache

Une devinette

Une devinette

Note : la Librairie GD (graphique dynamique) est obligatoire sur votre serveur pour obtenir des réponses affichées à l'envers. Une image renversée est en effet créée, à condition que la ligne 'reponse = oui' a été placée après le séparateur [config]

* Insérer une simple saisie d'informations *

Ce jeu, surtout utile en mode multi-jeu, permet de collecter des informations qui ne nécessitent pas de correction, comme un pseudo par exemple, ou un message personnalisé.

- module : saisies.php
- séparateurs obligatoires : [texte] & [saisie]
- séparateurs optionnels : [titre], [copyright], [config]
- plusieurs [saisie] entre et : oui
- paramètres de configuration par défaut :

bouton_corriger=valider // fond utilisé pour le bouton 'Corriger' bouton_refaire=reinitialiser // fond utilisé pour le bouton 'Reset'

Un exemple :

 [label] prenom Quel est ton prenom ? [saisie] prenom text size=48 [texte] Je suis : [saisie] genre checkbox M = Un garcon F = Une fille [label] preference Tu préfères : [saisie] preference select bonbons = Les bonbons gateaux = Les gâteaux [texte] Ton message : [saisie] message textarea cols=40 rows=10 value = Ligne 1 Ligne 2

Syntaxe à utiliser après [label] (tous les paramètres sont optionnels) :
(nom) (votre texte)
- nom par défaut : saisie

Syntaxe à utiliser après [saisie] (tous les paramètres sont optionnels) :

	(nom) (type) (autres paramètres de la balise) (valeur 1 = libelle 1, cas d'un type 'select', 'radio' ou 'checkbox') (valeur 2 = libelle 2, cas d'un type 'select', 'radio' ou 'checkbox') ... (value = Votre texte par défaut, pour certains types de saisies)

- nom par défaut : saisie
- type par défaut : text

Le nom :
un mot sans espace compose de lettres/chiffres/:._-

Les types reconnus sont les types HTML :
button, checkbox, color, date, datetime, datetime-local, email, file, hidden, image, month, number, password, radio, range, search, select, tel, text, textarea, time, url, week
- types non reconnus : submit, reset
- type par défaut : text

Les autres paramètres :
permet de compléter la balise HTML ( </code> le cas échéant)<br class='autobr' /> exemple 1 : <code class='spip_code spip_code_inline' dir='ltr'>cols=40 rows=10</code><br class='autobr' /> exemple 2 : <code class='spip_code spip_code_inline' dir='ltr'>size=48</code></p> <hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='id91d1_c0'> *** <a id="diagech"></a>Insérer un diagramme de positions d'échecs *** </th></tr></thead> <tbody> </tbody> </table><div class='spip_document_10188 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Les caractéristiques de ce jeu ont été placées ici : <a href='https://contrib.spip.net/Inserer-un-diagramme-de-positions-d-echecs' class="spip_in" hreflang="fr">Insérer un diagramme de positions d'échecs</a>.</p> <p>Échiquier interactif en JAVA : <a href='https://contrib.spip.net/Afficher-des-parties-d-echecs-avec-ChessViewerDeluxe' class="spip_in" hreflang="fr">Afficher des parties d'échecs avec ChessViewerDeluxe</a>.</p> <hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='idd320_c0'> *** <a id="pendu"></a>Insérer un jeu de Pendu *** </th></tr></thead> <tbody> </tbody> </table> <p>- module : pendu.php, pendu.js et pendu.CSS <br />- séparateurs obligatoires : [pendu] <br />- séparateurs optionnels : [titre], [texte], [copyright], [config] <br />- plusieurs [pendus] entre <jeux> et </jeux> : non <br />- paramètres de configuration par défaut :</p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>pendu=1 // Dessin du pendu en noir et blanc regle=non // Afficher la règle du jeu ? indices=non // Afficher les premières et dernières lettres? alphabet=latin1 // Utiliser un clavier latin simple</code></pre></div></blockquote> <p>Le pendu est essentiellement un jeu écrit en JavaScript. Il faut donc que votre navigateur et vos logiciels de protection de l'ordinateur l'autorisent.</p> <p>L'implémentation de ce jeu est très simple. Il suffit de choisir éventuellement le type de pendu à afficher (voir les dossiers disponibles sous la forme : /jeux/img/penduX) grâce à la configuration <i>pendu=X</i>, puis de renseigner la liste de mots située après la balise [pendu]. Le mot à deviner sera alors choisi au hasard à chaque partie de pendu.</p> <p><strong>Note :</strong> La liste des mots à placer après [pendu] peut accepter les séparateurs usuels : retours à la ligne, tabulations, espaces, virgules, points-virgules ou points.<br class='manualbr' />Les minuscules ou majuscules peuvent être utilisées indifféremment.<br class='manualbr' />N'utilisez aucun accent car le clavier du pendu ne les propose pas au joueur.</p> <p><strong>Exemple :</strong></p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [titre] Thème : le Jazz... [pendu] morton oliver armstrong ellington whiteman henderson nichols dorsey beiderbecke teagarden freeman kaminsky teschemacher davis goodman wilson hampton crosby parker gillespie powell monk clarke johnson mulligan evans hawkins basie coltrane coleman [config] Pendu = 2 // pendu en couleur </jeux></code></pre></div> <div class='spip_document_4041 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="12" data-legende-lenx="" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-4041 '><strong>Pendu Jazz </strong></div> </figcaption></figure> </div> <p>Concernant l'alphabet utilisé, il est possible d'en choisir un autre ou de l'indiquer en clair à chaque jeu :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[config] Alphabet = azerty1 Alphabet = A,B,C,D,È,É,Ê,Ë,Ï,Î,À,Â,Ä,Ô,Ö,Ù,Û,Ü</code></pre></div> <p>Voici les alphabets actuellement disponibles nativement :</p> <p> <strong>latin1 </strong> : A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z,-<br class='manualbr' /><strong>latinbr </strong> : A,B,C,D,,E,F,G,H,I,,J,K,L,M,N,,O,P,Q,R,S,,T,U,V,W,X,,Y,Z,-<br class='manualbr' /><strong>azerty1 </strong> : A,Z,E,R,T,Y,U,I,O,P,,Q,S,D,F,G,H,J,K,L,M,,W,X,C,V,B,N<br class='manualbr' /><strong>azerty2 </strong> : A,Z,E,R,T,Y,U,I,O,P,,Q,S,D,F,G,H,J,K,L,M,,W,X,C,V,B,N,-<br class='manualbr' /><strong>qwerty1 </strong> : Q,W,E,R,T,Y,U,I,O,P,,A,S,D,F,G,H,J,K,L,,Z,X,C,V,B,N,M<br class='manualbr' /><strong>qwerty2 </strong> : Q,W,E,R,T,Y,U,I,O,P,,A,S,D,F,G,H,J,K,L,,Z,X,C,V,B,N,M,-<br class='manualbr' /><strong>qwerty3 </strong> : Q,W,E,R,T,Y,U,I,O,P,,A,S,D,F,G,H,J,K,L,Ñ,,Z,X,C,V,B,N,M,-<br class='manualbr' /><strong>español1 </strong> : A,B,C,D,E,F,G,H,I,J,K,L,M,N,Ñ,O,P,Q,R,S,T,U,V,W,X,Y,Z,-<br class='manualbr' /><strong>español2 </strong> : A,B,C,D,E,F,G,H,I,J,K,L,M,N,Ñ,O,P,Q,R,S,T,U,V,W,X,Y,Z,Á,É,Í,Ó,Ú,-<br class='manualbr' /><strong>cyrillic1 </strong> : А,Б,В,Г,Д,Е,Ё,Ж,З,И,Й,К,Л,М,Н,О,П,Р,С,Т,У,Ф,Х,Ц,Ч,Ш,Щ,Ъ,Ь,Ы,Э,Ю,Я</p> <p><i>Notez que la double virgule entraîne un retour à la ligne.</i></p> <p>Une autre façon de personnaliser votre alphabet est d'ajouter la ligne suivante dans config/mes_options.php :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>define('jeux_alphabet_mesaccents', 'A,B,C,D,È,É,Ê,Ë,Ï,Î,À,Â,Ä,Ô,Ö,Ù,Û,Ü');</code></pre></div> <p>et puis configurer le jeu comme ceci :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[config] Alphabet = mesaccents</code></pre></div> <p><strong>Note de compatibilité :</strong> l'insertion de JavaScript dans les articles par les plugins a été facilitée par Spip 1.9.2. Le jeu du pendu n'est donc pour l'instant pas compatible avec les versions de SPIP antérieures ou égales à 1.9.1. À vos mises à jour !</p> <hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='ide5e4_c0'> *** <a id="mc"></a>Insérer une grille de mots-croisés *** </th></tr></thead> <tbody> </tbody> </table> <p>Les caractéristiques de ce jeu ont été placées ici : <a href='https://contrib.spip.net/Des-grilles-avec-le-plugin-Jeux' class="spip_in" hreflang="fr">Des grilles avec le plugin “Jeux”</a></p> <hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='ida556_c0'> *** <a id="sudoku"></a>Insérer une grille de sudoku *** </th></tr></thead> <tbody> </tbody> </table> <p>Les caractéristiques de ce jeu ont été placées ici : <a href='https://contrib.spip.net/Des-grilles-avec-le-plugin-Jeux' class="spip_in" hreflang="fr">Des grilles avec le plugin “Jeux”</a></p> <hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='ide305_c0'> *** <a id="multi"></a>Insérer un jeu multiple (un groupe de jeux) *** </th></tr></thead> <tbody> </tbody> </table> <p>Les caractéristiques de ce jeu ont été placées ici : <a href='https://contrib.spip.net/Les-jeux-multiples' class="spip_in" hreflang="fr">Les jeux multiples</a></p></div> </article> <article> <h1>Inserire dei giochi negli articoli !</h1> <p>nilocram — 2007-09-12T10:09:53Z</p> <div class='rss_chapo'><p>Questo plugin permette di inserire diversi giochi all'interno di un articolo SPIP.</p></div> <div class='rss_texte'><table class="table spip"> <thead><tr class='row_first'><th id='id3998_c0'> *** Informazioni sul plugin “Jeux” *** </th></tr></thead> <tbody> </tbody> </table> <p>- <strong>Autore:</strong> Patrice VANNEUFVILLE</p> <p>- <strong>Data:</strong> 2 dicembre 2006</p> <p>- <strong>Download:</strong> disponibile su <a href="http://zone.spip.org/files/spip-zone/jeux.zip" class="spip_out" rel="external">Spip-Zone</a>.</p> <p>- <strong>Lingue:</strong> per il momento francese, italiano e un po' d'inglese. Le traduzioni sono bene accette</p> <p><strong>Descrizione:</strong> Plugin che permette di generare diversi giochi all'interno di un articolo SPIP (questionario, parole crociate, sudoku, l'impiccato, ...). Analizza il codice dei giochi inseriti in SPIP, immagazzina i diversi elementi caratteristici e restituisce il codice HTML già formattato.</p> <p><strong>Installazione di un plugin:</strong> <a href="http://www.spip.net/it_article3422.html" class="spip_url spip_out" rel="external">http://www.spip.net/it_article3422.html</a></p> <p><strong>Sintassi nell'articolo:</strong> Nel testo dell'articolo il codice dei giochi deve trovarsi tra i tag, “<jeux>” e “</jeux>”. Anche questo codice è composto da separatori (per es.: [titre]) collocati tra i paragrafi del codice.<br class='manualbr' />Evitare di mescolare i separatori specifici che appartengono a giochi differenti nel codice di un unico gioco.<br class='manualbr' />I paragrafi del gioco possono a volte contenere delle scorciatoie tipografiche.</p> <p><strong>Un esempio semplice:</strong></p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [titre] L'indovinello del giorno [devinette] Anche se ha la coda non gliela pesti mai, cos'è ? [reponse] Il pianoforte </jeux></code></pre></div> </blockquote> <p><strong>separatori speciali:</strong> <br />- [titre]: utile per la maggior parte dei giochi <br />- [texte]: permette di inserire un contenuto così com'è nel risultato del gioco, per esempio un'immagine o una separazione più marcata tra due risposte o due domande di un questionario ... <br />- [config]: alcuni giochi possono aver bisogno di parametri di configurazione (visualizzazione, difficoltà, suggerimenti, ecc...). Questo separatore è seguito da righe nella forma: parametro = valore</p> <p><strong>Attenzione:</strong> per evitare brutte sorprese nella presentazione (sommari, rubriche, backend, ...), ricordatevi: <br />- sia di inserire un'introduzione nel vostro articolo tra i tag <intro> e </intro> <br />- sia di inserire la descrizione dell'articolo.</p> <p>Piccola nota per gli utenti di FCKEditor; non dimenticatevi di aggiungere la riga seguente in fckconfig.js:</p> <blockquote class="spip"> <p><code class='spip_code spip_code_inline' dir='ltr'>FCKConfig.ProtectedSource.Add(/<jeux[\s\S]*?\/jeux>/gi);</code></p> </blockquote> <p><strong>Moduli esistenti:</strong></p> <blockquote class="spip"> <p> <br />- <a href="#qcm" class="spip_ancre">Inserisci un questionario (o un quiz...)</a> <br />- <a href="#mc" class="spip_ancre">Inserisci uno schema di parole crociate</a> <br />- <a href="#sudoku" class="spip_ancre">Inserisci uno schema di sudoku</a> <br />- <a href="#trous" class="spip_ancre">Inserisci un esercizio di completamento</a> <br />- <a href="#poesie" class="spip_ancre">Inserisci una poesia</a> <br />- <a href="#citation" class="spip_ancre">Inserisci una citazione o una battuta</a> <br />- <a href="#devinette" class="spip_ancre">Inserisci un indovinello o una sciarada</a> <br />- <a href="#diagech" class="spip_ancre">Inserisci un diagramma di scacchi</a> <br />- <a href="#" class="spip_ancre">#</a> <br />- <a href="#" class="spip_ancre">#</a></p> </blockquote> <p><strong>Ringraziamenti:</strong> <br />- Mathieu GIANNECCHINI: creatore del questionario (domande a scelta multipla) <br />- Maïeul ROUQUETTE: creatore delle parole crociate <br />- François SCHREUER: creatore dei diagrammi di scacchi</p> <hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='id69ee_c0'> *** <a id="qcm"></a>Inserisci un questionario (o un quiz...) *** </th></tr></thead> <tbody> </tbody> </table> <p>- modulo: qcm.php <br />- separatori obbligatori: [qcm] o [quiz] <br />- separatori facoltativi: [titre], [texte] <br />- diversi [qcm] tra <jeux> e </jeux>: sì</p> <p>Nel paragrafo preceduto da [qcm], la sintassi è la seguente:</p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>T Titolo del questionario Q Testo della domanda P1 Testo della risposta 1 P2 Testo della risposta 2 ... Pi Testo della risposta i Rj (indica che la risposta esatta è la risposta j)</code></pre></div></blockquote> <p>Perciò, se la risposta esatta è la risposta 2 si indicherà “R2”.</p> <p>Attenzione, sono necessarie le maiuscole per: “T, Q, Pi e Ri”.</p> <p>E' possibile specificare i punti attribuiti a ciascuna risposta:</p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>P1.-2 Testo della risposta 1 -2 punti P2.4 Testo della risposta 2 4 punti R2</code></pre></div></blockquote> <p>Fate in modo che la risposta esatta attribuisca sempre il numero massimo di punti.</p> <p>Se al momento della correzione occorre spiegare la scelta (corretta o sbagliata) dell'utente, si possono aggiungere dei commenti:</p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>P1 Risposta 1|E un commento 1! P2 Risposta 2|E un commento 2!</code></pre></div></blockquote> <p>In funzione delle domande presenti, occorre prevedere più paragrafi preceduti dal separatore “[qcm]”.</p> <p>I tag [qcm] e [quiz] sono equivalenti.</p> <p><strong>Un esempio:</strong></p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [titre] Un titolo per il questionario! [qcm] Q Una domanda bla bla P1 Una risposta 1 P2 Una risposta 2 P3 Una risposta 3 (la risposta esatta) R3 (la risposta 3 è esatta!) [qcm] Q Una domanda ancora P1.2 Una risposta da 2 punti (la risposta è esatta) P2 Una risposta 2 R1 [qcm] Q Una domanda per finire P1 Una risposta 1|Un commento 1 P2 Una risposta 2|Un commento 2 P3.4 Una risposta da 4 punti!|Effettivamente! R3 </jeux></code></pre></div> </blockquote> <p><strong>Caso particolare:</strong> se l'utente deve inserire da solo la risposta, bastano una domanda “Q” e una risposta “P”. Esempio:</p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [qcm] Q Cita un pianeta del sistema solare: P mercurio venere terra marte giove saturno urano nettuno </jeux></code></pre></div> </blockquote> <p>L'elenco delle parole valide da collocare dopo “P” può accettare i separatori soliti: a capo, tabulazioni, spazi, virgole, punti e virgola o punti.<br class='manualbr' />Per una espressione che comprenda degli spazi, utilizzare le virgolette o il segno +<br class='manualbr' />Per esempio : “al fine di” è equivalente a : al+fine+di<br class='manualbr' />Le minuscole e le maiuscole possono essere usate indifferentemente nelle risposte.<br class='manualbr' />La gestione dei punti e la loro specificazione è sempre possible:</p> <blockquote class="spip"> <p><code class='spip_code spip_code_inline' dir='ltr'>P.4 mercurio venere terra marte giove saturno urano nettuno |Lo sapevi che plutone non è più un pianeta ?</code></p> </blockquote> <p><strong>Demo:</strong> <a href="http://www.ensemble-claudio-monteverdi.fr/article17" class="spip_url spip_out" rel="external">http://www.ensemble-claudio-monteve...</a></p> <hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='id5a09_c0'> *** <a id="mc"></a>Inserisci uno schema di parole crociate *** </th></tr></thead> <tbody> </tbody> </table> <p>- modulo: mots_croises.php <br />- separatori obbligatori: [horizontal], [vertical] & [solution] <br />- separatori facoltativi: [titre], [texte], [config] <br />- parametri di configurazione di default:</p> <blockquote class="spip"> <p><code class='spip_code spip_code_inline' dir='ltr'>solution=oui // Visualizzazione della soluzione ?</code></p> </blockquote> <p><br />- diversi schemi tra <jeux> e </jeux>: no</p> <p><strong>Un esempio:</strong></p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [horizontal] Definizione 1 Definizione 2. Definizione 3 Definizione 4. Definizione 5 [vertical] Definizione 1 Definizione 2 Definizione 3 [solution] aaa b*g a*d </jeux></code></pre></div> </blockquote><hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='idc0ed_c0'> *** <a id="sudoku"></a>Inserisci uno schema de sudoku *** </th></tr></thead> <tbody> </tbody> </table> <p>- modulo: sudoku.php <br />- separatori obbligatori: [sudoku] & [solution] <br />- separatori facoltativi: [titre], [texte], [config] <br />- parametri di configurazione di default:</p> <blockquote class="spip"> <p><code class='spip_code spip_code_inline' dir='ltr'>solution=oui // Visualizzare la soluzione?</code></p> </blockquote> <p><br />- diversi schemi tra <jeux> e </jeux>: no</p> <p>Gli schemi del sudoku possono avere le dimensioni: 4x4, 6x6 ou 9x9.<br class='manualbr' />Le caselle bianche sono rappresentate dal trattino: '-'</p> <p><strong>Un esempio:</strong></p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [sudoku] -2 --5--4 3--5 ----3 --1--6 6--1 [solution] 423615 165324 314562 256431 531246 642153 </jeux></code></pre></div> </blockquote><hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='id88ac_c0'> *** <a id="trous"></a>Inserisci un esercizio di completamento *** </th></tr></thead> <tbody> </tbody> </table> <p>- module: trous.php <br />- separatori obbligatori: [texte] & [trou] <br />- separatori facoltativi: [titre], [config] <br />- parametri di configurazione: indices = 0, 1, oui, non, yes, no, ... <br />- diversi [trou] tra <jeux> e </jeux>: sì</p> <p><strong>Un esempio:</strong></p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [texte] Questo è un esempio di cloze (esercizio di completamento). L'utente deve inserire le sue [trou]risposte[texte] negli spazi vuoti. Per ciascuna parola mancante possono essere accettate diverse risposte corrette. Per esempio, questo [trou] lacuna, vuoto, bianco [texte] autorizza le risposte " lacuna ", " vuoto " o " bianco ". [config] indices = oui </jeux></code></pre></div> </blockquote> <p><strong>Nota:</strong> L'elenco delle parole valide da collocare dopo [trou] può accettare i soliti separatori: a capo, tabulazioni, spazi, virgole, punti e virgola o punti.<br class='manualbr' />Per una espressione che comprenda degli spazi, utilizzare le virgolette o il segno +<br class='manualbr' />Per esempio : “al fine di” è equivalente a : al+fine+di <br class='manualbr' />Le minuscole e le maiuscole possono essere usate indifferentemente nelle risposte.</p> <hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='id405d_c0'> *** <a id="poesie"></a>Inserisci una poesia *** </th></tr></thead> <tbody> </tbody> </table> <p>- modulo: textes.php <br />- separatori obbligatori: [poesie] <br />- separatori facoltativi: [titre], [auteur], [recueil] <br />- diversi [poesie] tra <jeux> e </jeux>: no</p> <p><strong>Un esempio:</strong></p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [titre] L'ostrica asiatica [poesie] L'ostrica asiatica cura la sciatica portando un busto di fascia elastica con poco gusto di chi la mastica. [auteur] Toti SCIALOJA [recueil] Versi del senso perso, 1989 </jeux></code></pre></div> </blockquote><hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='id52c6_c0'> *** <a id="citation"></a>Inserisci una citazione o una battuta *** </th></tr></thead> <tbody> </tbody> </table> <p>- modulo: textes.php <br />- separatori obbligatori: [citation] o [blague] <br />- separatori facoltativi: [titre], [auteur] ou [recueil] <br />- diverse [citation] o [blague] tra <jeux> e </jeux>: sì</p> <p><strong>Un esempio:</strong></p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [citation] L'amore è cieco, perciò bisogna toccare. [auteur] Proverbio brasiliano </jeux></code></pre></div> </blockquote><hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='idbbcf_c0'> *** <a id="devinette"></a>Inserisci un indovinello o una sciarada *** </th></tr></thead> <tbody> </tbody> </table> <p>- modulo: devinettes.php <br />- separatori obbligatori: [devinette] ou [charade] <br />- separatori facoltativi: [reponse], [titre], [texte], [config] <br />- parametri di configurazione di default :</p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>reponse = oui // visualizzare la risposta ? taille=10 // dimensioni del font utilizzato</code></pre></div></blockquote> <p><br />- diversi [devinette] o [charade] tra <jeux> e </jeux>: sì</p> <p><strong>Due esempi:</strong></p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [devinette] Anche se ha la coda non gliela pesti mai, cos'è ? [reponse] Il pianoforte [devinette] Cos'hanno in comune un controllore delle imposte e uno spermatozoo ? [reponse] Tutti e due hanno una possibilità su tre milioni di diventare un giorno un essere umano. [config] reponse = oui </jeux> <jeux> [titre] Per i bambini... [charade] {{Il mio primo}} rimane segando il fusto. {{Il mio secondo}} la lingua in cui parlava Augusto. {{Il mio intero}} Si scarta e ha un dolce gusto. [reponse] Il cioccolatino </jeux></code></pre></div> </blockquote> <p><strong>Note:</strong> la Libreria GD (graphique dynamique) è necessaria sul proprio server per avere delle risposte visualizzate a rovescio. Un'immagine rovesciata viene in effetti creata, a condizione che la riga 'reponse = oui' sia stata collocata dopo il separatore [config].</p> <hr class="spip" /><table class="table spip"> <thead><tr class='row_first'><th id='id4f15_c0'> *** <a id="diagech"></a>Inserisci un diagramma di scacchi *** </th></tr></thead> <tbody> </tbody> </table> <p>- modulo: diag_echecs.php <br />- separatori obbligatori: [diag_echecs] <br />- separatori facoltativi: [titre], [texte], [config] <br />- parametri di configuratione di default:</p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>taille=29 // Dimensioni delle immagini in pixel (29 o 35) blancs=blanc // Colore delle caselle 'bianche' noirs=brun // Colore delle caselle 'nere' fond=blanc // Colore di fondo della pagina web bordure=2 // Spessore del bordo della scacchiera, in pixel police=5 // Codice del font utilizzato per le coordinate ( da 1 a 5) flip=non // Occorre ruotare la scacchiera? coords=oui // Visualizzare le coordinate ?</code></pre></div></blockquote> <p><br />- diversi [diag_echecs] tra <jeux> e </jeux>: sì</p> <p>La posizione deve essere descritta sotto forma di notazione FEN, oppure utilizzando la forma “classica”.<br class='manualbr' />Esempi: <br />- classica: B:Rg1,Dd1,Ta1,e1,Pa2,f6/N:Rb8,Pa6,f5 <br />- FEN : r1bqkbnr/pp2pppp/2n5/2p1P3/3p4/2P2N2/PP1P1PPP/RNBQKB1R</p> <p>Notazione “classica” : la descrizione della posizione bianca comica con “B:”, quella della posizione nera con “N:”, e le due sono separate da un “/”.<br class='manualbr' />E' anche possibile indicare un solo colore per la descrizione (B o N). L'ordine in questo caso è indifferente.<br class='manualbr' />Le maiuscole non sono obbligatorie</p> <p>Caselle evidenziate: si può utilizzare “/sv” per scegliere il verde, “/sb” per il blu, “/sj” per il giallo e “/sr” per il rosso.<br class='manualbr' />Attenzione: per utilizzare questa funzione, è necessario usare la notazione “classica”.</p> <p>Rotazione della scacchiera: è automatica utilizzando la notazione FEN (e naturalmente se la mossa spetta al Nero), altrimenti basta aggiungere “/r” alla descrizione “classica”.</p> <p><strong>Due esempi:</strong></p> <blockquote class="spip"><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><jeux> [diag_echecs] B:Rg1,Dd1,Ta1,e1,Pa2,f6/N:Rb8,Pa6,f5 [diag_echecs] r1bqkbnr/pp2pppp/2n5/2p1P3/3p4/2P2N2/PP1P1PPP/RNBQKB1R [config] taille=35 </jeux> <jeux> [diag_echecs] B:Rb6,pa3,Fh2/N:Rc8/sr:a8/sb:g3,f4,e5,d6,c7,b8 [config] taille=35 noirs=bleu </jeux></code></pre></div> </blockquote> <p><strong>Nota:</strong> la Libreria GD (graphique dynamique) è necessaria sul proprio server per visualizzare i diagrammi. ...)</p></div> </article> <article> <h1>Le Couteau Suisse</h1> <p>Patrice Vanneufville, Pierre KUHN — 2007-05-03T22:00:23Z</p> <div class='rss_chapo'><p>Ce plugin propose d'introduire facilement de simples fonctionnalités supplémentaires à SPIP et qui s'avèrent rapidement indispensables ! Par exemple : le contrôle de nombreuses variables «cachées» de SPIP, des améliorations ou facilités typographiques, des filtres supplémentaires, des balises pratiques, etc.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-9" id="nav6a60d14920d8c2.95130631"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Introduction"></a><a href="#Introduction" class="spip_ancre">Introduction</a></li><li> <a id="s-Fonctionnalites-outils-disponibles"></a><a href="#Fonctionnalites-outils-disponibles" class="spip_ancre">Fonctionnalités, outils disponibles</a></li><li> <a id="s-Particularite-du-lt"></a><a href="#Particularite-du-lt" class="spip_ancre">Particularité du «mode impression»</a></li><li> <a id="s-Installation-du-Couteau-Suisse"></a><a href="#Installation-du-Couteau-Suisse" class="spip_ancre">Installation du Couteau Suisse</a></li><li> <a id="s-Informations-techniques"></a><a href="#Informations-techniques" class="spip_ancre">Informations techniques</a></li><li> <a id="s-Compatibilite-avec-les-squelettes-ou-d-autres-plugins"></a><a href="#Compatibilite-avec-les-squelettes-ou-d-autres-plugins" class="spip_ancre">Compatibilité avec les squelettes ou d'autres plugins</a></li><li> <a id="s-Dysfonctionnements"></a><a href="#Dysfonctionnements" class="spip_ancre">Dysfonctionnements</a></li><li> <a id="s-Debats"></a><a href="#Debats" class="spip_ancre">Débats</a></li><li> <a id="s-Wiki"></a><a href="#Wiki" class="spip_ancre">Wiki</a></li></ul></div><div class="chapo" id="avertissement" style="display:none"> <div class="crayon mot-texte-189 crayon-init"> <p>Attention, la dernière mise à jour du Couteau Suisse (version 1.8.43.00, fichier zip de 15h le 02/07/11) peut poser quelques problèmes temporaires à votre site. Si le cas se présente, supprimez tous les fichiers «tmp/cache/charger*.*» après votre mise à jour afin de reconstruire le cache des plugins.<br/<Toutes nos excuses pour les dérangements occasionnés.</p> </div> </div><div id="outil_sommaire" style=" display:block; float:right; margin-left:1em; margin-right:0.4em; max-height:420px; overflow:auto; text-align:left; z-index:100; background-color:white; border:thin solid gray;"> <div style="margin:3pt;"> <div style=" /*line-height:1; border-bottom:1px dotted silver;*/ font-weight:bold; position:inherit; background:#E1F0F1 none repeat scroll 0 0; text-align:center;"> Sommaire </div> <ul style=" font-size:84%; list-style-image:none; list-style-position:outside; list-style-type:none; margin:0.3em 0.5em 0.1em 0.7em; padding:0;"> <li><a href="#introd" class="spip_ancre">Introduction</a></li> <li><a href="#outils" class="spip_ancre">Fonctionnalités, outils disponibles</a> <ul style=" list-style-image:none; list-style-position:outside; list-style-type:none; font-style:italic; line-height:1.2em; margin-left:2.4em;"> <li><a href="#outils" class="spip_ancre">Administration</a></li> <li><a href="#securite" class="spip_ancre">Sécurité</a></li> <li><a href="#iprivee" class="spip_ancre">Interface privée</a></li> <li><a href="#atypo" class="spip_ancre">Améliorations typographiques</a></li> <li><a href="#typo" class="spip_ancre">Raccourcis typographiques</a></li> <li><a href="#public" class="spip_ancre">Affichage public</a></li> <li><a href="#balficri" class="spip_ancre">Balises, filtres, critères</a></li> <li><a href="#devel" class="spip_ancre">Développement</a></li> <li><a href="#divers" class="spip_ancre">Divers</a></li> </ul> </li> <li><a href="#particul" class="spip_ancre">Particularité du «mode impression»</a></li> <li><a href="#install" class="spip_ancre">Installation du Couteau Suisse</a> <ul style=" list-style-image:none; list-style-position:outside; list-style-type:none; font-style:italic; line-height:1.2em; margin-left:2.4em;"> <li><a href="#maj" class="spip_ancre">Mise à jour</a></li> <li><a href="#urgence" class="spip_ancre">Procédure d'urgence</a></li> </ul> </li> <li><a href="#techn" class="spip_ancre">Informations techniques</a></li> <li><a href="#compat" class="spip_ancre">Compatibilité avec les squelettes ou d'autres plugins</a></li> <li><a href="#dysfct" class="spip_ancre">Dysfonctionnements</a></li> <li><a href="#debats" class="spip_ancre">Débats</a></li> <li><a href="#wiki" class="spip_ancre">Wiki</a></li> <li><a href="#forum" class="spip_ancre">Accès direct au forum</a></li> </ul> </div> </div><h2 class="h2" id='Introduction'><a id="introd"></a>Introduction<a class='sommaire-back sommaire-back-9' href='#s-Introduction' title='Back to the table of contents'></a></h2><div align="right" style="display:none;"><a href="#forum" class="spip_ancre">Accès direct au forum</a></div> <p>Le plugin <strong>«Le Couteau Suisse»</strong> propose d'introduire facilement de simples fonctionnalités supplémentaire à SPIP (que l'on pourra appeler «des outils» ou même «des lames») sans pour autant alourdir le core. Par exemple : le contrôle de nombreuses variables SPIP «cachées» ou non documentées, des améliorations ou facilités typographiques, des filtres supplémentaires, des balises pratiques, etc. Ma constatation est de voir que les utilisateurs (dont moi-même !) font souvent les mêmes installations de plugins dont certains ne font qu'une ligne ou deux. Il devient également plus facile de gérer les différentes variables de SPIP cachées à l'utilisateur lambda. L'idée est partie d'un message sur la liste spip.zone de Pierre Andrews (mes hommages, Pierre !) posté le dimanche 17 décembre 2006 19:16, suite à une plainte d'Olivier G. qui déplorait la création d'un plugin entier autour de l'utilisation d'une simple variable.</p> <p>Le but est donc de réunir toutes ces fonctionnalités, petites mais pratiques, en un seul plugin et d'ajouter dans l'espace d'administration une page de configuration où il suffira de cocher les outils voulus. Le gain en performances et en clarté est non négligeable : le plugin précompile les fonctionnalités lors de l'installation et permet ensuite une navigation plus fluide. Les débutants qui ne connaissent rien au PHP, HTML ou à SPIP, seront les premiers servis dans ce projet. Rien de plus facile pour moi ou pour la plupart d'entre vous d'ajouter une ligne de code qui va bien ... Mais ce n'est pas le cas de tout le monde !!</p> <p><strong>Un plugin en évolution...</strong></p> <p>Le plugin, bien qu'il soit stable et compatible avec SPIP v1.9.x/v2.x/v3.x/v4.0/v4.1<span class="spip_note_ref"> [<a href="#nb3-1" class="spip_note" rel="appendix" title="N'hésitez pas à nous faire part du résultat de vos tests" id="nh3-1">1</a>]</span>, reste encore en mouvance. Après s'être appelé <a href='https://contrib.spip.net/archive-Tweak-SPIP' class="spip_in" hreflang="fr">[archive] Tweak SPIP</a>, il continue à évoluer et à s'améliorer au fil des bugs découverts. Il convient donc pour l'instant de procéder à des mises à jour régulières. De nouveaux outils peuvent arriver à tout moment ! Vos petits coups de main et retours d'expériences sont essentiels pour la bonne évolution de ce plugin.</p> <p>La version du Couteau Suisse pour <strong>SPIP v1.91</strong> a été conservée ici : <a href="https://files.spip.net/grenier/couteau_suisse_191.zip" class="spip_url spip_out" rel="external">https://files.spip.net/grenier/cout...</a>. Sachez que cette version du plugin n'est désormais plus maintenue, il est préférable que vous mettiez à jour SPIP, vous y gagnerez sous tous les angles. Il en sera très bientôt de même avec SPIP v1.92...</p> <p><strong>Dépendances</strong></p> <p>La Couteau Suisse a vocation d'être un plugin totalement indépendant et compatible le plus largement possible avec les différentes versions de SPIP. Dès SPIP v1.9.2 et afin de faciliter grandement la mise en œuvre de ses fonctionnalités, <strong>le Couteau Suisse ne nécessite donc l'installation d'aucun autre plugin</strong>.</p> <p>Notez tout de même que :</p> <p>- Certains plugins tiers sont reconnus, sans être indispensables. Par exemple, <a href='https://contrib.spip.net/Chargeur-Activateur' class="spip_in" hreflang="fr">Chargeur Activateur</a> pour SPIP 1.92 ou <a href='https://contrib.spip.net/Porte-plume-3117' class="spip_in" hreflang="fr">Porte plume</a> pour SPIP >= 2.x. <br />- Certaines lames sont basées sur des <strong>fichiers externes</strong> dont il convient de bien vérifier le téléchargement lors de l'activation. Exemple d'outils concernés : «Prévisualisation des articles» - «Masquer du contenu» - «<a href='https://contrib.spip.net/De-jolis-coins' class="spip_in" hreflang="fr">Jolis Coins</a>», ... <br />- L'interface de configuration ainsi que quelques outils du plugin requièrent la librairie <i>jQuery</i>. Le site officiel (en anglais) est : <a href="http://jquery.com/" class="spip_url spip_out" rel="external">http://jquery.com/</a>. D'autres informations sont disponibles en français ici : <a href="http://www.jquery.info/" class="spip_url spip_out" rel="external">http://www.jquery.info/</a>. Cette librairie de fonctions Javascript a été complètement intégrée dans SPIP à partir de la version 1.92. Pour les versions antérieures, il vous faudra installer un plugin spécifique que vous pouvez télécharger ici : <a href="https://files.spip.org/spip-zone/jqueryplugin.zip" class="spip_url spip_out" rel="external">https://files.spip.org/spip-zone/jq...</a>.<br class='autobr' /> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a></p> <h2 class="h2" id='Fonctionnalites-outils-disponibles'><a id="outils"></a>Fonctionnalités, outils disponibles<a class='sommaire-back sommaire-back-9' href='#s-Fonctionnalites-outils-disponibles' title='Back to the table of contents'></a></h2> <p>Voici un peu en vrac les outils réunis pour l'instant. N'hésitez pas à nous signaler les oublis ou incohérences qui nous auraient échappés dans les tableaux qui suivent :</p> <table class="table spip"> <thead><tr class='row_first'><th id='id46b1_c0'> Administration </th></tr></thead> <tbody> </tbody> </table><table class="table spip"> <tbody> <tr class='row_odd odd'> <td><strong>Format des URLs</strong> </td></tr> <tr class='row_even even'> <td>SPIP offre un choix sur plusieurs jeux d'URLs pour fabriquer les liens d'accès aux pages de votre site. Plus d'infos : <a href="https://www.spip.net/fr_article765.html" class="spip_url spip_out auto" rel="nofollow external">https://www.spip.net/fr_article765.html</a>. L'outil « Boîtes privées » vous permet de voir sur la page de chaque objet SPIP l'URL propre associée. <p><strong>Format proposés</strong> : page, html, propres, propres2, libres, arborescentes, standard, propres_qs.</p> <p><i>Rappel</i> : pour utiliser les formats html, propres, propres2, libres ou arborescentes, recopiez le fichier “htaccess.txt” du répertoire de base du site SPIP sous le sous le nom “.htaccess” (attention à ne pas écraser d'autres réglages que vous pourriez avoir mis dans ce fichier) ; si votre site est en “sous-répertoire”, vous devrez aussi éditer la ligne “RewriteBase” ce fichier. Les URLs définies seront alors redirigées vers les fichiers de SPIP.</p> <p><strong>Nombreux paramètres de configuration</strong> : terminaison des URLs, début des URLs, caractère de séparation, longueur maximale, marqueurs dissociant les objets, script d'appel, lettres minuscules, id systématique en suffixe, id systématique en préfixe, minimum de 3 chiffres (pour Google notamment, SPIP 2.0 mini), etc.</p> <p><strong>Actions rapides sur les URLs</strong> :</p> <p>- Réinitialisation des URLs stockées dans la base</p> <p>- Édition en base de l'URL d'un objet spécifique.</p> </td></tr> <tr class='row_odd odd'> <td><strong>SPIP et le cache…</strong></td></tr> <tr class='row_even even'> <td>- <strong> <i>Désactiver le cache</i> </strong>: Par défaut, SPIP calcule toutes les pages publiques et les place dans le cache afin d'en accélérer la consultation. Désactiver temporairement le cache peut aider au développement du site. Sous SPIP 2.x, quatre valeurs possibles : Usage normal, Cache permanent,<br class='autobr' /> Pas de cache, Contrôle du cache. <p>- <strong> <i>Valeur du quota</i> </strong>: Le cache occupe un certain espace disque et SPIP peut en limiter l'importance. Une valeur vide ou égale à 0 signifie qu'aucun quota ne s'applique.</p> <p>- <strong> <i>Recalculer juste après une modification</i> </strong>: Lorsqu'une modification du contenu du site est faite, SPIP invalide immédiatement le cache sans attendre le calcul périodique suivant. Si votre site a des problèmes de performance face à une charge très élevée, vous pouvez cocher « non » à cette option.</p> <p>- <strong> <i>Durée du cache local</i> </strong>: Si la balise #CACHE n'est pas trouvée dans vos squelettes locaux, SPIP considère par défaut que le cache d'une page a une durée de vie de 24 heures avant de la recalculer. Afin de mieux gérer la charge de votre serveur, vous pouvez ici modifier cette valeur.</p> <p>- <strong> <i>Durée du cache en mutualisation</i> </strong>: Si vous avez plusieurs sites en mutualisation, vous pouvez spécifier ici la valeur par défaut prise en compte par tous les sites locaux (SPIP 2.0 mini).</p> <p>- <strong> <i>L'extension « Compresseur »</i> </strong> présente dans SPIP permet de compacter les différents éléments CSS et Javascript de vos pages et de les placer dans un cache statique. Cela accélère l'affichage du site, et limite le nombre d'appels sur le serveur et la taille des fichiers à obtenir. Quatre option pour régler compression du HEAD : <i>Compacter les CSS / Compacter le Javacript / Ne rien compacter en partie privée / Ne rien compacter du tout (rend caduques les options précédentes)</i>.</p> <p><strong>Action rapide sur le cache</strong> : le vider.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Dossier du squelette</strong></td></tr> <tr class='row_even even'> <td>Modifie le dossier du squelette utilisé. Par exemple : «squelettes/monsquelette». En laissant la case vide, c'est le squelette original «dist» fourni par SPIP qui sera utilisé.</td></tr> <tr class='row_odd odd'> <td><strong>Paragrapher</strong></td></tr> <tr class='row_even even'> <td>Applique (ou non) la fonction SPIP paragrapher() aux textes qui sont dépourvus de paragraphes en insérant des balises <code class='spip_code spip_code_inline' dir='ltr'><p></p></code>.</td></tr> <tr class='row_odd odd'> <td><strong>Suivi des forums</strong> (SPIP 1.9.2 uniquement)</td></tr> <tr class='row_even even'> <td>Un auteur d'article est toujours informé lorsqu'un message est publié dans le forum associé. Mais il est aussi possible d'avertir en plus : tous les participants au forum ou seulement les auteurs de messages en amont.</td></tr> <tr class='row_odd odd'> <td><strong>Pas de verrouillage de fichiers</strong></td></tr> <tr class='row_even even'> <td>Désactive le système de verrouillage de fichiers en neutralisant la fonction PHP <i>flock()</i>. Certains hébergements posent en effet des problèmes graves suite à un système de fichiers inadapté ou à un manque de synchronisation. N'activez pas cet outil si votre site fonctionne normalement.</td></tr> <tr class='row_odd odd'> <td><strong>Liste des webmestres</strong></td></tr> <tr class='row_even even'> <td>Un webmestre au sens SPIP est un administrateur ayant accès à l'espace FTP. Par défaut, il est l'administrateur id_auteur=1 du site. Les webmestres ont le privilège de ne plus être obligés de passer par FTP pour valider les opérations sensibles du site, comme la mise à jour de la base de données ou la restauration d'un dump. En tant que webmestre vous-même, vous aurez les droits de modifier cette liste.</td></tr> <tr class='row_odd odd'> <td><strong>La corbeille</strong> (SPIP 2.0 mini)</td></tr> <tr class='row_even even'> <td>SPIP supprime automatiquement les objets mis au rebuts au bout de 24 heures, en général vers 4 heures du matin, grâce à une tâche « CRON » (lancement périodique et/ou automatique de processus pré-programmés). Vous pouvez grâce à cet outil empêcher ce processus afin de mieux gérer votre corbeille. <p><strong>Action rapide</strong> : purger à votre convenance les objets déclassés.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Modération modérée</strong></td></tr> <tr class='row_even even'> <td>Permet de modérer la modération des forums publics configurés à priori pour les utilisateurs inscrits. Exemple : Je suis le webmestre de mon site, et je réponds à un message d'un utilisateur, pourquoi devoir valider mon propre message ? Modération modérée le fait pour moi !</td></tr> <tr class='row_odd odd'> <td><strong>Tâches CRON</strong></td></tr> <tr class='row_even even'> <td>Permet de visualiser les tâches « CRON » en cours (lancement périodique et/ou automatique de processus pré-programmés) et d'en piloter le fonctionnement</td></tr> </tbody> </table><table class="table spip"> <thead><tr class='row_first'><th id='idc1e9_c0'> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a> <a id="securite"></a>Sécurité </th></tr></thead> <tbody> </tbody> </table><center><i>(Les outils suivants concernent essentiellement la sécurité de votre site)</i></center><table class="table spip"> <tbody> <tr class='row_odd odd'> <td><strong>Lutte contre le SPAM</strong> </td></tr> <tr class='row_even even'> <td>Tente de lutter contre les envois de messages automatiques et malveillants en partie publique. Certains mots, tout comme les balises en clair <code class='spip_code spip_code_inline' dir='ltr'><a></a></code>, sont interdits : veuillez inciter vos rédacteurs à utiliser les raccourcis de liens SPIP. La configuration de cet outil antiSPAM vous permet facilement de Lister les séquences interdites et éventuellement de bloquer des adresses IPs. <p><strong>Action rapide</strong> : test interactif de ce filtre (messages et/ou adresses IP) et parcours éventuel de la base de données.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Ecran de sécurité</strong> (toutes versions de SPIP)</td></tr> <tr class='row_even even'> <td>L'écran de sécurité est un fichier PHP directement téléchargé sur le site officiel de SPIP, qui protège vos sites en bloquant certaines attaques liées à des trous de sécurité. <p>Outre la sécurité, cet écran a la capacité réglable de moduler les accès des robots d'indexation aux scripts php, de manière à leur dire de « revenir plus tard » lorsque le serveur est saturé.</p> <p>En cas de mise à jour officielle, actualisez le fichier distant associé afin de bénéficier de la protection la plus récente.</p> <p><strong>Fichier distant</strong> : facilité de mise à jour et gestion des versions.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Gestion du javascript</strong></td></tr> <tr class='row_even even'> <td>Pour gérer le javascript dans les articles, trois modes sont disponibles : <p>- <i>jamais</i> : le javascript est refusé partout</p> <p>- <i>défaut</i> : le javascript est signalé en rouge dans l'espace privé</p> <p>- <i>toujours</i> : le javascript est accepté partout.</p> <p>Attention : dans les forums, pétitions, flux syndiqués, etc., la gestion du javascript est toujours sécurisée.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Mises à jour automatiques</strong> - <a href='https://contrib.spip.net/Mise-a-jour-automatique-des-plugins' class="spip_in" hreflang="fr">Plus d'informations</a></td></tr> <tr class='row_even even'> <td>Garde un œil sur tous vos plugins. Cet outil vous permet de gérer facilement leurs mises à jour, récupérant notamment le numéro de révision contenu dans le fichier svn.revision et le comparant avec celui trouvé sur zone.spip.org. La liste proposée offre la possibilité de lancer le processus de mise à jour automatique de SPIP sur chacun des plugins préalablement installés dans le dossier plugins/auto/. <p>Cet outil vous informe également des différentes versions officielles disponibles pour SPIP lui-même.</p> </td></tr> <tr class='row_odd odd'> <td><strong>MailCrypt</strong> - <a href='https://contrib.spip.net/De-beaux-liens-hypertexte' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Masque tous les liens de courriels présents dans vos textes en les remplaçant par un lien Javascript permettant quand même d'activer la messagerie du lecteur. Cet outil antispam tente d'empêcher les robots de collecter les adresses électroniques laissées en clair dans les forums ou dans les balises de vos squelettes.</td></tr> <tr class='row_odd odd'> <td><strong>Citations bien balisées</strong></td></tr> <tr class='row_even even'> <td>Afin de respecter les usages en HTML dans les contenus SPIP de votre site (articles, rubriques, etc.), cet outil remplace automatiquement les balises <code class='spip_code spip_code_inline' dir='ltr'><quote></code> par des balises <code class='spip_code spip_code_inline' dir='ltr'><q></code> quand il n'y a pas de retour à la ligne.</td></tr> <tr class='row_odd odd'> <td><strong>Taille des forums</strong></td></tr> <tr class='row_even even'> <td>Par défaut les messages de forum ne sont pas limités en taille. Si cet outil est activé, un message d'erreur s'affichera lorsque quelqu'un voudra poster un message d'une taille supérieure à la valeur spécifiée, et le message sera refusé.</td></tr> <tr class='row_odd odd'> <td><strong>Pas de stockage IP</strong></td></tr> <tr class='row_even even'> <td>Désactive le mécanisme d'enregistrement automatique des adresses IP des visiteurs de votre site par soucis de confidentialité : SPIP ne conservera alors plus aucun numéro IP, ni temporairement lors des visites (pour gérer les statistiques ou alimenter spip.log), ni dans les forums (responsabilité).</td></tr> <tr class='row_odd odd'> <td><strong>Pas de forums anonymes</strong></td></tr> <tr class='row_even even'> <td>Incite tous les auteurs de messages publics à remplir (d'au moins d'une lettre !) le champ «Votre nom (ou pseudonyme) :» afin d'éviter les contributions totalement anonymes. <p>Cette fonctionnalité utilise la librairie jQuery.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Limites mémoire</strong></td></tr> <tr class='row_even even'> <td>- <strong>Taille maximale des images, des logos et des documents</strong>. Afin d'alléger la mémoire de votre serveur, SPIP vous permet de limiter les dimensions (hauteur et largeur) et la taille du fichier des images, logos ou documents joints aux divers contenus de votre site. Si un fichier dépasse la taille indiquée, le formulaire enverra bien les données mais elles seront détruites et SPIP n'en tiendra pas compte, ni dans le répertoire IMG/, ni en base de données. Un message d'avertissement sera alors envoyé à l'utilisateur. <br class='autobr' /> Une valeur nulle ou non renseignée correspond à une valeur illimitée. <p>- <strong>Espace maximal réservé aux copies locales</strong> (SPIP 2.0 mini). Il s'agit ici l'espace maximal réservé aux fichiers distants que SPIP pourrait télécharger (de serveur à serveur) et stocker sur votre site. La valeur par défaut est de 16 Mo.</p> <p>- <strong>Calculs d'images avec GD</strong>. Afin d'éviter un dépassement de mémoire PHP dans le traitement des grandes images par la librairie GD2, SPIP teste les capacités du serveur et peut donc refuser de traiter les trop grandes images. Il est possible de désactiver ce test en définissant manuellement le nombre maximal de pixels supportés pour les calculs. La valeur de 1 000 000 pixels semble correcte pour une configuration avec peu de mémoire. Une valeur nulle ou non renseignée entraînera le test du serveur.</p> <p>- <strong>Qualité de compression</strong> (SPIP 2.0 mini). La librairie GD2 permet d'ajuster la qualité de compression des images JPG. Un pourcentage élevé correspond à une qualité élevée.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Sessions anonymes</strong> (SPIP 2.1 maxi)</td></tr> <tr class='row_even even'> <td>Chaque semaine, cet outil vérifie les sessions anonymes et supprime les fichiers qui sont trop anciens (plus de 2 jours) afin de ne pas surcharger le serveur, notamment en cas de SPAM sur le forum.</td></tr> </tbody> </table><table class="table spip"> <thead><tr class='row_first'><th id='id7353_c0'> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a> <a id="iprivee"></a>Interface privée </th></tr></thead> <tbody> </tbody> </table><center><i>(Les outils suivants concernent uniquement la partie privée de SPIP)</i></center><table class="table spip"> <tbody> <tr class='row_odd odd'> <td><strong>Type d'interface privée</strong> (SPIP 1.9.2 maxi)</td></tr> <tr class='row_even even'> <td>Sélectionne d'office le type d'interface privée (simplifiée ou avancée) pour tous les rédacteurs déjà existants ou à venir et supprime le bouton correspondant du bandeau des petites icônes.</td></tr> <tr class='row_odd odd'> <td><strong>Allègement de l'interface privée</strong> (SPIP 2.0 mini)</td></tr> <tr class='row_even even'> <td>Désactive le menu de changement rapide de statut d'un article au survol de sa puce colorée. Cela est utile si vous cherchez à obtenir une interface privée la plus dépouillée possible afin d'optimiser les performances client.</td></tr> <tr class='row_odd odd'> <td><strong>Largeur d'écran</strong></td></tr> <tr class='row_even even'> <td>Détermine la largeur d'écran imposée à tous en partie privée. Un écran étroit présentera deux colonnes et un écran large en présentera trois. Le réglage par défaut laisse l'utilisateur choisir, son choix étant stocké dans un cookie. Il est possible aussi de modifier la largeur totale de la page.</td></tr> <tr class='row_odd odd'> <td><strong>Bouton « Visiter »</strong></td></tr> <tr class='row_even even'> <td>Remplace l'image du bouton standard « Visiter » (en haut à droite) par le logo du site, s'il existe. Pour définir ce logo, rendez-vous sur la page « Configuration du site » en cliquant sur le bouton « Configuration ».</td></tr> <tr class='row_odd odd'> <td><strong>Page des auteurs</strong></td></tr> <tr class='row_even even'> <td>Configure l'apparence de la page des auteurs, en partie privée. Vous pouvez définir : <p>- le nombre maximal d'auteurs à afficher sur le cadre central de la page des auteurs. Au-delà, une pagination est mise en place.</p> <p>- Les statuts d'auteurs qui peuvent être listés sur cette page (administrateurs, rédacteurs, visiteurs, etc.)</p> </td></tr> <tr class='row_odd odd'> <td><strong>Réglage des sélecteurs</strong></td></tr> <tr class='row_even even'> <td>- <strong>Sélecteur de rubrique (brouteur)</strong>. Permet d'utiliser le sélecteur de rubrique en AJAX à partir d'un nombre configurable de rubriques. <br />- <strong>Sélection de mots-clefs</strong> (SPIP 2.0 mini). Permet d'utiliser un champ de recherche au lieu d'une liste de sélection à partir d'un nombre configurable de mot(s)-clef(s). <br />- <strong>Sélection d'auteurs</strong> (SPIP 2.0 mini). L'ajout d'un auteur se fait par mini-navigateur dans la fourchette suivante : <p>- Une liste de sélection pour moins de XX auteurs(s).</p> <p>- Un champ de recherche à partir de YY auteurs(s).</p> </td></tr> <tr class='row_odd odd'> <td><strong>Dans la même rubrique</strong></td></tr> <tr class='row_even even'> <td>Définit le nombre d'objets listés dans le cadre nommé « Dans la même rubrique » et présent sur certaines pages de l'espace privé.</td></tr> <tr class='row_odd odd'> <td><strong>Les tris de SPIP</strong></td></tr> <tr class='row_even even'> <td>Pour personnaliser la navigation en partie privée et lorsque SPIP le permet, choisissez ici le tri à utiliser pour afficher certains types objets : <p>- <strong>Ordre des articles à l'intérieur des rubriques</strong></p> <p>- <strong>Ordre des groupes dans le formulaire d'ajout de mots-clés</strong></p> <p>Les propositions de configuration sont basées sur la fonctionnalité SQL 'ORDER BY'. N'utilisez le tri personnalisé que si vous savez ce que vous faites (champs disponibles par exemple pour les articles : id_article, id_rubrique, titre, soustitre, surtitre, statut, date_redac, date_modif, lang, etc.).</p> <p>Exemples : tri sur la date de modification (ORDER BY date_modif DESC), sur le titre (ORDER BY 0+titre,titre), sur la date de publication (ORDER BY date DESC), etc.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Boîtes privées</strong> - <a href='https://contrib.spip.net/Les-Boites-Privees' class="spip_in" hreflang="fr">Plus d'informations</a></td></tr> <tr class='row_even even'> <td>Toutes les boîtes décrites ci-dessous apparaissent dans la partie privée. <p>- <strong> <i>Les révisions du Couteau Suisse</i> </strong>: un cadre sur la présente page de configuration, indiquant les dernières modifications apportées au code du plugin (<a href="https://zone.spip.org/trac/spip-zone/log/_plugins_/_stable_/couteau_suisse?format=rss&mode=stop_on_copy&limit=20" class="spip_out" rel="external">Source</a>).</p> <p>- <strong> <i>Les articles au format SPIP</i> </strong>: un cadre repliable supplémentaire pour vos articles afin de connaître le code source utilisé par leurs auteurs.</p> <p>- <strong> <i>Les auteurs en stat</i> </strong>: un cadre supplémentaires sur la page des auteurs indiquant les 10 derniers connectés et les inscriptions non confirmées. Seuls les administrateurs voient ces informations.</p> <p>Vous pouvez également définir le nombre maximal d'auteurs à afficher sur le cadre central de cette page.</p> <p>- <strong> <i>Les webmestres SPIP</i> </strong> : un cadre dépliable sur la page des auteurs indiquant les administrateurs élevés au rang de webmestre SPIP. Seuls les administrateurs voient ces informations. Si vous êtes webmestre vous-même, voyez aussi l'outil « Liste des webmestres ».</p> <p>- <strong> <i>Les URLs propres</i> </strong> : un cadre dépliable pour chaque objet de contenu (article, rubrique, auteur, …) indiquant l'URL propre associée ainsi que leurs alias éventuels. L'outil « Format des URLs » vous permet une configuration fine des URLs de votre site.</p> <p>- <strong> <i>Les tris d'auteurs</i> </strong> : un cadre dépliable pour les articles contenant plus d'un auteur et permettant simplement d'en ajuster l'ordre d'affichage. Ceci est utile pour placer par exemple l'auteur original ou principal d'un article en toute première position.</p> <p>Seules les boucles AUTEURS non triées prennent en compte ces réglages.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Prévisualisation des articles</strong> (SPIP 2.0 mini, SPIP 2.1 maxi)</td></tr> <tr class='row_even even'> <td>Par défaut, SPIP permet de prévisualiser un article dans sa version publique et stylée, mais uniquement lorsque celui-ci a été « proposé à l'évaluation ». Hors cet outil permet aux auteurs de prévisualiser également les articles pendant leur rédaction. Chacun peut alors prévisualiser et modifier son texte à sa guise. <p>Attention : cette fonctionnalité ne modifie pas les droits de prévisualisation. Pour que vos rédacteurs aient effectivement le droit de prévisualiser leurs articles « en cours de rédaction », vous devez l'autoriser (dans le menu Configuration>Fonctions avancées de l'espace privé).</p> </td></tr> </tbody> </table><table class="table spip"> <thead><tr class='row_first'><th id='idb2b0_c0'> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a> <a id="atypo"></a>Améliorations typographiques </th></tr></thead> <tbody> </tbody> </table><center><i>(Les outils suivants modifient juste l'apparence de vos textes, sans en modifier la source)</i></center><table class="table spip"> <tbody> <tr class='row_odd odd'> <td><strong>Belles puces</strong> </td></tr> <tr class='row_even even'> <td>Remplace les puces « - » (tiret simple) des articles par des listes notées « -* » (traduites en HTML par : <code class='spip_code spip_code_inline' dir='ltr'><ul><li>…</li></ul></code>) et dont le style peut être personnalisé par css. Un nouveau raccourci est éventuellement proposé (« * ») pour conserver l'accès à cette puce image de SPIP.</td></tr> <tr class='row_odd odd'> <td><strong>Les exposants</strong> - <a href='https://contrib.spip.net/Mises-en-exposant' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Textes français : améliore le rendu typographique des abréviations courantes, en mettant en exposant les éléments nécessaires. Ainsi, <i>Mme</i> devient <i>M<sup>me</sup></i> et en corrigeant les erreurs courantes <i>2ème</i> ou <i>2me</i>, par exemple, deviennent <i>2<sup>e</sup></i>, seule abréviation correcte.</td></tr> <tr class='row_odd odd'> <td><strong>Guillemets typographiques</strong> - <a href='https://contrib.spip.net/Correction-typographique-des' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Remplace automatiquement les guillemets droits (") par les guillemets typographiques de la langue de composition. Le remplacement, transparent pour l'utilisateur, ne modifie pas le texte mais seulement l'affichage final.</td></tr> <tr class='row_odd odd'> <td><strong>Belles URLs</strong> - <a href='https://contrib.spip.net/De-beaux-liens-hypertexte' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>- <strong> <i>Liens corrects</i> </strong>: SPIP a pour habitude d'insérer un espace avant les points d'interrogation ou d'exclamation, typo française oblige. Voici un outil qui protège le point d'interrogation dans les URLs de vos textes. <p>- <strong> <i>Liens orphelins</i> </strong>: Remplace systématiquement toutes les URLs laissées en texte par les utilisateurs (notamment dans les forums) et qui ne sont donc pas cliquables, par des liens hypertextes au format SPIP. Voici un test : <i>www.spip.net</i> est remplacé par <a href="https://www.spip.net" class="spip_url spip_out" rel="external">www.spip.net</a>.</p> <p>Vous pouvez choisir le type de remplacement :</p> <p>- <i>basique</i> : sont remplacés les liens du type <i>http://spip.net</i> (tout protocole) ou <i>www.spip.net</i>.</p> <p>- <i>étendu</i> : sont remplacés en plus les liens du type <i>moi@spip.net</i>, <i>mailto:monmail</i> ou <i>news:mesnews</i>.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Sommaire pour les articles</strong> - <a href='https://contrib.spip.net/Un-sommaire-pour-vos-articles' class="spip_in" hreflang="fr">Plus d'informations</a></td></tr> <tr class='row_even even'> <td>Construit automatiquement un sommaire en début d'article afin d'accéder rapidement aux gros titres (balises <code class='spip_code spip_code_inline' dir='ltr'><h3>Un titre</h3></code> ou raccourcis SPIP <code class='spip_code spip_code_inline' dir='ltr'>{{{Un autre titre}}}</code>. Une balise #CS_SOMMAIRE est disponible pour déporter le sommaire dans la page. <p>Paramètres de configuration : <i>profondeur retenue sur les intertitres</i>, <i>largeur du sommaire (en caractères)</i>, <i>création systématique du sommaire (oui/non)</i>, <i>jolies ancres</i>.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Glossaire interne</strong> - <a href='https://contrib.spip.net/Un-glossaire-interne-pour-vos-sites' class="spip_in" hreflang="fr">Plus d'informations</a></td></tr> <tr class='row_even even'> <td>Gestion d'un glossaire interne lié à un groupe de mots-clés nommé «Glossaire» : très utile pour les termes difficiles ou les acronymes. Pour chaque mot, vous avez la possibilité de choisir les groupes utilisés, le nombre maximal de liens créés dans vos textes et la technique utilisée (JS ou CSS). <p><strong>Action rapide</strong> : Vérification de la base de données</p> </td></tr> <tr class='row_odd odd'> <td><strong>Smileys</strong> - <a href='https://contrib.spip.net/Inserer-des-smileys-ou-petites' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Remplace tous les smileys écrits «en texte» par l'image souriante correspondante. Outil très utile pour les forums. <p>Une balise est disponible pour afficher un tableau de smileys dans vos squelettes : #SMILEYS.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Intertitres en image</strong></td></tr> <tr class='row_even even'> <td>Transforme tous les intertitres « <code class='spip_code spip_code_inline' dir='ltr'>{{{Mon intertitre}}}</code> » ou « <code class='spip_code spip_code_inline' dir='ltr'>{{{*Mon intertitre}}}</code> » en image typographique paramétrable : taille de la police, couleur de la police, nom du fichier de la police (dossiers <i>polices/</i>), largeur maximale de la ligne de texte, hauteur de la ligne de texte (éq. à <i>line-height</i>), espacement autour du texte (éq. à <i>padding</i>), alignement du texte.</td></tr> <tr class='row_odd odd'> <td><strong>Sauts de ligne automatiques</strong></td></tr> <tr class='row_even even'> <td>Applique sur tous vos contenus SPIP (texte d'articles, rubriques, etc.) le filtre <code class='spip_code spip_code_inline' dir='ltr'>|post_autobr</code> qui remplace tous les sauts de ligne simples par un saut de ligne HTML <code class='spip_code spip_code_inline' dir='ltr'><br /></code>.</td></tr> <tr class='row_odd odd'> <td><strong>Titres typographiés</strong></td></tr> <tr class='row_even even'> <td>Active l'application automatique des raccourcis typographiques de SPIP sur toutes les balises #TITRE et apparentées (#NOM pour un auteur, etc.).</td></tr> </tbody> </table><table class="table spip"> <thead><tr class='row_first'><th id='id5754_c0'> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a> <a id="typo"></a>Raccourcis typographiques </th></tr></thead> <tbody> </tbody> </table><center><i>(Les outils suivants introduisent de nouveaux raccourcis pour la rédaction de vos textes)</i></center><table class="table spip"> <tbody> <tr class='row_odd odd'> <td><strong>Découpe en pages et onglets</strong> - <a href='https://contrib.spip.net/Decouper-un-texte-en-pages-et-ou-en-onglets' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Découpe l'affichage public d'un article en plusieurs pages grâce à une pagination automatique. placez simplement dans votre article quatre signes plus consécutifs (<code class='spip_code spip_code_inline' dir='ltr'>++++</code>) à l'endroit qui doit recevoir la coupure. <p>Si vous utilisez ce séparateur à l'intérieur des balises <code class='spip_code spip_code_inline' dir='ltr'><onglets></code> et <code class='spip_code spip_code_inline' dir='ltr'></onglets></code> alors vous obtiendrez un jeu d'onglets.</p> <p>Dans les squelettes : vous avez à votre disposition les nouvelles balises #ONGLETS_DEBUT, #ONGLETS_TITRE et #ONGLETS_FIN.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Blocs multilingues</strong></td></tr> <tr class='row_even even'> <td>À l'instar de ce vous pouvez déjà faire dans vos squelettes, cet outil vous permet d'utiliser librement les chaînes de langues (de SPIP ou de vos squelettes) dans tous les contenus de votre site (articles, titres, messages, etc.) à l'aide du raccourci <code class='spip_code spip_code_inline' dir='ltr'><:chaine:></code>. La fonction SPIP utilisée est : <code class='spip_code spip_code_inline' dir='ltr'>_T('un_texte', $flux)</code>. Les arguments sont également supportés. <p>N'oubliez pas de vérifier que 'un_texte' est bien défini dans les fichiers de langue.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Décoration</strong> - <a href='https://contrib.spip.net/Decorer-ou-colorer-vos-textes' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>De nouveaux styles (classes ou langues) paramétrables pour vos textes et accessibles grâce à des balises à chevrons personnalisées. Exemple : <code class='spip_code spip_code_inline' dir='ltr'><mabalise>texte</mabalise></code> ou : <code class='spip_code spip_code_inline' dir='ltr'><mabalise/></code>. <p>Exemples fournis : <code class='spip_code spip_code_inline' dir='ltr'><sc>capitales</sc></code>, <code class='spip_code spip_code_inline' dir='ltr'><souligne>souligné</souligne></code>, <code class='spip_code spip_code_inline' dir='ltr'><barre>barré</barre></code>, <code class='spip_code spip_code_inline' dir='ltr'><dessus>dessus</dessus></code>, <code class='spip_code spip_code_inline' dir='ltr'><clignote>clignote</clignote></code>, <code class='spip_code spip_code_inline' dir='ltr'><surgris>gris</surgris></code> et <code class='spip_code spip_code_inline' dir='ltr'><surfluo>fluo</surfluo></code></p> </td></tr> <tr class='row_odd odd'> <td><strong>Tout en couleurs</strong> - <a href='https://contrib.spip.net/Decorer-ou-colorer-vos-textes' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Permet d'appliquer facilement des couleurs (toutes éventuellement paramétrables) à tous les textes du site (articles, brèves, titres, forum, ...) en utilisant des balises à crochets (anglais ou français). <p>Deux exemples identiques : <code class='spip_code spip_code_inline' dir='ltr'>Lorem ipsum [rouge]dolor[/rouge] sit amet</code> et <br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>Lorem ipsum [red]dolor[/red] sit amet</code>.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Chatons</strong></td></tr> <tr class='row_even even'> <td>Insère des images (ou <i>chatons</i> pour les <i>tchats</i>) dans tous les textes où apparaît une chaîne du genre <code class='spip_code spip_code_inline' dir='ltr'>:nom</code>. Comme pour les smileys, cet outil remplace les raccourcis en texte par les images du même nom qu'il trouve dans le répertoire plugins/couteau_suisse/img/chatons/ ou squelettes/mon_squelette/img/chatons/.</td></tr> <tr class='row_odd odd'> <td><strong>Filets de Séparation</strong> - <a href='https://contrib.spip.net/Filets-de-Separation' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Permet d'insérer très facilement des filets de séparation personnalisés dans les textes, comme des styles purs ou des images à placer dans le répertoire plugins/couteau_suisse/img/filets.</td></tr> <tr class='row_odd odd'> <td><strong>Blocs Dépliables</strong> - <a href='https://contrib.spip.net/Des-blocs-depliables' class="spip_in" hreflang="fr">Plus d'informations</a></td></tr> <tr class='row_even even'> <td>Vous permet de créer des blocs dont le titre cliquable peut les rendre visibles ou invisibles. <p>Dans les textes SPIP : les rédacteurs ont à disposition les nouvelles balises <code class='spip_code spip_code_inline' dir='ltr'><bloc></code> (ou <code class='spip_code spip_code_inline' dir='ltr'><invisible></code>) et <code class='spip_code spip_code_inline' dir='ltr'><visible></code> à utiliser dans leurs textes.</p> <p>Dans les squelettes : vous avez à votre disposition les nouvelles balises #BLOC_TITRE, #BLOC_DEBUT et #BLOC_FIN.</p> </td></tr> </tbody> </table><table class="table spip"> <thead><tr class='row_first'><th id='id1374_c0'> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a> <a id="public"></a>Affichage public </th></tr></thead> <tbody> </tbody> </table><center><i>(Les outils suivants modifient juste l'apparence des pages publiques)</i></center><table class="table spip"> <tbody> <tr class='row_odd odd'> <td><strong>Supprime le numéro</strong> (obsolète dès SPIP 3.0) </td></tr> <tr class='row_even even'> <td>Applique la fonction SPIP supprimer_numero() à l'ensemble des titres, des noms et des types (de mots-clés) du site public, sans que le filtre supprimer_numero soit présent dans les squelettes.<br class='autobr' /> Voici la syntaxe à utiliser dans le cadre d'un site multilingue : <code class='spip_code spip_code_inline' dir='ltr'>1. <multi>My Title[fr]Mon Titre[de]Mein Titel</multi></code>.</td></tr> <tr class='row_odd odd'> <td><strong>Force la langue</strong></td></tr> <tr class='row_even even'> <td>Force le contexte de langue pour les jeux de squelettes multilingues disposant d'un formulaire ou d'un menu de langues sachant gérer le cookie de langues. Techniquement, cet outil a pour effet : <p>- de désactiver la recherche du squelette en fonction de la langue de l'objet,</p> <p>- de désactiver le critère <code class='spip_code spip_code_inline' dir='ltr'>{lang_select}</code> automatique sur les objets classiques (articles, brèves, rubriques etc ... ).</p> <p>Les blocs multi s'affichent alors toujours dans la langue demandée par le visiteur.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Style des paragraphes</strong></td></tr> <tr class='row_even even'> <td>Jusqu'à la version 1.92 de SPIP, les paragraphes html (marqués par la balise <code class='spip_code spip_code_inline' dir='ltr'><p></code>) étaient systématiquement affublés du style <code class='spip_code spip_code_inline' dir='ltr'>class="spip"</code>. Cet outil vous permet de définir le style de vos paragraphes en fonction de vos feuilles de style.</td></tr> <tr class='row_odd odd'> <td><strong>Désactive les objets flash</strong> <p>Supprime les objets flash des pages de votre site et les remplace par le contenu alternatif associé. Nécessite le plugin <i>jQuery</i> ou une version de SPIP supérieure à 1.9.2.</p> </td></tr> <tr class='row_even even'> <td><strong>SPIP et les liens… externes</strong> - <a href='https://contrib.spip.net/De-beaux-liens-hypertexte' class="spip_in" hreflang="fr">Plus d'informations</a></td></tr> <tr class='row_odd odd'> <td>- <strong> <i>Liens externes</i> </strong>: permet aux liens externes au site de s'ouvrir dans une nouvelle fenêtre extérieure. Activer cet outil revient à ajouter automatiquement <code class='spip_code spip_code_inline' dir='ltr'>target="_blank"</code> à toutes les balises <code class='spip_code spip_code_inline' dir='ltr'><a></code> dotées par SPIP des classes <i>spip_out</i>, <i>spip_url</i> et/ou <i>spip_glossaire</i>. Il est parfois nécessaire d'ajouter l'une de ces classes aux liens du squelette du site (fichiers html) afin d'étendre au maximum cette fonctionnalité. <p>- <strong> <i>Glossaire externe</i> </strong>: SPIP permet de relier des mots à leur définition grâce au raccourci typographique <code class='spip_code spip_code_inline' dir='ltr'>[?mot]</code>. Par défaut, le glossaire externe renvoie vers l'encyclopédie libre wikipedia.org. À vous de choisir l'adresse à utiliser. Exemple : <a href="https://en.wikipedia.org/wiki/SPIP" class="spip_glossaire" rel="external">SPIP</a>.</p> </td></tr> <tr class='row_even even'> <td><strong>Désactive jQuery</strong></td></tr> <tr class='row_odd odd'> <td>Empêche l'installation des fonctions de <i>jQuery</i> dans la partie publique : utile pour alléger les pages ou installer d'autres librairies. <i>jQuery</i> (<a href="http://jquery.com/" class="spip_url spip_out" rel="external">http://jquery.com/</a>) apporte de nombreuses commodités dans la programmation de Javascript et peut être utilisée par certains plugins. SPIP l'utilise dans sa partie privée.</td></tr> <tr class='row_even even'> <td><strong>Ancres douces</strong></td></tr> <tr class='row_odd odd'> <td>Offre à votre site public un défilement adouci de la page lorsque le visiteur clique sur un lien pointant vers une ancre : très utile pour éviter de se perdre dans une page complexe ou un texte très long...</td></tr> <tr class='row_even even'> <td><strong>Jolis Coins</strong> - <a href='https://contrib.spip.net/De-jolis-coins' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_odd odd'> <td>Permet de modifier facilement l'aspect des coins de vos cadres colorés en partie publique de votre site. Tout est possible, ou presque ! Voyez le résultat sur cette page : <a href="http://www.malsup.com/jquery/corner/" class="spip_url spip_out" rel="external">http://www.malsup.com/jquery/corner/</a>.</td></tr> <tr class='row_even even'> <td><strong>Visiteurs connectés</strong></td></tr> <tr class='row_odd odd'> <td>Offre une noisette pour votre squelette qui affiche le nombre de visiteurs connectés sur le site public : ajoutez simplement <code class='spip_code spip_code_inline' dir='ltr'><INCLURE{fond=fonds/visiteurs_connectes}></code> dans vos pages. Pour éviter l'insertion d'un paragraphe, ajouter le paramètre <code class='spip_code spip_code_inline' dir='ltr'>{p=0}</code> : <code class='spip_code spip_code_inline' dir='ltr'><INCLURE{fond=fonds/visiteurs_connectes}{p=0}></code></td></tr> <tr class='row_even even'> <td><strong>Message d'alerte</strong></td></tr> <tr class='row_odd odd'> <td>Affiche en tête de toutes les pages publiques un bandeau d'alerte pour diffuser le message d'urgence défini par l'utilisateur. <p>Les balises <code class='spip_code spip_code_inline' dir='ltr'><multi/></code> sont recommandées en cas de site multilingue.</p> </td></tr> </tbody> </table><table class="table spip"> <thead><tr class='row_first'><th id='idef8f_c0'> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a> <a id="balficri"></a>Balises, filtres, critères </th></tr></thead> <tbody> </tbody> </table><table class="table spip"> <tbody> <tr class='row_odd odd'> <td><strong>Orientation des images</strong> </td></tr> <tr class='row_even even'> <td>Ajoute les critères <code class='spip_code spip_code_inline' dir='ltr'>{portrait}</code>, <code class='spip_code spip_code_inline' dir='ltr'>{carre}</code> et <code class='spip_code spip_code_inline' dir='ltr'>{paysage}</code> dans vos squelettes pour le classement des photos. <p><a href='https://contrib.spip.net/Portrait-ou-Paysage' class="spip_in" hreflang="fr">Idée d'origine</a></p> </td></tr> <tr class='row_odd odd'> <td><strong>Version texte</strong></td></tr> <tr class='row_even even'> <td>2 filtres pour vos squelettes. <p>version_texte : extrait le contenu texte d'une page html à l'exclusion de quelques balises élémentaires.</p> <p>version_plein_texte : extrait le contenu texte d'une page html pour rendre du texte plein.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Balise #INSERT_HEAD</strong></td></tr> <tr class='row_even even'> <td>Active #INSERT_HEAD sur tous les squelettes, qu'ils aient ou non cette balise entre <head> et </head>. Grâce à cette option, les plugins pourront insérer du javascript (.js) ou des feuilles de style (.css).</td></tr> <tr class='row_odd odd'> <td><strong>Balise #INTRODUCTION</strong> - <a href='https://contrib.spip.net/Reglages-pour-la-balise' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>- <strong> <i>Longueur du résumé</i> </strong>: vous pouvez préciser (en pourcentage par rapport à la valeur utilisée par défaut) la longueur du texte renvoyé par balise #INTRODUCTION. Une valeur nulle ou égale à 100 ne modifie pas l'aspect de l'introduction et utilise donc les valeurs par défaut suivantes : 500 caractères pour les articles, 300 pour les brèves et 600 pour les forums ou les rubriques. <p>- <strong> <i>Points de suite</i> </strong>: par défaut, les points de suite ajoutés au résultat de la balise #INTRODUCTION sont : <code class='spip_code spip_code_inline' dir='ltr'>'&</code><code class='spip_code spip_code_inline' dir='ltr'>nbsp;(...)'</code>. Cette balise à placer dans les squelettes sert en général à la une ou dans les rubriques afin d'introduire les articles, les brèves, etc.. Vous pouvez donc préciser votre propre chaîne de caractère indiquant à l'utilisateur que le texte tronqué a bien une suite.</p> <p>- <strong> <i>Points de suite cliquables</i> </strong>: si la balise #INTRODUCTION est utilisée pour résumer un article, alors le Couteau Suisse peut fabriquer un lien hypertexte sur les points de suite définis ci-dessus afin de mener le lecteur vers le texte original. Par exemple : « Lire la suite de l'article… »</p> </td></tr> <tr class='row_odd odd'> <td><strong>Liens en clair</strong> - <a href='https://contrib.spip.net/De-beaux-liens-hypertexte' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Met à votre disposition le filtre : 'liens_en_clair'. Votre texte contient probablement des liens hypertexte qui ne sont pas visibles lors d'une impression. Ce filtre ajoute entre crochets la destination de chaque lien cliquable (liens externes ou mails). <p>Attention : En mode impression (paramètre 'cs=print' dans l'url de la page par exemple), cette fonctionnalité est appliquée automatiquement.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Balises #TITRE_PARENT/OBJET</strong> - <a href='https://contrib.spip.net/Les-balises-TITRE_PARENT-et' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Au sein d'une boucle, il est courant de vouloir afficher le titre du parent de l'objet en cours. Traditionnellement, il suffirait d'utiliser une seconde boucle, mais cette nouvelle balise <strong>#TITRE_PARENT</strong> allégera l'écriture de vos squelettes. Le résultat renvoyé est : le titre du groupe d'un mot-clé ou celui de la rubrique parente (si elle existe) de tout autre objet (article, rubrique, brève, etc.). <p>Notez : Pour les mots-clés, un alias de #TITRE_PARENT est <strong>#TITRE_GROUPE</strong>. Le traitement SPIP de ces nouvelles balises est similaire à celui de #TITRE.</p> <p>- Si vous êtes sous SPIP 2.0, alors vous avez ici à votre disposition tout un ensemble de balises <strong>#TITRE_XXX</strong> qui pourront vous donner le titre de l'objet 'xxx', à condition que le champ '<i>id_xxx</i>' soit présent dans la table en cours (<i>#ID_XXX</i> utilisable dans la boucle en cours).</p> <p>Par exemple, dans une boucle sur (ARTICLES), <i>#TITRE_SECTEUR</i> donnera le titre du secteur dans lequel est placé l'article en cours, puisque l'identifiant #ID_SECTEUR (ou le champ 'id_secteur') est disponible dans ce cas.</p> <p>La syntaxe <strong>#TITRE_XXX{yy}</strong> est également supportée. Exemple : <i>#TITRE_ARTICLE{10}</i> renverra le titre de l'article #10.</p> </td></tr> <tr class='row_odd odd'> <td><strong> Balises #SWITCH #CASE</strong> (SPIP 3.1 mini) - <a href='https://contrib.spip.net/Balises-et-filtre-switch-case' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Les balises <strong>#SWITCH</strong>, <strong>#CASE</strong> et <strong>#CASE_DEFAULT</strong>, ainsi que le filtre <strong>|switchcase</strong>, implémentent les contrôles <i>switch/case/default</i> du PHP ou du C. <p>Ces écritures simplifient grandement la lisibilté de vos squelettes. Exemples :<br class='autobr' /></p> <blockquote class="spip"><div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#SWITCH{#ENV{code_erreur}} [(#CASE{0}) Tout va bien] [(#CASE{1}) Attention ?] [(#CASE{2}) Oups !] [(#FRUIT|switchcase{ banane,jaune, orange,orange, fraise,rouge, inconnue }]</code></pre></div></blockquote> <p>- Après un appel à <code class='spip_code spip_code_inline' dir='ltr'>#SWICH{valeur comparée}</code>, <code class='spip_code spip_code_inline' dir='ltr'>#CASE{valeur calculée}</code> vaut <code class='spip_code spip_code_inline' dir='ltr'>''</code> (vide) si la valeur calculée est différente de la valeur comparée, et vaut <code class='spip_code spip_code_inline' dir='ltr'>' '</code> (espace) en cas d'égalité.</p> <p>- La valeur testée par le #SWITCH reste disponible grâce à : <code class='spip_code spip_code_inline' dir='ltr'>#GET{_switch_}</code>.</p> <p>- On ne peut pas emboiter plusieurs <code class='spip_code spip_code_inline' dir='ltr'>#SWITCH</code> dans un même squelette.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Balise #SET étendue</strong> - <a href='https://contrib.spip.net/Balise-SET-etendue' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Afin d'alléger les écritures du type <code class='spip_code spip_code_inline' dir='ltr'>#SET{x,#GET{x}|un_filtre}</code>, cet outil vous offre le raccourci suivant : <code class='spip_code spip_code_inline' dir='ltr'>#SET_UN_FILTRE{x}</code>. Le filtre appliqué à une variable passe donc dans le nom de la balise. Exemples : <code class='spip_code spip_code_inline' dir='ltr'>#SET{x,1}#SET_PLUS{x,2}</code> ou <code class='spip_code spip_code_inline' dir='ltr'>#SET{x,avions}#SET_REPLACE{x,ons,ez}</code>.</td></tr> <tr class='row_odd odd'> <td><strong>Trousse à balises</strong> - <a href='https://contrib.spip.net/Trousse-a-Balises-la-balise-BOLO-et-Cie' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Quelques balises pour faciliter la rédaction de vos squelettes : <p>- <strong>La balise #BOLO/Le modèle <boloxxx></strong> : produit un faux texte d'un maximum de 3000 caractères (“bolo” ou “lorem ipsum”) afin d'aider à la mise au point des pages. L'argument peut préciser le nombre de caractères voulu.</p> <p>- <strong>La balise #CHR</strong> : retourne le caractère dont le code ASCII est donné par le paramètre ascii en argument.</p> <p>- <strong>La balise #MAINTENANT/#NOW</strong> : renvoie la date et l'heure actuelle (attention cependant au cache de SPIP). L'argument peut en spécifier le format.</p> <p>- <strong>La balise #AUTORISER_SINON_LOGIN</strong> : renvoie une page de login si l'autorisation n'est pas donnée au squelette en cours.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Masquer du contenu</strong> (SPIP 2.0 mini)</td></tr> <tr class='row_even even'> <td>Permet de masquer sur le site public et sans modification particulière de vos squelettes, les contenus (rubriques ou articles) qui ont le mot-clé défini par l'utilisateur. Si une rubrique est masquée, toute sa branche l'est aussi. Pour forcer l'affichage des contenus masqués, il suffit d'ajouter le critère <code class='spip_code spip_code_inline' dir='ltr'>{tout_voir}</code> aux boucles de votre squelette.</td></tr> <tr class='row_odd odd'> <td><strong>Obfusquer des liens</strong></td></tr> <tr class='row_even even'> <td>Met à votre disposition le filtre : <strong>|obfusquer_liens</strong>. L'obfuscation de liens permet d'empêcher les robots des moteurs de recherche de suivre les liens de type <code class='spip_code spip_code_inline' dir='ltr'><a href=\"page.html\">par ici</a></code>, sans modifier la navigation. Cela pourra éviter la transmission de <i>pagerank</i> non désiré vers des pages à moindre intérêt, et guider les robots vers des pages plus pertinentes et riches. <p>En plaçant <code class='spip_code spip_code_inline' dir='ltr'>#FILTRE{obfusquer_liens}</code> dans un squelette, tous les liens seront obfusqués.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Critère « <i>left_join</i> »</strong></td></tr> <tr class='row_even even'> <td>Met à votre disposition le critère « <i>left_join</i> » permettant à vos boucles d'utiliser des jointures SQL « LEFT JOIN » à la place des jointures d'intersection « INNER JOIN » que SPIP utilise par défaut. <p>Les résultats incluront ainsi toutes les entrées de la table principale, qu'il y ait une correspondance ou non dans la table liée.</p> <p>Voici quelques exemples de syntaxe :</p> <p>- <i>Sans paramètre, le critère s'applique à toutes les tables liées</i> : <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE(AUTEURS spip_documents){left_join}...</code></p> <p>- <i>Les paramètres (séparés par des espaces) permettent de cibler certaines tables</i> : <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE(spip_documents_liens documents rubriques){left_join documents}....</code></p> <p>- <i>Avec un paramètre “debug”, des informations utiles sont affichées (à éviter en mode production)</i> : <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE(XXX YYY ZZZ){left_join debug}....</code></p> </td></tr> </tbody> </table><table class="table spip"> <thead><tr class='row_first'><th id='idfb9d_c0'> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a> <a id="devel"></a>Développement </th></tr></thead> <tbody> </tbody> </table><center><i>(Les outils suivants sont en général utilisés pendant la phase de développement de site)</i></center><table class="table spip"> <tbody> <tr class='row_odd odd'> <td><strong>Site en travaux</strong> </td></tr> <tr class='row_even even'> <td>Permet d'afficher un message personnalisable pendant une phase de maintenance sur tout le site public et de choisir le type d'utilisateur autorisés à parcourir le site (public ou privé). <p>Modèle surchargeable utilisé : <i>fonds/en_travaux.html</i></p> </td></tr> <tr class='row_odd odd'> <td><strong>Activer le validateur xml</strong></td></tr> <tr class='row_even even'> <td>Active le validateur xml pour l'espace public tel qu'il est décrit dans la <a href="https://www.spip.net/fr_article3541.html" class="spip_out" rel="external">documentation</a>.</td></tr> <tr class='row_odd odd'> <td><strong>Débogueur de développement</strong></td></tr> <tr class='row_even even'> <td>Permet de voir les erreurs PHP à l'écran. Vous pouvez même choisir le niveau d'erreurs d'exécution PHP qui sera affiché si le débogueur est actif, ainsi que l'espace SPIP sur lequel ces réglages s'appliqueront. Utile notamment pour valider la syntaxe de vos pages finales, et résoudre les problèmes d'accessibilité du Web aux déficients visuels.</td></tr> <tr class='row_odd odd'> <td><strong>SPIP et les logs</strong> - <a href='https://contrib.spip.net/SPIP-et-les-logs' class="spip_in" hreflang="fr">Plus d'Informations</a></td></tr> <tr class='row_even even'> <td>Configure les différents paramètres pris en compte par SPIP pour la journalisation des événements particuliers du site : <i>rotation des fichiers (nombre et taille), dossier, nom, extension, nombre d'accès par hit, informations supplémentaires, format brut et gravité maximale acceptée</i>. <p>Cet outil permet également de consulter et/ou supprimer tous les logs du site.</p> </td></tr> <tr class='row_odd odd'> <td><strong>Traductions manquantes</strong></td></tr> <tr class='row_even even'> <td>Toutes les chaînes de langue qui ne sont pas internationalisées (donc présentes dans les fichiers lang/*_XX.php) vont apparaître en rouge. Utile pour n'en oublier aucune !</td></tr> <tr class='row_odd odd'> <td><strong>Décalage horaire</strong> (PHP 5.1 mini)</td></tr> <tr class='row_even even'> <td>Configure le décalage horaire utilisé par les fonctions date/heure et permet notamment d'éviter les avertissements de PHP 5 lorsque ce décalage horaire est indéfini ou invalide.</td></tr> <tr class='row_odd odd'> <td><strong>Profiling</strong> - <a href='https://contrib.spip.net/SPIP-et-les-logs#profiling' class="spip_in" hreflang="fr">Plus d'Informations</a></td> <td class='numeric '></td></tr> <tr class='row_even even'> <td>Aide à optimiser les requêtes SQL de vos squelettes ou de vos scripts en traçant les informations correspondant aux requêtes <a href="https://dev.mysql.com/doc/refman/5.0/en/slow-query-log.html" class="spip_out" rel="external">« trop lentes »</a> (MySQL uniquement) ou aux boucles SPIP dépassant un nombre défini de secondes.</td></tr> </tbody> </table><table class="table spip"> <thead><tr class='row_first'><th id='id49c6_c0'> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a> <a id="divers"></a>Divers </th></tr></thead> <tbody> </tbody> </table><table class="table spip"> <tbody> <tr class='row_odd odd'> <td><strong>Comportements du Couteau Suisse</strong> </td></tr> <tr class='row_even even'> <td>- <strong> <i>Logs</i> </strong> : obtenez de nombreux renseignements à propos du fonctionnement du Couteau Suisse dans les fichiers spip.log que l'on peut trouver dans le répertoire temporaire (/tmp à partir de SPIP v1.9.2) <p>- <strong> <i>Options SPIP en amont</i> </strong> : SPIP ordonne les plugins dans un ordre spécifique. Afin d'être sûr que le Couteau Suisse soit en tête et gère en amont certaines options de SPIP, alors cochez cette option. Si les droits de votre serveur le permettent, le fichier config/mes_options.php sera automatiquement modifié pour inclure le fichier tmp/couteau-suisse/mes_spip_options.php.</p> <p>- <strong> <i>Requêtes externes</i> </strong> : d'une part, le Couteau Suisse vérifie régulièrement l'existence d'une version plus récente de son code et informe sur sa page de configuration d'une mise à jour éventuellement disponible. D'autre part, ce plugin comporte certains outils qui peuvent nécessiter d'importer des librairies distantes.</p> <p>Si les requêtes externes de votre serveur posent des problèmes ou par souci d'une meilleure sécurité, cochez ces options:</p> <p>- <i>Les vérifications de versions distantes</p> <p>- <i>Les outils du Couteau Suisse ayant des fichiers distants</i></p> </td></tr> </tbody> </table> <p>J'espère que la liste pourra s'allonger et gagner en qualité. Cette contrib faite pour vous. N'hésitez pas à l'alimenter : les idées lumineuses et les documentations détaillées sont toujours les bienvenues. Il est par exemple possible de réunir ici la gestion de toutes les variables ou définitions prévues pour mes_options.php ou mes_fonctions.php.</p> <p>Je me suis permis de rassembler toutes ces petites contributions en un seul plugin parce qu'elles ont très peu de lignes de code, qu'elles ne manipulent par exemple que le fichier mes_options.php, ou alors n'utilisent qu'un seul pipeline. Bien sûr le <i>Couteau Suisse</i> accepte les fonctionnalités «multi-pipeline» et «multi-traitement», mais son but reste de réunir toutes les «petites» améliorations de SPIP qui ne sont pas strictement nécessaires mais bien utiles au plus grand nombre.</p> <p>Merci à la communauté SPIP ainsi qu'aux différents auteurs et contributeurs (sans ordre) : Vincent Ramos, Maïeul Rouquette, Fil, Arnaud Ventre, Joseph Larmarange, Cédric Morin, Pierre Andrews (Mortimer), IZO, Phil, Jérôme Combaz, Bertrand Marne, Romy Têtue, Aurélien Pierard, FredoMkb, Sylvain, BoOz, Alexis Roussel, Paolo, Pat, Yohann(potter64), Nicolas Hoizey, Piero Wbmstr, etc.</p> <p><a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a></p> <h2 class="h2" id='Particularite-du-lt'><a id="particul"></a>Particularité du «mode impression»<a class='sommaire-back sommaire-back-9' href='#s-Particularite-du-lt' title='Back to the table of contents'></a></h2> <p>Le Couteau Suisse offre un mode utile pour l'impression en plaçant le paramètre “cs=print” dans le lien d'appel de la page. Ce mode est automatiquement activé si les squelettes “print.html”, “imprimer.html”, “imprimir_articulo.html”, “imprimir_breve.html” ou “article_pdf.html” sont utilisés (donc ici : “page=print”, “page=imprimer”, etc.).</p> <p>Exemples d'appel : <br />- Dans un navigateur : <code class='spip_code spip_code_inline' dir='ltr'>www.monsite.ici/spip?article999&cs=print</code>. <br />- Dans un squelette : <code class='spip_code spip_code_inline' dir='ltr'>[(#SELF|parametre_url{cs,print})]</code> <br />- En PHP : <code class='spip_code spip_code_inline' dir='ltr'>parametre_url(self(), 'cs', 'print')</code></p> <p>En mode impression, quatre outils réagissent actuellement : <br />- Découpe en page : l'article est imprimé en intégralité sans découpage (juste un filet discret entre les pages), tout comme les onglets, représentés dans un léger cadre pointillé. <br />- Sommaire automatique : les ancres ne sont pas placées sur les intertitres. <br />- Liens en clair : les liens invisibles (liens externes ou mails) sont affichés entre crochets. <br />- Glossaire interne : les mots trouvés sont mis en valeur, mais les fenêtres apparaissant au survol ne sont pas insérées dans le code.</p> <p>Comme vous pouvez le voir trois paragraphes plus haut, un système de compatibilité a été instauré avec les plugins <a href='https://contrib.spip.net/Plugin-version-imprimable' class="spip_in" hreflang="fr">Imprimir Documento</a> et <a href='https://contrib.spip.net/Article-PDF-2226' class="spip_in" hreflang="fr">Article PDF</a>.</p> <p><strong>Attention</strong> : Si votre fichier article.html utilise une balise INCLURE pour traiter le corps de l'article, pensez bien à transmettre les paramètres du Couteau Suisse au fond inclus, sous peine de voir le cache dysfonctionner. En effet, SPIP ne transmettant pas automatiquement les parametres d'url aux fonds inclus, le cache sera le même quelque soit la valeur du paramètre 'cs'.</p> <p>Voici un exemple d'inclusion que l'on peut faire dans le fichier article.html. Il transmet deux paramètres du Couteau Suisse : 'artpage' pour la découpe en page des articles et 'cs' pour avoir accès au mode impression du plugin.</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#REM) Contenu principal : contenu de l'article ] <INCLURE{fond=inc-corps-article}{id_article=#ID_ARTICLE}{artpage=#ENV{artpage,1}}{cs=#ENV{cs}}></code></pre></div> <p><a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a></p> <h2 class="h2" id='Installation-du-Couteau-Suisse'><a id="install"></a>Installation du Couteau Suisse<a class='sommaire-back sommaire-back-9' href='#s-Installation-du-Couteau-Suisse' title='Back to the table of contents'></a></h2> <p>- Téléchargement : <a href="https://files.spip.net/spip-zone/couteau_suisse.zip" class="spip_out" rel="external">sur la zone</a><span class="spip_note_ref"> [<a href="#nb3-2" class="spip_note" rel="appendix" title="Téléchargement du Plugin, liens complémentaires : Récupérer le zip sur (…)" id="nh3-2">2</a>]</span> <br />- Installation : comme tous les autres plugins. Voir : <a href="https://www.spip.net/fr_article3396.html" class="spip_url spip_out" rel="external">https://www.spip.net/fr_article3396.html</a> <br />- Configuration : rendez vous sur la page d'administration du plugin en cliquant sur l'icône «Configuration», puis sur l'onglet «Le Couteau Suisse». Vous arrivez donc ici : <code class='spip_code spip_code_inline' dir='ltr'>ecrire/?exec=admin_couteau_suisse</code></p> <p><strong><a id="maj"></a>Mise à jour</strong></p> <p>Le fichier accessible en téléchargement ci-dessus est régulièrement mis à jour : les petits bugs sont corrigés, des améliorations y sont apportées, de nouveaux outils y sont ajoutés, etc. Il est recommandé de mettre le régulièrement à jour afin de bénéficier des dernières avancées du plugin. Notez bien qu'il faut toujours revalider la page des plugins lorsqu'on met à jour un dossier de plugin. Techniquement, cela permet entre autre de réinitialiser les pipelines et donc les procédures et fonctions utilisées. Ensuite, n'hésitez pas à consulter la page d'administration du plugin lui-même afin de vérifiez vos précédentes options et considérer l'utilité des nouveaux outils éventuellement disponibles.</p> <p>Un fichier retraçant l'historique n'existe pas actuellement. Je fais appel aux courageuses bonnes volontés qui me lisent à cet instant précis pour cette tâche qui pourrait les intéresser ! Cependant, il vous est possible de consulter les logs de développement (<a href="http://trac.rezo.net/trac/spip-zone/log/_plugins_/couteau_suisse" class="spip_url spip_out" rel="external">http://trac.rezo.net/trac/spip-zone...</a> ou <a href='https://contrib.spip.net/spip.php?page=site&id_syndic=174'>site 174</a>), ou directement sur la page de configuration du plugin, après avoir activé l'outil : «Les révisions du Couteau Suisse». Le plugin est en effet développé grâce au système de suivi des version «SVN»<span class="spip_note_ref"> [<a href="#nb3-3" class="spip_note" rel="appendix" title="http://trac.rezo.net/trac/spip-zone/" id="nh3-3">3</a>]</span>. Je cite à ce sujet Alexandra<span class="spip_note_ref"> [<a href="#nb3-4" class="spip_note" rel="appendix" title="Article : http://zine.spip.org/spip.php?article44" id="nh3-4">4</a>]</span> :</p> <blockquote class="spip"> <p><i>La fonction principale d'un système de suivi de versions est de permettre l'édition collaborative et le partage de données. C'est grâce à cet outil que bien des œuvres, des plugins et choses diverses se développent sur spip-zone, où tout le monde peut déposer son bout de code, récuper celui d'un autre, améliorer tel projet commencé, sans que cela ne crée de conflits liés à des modifications simultanées.</p> <p>Toutes les modifications sont enregistrées sur un serveur unique. Celles-ci sont alors gérées localement sur chaque poste utilisateur par un programme spécifique, qui s'assure que les modifications faites localement ne sont pas incompatibles avec la dernière version en ligne. Il permet aussi à chacun d'effectuer des mises à jour rapides en ne récupérant que les éléments modifiés.</i></p> </blockquote> <p>Pour mettre à jour le plugin, la procédure <strong>par FTP</strong> s'exécute en quatre points :</p> <ol class="spip" role="list"><li> Supprimez tous les fichiers du dossier <code class='spip_code spip_code_inline' dir='ltr'>plugins/couteau_suisse/</code></li><li> Transférez-y les nouveaux fichiers téléchargés <a href="https://files.spip.net/spip-zone/couteau_suisse.zip" class="spip_out" rel="external">sur la zone</a></li><li> Rendez-vous sur la page de gestion des plugins (ou procédez à son réaffichage) : <code class='spip_code spip_code_inline' dir='ltr'>ecrire/?exec=admin_plugin</code></li><li> Rendez-vous sur la page de gestion du Couteau Suisse (ou procédez à son réaffichage) : <code class='spip_code spip_code_inline' dir='ltr'>ecrire/?exec=admin_couteau_suisse</code></li></ol> <p><strong>Mise à jour automatique en un clic</strong> : voir le paragraphe “Compatibilité avec les squelettes ou d'autres plugins” ci-dessous.</p> <p><strong>Outil «Mises à jour automatiques»</strong> : Voir l'article «<a href='https://contrib.spip.net/Mise-a-jour-automatique-des-plugins' class="spip_in" hreflang="fr">Mise à jour automatique des plugins</a>».</p> <p><strong><a id="urgence"></a>Procédure d'urgence</strong></p> <p>Si un outil semble incompatible avec son environnement (PHP, SQL, un autre plugin, le squelette, etc.), ou si une mise à jour du Couteau Suisse provoque une erreur ou une page blanche, votre premier réflexe est de <strong>supprimer totalement le répertoire de travail (caches divers et données temporaires) du plugin : «tmp/couteau-suisse»</strong> (ou «ecrire/data/couteau-suisse» pour la version 1.91 de SPIP ). Les fichiers se reconstruiront automatiquement et souvent les problèmes se régleront d'eux mêmes. Nous nous excusons par avance de ce désagrément parfois nécessaire pour améliorer, optimiser ou consolider le fonctionnement du plugin.</p> <p>Pour le pire des cas, il existe un lien permettant de réinitialiser complètement le plugin, en désactivant l'ensemble des outils et en supprimant toutes les variables stockées dans la base de données. Voici ce lien : <code class='spip_code spip_code_inline' dir='ltr'>ecrire/?exec=admin_couteau_suisse&cmd=resetall</code></p> <p>Vous utiliserez ce lien si une page blanche surgit ou si une erreur empêche le bon fonctionnement de votre site, et cela juste après l'activation d'un outil. A l'installation du plugin, il est donc fortement conseillé d'activer les outils un par un, histoire de repérer les éventuels conflits qui pourraient survenir. le monde PHP évolue, SPIP évolue, .... On n'est jamais trop prudent !</p> <p>En principe, vous n'avez pas besoin de modifier l'état (actif ou inactif) d'une lame à la main. Mais si le cas se présentait, alors il vous faut l'identifiant de l'outil (certains sont listés ici : <a href='https://contrib.spip.net/Les-autorisations-du-Couteau#lame' class="spip_in" hreflang="fr">[dev] Les autorisations du Couteau Suisse</a>) présent dans sa description. Le lien dont vous avez besoin est celui qui est lancé lorsque vous cliquez sur «Activer» (pour un outil inactif) ou «Désactiver» (pour un outil actif).<br class='manualbr' />Voici comment par exemple basculer l'état de la lame «En Travaux» :<br class='manualbr' /><code class='spip_code spip_code_inline' dir='ltr'>ecrire/?exec=admin_couteau_suisse&cmd=switch&outil=en_travaux</code></p> <p><strong>Conseil</strong> : si le réglage du plugin vous satisfait pleinement, nous vous recommandons de sauvegarder systématiquement vos configurations en cliquant d'abord sur le lien <strong>«Configuration Actuelle»</strong> présent sur la page d'administration du Couteau Suisse, en haut à gauche. Cliquez ensuite sur le bouton «Sauver la configuration actuelle». Un <i>pack de configuration</i> sera alors déposé dans votre fichier «/config/mes_options.php» et pourra être réactivé plus tard. Plus d'information ici : <a href='https://contrib.spip.net/Le-Couteau-Suisse-a-piloter' class="spip_in" hreflang="fr">[dev] Le Couteau Suisse à piloter</a>.</p> <p>Enfin, après avoir effectué la procédure décrite dans le paragraphe “Dysfonctionnements” ci-dessous sans avoir pu l'appliquer jusqu'au bout, et si vraiment rien n'y fait, alors il suffit de renommer le répertoire <i>plugins/couteau_suisse</i> (ou <i>plugins/auto/couteau_suisse</i>) afin de désactiver le plugin dans son ensemble. Les données de configuration sont préservées dans ce cas. Puis, relancez le site avant de refaire une installation propre et complète du plugin. Il est possible que le transfert des fichiers du plugin ait été incomplet, ou que l'erreur ne venait pas du Couteau Suisse...</p> <p><strong>Quelques tests</strong></p> <p>Pour les plus curieux et avertis d'entre vous, le <i>Couteau Suisse</i> offre aussi une page de test privée (très basique et aujourd'hui un peu obsolète) accessible grâce à ce lien : <code class='spip_code spip_code_inline' dir='ltr'>ecrire/?exec=test_couteau_suisse</code></p> <p>Et dans tous les cas, le forum ci-dessous est fait pour vous pour les soucis que vous pourriez rencontrer.<br class='autobr' /> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a></p> <h2 class="h2" id='Informations-techniques'><a id="techn"></a>Informations techniques<a class='sommaire-back sommaire-back-9' href='#s-Informations-techniques' title='Back to the table of contents'></a></h2> <p>- Quelques informations techniques pour les curieux développeurs d'outils : <br class='manualbr' /><a href='https://contrib.spip.net/Le-Couteau-Suisse-pour-les' class="spip_in" hreflang="fr">[dev] Le Couteau Suisse : développer un outil</a></p> <p>- Comment piloter la configuration du Couteau Suisse, gérer des packs de configuration et lui ajouter des lames à la volée : <br class='manualbr' /><a href='https://contrib.spip.net/Le-Couteau-Suisse-a-piloter' class="spip_in" hreflang="fr">[dev] Le Couteau Suisse à piloter</a></p> <p>- Comment ne pas mettre un Couteau Suisse entre toutes les mains : <br class='manualbr' /><a href='https://contrib.spip.net/Les-autorisations-du-Couteau' class="spip_in" hreflang="fr">[dev] Les autorisations du Couteau Suisse</a></p> <p><a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a></p> <h2 class="h2" id='Compatibilite-avec-les-squelettes-ou-d-autres-plugins'><a id="compat"></a>Compatibilité avec les squelettes ou d'autres plugins<a class='sommaire-back sommaire-back-9' href='#s-Compatibilite-avec-les-squelettes-ou-d-autres-plugins' title='Back to the table of contents'></a></h2> <p>En tout premier lieu, il est déconseillé aux squelettes d'utiliser des balises étoilées (comme #TEXTE*) car elles renvoient le texte brut stocké en base de donnée sans aucun traitement possible. Hors, SPIP laisse la possibilité à un plugin ou un squelette d'appliquer un traitement sur une balise particulière afin de mieux cibler une action donnée sur un objet donné.</p> <p>Un code de ce genre (balise #TEXTE*) a été détectée dans l'ancien squelette <a href="http://www.stages.alternatives.ca/rubrique28.html" class="spip_out" rel="external">Alternatives</a> sur la page article.html. Les outils suivants, bien qu'activés, ne seront donc pas reconnus : <br />- Les découpes et onglets, Le sommaire automatique, Le Glossaire interne, Les corrections automatiques.<br class='manualbr' />Afin de remédier au problème, vous devez remplacer TOUT le code suivant :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> [<div id="sommaire"> <h4><:icone_brouteur:></h4> (#TEXTE*|sommaire_article|propre) </div>] [<div class="#EDIT{texte} texte">(#TEXTE*|decouper_en_page{#ID_ARTICLE}|propre|reduire_image{440,0})</div>]</code></pre></div> <p>par celui-ci :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> [<div class="#EDIT{texte} texte">(#TEXTE|reduire_image{440,0})</div>]</code></pre></div> <p><strong>Pour comprendre les traitements</strong>, le meilleur exemple est la suppression du numéro dans les titres. Si vous stockez un titre sous la forme “1. mon titre”, vous allez pouvoir ensuite trier vos articles en fonction du titre. Mais si vous ne voulez pas que ce numéro apparaisse sur vos pages publiques, alors deux solutions s'offrent à vous : <br />- soit vous appliquez un filtre partout : <code class='spip_code spip_code_inline' dir='ltr'>[(#TITRE|supprimer_numero)]</code> <br />- soit vous ajoutez un traitement : <code class='spip_code spip_code_inline' dir='ltr'>$table_des_traitements['TITRE'][]= 'typo(supprimer_numero(%s))';</code></p> <p>Il faut savoir qu'à ce jour, SPIP permet difficilement (à ce jour) d'agir à plusieurs sur les traitements de balises. Le code ci-dessus écrase obligatoirement le code qu'un plugin aurait pu précédemment tenter d'appliquer.<br class='manualbr' />Certains outils du Couteau Suisse risque donc d'être incompatible avec (entre autres) les plugins suivants : <br />- Table des matières, Pagination articles, Découpe en pages.<br class='manualbr' />L'outil “suppression du numéro des titres” est inutile dans les squelettes suivants (entre autres) : <br />- Alternatives, forum spipBB, multisaisons, techno_blog.</p> <p><strong>Les barres de rédaction</strong> : le Couteau Suisse est compatible avec le <a href='https://contrib.spip.net/Plugin-Barre-Typographique-V2' class="spip_in" hreflang="fr">Plugin Barre Typographique V2</a> (SPIP<span class='ressource'><2.0)></span> 3117] (SPIP>=2.0). Il insère les raccourcis de certains outils afin de faciliter le travail de vos rédacteurs. Ceci est encore en expérimentation, n'hésitez pas à nous remonter vos remarques. Pour le calcul graphique de certaines icônes, vérifiez que les fonctions GD de votre site sont bien activées (Configuration > Fonctions avancées).</p> <p><strong>Mises à jour en un clic</strong></p> <p>- Le Couteau Suisse nécessite des mises à jour régulières. Si vous êtes sous SPIP 1.92x, n'hésitez donc pas à installer le plugin “<a href='https://contrib.spip.net/Chargeur-Activateur' class="spip_in" hreflang="fr">Chargeur Activateur</a>” que le Couteau Suisse utilise pour offrir un lien de téléchargement automatique sur sa page de config.</p> <p>- Sous SPIP >= 2.x, ce plugin n'est plus nécessaire. Il vaut mieux utiliser la procédure d'installation automatique offerte par SPIP (page d'administration des plugins) en créant un dossier <code class='spip_code spip_code_inline' dir='ltr'>/plugins/auto/</code> dans votre site, et en utilisant :<br class='autobr' /> soit l'adresse directe du zip :<br class='manualbr' />- <a href="https://files.spip.net/spip-zone/couteau_suisse.zip" class="spip_url spip_out auto" rel="nofollow external">https://files.spip.net/spip-zone/couteau_suisse.zip</a><br class='manualbr' />soit une liste de plugins, comme par exemple : <br class='manualbr' />- <code class='spip_code spip_code_inline' dir='ltr'>http://files.spip.org/spip-zone/paquets.rss.xml.gz</code><br class='manualbr' />- <code class='spip_code spip_code_inline' dir='ltr'>http://plugins.spip.net/rss-+-selection-2-+</code><br class='manualbr' />Une fois installé pour la première fois, un lien de mise à jour est disponible sur la page de configuration pour répéter cette opération en un seul clic quand vous le désirerez.<br class='autobr' /> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a></p> <h2 class="h2" id='Dysfonctionnements'><a id="dysfct"></a>Dysfonctionnements<a class='sommaire-back sommaire-back-9' href='#s-Dysfonctionnements' title='Back to the table of contents'></a></h2> <p>N'hésitez pas à remonter tout type de dysfonctionnement du plugin, nous essaierons d'y répondre, dans la mesure du possible. Dans un premier temps, tentez quand même de chercher les causes de vos soucis et soyez méthodiques. Le code est gratuit et améliorable ; chacun peut apporter une pierre à l'édifice.</p> <p>Dans vos messages, soyez précis. Indiquez bien les différentes versions des éléments que vous utilisez : plugin, squelette, SPIP, PHP, etc. Pour débusquer un bug et trouver la source, il faut d'abord isoler le Couteau Suisse en désactivant les autres plugins, puis isoler l'outil défaillant. Désactiver temporairement son squelette et réutiliser le squelette source de SPIP (“dist”) peut également donner des informations utiles.</p> <p><strong>3 moyens de contact :</strong> <br />- Les listes de diffusion comme spip.zone, sur gmane.org; <br />- Le forum <a href="#forum" class="spip_ancre">ci-après</a>, histoire que tout le monde en profite; <br />- Mail direct si par hasard vous savez à qui vous adresser, mais seulement pour des données privées.</p> <p><strong>Avant toute chose, assurez-vous d'avoir :</strong> <br />- installé/réinstallé la <strong>toute dernière</strong> version de vos plugins <br />- supprimé le dossier tmp/couteau-suisse <br />- supprimé les fichiers tmp/charger_*.php <br />- validé/rechargé la page des plugins (admin_plugin) <br />- validé/rechargé la page du couteau suisse (admin_couteau_suisse) <br />- et enfin, vidé le cache de SPIP</p> <p><strong>Pour mettre les mains dans le cambouis</strong> ou <strong>glaner quelques infos</strong>, n'hésitez pas à consulter et appliquer l'excellent article de <a href='https://contrib.spip.net/Matthieu-Marcillaud' class="spip_in">Matthieu Marcillaud</a> : <a href="http://marcimat.magraine.net/Outils-de-debug" class="spip_url spip_out" rel="external">http://marcimat.magraine.net/Outils...</a>.</p> <p><strong>Lors d'une migration vers SPIP 3.0</strong>, il est possible que la page d'administration du Couteau Suisse soit désorganisée ou présente des erreurs. Essayez dans un premier temps d'ajoutez le paramètre « <code class='spip_code spip_code_inline' dir='ltr'>&var_mode=recalcul</code> » à votre URL afin de recalculer les règles de typographie.</p> <p><strong>Si cette erreur particulère survient (ou simplement une page blanche sous SPIP 1.92) :</strong> <span style="color:red"><i>Fatal error: Cannot redeclare execute_pipeline_bt_gadgets() (previously declared in /[...]/tmp/charger_pipelines.php:xxx) in /[...]/tmp/charger_pipelines.php on line xxx</i></span> : prenez soin de désactiver ou mettre à jour tous les plugins concernant la barre typographique (BT V2), puis supprimez le fichier <i>tmp/charger_pipelines.php</i>.<br class='autobr' /> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a></p> <p><strong>Si cette erreur particulère survient (ou simplement une prévisualisation impossible des messages de forum sous SPIP 2.0.9) quand les visiteurs tentent de 'Voir ce message avant de poster' :</strong> : <span style="color:red"><i>Fatal error: Call to undefined function cs_decoupe() in /[...]/squelettes-dist/formulaires/forum.php(275) : eval()'d code on line 1</i></span> :<br class='autobr' /> mettez vite à jour SPIP, version 2.0.10 minimum ! Le fichier fautif sous SPIP 2.0.9 est squelettes-dist/formulaires/forum.php. Il doit être remplacé par celui-ci : <a href="http://trac.rezo.net/trac/spip/browser/branches/spip-2.0/squelettes-dist/formulaires/forum.php" class="spip_url spip_out" rel="external">http://trac.rezo.net/trac/spip/brow...</a> (téléchargement en bas de page).</p> <h2 class="h2" id='Debats'><a id="debats"></a>Débats<a class='sommaire-back sommaire-back-9' href='#s-Debats' title='Back to the table of contents'></a></h2> <p>A ce sujet, j'ai tenté de lancer les débats suivants :</p> <p><strong>Un premier débat</strong> qui peut être lancé concerne donc la répartition entre les fonctionnalités du core et celles qui peuvent être placées dans ce plugin que l'utilisateur est libre d'installer ou non. Chaque fonctionnalité peut elle aussi être activée ou désactivée par l'utilisateur. SPIP «gonfle» de jour en jour et la souplesse introduite par les plugins peut permettre un gonflage maîtrisé...</p> <p>Par exemple, un antispam n'est peut-être pas nécessaire dans le core (utilisé aussi en intranet) mais pourrait trouver une meilleure place dans le <i>Couteau Suisse</i>.</p> <p><strong>Le second débat</strong>, c'est celui de savoir ce qu'il faut mettre dans le <i>Couteau Suisse</i> ou non ! Doit-il rassembler diverses corrections typographiques et remplacements graphiques ? Doit-il ajouter de nouvelles balises pour les squelettes ? Doit-il ajouter de nouveaux filtres pour ces balises ?</p> <p>- De ceci émerge déjà une première réponse : le <i>Couteau Suisse</i> doit pouvoir contrôler les variables «cachées» de SPIP et habituellement placées dans «mes_options.php». <br />- Ensuite et à mon sens, les remplacements et améliorations typographiques ont besoin d'un cadre sécurisant unifié. Il est déjà apporté par exemple par les fonctions «monoutil_installe()» et «cs_echappe_balises()» ou les paramètres «version-min» ou «version-max». <br />- De même, la compilation des traitements favorise un ciblage plus précis des actions sur les différents textes de SPIP. <br />- Enfin, le <i>Couteau Suisse</i> doit également pouvoir assurer une compatibilité sans faille entre tous les outils et avec les différentes versions de SPIP.</p> <p>Qu'en pensez-vous?<br class='autobr' /> <a class="retour_top" href="#outil_sommaire" title="Retour au sommaire"></a></p> <h2 class="h2" id='Wiki'><a id="wiki"></a>Wiki<a class='sommaire-back sommaire-back-9' href='#s-Wiki' title='Back to the table of contents'></a></h2> <p><a href='https://contrib.spip.net/YannX' class="spip_in">YannX</a> a ouvert pour tous les utilisateurs du Couteau Suisse un carnet Wiki où tout le monde peut déposer ses idées et suggestions. N'hésitez pas, c'est par ici : <a href='https://contrib.spip.net/Carnet-Plugin_Couteau_Suisse' class="spip_in" hreflang="fr">Carnet Plugin_Couteau_Suisse</a>.</p></div> <hr /> <div class='rss_notes'><div id="nb3-1"> <p><span class="spip_note_ref">[<a href="#nh3-1" class="spip_note" title="Footnotes 3-1" rev="appendix">1</a>] </span>N'hésitez pas à nous faire part du résultat de vos tests</p> </div><div id="nb3-2"> <p><span class="spip_note_ref">[<a href="#nh3-2" class="spip_note" title="Footnotes 3-2" rev="appendix">2</a>] </span><strong>Téléchargement du Plugin, liens complémentaires</strong> : Récupérer le zip sur l'espace de téléchargement, ou le(s) miroir(s), de spip-zone, cf. rubrique <a href="http://zone.spip.org/trac/spip-zone/#Produitsfinis" class="spip_out" rel="external">Produits finis</a></p> </div><div id="nb3-3"> <p><span class="spip_note_ref">[<a href="#nh3-3" class="spip_note" title="Footnotes 3-3" rev="appendix">3</a>] </span><a href="http://trac.rezo.net/trac/spip-zone/" class="spip_url spip_out" rel="external">http://trac.rezo.net/trac/spip-zone/</a></p> </div><div id="nb3-4"> <p><span class="spip_note_ref">[<a href="#nh3-4" class="spip_note" title="Footnotes 3-4" rev="appendix">4</a>] </span>Article : <a href="http://zine.spip.org/spip.php?article44" class="spip_url spip_out" rel="external">http://zine.spip.org/spip.php?article44</a></p> </div></div> <div class='rss_ps'><p>- Le logo de cet article a été créé par Kavel : <a href="http://www.armatronic.com/" class="spip_url spip_out" rel="external">http://www.armatronic.com/</a></p> <p>- La version du Couteau Suisse pour SPIP v1.91 du plugin a été conservée ici : <a href="https://files.spip.net/grenier/couteau_suisse_191.zip" class="spip_url spip_out" rel="external">https://files.spip.net/grenier/cout...</a></p></div> </article> <article> <h1>Le plugin noiZetier version 1</h1> <p>Joseph — 2010-06-21T09:43:06Z</p> <div class='rss_chapo'><p>Le noiZetier offre une interface d'administration permettant d'insérer au choix des éléments modulaires de squelettes (noisettes) et de les ajouter ainsi à ses squelettes.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d1492cf116.13662647"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Principe-general-du-noiZetier"></a><a href="#Principe-general-du-noiZetier" class="spip_ancre">Principe général du noiZetier</a></li><li> <a id="s-Installation-et-dependances"></a><a href="#Installation-et-dependances" class="spip_ancre">Installation et dépendances</a></li><li> <a id="s-Ajouter-des-noisettes-a-un-bloc"></a><a href="#Ajouter-des-noisettes-a-un-bloc" class="spip_ancre">Ajouter des noisettes à un bloc</a></li><li> <a id="s-Pour-aller-plus-loin"></a><a href="#Pour-aller-plus-loin" class="spip_ancre">Pour aller plus loin</a></li></ul></div><h2 class="h2" id='Principe-general-du-noiZetier'>Principe général du noiZetier<a class='sommaire-back sommaire-back-4' href='#s-Principe-general-du-noiZetier' title='Back to the table of contents'></a></h2> <p>Le noiZetier fournit une interface dans l'espace privé permettant de choisir, pour chaque page, des noisettes à ajouter aux blocs <i>contenu</i>, <i>navigation</i> et <i>extra</i><span class="spip_note_ref"> [<a href="#nb4-1" class="spip_note" rel="appendix" title="Il s'agit des blocs par défaut lors d'une utilisation conjointe avec Zpip. (…)" id="nh4-1">1</a>]</span> de chaque page. Les noisettes viennent ainsi compléter les contenus par défaut prévus par le squelette.</p> <p>Ces noisettes sont déclarées dans un sous-répertoire <code class='spip_code spip_code_inline' dir='ltr'>noisettes/</code>. Elles peuvent être fournies par un plugin, un squelette ou être placées dans le répertoire <code class='spip_code spip_code_inline' dir='ltr'>squelettes</code> du site.</p> <p>Le noiZetier est nativement fonctionnel avec le squelette <a href='https://contrib.spip.net/Le-Squelette-Zpip' class="spip_in" hreflang="fr">Zpip-dist</a> et les squelettes basés sur ce dernier. Il peut être utilisé avec d'autres squelettes si ces derniers le prévoient (voir <a href='https://contrib.spip.net/Adapter-un-squelette-pour-etre-compatible-avec-le' class="spip_in" hreflang="fr">Adapter un squelette pour être compatible avec le noiZetier</a>).</p> <p>Pour gérer l'ensemble des contenus du site sous formes de noisettes voir <a href='https://contrib.spip.net/Aveline-collection-de-noisettes-Z' class="spip_in" hreflang="fr">Aveline v1 : collection de noisettes Z</a>.</p> <h2 class="h2" id='Installation-et-dependances'>Installation et dépendances<a class='sommaire-back sommaire-back-4' href='#s-Installation-et-dependances' title='Back to the table of contents'></a></h2> <p>Le plugin noiZetier s'installe comme tous les autres plugins (voir la <a href="http://www.spip.net/fr_article3396.html" class="spip_out" rel="external">doc en ligne</a>). Pour fonctionner, il nécessite SPIP en version 2.1 minimum et le plugin <a href='https://contrib.spip.net/SPIP-Bonux' class="spip_in" hreflang="fr">SPIP Bonux</a>.</p> <p>À partir de la version 0.8 du noiZetier, les plugins <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">Saisies</a>, <a href="http://files.spip.org/spip-zone/yaml.zip" class="spip_out" rel="external">YAML</a>, <a href="http://files.spip.org/spip-zone/verifier.zip" class="spip_out" rel="external">Vérifier</a> sont nécessaires au fonctionnement du noiZetier.</p> <p>À partir le version 0.9, le plugin <a href='https://contrib.spip.net/jQuery-UI-pour-SPIP' class="spip_in" hreflang="fr">jQuery UI pour SPIP </a> est également requis. Il permet le drag n drop pour définir l'ordre des noisettes.</p> <p>Le noiZetier est développé sur SPIP-Zone. De fait, vous pouvez le récupérer via SVN ou bien télécharger la dernière version sous forme de <a href="http://files.spip.org/spip-zone/noiZetier.zip" class="spip_out" rel="external">fichier Zip</a>.</p> <p>Le plugin <a href='https://contrib.spip.net/Compositions-1' class="spip_in" hreflang="fr">Compositions</a> n'est pas indispensable mais est fortement recommandé.</p> <p>- Le plugin Saisies permet de rendre les formulaires de configuration des noisettes plus ergonomiques (adaptation du type de saisie pour chaque paramètre).</p> <p>- Le plugin Vérifier est utilisé pour vérifier la valeur des entrées saisies au besoin.</p> <p>- Le plugin YAML permet <a href='https://contrib.spip.net/Exporter-et-importer-une-configuration-du-noiZetier' class="spip_in" hreflang="fr">d'exporter et d'importer une configuration</a> particulière du noiZetier mais également de pouvoir profiter de noisettes complexes décrites par un fichier YAML au lieu d'un fichier XML (voir <a href='https://contrib.spip.net/Declarer-des-noisettes-au-noiZetier' class="spip_in" hreflang="fr">Déclarer des noisettes au noiZetier</a>).</p> <p>- Enfin, le plugin <a href='https://contrib.spip.net/Compositions-1' class="spip_in" hreflang="fr">Compositions</a> permet de configurer des <a href='https://contrib.spip.net/Les-compositions-du-noiZetier' class="spip_in" hreflang="fr">compositions du noiZetier</a>.</p> <h2 class="h2" id='Ajouter-des-noisettes-a-un-bloc'>Ajouter des noisettes à un bloc<a class='sommaire-back sommaire-back-4' href='#s-Ajouter-des-noisettes-a-un-bloc' title='Back to the table of contents'></a></h2> <p>Par défaut, seuls les webmasters du site ont les droits suffisants pour configurer le noiZetier.</p> <p>Une fois le plugin installé, l'accès au noiZetier se fait via le menu <i>Configuration</i>.</p> <div class='spip_document_8274 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Ce bouton vous emmène sur la page principale du noiZetier. Cette dernière liste les pages de votre site web pouvant recevoir des noisettes. Pour chacune, un lien <strong>Configurer les noisettes de cette page</strong> vous permet d'accéder à la gestion des noisettes de cette page.</p> <p>Si les plugins YAML et/ou Compositions sont activés, des options supplémentaires sont disponibles en haut à gauche.</p> <div class='spip_document_8275 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Les différents blocs de la page sont présentés les uns au-dessous des autres.</p> <div class='spip_document_8279 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Pour ajouter une noisette, cliquez sur le bouton <strong>Ajouter une noisette</strong> et choisissez une noisette parmi celles disponibles.</p> <div class='spip_document_8277 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Renseignez les différents paramètres de la noisette et valider.</p> <div class='spip_document_8278 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Les différentes noisettes configurées pour un bloc apparaissent dans leur ordre d'inclusion avec leurs paramètres.</p> <div class='spip_document_8276 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Pour modifier les paramètres d'une noisette, supprimer une noisette ou modifier l'ordre d'inclusion des noisettes, passer la souris sur le nom de la noisette pour faire apparaître les boutons de modification.</p> <div class='spip_document_8280 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Pour-aller-plus-loin'>Pour aller plus loin<a class='sommaire-back sommaire-back-4' href='#s-Pour-aller-plus-loin' title='Back to the table of contents'></a></h2><ul class="spip" role="list"><li> <a href='https://contrib.spip.net/Les-compositions-du-noiZetier' class="spip_in" hreflang="fr">Les compositions du noiZetier</a></li><li> <a href='https://contrib.spip.net/Exporter-et-importer-une-configuration-du-noiZetier' class="spip_in" hreflang="fr">Exporter et importer une configuration du noiZetier</a></li><li> <a href='https://contrib.spip.net/Declarer-des-noisettes-au-noiZetier' class="spip_in" hreflang="fr">Déclarer des noisettes au noiZetier</a></li><li> <a href='https://contrib.spip.net/Fonctionnement-par-defaut-du-noiZetier' class="spip_in" hreflang="fr">Fonctionnement par défaut du noiZetier</a></li><li> <a href='https://contrib.spip.net/Adapter-un-squelette-pour-etre-compatible-avec-le' class="spip_in" hreflang="fr">Adapter un squelette pour être compatible avec le noiZetier</a></li></ul></div> <hr /> <div class='rss_notes'><div id="nb4-1"> <p><span class="spip_note_ref">[<a href="#nh4-1" class="spip_note" title="Footnotes 4-1" rev="appendix">1</a>] </span>Il s'agit des blocs par défaut lors d'une utilisation conjointe avec Zpip. Le nombre et les noms des blocs peuvent différer selon le squelette.</p> </div></div> </article> <article> <h1>noiZetier v2</h1> <p>Joseph — 2012-11-09T12:22:36Z</p> <div class='rss_chapo'><p>Le noiZetier offre une interface d'administration permettant d'insérer au choix des éléments modulaires de squelettes (noisettes) et de les ajouter ainsi à ses squelettes.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d149355061.12068214"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Compatibilite"></a><a href="#Compatibilite" class="spip_ancre">Compatibilité</a></li><li> <a id="s-Nouvelle-interface"></a><a href="#Nouvelle-interface" class="spip_ancre">Nouvelle interface</a></li><li> <a id="s-Edition-des-noisettes-depuis-l-espace-public"></a><a href="#Edition-des-noisettes-depuis-l-espace-public" class="spip_ancre">Édition des noisettes depuis l'espace public</a></li><li> <a id="s-Apercus-des-noisettes-dans-l-espace-prive"></a><a href="#Apercus-des-noisettes-dans-l-espace-prive" class="spip_ancre">Aperçus des noisettes dans l'espace privé</a></li></ul></div><h2 class="h2" id='Compatibilite'>Compatibilité<a class='sommaire-back sommaire-back-4' href='#s-Compatibilite' title='Back to the table of contents'></a></h2> <p>La version 2 du noizetier fonctionne sous SPIP 3.</p> <p>Le Noizetier 2 est compatible uniquement avec la version 1 du squelette <a href='https://contrib.spip.net/Le-Squelette-Zpip' class="spip_in" hreflang="fr">Zpip</a><span class="spip_note_ref"> [<a href="#nb5-1" class="spip_note" rel="appendix" title="La version 2 de Zpip est toujours en cours de développement et sa structure (…)" id="nh5-1">1</a>]</span>.</p> <p>Pour un espace public entièrement configuré à partir de noisettes, il est conseillé d'utiliser les versions 2 de <a href='https://contrib.spip.net/Zpip-vide-v2' class="spip_in" hreflang="fr">Zpip-vide</a> et d'<a href='https://contrib.spip.net/Aveline-v2' class="spip_in" hreflang="fr">Aveline</a>.</p> <p>La version 2 du noizetier peut être utilisée conjointement avec la version 3 du plugin <a href='https://contrib.spip.net/Compositions-2-et-superieur' class="spip_in" hreflang="fr">Compositions</a> et la version 1 de l'<a href='https://contrib.spip.net/Importeur-Exporteur-de-configurations' class="spip_in" hreflang="fr">Importeur / Exporteur de configurations</a>.</p> <h2 class="h2" id='Nouvelle-interface'>Nouvelle interface<a class='sommaire-back sommaire-back-4' href='#s-Nouvelle-interface' title='Back to the table of contents'></a></h2> <p>À l'occasion de cette version 2, le noizetier se dote d'une nouvelle interface, entièrement repensée.</p> <p>Le noizetier est accessible via l'entrée</p> <div class='spip_document_11189 spip_document spip_documents spip_document_image spip_documents_center spip_document_center inline'> <figure class="spip_doc_inner"> </figure> </div> <p><i>Gérer les noisettes</i> dans le menu <i>Squelettes</i>.</p> <div class='spip_document_11191 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="17" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_noizetier_liste_pages.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11191 '><strong>Liste des pages</strong></div> </figcaption></figure> </div> <p>L'icône</p> <div class='spip_document_11192 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>permet de créer une <a href='https://contrib.spip.net/Les-compositions-du-noiZetier' class="spip_in" hreflang="fr">nouvelle page / composition du noizetier</a>.</p> <p>En cliquant sur le nom d'une page, vous afficherez les noisettes de cette dernière.</p> <div class='spip_document_11190 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="42" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_noizetier_page_article.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11190 '><strong>Gestion des noisettes de la page article</strong></div> </figcaption></figure> </div> <p>Les noisettes peuvent être déplacées et réordonnées, y compris d'un bloc à l'autre, par simple glisser/déposer. Des noisettes peuvent également être ajoutées, par glisser/déposer, depuis la liste des noisettes disponibles affichée dans la colonne de gauche.</p> <p>Au survol d'une noisette, apparaissent les icônes permettant de déplacer, supprimer ou éditer la noisette.</p> <h2 class="h2" id='Edition-des-noisettes-depuis-l-espace-public'>Édition des noisettes depuis l'espace public<a class='sommaire-back sommaire-back-4' href='#s-Edition-des-noisettes-depuis-l-espace-public' title='Back to the table of contents'></a></h2> <p>Vous pouvez dorénavant éditer/ajouter/modifier/supprimer les noisettes directement depuis l'espace public. À condition que vous soyez identifié et que ayez les droits requis, vous pouvez ajouter <code class='spip_code spip_code_inline' dir='ltr'>&voir=noisettes</code> à l'URL d'une page publique pour voir les différentes noisettes installées. Ces dernières peuvent même être déplacées par glisser/déposer si javascript est activé.</p> <p>Si vous avez activé le cookie de correspondance, vous pouvez passer en mode <code class='spip_code spip_code_inline' dir='ltr'>voir=noisettes</code> via un lien dédié, ou en cliquant sur l'icône</p> <div class='spip_document_11193 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>si vous utilisez le <a href='https://contrib.spip.net/MiniBando' class="spip_in" hreflang="fr">minibando</a>.</p> <div class='spip_document_11194 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="47" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_mode_voir_noisettes.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11194 '><strong>Éditions des noisettes depuis l'espace public</strong></div> </figcaption></figure> </div><h2 class="h2" id='Apercus-des-noisettes-dans-l-espace-prive'>Aperçus des noisettes dans l'espace privé<a class='sommaire-back sommaire-back-4' href='#s-Apercus-des-noisettes-dans-l-espace-prive' title='Back to the table of contents'></a></h2> <p>Il est possible de définir un aperçu de la noisette qui sera utilisé dans l'espace privé. Voir <a href='https://contrib.spip.net/Declarer-des-noisettes-au-noiZetier' class="spip_in" hreflang="fr">Déclarer des noisettes au noiZetier</a>.</p></div> <hr /> <div class='rss_notes'><div id="nb5-1"> <p><span class="spip_note_ref">[<a href="#nh5-1" class="spip_note" title="Footnotes 5-1" rev="appendix">1</a>] </span>La version 2 de Zpip est toujours en cours de développement et sa structure n'est pas encore figée. La version 2 du noizetier est incompatible avec cette version 2 de Zpip, de même qu'avec Z-core. Lorsque ces deux derniers plugins seront en voie de stabilisation, une nouvelle version du noizetier sera développée.</p> </div></div> </article> <article> <h1>Saisies</h1> <p>Maïeul, RastaPopoulos — 2010-03-27T15:32:31Z</p> <div class='rss_chapo'><p>Le plugin Saisies facilite le développement des formulaires, en proposant des méthodes et outils pour déclarer et vérifier les champs.</p></div> <div class='rss_texte'><h2 class="h2" id='Introduction'>Introduction<a class='sommaire-back sommaire-back-12' href='#s-Introduction' title='Back to the table of contents'></a></h2> <p>Créer un formulaire est une tâche toujours un peu répétitive : les champs ont souvent les mêmes propriétés, le même accompagnement (message d'erreur, explication ...) et la même structure HTML. Ce plugin est un outil d'aide au développement, ayant pour but de faciliter et d'accélérer l'écriture des formulaires.</p> <p>Pour cela, Saisies propose plusieurs mécanismes (balises, API PHP) pour générer et manipuler plus facilement les champs des formulaires. De cette manière, les squelettes de formulaires sont :</p> <ul class="spip" role="list"><li> plus lisibles : il n'y a que le strict nécessaire dedans, pas de répétition ;</li><li> intégrés au <a href="https://programmer.spip.net/-Formulaires-35-" class="spip_out" rel="external">fonctionnement CVT de SPIP</a>, notamment pour la gestion des erreurs sur les champs ;</li><li> automatiquement compatibles avec les recommandations HTML/CSS de SPIP.</li></ul> <p>Dans la présente documentation, nous présentons la manière de construire un formulaire avec Saisies de la méthode la plus robuste à la méthode la moins robuste.</p> <p>Les méthodes moins robustes sont présentées pour deux raisons :</p> <ol class="spip" role="list"><li> ce sont les méthodes les plus anciennes. On trouve encore beaucoup de code les utilisant ;</li><li> il est parfois nécessaire de passer par là, pour des réglages fins.</li></ol> <p><strong>Pour utiliser l'API complète PHP, vous devez installer ou nécessiter le plugin YAML dans votre plugin.</strong> Ce n'est pas le cas quand on utilise juste la simple balise, ce pourquoi c'est à vous de le nécessiter.</p> <p>Dans la présente documentation, lorsqu'un code est entre chevrons (comme <code class='spip_code spip_code_inline' dir='ltr'><ceci></code>), vous devez le remplacer par une valeur correspondant à votre projet.</p> <p>Cette documentation est valable à partir de la version 6.3.0 ou du plugin.</p> <div class="well nav-sommaire nav-sommaire-12" id="nav6a60d1493bcf20.70869489"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Introduction"></a><a href="#Introduction" class="spip_ancre">Introduction</a></li><li> <a id="s-Methode-1-declarer-un-formulaire-CVT-complet-en-PHP"></a><a href="#Methode-1-declarer-un-formulaire-CVT-complet-en-PHP" class="spip_ancre">Méthode 1 : déclarer un formulaire CVT complet en PHP</a> <ul class="spip" role="list"><li> <a id="s-Principe"></a><a href="#Principe" class="spip_ancre">Principe</a></li><li> <a id="s-Mise-en-oeuvre"></a><a href="#Mise-en-oeuvre" class="spip_ancre">Mise en œuvre</a></li><li> <a id="s-Pipeline"></a><a href="#Pipeline" class="spip_ancre">Pipeline</a></li></ul></li><li> <a id="s-Methode-1a-declarer-un-formulaire-CVT-en-PHP-mais-effectuer-soi-meme-des-nbsp"></a><a href="#Methode-1a-declarer-un-formulaire-CVT-en-PHP-mais-effectuer-soi-meme-des-nbsp" class="spip_ancre">Méthode 1a : déclarer un formulaire CVT en PHP, mais effectuer soi-même des vérifications</a></li><li> <a id="s-Methode-1b-avec-controler-la-structure-globale-du-formulaire-mais-nbsp"></a><a href="#Methode-1b-avec-controler-la-structure-globale-du-formulaire-mais-nbsp" class="spip_ancre">Méthode 1b avec <code class='spip_code spip_code_inline' dir='ltr'>#GENERER_SAISIES</code> : contrôler la structure globale du formulaire, mais utiliser le formalisme de saisies</a></li><li> <a id="s-Methode-2-la-balise"></a><a href="#Methode-2-la-balise" class="spip_ancre">Méthode 2 : la balise <code class='spip_code spip_code_inline' dir='ltr'>#SAISIE</code></a></li><li> <a id="s-Appendice-1-chargement-des-CSS-et-scripts-Javascript-sur-le-site-public"></a><a href="#Appendice-1-chargement-des-CSS-et-scripts-Javascript-sur-le-site-public" class="spip_ancre">Appendice 1 : chargement des CSS et scripts Javascript sur le site public</a></li><li> <a id="s-Appendice-2-enregistrer-des-tableaux"></a><a href="#Appendice-2-enregistrer-des-tableaux" class="spip_ancre">Appendice 2 : enregistrer des tableaux</a></li><li> <a id="s-Appendice-3-la-balise"></a><a href="#Appendice-3-la-balise" class="spip_ancre">Appendice 3 : la balise <code class='spip_code spip_code_inline' dir='ltr'>#VOIR_SAISIES</code></a></li><li> <a id="s-Appendice-4-probleme-avec-Xdebug"></a><a href="#Appendice-4-probleme-avec-Xdebug" class="spip_ancre">Appendice 4 : problème avec Xdebug</a></li></ul></div> <h2 class="h2" id='Methode-1-declarer-un-formulaire-CVT-complet-en-PHP'>Méthode 1 : <a id="declarationPHP"></a>déclarer un formulaire CVT complet en PHP<a class='sommaire-back sommaire-back-12' href='#s-Methode-1-declarer-un-formulaire-CVT-complet-en-PHP' title='Back to the table of contents'></a></h2><h3 class="h3" id='Principe'>Principe<a class='sommaire-back sommaire-back-12' href='#s-Principe' title='Back to the table of contents'></a></h3> <p>Saisies augmente l'API CVT de SPIP avec une fonction <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_saisies()</code> afin de déclarer l'ensemble des champs d'un formulaire et leur vérification dans une unique syntaxe. Cette fonction permet également de déclarer différents réglages de formulaire, tel que :</p> <ul class="spip" role="list"><li> le label du bouton de validation final;</li><li> l'utilisation en multiétapes.</li></ul> <p>Grâce à ce mécanisme, pour les cas les plus courants, les fonctions <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_charger()</code> et <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_verifier()</code> deviennent facultatives. Saisies s'occupera de tout suivant votre déclaration. Seule la fonction <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_traiter()</code> reste toujours de votre ressort.</p> <p>De même, par défaut, vous n'avez plus à vous occuper du squelette. Il doit toujours être présent, avec le même nom que votre fichier PHP dans le dossier <code class='spip_code spip_code_inline' dir='ltr'>formulaires/</code>, mais vous devez le laisser <strong>totalement</strong> vide. Saisies s'occupera de générer le HTML complet, en suivant les recommandations de structuration de SPIP.</p> <p>Enfin, dans le cas particulier où vous créez un formulaire de configuration, vous n'aurez même pas à déclarer les valeurs par défaut ni le traitement. Voir l'article “<a href='https://contrib.spip.net/Formulaire-de-configuration-avec-le-plugin-Saisies' class="spip_in" hreflang="fr">Formulaire de configuration avec le plugin Saisies</a>”.</p> <h3 class="h3" id='Mise-en-oeuvre'>Mise en œuvre<a class='sommaire-back sommaire-back-12' href='#s-Mise-en-oeuvre' title='Back to the table of contents'></a></h3> <p>Il vous faut donc créer un fichier <code class='spip_code spip_code_inline' dir='ltr'>formulaires/<nomduformulaire>.html</code> vide, ainsi qu'un fichier <code class='spip_code spip_code_inline' dir='ltr'>formulaires/<nomduformulaire>.php</code> contenant deux fonctions :<br class='autobr' /> - <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_traiter()</code>, qui indique ce que votre formulaire doit effectuer comme traitement ; cela n'est pas du ressort du plugin Saisies;<br class='autobr' /> - <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_saisies()</code>, pour déclarer les saisies proprement dites.</p> <p>Cette dernière fonction reçoit comme arguments les mêmes arguments que la fonction <code class='spip_code spip_code_inline' dir='ltr'>_charger()</code> du formulaire CVT, et elle doit retourner un tableau PHP contenant la liste de toutes vos saisies suivant un formalisme attendu.</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>formulaires_<nomduformulaire>_saisies(…) { $saisies = […]; return $saisies; }</code></pre></div><h4 class="h4">Déclaration de l'ensemble des saisies</h4> <p>Chaque ligne globale du tableau renvoyé décrit une saisie.<br class='autobr' /> L'ordre des éléments sera l'ordre des saisies.<br class='manualbr' /></p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>$saisies = [ […], // une saisie […], // une saisie […], // une saisie ];</code></pre></div><h4 class="h4">Déclaration d'une saisie individuelle</h4> <p>Chaque saisie est elle-même décrite dans un tableau, qui prend par exemple la forme suivante :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>[ 'saisie' => 'input', 'options' => [ 'nom' => 'nom', 'label' => 'Votre nom', 'defaut' => 'Valeur par défaut' ], ];</code></pre></div> <p>On consultera “<a href='https://contrib.spip.net/Reference-des-saisies' class="spip_in" hreflang="fr">Référence des saisies</a>” pour avoir l'ensemble des saisies et des options disponibles en standard.</p> <p>D'autres plugins ajoutent leurs propres saisies, et vous pouvez aussi <a href='https://contrib.spip.net/Creer-ses-propres-saisies' class="spip_in" hreflang="fr">créer vos propres saisies</a>.</p> <h4 class="h4">Déclaration des saisies enfants</h4> <p> Les saisies qui acceptent des enfants (comme les fieldsets) les placent dans une clé <code class='spip_code spip_code_inline' dir='ltr'>saisies</code> dont la valeur est un tableau ayant la même structure que le tableau global : <br class='manualbr' /></p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>$un_fieldset = [ 'saisie' => 'fieldset', 'options' => [ 'nom' => 'mon_groupe', 'label' => 'Mon groupe de champ' ], 'saisies' => [ […], // une autre saisie […], // une autre saisie […], // etc ] ];</code></pre></div><h4 class="h4"> Appliquer des vérifications </h4> <p>Pour des vérifications simples et uniques vous pouvez en déclarer des vérifications à appliquer sur chacune de vos saisies, avec le <a href='https://contrib.spip.net/Verifier' class="spip_in" hreflang="fr">plugin API de Vérification</a> (qui n'est pas activé automatiquement avec le plugin <code class='spip_code spip_code_inline' dir='ltr'>saisies</code>).</p> <p>Il faut alors ajouter une clé <code class='spip_code spip_code_inline' dir='ltr'>verifier</code> selon ce formalisme :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>[ 'saisie' => 'input', 'options' => [ 'nom' => 'slug', 'label' => 'slug', 'obligatoire' => 'oui', ], 'verifier' => [ [ 'type' => 'taille', 'options' => ['min' => 10] ], [ 'type' => 'slug', ], ], ];</code></pre></div> <p>Permet de vérifier que nous avons affaire à un slug d'une taille minimum de 10 caractères.</p> <p>Consulter “<a href='https://contrib.spip.net/References-des-verifications' class="spip_in" hreflang="fr">Références des vérifications</a>” pour la liste des types de vérification livrés avec le plugin et de leurs options.</p> <div class="notice"> Pour les versions du plugin < 4.3.0, il n'est possible de déclarer qu'une seule vérification par saisie, sous la forme : <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>[ 'saisie' => 'input', 'options' => [ 'nom' => 'nom', 'label' => 'label', 'obligatoire' => 'oui', ], 'verifier' => [ 'type' => 'entier', 'options' => [ 'min' => 100, 'max' => 500 ], ], ];</code></pre></div> </div> <p>À noter que chaque vérification reçoit dans le tableau d'options deux clés supplémentaires :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>_saisie</code> pour la saisie courante</li><li> <code class='spip_code spip_code_inline' dir='ltr'>_saisies</code> pour l'ensemble des saisies du formulaire</li></ul><h4 class="h4">Support du multilinguisme</h4> <p>Saisies supporte le multilinguisme. Ainsi, dans l'exemple ci-dessous, <a href="https://programmer.spip.net/Syntaxe-des-chaines-de-langue" class="spip_out" rel="external">la chaine de langue</a> <code class='spip_code spip_code_inline' dir='ltr'><:cle:valeur:></code> sera automatiquement interprétée.</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>[ 'saisie' => 'input', 'options' => [ 'nom' => 'nom', 'label' => '<:cle:valeur:>', 'size' => 50 ], ];</code></pre></div><h4 class="h4"><a id="options_globales"></a>Options globales</h4> <p>Il est possible de déclarer des options d'affichage globales à l'ensemble du formulaire. Elles sont alors placées dans une clé <code class='spip_code spip_code_inline' dir='ltr'>options</code> à la racine du tableau des saisies.</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>$saisies = [ 'options' => [ // Changer l'intitulé du bouton final de validation 'texte_submit' => 'Valider c'est gagné', … '<option>' => '<valeur>' //Une autre option ], […], // une saisie […], // une saisie […], // une saisie );</code></pre></div><table class="table spip"> <thead><tr class='row_first'><th id='idb435_c0'>Option</th><th id='idb435_c1'>Usage</th><th id='idb435_c2'>Valeur possible</th><th id='idb435_c3'>Valeur par défaut</th></tr></thead> <tbody> <tr class='row_odd odd'> <td colspan='4' headers='idb435_c0'><h5 class="h5">Options pour l'obligation de remplissage</h5></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>obligatoire_defaut</code></td> <td headers='idb435_c1'>Rendre tous les champs obligatoires, sauf demande contraire</td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>true|false</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>false</code></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>obligatoire_defaut_texte</code></td> <td headers='idb435_c1'>Texte indiquant que les champs sont obligatoires</td> <td headers='idb435_c2'>Texte, passe <code class='spip_code spip_code_inline' dir='ltr'>propre()</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'><:saisies:option_globale_obligatoire_defaut_texte:></code></td></tr> <tr class='row_even even'> <td colspan='4' headers='idb435_c0'><h5 class="h5">Options de prévisualisation</h5></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>previsualisation_mode</code></td> <td headers='idb435_c1'>Type de prévisualisation</td> <td headers='idb435_c2'>Texte : <code class='spip_code spip_code_inline' dir='ltr'>''</code> (pas de prévisualisation), / <code class='spip_code spip_code_inline' dir='ltr'>dessus</code> / <code class='spip_code spip_code_inline' dir='ltr'>etape</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>''</code></td></tr> <tr class='row_even even'> <td colspan='4' headers='idb435_c0'><h5 class="h5">Options pour le bouton de validation</h5></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>texte_submit</code></td> <td headers='idb435_c1'>Texte du bouton de validation</td> <td headers='idb435_c2'>Texte, passe par <code class='spip_code spip_code_inline' dir='ltr'>_T_ou_typo()</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'><:bouton_enregistrer:></code></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>afficher_si_submit</code></td> <td headers='idb435_c1'>Condition pour afficher le bouton de validation</td> <td headers='idb435_c2'>Voir “<a href='https://contrib.spip.net/Affichage-conditionnel-des-saisies-syntaxe-des-tests' class="spip_in" hreflang="fr">Affichage conditionnel des saisies : syntaxe des tests</a>”</td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>null</code></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>squelettes_boutons</code></td> <td headers='idb435_c1'>Squelette utilisé pour le bouton de validation, si envie de surcharger (déconseillé)</td> <td headers='idb435_c2'>Chaîne de caractère</td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>'formulaires/inc-saisies-cvt-boutons'</code></td></tr> <tr class='row_even even'> <td colspan='4' headers='idb435_c0'><h5 class="h5">Options pour la gestion des étapes multiples</h5></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>etapes_activer</code></td> <td headers='idb435_c1'>Activer la gestion multi-étapes, chaque <code class='spip_code spip_code_inline' dir='ltr'>fieldset</code> de premier niveau devient une étape</code></td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>True|False</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>False</code></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>etapes_presentation</code></td> <td headers='idb435_c1'>Mode de présentation des étapes en haut du formulaire</td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>'defaut'|'courante'</code>, il est possible de créer son propre mode en créant un squelette <code class='spip_code spip_code_inline' dir='ltr'>formulaires/inc-saisies-cvt-etapes-<presentation>.html</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>defaut</code></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>etapes_suivant</code></td> <td headers='idb435_c1'>Texte du bouton pour aller à l'étape suivante</td> <td headers='idb435_c2'>Texte, passe par <code class='spip_code spip_code_inline' dir='ltr'>_T_ou_typo()</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'><:bouton_suivant:></code></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>etapes_precedent</code></td> <td headers='idb435_c1'>Texte du bouton pour revenir à l'étape précédente</td> <td headers='idb435_c2'>Texte, passe par <code class='spip_code spip_code_inline' dir='ltr'>_T_ou_typo()</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'><:precedent|ucfirst:></code></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>etapes_precedent_suivant_titrer</code></td> <td headers='idb435_c1'>Permet d'ajouter le titre des étapes dans les boutons “précédent” et “suivant”</td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>True|False</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>False</code></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>etapes_ignorer_recapitulatif</code></td> <td headers='idb435_c1'>Permet de ne pas insérer de récapitulatif avant la validation finale</td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>True|False</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>False</code></td></tr> <tr class='row_odd odd'> <td colspan='4' headers='idb435_c0'><h5 class="h5">Options de balisage</h5></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>ajax</code></td> <td headers='idb435_c1'>Mettre le formulaire en ajax</td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>True|False</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>False</code></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>inserer_a_la_place</code></td> <td headers='idb435_c1'>Texte à mettre à la place de l'ensemble du formulaire, mais au sein du wrapper global (<code class='spip_code spip_code_inline' dir='ltr'><div></code>)</td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>text</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>''</code></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>conteneur_class</code></td> <td headers='idb435_c1'>Classe supplémentaire à ajouter sur le conteneur (<code class='spip_code spip_code_inline' dir='ltr'>(div)</code></td> <td headers='idb435_c2'>Chaîne de caractère</td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>''</code></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>conteneur_id</code></td> <td headers='idb435_c1'>Identifiant html du conteneur (<code class='spip_code spip_code_inline' dir='ltr'>(div)</code></td> <td headers='idb435_c2'>Chaîne de caractère</td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>''</code></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>inserer_debut</code></td> <td headers='idb435_c1'>Contenu arbitraire à insérer au début du formulaire, par exemple pour appeler un script Javascript</td> <td headers='idb435_c2'>Chaîne de caractères</td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>null</code></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>inserer_fin</code></td> <td headers='idb435_c1'>Contenu arbitraire à insérer à la fin du formulaire, par exemple pour appeler un script Javascript</td> <td headers='idb435_c2'>Chaîne de caractère</td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>null</code></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>prefixe_id</code></td> <td headers='idb435_c1'>Préfixe arbitraire à mettre devant tous les attributs <code class='spip_code spip_code_inline' dir='ltr'>id</code> balisant les saisies individuelles. Un tiret-bas <code class='spip_code spip_code_inline' dir='ltr'>_</code> sera automatiquement inséré après le préfixe.</td> <td headers='idb435_c2'>Chaîne de caractère</td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>''</code></td></tr> <tr class='row_odd odd'> <td colspan='4' headers='idb435_c0'><h5 class="h5">Options liées à la soumission</h5></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>verifier_valeurs_acceptables</code></td> <td headers='idb435_c1'>Permet de s'assurer que les valeurs reçues figurent bien parmi les valeurs proposées lors de la saisie du formulaire</td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>True|False</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>False</code></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>afficher_si_avec_post</code></td> <td headers='idb435_c1'>Permet que les saisies masquées par <a href='https://contrib.spip.net/Generation-de-saisies-conditionnelles-avec-afficher_si' class="spip_in" hreflang="fr">affichage conditionnel</a> soient tout de même postées</td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>True|False</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>False</code></td></tr> <tr class='row_even even'> <td colspan='4' headers='idb435_c0'><h4 class="h4">Autres options</h4></td></tr> <tr class='row_odd odd'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>afficher_si_conteneur_extra</code></td> <td headers='idb435_c1'>Les éléments possédant des attributs <code class='spip_code spip_code_inline' dir='ltr'>data_afficher_si</code> au sein de ce(s) conteneur(s) s'afficheront/se masqueront en fonction des valeurs du champ du formulaire. Voir la documentation sur les <a href="https://contrib.spip.net/Generation-de-saisies-conditionnelles-avec-afficher_si}">affichages conditionnels</a></td> <td headers='idb435_c2'>Selecteur JS/CSS</td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>''</code></td></tr> <tr class='row_even even'> <td headers='idb435_c0'><code class='spip_code spip_code_inline' dir='ltr'>chercher_formulaire_cache</code></td> <td headers='idb435_c1'>Permet que le résultat de la fonction <code class='spip_code spip_code_inline' dir='ltr'>formulaire_xx_saisies()</code> soit mis en cache statique au cours d'un hit PHP, utile notamment quand la construction du tableau de saisies est consommateur de ressource</td> <td headers='idb435_c2'><code class='spip_code spip_code_inline' dir='ltr'>true|false</code></td> <td headers='idb435_c3'><code class='spip_code spip_code_inline' dir='ltr'>false</code></td></tr> </tbody> </table> <p>Si un texte passe par <code class='spip_code spip_code_inline' dir='ltr'>_T_ou_typo()</code>, cela peut être :</p> <ul class="spip" role="list"><li> un texte directement écrit dans la langue du site;</li><li> un appel à une chaîne de langue sous la forme <code class='spip_code spip_code_inline' dir='ltr'><:fichier_de_langue:chaine:></code>;</li><li> un texte utilisant la balise <code class='spip_code spip_code_inline' dir='ltr'><multi></code> pour gérer l'internationalisation.</li></ul><h3 class="h3" id='Pipeline'>Pipeline<a class='sommaire-back sommaire-back-12' href='#s-Pipeline' title='Back to the table of contents'></a></h3> <p>Lors du chargement des saisies déclarées via une fonction <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nom_du_formulaire>_saisies()</code>, les saisies sont passés à un pipeline <code class='spip_code spip_code_inline' dir='ltr'>formulaire_saisies</code>. Le tableau <code class='spip_code spip_code_inline' dir='ltr'>$flux</code> passé à ce pipeline à la structure suivante :</p> <p>- <code class='spip_code spip_code_inline' dir='ltr'>$flux['args']['form']</code> : le nom du formulaire; <br />- <code class='spip_code spip_code_inline' dir='ltr'>$flux['args']['args']</code> : les différents arguments passés; <br />- <code class='spip_code spip_code_inline' dir='ltr'>$flux['data']</code> : les saisies.</p> <p>Il est donc possible à un plugin de modifier dynamiquement les saisies d'un formulaire en utilisant les <a href="https://code.spip.net/saisies/namespaces/default.html" class="spip_out" rel="external">différentes fonctions de l'API de saisies</a>.</p> <h2 class="h2" id='Methode-1a-declarer-un-formulaire-CVT-en-PHP-mais-effectuer-soi-meme-des-nbsp'>Méthode 1a : <a id="declarationPHP"></a>déclarer un formulaire CVT en PHP, mais effectuer soi-même des vérifications<a class='sommaire-back sommaire-back-12' href='#s-Methode-1a-declarer-un-formulaire-CVT-en-PHP-mais-effectuer-soi-meme-des-nbsp' title='Back to the table of contents'></a></h2> <p>Parfois il est nécessaire d'avoir des vérifications supplémentaires sur les saisies. Pour ce faire, vous devez déclarer votre propre fonction <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_verifier()</code>.</p> <p>Dans ce cas, vous ne perdrez pas le bénéfice d'une déclaration des vérifications de base dans votre tableau de saisies : celles-ci sont alors automatiquement effectuées <strong>après</strong> vos propres vérifications.</p> <p><a id="pipeline_verification"></a>Toutefois, il est parfois nécessaire de faire en sorte que les vérifications “par déclaration” se fassent <strong>avant</strong> vos propres vérifications. Dans ce cas, la méthode la plus propre est de déclarer ses vérifications non pas sous forme d'une fonction <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_verifier()</code>, mais par la création d'une fonction <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_verifier_post_saisie()</code>, ou sa variante <code class='spip_code spip_code_inline' dir='ltr'>verifier_etape_post_saisies()</code> dans le cadre du multiétape.</p> <p>À noter qu'il existe deux pipelines pour ajouter des vérifications à un formulaire existant : <code class='spip_code spip_code_inline' dir='ltr'>formulaire_verifier_post_saisies</code> et <code class='spip_code spip_code_inline' dir='ltr'>formulaire_verifier_etape_post_saisies</code>.</p> <h2 class="h2" id='Methode-1b-avec-controler-la-structure-globale-du-formulaire-mais-nbsp'> Méthode 1b avec <code class='spip_code spip_code_inline' dir='ltr'>#GENERER_SAISIES</code> : contrôler la structure globale du formulaire, mais utiliser le formalisme de saisies<a class='sommaire-back sommaire-back-12' href='#s-Methode-1b-avec-controler-la-structure-globale-du-formulaire-mais-nbsp' title='Back to the table of contents'></a></h2> <p>Dans quelques cas rares, la structure globale du formulaire livrée avec Saisies ne convient pas. Pour autant, vous souhaitez.</p> <ul class="spip" role="list"><li> profiter du formalisme de déclaration des saisies</li><li> profiter de la vérification automatique de ces saisies (sauf si vous utilisez la méthode 1a).</li></ul> <p>Dans ce cas :</p> <ul class="spip" role="list"><li> vous mettez dans votre fichier <code class='spip_code spip_code_inline' dir='ltr'>formulaires/<nomduformulaire>.html</code> la structure globale du formulaire correspondant à votre besoin;</li><li> là où vous souhaitez insérer vos saisies, vous utilisez la balise <code class='spip_code spip_code_inline' dir='ltr'>#GENERER_SAISIES</code>.</li></ul> <p>Cette balise permet de générer <strong>toutes les saisies</strong> d'un formulaire, en une seule fois. Pour cela on lui passe en paramètre le tableau de description.</p> <p>Exemple d'utilisation :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code><div class="formulaire_spip formulaire_#ENV{form}"[(#ENV{_etape}|oui)formulaire_multietapes]"> <form .... [ data-resume_etapes_futures="(#ENV{_resume_etapes_futures}|json_encode|attribut_html)"]> .... <div > #GENERER_SAISIES{#ENV{_saisies}} </div> .... </form> </div></code></pre></div> <p>On notera l'emploi d'un <code class='spip_code spip_code_inline' dir='ltr'>_</code> en préfixe de la variable d'environnement. Cela permet que les guillemets présents dans les options ne soient pas transformés en entités HTML<span class="spip_note_ref"> [<a href="#nb7-1" class="spip_note" rel="appendix" title="Voir la documentation de la fonction des formulaires CVT." id="nh7-1">1</a>]</span>.</p> <p><code class='spip_code spip_code_inline' dir='ltr'>#ENV{_saisies}</code> est rempli automatiquement avec la valeur de retour de la fonction <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire>_saisies()</code><span class="spip_note_ref"> [<a href="#nb7-2" class="spip_note" rel="appendix" title="Historiquement, elle pouvait aussi être remplie manuellement en ajoutant une (…)" id="nh7-2">2</a>]</span>.</p> <p>On n'oubliera pas les attributs suivants : <br />- les différentes classes sur le <code class='spip_code spip_code_inline' dir='ltr'><div></code> englobant <br />- l'attribut <code class='spip_code spip_code_inline' dir='ltr'>[ data-resume_etapes_futures="(#ENV{_resume_etapes_futures}|json_encode|attribut_html)"]</code> sur le <code class='spip_code spip_code_inline' dir='ltr'><form></code>, qui permet de gérer correctement les affichages conditionnels des étapes dans un formulaire multi-étape.</p> <p>Par ailleurs, on utilisera</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> [(#ENV{_etape}|oui) <INCLURE{fond=formulaires/inc-saisies-cvt-etapes-#ENV{_saisies/options/etapes_presentation,defaut}, etapes=#ENV{_saisies_par_etapes}, env} /> ] </div> pour insérer le chemin d'étapes, et <cadre class="spip"> <INCLURE{fond=formulaires/inc-saisies-cvt-boutons,env} /></code></pre></div> <p>pour les boutons de validation.</p> <h2 class="h2" id='Methode-2-la-balise'>Méthode 2 : la balise <code class='spip_code spip_code_inline' dir='ltr'>#SAISIE</code><a class='sommaire-back sommaire-back-12' href='#s-Methode-2-la-balise' title='Back to the table of contents'></a></h2> <p>Parfois on veut pouvoir contrôler encore plus finement la présentation des saisies. Pour ce faire, on peut insérer dans <code class='spip_code spip_code_inline' dir='ltr'>formulaires/<nomduformulaire>.html</code> des appels à la balise <code class='spip_code spip_code_inline' dir='ltr'>#SAISIE</code>.</p> <p>Cette méthode n'est pas toujours adaptée, car elle présente des limitations :</p> <ol class="spip" role="list"><li> elle ne permet pas de profiter des vérifications automatiques;</li><li> elle ne permet pas de profiter du <a href='https://contrib.spip.net/Generation-de-saisies-conditionnelles-avec-afficher_si' class="spip_in" hreflang="fr">mécanisme d'affichage conditionnel</a>.</li></ol> <p><code class='spip_code spip_code_inline' dir='ltr'>#SAISIE</code> permet de générer <strong>une seule saisie</strong> en lui donnant directement les paramètres désirés. Chaque saisie va générer une ligne dans un formulaire, c'est-à-dire un élément <code class='spip_code spip_code_inline' dir='ltr'><div></code>.</p> <p>La balise <code class='spip_code spip_code_inline' dir='ltr'>#SAISIE</code> a deux arguments obligatoires : le type de saisie, et son nom HTML (attribut “name”). Toutes les autres options sont facultatives et servent à configurer le champ ; de ce fait, elles sont de la forme <code class='spip_code spip_code_inline' dir='ltr'>option=valeur</code>.</p> <p>La forme complète est donc la suivante :<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>#SAISIE{type, name, option=valeur, option2=valeur2, etc=etc}</code></p> <p>Voici quelques exemples d'utilisation.</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>Génère un simple champ texte, indiqué comme étant obligatoire : #SAISIE{input, email, label=Votre courriel, obligatoire=oui} Génère un choix multiple parmi les utilisateurs du SPIP : #SAISIE{auteurs, destinataires, label=Destinataires du message, explication=Choisissez une ou plusieurs personnes à qui sera envoyé le message., multiple=oui}</code></pre></div> <p>Comme vous le voyez, des champs qui peuvent être complexes, et fastidieux à écrire de manière complète, s'écrivent ici en quelques lignes.</p> <p><code class='spip_code spip_code_inline' dir='ltr'>#SAISIE</code> supporte le multilinguisme. Dans ce cas, attention de bien utiliser la syntaxe complète avec les crochets :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>#SAISIE{input, annee, label=<:monplugin:annee:>,obligatoire=oui}</code> ne fonctionne pas ;</li><li> <code class='spip_code spip_code_inline' dir='ltr'>[(#SAISIE{input, annee, label=<:monplugin:annee:>,obligatoire=oui})]</code> fonctionne.</li></ul><h2 class="h2" id='Appendice-1-chargement-des-CSS-et-scripts-Javascript-sur-le-site-public'>Appendice 1 : chargement des CSS et scripts Javascript sur le site public<a class='sommaire-back sommaire-back-12' href='#s-Appendice-1-chargement-des-CSS-et-scripts-Javascript-sur-le-site-public' title='Back to the table of contents'></a></h2> <p>Si votre formulaire est destiné à être public, le plugin se charge d'ajouter automatiquement les appels aux fichiers CSS et scripts Javascript associés aux saisies utilisées sur le site public, lorsque le formulaire est effectivement utilisé.forme</p> <p>Toutefois, si vous avez beaucoup de formulaires utilisant Saisies sur le site public, il peut être judicieux de charger systématiquement les fichiers sur toutes les pages, afin de profiter de la compréhension et du cache navigateur. Dans la configuration du plugin (“Squelettes”->“Configuration du plugin Saisies”), une option permet d'activer cela.</p> <h2 class="h2" id='Appendice-2-enregistrer-des-tableaux'> Appendice 2 : enregistrer des tableaux <a class='sommaire-back sommaire-back-12' href='#s-Appendice-2-enregistrer-des-tableaux' title='Back to the table of contents'></a></h2> <p>La norme HTML permet de gérer des réponses de formulaire sous la forme de tableau.</p> <p>Dans la déclaration de la saisie, on peut utiliser la syntaxe HTML classique avec crochets :</p> <div class="precode"><pre class='php spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[ 'saisie' => 'input', 'options' => [ 'nom' => 'annee[debut]', 'label' => 'Votre nom', 'size' => 50 ], ];</code></pre></div> <p>Mais il est recommandé d'utiliser le formalisme SPIP suivant : <code class='spip_code spip_code_inline' dir='ltr'><tableau>/<clé></code>.</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>[ 'saisie' => 'input', 'options' => [ 'nom' => 'annee/debut', 'label' => 'Label', 'size' => 50 ], ];</code></pre></div> <p>Le code suivant permettra de récupérer la valeur en PHP :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>$annee = _request('annee'); $debut = $annee['debut'];</code></pre></div><h2 class="h2" id='Appendice-3-la-balise'>Appendice 3 : la balise <code class='spip_code spip_code_inline' dir='ltr'>#VOIR_SAISIES</code><a class='sommaire-back sommaire-back-12' href='#s-Appendice-3-la-balise' title='Back to the table of contents'></a></h2> <p>Cette balise permet d'afficher toutes les valeurs saisies après validation d'un formulaire. On lui passe en paramètre deux arguments :</p> <ol class="spip" role="list"><li> le tableau de description des saisies (au même format que pour #GENERER_SAISIES)</li><li> un tableau des valeurs saisies</li></ol> <p>Exemple d'utilisation, dans le squelette d'un formulaire :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>[(#EDITABLE|non) #VOIR_SAISIES{#ENV{mes_saisies}, #ENV} ]</code></pre></div><h2 class="h2" id='Appendice-4-probleme-avec-Xdebug'>Appendice 4 : problème avec Xdebug<a class='sommaire-back sommaire-back-12' href='#s-Appendice-4-probleme-avec-Xdebug' title='Back to the table of contents'></a></h2> <p>Si vous développez en utilisant le logiciel Xdebug, il existe un problème connu : par défaut celui-ci affiche une erreur à partir d'un certain niveau d'imbrication de fonctions PHP (“nesting level” dirait Shakespeare).</p> <p>Le niveau d'imbrication autorisé par défaut est relativement bas, mais on peut le paramétrer. Vous devez donc ajouter cela dans votre configuration PHP/Xdebug :</p> <div class="precode"><pre data-language="ini" class='spip_code spip_code_block language-ini' dir='ltr' style='text-align:left;'><code>[xdebug] xdebug.max_nesting_level = 200 ou 500 ou plus…</code></pre></div> <p>Et hop, ça remarche.</p></div> <hr /> <div class='rss_notes'><div id="nb7-1"> <p><span class="spip_note_ref">[<a href="#nh7-1" class="spip_note" title="Footnotes 7-1" rev="appendix">1</a>] </span>Voir la <a href="https://www.spip.net/fr_article4151.html" class="spip_out" rel="external">documentation de la fonction <code class='spip_code spip_code_inline' dir='ltr'>_charger</code> des formulaires CVT</a>.</p> </div><div id="nb7-2"> <p><span class="spip_note_ref">[<a href="#nh7-2" class="spip_note" title="Footnotes 7-2" rev="appendix">2</a>] </span>Historiquement, elle pouvait aussi être remplie manuellement en ajoutant une clé <code class='spip_code spip_code_inline' dir='ltr'>_saisies</code> dans le tableau de retour de la fonction <code class='spip_code spip_code_inline' dir='ltr'>formulaires_<nomduformulaire_charger()</code>, toutefois ceci ne permet pas de bénéficier de tous les mécanismes d'automatisme du plugin saisies, et les bugs risquent d'être présents. Ce n'est donc pas une fonctionnalité officiellement supportée et validée.</p> </div></div> <div class='rss_ps'><p>Voir aussi la doc complémentaire et participative sur le wiki :<br class='manualbr' /><a href='https://contrib.spip.net/Saisies-Doc-complementaire' class="spip_in" hreflang="fr">Saisies : Doc complémentaire</a></p></div> </article> <article> <h1>Indexer : Installation et Configuration</h1> <p>cam.lafit, Fil, Matthieu Marcillaud, RastaPopoulos — 2014-10-06T15:15:29Z</p> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-8" id="nav6a60d1493ffe52.72131049"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Introduction"></a><a href="#Introduction" class="spip_ancre">Introduction</a></li><li> <a id="s-Compatibilite"></a><a href="#Compatibilite" class="spip_ancre">Compatibilité</a></li><li> <a id="s-Description-technique"></a><a href="#Description-technique" class="spip_ancre">Description technique</a></li><li> <a id="s-Installation-de-Sphinx"></a><a href="#Installation-de-Sphinx" class="spip_ancre">Installation de Sphinx</a></li><li> <a id="s-Creation-de-la-configuration-Debian-et-derives"></a><a href="#Creation-de-la-configuration-Debian-et-derives" class="spip_ancre">Création de la configuration <i>Debian et dérivés</i></a></li><li> <a id="s-Tester-que-Sphinx-est-bien-lance"></a><a href="#Tester-que-Sphinx-est-bien-lance" class="spip_ancre">Tester que Sphinx est bien lancé</a></li><li> <a id="s-Preparer-SPIP-et-indexer-ses-articles"></a><a href="#Preparer-SPIP-et-indexer-ses-articles" class="spip_ancre">Préparer SPIP et indexer ses articles</a></li><li> <a id="s-Interdire-les-ecritures"></a><a href="#Interdire-les-ecritures" class="spip_ancre">Interdire les écritures</a></li></ul></div><h2 class="h2" id='Introduction'>Introduction<a class='sommaire-back sommaire-back-8' href='#s-Introduction' title='Back to the table of contents'></a></h2> <p>Pour comprendre l'intérêt du plugin, nous invitons à lire l'article suivant <a href='https://contrib.spip.net/Indexer-Introduction' class="spip_in" hreflang="fr">Indexer : Introduction</a>. Le fonctionnement de la boucle <strong>SPHINX</strong> est expliqué dans cet article:<br class='autobr' /> <a href='https://contrib.spip.net/Indexer-La-boucle-SPHINX' class="spip_in" hreflang="fr">Indexer : La boucle SPHINX</a>. La suite de l'article aborde uniquement l'installation et la configuration du plugin Indexer et du moteur <a href="http://sphinxsearch.com/" class="spip_out" rel="external">Sphinx</a> .</p> <p>Rappel pour les lecteurs inattentifs, il faut installer <strong>Sphinx</strong> en plus du plugin.</p> <h2 class="h2" id='Compatibilite'>Compatibilité<a class='sommaire-back sommaire-back-8' href='#s-Compatibilite' title='Back to the table of contents'></a></h2> <p>Le plugin <code class='spip_code spip_code_inline' dir='ltr'>Indexer</code> (compatible SPIP 2.1 et SPIP 3.x) exploite le mode RT (real-time), l'API mysql, et les fonctionnalités JSON de Sphinx. Pour cette raison il ne fonctionne qu'à partir de la version 2.2 de Sphinx.</p> <p><i>Note : l'ancien plugin SPIP <code class='spip_code spip_code_inline' dir='ltr'>Sphinx</code> (<a href='https://contrib.spip.net/Sphinx'>doc</a>) exploite le mode standard de Sphinx, et son API native. </i></p> <h2 class="h2" id='Description-technique'>Description technique<a class='sommaire-back sommaire-back-8' href='#s-Description-technique' title='Back to the table of contents'></a></h2> <p>Le mode RT de Sphinx permet à tout moment d'enrichir ou d'actualiser les contenus de Sphinx, par l'intermédiaire de requêtes proches de l'écriture SQL, et donc assez familières. Ainsi, le plugin <code class='spip_code spip_code_inline' dir='ltr'>Indexer</code> actualise l'index de Sphinx après chaque modification d'un contenu dans SPIP. La page <code class='spip_code spip_code_inline' dir='ltr'>exec=indexer</code> permet d'indexer ou de réindexer tous les contenus du site.</p> <p>Le plugin intègre quelques documentations : <br class='autobr' /> <a href="http://zone.spip.org/trac/spip-zone/browser/_plugins_/indexer/trunk/doc" class="spip_url spip_out auto" rel="nofollow external">http://zone.spip.org/trac/spip-zone/browser/_plugins_/indexer/trunk/doc</a></p> <p>Notamment, par défaut, il utilise un index nommé 'spip'. Cet index Sphinx ressemble beaucoup à une table SQL. Chaque entrée dans l'index est appelé un document. Ici, un document possède certains champs assez communs, qui sont détaillés dans la <a href='https://contrib.spip.net/Indexer-Indexation' class="spip_in" hreflang="fr">documention de l'indexation</a>.</p> <h2 class="h2" id='Installation-de-Sphinx'> Installation de Sphinx <a class='sommaire-back sommaire-back-8' href='#s-Installation-de-Sphinx' title='Back to the table of contents'></a></h2> <p>Sphinxsearch fournit un ensemble de paquets selon les environnements serveurs (Windows, Linux, Debian, ....) depuis la page : <br class='autobr' /> <a href="http://sphinxsearch.com/downloads/release/" class="spip_url spip_out auto" rel="nofollow external">http://sphinxsearch.com/downloads/release/</a></p> <p>Le point important est de prendre un version supérireure à 2.2</p> <p>L'installation est à effectuer selon votre environnement (exe, yum, apt-get/aptitude, ....)</p> <p>Vous pouvez contrôler le bon fonctionnement de Sphinx via la commande suivante (à exécuter en root ou assimilé)</p> <div class="precode"><pre data-language="bash" class='spip_code spip_code_block language-bash' dir='ltr' style='text-align:left;'><code>searchd</code></pre></div><h2 class="h2" id='Creation-de-la-configuration-Debian-et-derives'> Création de la configuration <i>Debian et dérivés</i> <a class='sommaire-back sommaire-back-8' href='#s-Creation-de-la-configuration-Debian-et-derives' title='Back to the table of contents'></a></h2> <p>Il faut créer le fichier de configuration de sphinx dans <code class='spip_code spip_code_inline' dir='ltr'>/etc/sphinx/sphinx.conf</code>.<br class='autobr' /> Un fichier d'exemple est fourni avec le paquet debian/ubuntu.</p> <p>Nous pouvons utiliser du <a href="https://en.wikipedia.org/wiki/PHP" class="spip_glossaire" rel="external">PHP</a> pour gérer la configuration dans des fichiers séparés dans <code class='spip_code spip_code_inline' dir='ltr'>/etc/sphinx/conf.d-enabled/</code> ou <code class='spip_code spip_code_inline' dir='ltr'>/etc/sphinxsearch/conf.d-enabled/</code> . On en profite pour créer le répertoire manquant sous Ubuntu/Debian :</p> <p>Fichier <code class='spip_code spip_code_inline' dir='ltr'>/etc/sphinx/sphinx.conf</code> ou <code class='spip_code spip_code_inline' dir='ltr'>/etc/sphinxsearch/sphinx.conf</code></p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>#!/usr/bin/env php <?php # Correction bug paquet debian / ubuntu if (!is_dir('/var/run/sphinx')) { mkdir('/var/run/sphinx'); } # Recherche et inclusions des configurations foreach (glob(__DIR__ . '/conf.d-enabled/*.conf') as $conf) { include $conf; }</code></pre></div> <p>Créer le répertoire <code class='spip_code spip_code_inline' dir='ltr'>/etc/sphinx/conf.d-enabled</code> ou <code class='spip_code spip_code_inline' dir='ltr'>/etc/sphinxsearch/conf.d-enabled</code> (et éventuellement <code class='spip_code spip_code_inline' dir='ltr'>conf.d-available</code>)</p> <p>Dans <strong>conf.d-enabled</strong>, mettre :</p> <ul class="spip" role="list"><li> le fichier <a href="https://git.spip.net/spip-contrib-extensions/indexer/src/branch/master/doc/1_charset.conf" class="spip_out" rel="external">1_charsets.conf</a> <ul class="spip" role="list"><li> <i>Remarque</i> : C'est un script il doit donc avoir les droits d'exécution.</li></ul></li></ul><ul class="spip" role="list"><li> le fichier searchd.conf :<br class='autobr' /> On précise les IP d'écoute, pour restreindre au serveur local pensez à mettre 127.0.0.1 et non l'ip publique de votre serveur.</li></ul> <p>On peut noter que searchd fournit par défaut des connecteurs sur divers ports :</p> <ul class="spip" role="list"><li> API interface “native” <strong>9312</strong><br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>listen = 127.0.0.1:9312</code></li><li> API interface “SphinxQL” 9306<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>listen = 127.0.0.1:9306:mysql41</code></li></ul> <p>Le plugin Indexer n'utilise que l'inteface SphinxQL, il est donc tout à fait possible de désactiver l'interface 9312.</p> <p>Si le répertoire de référence est sphinxsearch et non sphinx, pensez à corriger la config suivante en actualisant les chemins.</p> <div class="precode"><pre data-language="config" class='spip_code spip_code_block language-config' dir='ltr' style='text-align:left;'><code>searchd { # [hostname:]port[:protocol], or /unix/socket/path to listen on # known protocols are 'sphinx' (SphinxAPI) and 'mysql41' (SphinxQL) # listen = 9306:mysql41 listen = 127.0.0.1:9306:mysql41 pid_file = /var/run/sphinx/searchd.pid log = /var/log/sphinx/searchd.log query_log = /var/log/sphinx/query.log binlog_path = /var/lib/sphinx/ }</code></pre></div><ul class="spip" role="list"><li> le fichier spip.conf : <div class="precode"><pre data-language="config" class='spip_code spip_code_block language-config' dir='ltr' style='text-align:left;'><code>index spip{ type = rt path = /var/lib/sphinxsearch/data/spip rt_field = title rt_attr_string = title rt_field = summary rt_attr_string = summary rt_field = content rt_attr_string = content rt_attr_timestamp = date rt_attr_timestamp = date_indexation rt_attr_string = uri rt_attr_json = properties rt_attr_string = signature <?php echo _CHARSET_INDEXATION_FR ; ?> }</code></pre></div></li></ul> <p>Relancer le démon searchd une fois ceci effectué :</p> <div class="precode"><pre data-language="bash" class='spip_code spip_code_block language-bash' dir='ltr' style='text-align:left;'><code>sudo searchd --stop sudo searchd # ou sudo service sphinxsearch restart</code></pre></div><h2 class="h2" id='Tester-que-Sphinx-est-bien-lance'> Tester que Sphinx est bien lancé <a class='sommaire-back sommaire-back-8' href='#s-Tester-que-Sphinx-est-bien-lance' title='Back to the table of contents'></a></h2> <p>Se connecter à Sphinx via le client mysql ou mariadb :</p> <div class="precode"><pre data-language="bash" class='spip_code spip_code_block language-bash' dir='ltr' style='text-align:left;'><code>mysql -h0 -P9306</code></pre></div> <p>Quelques commandes :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>show tables;</code> : liste l'ensemble des indexes</li><li> <code class='spip_code spip_code_inline' dir='ltr'>describe spip;</code> : décrit les champs d'un index</li></ul><div class="precode"><pre data-language="bash" class='spip_code spip_code_block language-bash' dir='ltr' style='text-align:left;'><code>> show tables; +-------+------+ | Index | Type | +-------+------+ | spip | rt | +-------+------+ 1 row in set (0.00 sec) > describe spip; +------------+-----------+ | Field | Type | +------------+-----------+ | id | bigint | | title | field | | summary | field | | content | field | | date | timestamp | | title | string | | summary | string | | content | string | | uri | string | | signature | string | | properties | json | +------------+-----------+ 11 rows in set (0.00 sec)</code></pre></div><h2 class="h2" id='Preparer-SPIP-et-indexer-ses-articles'> Préparer SPIP et indexer ses articles <a class='sommaire-back sommaire-back-8' href='#s-Preparer-SPIP-et-indexer-ses-articles' title='Back to the table of contents'></a></h2> <p>Si sphinx est actif (on peut se connecter à lui via mysql), on peut alors, si il est installé sur le même serveur que le site SPIP, directement l'interconnecter avec SPIP.</p> <p>La configuration de base se fait dans config/mes_options.php :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>define('SPHINX_DEFAULT_INDEX', 'spip'); define('SPHINX_SERVER_HOST', '127.0.0.1'); define('SPHINX_SERVER_PORT', 9306);</code></pre></div> <p>Pour ce faire, télécharger et activer le plugin Indexer.<br class='autobr' /> Une fois actif, aller sur la page <code class='spip_code spip_code_inline' dir='ltr'>ecrire/?exec=indexer</code>.<br class='autobr' /> L'interface est encore très sobre, mais on peut démarrer l'indexation de tous les articles du site en cliquant «démarrer». Cela peut prendre un peu de temps en fonction de la machine et du nombre d'articles.</p> <p>Une fois indexé, une page (joliment affichée si «spipr-dist» est actif) peut être visitée pour tester un peu : <code class='spip_code spip_code_inline' dir='ltr'>?page=sphinx</code>. Cette page affiche un champ de recherche, ainsi que des facettes sur les auteurs, les mots clés ou la date.</p> <h2 class="h2" id='Interdire-les-ecritures'>Interdire les écritures<a class='sommaire-back sommaire-back-8' href='#s-Interdire-les-ecritures' title='Back to the table of contents'></a></h2> <p>Si vous utilisez ce plugin sur un site de préproduction, la configuration suivante permet d'interdire les écritures dans la base sphinx :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>define('_INDEXER_READONLY', true);</code></pre></div> <p>Il existe aussi 2 autres constantes qui permettent de désactiver le plugin sur un site en préproduction / local:</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>define('SPHINX_DEFAULT_INDEX', ''); define('_INDEXER_OFF', true);</code></pre></div></div> </article> <article> <h1>Formidable, le générateur de formulaires</h1> <p>Maïeul, RastaPopoulos — 2012-01-23T21:00:00Z</p> <div class='rss_chapo'><p>Un générateur de formulaires <strong>facilement configurable</strong> pour les non-informaticien<span aria-hidden='true'>·</span>ne<span aria-hidden='true'>·</span>s et <strong>facilement extensible</strong> pour les développeur⋅euses.</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-18" id="nav6a60d14943a8b3.89114555"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Introduction"></a><a href="#Introduction" class="spip_ancre">Introduction</a></li><li> <a id="s-Interface-utilisateur-trice"></a><a href="#Interface-utilisateur-trice" class="spip_ancre">Interface utilisateur<span aria-hidden='true'><span aria-hidden='true'>·</span></span>trice</a></li><li> <a id="s-Appeler-mon-formulaire"></a><a href="#Appeler-mon-formulaire" class="spip_ancre">Appeler mon formulaire</a> <ul class="spip" role="list"><li> <a id="s-Dans-un-contenu"></a><a href="#Dans-un-contenu" class="spip_ancre">Dans un contenu</a></li><li> <a id="s-Dans-un-squelette"></a><a href="#Dans-un-squelette" class="spip_ancre">Dans un squelette</a></li></ul></li><li> <a id="s-Afficher-les-resultats-du-formulaire"></a><a href="#Afficher-les-resultats-du-formulaire" class="spip_ancre">Afficher les résultats du formulaire</a></li><li> <a id="s-Dans-un-contenu-4d17"></a><a href="#Dans-un-contenu-4d17" class="spip_ancre">Dans un contenu</a></li><li> <a id="s-Pre-remplir-dynamiquement-les-champs-d-un-formulaire"></a><a href="#Pre-remplir-dynamiquement-les-champs-d-un-formulaire" class="spip_ancre">Pré-remplir dynamiquement les champs d'un formulaire</a> <ul class="spip" role="list"><li> <a id="s-Dans-un-contenu-2"></a><a href="#Dans-un-contenu-2" class="spip_ancre">Dans un contenu</a></li><li> <a id="s-Dans-un-squelette-485e"></a><a href="#Dans-un-squelette-485e" class="spip_ancre">Dans un squelette</a></li></ul></li><li> <a id="s-Autres-options-utilisable-dans-le-squelette"></a><a href="#Autres-options-utilisable-dans-le-squelette" class="spip_ancre">Autres options utilisable dans le squelette</a></li><li> <a id="s-Case-unique"></a><a href="#Case-unique" class="spip_ancre">Case unique</a></li><li> <a id="s-Courriels-de-notification"></a><a href="#Courriels-de-notification" class="spip_ancre">Courriels de notification</a></li><li> <a id="s-Conservation-des-IP"></a><a href="#Conservation-des-IP" class="spip_ancre">Conservation des IP</a></li><li> <a id="s-Envoi-de-fichiers"></a><a href="#Envoi-de-fichiers" class="spip_ancre">Envoi de fichiers</a></li><li> <a id="s-Mise-en-forme-des-saisies"></a><a href="#Mise-en-forme-des-saisies" class="spip_ancre">Mise en forme des saisies</a></li><li> <a id="s-Affichage-des-reponses-sous-forme-de-tableau"></a><a href="#Affichage-des-reponses-sous-forme-de-tableau" class="spip_ancre">Affichage des réponses sous forme de tableau</a></li><li> <a id="s-Voir-aussi-sur-le-wiki"></a><a href="#Voir-aussi-sur-le-wiki" class="spip_ancre">Voir aussi sur le wiki</a></li></ul></div></p> <p>Cette documentation est valable à partir de la version 6.1.0 de Formidable.</p> <h2 class="h2" id='Introduction'>Introduction<a class='sommaire-back sommaire-back-18' href='#s-Introduction' title='Back to the table of contents'></a></h2> <p>Historiquement, deux plugins avaient déjà été développés précédemment pour gérer des formulaires :</p> <ul class="spip" role="list"><li> Forms &Tables, qui n'a pas été complètement porté pour SPIP 2.</li><li> et spip-formulaire créé par artego mais qui n'était plus maintenu.</li></ul> <p>La question s'est donc posée : construire sur la base d'un des deux plugins ou repartir de zéro ?<br class='manualbr' />Form &Table, très complet pour les utilisateurs, présentait l'inconvénient d'avoir un côté “fourre-tout” qui le rendait difficilement modifiable et difficile à personnaliser par les dévs.</p> <p>Il a finalement été décidé de repartir de zéro pour proposer quelque chose:</p> <ul class="spip" role="list"><li> de plus facile à utiliser pour les utilisateurs d'une part,</li><li> mais aussi de plus facile à personnaliser pour les développeur⋅euses.<br class='autobr' /> Avec le parti pris de se baser de préférence sur plusieurs petits plugins spécialisés et de tirer parti de la nouvelle <a href="http://programmer.spip.org/-Les-formulaires-" class="spip_out" rel="external">norme CVT</a>.</li></ul><h2 class="h2" id='Interface-utilisateur-trice'>Interface utilisateur<span aria-hidden='true'>·</span>trice<a class='sommaire-back sommaire-back-18' href='#s-Interface-utilisateur-trice' title='Back to the table of contents'></a></h2> <p>L'utilisation basique de l'interface est abordée dans ce screencast : <a href='https://contrib.spip.net/Mon-premier-formulaire-pas-a-pas-c-est-Formidable' class="spip_in" hreflang="fr">Mon premier formulaire pas à pas : c'est Formidable<small class="fine d-inline"> </small>!</a></p> <h2 class="h2" id='Appeler-mon-formulaire'><a id="appeler-mon-formulaire"></a>Appeler mon formulaire<a class='sommaire-back sommaire-back-18' href='#s-Appeler-mon-formulaire' title='Back to the table of contents'></a></h2> <p>Vous devez appeler le formulaire ayant le nom “formidable”, en lui passant en paramètre l'identifiant de votre formulaire.</p> <h3 class="h3" id='Dans-un-contenu'>Dans un contenu<a class='sommaire-back sommaire-back-18' href='#s-Dans-un-contenu' title='Back to the table of contents'></a></h3> <p>Utilisez le modèle <code class='spip_code spip_code_inline' dir='ltr'><formulaire></code> classique : <code class='spip_code spip_code_inline' dir='ltr'><formulaire|formidable|id=34></code> ou bien <code class='spip_code spip_code_inline' dir='ltr'><formulaire|formidable|id=contact></code></p> <h3 class="h3" id='Dans-un-squelette'>Dans un squelette<a class='sommaire-back sommaire-back-18' href='#s-Dans-un-squelette' title='Back to the table of contents'></a></h3> <p><br class='manualbr' /><code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_FORMIDABLE{34}</code> ou bien <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_FORMIDABLE{contact}</code></p> <h2 class="h2" id='Afficher-les-resultats-du-formulaire'>Afficher les résultats du formulaire<a class='sommaire-back sommaire-back-18' href='#s-Afficher-les-resultats-du-formulaire' title='Back to the table of contents'></a></h2> <h2 class="h2" id='Dans-un-contenu-4d17'>Dans un contenu<a class='sommaire-back sommaire-back-18' href='#s-Dans-un-contenu-4d17' title='Back to the table of contents'></a></h2> <p>Utilisez le modèle <code class='spip_code spip_code_inline' dir='ltr'><formulaire_analyse|id_formulaire=34></code></p> <h2 class="h2" id='Pre-remplir-dynamiquement-les-champs-d-un-formulaire'>Pré-remplir dynamiquement les champs d'un formulaire<a class='sommaire-back sommaire-back-18' href='#s-Pre-remplir-dynamiquement-les-champs-d-un-formulaire' title='Back to the table of contents'></a></h2> <p>À noter, vous avez la possibilité de surcharger dans l'appel, les valeurs par défaut des champs de votre formulaire. Pour cela, vous devez passer un tableau de <code class='spip_code spip_code_inline' dir='ltr'>nom=>valeur</code> en deuxième paramètre. Vous pourrez trouver les noms de vos champs dans l'aide-mémoire situé sur la page de configuration des traitements.</p> <h3 class="h3" id='Dans-un-contenu-2'>Dans un contenu<a class='sommaire-back sommaire-back-18' href='#s-Dans-un-contenu-2' title='Back to the table of contents'></a></h3> <p>Le tableau de valeurs dans un paramètre <strong>defaut</strong> sous forme d'une suite de chaînes “clé,valeur” séparée par des virgules :<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'><formulaire|formidable|id=contact|defaut=hidden1,valeur,input_5,autrevaleur></code></p> <h3 class="h3" id='Dans-un-squelette-485e'>Dans un squelette<a class='sommaire-back sommaire-back-18' href='#s-Dans-un-squelette-485e' title='Back to the table of contents'></a></h3> <p>Le tableau en deuxième paramètre :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#FORMULAIRE_FORMIDABLE{contact, #ARRAY{nom_du_champ, Ma valeur}}</code></pre></div> <p>C'est particulièrement utile pour remplir un champ caché avec une valeur <i>dynamique</i> venant du squelette :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#FORMULAIRE_FORMIDABLE{contact, #ARRAY{hidden_1, #ID_DOCUMENT}}</code></pre></div> <h2 class="h2" id='Autres-options-utilisable-dans-le-squelette'>Autres options utilisable dans le squelette<a id="3emearg"></a><a class='sommaire-back sommaire-back-18' href='#s-Autres-options-utilisable-dans-le-squelette' title='Back to the table of contents'></a></h2> <p>Il est possible de passer des options comme troisième argument du formulaire, sous forme de tableau (<code class='spip_code spip_code_inline' dir='ltr'>#ARRAY</code>).</p> <table class="table spip"> <caption><i>Options possible comme troisième argument de <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_FORMIDABLE</code></strong></caption> <thead><tr class='row_first'><th id='idf7fd_c0'>Nom de l'option</th><th id='idf7fd_c1'>Fonction</th><th id='idf7fd_c2'>Type</th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='idf7fd_c0'><code class='spip_code spip_code_inline' dir='ltr'>forcer_modif</code></td> <td headers='idf7fd_c1'>Permet de forcer la modification d'une réponse, même si non autorisé</td> <td headers='idf7fd_c2'>Booléen</td></tr> <tr class='row_even even'> <td headers='idf7fd_c0'><code class='spip_code spip_code_inline' dir='ltr'>id_formulaires_reponse</code></td> <td headers='idf7fd_c1'>Identifiant de la réponse à modifier</td> <td headers='idf7fd_c2'>Entier</td></tr> <tr class='row_odd odd'> <td headers='idf7fd_c0'><code class='spip_code spip_code_inline' dir='ltr'>no_ajax</code></td> <td headers='idf7fd_c1'>Désactiver l'ajax sur le formulaire</td> <td headers='idf7fd_c2'>Booléen</td></tr> <tr class='row_even even'> <td headers='idf7fd_c0'><code class='spip_code spip_code_inline' dir='ltr'>traiter_enregistrement_desactiver_modif_instituer_prop</code></td> <td headers='idf7fd_c1'>Permet de désactiver au cas par cas l'option de configuration « Lorsque l'internaute modifie la réponse, son statut redevient « proposée » »</td> <td headers='idf7fd_c2'>Booléen</td></tr> <tr class='row_odd odd'> <td headers='idf7fd_c0'><code class='spip_code spip_code_inline' dir='ltr'>traiter_email_destinataires</code></td> <td headers='idf7fd_c1'>Destinataires pour le traitement</td> <td headers='idf7fd_c2'>Tableau (<code class='spip_code spip_code_inline' dir='ltr'>#ARRAY</code>) d'emails ou liste d'emails séparés par des virgules</td></tr> <tr class='row_even even'> <td headers='idf7fd_c0'><code class='spip_code spip_code_inline' dir='ltr'>traiter_email_destinataires_methode</code></td> <td headers='idf7fd_c1'>Indique si <code class='spip_code spip_code_inline' dir='ltr'>traiter_email_destinataires</code> doit remplacer les emails déjà configurés dans le traitement ou les ajouter</td> <td headers='idf7fd_c2'>Au choix <code class='spip_code spip_code_inline' dir='ltr'>'remplacer'</code> ou <code class='spip_code spip_code_inline' dir='ltr'>'ajouter'</code> (valeur par défaut)</td></tr> <tr class='row_odd odd'> <td headers='idf7fd_c0'><code class='spip_code spip_code_inline' dir='ltr'>url_redirect</code></td> <td headers='idf7fd_c1'>Url de redirection</td> <td headers='idf7fd_c2'>Chaine</td></tr> <tr class='row_even even'> <td headers='idf7fd_c0'><code class='spip_code spip_code_inline' dir='ltr'>ignorer_limite_date</code></td> <td headers='idf7fd_c1'>Permet de ne pas tenir compte de la date de publication et de la date d'expiration (à priori usage purement interne à formidable</td> <td headers='idf7fd_c2'>Booleen</td></tr> </tbody> </table> <p><strong>Exemple d'un formulaire Formidable dont l'identifiant est <i>contact_libre</strong></i> et dont l'email destinataire est dans le champ <strong>email</strong> de la table de votre objet <code class='spip_code spip_code_inline' dir='ltr'>#EMAIL de la table spip_contacts …</code>.</p> <div class="precode"><pre SPIP class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><div class="ajax"> #FORMULAIRE_FORMIDABLE{contact_libre,'',#ARRAY{traiter_email_destinataires,#EMAIL}} </div></code></pre></div><h2 class="h2" id='Case-unique'>Case unique <a class='sommaire-back sommaire-back-18' href='#s-Case-unique' title='Back to the table of contents'></a></h2> <p>Pour rendre obligatoire la réponse oui à une case unique (pour la validation de conditions d'utilisation par exemple), il faut simplement rendre le champ obligatoire.</p> <h2 class="h2" id='Courriels-de-notification'>Courriels de notification <a class='sommaire-back sommaire-back-18' href='#s-Courriels-de-notification' title='Back to the table of contents'></a></h2> <p>Une option des traitements proposés permet d'envoyer un mail de notification automatiquement, à chaque saisie d'un formulaire.</p> <p>Le squelette par défaut employé pour la mise en forme de ces mails est <code class='spip_code spip_code_inline' dir='ltr'>plugins/formidable/notifications/formulaire_email.html</code>. Vous pouvez le copier dans le répertoire 'notifications' de votre squelette et l'y modifier à votre guise. Cette modification vaudra pour <strong>tous</strong> les formulaires.</p> <p>Pour utiliser un squelette spécifique pour les mails de notification de l'un seulement des formulaires définis avec Formidable, il suffit d'ajouter son squelette dans le répertoire 'notifications' de votre dossier squelettes, mais en ajoutant l'identifiant.</p> <p>IDENTIFIANT étant l'identifiant du formulaire défini dans Formidable, les squelettes doivent se nommer :<br class='manualbr' /><code class='spip_code spip_code_inline' dir='ltr'>formulaire_IDENTIFIANT_email.html</code> pour le mail aux destinataires<br class='manualbr' /><code class='spip_code spip_code_inline' dir='ltr'>formulaire_IDENTIFIANT_accuse.html</code> pour l'accusé de réception du visiteur</p> <h2 class="h2" id='Conservation-des-IP'>Conservation des IP<a class='sommaire-back sommaire-back-18' href='#s-Conservation-des-IP' title='Back to the table of contents'></a></h2> <p>Les adresse IP des personnes répondant aux formulaires sont stockées en base de donnée. Depuis la version 1.5 (SPIP 3) / 0.7 (SPIP < 3), elle sont automatiquement hashé, de manière à ce que l'IP ne soit plus reconnaissable, au bout de 124 jours (environ 4 mois).</p> <p>Pour changer ce délai, vous pouvez redéfinir la constante <code class='spip_code spip_code_inline' dir='ltr'>_CNIL_PERIODE</code> dans votre fichier <code class='spip_code spip_code_inline' dir='ltr'>mes_options.php</code>.</p> <p>Par exemple :</p> <div class="precode"><pre class='php spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>define('_CNIL_PERIODE', 24*3600);</code></pre></div> <p>permet de hasher les IP toutes les 24 heures.</p> <p>Si vous voulez désactiver le hashage, mettez la valeur à 0.</p> <h2 class="h2" id='Envoi-de-fichiers'>Envoi de fichiers<a class='sommaire-back sommaire-back-18' href='#s-Envoi-de-fichiers' title='Back to the table of contents'></a></h2> <p>Lire l'article complémentaire : <a href='https://contrib.spip.net/Envoyer-des-fichiers-avec-un-formulaire-Formidable' class="spip_in" hreflang="fr">Envoyer des fichiers avec un formulaire Formidable</a>.</p> <h2 class="h2" id='Mise-en-forme-des-saisies'>Mise en forme des saisies<a class='sommaire-back sommaire-back-18' href='#s-Mise-en-forme-des-saisies' title='Back to the table of contents'></a></h2> <p>Le plugin ne prévoit aucun réglage de mise en forme des saisies : c'est à chaque squelette d'avoir ses styles. Il respecte cependant la <a href="https://www.spip.net/fr_article3791.html" class="spip_out" rel="external">convention d'écriture des formulaire SPIP</a>. Il permet d'ajouter des classes spécifiques sur les saisies.</p> <h2 class="h2" id='Affichage-des-reponses-sous-forme-de-tableau'>Affichage des réponses sous forme de tableau<a class='sommaire-back sommaire-back-18' href='#s-Affichage-des-reponses-sous-forme-de-tableau' title='Back to the table of contents'></a></h2> <p>Le plugin <a href='https://contrib.spip.net/Formidable-Tablesorter-afficher-trier-et-filtrer-vos' class="spip_in" hreflang="fr">Formidable Tablesorter</a> permet d'afficher sous forme de tableau les réponses, dans l'espace privé, avec possibilité de tri et de filtre.</p> <h2 class="h2" id='Voir-aussi-sur-le-wiki'>Voir aussi sur le wiki <a class='sommaire-back sommaire-back-18' href='#s-Voir-aussi-sur-le-wiki' title='Back to the table of contents'></a></h2> <p><br />- <a href='https://contrib.spip.net/Complement-sur-Formidable' class="spip_in" hreflang="fr">Complément de doc et exemples sur les boucles et balises de formidable</a> <br />- <a href='https://contrib.spip.net/Styles-et-CSS-avec-formidable' class="spip_in" hreflang="fr">Exemples de stylage CSS d'un formulaire Formidable</a> <br />- <a href='https://contrib.spip.net/todoFormidable' class="spip_in" hreflang="fr">todoFormidable</a> <br />- <a href='https://contrib.spip.net/Formidable-Presentation-aux-Grottes-2010' class="spip_in" hreflang="fr">Formidable, présentation aux Grottes (2010)</a></p></div> </article> <article> <h1>Introduction à la création d'un livre</h1> <p>Maïeul — 2012-01-17T16:53:55Z</p> <div class='rss_chapo'><p>Pour produire un livre avec SPIP, on peut produire un PDF. Une des solutions est d'utiliser LaTeX. C'est celle que nous avons choisie.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-3" id="nav6a60d149474536.26140720"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-SPIP-et-LaTeX"></a><a href="#SPIP-et-LaTeX" class="spip_ancre">SPIP et LaTeX</a></li><li> <a id="s-Une-structure-de-livre-flexible"></a><a href="#Une-structure-de-livre-flexible" class="spip_ancre">Une structure de livre flexible</a></li><li> <a id="s-Comment-aborder-ce-projet-lt-lt-Un-livre-avec-SPIP"></a><a href="#Comment-aborder-ce-projet-lt-lt-Un-livre-avec-SPIP" class="spip_ancre">Comment aborder ce projet « Un livre avec SPIP »</a></li></ul></div><h2 class="h2" id='SPIP-et-LaTeX'>SPIP et LaTeX<a class='sommaire-back sommaire-back-3' href='#s-SPIP-et-LaTeX' title='Back to the table of contents'></a></h2> <p>SPIP permet de produire n'importe quel fichier de type <code class='spip_code spip_code_inline' dir='ltr'>text</code>. En général, il produit des fichiers <code class='spip_code spip_code_inline' dir='ltr'>HTML</code>. Mais avec le language de boucle de SPIP, on peut aussi produire des javascript, des css, etc.</p> <p>L'idée d'un livre avec SPIP est la suivante : produire tantôt du HTML, pour une consultation avec un navigateur, tantôt des fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>.</p> <p>Ces fichiers sont des fichiers <code class='spip_code spip_code_inline' dir='ltr'>LaTeX</code>. À partir d'un ensemble de fichiers LaTeX, il est possible en utilisant le compilateur LaTeX<span class="spip_note_ref"> [<a href="#nb8-1" class="spip_note" rel="appendix" title="Voir l'article de Wikipédia pour plus de détails sur ce qu'est LaTeX." id="nh8-1">1</a>]</span> de produire un fichier <code class='spip_code spip_code_inline' dir='ltr'>PDF</code>. C'est ce fichier qui devra être envoyé à l'impression.</p> <p>L'avantage d'utiliser LaTeX est : <br />- utiliser un logiciel libre plutôt que PrinceXml (qui permet de convertir du HTML en PDF, mais qui est propriétaire) <br />- utiliser un logiciel réputé pour ses grandes qualités typographiques (réputation qui n'est pas volée).</p> <p>Au final, on peut résumer ainsi le processus de production d'un livre avec SPIP.</p> <div class='spip_document_10325 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="43" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10325 '><strong>Schéma de production d'un livre avec SPIP </strong></div> </figcaption></figure> </div> <p>Pour ce projet, nous n'utilisons pas LaTeX, mais XeLaTeX qui est une variante de LaTeX ayant une gestion plus correcte de l'encodage Unicode<span class="spip_note_ref"> [<a href="#nb8-2" class="spip_note" rel="appendix" title="Sur les histoires d'encodage, voir le mémorable article sur la tour de Babel (…)" id="nh8-2">2</a>]</span>.</p> <h2 class="h2" id='Une-structure-de-livre-flexible'>Une structure de livre flexible<a class='sommaire-back sommaire-back-3' href='#s-Une-structure-de-livre-flexible' title='Back to the table of contents'></a></h2> <p>De même que SPIP peut produire n'importe quelle structure de page HTML, il peut produire n'importe quelle structure de fichier <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>.</p> <p>C'est pourquoi le système est divisé en deux plugins : <br />- LaTeXWheel qui permet à SPIP de transformer ses raccourcis typographiques (<code class='spip_code spip_code_inline' dir='ltr'>{</code>,<code class='spip_code spip_code_inline' dir='ltr'>-*</code> etc.) en code LaTeX. <br />- Zippeur version 2, qui permet d'assembler en un seul ZIP une série de fichier <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>. En effet, il est possible de créer des sous-fichiers LaTeX, un peu comme on crée des sous-squelettes avec <code class='spip_code spip_code_inline' dir='ltr'><INCLURE></code>. Par conséquent, on demandera à SPIP de produire un zip contenant un ensemble de fichier <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>, plutôt qu'un seul fichier <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> de grande taille.</p> <p>Un squelette correspondant à la structure du site <a href="http://programmer.spip.org" class="spip_url spip_out auto" rel="nofollow external">http://programmer.spip.org</a> a été concu. Il propose ainsi une structure possible. Il s'appuie sur ces deux plugins.</p> <h2 class="h2" id='Comment-aborder-ce-projet-lt-lt-Un-livre-avec-SPIP'>Comment aborder ce projet « Un livre avec SPIP »<a class='sommaire-back sommaire-back-3' href='#s-Comment-aborder-ce-projet-lt-lt-Un-livre-avec-SPIP' title='Back to the table of contents'></a></h2> <p>Cette documentation se divise en deux :</p> <p>- Une documentation pour les personnes ne connaissant ni LaTeX ni le mécanisme des boucles de SPIP. Cette documentation se subdivise en deux :</p> <ul class="spip" role="list"><li> Installer le squelette Documentation (celui de <a href="http://programmer.spip.org" class="spip_url spip_out auto" rel="nofollow external">http://programmer.spip.org</a>) et <a href='https://contrib.spip.net/Utiliser-le-squelette-Documentation-pour-rediger-un' class="spip_in" hreflang="fr">s'en servir pour faire un livre</a>.</li><li> <a href='https://contrib.spip.net/Fabriquer-les-tex-puis-le-PDF' class="spip_in" hreflang="fr">Exporter le contenu du livre en LaTeX, puis le convertir en PDF (A4)</a>.</li></ul> <p>- Une documentation, encore à écrire, pour les personnes souhaitant personnaliser leur livre, ce qui nécéssite de connaître :</p> <ul class="spip" role="list"><li> <a href="http://programmer.spip.org/-Ecriture-des-squelettes" class="spip_out" rel="external">Le système de squelettes de SPIP</a>.</li><li> Les bases de LaTeX. Pour les apprendre on pourra utiliser (entre autre) le livre de l'auteur « <a href="http://geekographie.maieul.net/95». Cette documentation se décompose en plusieurs parties :</li><li> [->4124" class="spip_out" rel="external">(Xe)LaTeX appliqué aux sciences humaines </a> </li><li> <a href='https://contrib.spip.net/Reference-de-LaTeXWheel' class="spip_in" hreflang="fr">Référence de LaTeXWheel</a></li></ul></div> <hr /> <div class='rss_notes'><div id="nb8-1"> <p><span class="spip_note_ref">[<a href="#nh8-1" class="spip_note" title="Footnotes 8-1" rev="appendix">1</a>] </span>Voir l'article de Wikipédia pour plus de détails sur ce qu'est <a href="https://en.wikipedia.org/wiki/LaTeX" class="spip_glossaire" rel="external">LaTeX</a>.</p> </div><div id="nb8-2"> <p><span class="spip_note_ref">[<a href="#nh8-2" class="spip_note" title="Footnotes 8-2" rev="appendix">2</a>] </span>Sur les histoires d'encodage, voir <a href="http://www.uzine.net/article1785.html" class="spip_out" rel="external">le mémorable article sur la tour de Babel du net</a>.</p> </div></div> </article> <article> <h1>Menus</h1> <p>RastaPopoulos — 2009-08-18T16:37:25Z</p> <div class='rss_chapo'><p>Créez enfin vos menus facilement !</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-8" id="nav6a60d1494f1004.05625735"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Introduction"></a><a href="#Introduction" class="spip_ancre">Introduction</a></li><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Creation-d-un-menu"></a><a href="#Creation-d-un-menu" class="spip_ancre">Création d'un menu</a></li><li> <a id="s-Les-differents-types-d-entrees"></a><a href="#Les-differents-types-d-entrees" class="spip_ancre">Les différents types d'entrées</a></li><li> <a id="s-Modification-des-entrees"></a><a href="#Modification-des-entrees" class="spip_ancre">Modification des entrées</a></li><li> <a id="s-Utiliser-les-menus-dans-votre-site"></a><a href="#Utiliser-les-menus-dans-votre-site" class="spip_ancre">Utiliser les menus dans votre site</a></li><li> <a id="s-Exporter-les-menus-vers-un-autre-site"></a><a href="#Exporter-les-menus-vers-un-autre-site" class="spip_ancre">Exporter les menus vers un autre site</a></li><li> <a id="s-Surcharge-des-fichiers-html"></a><a href="#Surcharge-des-fichiers-html" class="spip_ancre">Surcharge des fichiers <code class='spip_code spip_code_inline' dir='ltr'>menus/<type></code>.html</a></li></ul></div></p> <h2 class="h2" id='Introduction'>Introduction<a class='sommaire-back sommaire-back-8' href='#s-Introduction' title='Back to the table of contents'></a></h2> <p>Lorsqu'on ne se sert pas du plugin 'Menus', on est obligé de définir tous ses menus dans les squelettes, ce qui fait que l'administration du site n'a pas directement la main dessus, lorsqu'un changement est nécessaire, il faut en faire la demande à la personne en charge des squelettes.</p> <p>De plus, lorsqu'on veut des liens statiques (un lien vers un article précis, ou vers une page précise, ou vers un site externe) il faut les écrire en dur dans le squelette du menu.</p> <p>Le but du plugin 'Menus' est donc de permettre de facilement élaborer des menus au moyen d'une interface conviviale, directement dans la partie privée.</p> <p><strong>Attention ! Ce plugin ne s'occupe pas de la manière dont seront affichés les menus. Il permet de les créer facilement et d'en générer le HTML.</strong></p> <p>Pour l'affichage, voyez avec votre thème ou des plugins spécifiques tels que <a href='https://contrib.spip.net/Menu-anime-deroulant' class="spip_in" hreflang="fr">Menu animé déroulant</a>, <a href='https://contrib.spip.net/Menu-deroulant-2' class="spip_in" hreflang="fr">Menu Déroulant 2</a>, <a href='https://contrib.spip.net/Menu-accordeon-2' class="spip_in" hreflang="fr">Menu Accordéon 2</a> ou <a href='https://contrib.spip.net/Menu-jQuery-Superfish' class="spip_in" hreflang="fr">Menu jQuery Superfish</a>.</p> <h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-8' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Comme n'importe quel plugin.</p> <h2 class="h2" id='Creation-d-un-menu'>Création d'un menu<a class='sommaire-back sommaire-back-8' href='#s-Creation-d-un-menu' title='Back to the table of contents'></a></h2> <p>Le plugin ajoute un lien dans le bandeau de SPIP :</p> <div class='spip_document_7047 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>La page liste tous vos menus, et vous propose d'en créer un nouveau :</p> <div class='spip_document_7045 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menus_liste.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>D'abord vous devez identifier votre menu. Il faut lui donner un titre, ainsi qu'un mot-clé qui vous permettra de l'appeler facilement. En effet, vous ne pouvez pas prévoir à l'avance dans vos squelettes le numéro du menu. Grâce à ce mot-clé identifiant, vous n'avez donc pas à modifier vos squelettes à chaque fois. Vous pouvez également saisir une classe qui sera ajoutée au premier élément ul du menu généré. Ceci peut permettre d'activer la gestion de l'affichage par un plugin tiers.</p> <div class='spip_document_7046 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menus_nouveau.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Vous pouvez alors commencer à construire le menu en ajoutant des entrées :</p> <div class='spip_document_7048 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menu_construction.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div><h2 class="h2" id='Les-differents-types-d-entrees'>Les différents types d'entrées<a class='sommaire-back sommaire-back-8' href='#s-Les-differents-types-d-entrees' title='Back to the table of contents'></a></h2> <p>Les Menus sont fournis pour l'instant avec plus de dix types d'entrées qui permettent déjà de construire la plupart des menus facilement.</p> <p>N'hésitez pas à en proposer d'autres !</p> <div class='spip_document_8573 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menu_choix.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Voici la description de quelques uns des types d'entrées disponibles :</p> <p>- <strong>Lien arbitraire</strong> : vous pouvez créer des liens vers ce que vous voulez en donnant une adresse et un titre.</p> <div class='spip_document_7049 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menus_lien_arbitraire.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>- <strong>Objet de SPIP</strong> : crée un lien vers n'importe quel objet éditorial de SPIP. Ça peut être un article, une rubrique ou n'importe quoi venant d'un plugin.</p> <div class='spip_document_7050 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menus_objet_spip.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>- <strong>Liste dynamique de rubriques et d'articles</strong> : vous pouvez afficher les rubriques de SPIP, y compris de manière arborescente. Pour cela, il suffit de définir la rubrique dans laquelle il faut commencer la liste, le niveau maximum de sous-rubriques, les exclusions éventuelles, le type de tri... Vous pouvez aussi inclure les articles dans l'arborescence, limiter leur nombre, en gérer le tri...</p> <div class='spip_document_7051 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="119" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menus_liste_dynamique.png' class="spip_doc_lien mediabox" type="image/png"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_credits crayon document-credits-7051 '>Détails des options d'une entrée de menu : Liste ou arborescence de rubriques et d'articles (avec beaucoup d'options) </div> </figcaption></figure> </div><h2 class="h2" id='Modification-des-entrees'>Modification des entrées<a class='sommaire-back sommaire-back-8' href='#s-Modification-des-entrees' title='Back to the table of contents'></a></h2> <p>Lorsque vous avez déjà ajouté des choses, vous obtenez alors la liste des entrées sous cette forme :</p> <div class='spip_document_7066 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menus_construction_2.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Vous pouvez alors déplacer les entrées pour modifier leur ordre, les supprimer, changer leurs paramètres et créer des sous-menus en-dessous des entrées qui le permettent.</p> <h2 class="h2" id='Utiliser-les-menus-dans-votre-site'>Utiliser les menus dans votre site<a class='sommaire-back sommaire-back-8' href='#s-Utiliser-les-menus-dans-votre-site' title='Back to the table of contents'></a></h2> <p>Pour afficher un menu dans votre site, il vous suffit d'inclure un petit squelette où vous le désirez :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>#INCLURE{fond=inclure/menu, env, identifiant=<votre_menu>}</code></pre></div> <p>Vous pouvez aussi tester votre menu facilement en cliquant sur le bouton «Voir en ligne» ou en allant sur la page : <code class='spip_code spip_code_inline' dir='ltr'>spip.php?menu<numero></code></p> <h2 class="h2" id='Exporter-les-menus-vers-un-autre-site'> Exporter les menus vers un autre site <a class='sommaire-back sommaire-back-8' href='#s-Exporter-les-menus-vers-un-autre-site' title='Back to the table of contents'></a></h2> <p>Imaginons que sur une version de votre site en local vous réorganisez tous les menus. Pour reporter ces changements en prod, il faut exporter les menus dans un fichier et les réimporter en prod.</p> <p>S'assurer tout d'abord que le plugin Yaml est activé .</p> <div class='spip_document_12963 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Lorsqu'il est activé une icône apparaît : exporter ce menu</p> <div class='spip_document_12964 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menus_export-annote.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Le sauvegarder sur votre ordinateur</p> <div class='spip_document_12965 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Sur le site de destination, il suffit de créer un nouveau menu avec le même identifiant (penser à le supprimer avant s'il existe). Et à la création, si le plugin YAML est bien activé, la boite de choix de fichier est proposée.</p> <div class='spip_document_12966 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menus_import_annote.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div><h2 class="h2" id='Surcharge-des-fichiers-html'>Surcharge des fichiers <code class='spip_code spip_code_inline' dir='ltr'>menus/<type></code>.html<a class='sommaire-back sommaire-back-8' href='#s-Surcharge-des-fichiers-html' title='Back to the table of contents'></a></h2> <p>Si pour des besoins particuliers, on doit surcharger un fichier du répertoire menus/, il ne faut pas oublier de copier le fichier XML de description qui va avec.</p> <p>En effet, le plugin cherche le fichier XML au même endroit que le fichier HTML.</p></div> </article> <article> <h1>API CacheLab 1. Action sur des caches ciblés</h1> <p>JLuc — 2018-09-28T17:33:02Z</p> <div class='rss_chapo'><p>Chaque fois qu'un utilisateur crée ou modifie un objet (article, forum, favori, etc), SPIP invalide tout le cache. Tous les caches en mémoire devront ensuite être calculés de nouveau au lieu d'être utilisés... même s'ils sont encore valables. Parfois, c'est rageant de ne plus pouvoir bénéficier d'aucun de ces caches, alors qu'on vient juste d'ajouter une virgule dans un texte ou qu'un internaute vient de poster un forum dans un coin lointain du site, ou juste un “J'aime”...</p> <p>CacheLab fournit une API permettant d'appliquer différentes actions sur des caches ciblés, au rang desquelles figure l'invalidation. Le ciblage se fait par une condition qui porte sur le chemin du squelette, sur la session ou sur le contexte ayant généré ce cache. Cela permet de décrire les caches ciblés et de leur appliquer l'action. Dans le cas d'une invalidation, seuls les caches le nécessitant sont invalidés, et aucun autre.</p> <p>Cette partie de <var>CacheLab</var> doit être utilisé avec le plugin <a href='https://contrib.spip.net/Plugin-memoization' class="spip_in" hreflang="fr">memoization</a> activé avec le cache <var>APC</var> ou <var>APCu</var>.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-5" id="nav6a60d149557e85.77126535"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Fonction"></a><a href="#Fonction" class="spip_ancre">Fonction <code class='spip_code spip_code_inline' dir='ltr'>controler_invalideur</code></a></li><li> <a id="s-Fonction-cachelab_cibler"></a><a href="#Fonction-cachelab_cibler" class="spip_ancre">Fonction cachelab_cibler</a></li><li> <a id="s-Logs-d-informations-sur-le-fonctionnement"></a><a href="#Logs-d-informations-sur-le-fonctionnement" class="spip_ancre">Logs d'informations sur le fonctionnement</a></li><li> <a id="s-Questions-et-reponses"></a><a href="#Questions-et-reponses" class="spip_ancre">Questions et réponses</a></li><li> <a id="s-Voir-aussi"></a><a href="#Voir-aussi" class="spip_ancre">Voir aussi</a></li></ul></div><style> code {background-color: #DDD} </style> <p>CacheLab n'installe aucune stratégie d'invalidation, car ces stratégies dépendent de chaque site, mais CacheLab donne le moyen de le faire au moyen des fonctions d'API : <br />- API d'action locale : les fonctions <code class='spip_code spip_code_inline' dir='ltr'>controler_invalideur</code> et <code class='spip_code spip_code_inline' dir='ltr'>cachelab_cibler</code> que décrit cet article. <br />- API d'action globale : ces fonctions interceptent les signaux d'invalidations de SPIP et permettent de les interpréter de la manière désirée globalement pour le site.</p> <h2 class="h2" id='Fonction'>Fonction <code class='spip_code spip_code_inline' dir='ltr'>controler_invalideur</code><a class='sommaire-back sommaire-back-5' href='#s-Fonction' title='Back to the table of contents'></a></h2> <p>Dans SPIP, la fonction qui invalide le cache est <a href="https://code.spip.net/autodoc/tree/ecrire/inc/invalideur.php.html#function_suivre_invalideur" class="spip_out" rel="external"><code class='spip_code spip_code_inline' dir='ltr'>suivre_invalideur</code></a>. Cette fonction invalide TOUT le cache. Il est toutefois possible de la désactiver totalement ou de la désactiver pour certains types d'objets. C'est ce que facilite la fonction <code class='spip_code spip_code_inline' dir='ltr'>controler_invalideur</code>.</p> <p>Les arguments sont :</p> <p><strong>action</strong> <br />- <code class='spip_code spip_code_inline' dir='ltr'>stop</code> : arrêter le fonctionnement par défaut d'invalidation des caches par <code class='spip_code spip_code_inline' dir='ltr'>suivre_invalideur</code>. <br />- <code class='spip_code spip_code_inline' dir='ltr'>go</code> : reprendre le fonctionnement par défaut des invalidations. <br />- <code class='spip_code spip_code_inline' dir='ltr'>select</code> : spécifier les types d'objet dont la modification est invalidante (les autres n'invalident pas).</p> <p><strong>objets_invalidants</strong> : non spécifié, ou liste des objets invalidants. Cet argument sert uniquement pour l'action <code class='spip_code spip_code_inline' dir='ltr'>select</code> : c'est la liste (array) des types d'objets qui continuent à invalider globalement le cache.</p> <p>Cette fonction peut être appelée dans le code php <br />- soit dans le mes_options du plugin, pour totalement supprimer l'invalidation SPIP des caches (avec <code class='spip_code spip_code_inline' dir='ltr'>controler_invalideur('stop');</code>) et ensuite cibler au cas par cas <br />- soit au cas par cas. Par exemple, dans le traitement d'un formulaire, on pourra stoper l'invalidation juste avant d'appeler l'API SPIP d'enregistrement d'une modification, afin de préserver le cache, puis cibler précisément l'invalidation adéquate avec <code class='spip_code spip_code_inline' dir='ltr'>cachelab_cibler</code>, puis restaurer le fonctionnement normal de l'invalidation avec (avec <code class='spip_code spip_code_inline' dir='ltr'>controler_invalideur('go');</code>)</p> <h2 class="h2" id='Fonction-cachelab_cibler'>Fonction cachelab_cibler<a class='sommaire-back sommaire-back-5' href='#s-Fonction-cachelab_cibler' title='Back to the table of contents'></a></h2> <p>Cette fonction permet de réaliser une action sur un certain nombre de caches, ciblés en fonctions de conditions qui portent sur leur chemin, sur l'environnement du squelette à l'origine de ce cache (variables de contexte), sur le contenu du cache lui-même ou sur ses métadonnées.</p> <p>C'est la fonction principale qui doit être appelée pour faire une invalidation ciblée, lorsqu'on a désactivé l'invalidation totale au moyen de <code class='spip_code spip_code_inline' dir='ltr'>controler_invalideur</code>.</p> <p>L'appel est simple puisqu' il y a 3 arguments : action, condition, options.</p> <p><strong>action</strong> : l'action à réaliser sur les caches filtrés. Les actions sont en anglais. <br />- <code class='spip_code spip_code_inline' dir='ltr'>del</code> : détruire les caches ciblés. En effet, SPIP 3 ne peut pas “invalider” spécifiquement un cache : pour s'en débarrasser, il faut le supprimer. Lorsque cette doc ne le précise pas, c'est elle qui est supposée utilisée. <br />- <code class='spip_code spip_code_inline' dir='ltr'>list</code> : renvoie la liste des clés des caches ciblés. <br />- <code class='spip_code spip_code_inline' dir='ltr'>list_html</code> : renvoie la liste des contenus HTML des caches ciblés, indexés par leur clé. Attention, cela peut être volumineux. On peut limiter le nombre de résultats en spécifiant <code class='spip_code spip_code_inline' dir='ltr'>$option['nb']</code>. <br />- <code class='spip_code spip_code_inline' dir='ltr'>clean</code> : parcourir les caches et supprimer les caches périmés (pour SPIP). Toute action, sauf 'pass' le fait déjà, sauf option contraire. <br />- <code class='spip_code spip_code_inline' dir='ltr'>pass</code> : parcourir les caches mais ne rien faire, pas même la suppression nettoyage des caches périmés (pour SPIP) qui est faite par défaut pour les autres actions. <br />- <code class='spip_code spip_code_inline' dir='ltr'>get</code> : renvoyer le premier cache ciblé (métadonnées et contenu). <br />- <code class='spip_code spip_code_inline' dir='ltr'>get_html</code> : renvoyer le contenu du premier cache ciblé (html généré à partir du squelette SPIP)</p> <p><strong>conditions</strong> : l'énoncé des conditions que doit satisfaire un cache. Les conditions sont en français. <br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>cachelab_cibler</code> applique l'action indiquée à tous les caches qui satisfont à la fois la condition sur la session (si cette condition est présente) ET sur le chemin du squelette (s'il y en a une) ET sur le contexte (s'il y en a une). <br class='autobr' /> La condition sur le chemin n'est évaluée que si la condition sur la session est satisfaite (si présente).<br class='autobr' /> La condition sur l'objet n'est évaluée que si la condition sur la session et sur le chemin sont satisfaits (si présents).</p> <p><code class='spip_code spip_code_inline' dir='ltr'>$condition</code> est un tableau dont les entrées peuvent être :</p> <p>- <code class='spip_code spip_code_inline' dir='ltr'>chemin</code> : spécification du chemin des squelettes ciblés. C'est la plus simple et la plus courante des conditions utilisée. <br class='autobr' /> Par défaut, c'est une chaîne constituée des morceaux de chemins ciblés, séparés par un <code class='spip_code spip_code_inline' dir='ltr'>|</code> s'il y en a plusieurs. Cette chaine sera décomposée et les différents morceaux de chemins seront cherchés avec <code class='spip_code spip_code_inline' dir='ltr'>strpos</code>. <br class='autobr' /> Exemple : <code class='spip_code spip_code_inline' dir='ltr'>admin|liste</code> ciblera tous les caches des squelettes dont le chemin ou le nom contient 'admin' ou 'liste'. <br class='autobr' /> On peut indiquer des dossiers et sous-dossiers : <code class='spip_code spip_code_inline' dir='ltr'>liste/article</code></p> <p>- <code class='spip_code spip_code_inline' dir='ltr'>cle_objet</code> : le nom de l'argument d'inclusion (par exemple un nom de clé primaire) et <code class='spip_code spip_code_inline' dir='ltr'>id_objet</code> : la valeur ciblée de cette clé. Ces 2 couples (index,valeur) vont nécessairement ensemble. <br class='autobr' /> Exemple : <code class='spip_code spip_code_inline' dir='ltr'>cachelab_cibler('del', ['cle_objet'=>'id_article', 'id_objet'=>123]);</code> effacera tous les caches présentant <code class='spip_code spip_code_inline' dir='ltr'>id_article=123</code> dans les paramètres de leur inclusion (ou <code class='spip_code spip_code_inline' dir='ltr'>id_article</code> simplement, avec un <code class='spip_code spip_code_inline' dir='ltr'>id_article</code> valant <code class='spip_code spip_code_inline' dir='ltr'>123</code>).</p> <p>Les arguments d'inclusions ciblés peuvent ne pas être des clé primaires.<br class='manualbr' />Exemple : <code class='spip_code spip_code_inline' dir='ltr'>cachelab_cibler('del', ['cle_objet'=>'couleur', 'id_objet'=>'bleu']);</code> invalidera les caches des inclusions ayant “couleur => bleu” dans leur contexte. Dans ce cas, la valeur ciblée peut être d'un autre type (à confirmer) que int ou string.</p> <p>Depuis la version 1.6.1 du plugin, il est également possible d'indiquer, pour id_objet, une suite de valeurs cibles, séparées par des '|' comme pour le ciblage par le chemin. Ainsi, <code class='spip_code spip_code_inline' dir='ltr'>cachelab_cibler('del', ['cle_objet'=>'id_article', 'id_objet'=>'11|21|31');</code> effacera tous les caches dont les contextes contiennent un id_article valant 11, 21 ou 31.</p> <p>- <code class='spip_code spip_code_inline' dir='ltr'>contexte</code> : spécification d'un tableau de couples <code class='spip_code spip_code_inline' dir='ltr'>(clé_objet,id_objet)</code>. Seuls les caches dont le contexte inclue l'ensemble de ces couples <code class='spip_code spip_code_inline' dir='ltr'>(clé,valeur)</code> sont ciblés. On utilisera par exemple le ciblage par contexte lorsqu'une noisette reçoit une simple référence dans son environnement sous la forme de 2 variables d'environnement : 'objet' et 'id_objet'.</p> <div class="precode"><pre class='php spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>cachelab_cibler( 'del', [ 'chemin'=>'inclure/documents', 'contexte' => ['objet'=>'unetable', 'id_objet'=>$id_unetable] ]);</code></pre></div> <p>- <code class='spip_code spip_code_inline' dir='ltr'>session</code> : seuls sont ciblés les squelettes sessionnés pour la session indiquée. <br class='autobr' /> La valeur spécifiée n'est pas un id_auteur, mais un identifiant de session (nombre hexa de 8 caractères, tel que renvoyé par <code class='spip_code spip_code_inline' dir='ltr'>spip_session()</code> ou trouvé dans <code class='spip_code spip_code_inline' dir='ltr'>$GLOBALS['cache_utilise_session']</code>). <br class='autobr' /> Une valeur spéciale : '<code class='spip_code spip_code_inline' dir='ltr'>courante</code>' permet de spécifier la session courante. <br class='autobr' /> C'est ainsi que <code class='spip_code spip_code_inline' dir='ltr'>cachelab_cibler('del', ['chemin'=>'liste', 'session'=>'courante'])</code> effacera tous les caches des listes sessionnées pour la session courante.</p> <p>- <code class='spip_code spip_code_inline' dir='ltr'>plus</code> : spécification d'une méthode de filtrage autre que celles incorporées dans le plugin. Cela permet des extensions personnalisées pour des filtrages adaptés à un squelette particulier. La manière de créer une nouvelle méthode de filtrage est détaillée sur la page <a href='https://contrib.spip.net/Extensions-nouveaux-ciblages-et-gestion-des-caches' class="spip_in" hreflang="fr">Extensions : nouveaux ciblages et gestion des caches périmés</a>.</p> <p>Les conditions déjà décrites se combinent par un ET (AND) logique et permettent de cibler aussi précisément que possible le jeu de cache ciblé. On peut, par exemple, spécifier un chemin, une valeur de contexte et un couple (cle_objet, id_objet) et seuls les caches vérifiant l'ensemble de ces critères seront ciblés.</p> <p>Il arrive qu'on ait besoin de cibler plusieurs jeux de caches, c'est à dire qu'on veut combiner plusieurs conditions de manière inclusive, par un OU (OR) logique. Par exemple : chemin OU valeur de contexte OU id_objet précis. Pour combiner des conditions de manière inclusive, on peut <br />- faire des appels successifs à <code class='spip_code spip_code_inline' dir='ltr'>cachelab_cibler</code>, <br />- ou bien (plus efficace) définir une nouvelle méthode de filtrage et l'appeler via <code class='spip_code spip_code_inline' dir='ltr'>plus</code>, <br />- ou bien faire appel au critère de condition <code class='spip_code spip_code_inline' dir='ltr'>ou</code>. Il faut pour cela utiliser une entrée 'ou' ou 'or'. C'est équivalent à appeler cachelab_cibler successivement pour chacune de ces conditions, mais c'est plus rapide puisque ça ne parcourera qu'une seule fois la liste des caches.</p> <p>Exemple pour une utilisation du plugin 'favori' : avec l'appel à cachelab_cibler suivant, 2 jeux de caches seront ciblés : <br />- les noisettes ayant 'favori' dans leur chemin et recevant un certain id_favori dans leur environnement <br />- les noisettes ayant 'mes_favoris' dans leur chemin et un certain id_auteur dans leur environnement</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>$cible = cachelab_cibler( 'del', [ 'ou' => [ ['chemin'=>'favori', 'cle_objet'=>'id_favori', 'id_objet'=>$id_favori], ['chemin'=>'mes_favoris', 'cle_objet'=>'id_auteur', 'id_objet'=>$id_auteur] ]]); </code></pre></div> <p><strong>options</strong> : tableau facultatif d'options à passer à l'action ou au filtrage. Ces options permettent de modifier le filtrage ou d'enrichir les résultats renvoyés par la fonction.</p> <p>- <code class='spip_code spip_code_inline' dir='ltr'>methode_chemin</code> : Par défaut, les chemins sont reconnus avec la fonction php <code class='spip_code spip_code_inline' dir='ltr'>strpos</code>. Toutefois, 2 autres valeurs sont possible :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>regexp</code> : c'est alors un test d'expression régulière qui est utilisé, et qui permet une plus grande finesse de ciblage. Par exemple, si <code class='spip_code spip_code_inline' dir='ltr'>$condition['methode_chemin']</code> vaut <code class='spip_code spip_code_inline' dir='ltr'>inclu.e|liste.*admin</code>, alors les chemins de squelettes contenant 'inclure' ou 'include' seront ciblés, ainsi que tous les chemins de squelette dans un dossier 'liste' et ayant 'admin' dans le nom... ou ayant 'liste' puis 'admin' dans leur nom.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>==</code> ou <code class='spip_code spip_code_inline' dir='ltr'>egal</code> ou ou <code class='spip_code spip_code_inline' dir='ltr'>equal</code> : dans ce cas c'est un test d'égalité qui est fait. Cette valeur sera souvent combinée à l'option <code class='spip_code spip_code_inline' dir='ltr'>partie_chemin</code> afin de préciser quelle partie du chemin doit être égale à la valeur indiquée.</li></ul> <p>- <code class='spip_code spip_code_inline' dir='ltr'>partie_chemin</code> : permet de spécifier quelle partie du chemin est testée. Le chemin complet, c'est le chemin du squelette depuis le dossier de squelettes (comme pour un <code class='spip_code spip_code_inline' dir='ltr'>inclure_spip</code>), avec des séparateurs <code class='spip_code spip_code_inline' dir='ltr'>/</code> au niveau des dossiers et avec en prime en suffixe l'identifiant de session (un hexa qui peut difficilement matcher avec un nom de squelette et donc qui ne gêne pas). Les différentes valeurs possibles sont :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>tout</code> ou <code class='spip_code spip_code_inline' dir='ltr'>chemin</code> : teste l'entièreté du chemin et du nom de fichier;</li><li> <code class='spip_code spip_code_inline' dir='ltr'>dossier</code> : teste le répertoire du squelette seulement. Comme ça, des squelettes dans les sous-dossiers ne sont pas ciblés ;</li><li> <code class='spip_code spip_code_inline' dir='ltr'>fichier</code> : teste le nom de fichier du squelette seulement, pas l'arborescence des dossiers qui y mènent.</li></ul> <p>- <code class='spip_code spip_code_inline' dir='ltr'>list</code> et <code class='spip_code spip_code_inline' dir='ltr'>chrono</code> : permettent de récupérer les listes de caches et la durée du filtrage, pour aller plus loin et optimiser le ciblage.</p> <p>- <code class='spip_code spip_code_inline' dir='ltr'>clean</code> : par défaut, cachelab détruit les caches SPIP périmés que APCCache garde encore en mémoire, dés qu'il en rencontre un. Ce comportement est désactivé lorsque <code class='spip_code spip_code_inline' dir='ltr'>$options</code> a un index 'clean' vide.</p> <p><strong>Préciser le diagnostic</strong></p> <p>Lorsqu'on cible avec une action <code class='spip_code spip_code_inline' dir='ltr'>del</code>, il n'est en général pas utile d'utiliser le retour de la fonction... sauf pour la surveillance et l'optimisation.</p> <p>La fonction <code class='spip_code spip_code_inline' dir='ltr'>cachelab_cibler</code> renvoie en effet le tableau des statistiques récoltées lors du parcours des caches. Ces données permettent d'étudier le cache, de connaître le coût de l'invalidation ciblée (en ms) et éventuellement d'aller plus loin dans l'optimisation.</p> <p>Le tableau renvoyé contient les index suivants :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>nb_candidats</code> : le nombre de caches candidats (corrects et valides)</li><li> <code class='spip_code spip_code_inline' dir='ltr'>nb_cible</code> : le nombre de caches ciblés par les conditions spécifiées</li><li> <code class='spip_code spip_code_inline' dir='ltr'>nb_clean</code> : le nombre de caches vidés car périmés par APC ou invalidés car trop vieux vu la durée du cache SPIP</li><li> <code class='spip_code spip_code_inline' dir='ltr'>chrono</code> : le temps total du filtrage, en millisecondes.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>l_cible</code> : liste des clés des caches ciblés. Pour obtenir ces sorties, le tableau d'options passé à la fonction doit contenir une entrée <code class='spip_code spip_code_inline' dir='ltr'>list</code> vraie.</li></ul> <p>Exemple de résultats renvoyé :</p> <table class="table spip"> <tbody> <tr class='row_odd odd'> <td>Filtrage du chemin par 'strpos' :<br class='autobr' /> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[nb_cible] => 8 [nb_clean] => 0 [nb_candidats] => 2325 [chrono] => 10.415 ms </code></pre></div></td> <td>Filtrage du chemin par 'regexp' :<br class='autobr' /> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[nb_cible] => 29 [nb_clean] => 0 [nb_candidats] => 1546 [chrono] => 81.342 ms </code></pre></div></td></tr> </tbody> </table> <p>On peut aussi définir ses propres actions : voir <a href='https://contrib.spip.net/Extensions-nouveaux-ciblages-et-gestion-des-caches' class="spip_in" hreflang="fr">Extensions : nouveaux ciblages et gestion des caches périmés</a>.</p> <p><strong>Efficacité et coût pour le CPU</strong></p> <p>Sur un hébergement où chaque site dispose de son propre espace pour les caches APC, les durées de filtrage ne sont pas pénalisantes. Surtout qu'elles ne se font que lorsqu'il y a une invalidation. Le coût du ciblage de l'invalidation est compensé par le bien meilleur taux de cache : en pratique on atteint assez rapidement un taux de cache de 97% à 99,9%. SPIP n'est alors sollicité pour l'évaluation d'un squelette que lorsqu'il y a réellement besoin de le calculer ou de le mettre à jour.</p> <p>- Le filtrage par regexp est évidemment plus long que par strpos. Et l'interrogation du contexte est un peu plus lente puisqu'il faut accéder au contenu des caches.</p> <p>- Le filtrage par le contenu du contexte est plus coûteux si les données du cache sont cryptées par mémoization, comme c'est nécessaire lorsque le cache APCu est partagé entre utilisateurs. Si les données sont codées, le commit <a href="https://zone.spip.org/trac/spip-zone/changeset/111634" class="spip_out" rel="external">111634</a> indique qu'il faut 1 ou 2µs pour chaque décodage. De plus, leur nombre peut être beaucoup plus grand puisque les caches de tous les sites se cumulent. Dans ce cas, le parcours va prendre plus de temps et ça peut devenir inacceptable. On pourrait envisager des développements pour améliorer les temps d'accés sur ce type d'hébergement (Voir <a href='https://contrib.spip.net/Complements-CacheLab-et-todo' class="spip_in" hreflang="fr">todo</a> : “Sous-listes de caches”).</p> <h2 class="h2" id='Logs-d-informations-sur-le-fonctionnement'>Logs d'informations sur le fonctionnement<a class='sommaire-back sommaire-back-5' href='#s-Logs-d-informations-sur-le-fonctionnement' title='Back to the table of contents'></a></h2> <p>Plusieurs fichiers de logs sont produits soit systématiquement, soit à la demande par passage de paramètre aux fonctions de l'API, soit de manière paramétrable globalement par des constantes.</p> <p>Ces informations permettent de suivre globalement le fonctionne du cachelab, et d'optimiser éventuellement le ciblage, par un meilleur choix des conditions de ciblage, du découpage des noisettes ou du choix des arguments reçus par ces noisettes ciblées.</p> <p><strong>La constante <code class='spip_code spip_code_inline' dir='ltr'>LOG_CACHELAB_CHRONO</code></strong>, lorsqu'elle vaut <code class='spip_code spip_code_inline' dir='ltr'>true</code> demande de loger un maximum d'information.</p> <p><strong>Le fichier <code class='spip_code spip_code_inline' dir='ltr'>cachelab_chrono.log</code></strong> contient alors les logs détaillés des temps de ciblage : la condition, le nombre de cache ciblé, le nombre total de cache à ce moment et la durée du ciblage.</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>info: cachelab_cibler(del) en 47.324 ms (0 caches sur 17660) Array ( [chemin] => facette|liste/article ) info: cachelab_cibler(del) en 264.248 ms (0 caches sur 17660) Array ( [ou] => Array ( [0] => Array ( [cle_objet] => id_article [id_objet] => 17714 ) [1] => Array ( [chemin] => facette|liste/article) ))</code></pre></div> <p><strong>Le fichier <code class='spip_code spip_code_inline' dir='ltr'>cachelag_toomany_del.log</code></strong> indique quelles ciblages renvoient un grand nombre de caches. On y trouve la condition ciblant les caches, la durée du ciblage, le nombre de caches ciblés et le nombre total de cache à ce moment.</p> <p>Le seuil déclanchant ce log peut être paramétré par la constante <code class='spip_code spip_code_inline' dir='ltr'>LOG_CACHELAB_TOOMANY_DEL</code>. Par défaut c'est 100.</p> <p>Exemple :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> ### cachelab_cibler(del) en 186.538 ms (109 caches sur 14263) Array ( [cle_objet] => id_article [id_objet] => 17986) ### cachelab_cibler(del) en 64.819 ms (127 caches sur 17871) Array ([chemin] => facette|liste/article)</code></pre></div> <p><strong>Le fichier <code class='spip_code spip_code_inline' dir='ltr'>cachelag_slow_del.log</code></strong> indique quelles ciblages prennent longtemps à se faire. On y trouve la condition ciblant les caches, la durée du ciblage, le nombre de caches ciblés et la durée du ciblage.</p> <p>Le seuil déclanchant ce log peut être paramétré par la constante <code class='spip_code spip_code_inline' dir='ltr'>LOG_CACHELAB_SLOW</code>. Par défaut c'est 100ms.</p> <p>Exemple :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>INFO: cachelab_cibler(del) en 461.381 ms (16 caches sur 16901) Array ( [cle_objet] => id_truc [id_objet] => 17588 )</code></pre></div><h2 class="h2" id='Questions-et-reponses'>Questions et réponses <a class='sommaire-back sommaire-back-5' href='#s-Questions-et-reponses' title='Back to the table of contents'></a></h2><ul class="spip" role="list"><li> « <strong>Dans des inclures imbriqués, est-il possible d'invalider certains inclures de la branche sans forcement invalider tout les inclures enfants ? Par exemple en <code class='spip_code spip_code_inline' dir='ltr'>zcore</code> il y a <code class='spip_code spip_code_inline' dir='ltr'>content > liste</code> Si j'invalide <code class='spip_code spip_code_inline' dir='ltr'>content</code>, <code class='spip_code spip_code_inline' dir='ltr'>liste</code> sera-t-il invalidé ?</strong> »</li></ul> <p>La réponse dépend des conditions et options utilisées. Avec la simple option <code class='spip_code spip_code_inline' dir='ltr'>'chemin'=>'content'</code>, les squelettes des sous-dossiers sont aussi invalidés puisque leur chemin contient le chemin ciblé. Mais plusieurs options permettent d'obtenir le ciblage voulu :</p> <p>1) Une option de filtrage permet de n'invalider que les squelettes d'un dossier ciblé : <code class='spip_code spip_code_inline' dir='ltr'>'partie_chemin' => 'dossier'</code>. Ça répond assez précisément à la demande. Voir doc plus haut.</p> <p>2) Une autre manière de faire serait de passer <code class='spip_code spip_code_inline' dir='ltr'>methode_chemin=regexp</code> et donner comme chemin une expression régulière qui exclue les squelettes dans les sous dossiers. Par exemple : <code class='spip_code spip_code_inline' dir='ltr'>chemin=content\/[^\/]*$</code></p> <p>3) Une autre manière de faire serait de <a href='https://contrib.spip.net/Extensions-nouveaux-ciblages-et-gestion-des-caches' class="spip_in" hreflang="fr">créer une extension de filtrage</a> <code class='spip_code spip_code_inline' dir='ltr'>contentseul</code> qui cible spécifiquement ce dossier. <br />- créer une fonction <code class='spip_code spip_code_inline' dir='ltr'>cachelab_ciblercache_contentseul</code> qui opérerait le filtrage, par exemple avec la même regexp que ci dessus ou bien ainsi :</p> <div class="precode"><pre class='php spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>function cachelab_ciblercache_contentseul($action, $conditions, $options, $cle, &$data, &$stats) { return (strpos($cle,'content') and (substr_count($cle, '/') < 2)); }</code></pre></div> <p><br />- Et pour l'appeler, il suffira alors de passer une condition avec <code class='spip_code spip_code_inline' dir='ltr'>plus=contentseul</code>.</p> <ul class="spip" role="list"><li> <strong>« Et memcache, XCache et redis ? »</strong></li></ul> <p>Cachelab n'est prévu que pour APCu.</p> <p>Cependant, des devs seraient bienvenus : contrairement à <code class='spip_code spip_code_inline' dir='ltr'>XRay</code> qui en son état actuel est trés lié à <code class='spip_code spip_code_inline' dir='ltr'>APC</code>, <code class='spip_code spip_code_inline' dir='ltr'>CacheLab</code> n'appelle qu'une seule fonction spécifique à <code class='spip_code spip_code_inline' dir='ltr'>APC</code> : celle qui permet de lister l'ensemble des caches. Il serait possible d'étendre <code class='spip_code spip_code_inline' dir='ltr'>memoization</code> pour disposer optionnellement d'une méthode <code class='spip_code spip_code_inline' dir='ltr'>iterate</code> (c'est d'ailleurs fait dans un <a href="https://gitlab.com/JLuc/memoization.dev" class="spip_out" rel="external">fork du plugin Memoization</a>. Sur option, <code class='spip_code spip_code_inline' dir='ltr'>Memoïzation</code> tiendrait à jour une liste des caches et alors cacheLab pourrait tout de suite fonctionner avec les autres systèmes de caches. Il serait certainement possible de faire la même chose pour memcache, XCache et redis.</p> <ul class="spip" role="list"><li> <strong>Quel est l'état de dev du plugin ? </strong></li></ul> <p>Les fonctions décrites sur cette page sont stables et éprouvées. Les éventuels bugs détectés sont gérés sur <a href="https://git.spip.net/spip-contrib-extensions/cachelab/issues" class="spip_out" rel="external">le bugtracker</a> et d'éventuels développements futurs sont imaginés sur <a href='https://contrib.spip.net/Complements-CacheLab-et-todo' class="spip_in" hreflang="fr">Compléments CacheLab et todo</a>.<br class='autobr' /> Une seconde partie du plugin est fonctionnelle, mais susceptible d'évoluer (<a href='https://contrib.spip.net/API-CacheLab-2-Actions-globales-par-type-d' class="spip_in" hreflang="fr">API CacheLab 2. Actions globales par type d'invalidation</a>)</p> <ul class="spip" role="list"><li> <strong>Quels sont les résultats obtenus ?</strong></li></ul> <p>Sur le site qui a permis le développement de cachelab, 100% des invalidations du cache sont optimisées. <br />- Il n'y a plus aucune invalidation totale du cache, sauf si on le désire et qu'on en fait la demande explicitement. <br />- Seuls les caches qu'il faut réellement invalider sont invalidés.</p> <p>Avec cachelab, le taux de hit du cache SPIP est passé de en moyenne 40% à plus de 99% après quelques heures ou jours de fonctionnement (aprés le <a href="https://core.spip.net/issues/4235" class="spip_out" rel="external">fix du bug de contamination du sessionnement</a>). C'est à dire qu'aucun calcul n'est fait inutilement.</p> <h2 class="h2" id='Voir-aussi'>Voir aussi <a class='sommaire-back sommaire-back-5' href='#s-Voir-aussi' title='Back to the table of contents'></a></h2> <p><br />- <a href='https://contrib.spip.net/En-prime-CacheLab-etend-CACHE-et-INCLURE' class="spip_in" hreflang="fr">En prime : CacheLab étend #CACHE et INCLURE</a> <br />- <a href='https://contrib.spip.net/API-CacheLab-2-Actions-globales-par-type-d' class="spip_in" hreflang="fr">API CacheLab 2. Actions globales par type d'invalidation</a> <br />- <a href='https://contrib.spip.net/Complements-CacheLab-et-todo' class="spip_in" hreflang="fr">Compléments CacheLab et todo</a> <br />- <a href='https://contrib.spip.net/XRay-un-explorateur-des-caches-SPIP' class="spip_in" hreflang="fr">XRay, un explorateur des caches SPIP</a> <br />- <a href='https://contrib.spip.net/plugin_macrosession_session_optimisees_et_etendues' class="spip_in" hreflang="fr">Plugin 'macrosession' : usage optimisé et extension des données de session</a></p></div> </article> <article> <h1>Campos Extras — API e criação</h1> <p>Ricardo — 2025-03-14T18:37:04Z</p> <div class='rss_chapo'><p>Este documento apresenta as APIs disponíveis no plugin «Campos Extras», bem como as usar para criar um plugin que acrescente campos extras.</p> <p>O plugin «<a href='https://contrib.spip.net/Campos-Extras-Interface' class="spip_in" hreflang="pt_br">Campos Extras (Interface)</a>», entre outros, se apoia nestas APIs e oferece uma interface gráfica para gerenciar esses campos.</p> <p>A documentação é válida para versões do plugin a partir da 3.0.0.</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-5" id="nav6a60d14959e103.23393751"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-API-de-autorizacao-restricao-dos-campos-extras"></a><a href="#API-de-autorizacao-restricao-dos-campos-extras" class="spip_ancre">API de autorização / restrição dos campos extras</a></li><li> <a id="s-Funcoes-de-autorizacao-precisas"></a><a href="#Funcoes-de-autorizacao-precisas" class="spip_ancre">Funções de autorização precisas</a></li><li> <a id="s-Criar-um-plugin-usando-as-APIs-de-Campos-Extras"></a><a href="#Criar-um-plugin-usando-as-APIs-de-Campos-Extras" class="spip_ancre">Criar um plugin usando as APIs de Campos Extras</a></li><li> <a id="s-Um-outro-exemplo"></a><a href="#Um-outro-exemplo" class="spip_ancre">Um outro exemplo...</a></li><li> <a id="s-Outro-exemplo-usando-um-ou-mais-fieldsets-para-separar-os-novos-campos-nbsp"></a><a href="#Outro-exemplo-usando-um-ou-mais-fieldsets-para-separar-os-novos-campos-nbsp" class="spip_ancre">Outro exemplo... usando um ou mais fieldsets para separar os novos campos adicionais</a></li></ul></div></p> <h2 class="h2" id='API-de-autorizacao-restricao-dos-campos-extras'>API de autorização / restrição dos campos extras<a class='sommaire-back sommaire-back-5' href='#s-API-de-autorizacao-restricao-dos-campos-extras' title='Back to the table of contents'></a></h2> <p>Como na versão precedente, pode-se restringir o uso de campos extras a determinados setores ou seções. A função da API <code class='spip_code spip_code_inline' dir='ltr'>restreindre_extras</code> é idêntica, no entanto os nomes da funções de autorização subjacentes evoluiram.</p> <p>A função <code class='spip_code spip_code_inline' dir='ltr'>restreindre_extras</code> simplifica as definições de restrições dos campos, ou seja, as restrições de exibição definidas em função da seção a que os campos pertencem. Estas funções devem ser colocadas no arquivo<code class='spip_code spip_code_inline' dir='ltr'>squelettes/mes_fonctions.php</code>. O seu papel é criar «dinamicamente» as funções de autorização adequadas (descritas mais abaixo).</p> <p>Para o seu correto funcionamento, é preciso carregar a biblioteca <code class='spip_code spip_code_inline' dir='ltr'>inc/cextras_autoriser</code>.</p> <p>Os argumentos dessa função são:</p> <ol class="spip" role="list"><li> o objeto em questão (matéria, seção, palavra-chave, site...)</li><li> o nome do(s) campo(s) extra(s)</li><li> o identificadores de restrição (por padrão, as seções)</li><li> o alvo (por padrão, 'rubrique', mas pode ser também 'secteur' ou 'groupe')</li><li> recursivo (false por padrão) (é aplicável aos elementos descendentes?)</li></ol> <p>Um exemplo de arquivo de autorização e várias autorizações:</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php include_spip('inc/cextras_autoriser'); // restringir o campo 'gama' das matérias, na seção 2 restreindre_extras('article', 'gama', 2); // restringir o campo 'alfa' e 'beta' das matérias , nas seções 2 e 3 restreindre_extras('article', array('alfa', 'beta'), array(2, 3)); // restringir o campo 'iota' das seções, na seção 37 restreindre_extras('rubrique', 'iota', 37); // restringir o campo 'iota' das seções, na seção 37 e suas subseções restreindre_extras('rubrique', 'iota', 37, 'rubrique', true); // restringir os campos 'alfa' e 'beta' das matérias, nas seções 37 e 38 e seus descendentes restreindre_extras('article', array('alfa', 'beta'), array(37, 38), 'rubrique', true); // quando se quer aplicar a um setor, prefira usar 'secteur' em vez de seções recursivas. Para restringir ao setor 2: restreindre_extras('article', 'beta', 2, 'secteur'); </code></pre></div> <p>Um argumento adicional permite definir a função que fará a validação; o seu valor padrão é 'rubrique', que carrega a função <code class='spip_code spip_code_inline' dir='ltr'>inc_restreindre_extras_objet_sur_{rubrique}_dist</code>. O plugin suporta também <i>secteur</i> e <i>groupemot</i>:</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// restringir os campos 'motim' et 'motor' das palavras-chave, no grupo 3 restreindre_extras('mot', array('motim', 'motor'), 3, 'groupemot'); </code></pre></div> <p>Após a versão 3.3.0, pode-se também restringir os campos extras em função da <a href='https://contrib.spip.net/Compositions-2-et-superieur' class="spip_in" hreflang="fr">composição</a> do objeto, ex:</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// restringir o campo 'lazer' nas matérias que usam a composição 'cv' restreindre_extras('article', 'lazer', 'cv', 'composition'); </code></pre></div> <p>Após a versão 3.7.0, pode-se também restringir os campos extras em função de uma palavra-chave vinculada ao objeto, ex:</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// restringir o campo 'lazer' nas matérias vinculadas às palavras-chave 9 ou 10 restreindre_extras('article', 'lazer', array(9, 10), 'mot'); </code></pre></div> <p><strong>Notas:</strong></p> <ul class="spip" role="list"><li> Por uma questão de otimização (menos consultas SQL), é preferível agrupar em uma única chamada, em vez de várias, sempre que possível.</li><li> não é possível definir duas restrições diferentes para um mesmo campo extra. <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// impossível (apenas a 1ª é considerada): restreindre_extras('article', 'c1', 1); restreindre_extras('article', 'c1', 2); // Use: restreindre_extras('article', 'c1', array(1, 2)); // Mas agrupar os campos sempre que possível (mesmos identificadores de aplicação). Se: restreindre_extras('article', 'c1', array(1, 2)); restreindre_extras('article', 'c2', array(1, 2)); // Prefira: restreindre_extras('article', array('c1', 'c2'), array(1, 2)); </code></pre></div></li></ul><h2 class="h2" id='Funcoes-de-autorizacao-precisas'>Funções de autorização precisas<a class='sommaire-back sommaire-back-5' href='#s-Funcoes-de-autorizacao-precisas' title='Back to the table of contents'></a></h2> <p>Certos casos são bem complexos e pode ser necessário que você crie as suas próprias funções de autorização com as ações que precisa. Essas funções devem ser nomeadas (o _dist não é obrigatório):</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>autoriser_{objet}_voirextra_{champ}_dist</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>autoriser_{objet}_modifierextra_{champ}_dist</code></li></ul> <p>Isso pode dar uma função (tabela auteurs, campo prenom):</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>autoriser_auteur_voirextra_prenom_dist</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>autoriser_auteur_modifierextra_prenom_dist</code></li></ul> <p>Veja um exemplo de código simples, abaixo:</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// apenas os redatores e admins podem ver function autoriser_auteur_voirextra_prenom_dist($faire, $type, $id, $qui, $opt) { return in_array($qui['statut'], array('0minirezo', '1comite')); } // apenas os admins podem alterar function autoriser_auteur_modifierextra_prenom_dist($faire, $type, $id, $qui, $opt) { return in_array($qui['statut'], array('0minirezo')); } </code></pre></div> <p>Abaixo, um outro exemplo mais completo que testa se uma matéria usa uma certa <a href='https://contrib.spip.net/Compositions' class="spip_in" hreflang="fr">composição</a>, a composição «mapa», para exibir ou não os campos extras:</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>/* AUTORIZAÇÕES */ function grainepc_objet_est_carto($objet, $id) { $compo = compositions_determiner($objet, $id); return ($compo == 'mapa'); } // autorizações dos campos extras de mapa... foreach (array( 'declinacao', 'estrutura', 'exibicao', 'data_criacao', 'coordenadas', 'apresentacao', 'infos') as $nom) { $m = "autoriser_article_modifierextra_" . $nom . "_dist"; $v = "autoriser_article_voirextra_" . $nom . "_dist"; $code = " if (!function_exists('$m')) { function $m(\$faire, \$type, \$id, \$qui, \$opt) { return grainepc_objet_est_carto(\$type, \$id); } } if (!function_exists('$v')) { function $v(\$faire, \$type, \$id, \$qui, \$opt) { return grainepc_objet_est_carto(\$type, \$id); } } "; # var_dump($code); eval($code); } </code></pre></div> <p><a id="exemple-plugin"></a></p> <h2 class="h2" id='Criar-um-plugin-usando-as-APIs-de-Campos-Extras'>Criar um plugin usando as APIs de Campos Extras<a class='sommaire-back sommaire-back-5' href='#s-Criar-um-plugin-usando-as-APIs-de-Campos-Extras' title='Back to the table of contents'></a></h2> <p>Como você sabe, o plugin «Campos Extras Interface» usa uma API de Campos Extras, para oferecer um gerenciamento gráfico dos campos. No entanto, outros plugins também podem usar esta API para delegar ao plugin Campos Extras o gerenciamento de exibição, verificação e processamento de novos campos da base de dados e gerenciá-los ele mesmo, usando os pipelines fornecidos pelo SPIP. A vantagem aqui, é que todas as declarações são agrupadas num único pipeline e que o processo de instalação e desinstalação é simplificado. Vejamos por exemplo, a extensão de demonstração «Título curto para seções».</p> <p>À partida, é preciso criar um <code class='spip_code spip_code_inline' dir='ltr'>paquet.xml</code> apresentando o plugin:</p> <div class="precode"><pre data-language="xml" class='spip_code spip_code_block language-xml' dir='ltr' style='text-align:left;'><code><paquet prefix="titrecourt" categorie="outil" version="1.1.0" etat="stable" compatibilite="[3.0.0-beta;[" logo="" schema="0.0.1" > <nom>Título Curto para Seções</nom> <auteur>Matthieu Marcillaud [->magraine.net]</auteur> <licence>GNU/GPL</licence> <necessite nom="cextras" compatibilite="[3.0.5;[" /> <pipeline nom="declarer_champs_extras" inclure="base/titrecourt.php" /> </paquet> </code></pre></div> <p>Destacamos a indicação de dependência de «cextras» que é o núcleo de Campos Extras, sua API («iextras» sendo o plugin de interface gráfica), assim como a chamada de um pipeline<code class='spip_code spip_code_inline' dir='ltr'>declarer_champs_extras</code>.</p> <p>Vamos preencher o pipeline do nosso novo campo «titrecourt» na tabela das seções (rubriques). Para tal, criamos o arquivo <code class='spip_code spip_code_inline' dir='ltr'>base/titrecourt.php</code> com o conteúdo:</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php if (!defined("_ECRIRE_INC_VERSION")) return; function titrecourt_declarer_champs_extras($champs = array()) { $champs['spip_rubriques']['titre_court'] = array( 'saisie' => 'input',// Tipo de campo (ver plugin Saisies) 'options' => array( 'nom' => 'titre_court', 'label' => _T('titrecourt:titre_court'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valor padrão 'restrictions'=>array('voir' => array('auteur' => ''),// Todos podem ver 'modifier' => array('auteur' => 'webmestre')),// Só os webmasters podem alterar ), ); return $champs; } ?> </code></pre></div> <p>Observe que o código preenche uma matriz de descrição em<code class='spip_code spip_code_inline' dir='ltr'>$champs['spip_rubriques']['titre_court']</code>. O princípio é, então, de preencher a matriz <code class='spip_code spip_code_inline' dir='ltr'>$champs</code> com uma chave indicando a tabela SQL, e uma chave indicando a coluna SQL <code class='spip_code spip_code_inline' dir='ltr'>$champs[table][champ]</code>.</p> <p>A matriz de descrição está, assim, <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">no formato do plugin «<small class="fine d-inline"> </small>Saisies<small class="fine d-inline"> </small>»</a> (no qual o Campos Extras se apoia). Encontramos, no entanto, seis opções adicionais:</p> <ul class="spip" role="list"><li> «nom» indica o nome da coluna SQL desejada,</li><li> «sql» indica a linha SQL correspondente,</li><li> «rechercher» (opcional) permite indicar se o campo deve ser considerado nas buscas. Você pode informar o valor <code class='spip_code spip_code_inline' dir='ltr'>true</code> (a ponderação aplicada por padrão é <code class='spip_code spip_code_inline' dir='ltr'>2</code>), ou qualquer valor inteiro de ponderação de busca desejada, por exemplo, <code class='spip_code spip_code_inline' dir='ltr'>5</code>;</li><li> «versionner» (opcional) permite indicar se o campo pode ser versionado, quando as revisões estão ativadas (plugin révisions) no objeto editorial no qual é incluído o campo extra. <code class='spip_code spip_code_inline' dir='ltr'>true</code> para ativar o versionamento;</li><li> «restrictions» (opcional) permite indicar as restrições aplicadas automaticamente na área restrita. Pode ser uma das opções: <ul class="spip" role="list"><li> 'voir' => array('auteur'=>'') // todos podem ver (é o valor padrão!)</li><li> 'voir' => false // ninguém pode ver</li><li> 'modifier => array('auteur' => 'admin') // apenas os admins podem alterar.</li><li> 'modifier => array('auteur' => 'admin_complet') // apenas os admins não-restritos podem alterar.</li><li> 'modifier => array('auteur' => 'webmestre') // apenas os webmasters podem alterar.</li><li> 'secteur' => '3' (restrito ao setor 3).</li><li> 'secteur' => '3:5:8' (restrito aos setores 3, 5 e 8).</li><li> 'branche' => '2' (restrito à ramificação 2...).</li><li> 'rubrique' => '1'.</li><li> 'groupe' => '4'.</li></ul></li><li> «traitements», tratamentos tipográficos a aplicar, seja uma constante predefinida, seja uma string descrevendo as funções a aplicar. Leia a documentação em <a href="https://programmer.spip.net/Traitements-automatiques-des" class="spip_out" rel="external">Programar com o SPIP</a>.</li></ul> <p>Note que se estas restrições não forem suficientes, você pode criar as funções de autorizações específicas dos seus campos extras, como visto mais acima.</p> <p>O último arquivo a criar gerencia a instalação e desinstalação dos campos. Neste exemplo é o arquivo <code class='spip_code spip_code_inline' dir='ltr'>titrecourt_administrations.php</code>, que contém o mínimo necessário:</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php if (!defined("_ECRIRE_INC_VERSION")) return; include_spip('inc/cextras'); include_spip('base/titrecourt'); function titrecourt_upgrade($nom_meta_base_version,$version_cible) { $maj = array(); cextras_api_upgrade(titrecourt_declarer_champs_extras(), $maj['create']); include_spip('base/upgrade'); maj_plugin($nom_meta_base_version, $version_cible, $maj); } function titrecourt_vider_tables($nom_meta_base_version) { cextras_api_vider_tables(titrecourt_declarer_champs_extras()); effacer_meta($nom_meta_base_version); } </code></pre></div> <p>Encontramos as funções <code class='spip_code spip_code_inline' dir='ltr'>upgrade()</code> e <code class='spip_code spip_code_inline' dir='ltr'>vider_tables()</code> dos plugins, que chamam as funções <code class='spip_code spip_code_inline' dir='ltr'>cextras_api_upgrade()</code> e <code class='spip_code spip_code_inline' dir='ltr'>cextras_api_vider_tables()</code> com o conteúdo da função que lista os campos que foram criados, aqui <code class='spip_code spip_code_inline' dir='ltr'>titrecourt_declarer_champs_extras()</code>.</p> <p>Para a função de upgrade, indica-se também onde queremos criar as atualizações, aqui em <code class='spip_code spip_code_inline' dir='ltr'>$maj['create']</code> que corresponde a «na criação do plugin», mas pode ser chamada também fora de uma atualização (por exemplo, se quiser incluir um campo adicional).</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>$maj = array(); cextras_api_upgrade(titrecourt_declarer_champs_extras(), $maj['create']); // atualização da versão 1.2 (novos campos a criar) cextras_api_upgrade(titrecourt_declarer_champs_extras(), $maj['1.2']); </code></pre></div><h2 class="h2" id='Um-outro-exemplo'>Um outro exemplo...<a class='sommaire-back sommaire-back-5' href='#s-Um-outro-exemplo' title='Back to the table of contents'></a></h2> <p>Veja outro exemplo mais complexo. Aqui, as autorizações para composições foram também criadas. Vários campos estão presentes em tabelas diferentes e várias atualizações são feitas.</p> <p><strong>Declaração dos campos</strong></p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php if (!defined("_ECRIRE_INC_VERSION")) return; function grainepc_declarer_champs_extras($champs = array()){ $champs['spip_auteurs']['telephone'] = array( 'saisie' => 'input', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'telephone', 'label' => _T('grainepc:info_telephone'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valor padrão )); $champs['spip_articles']['declinaison'] = array( 'saisie' => 'input', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'declinaison', 'label' => _T('grainepc:info_declinaison'), 'sql' => "text DEFAULT '' NOT NULL", 'defaut' => '',// Valor padrão 'traitements' => '_TRAITEMENT_TYPO', )); $champs['spip_articles']['structure'] = array( 'saisie' => 'radio', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'structure', 'label' => _T('grainepc:info_type_structure'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valor padrão 'datas' => array( '' => _T('grainepc:info_rien'), 'structure' => _T('grainepc:info_structure'), 'structure_adherente' => _T('grainepc:info_structure_adherente'), ), )); $champs['spip_articles']['affichage'] = array( 'saisie' => 'radio', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'affichage', 'label' => _T('grainepc:info_affichage'), 'sql' => "varchar(30) NOT NULL DEFAULT 'complet'", 'defaut' => 'complet',// Valor padrão 'datas' => array( 'complet' => _T('grainepc:info_complet'), 'reduit' => _T('grainepc:info_reduit'), ), )); $champs['spip_articles']['date_creation'] = array( 'saisie' => 'date', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'date_creation', 'label' => _T('grainepc:info_date_creation'), 'sql' => "datetime DEFAULT '0000-00-00 00:00:00' NOT NULL", 'defaut' => '0000-00-00 00:00:00',// Valor padrão ), 'verifier' => array( 'type' => 'date', 'options' => array( 'normaliser' => 'datetime', ) )); $champs['spip_articles']['coordonnees'] = array( 'saisie' => 'textarea', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'coordonnees', 'label' => _T('grainepc:info_coordonnees'), 'sql' => "text DEFAULT '' NOT NULL", 'defaut' => '',// Valor padrão 'rows' => 4, 'traitements' => '_TRAITEMENT_RACCOURCIS', )); $champs['spip_articles']['presentation'] = array( 'saisie' => 'textarea', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'presentation', 'label' => _T('grainepc:info_presentation'), 'sql' => "text DEFAULT '' NOT NULL", 'defaut' => '',// Valor padrão 'rows' => 6, 'traitements' => '_TRAITEMENT_RACCOURCIS', )); $champs['spip_articles']['infos'] = array( 'saisie' => 'textarea', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'infos', 'label' => _T('grainepc:info_infos'), 'sql' => "text DEFAULT '' NOT NULL", 'defaut' => '',// Valor padrão 'rows' => 5, 'traitements' => '_TRAITEMENT_RACCOURCIS', )); return $champs; } </code></pre></div> <p><strong>Instalação</strong></p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php include_spip('inc/cextras'); include_spip('base/grainepc'); function grainepc_upgrade($nom_meta_base_version,$version_cible){ $maj = array(); cextras_api_upgrade(grainepc_declarer_champs_extras(), $maj['create']); cextras_api_upgrade(grainepc_declarer_champs_extras(), $maj['1.1.0']); cextras_api_upgrade(grainepc_declarer_champs_extras(), $maj['1.2.0']); $maj['1.2.0'][] = array('sql_alter',"TABLE spip_auteurs DROP type"); cextras_api_upgrade(grainepc_declarer_champs_extras(), $maj['1.3.0']); include_spip('base/upgrade'); maj_plugin($nom_meta_base_version, $version_cible, $maj); } function grainepc_vider_tables($nom_meta_base_version) { cextras_api_vider_tables(grainepc_declarer_champs_extras()); effacer_meta($nom_meta_base_version); } </code></pre></div><h2 class="h2" id='Outro-exemplo-usando-um-ou-mais-fieldsets-para-separar-os-novos-campos-nbsp'>Outro exemplo... usando um ou mais fieldsets para separar os novos campos adicionais<a class='sommaire-back sommaire-back-5' href='#s-Outro-exemplo-usando-um-ou-mais-fieldsets-para-separar-os-novos-campos-nbsp' title='Back to the table of contents'></a></h2> <p>Outro exemplo onde os campos são agrupados por fieldsets (em seguimento a uma questão levantada nos fóruns desta matéria).</p> <p>Aqui, o conjunto de campos são da mesma tabela, e são agrupados em dois fieldsets diferentes <i>numeros</i> e <i>adresse</i>.</p> <p><strong>Declaração dos campos</strong></p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php if (!defined("_ECRIRE_INC_VERSION")) return; function numadresse_declarer_champs_extras($champs = array()){ $champs['spip_auteurs']['numeros'] = array( 'saisie' => 'fieldset',// Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => "numeros", 'label' => _T('numadresse:legend_numeros') ), 'saisies' => array( 'telephone' => array( 'saisie' => 'input', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'telephone', 'label' => _T('numadresse:info_telephone'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valor padrão )), 'fax' => array( 'saisie' => 'input', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'fax', 'label' => _T('numadresse:info_fax'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valor padrão )) ) ); $champs['spip_auteurs']['adresse'] = array( 'saisie' => 'fieldset',// Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => "adresse", 'label' => _T('numadresse:legend_adresse') ), 'saisies' => array( 'adresse' => array( 'saisie' => 'input', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'adresse', 'label' => _T('numadresse:info_adresse'), 'sql' => "text NOT NULL DEFAULT ''", 'defaut' => '',// Valor padrão )), 'code_postal' => array( 'saisie' => 'input', // Tipo do campo (ver plugin Entrada de Dados) 'options' => array( 'nom' => 'code_postal', 'label' => _T('numadresse:info_code_postal'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valor padrão )) ) ); return $champs; } </code></pre></div> <p>Para a instalação destes campos, use o exemplo mais acima.</p> <p>Os quatro novos campos ficam assim organizados em dois fieldsets diferentes, abaixo do perfil do autor.</p></div> </article> <article> <h1>Champs Extras — API et créations</h1> <p>Matthieu Marcillaud — 2012-03-22T12:50:21Z</p> <div class='rss_chapo'><p>Dans ce document vous trouverez expliquées les API disponibles dans le plugin «Champs Extras » ainsi que les manières de les utiliser pour créer un plugin ajoutant des champs extras (via ces API donc).</p> <p>Le plugin «<a href='https://contrib.spip.net/Champs-Extras-Interface' class="spip_in" hreflang="fr">Champs Extras Interface</a>», entre autres, s'appuie sur ces API et offre une interface graphique pour gérer ces champs.</p> <p>La documentation est valable à partir de la version 3.0.0 du plugin.</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-5" id="nav6a60d1495d3b81.93015279"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-API-d-autorisation-restrictions-des-champs-extras"></a><a href="#API-d-autorisation-restrictions-des-champs-extras" class="spip_ancre">API d'autorisation / restrictions des champs extras</a></li><li> <a id="s-Fonctions-d-autorisations-precises"></a><a href="#Fonctions-d-autorisations-precises" class="spip_ancre">Fonctions d'autorisations précises</a></li><li> <a id="s-Creer-un-plugin-en-utilisant-les-API-de-Champs-Extras"></a><a href="#Creer-un-plugin-en-utilisant-les-API-de-Champs-Extras" class="spip_ancre">Créer un plugin en utilisant les API de Champs Extras</a></li><li> <a id="s-Un-autre-exemple"></a><a href="#Un-autre-exemple" class="spip_ancre">Un autre exemple...</a></li><li> <a id="s-Un-autre-exemple-en-utilisant-un-ou-plusieurs-fieldset-pour-separer-les-nbsp"></a><a href="#Un-autre-exemple-en-utilisant-un-ou-plusieurs-fieldset-pour-separer-les-nbsp" class="spip_ancre">Un autre exemple... en utilisant un ou plusieurs fieldset pour séparer les nouveau champs ajoutés</a></li></ul></div></p> <h2 class="h2" id='API-d-autorisation-restrictions-des-champs-extras'>API d'autorisation / restrictions des champs extras<a class='sommaire-back sommaire-back-5' href='#s-API-d-autorisation-restrictions-des-champs-extras' title='Back to the table of contents'></a></h2> <p>Comme dans la version précédente, il est possible de restreindre l'usage de champs extras à certains secteurs ou rubriques. La fonction d'API <code class='spip_code spip_code_inline' dir='ltr'>restreindre_extras</code> est identique, cependant, les noms des fonctions d'autorisations sous-jacentes ont, eux, évolué.</p> <p>La fonction <code class='spip_code spip_code_inline' dir='ltr'>restreindre_extras</code> facilite les restrictions des champs, c'est à dire des restrictions d'affichages définies en fonction de la rubrique à laquelle ces champs appartiennent. Ces fonctions sont à placer dans le fichier <code class='spip_code spip_code_inline' dir='ltr'>squelettes/mes_fonctions.php</code>. Leur rôle est de créer «à la volée» les fonctions d'autorisations adéquates (elles sont décrites plus loin).</p> <p>Pour leur bon fonctionnement, il est nécessaire de charger la librairie <code class='spip_code spip_code_inline' dir='ltr'>inc/cextras_autoriser</code>.</p> <p>Les arguments de cette fonction sont :</p> <ol class="spip" role="list"><li> objet incriminé (article, rubrique, mot, site...)</li><li> nom du/des champ(s) extras</li><li> identifiants de restriction (par défaut des rubriques)</li><li> cible (par défaut 'rubrique', mais peut aussi être 'secteur' ou 'groupe')</li><li> recursif (false par défaut) (applique t-on aux éléments enfants ?)</li></ol> <p>Un exemple de fichier d'autorisation et diverses autorisations :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php include_spip('inc/cextras_autoriser'); // restreindre le champ 'gamma' des articles, sur la rubrique 2 restreindre_extras('article', 'gamma', 2); // restreindre le champ 'alpha' et 'beta' des articles, sur les rubriques 2 et 3 restreindre_extras('article', array('alpha', 'beta'), array(2, 3)); // restreindre le champ 'iota' des rubriques, sur la rubrique 37 restreindre_extras('rubrique', 'iota', 37); // restreindre le champ 'iota' des rubriques, sur la rubrique 37 et ses sous rubriques restreindre_extras('rubrique', 'iota', 37, 'rubrique', true); // restreindre les champs 'alpha' et 'beta' des articles, sur les rubriques 37 et 38 et leurs enfants restreindre_extras('article', array('alpha', 'beta'), array(37, 38), 'rubrique', true); // lorsqu'on veut appliquer sur un secteur, préférer 'secteur' plutôt que rubriques récursives. Pour restreindre au secteur 2 : restreindre_extras('article', 'beta', 2, 'secteur'); ?></code></pre></div> <p>Un argument supplémentaire permet donc de définir la fonction qui fera la recherche de validité, et vaut par défaut 'rubrique', ce qui charge la fonction <code class='spip_code spip_code_inline' dir='ltr'>inc_restreindre_extras_objet_sur_{rubrique}_dist</code>. Le plugin supporte aussi <i>secteur</i> et <i>groupemot</i> :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// restreindre les champs 'motin' et 'moteur' des mots, sur le groupe 2 restreindre_extras('mot', array('motin', 'moteur'), 3, 'groupemot');</code></pre></div> <p>Depuis la version 3.3.0, il est aussi possible de restreindre les champs extras en fonction de <a href='https://contrib.spip.net/Compositions-2-et-superieur' class="spip_in" hreflang="fr">la composition</a> de l'objet, ex :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// restreindre le champ 'loisirs' sur les articles qui portent la composition 'cv' restreindre_extras('article', 'loisirs', 'cv', 'composition');</code></pre></div> <p>Depuis la version 3.7.0, il est aussi possible de restreindre les champs extras en fonction d'un mot clé lié à l'objet, ex :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// restreindre le champ 'loisirs' sur les articles qui portent un des mots clés n°9 ou 10 restreindre_extras('article', 'loisirs', array(9, 10), 'mot');</code></pre></div> <p><strong>Notes :</strong></p> <ul class="spip" role="list"><li> Par souci d'optimisation (moins de requêtes SQL), il est préférable de regrouper en un seul appel au lieu de plusieurs lorsque c'est possible,</li><li> Il n'est pas possible de définir deux restrictions différentes pour un même champ extra. <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// impossible (seul le 1er est pris en compte) : restreindre_extras('article', 'c1', 1); restreindre_extras('article', 'c1', 2); // Utiliser : restreindre_extras('article', 'c1', array(1, 2)); // Mais grouper les champs dés que c'est possible (mêmes identifiants d'application). Si : restreindre_extras('article', 'c1', array(1, 2)); restreindre_extras('article', 'c2', array(1, 2)); // Préférer : restreindre_extras('article', array('c1', 'c2'), array(1, 2));</code></pre></div></li></ul><h2 class="h2" id='Fonctions-d-autorisations-precises'>Fonctions d'autorisations précises<a class='sommaire-back sommaire-back-5' href='#s-Fonctions-d-autorisations-precises' title='Back to the table of contents'></a></h2> <p>Certains cas sont bien plus complexes et peuvent nécessiter que vous créiez vous-même les fonctions d'autorisations avec leurs actions qui vont bien. Ces fonctions doivent être nommées (le _dist n'est pas obligatoire) :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>autoriser_{objet}_voirextra_{champ}_dist</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>autoriser_{objet}_modifierextra_{champ}_dist</code></li></ul> <p>Cela peut donner une fonction (table auteurs, champ prenom) :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>autoriser_auteur_voirextra_prenom_dist</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>autoriser_auteur_modifierextra_prenom_dist</code></li></ul> <p>Un exemple de code simple pourrait être :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>// seuls les rédacteurs et admins peuvent voir function autoriser_auteur_voirextra_prenom_dist($faire, $type, $id, $qui, $opt) { return in_array($qui['statut'], array('0minirezo', '1comite')); } // seuls les admins peuvent modifier function autoriser_auteur_modifierextra_prenom_dist($faire, $type, $id, $qui, $opt) { return in_array($qui['statut'], array('0minirezo')); }</code></pre></div> <p>Voici un autre exemple plus complet qui teste si un article a une certaine <a href='https://contrib.spip.net/Compositions' class="spip_in" hreflang="fr">composition</a>, la composition «carte», pour afficher ou non des champs extras :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>/* AUTORISATIONS */ function grainepc_objet_est_carto($objet, $id) { $compo = compositions_determiner($objet, $id); return ($compo == 'carte'); } // autorisations des champs extras de carte ... foreach (array( 'declinaison', 'structure', 'affichage', 'date_creation', 'coordonnees', 'presentation', 'infos') as $nom) { $m = "autoriser_article_modifierextra_" . $nom . "_dist"; $v = "autoriser_article_voirextra_" . $nom . "_dist"; $code = " if (!function_exists('$m')) { function $m(\$faire, \$type, \$id, \$qui, \$opt) { return grainepc_objet_est_carto(\$type, \$id); } } if (!function_exists('$v')) { function $v(\$faire, \$type, \$id, \$qui, \$opt) { return grainepc_objet_est_carto(\$type, \$id); } } "; # var_dump($code); eval($code); }</code></pre></div> <p><a id="exemple-plugin"></a></p> <h2 class="h2" id='Creer-un-plugin-en-utilisant-les-API-de-Champs-Extras'>Créer un plugin en utilisant les API de Champs Extras<a class='sommaire-back sommaire-back-5' href='#s-Creer-un-plugin-en-utilisant-les-API-de-Champs-Extras' title='Back to the table of contents'></a></h2> <p>Vous le savez, le plugin «Champs Extras Interfaces» s'appuie sur une API de Champs Extras pour proposer une gestion graphique des champs. Cependant, des plugins peuvent aussi s'appuyer sur cette API afin de décharger sur le plugin champs extras la gestion de l'affichage, de la vérification et le traitement de nouveaux champs. Il n'y a rien d'obligatoire à cette utilisation, vous pouvez très bien développer un plugin qui crée des nouveaux champs en base et les gère de lui-même en utilisant les pipelines fournis par SPIP. L'avantage ici, est que toutes les déclarations sont regroupées dans un seul pipeline, et que la procédure d'installation et de désinstallation est simplifiée. Voyons un exemple, l'extension de démonstration nommée «Titre court pour rubriques».</p> <p>Tout d'abord, il faut créer un <code class='spip_code spip_code_inline' dir='ltr'>paquet.xml</code> présentant le plugin :</p> <div class="precode"><pre data-language="xml" class='spip_code spip_code_block language-xml' dir='ltr' style='text-align:left;'><code><paquet prefix="titrecourt" categorie="outil" version="1.1.0" etat="stable" compatibilite="[3.0.0-beta;[" logo="" schema="0.0.1" > <nom>Titre Court pour Rubriques</nom> <auteur>Matthieu Marcillaud [->magraine.net]</auteur> <licence>GNU/GPL</licence> <necessite nom="cextras" compatibilite="[3.0.5;[" /> <pipeline nom="declarer_champs_extras" inclure="base/titrecourt.php" /> </paquet></code></pre></div> <p>On remarque l'indication de dépendance à «cextras» qui est, donc, le cœur de Champs Extras, son API («iextras» étant le plugin d'interface graphique), ainsi que l'appel d'un pipeline <code class='spip_code spip_code_inline' dir='ltr'>declarer_champs_extras</code>.</p> <p>Nous allons remplir le pipeline de notre nouveau champ «titrecourt» sur la table des rubriques. Pour cela, on crée le fichier <code class='spip_code spip_code_inline' dir='ltr'>base/titrecourt.php</code> avec comme contenu :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php if (!defined("_ECRIRE_INC_VERSION")) return; function titrecourt_declarer_champs_extras($champs = array()) { $champs['spip_rubriques']['titre_court'] = array( 'saisie' => 'input',//Type du champ (voir plugin Saisies) 'options' => array( 'nom' => 'titre_court', 'label' => _T('titrecourt:titre_court'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valeur par défaut 'restrictions'=>array('voir' => array('auteur' => ''),//Tout le monde peut voir 'modifier' => array('auteur' => 'webmestre')),//Seuls les webmestres peuvent modifier ), ); return $champs; } ?></code></pre></div> <p>Observons. Le code remplit un tableau de description dans <code class='spip_code spip_code_inline' dir='ltr'>$champs['spip_rubriques']['titre_court']</code>. Le principe est donc de remplir le tableau <code class='spip_code spip_code_inline' dir='ltr'>$champs</code> avec une clé indiquant la table SQL, puis une clé indiquant la colonne SQL <code class='spip_code spip_code_inline' dir='ltr'>$champs[table][champ]</code>.</p> <p>Le tableau de description est ensuite <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">au format du plugin «<small class="fine d-inline"> </small>Saisies<small class="fine d-inline"> </small>»</a> (puisque Champs Extras s'appuie dessus). On trouve cependant 6 options supplémentaires :</p> <ul class="spip" role="list"><li> «nom» indique le nom le la colonne SQL désirée,</li><li> «sql» indique la ligne SQL correspondante,</li><li> «rechercher» (optionnel) permet d'indiquer si le champ doit être pris en compte dans les recherches. Vous pouvez renseigner la valeur <code class='spip_code spip_code_inline' dir='ltr'>true</code> (la pondération appliquée par défaut est <code class='spip_code spip_code_inline' dir='ltr'>2</code>), ou toute valeur entière de pondération de recherche désirée, par exemple <code class='spip_code spip_code_inline' dir='ltr'>5</code> ;</li><li> «versionner» (optionnel) permet d'indiquer si le champ peut être versionné lorsque les révisions sont activées (plugin révisions) sur l'objet éditorial sur lequel est ajouté le champs extras. <code class='spip_code spip_code_inline' dir='ltr'>true</code> pour activer le versionnage ;</li><li> «restrictions» (optionnel) permet d'indiquer les restrictions appliquées automatiquement dans l'espace privé. On peut trouver dedans les options : <ul class="spip" role="list"><li> 'voir' => array('auteur'=>'') // tout le monde peut voir (c'est l'action par défaut !)</li><li> 'voir' => false // personne peut voir</li><li> 'modifier => array('auteur' => 'admin') // seuls les admins.</li><li> 'modifier => array('auteur' => 'admin_complet') // seuls les admins non restreints</li><li> 'modifier => array('auteur' => 'webmestre') // seuls les webmestres.</li><li> 'secteur' => '3' (restreint au secteur 3).</li><li> 'secteur' => '3:5:8' (restreint au secteurs 3, 5 et 8).</li><li> 'branche' => '2' (restreint à la branche 2...).</li><li> 'rubrique' => '1'.</li><li> 'groupe' => '4'.</li></ul></li><li> «traitements», traitements typographiques à appliquer, soit une constante prédéfinie, soit un chaîne décrivant les fonctions à appliquer. Lire la documentation sur <a href="https://programmer.spip.net/Traitements-automatiques-des" class="spip_out" rel="external">Programmer avec SPIP</a>.</li></ul> <p>Notez que si ces restrictions ne sont pas suffisantes, vous pouvez créer comme on l'a vu plus haut les fonctions d'autorisations spécifiques à vos champs extras.</p> <p>Le dernier fichier à créer gère l'installation et la désinstallation des champs. C'est dans notre exemple le fichier <code class='spip_code spip_code_inline' dir='ltr'>titrecourt_administrations.php</code> et il contient le minimum syndical :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php if (!defined("_ECRIRE_INC_VERSION")) return; include_spip('inc/cextras'); include_spip('base/titrecourt'); function titrecourt_upgrade($nom_meta_base_version,$version_cible) { $maj = array(); cextras_api_upgrade(titrecourt_declarer_champs_extras(), $maj['create']); include_spip('base/upgrade'); maj_plugin($nom_meta_base_version, $version_cible, $maj); } function titrecourt_vider_tables($nom_meta_base_version) { cextras_api_vider_tables(titrecourt_declarer_champs_extras()); effacer_meta($nom_meta_base_version); } ?></code></pre></div> <p>On trouve les fonctions <code class='spip_code spip_code_inline' dir='ltr'>upgrade()</code> et <code class='spip_code spip_code_inline' dir='ltr'>vider_tables()</code> des plugins, qui appellent des fonctions <code class='spip_code spip_code_inline' dir='ltr'>cextras_api_upgrade()</code> et <code class='spip_code spip_code_inline' dir='ltr'>cextras_api_vider_tables()</code> avec le contenu de la fonction qui liste les champs que l'on crée, ici <code class='spip_code spip_code_inline' dir='ltr'>titrecourt_declarer_champs_extras()</code>.</p> <p>Pour la fonction d'upgrade, on indique aussi où l'on souhaite créer les mises à jour, ici dans <code class='spip_code spip_code_inline' dir='ltr'>$maj['create']</code> qui est «à la création du plugin», mais cela aurait pu être appelé aussi lors d'une mise à jour (par exemple si vous avez ajouté un champ de plus).</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>$maj = array(); cextras_api_upgrade(titrecourt_declarer_champs_extras(), $maj['create']); // mise à jour de la version 1.2 (nouveaux champs a créer) cextras_api_upgrade(titrecourt_declarer_champs_extras(), $maj['1.2']);</code></pre></div><h2 class="h2" id='Un-autre-exemple'>Un autre exemple...<a class='sommaire-back sommaire-back-5' href='#s-Un-autre-exemple' title='Back to the table of contents'></a></h2> <p>Voici un autre exemple plus complexe. C'était pour cet exemple que les autorisations par compositions avaient aussi été créées. Ici, plusieurs champs sont présents sur des tables différentes et plusieurs mises à jour sont faites.</p> <p><strong>Déclaration des champs</strong></p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php if (!defined("_ECRIRE_INC_VERSION")) return; function grainepc_declarer_champs_extras($champs = array()){ $champs['spip_auteurs']['telephone'] = array( 'saisie' => 'input', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'telephone', 'label' => _T('grainepc:info_telephone'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valeur par défaut )); $champs['spip_articles']['declinaison'] = array( 'saisie' => 'input', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'declinaison', 'label' => _T('grainepc:info_declinaison'), 'sql' => "text DEFAULT '' NOT NULL", 'defaut' => '',// Valeur par défaut 'traitements' => '_TRAITEMENT_TYPO', )); $champs['spip_articles']['structure'] = array( 'saisie' => 'radio', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'structure', 'label' => _T('grainepc:info_type_structure'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valeur par défaut 'datas' => array( '' => _T('grainepc:info_rien'), 'structure' => _T('grainepc:info_structure'), 'structure_adherente' => _T('grainepc:info_structure_adherente'), ), )); $champs['spip_articles']['affichage'] = array( 'saisie' => 'radio', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'affichage', 'label' => _T('grainepc:info_affichage'), 'sql' => "varchar(30) NOT NULL DEFAULT 'complet'", 'defaut' => 'complet',// Valeur par défaut 'datas' => array( 'complet' => _T('grainepc:info_complet'), 'reduit' => _T('grainepc:info_reduit'), ), )); $champs['spip_articles']['date_creation'] = array( 'saisie' => 'date', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'date_creation', 'label' => _T('grainepc:info_date_creation'), 'sql' => "datetime DEFAULT '0000-00-00 00:00:00' NOT NULL", 'defaut' => '0000-00-00 00:00:00',// Valeur par défaut ), 'verifier' => array( 'type' => 'date', 'options' => array( 'normaliser' => 'datetime', ) )); $champs['spip_articles']['coordonnees'] = array( 'saisie' => 'textarea', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'coordonnees', 'label' => _T('grainepc:info_coordonnees'), 'sql' => "text DEFAULT '' NOT NULL", 'defaut' => '',// Valeur par défaut 'rows' => 4, 'traitements' => '_TRAITEMENT_RACCOURCIS', )); $champs['spip_articles']['presentation'] = array( 'saisie' => 'textarea', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'presentation', 'label' => _T('grainepc:info_presentation'), 'sql' => "text DEFAULT '' NOT NULL", 'defaut' => '',// Valeur par défaut 'rows' => 6, 'traitements' => '_TRAITEMENT_RACCOURCIS', )); $champs['spip_articles']['infos'] = array( 'saisie' => 'textarea', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'infos', 'label' => _T('grainepc:info_infos'), 'sql' => "text DEFAULT '' NOT NULL", 'defaut' => '',// Valeur par défaut 'rows' => 5, 'traitements' => '_TRAITEMENT_RACCOURCIS', )); return $champs; } ?></code></pre></div> <p><strong>Installation</strong></p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php include_spip('inc/cextras'); include_spip('base/grainepc'); function grainepc_upgrade($nom_meta_base_version,$version_cible){ $maj = array(); cextras_api_upgrade(grainepc_declarer_champs_extras(), $maj['create']); cextras_api_upgrade(grainepc_declarer_champs_extras(), $maj['1.1.0']); cextras_api_upgrade(grainepc_declarer_champs_extras(), $maj['1.2.0']); $maj['1.2.0'][] = array('sql_alter',"TABLE spip_auteurs DROP type"); cextras_api_upgrade(grainepc_declarer_champs_extras(), $maj['1.3.0']); include_spip('base/upgrade'); maj_plugin($nom_meta_base_version, $version_cible, $maj); } function grainepc_vider_tables($nom_meta_base_version) { cextras_api_vider_tables(grainepc_declarer_champs_extras()); effacer_meta($nom_meta_base_version); } ?></code></pre></div><h2 class="h2" id='Un-autre-exemple-en-utilisant-un-ou-plusieurs-fieldset-pour-separer-les-nbsp'>Un autre exemple... en utilisant un ou plusieurs fieldset pour séparer les nouveau champs ajoutés<a class='sommaire-back sommaire-back-5' href='#s-Un-autre-exemple-en-utilisant-un-ou-plusieurs-fieldset-pour-separer-les-nbsp' title='Back to the table of contents'></a></h2> <p>Voici un autre exemple où les champs sont regroupés par fieldsets (suite à une question posée dans les forums de cet article).</p> <p>Ici, l'ensemble des champs sont sur la même table, et sont regroupés en deux fieldsets différents <i>numeros</i> et <i>adresse</i>.</p> <p><strong>Déclaration des champs</strong></p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php if (!defined("_ECRIRE_INC_VERSION")) return; function numadresse_declarer_champs_extras($champs = array()){ $champs['spip_auteurs']['numeros'] = array( 'saisie' => 'fieldset',//Type du champ (voir plugin Saisies) 'options' => array( 'nom' => "numeros", 'label' => _T('numadresse:legend_numeros') ), 'saisies' => array( 'telephone' => array( 'saisie' => 'input', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'telephone', 'label' => _T('numadresse:info_telephone'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valeur par défaut )), 'fax' => array( 'saisie' => 'input', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'fax', 'label' => _T('numadresse:info_fax'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valeur par défaut )) ) ); $champs['spip_auteurs']['adresse'] = array( 'saisie' => 'fieldset',//Type du champ (voir plugin Saisies) 'options' => array( 'nom' => "adresse", 'label' => _T('numadresse:legend_adresse') ), 'saisies' => array( 'adresse' => array( 'saisie' => 'input', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'adresse', 'label' => _T('numadresse:info_adresse'), 'sql' => "text NOT NULL DEFAULT ''", 'defaut' => '',// Valeur par défaut )), 'code_postal' => array( 'saisie' => 'input', // Type du champs (voir plugin Saisies) 'options' => array( 'nom' => 'code_postal', 'label' => _T('numadresse:info_code_postal'), 'sql' => "varchar(30) NOT NULL DEFAULT ''", 'defaut' => '',// Valeur par défaut )) ) ); return $champs; } ?></code></pre></div> <p>Pour l'installation de ces champs, faire comme l'exemple situé plus haut.</p> <p>Les quatres nouveaux champs sont ainsi répartis dans deux fieldsets différents en bas du profil de l'auteur.</p></div> </article> <article> <h1>Définitions et <abbr title="Foire Aux Questions">FAQ</abbr></h1> <p>tetue — 2009-10-14T07:53:42Z</p> <div class='rss_chapo'><p>Ce petit plugin valorise les termes définis (<code class='spip_code spip_code_inline' dir='ltr'>dfn</code>) et les listes de définitions (<code class='spip_code spip_code_inline' dir='ltr'>dl</code>, <code class='spip_code spip_code_inline' dir='ltr'>dt</code>, <code class='spip_code spip_code_inline' dir='ltr'>dd</code>) et transforme celles marquées « <code class='spip_code spip_code_inline' dir='ltr'>faq</code> » en <abbr title="Foire Aux Questions">FAQ</abbr> dépliable.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-2" id="nav6a60d149602ea1.14477129"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Mise-en-valeur-des-definitions"></a><a href="#Mise-en-valeur-des-definitions" class="spip_ancre">Mise en valeur des définitions</a></li><li> <a id="s-Creation-de-FAQ"></a><a href="#Creation-de-FAQ" class="spip_ancre">Création de <abbr title="Foire Aux Questions">FAQ</abbr></a></li></ul></div><h2 class="h2" id='Mise-en-valeur-des-definitions'>Mise en valeur des définitions<a class='sommaire-back sommaire-back-2' href='#s-Mise-en-valeur-des-definitions' title='Back to the table of contents'></a></h2> <p>Ce plugin valorise les éléments HTML dédiés aux définitions, méconnus et trop peu utilisés. Employez ces balises dans la rédaction de vos articles, pour améliorer leur sémantique (et donc leur indexation, leur référencement, leur accessibilité<span class="spip_note_ref"> [<a href="#nb9-1" class="spip_note" rel="appendix" title="Notons toutefois que, contrairement aux listes de définitions, n'améliore (…)" id="nh9-1">1</a>]</span>, etc).</p> <dl> <dt><strong>Terme défini : <code class='spip_code spip_code_inline' dir='ltr'>dfn</code></strong></dt> <dd> <p>Lorsqu'on définit un terme au fil d'un texte, celui-ci est à placer dans l'élément HTML <code class='spip_code spip_code_inline' dir='ltr'>dfn</code>. Exemple :<br class='manualbr' />« Le <dfn>polatouche</dfn> est un écureuil volant » s'écrit :<br class='manualbr' /><code class='spip_code spip_code_inline' dir='ltr'>Le <dfn>polatouche</dfn> est un écureuil volant</code>.</p> </dd> <dt><strong>Liste de définitions : <code class='spip_code spip_code_inline' dir='ltr'>dl</code>, <code class='spip_code spip_code_inline' dir='ltr'>dt</code>, <code class='spip_code spip_code_inline' dir='ltr'>dd</code></strong></dt> <dd> <p>Très pratiques pour des définitions qui se succèdent, comme dans un glossaire ou une FAQ, les listes de définitions comportent deux parties, un terme et une description. Exemple :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><dl> <dt>Grenouille</dt> <dd>Truc vert humide</dd> <dt>Lapin</dt> <dd>Truc chaud et doux</dd> </dl></code></pre></div> </dd> </dl> <p>Ce plugin habille ces éléments d'un style minimal par défaut, de façon à les rendre un peu plus visibles, pour vous inviter à les employer. Pour en savoir plus, consultez les documentations HTML de référence, dont cet article traduit sur Pompage.net : « <a href="http://www.pompage.net/pompe/listesdefinitions/" class="spip_out" rel="external">Les listes de définitions : mal utilisées ou mal comprises ?</a> ».</p> <h2 class="h2" id='Creation-de-FAQ'>Création de <abbr title="Foire Aux Questions">FAQ</abbr><a class='sommaire-back sommaire-back-2' href='#s-Creation-de-FAQ' title='Back to the table of contents'></a></h2> <p>Ce plugin permet de réaliser facilement une <dfn>FAQ</dfn>, c'est-à-dire une liste de questions fréquentes accompagnées de leurs réponses. Cette FAQ est constituée d'une liste de définitions cliquable open-close : la réponse se déplie lorsque l'internaute clique sur la question, puis se replie s'il la clique à nouveau.</p> <p>Voici les deux façons de créer une FAQ sur votre site :</p> <p>* <strong>Création d'un article-FAQ (par le rédacteur)</strong></p> <ol class="spip" role="list"><li> Rédiger les questions et réponses dans un article dédié,</li><li> Baliser correctement : les questions entre <code class='spip_code spip_code_inline' dir='ltr'><dt></code>, les réponses entre <code class='spip_code spip_code_inline' dir='ltr'><dd></code> et l'ensemble entre <code class='spip_code spip_code_inline' dir='ltr'><dl class="faq"></code> et <code class='spip_code spip_code_inline' dir='ltr'></dl></code>.</li></ol> <p>* <strong>Création d'une rubrique-FAQ (par le webmestre)</strong></p> <ol class="spip" role="list"><li> Stocker les questions-réponses, à raison d'un couple par article, où la question constitue le titre,</li><li> Ranger ces articles dans une rubrique dédiée<span class="spip_note_ref"> [<a href="#nb9-2" class="spip_note" rel="appendix" title="Rappel : il est possible de créer des variantes de squelettes, en dupliquant (…)" id="nh9-2">2</a>]</span>,</li><li> Inclure la noisette fournie par le plugin, dans le squelette de rubrique correspondant, de cette façon : <code class='spip_code spip_code_inline' dir='ltr'><INCLURE{fond=inc-rubrique-faq}{id_rubrique}></code>.</li></ol> <p>Ces deux types de FAQ peuvent co-exister au sein d'un même site, où il est possible de créer autant de FAQ que souhaité.</p> <p>Voici un exemple de FAQ créé avec ce plugin, assortie à la charte graphique du <a href="http://www.upsti.fr/serv4/spip.php?rubrique315" class="spip_out" rel="external">site de l'UPSTI</a> :</p> <div class='spip_document_7290 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div></div> <hr /> <div class='rss_notes'><div id="nb9-1"> <p><span class="spip_note_ref">[<a href="#nh9-1" class="spip_note" title="Footnotes 9-1" rev="appendix">1</a>] </span>Notons toutefois que, contrairement aux listes de définitions, <code class='spip_code spip_code_inline' dir='ltr'>dfn</code> n'améliore pas l'accessibilité. Cf. cette discussion : « <a href="http://forum.alsacreations.com/topic-6-42657-1-Synthese-vocale-et-ltdfngt.html" class="spip_out" rel="external">Synthèse vocale et dfn</a> ».</p> </div><div id="nb9-2"> <p><span class="spip_note_ref">[<a href="#nh9-2" class="spip_note" title="Footnotes 9-2" rev="appendix">2</a>] </span><strong>Rappel</strong> : il est possible de créer des <a href="http://www.spip.net/3445" class="spip_out" rel="external">variantes de squelettes</a>, en dupliquant <code class='spip_code spip_code_inline' dir='ltr'>rubrique.html</code> en <code class='spip_code spip_code_inline' dir='ltr'>rubrique-11.html</code> si votre Rubrique de FAQ a le numéro 11.</p> </div></div> <div class='rss_ps'><p>Remarque : ce plugin n'apporte qu'une surcouche (stylistique et comportementale) sans grande incidence. En l'absence du plugin, votre contenu reste correctement structuré et exploitable.</p> <p>Remarque 2 : les <code class='spip_code spip_code_inline' dir='ltr'>dl</code>, <code class='spip_code spip_code_inline' dir='ltr'>dt</code>, <code class='spip_code spip_code_inline' dir='ltr'>dd</code> sont nativement utilisés par SPIP pour l'insertion des documents dans les articles, ce qui complique leur habillage CSS en vue d'un usage simple en tant que... liste de définition (voir <a href="http://core.spip.org/issues/1934" class="spip_out" rel="external">ticket #1934</a>). Ce plugin les rend à nouveau disponible à la rédaction. Cependant soyez bien précis lorsque vous essayerez de personnaliser leur habillage via CSS : cela reste délicat.</p> <p>L'icône choisie pour ce plugin est de <a href="http://www.iconfinder.net/icondetails/35466/128/" class="spip_out" rel="external">Harwen Zhang</a>.</p></div> </article> <article> <h1>Édition directe pour SPIP 2</h1> <p>Rainer Müller — 2011-05-19T05:45:13Z</p> <div class='rss_chapo'><p>Ce plugin permet d'éditer des objets SPIP directement depuis leur page d'accueil dans l'espace privé de SPIP 2.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-5" id="nav6a60d149632814.94617553"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Principe"></a><a href="#Principe" class="spip_ancre">Principe</a></li><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Configuration"></a><a href="#Configuration" class="spip_ancre">Configuration</a></li><li> <a id="s-Etat-d-avancement"></a><a href="#Etat-d-avancement" class="spip_ancre">État d'avancement:</a></li><li> <a id="s-Pour-Developpeur"></a><a href="#Pour-Developpeur" class="spip_ancre">Pour Développeur</a></li></ul></div><h2 class="h2" id='Principe'>Principe<a class='sommaire-back sommaire-back-5' href='#s-Principe' title='Back to the table of contents'></a></h2> <p>Ce plugin se fonde sur le plugin “<a href='https://contrib.spip.net/Articles-en-edition-directe' class="spip_in" hreflang="fr">Articles en édition directe</a>” en y incluant d'autres objets SPIP pour les rendre directement éditables depuis leur page dans l'espace privé. <strong>Il dispose d'une version pour SPIP 3 et SPIP4 : regardez par <a href='https://contrib.spip.net/Edition-directe-3' class="spip_in" hreflang="fr">ici</a></strong></p> <p>Toutes les manipulations de l'objet SPIP (modifications, ajouter des mots clés, auteurs, etc.) peuvent se faire depuis une seule page.</p> <div class='spip_document_9481 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-5' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Le plugin s'installe comme <a href="http://www.spip.net/fr_article3396.html" class="spip_out" rel="external">n'importe quel plugin</a>.</p> <p>Il nécessite toutefois les plugins suivants:</p> <p>- <a href='https://contrib.spip.net/Mediatheque' class="spip_in" hreflang="fr">Médiathèque</a> <br />- <a href='https://contrib.spip.net/Config-CFG' class="spip_in" hreflang="fr">CFG</a> <br />- <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">Saisies</a> <br />- <a href='https://contrib.spip.net/SPIP-Bonux' class="spip_in" hreflang="fr">Spip Bonux</a></p> <h2 class="h2" id='Configuration'>Configuration<a class='sommaire-back sommaire-back-5' href='#s-Configuration' title='Back to the table of contents'></a></h2> <p>Via CFG doivent être sélectionnés les objets à rendre éditable directement.</p> <p>Les articles sont par défaut en mode édition directe.</p> <h2 class="h2" id='Etat-d-avancement'>État d'avancement:<a class='sommaire-back sommaire-back-5' href='#s-Etat-d-avancement' title='Back to the table of contents'></a></h2> <p><strong>Si le plugin est utilisé pour un spip 2 ou 2.1</strong></p> <p>Les objets suivants sont éditables directement:</p> <ul class="spip" role="list"><li> article</li><li> rubrique</li><li> brève</li><li> site</li></ul><h2 class="h2" id='Pour-Developpeur'>Pour Développeur<a class='sommaire-back sommaire-back-5' href='#s-Pour-Developpeur' title='Back to the table of contents'></a></h2> <p>Une pipeline permet désormais d'influencer sur l'activation de l'édition directe. Ce qui permet par exemple de la restreindre à une rubrique ou d'ajouter d'avantage de critères.</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code> $pipeline= pipeline('edition_directe_controle',array( 'args'=>array( 'objet'=>$objet ), 'data'=>$config ));</code></pre></div> <p>$config étant un array des objets choisis pour l'édition directe via cfg</p> <p>array('nom_objet'=>'on')</p></div> </article> <article> <h1>Galleria (fr)</h1> <p>emthanh, Matthieu Marcillaud, RealET — 2011-11-16T20:23:39Z</p> <div class='rss_chapo'><p>Une galerie d'image qui utilise la librairie javascript Galleria.</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d149682d30.05264281"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Description"></a><a href="#Description" class="spip_ancre">Description</a></li><li> <a id="s-Utilisation"></a><a href="#Utilisation" class="spip_ancre">Utilisation</a></li><li> <a id="s-Options"></a><a href="#Options" class="spip_ancre">Options</a></li><li> <a id="s-Bug-connu"></a><a href="#Bug-connu" class="spip_ancre">Bug connu</a></li></ul></div></p> <h2 class="h2" id='Description'>Description<a class='sommaire-back sommaire-back-4' href='#s-Description' title='Back to the table of contents'></a></h2> <p>Ce plugin vous permet d'ajouter des galeries d'images à vos articles. La galerie créée utilise la librairie javascript Galleria. Le plugin propose un modèle nommé <code class='spip_code spip_code_inline' dir='ltr'><galleria></code>.</p> <h2 class="h2" id='Utilisation'>Utilisation<a class='sommaire-back sommaire-back-4' href='#s-Utilisation' title='Back to the table of contents'></a></h2> <p>Pour créer une galerie d'image ajoutez une balise <code class='spip_code spip_code_inline' dir='ltr'><galleria##></code> dans un article, où <code class='spip_code spip_code_inline' dir='ltr'>##</code> est l'ID d'un article.Les images de la galerie sont celles liés à l'article.</p> <h2 class="h2" id='Options'>Options<a class='sommaire-back sommaire-back-4' href='#s-Options' title='Back to the table of contents'></a></h2> <p>Les options les plus courantes du modèle sont : <br />- width <br />- height <br />- lightbox :<abbr title="false">true</abbr> <br />- transition :[fade|flash|pulse|slide|fadeslide|doorslide] <br />- theme : le nom d'un theme Galleria <br />- pagesize : le nombre d'image par page</p> <p>Ex : <code class='spip_code spip_code_inline' dir='ltr'><galleria22></code> une galerie dans l'article 22 ; <code class='spip_code spip_code_inline' dir='ltr'><galleria22|lightbox=true></code> activation de l'effet lightbox</p> <p>Pour plus d'options et de personnalisation de la galerie reportez-vous directement au <a href="https://galleriajs.github.io/" class="spip_out" rel="external">site de Galleria</a></p> <h2 class="h2" id='Bug-connu'>Bug connu<a class='sommaire-back sommaire-back-4' href='#s-Bug-connu' title='Back to the table of contents'></a></h2> <p>Lorsqu'on ajoute plusieur galerie dans un même article, la galerie ne fonctione pas correctement. (bug fermé avec la version 1.3.1)</p> <div class='spip_document_10090 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <div class='spip_document_10089 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="44" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10089 '><strong>ouverture avec lightbox/open with lightbox </strong></div> </figcaption></figure> </div></div> </article> <article> <h1>Mailsubscribers</h1> <p>Cerdic — 2013-01-16T11:59:07Z</p> <div class='rss_chapo'><p>Ce plugin permet de gérer les inscriptions (ou abonnements) à la diffusion de contenu par email.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-6" id="nav6a60d1496ca7d5.87197097"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Configuration"></a><a href="#Configuration" class="spip_ancre">Configuration</a></li><li> <a id="s-Inscription-desinscription-sur-le-site-public"></a><a href="#Inscription-desinscription-sur-le-site-public" class="spip_ancre">Inscription-désinscription sur le site public</a></li><li> <a id="s-Administration-des-inscrits"></a><a href="#Administration-des-inscrits" class="spip_ancre">Administration des inscrits</a></li><li> <a id="s-Newsletter-confirmation-d-inscription-reconsentement"></a><a href="#Newsletter-confirmation-d-inscription-reconsentement" class="spip_ancre">Newsletter : confirmation d'inscription / reconsentement</a></li><li> <a id="s-Migration-depuis-un-ancien-plugin"></a><a href="#Migration-depuis-un-ancien-plugin" class="spip_ancre">Migration depuis un ancien plugin</a></li></ul></div><p><strong>Mailsubscribers</strong> permet de gérer les inscriptions par Opt-in simple ou double et la désinscription par URL. Ce plugin gère également plusieurs listes de diffusion (simplifiées) permettant de cibler des listes d'inscrits au cas par cas dans les envois en nombre par courrier électronique.</p> <p>Pour les développeur/euses, ce plugin implémente la partie <i>subscribe</i> de l'<a href='https://contrib.spip.net/API-Newsletter' class="spip_in" hreflang="fr">API Newsletter</a> et peut donc être utilisé avec les plugins <a href='https://contrib.spip.net/Newsletters' class="spip_in" hreflang="fr">Newsletters</a> et <a href='https://contrib.spip.net/Mailshot' class="spip_in" hreflang="fr">Mailshot</a> pour l'envoi de Newsletters.</p> <h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-6' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Le plugin s'installe classiquement, et ne nécessite pas d'autre plugin pour fonctionner. Cependant, si vous souhaitez importer et exporter des listes d'abonnés au format CSV, vous devrez installer le plugin complémentaire <a href='https://contrib.spip.net/SPIP-Bonux' class="spip_in" hreflang="fr">SPIP Bonux</a>.</p> <h2 class="h2" id='Configuration'>Configuration<a class='sommaire-back sommaire-back-6' href='#s-Configuration' title='Back to the table of contents'></a></h2> <p>Vous pouvez configurer ce plugin pour l'adapter à vos besoins.</p> <div class='spip_document_11320 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h4>Opt-in</h4> <p>Vous pouvez choisir le fonctionnement en simple Opt-in ou double Opt-in :</p> <ul class="spip" role="list"><li> en <dfn>simple opt-in</dfn> : il suffit pour s'inscrire que la personne renseigne son email dans un formulaire d'inscription explicitement dédié à l'envoi d'informations par mail, ou qu'il coche une case “je veux m'inscrire à la Newsletter” dans un autre formulaire (inscription comme redacteur dans le site par exemple) ;</li><li> en <dfn>double opt-in</dfn> : l'inscription est mise en attente suite à cette première étape, et un email est envoyé sur l'adresse courriel renseignée, demandant de cliquer sur un lien pour confirmer l'inscription. Il y a donc une étape de vérification.</li></ul> <p>Le mode double opt-in permet d'avoir une base d'inscrits de meilleure qualité. Il évite les inscriptions forcées, pour le compte d'autrui, ainsi que d'inscrire une adresse email erronée (faute de frappe). Ce mode est nécessaire dans certain pays pour être en accord avec la loi. En France le simple opt-in suffit, mais il est recommandé d'utiliser le double opt-in.</p> <h4>Inscription à la Newsletter lors de l'inscription au site</h4> <p>Si vous activez cette option, une case à cocher sera automatiquement ajoutée sur le formulaire d'inscription au site pour permettre l'inscription à la Newsletter en même temps.</p> <div class='spip_document_11318 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h4>Listes de diffusion</h4> <p>Pour chaque liste, indiquez un identifiant (lettres et chiffres uniquement) ainsi qu'un libellé explicite. Vous pouvez a posteriori fermer une liste : dans ce cas il n'est plus possible de s'y inscrire, mais vous conservez tout de même la liste des inscrits en base de donnée.</p> <p>Par défaut, il n'y a qu'une liste de diffusion disponible, avec l'identifiant <tt>newsletter</tt>.</p> <p><a id="nh17-1"></a></p> <h4>Listes de diffusion automatiques</h4> <p>Il est possible d'avoir des listes de diffusion dont les abonnés sont automatiquement synchronisées avec d'autres tables ou même d'autres bases<span class="spip_note_ref"> [<a href="#nb10-1" class="spip_note" rel="appendix" title="à partir de la version 1.6.0" id="nh10-1">1</a>]</span>. Le plugin permet par exemple de créer les listes automatiques des Administrateurs, des Rédacteurs et des Visiteurs du site.</p> <div class='spip_document_12603 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Si vous cochez la liste des Administrateurs en Enregistrez, elle apparaîtra avec une mention précisant que cette liste est synchronisée automatiquement. Si vous rafraichissez la page quelque minutes plus tard (ce n'est pas immédiat car la synchronisation est faite en tache de fond), le nombre d'abonnés apparaitra.</p> <div class='spip_document_12604 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Vous pouvez aussi définir votre propre liste automatique synchronisée. Pour cela, créez la liste avec un identifiant et un nom qui vous conviennent, puis ajoutez dans votre fichier <code class='spip_code spip_code_inline' dir='ltr'>mes_fonctions.php</code> la fonction <code class='spip_code spip_code_inline' dir='ltr'>mailsubscribers_synchro_list_newsletter_xxx()</code> que vous aurez créé (en remplaçant <code class='spip_code spip_code_inline' dir='ltr'>xxx</code> par l'identifiant de votre liste). <br class='autobr' /> Cette fonction devra retourner un tableau d'abonnés, chacun étant décrit par un tableau avec <br />- l'entrée obligatoire <tt>email</tt> <br />- les entrées facultatives <tt>nom</tt> et <tt>prenom</tt>.</p> <p>Ces données peuvent venir aussi bien d'une table SQL, d'un fichier texte, CSV, d'une autre base de donnée…</p> <p>Le plugin synchronisera alors automatiquement 1 fois par jour les abonnés avec la liste fournie par votre fonction, et vous pourrez envoyer des Infolettres sur ces listes toujours à jour.</p> <h2 class="h2" id='Inscription-desinscription-sur-le-site-public'>Inscription-désinscription sur le site public<a class='sommaire-back sommaire-back-6' href='#s-Inscription-desinscription-sur-le-site-public' title='Back to the table of contents'></a></h2> <p>Le plugin ne propose par défaut aucune page d'inscription pour le site public. Vous devez ajouter le formulaire d'inscription et désinscription dans votre squelette.</p> <h4>Formulaire d'inscription</h4> <p>Vous pouvez insérer simplement le formulaire d'inscription dans votre squelette avec la balise <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_NEWSLETTER_SUBSCRIBE</code>. L'inscription se fera sur la liste par défaut <code class='spip_code spip_code_inline' dir='ltr'>newsletter</code>.</p> <div class='spip_document_11322 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Le formulaire est volontairement le plus simple possible se limitant à un label et un champ de saisie (automatiquement rempli par l'adresse email du visiteur si identifié). Cela vous permet d'ajouter un titre à votre guise. Vous pouvez modifier le libellé du bouton en personnalisant la chaine de langue <code class='spip_code spip_code_inline' dir='ltr'>bouton_subscribe</code>.</p> <p>Pour proposer l'inscription sur une autre liste ou plusieurs listes, indiquez l'identifiant de la ou les listes en argument de la balise, séparés par une virgule. Les paramètres à passer doivent être entre guillemets. Par exemple :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#FORMULAIRE_NEWSLETTER_SUBSCRIBE{ "newsletter,nouveautes", "checklist" }</code></pre></div> <p>Lors de son inscription, l'internaute reçoit un email d'information (ou de confirmation si double opt-in).</p> <p>Comme pour tous les formulaires, il est possible d'insérer le formulaire d'inscription à l'intérieur du texte d'un article, plutôt que dans un squelette, au moyen de l'appel de modèle suivant :<br class='autobr' /> <code class='spip spip_code spip_code_inline' dir='ltr'><formulaire|newsletter_subscribe|listes=liste1| ... ></code></p> <h4>Formulaire de désinscription</h4> <p>Comme pour le formulaire d'inscription, le formulaire de désinscription s'insère avec <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_NEWSLETTER_UNSUBSCRIBE</code>. Vous pouvez indiquer la ou les listes concernées en argument : <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_NEWSLETTER_UNSUBSCRIBE{"newsletter,nouveautes"}</code></p> <div class='spip_document_11324 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Vous pouvez modifier le libellé du bouton en personalisant la chaine de langue <code class='spip_code spip_code_inline' dir='ltr'>bouton_unsubscribe</code>.</p> <p>Lors de sa désinscription, l'internaute reçoit un email d'information. Si il n'est plus abonné à aucune liste, son adresse email est obfusquée, transformée en md5 de son email avec le domaine <tt>@example.org</tt>. Cela permet de préserver l'anonymat des désinscrit, mais de les garder en base pour éviter de les réinscrire par erreur en cas d'import d'adresses par exemple.</p> <h2 class="h2" id='Administration-des-inscrits'>Administration des inscrits<a class='sommaire-back sommaire-back-6' href='#s-Administration-des-inscrits' title='Back to the table of contents'></a></h2><h4>Liste des inscrits</h4> <p>La liste des inscrits est disponible dans l'espace privé, depuis le menu <strong>Activité</strong> > <strong>Inscrits aux envois par email</strong></p> <div class='spip_document_11319 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h4>Inscription</h4> <p>Vous pouvez inscrire une adresse email manuellement depuis l'espace privé en sélectionnant “Ajouter une inscription”.</p> <div class='spip_document_11339 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Vous devrez renseigner a minima l'adresse email et une liste de diffusion. L'inscrit sera par défaut “pas inscrit” et vous devrez modifier son statut pour l'inscrire réellement.<br class='autobr' /> Lorsque vous modifiez le statut par ce formulaire d'édition, aucun courriel de notification n'est envoyé à l'adresse email concernée.</p> <p>En revanche, dans tous les autres cas l'inscrit recevra automatiquement sur son adresse courriel un email de vérification quand vous lui mettez le statut “à confirmer”, et un email d'information si vous lui mettez le statut “abonné”. De même si vous le passez ensuite en “désabonné” un email d'information sera à nouveau envoyé. C'est par exemple le cas quand vous modifiez le statut de l'inscrit par le formulaire de changement dédié à cet effet :</p> <div class='spip_document_11340 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h4>Export des inscrits<span class="spip_note_ref"> [<a href="#nb10-2" class="spip_note" rel="appendix" title="Cette fonction nécessite la présence du plugin SPIP-Bonux" id="nh10-2">2</a>]</span></h4> <p>Vous pouvez télécharger la liste des inscrits ou de toutes les adresses (y compris les inscrits en attente ou les désinscrits<span class="spip_note_ref"> [<a href="#nb10-3" class="spip_note" rel="appendix" title="les adresses mails des désinscrits sont obfusquées par un md5 pour des (…)" id="nh10-3">3</a>]</span>) au format CSV. Chaque colonne correspond à un champ de la table.</p> <h4>Import des inscrits<span class="spip_note_ref"> [<a href="#nb10-4" class="spip_note" rel="appendix" title="Cette fonction nécessite la présence du plugin SPIP-Bonux" id="nh10-4">4</a>]</span></h4> <p>Vous pouvez importer une liste d'adresse mail à inscrire. Un fichier CSV est attendu, avec en première ligne le nom des champs, selon le même format que celui fournit en export. Si le fichier ne comporte qu'une seule colonne, il sera supposé que ce sont des emails. Cela vous permet d'importer des fichiers textes avec une adresse email par ligne comme les fichiers d'export générés par SPIP-Listes.</p> <p>Si votre fichier d'import contient une colonne statut, les adresses prendront automatiquement le statut fixé par le fichier. Un email de confirmation ou d'information sera envoyé à chaque adresse importée (sauf si vous cochez l'option pour ne pas notifier lors de l'import).</p> <p>Si votre fichier d'import ne contient pas de colonne statut, les adresses seront automatiquement inscrites (directement ou via un mail de confirmation selon le réglage de votre opt-in). Cependant, les adresses emails correspondant à des personnes désinscrites ne seront pas ré-inscrites.</p> <div class='spip_document_11341 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Après sélection d'un fichier, le formulaire vous montre une prévisualisation de l'interprétation des données sur les premières lignes du fichier, et vous pouvez lancer l'import si cela vous convient. A cette étape, vous pouvez préciser que cet import doit se faire sans notification des inscrits<span class="spip_note_ref"> [<a href="#nb10-5" class="spip_note" rel="appendix" title="réserver cet usage au transfert d'inscrits d'un site à un autre, et ne pas (…)" id="nh10-5">5</a>]</span>, ou aussi que vous voulez vider la table avant l'import (cas de la mise à jour complète de votre base par un fichier CSV). Cette dernière option ne vous est proposée que si vous êtes webmestre.</p> <h4>Traçabilité des inscriptions</h4> <p>À chaque fois qu'une adresse email est inscrite ou désinscrite, cela provoque l'enregistrement d'une trace dans le champ <i>optin</i> de l'adresse email correspondante. La trace sera enregistrée que l'inscription se fasse sur le site public, ou par un administrateur dans le back-office, ou même par un import de fichier.</p> <p>La trace contient la date et l'heure de la modification ainsi que les éléments d'identification de la personne qui a réalisé l'action (adresse IP si la personne n'est pas identifiée, ou id_auteur et nom de l'administrateur SPIP).</p> <p>Le champ <i>optin</i> qui garde cette trace n'est pas éditable, et peut donc être opposé comme justificatif si une personne manifeste sa désapprobation d'avoir été inscrite à son insu (à tort ou à raison).</p> <h2 class="h2" id='Newsletter-confirmation-d-inscription-reconsentement'>Newsletter : confirmation d'inscription / reconsentement <a class='sommaire-back sommaire-back-6' href='#s-Newsletter-confirmation-d-inscription-reconsentement' title='Back to the table of contents'></a></h2> <p>Il est possible d'envoyer un message aux abonné<span aria-hidden='true'>·</span>es n'ayant pas ouvert un seul mail depuis 1 an afin de leur demander de confirmer explicitement leur inscription et ainsi éviter de continuer à envoyer des newsletters à des gens qui ne les ouvrent pas.</p> <p>Cela s'appuie sur les statistiques des prestataires d'envois des mails ; cela ne fonctionnera donc pas avec un envoi via SMTP, qui n'obtient pas ces informations.</p> <h4 class="h4"> Envoyer le mail</h4> <p>Dans le menu Activité > Listes de diffusion, cliquer sur “Accéder à la gestion d'opt-in”.</p> <div class='spip_document_22413 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Choisir une liste de diffusion pour afficher les adresses qui n'ont pas ouvert de mail ainsi que celles qui ont ouvert mais pas cliqué de liens dedans. </p> <p>Il possible d'envoyer manuellement, liste par liste, un mail de confirmation à ces adresses. <br class='autobr' /> Ce mail offre le choix de rester abonner ou de se désabonner.</p> <p>Sans confirmation explicite après 7 jours, les adresses sont automatiquement désabonnées.</p> <h2 class="h2" id='Migration-depuis-un-ancien-plugin'>Migration depuis un ancien plugin<a class='sommaire-back sommaire-back-6' href='#s-Migration-depuis-un-ancien-plugin' title='Back to the table of contents'></a></h2> <p>Si vous utilisiez auparavant l'un des plugins SPIP-Listes, SPIP-Lettres, CleverMail ou MesAbonnés, les inscrits seront automatiquement importés lors de l'installation de MailSubscribers (dans le cas des plugins SPIP-Lettres et CleverMail, les désinscrits sont aussi importés).</p> <p>Pour cela vous devez avoir encore les tables de ces plugins dans votre base de données. Il vous faut donc désactiver votre ancien plugin, mais surtout ne pas le désinstaller car cela supprime les données.</p> <p>Après avoir installé le plugin et vérifié que toutes les adresses ont bien été importées, vous pouvez désinstaller votre ancien plugin pour supprimer ses données si vous le souhaitez.</p></div> <hr /> <div class='rss_notes'><div id="nb10-1"> <p><span class="spip_note_ref">[<a href="#nh10-1" class="spip_note" title="Footnotes 10-1" rev="appendix">1</a>] </span>à partir de la version 1.6.0</p> </div><div id="nb10-2"> <p><span class="spip_note_ref">[<a href="#nh10-2" class="spip_note" title="Footnotes 10-2" rev="appendix">2</a>] </span>Cette fonction nécessite la présence du plugin SPIP-Bonux</p> </div><div id="nb10-3"> <p><span class="spip_note_ref">[<a href="#nh10-3" class="spip_note" title="Footnotes 10-3" rev="appendix">3</a>] </span>les adresses mails des désinscrits sont obfusquées par un md5 pour des raisons de confidentialité</p> </div><div id="nb10-4"> <p><span class="spip_note_ref">[<a href="#nh10-4" class="spip_note" title="Footnotes 10-4" rev="appendix">4</a>] </span>Cette fonction nécessite la présence du plugin SPIP-Bonux</p> </div><div id="nb10-5"> <p><span class="spip_note_ref">[<a href="#nh10-5" class="spip_note" title="Footnotes 10-5" rev="appendix">5</a>] </span>réserver cet usage au transfert d'inscrits d'un site à un autre, et ne pas en profiter pour importer des adresses qui n'ont pas explicitement demandé à être inscrites</p> </div></div> </article> <article> <h1>Opérations électorales</h1> <p>Thrax — 2021-03-23T08:00:00Z</p> <div class='rss_chapo'><p>Ce plugin permet la gestion des opérations électorales (régionales, départementales, municipales, professionnelles...) tout le long du processus : l'établissement des listes avec ses candidates et candidats, la vérification de la recevabilité, la soumission des listes à un scrutin, le dépouillement et le calcul des résultats, la gestion de multiples scrutins dans une opération électorale. Toutes les opérations électorales, qui sont des démarches sensibles, se définissent dans l'espace privé. L'espace public, au travers des modèles et du formulaire de simulation, permet de faire des opérations sans danger : visualiser une liste, connaître un résultat, faire une simulation.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-7" id="nav6a60d14974afa0.83223912"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Configuration"></a><a href="#Configuration" class="spip_ancre">Configuration</a></li><li> <a id="s-Utilisation"></a><a href="#Utilisation" class="spip_ancre">Utilisation</a></li><li> <a id="s-Les-differents-objets-editoriaux"></a><a href="#Les-differents-objets-editoriaux" class="spip_ancre">Les différents objets éditoriaux</a></li><li> <a id="s-La-verification-de-la-recevabilite-des-listes"></a><a href="#La-verification-de-la-recevabilite-des-listes" class="spip_ancre">La vérification de la recevabilité des listes</a></li><li> <a id="s-Le-calcul-des-resultats"></a><a href="#Le-calcul-des-resultats" class="spip_ancre">Le calcul des résultats</a></li><li> <a id="s-Les-modeles"></a><a href="#Les-modeles" class="spip_ancre">Les modèles</a></li></ul></div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-7' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Ce plugin <i>nécessite</i> l'installation préalable de 3 plugins :</p> <ol class="spip" role="list"><li> <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">Saisies pour Formulaires</a>,</li><li> <a href='https://contrib.spip.net/Verifier' class="spip_in" hreflang="fr">Vérifier</a></li><li> <a href='https://contrib.spip.net/Le-plugin-YAML-v2' class="spip_in" hreflang="fr">Yaml</a>.</li></ol> <p>Ce plugin <i>utilise</i>, s'ils sont installés sur votre site, les plugins :</p> <ul class="spip" role="list"><li> <a href='https://contrib.spip.net/Territoires-utilisation-du-plugin' class="spip_in" hreflang="fr">Territoires</a>,</li><li> <a href='https://contrib.spip.net/Plugin-Inserer-Modeles' class="spip_in" hreflang="fr">Insérer Modèles</a>,</li><li> <a href='https://contrib.spip.net/Chart-js' class="spip_in" hreflang="fr">Chartjs</a>.</li></ul><h2 class="h2" id='Configuration'>Configuration<a class='sommaire-back sommaire-back-7' href='#s-Configuration' title='Back to the table of contents'></a></h2> <p><a href="https://www.spip.net/fr_article5414.html" class="spip_out" rel="external">La configuration du plugin</a> permet de lier ses objets (voir leur description ci-après) à d'autres objets de votre site, ce qui permettra, lors de la désinstallation, de retirer ces liaisons<span class="spip_note_ref"> [<a href="#nb12-1" class="spip_note" rel="appendix" title="Il peut être utile d'associer un auteur de votre site s'il est membre d'une (…)" id="nh12-1">1</a>]</span>.</p> <h2 class="h2" id='Utilisation'>Utilisation<a class='sommaire-back sommaire-back-7' href='#s-Utilisation' title='Back to the table of contents'></a></h2> <p>Pour faciliter la prise en main du plugin, depuis le menu <i>Edition</i> > <i>Opérations électorales</i> de l'espace privé, il est proposé <strong>l'installation d'exemples d'opérations électorales</strong> qui permettent de comprendre immédiatement l'imbrication des différents objets et l'utilisation du plugin.</p> <div class='spip_document_21733 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="80" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-21733 '><strong>Illustration d'affiche_gauche pour peupler la base de données par des exemples </strong></div> </figcaption></figure> </div><h2 class="h2" id='Les-differents-objets-editoriaux'>Les différents objets éditoriaux<a class='sommaire-back sommaire-back-7' href='#s-Les-differents-objets-editoriaux' title='Back to the table of contents'></a></h2> <p>Gérer des opérations électorales se fait assez simplement au travers de ce plugin par la création d'objets éditoriaux ayant une hiérarchie.</p> <table class="table spip"> <caption>Le plugin permet la création de 4 objets éditoriaux</caption> <thead><tr class='row_first'><th id='ida296_c0'> Icone </th><th id='ida296_c1'> Hiérarchie </th><th id='ida296_c2'> Table </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='ida296_c0'><div class='spip_document_21727 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="35" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-21727 '><strong>L'icône d'un membre (list_membre) </strong></div> </figcaption></figure> </div></td> <td headers='ida296_c1'>Un <strong>membre</strong> de la liste...</td> <td headers='ida296_c2'><code class='spip_code spip_code_inline' dir='ltr'>spip_list_membres</code></td></tr> <tr class='row_even even'> <td headers='ida296_c0'><div class='spip_document_21728 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="33" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-21728 '><strong>L'icône d'une liste (list_elec) </strong></div> </figcaption></figure> </div></td> <td headers='ida296_c1'>...qui vient sur une <strong>liste</strong>...</td> <td headers='ida296_c2'><code class='spip_code spip_code_inline' dir='ltr'>spip_list_elecs</code></td></tr> <tr class='row_odd odd'> <td headers='ida296_c0'><div class='spip_document_21730 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="37" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-21730 '><strong>L'icône d'un scrutin (list_scrutin) </strong></div> </figcaption></figure> </div></td> <td headers='ida296_c1'>...qui elle-même se soumet à un <strong>scrutin</strong>...</td> <td headers='ida296_c2'><code class='spip_code spip_code_inline' dir='ltr'>spip_list_scrutins</code></td></tr> <tr class='row_even even'> <td headers='ida296_c0'><div class='spip_document_21729 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="53" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-21729 '><strong>L'icône d'une opération électorale (list_operation) </strong></div> </figcaption></figure> </div></td> <td headers='ida296_c1'>...qui lui-même s'inscrit dans une <strong>opération électorale</strong>.</td> <td headers='ida296_c2'><code class='spip_code spip_code_inline' dir='ltr'>spip_list_operations</code></td></tr> </tbody> </table> <p>Il convient de débuter par la création d'une opération électorale.</p> <h2 class="h2" id='La-verification-de-la-recevabilite-des-listes'>La vérification de la recevabilité des listes<a class='sommaire-back sommaire-back-7' href='#s-La-verification-de-la-recevabilite-des-listes' title='Back to the table of contents'></a></h2> <p>Le plugin permet de vérifier la recevabilité des listes par des scripts YAML<span class="spip_note_ref"> [<a href="#nb12-2" class="spip_note" rel="appendix" title="L'existence de ces scripts écrits en language YAML et permettant la (…)" id="nh12-2">2</a>]</span>.</p> <p>Cette vérification se fait automatiquement et progressivement pour guider l'internaute dans l'élaboration de sa liste. Un avertissement apparaîtra si sa liste n'a pas le nombre suffisant de membres ou si elle ne respecte pas la parité attendue.</p> <p>Cette vérification se fait au niveau de l'objet éditorial <i>listes des candidatures</i>.</p> <div class='spip_document_21731 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="47" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-21731 '><strong>Tableau analysant la recevabilité d'une liste </strong></div> </figcaption></figure> </div> <p>Des info-bulles vous guide dans des opérations de rectification ou des stratégies de rééquilibrage.</p> <h2 class="h2" id='Le-calcul-des-resultats'>Le calcul des résultats<a class='sommaire-back sommaire-back-7' href='#s-Le-calcul-des-resultats' title='Back to the table of contents'></a></h2> <p>Le plugin permet le calcul du résultat du scrutin par l'appel d'une fonction.</p> <p>Ce calcul se fait au niveau de l'objet éditorial du <i>scrutin</i>. Ce calcul demande préalablement de renseigner les listes et le scrutin par les informations obtenues lors du dépouillement<span class="spip_note_ref"> [<a href="#nb12-3" class="spip_note" rel="appendix" title="Pour plus de facilité, un objet virtuel, , collecte et distribue ces (…)" id="nh12-3">3</a>]</span>. Le calcul de résultats complexes, par groupes ou sections de liste, est possible.</p> <div class='spip_document_21732 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="46" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-21732 '><strong>Tableau affichant les résultats d'un scrutin </strong></div> </figcaption></figure> </div> <p>Afin d'assurer la compatibilité ascendante pour les sites utilisant le plugin « <a href='https://contrib.spip.net/Plugin-scrutin-de-liste-a-la' class="spip_in" hreflang="fr">scrutin de liste à la proportionnelle</a> », le présent plugin reprend le formulaire <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_SCRUT_PROP{liste,sieges,quota,prime,repartition,inscrits,couleurs}</code><span class="spip_note_ref"> [<a href="#nb12-4" class="spip_note" rel="appendix" title="Voir ticket #1." id="nh12-4">4</a>]</span>.</p> <h2 class="h2" id='Les-modeles'>Les modèles<a class='sommaire-back sommaire-back-7' href='#s-Les-modeles' title='Back to the table of contents'></a></h2> <p>Différents <a href="https://www.spip.net/fr_article3454.html" class="spip_out" rel="external">modèles</a> sont à votre disposition<span class="spip_note_ref"> [<a href="#nb12-5" class="spip_note" rel="appendix" title="Pour faciliter de l'utilisation des modèles dans vos articles, le plugin (…)" id="nh12-5">5</a>]</span></p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>liste_candidatures</code> vous permet d'afficher une liste</li><li> <code class='spip_code spip_code_inline' dir='ltr'>resultat_scrutin</code> vous permet d'afficher le résultat d'un scrutin pour peu que vous l'ayez calculer dans l'espace privé de SPIP avant.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>resultat_scrutin_graph</code> permet d'afficher le résultat d'un scrutin de façon graphique<span class="spip_note_ref"> [<a href="#nb12-6" class="spip_note" rel="appendix" title="L'utilisation du modèle demande l'installation du plugin chartjs" id="nh12-6">6</a>]</span>.</li></ul></div> <hr /> <div class='rss_notes'><div id="nb12-1"> <p><span class="spip_note_ref">[<a href="#nh12-1" class="spip_note" title="Footnotes 12-1" rev="appendix">1</a>] </span>Il peut être utile d'associer un auteur de votre site s'il est membre d'une <i>liste</i>. Il peut être pertinent de préciser le ressort territorial de l'<i>opération électorale</i> en associant un territoire (plugin <a href='https://contrib.spip.net/Territoires-utilisation-du-plugin' class="spip_in" hreflang="fr">Territoires</a>) à celle-ci. Les liaisons font l'objet d'un soin particulier et apparaissent dans les listes avec un pictogramme adapté. La fonction <code class='spip_code spip_code_inline' dir='ltr'>filtre_picto_assos_dist</code>, déclarée dans le fichier <code class='spip_code spip_code_inline' dir='ltr'>op_elec_fonctions.php</code> permettant l'apparition de cette liaison peut être <a href="https://programmer.spip.net/Surcharger-une-fonction-_dist" class="spip_out" rel="external">surchargée</a>.</p> </div><div id="nb12-2"> <p><span class="spip_note_ref">[<a href="#nh12-2" class="spip_note" title="Footnotes 12-2" rev="appendix">2</a>] </span>L'existence de ces scripts écrits en language YAML et permettant la vérification de la recevabilité est à déclarer lors de la création de l'objet éditorial <i>scrutin</i>. Les scripts sont placés dans un répertoire dénommé <code class='spip_code spip_code_inline' dir='ltr'>recevabilites</code> soit dans le présent plugin soit dans votre propre plugin. La fonction <code class='spip_code spip_code_inline' dir='ltr'>recevabilites_analyse_de_recevabilite_dist</code>, déclarée dans le fichier <code class='spip_code spip_code_inline' dir='ltr'>recevabilites/analyse_de_recevabilite.php</code> permettant l'interprétation des scripts peut être <a href="https://programmer.spip.net/Surcharger-une-fonction-_dist" class="spip_out" rel="external">surchargée</a>.</p> </div><div id="nb12-3"> <p><span class="spip_note_ref">[<a href="#nh12-3" class="spip_note" title="Footnotes 12-3" rev="appendix">3</a>] </span>Pour plus de facilité, un objet virtuel, <code class='spip_code spip_code_inline' dir='ltr'>spip_list_calculs</code>, collecte et distribue ces informations entre les deux objets éditoriaux, <code class='spip_code spip_code_inline' dir='ltr'>spip_list_elecs</code> et <code class='spip_code spip_code_inline' dir='ltr'>spip_list_scrutins</code>. Une fois les calculs faits, une table auxiliaire vient accueillir les informations, <code class='spip_code spip_code_inline' dir='ltr'>spip_list_repartitions</code>. Ces résultats peuvent être affichés par une boucle, comme le fait le squelette <code class='spip_code spip_code_inline' dir='ltr'>prive/objets/contenu/list_scrutin.html</code></p> </div><div id="nb12-4"> <p><span class="spip_note_ref">[<a href="#nh12-4" class="spip_note" title="Footnotes 12-4" rev="appendix">4</a>] </span>Voir <a href="https://git.spip.net/spip-contrib-extensions/op_elec/issues/1" class="spip_out" rel="external">ticket #1</a>.</p> </div><div id="nb12-5"> <p><span class="spip_note_ref">[<a href="#nh12-5" class="spip_note" title="Footnotes 12-5" rev="appendix">5</a>] </span>Pour faciliter de l'utilisation des modèles dans vos articles, le plugin Opérations électorales utilise le plugin <a href='https://contrib.spip.net/Plugin-Inserer-Modeles' class="spip_in" hreflang="fr">inserer_modeles</a>.</p> </div><div id="nb12-6"> <p><span class="spip_note_ref">[<a href="#nh12-6" class="spip_note" title="Footnotes 12-6" rev="appendix">6</a>] </span>L'utilisation du modèle <code class='spip_code spip_code_inline' dir='ltr'>resultat_scrutin_graph</code> demande l'installation du plugin <a href='https://contrib.spip.net/Chart-js' class="spip_in" hreflang="fr">chartjs</a></p> </div></div> </article> <article> <h1>Plugin Insérer Modèles</h1> <p>Joseph — 2010-11-16T17:04:12Z</p> <div class='rss_chapo'><p>Ce plugin fournit une aide à l'insertion des modèles dans vos textes à travers des formulaires de saisies. Ces formulaires sont accessibles dans la colonne de droite ou via un bouton dans le <a href='https://contrib.spip.net/Porte-plume-3117' class="spip_in" hreflang="fr">porte-plume</a>.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d1497ab969.77147331"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Formulaires-d-insertion-dans-la-colonne-laterale"></a><a href="#Formulaires-d-insertion-dans-la-colonne-laterale" class="spip_ancre">Formulaires d'insertion dans la colonne latérale</a></li><li> <a id="s-Utilisation-avec-le-porte-plume"></a><a href="#Utilisation-avec-le-porte-plume" class="spip_ancre">Utilisation avec le porte-plume</a></li><li> <a id="s-Page-de-configuration-du-plugin"></a><a href="#Page-de-configuration-du-plugin" class="spip_ancre">Page de configuration du plugin</a></li><li> <a id="s-Declarer-des-modeles-a-Inserer-Modeles"></a><a href="#Declarer-des-modeles-a-Inserer-Modeles" class="spip_ancre">Déclarer des modèles à Insérer Modèles</a></li></ul></div><h2 class="h2" id='Formulaires-d-insertion-dans-la-colonne-laterale'>Formulaires d'insertion dans la colonne latérale<a class='sommaire-back sommaire-back-4' href='#s-Formulaires-d-insertion-dans-la-colonne-laterale' title='Back to the table of contents'></a></h2> <p>Sur les pages d'édition des articles, des rubriques, des brèves et des mots-clés, le formulaire ci-dessous est affiché dans la colonne latérale. Son contenu est fonction des plugins et modèles installés sur votre site.</p> <div class='spip_document_8888 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="20" data-legende-lenx="" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-8888 '><strong>Encart d'insertion </strong></div> </figcaption></figure> </div> <p>Sélectionnez le modèle que vous souhaitez insérer et remplissez le formulaire.</p> <p>Cliquez sur <i>Insérer</i> : l'appel du modèle est alors calculé et intégré à l'emplacement courant dans le texte.</p> <p><strong>Remarque :</strong> la liste des modèles proposés dépend des plugins installés sur votre site. En effet, charge à chaque plugin de déclarer à Insérer Modèles les modèles qu'il propose (cf. <a href='https://contrib.spip.net/Comment-declarer-un-modele-pour-le-plugin-Inserer' class="spip_in" hreflang="fr">Comment déclarer un modèle pour le plugin “Insérer Modèles”</a>). Si aucun plugin actif ne déclare de modèle à insérer, alors le formulaire d'Insérer modèles n'est pas affiché.</p> <p>Exemples de plugins déclarant des modèles à Insérer modèles : <br />- <a href='https://contrib.spip.net/Plugin-Modeles-media' class="spip_in" hreflang="fr">Plugin Modèles media</a>, <br />- <a href='https://contrib.spip.net/Formidable-le-generateur-de-formulaires' class="spip_in" hreflang="fr">Formidable, le générateur de formulaires</a>, <br />- <a href='https://contrib.spip.net/Cite-des-modeles-pour-les-references-bibliographiques' class="spip_in" hreflang="fr">Cite : des modèles pour les références bibliographiques</a>, <br />- <a href='https://contrib.spip.net/Modele-exergue' class="spip_in" hreflang="fr">Modèle exergue</a></p> <p>Votre squelette ou plugin peut également déclarer ses modeles pour que Insérer modèles les propose. Pour cela, suivez les instructions dans la dernière partie de cet article.</p> <h2 class="h2" id='Utilisation-avec-le-porte-plume'>Utilisation avec le porte-plume<a class='sommaire-back sommaire-back-4' href='#s-Utilisation-avec-le-porte-plume' title='Back to the table of contents'></a></h2> <p>Si le porte-plume est activé, un bouton pour l'insertion des modèles sera ajouté au porte-plume.</p> <div class='spip_document_8891 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Positionnez le curseur à l'endroit du texte où vous souhaitez insérer le modèle puis cliquez sur le bouton en forme de pièce de puzzle, vous ferez apparaître une <br class='autobr' /> fenêtre vous permettant de choisir le type de modèle que vous souhaitez insérer.</p> <p>Il est également possible de choisir directement le type de modèle que vous souhaitez insérer via les boutons (sous-menu) qui apparaissent au survol avec la souris du bouton principal.</p> <p>Remplissez le formulaire.</p> <div class='spip_document_22085 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="46" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/inserer_modele_porte_plume.png' class="spip_doc_lien mediabox" type="image/png"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-22085 '><strong>Insérer un modèle via la barre typographique </strong></div> </figcaption></figure> </div> <p>Lorsque vous cliquez sur <i>Insérer</i>, l'appel du modèle est calculé et automatiquement inséré à l'endroit où ce situait votre curseur dans le texte.</p> <div class='spip_document_8893 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Page-de-configuration-du-plugin'>Page de configuration du plugin<a class='sommaire-back sommaire-back-4' href='#s-Page-de-configuration-du-plugin' title='Back to the table of contents'></a></h2> <p>La page de configuration du plugin permet : <br />- de lister les pages d'édition où utiliser le plugin ; <br />- d'activer ou non la répartition des modèles en catégories ; ce sont les modèles qui déclarent la catégorie utilisé, mais il existe un mécanisme de pipeline pour modifier ; <br />- de désactiver certains modèles<span class="spip_note_ref"> [<a href="#nb13-1" class="spip_note" rel="appendix" title="À noter que pour les dev, il est également possible de désactiver certains (…)" id="nh13-1">1</a>]</span>.</p> <h2 class="h2" id='Declarer-des-modeles-a-Inserer-Modeles'>Déclarer des modèles à Insérer Modèles<a class='sommaire-back sommaire-back-4' href='#s-Declarer-des-modeles-a-Inserer-Modeles' title='Back to the table of contents'></a></h2> <p>Le plugin Insérer Modèles proposera à l'insertion tous les fichiers YAML trouvés dans un sous-répertoire <code class='spip_code spip_code_inline' dir='ltr'>modeles/</code> de plugins actifs. Ces fichiers permettent de décrire le formulaire d'insertion du ou des modèles concernés.</p> <p>Pour plus de détails, voir <a href='https://contrib.spip.net/Comment-declarer-un-modele-pour-le-plugin-Inserer' class="spip_in" hreflang="fr">Comment déclarer un modèle pour le plugin “Insérer Modèles”</a>.</p></div> <hr /> <div class='rss_notes'><div id="nb13-1"> <p><span class="spip_note_ref">[<a href="#nh13-1" class="spip_note" title="Footnotes 13-1" rev="appendix">1</a>] </span>À noter que pour les dev, il est également possible de <a href="https://git.spip.net/spip-contrib-extensions/inserer_modeles/commit/b9760bf4e0a37a0a93c6f0d5a5f4d4b55afd0a42" class="spip_out" rel="external">désactiver certains modèles via un pipeline</a>.</p> </div></div> </article> <article> <h1>Rang : ordonner une liste par Drag&Drop</h1> <p>nicod_, Peetdu — 2018-05-05T15:40:29Z</p> <div class='rss_chapo'><p>Dans l'espace privé, pouvoir ordonner une liste d'objets par glisser-déposer. Par exemple la liste des articles d'une rubrique.</p> <p>Il devient possible d'utiliser le critère <i>par rang</i> dans vos squelettes.</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-7" id="nav6a60d1497eadc1.58808571"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Configuration"></a><a href="#Configuration" class="spip_ancre">Configuration</a></li><li> <a id="s-Dans-vos-squelettes"></a><a href="#Dans-vos-squelettes" class="spip_ancre">Dans vos squelettes</a></li><li> <a id="s-Cas-particulier-de-classement"></a><a href="#Cas-particulier-de-classement" class="spip_ancre">Cas particulier de classement</a></li><li> <a id="s-Comment-utiliser-ce-plugin-pour-faire-du-drag-amp-drop-sur-mon-objet-editorial"></a><a href="#Comment-utiliser-ce-plugin-pour-faire-du-drag-amp-drop-sur-mon-objet-editorial" class="spip_ancre">Comment utiliser ce plugin pour faire du drag&drop sur mon objet éditorial</a></li><li> <a id="s-Declarer-le-parent-d-un-objet-editorial"></a><a href="#Declarer-le-parent-d-un-objet-editorial" class="spip_ancre">Déclarer le parent d'un objet éditorial</a></li><li> <a id="s-Notes-techniques"></a><a href="#Notes-techniques" class="spip_ancre">Notes techniques</a></li></ul></div></p> <h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-7' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Il <a href="https://www.spip.net/fr_article3396.html" class="spip_out" rel="external">s'installe comme tous les plugins</a>.</p> <p>Avec SPIP < v4 il nécessite le plugin <a href="https://plugins.spip.net/declarerparent.html" class="spip_out" rel="external">Déclarer parent</a> (installé en dépendance).</p> <p>Il est fourni avec une surcharge des squelettes du core et du plugin mots, permettant de ranger les articles et les mots clés dans l'espace privé.</p> <h2 class="h2" id='Configuration'>Configuration<a class='sommaire-back sommaire-back-7' href='#s-Configuration' title='Back to the table of contents'></a></h2> <div class='spip_document_14047 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p><strong>Choisir les objets</strong><br class='autobr' /> …pour lesquels vous voulez activer le drag&drop.</p> <p>Ici vous pouvez activer :</p> <ul class="spip" role="list"><li> les Articles,</li><li> les Site référencés,</li><li> les Mots-clés,</li><li> les objets éditoriaux gérés par d'autres plugins.</li></ul> <p><strong>Ranger les objets</strong><br class='autobr' /> Si cette case est cochée, les nouveaux objets créés seront rangés automatiquement à la fin de la liste, avec le rang le plus élevé +1.</p> <h2 class="h2" id='Dans-vos-squelettes'>Dans vos squelettes<a class='sommaire-back sommaire-back-7' href='#s-Dans-vos-squelettes' title='Back to the table of contents'></a></h2> <p>Il est possible d'utiliser le critère <i>par rang</i> pour les objets activés dans la configuration.</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_articles(ARTICLES){id_rubrique}{par rang}> <h2>#TITRE</h2> <div>#TEXTE</div> </BOUCLE_articles></code></pre></div><h2 class="h2" id='Cas-particulier-de-classement'>Cas particulier de classement<a class='sommaire-back sommaire-back-7' href='#s-Cas-particulier-de-classement' title='Back to the table of contents'></a></h2> <p>Si vous avez un cas particulier, vous pouvez utiliser le pipeline <strong>rang_declarer_contexte</strong> pour ajouter d'autres contextes à cette liste.</p> <p><strong>Exemple</strong><br class='autobr' /> Pouvoir classer les définitions qui apparaissent dans la page <code class='spip_code spip_code_inline' dir='ltr'>exec=dictionnaire</code>.</p> <p>1- déclarer le pipeline dans le fichier <code class='spip_code spip_code_inline' dir='ltr'>paquet.xml</code> (du plugin “prefixplugin” ici)</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><pipeline nom="rang_declarer_contexte" inclure="prefixplugin_pipelines.php" /></code></pre></div> <p>2- puis dans le fichier <code class='spip_code spip_code_inline' dir='ltr'>prefixplugin_pipelines.php</code> ajouter la fonction suivante :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>function prefixplugin_rang_declarer_contexte($flux) { $flux[] = 'dictionnaire'; return $flux; }</code></pre></div><h2 class="h2" id='Comment-utiliser-ce-plugin-pour-faire-du-drag-amp-drop-sur-mon-objet-editorial'>Comment utiliser ce plugin pour faire du drag&drop sur mon objet éditorial<a class='sommaire-back sommaire-back-7' href='#s-Comment-utiliser-ce-plugin-pour-faire-du-drag-amp-drop-sur-mon-objet-editorial' title='Back to the table of contents'></a></h2> <p>La première chose à faire est bien sûr de cocher l'objet (exemple : Patates) dans la configuration du plugin.</p> <p>Ensuite, il faut modifier le squelette <code class='spip_code spip_code_inline' dir='ltr'>/prive/objets/liste/patates.html</code> pour y ajouter quelques informations.<br class='autobr' /> Sur la base d'un squelette généré par la Fabrique, voici les modifications à y apporter.</p> <p><strong>1- Pouvoir trier la liste par rang</strong><br class='autobr' /> Dans le tableau ci-dessous, ajouter l'entrée <code class='spip_code spip_code_inline' dir='ltr'>rang,1</code></p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#SET{defaut_tri,#ARRAY{ rang,1, titre,1, date,-1, id_patate,1, points,-1 }})]</code></pre></div> <p><strong>2- Vérifier que l'objet a bien été sélectionné dans la configuration</strong><br class='autobr' /> Juste après ce tout premier bloc qui détermine le sens de tri, ajouter le test qui détermine si l'objet est effectivement coché dans la configuration de Rang ou pas, et stocker le résultat pour ne pas le recalculer ensuite.</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#SET{activer_rang, #VAL{patates}|in_array{#RANG_LISTE_OBJETS} }</code></pre></div> <p><strong>Si l'objet éditorial a un objet parent</strong> (par exemple, le parent d'un article est une rubrique, le parent d'un mot est un groupe_mot), il faut aussi tester si l'identifiant du parent est bien reçu dans l'environnement.<br class='autobr' /> On trie alors les objets en fonction de leurs parents.</p> <p>Dans le cas d'un article par exemple, le test serait :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#SET{activer_rang, #ENV{id_rubrique}|et{#VAL{articles}|in_array{#RANG_LISTE_OBJETS}} }</code></pre></div> <p><strong>3- toujours pour le tri</strong><br class='autobr' /> si le rang est activé sur cet objet, on applique un tri par rang par défaut.</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#GET{activer_rang}|oui) [(#VAL{rang}|setenv{par})] #SET{tri,rang} ]</code></pre></div> <p><strong>4- Pour pouvoir insérer et configurer le code javascript qui va gérer le drag&drop</strong><br class='autobr' /> …Il faut préciser sur quel objet il va s'appliquer.<br class='autobr' /> On ajoute donc un attribut <code class='spip_code spip_code_inline' dir='ltr'>data-objets</code> à la table :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><table class="spip liste" data-objet="patates"></code></pre></div> <p><strong>5- Afficher le Rang</strong></p> <p>Par défaut, la Fabrique génère des squelettes qui affichent la balise #RANG à côté du #TITRE. Mais nous voulons pouvoir trier aussi bien par rang que par titre, nous allons donc séparer ces deux colonnes.</p> <p>Dans le <code class='spip_code spip_code_inline' dir='ltr'><thead></code>, on ajoute juste avant celle du titre une colonne pour trier par Rang :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#GET{activer_rang}|oui)<th class="rang" scope="col">[(#TRI{rang,<span title="<:rang:lien_trier_rang|attribut_html:>"><:rang:info_rang_abbr:></span>,ajax})]</th>]</code></pre></div> <p>Et dans le <code class='spip_code spip_code_inline' dir='ltr'><tbody></code>, on ajoute la colonne correspondante :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#GET{activer_rang}|oui)<td class="rang">[(#RANG).]</td>]</code></pre></div> <p>Dans le <code class='spip_code spip_code_inline' dir='ltr'><td class="titre principale"></code> qui contient le titre, on peut donc supprimer la balise <code class='spip_code spip_code_inline' dir='ltr'>[(#RANG).]</code></p> <p><strong>6- Ajout de l'attribut <code class='spip_code spip_code_inline' dir='ltr'>data-id_objet</code></strong><br class='autobr' /> Ajouter un attribut <code class='spip_code spip_code_inline' dir='ltr'>data-id_objet</code> sur le <code class='spip_code spip_code_inline' dir='ltr'><tr></code> de chaque objet :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><tr [(#GET{activer_rang}|oui)data-id_objet="#ID_PATATE"] class="[(#COMPTEUR_BOUCLE|alterner{row_odd,row_even})]"></code></pre></div> <p>Le code javascript qui gère le drag&drop ajoutera automatiquement une colonne supplémentaire avec un petit picto symbolisant une poignée, qui indique que les objets peuvent être déplacés dans la liste.</p> <h2 class="h2" id='Declarer-le-parent-d-un-objet-editorial'>Déclarer le parent d'un objet éditorial<a class='sommaire-back sommaire-back-7' href='#s-Declarer-le-parent-d-un-objet-editorial' title='Back to the table of contents'></a></h2> <p>Pour les objets qui ont une liaison directe avec un autre objet (i.e. sont enfants de cet objet par un <strong>id_</strong>, par exemple <strong>spip_articles</strong> qui contient un <strong>id_rubrique</strong>), le plugin rang a besoin de savoir quel est le parent des objets qu'on veut classer.</p> <p>Il utilise pour ça la fonction du core <strong>objet_lister_parents()</strong> (dans <code class='spip_code spip_code_inline' dir='ltr'>ecrire/base/objets.php</code>).</p> <p>Cette déclaration peut être faite soit par la déclaration d'un ['parent'] dans la description de la table de l'objet :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code> 'parent' => [ 'type' => 'type_du_parent', 'champ' => 'id_type_du_parent' ],</code></pre></div> <p>soit par l'utilisation du pipeline <code class='spip_code spip_code_inline' dir='ltr'>objet_lister_parents</code>.</p> <h2 class="h2" id='Notes-techniques'>Notes techniques<a class='sommaire-back sommaire-back-7' href='#s-Notes-techniques' title='Back to the table of contents'></a></h2> <p>a/ La balise <strong><code class='spip_code spip_code_inline' dir='ltr'>#RANG_LISTE_OBJETS</code></strong> calcule automatiquement la liste des contextes (i.e. pages <code class='spip_code spip_code_inline' dir='ltr'>/?exec=patates</code>) sur lesquels il insère le code javascript qui gère le drag&drop.</p> <p>Cette liste est calculée à partir des objets cochés dans la configuration, et y ajoute les noms des objets parents au singulier. Si vous avez coché <i>Articles</i> dans la configuration, la liste des contextes contiendra <i>articles</i> et <i>rubrique</i>.</p> <p>Le calcul s'appuie sur la convention que les noms des squelettes correspondent aux noms des objets, par exemple, les objets <i>patates</i> sont listés dans le squelette <i>/prive/objets/liste/patates.html</i> et affichés dans <i>/prive/objets/contenu/patate.html</i>.</p> <p>Enfin la balise <code class='spip_code spip_code_inline' dir='ltr'>#RANG_LISTE_OBJETS</code> offre l'avantage de ne plus être interprétée si le plugin est désactivé ou désinstallé. Les surcharges de squelettes sont donc compatible <i>“avec et sans”</i> le plugin Rang, et ne génèreront pas d'erreurs.</p> <p>b/ Ce plugin surcharge la balise #RANG du core de SPIP.</p> <p>c/ Lorsque vous activez un objet dans la config, le plugin va créer un champ 'rang' dans la table de l'objet sélectionné.</p></div> </article> <article> <h1>Utiliser le squelette « Documentation » pour rédiger un livre</h1> <p>Maïeul — 2012-01-17T16:54:06Z</p> <div class='rss_chapo'><p>La manière la plus simple pour se lancer dans le projet « un livre avec SPIP » est d'utiliser le squelette documentation pour SPIP 3.</p> <p>Ce squelette est celui utilisé par le site de Marcimat <a href="http://programmer.spip.org/" class="spip_out" rel="external">Programmer avec SPIP</a>, mais porté sur SPIP 3.</p> <p>Dans cet article, j'explique comment installer et l'utiliser de manière à optimiser l'export en <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d14981f3f2.08600347"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Utilisation"></a><a href="#Utilisation" class="spip_ancre">Utilisation</a></li><li> <a id="s-Raccourcis-typographique"></a><a href="#Raccourcis-typographique" class="spip_ancre">Raccourcis typographique</a></li><li> <a id="s-Production-du-PDF"></a><a href="#Production-du-PDF" class="spip_ancre">Production du PDF</a></li></ul></div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-4' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Le squelette est distribué sous forme de plugin. <a href="http://www.spip.net/fr_article3396.html" class="spip_out" rel="external">Il s'installe comme n'importe quel plugin</a>.</p> <p>Toutefois il nécessite au minimum SPIP 3.</p> <p>En outre il a besoin des plugins : <br />- <a href='https://contrib.spip.net/Le-Squelette-Zpip' class="spip_in" hreflang="fr">ZPIP 1.7.x</a> <br />- <a href='https://contrib.spip.net/Criteres-precedent-et-suivant' class="spip_in" hreflang="fr">Critères <code class='spip_code spip_code_inline' dir='ltr'>precedent</code> et <code class='spip_code spip_code_inline' dir='ltr'>suivant</code></a> <br />- <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">Saisie</a> <br />- <a href='https://contrib.spip.net/Champs-Extras-Interface' class="spip_in" hreflang="fr">Champ extra 3</a></p> <h2 class="h2" id='Utilisation'>Utilisation<a class='sommaire-back sommaire-back-4' href='#s-Utilisation' title='Back to the table of contents'></a></h2> <p><strong>Arborescence</strong></p> <p>Puisque le but est d'utiliser le squelette pour ensuite fabriquer un <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> pour l'impression, il est bon de savoir comment est organisé la hiérachie des titres dans un fichier LaTeX.<br class='autobr' /> Par défaut, tout les titres sont numérotés automatiquement. Voici les différents niveaux de titre, du plus important au plus faible.</p> <table class="table spip"> <thead><tr class='row_first'><th id='idb2ca_c0'>Nom de titre</th><th id='idb2ca_c1'>Code LaTeX</th><th id='idb2ca_c2'>Spécificité lors de la conversion en PDF</th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='idb2ca_c0'>Partie</td> <td headers='idb2ca_c1'><code class='spip_code spip_code_inline' dir='ltr'>\part</code></td> <td headers='idb2ca_c2'>Le titre est sur une page de droite dédiée.</td></tr> <tr class='row_even even'> <td headers='idb2ca_c0'>Chapitre</td> <td headers='idb2ca_c1'><code class='spip_code spip_code_inline' dir='ltr'>\chapter</code></td> <td headers='idb2ca_c2'>Un chapitre commence en haut de page, sur une page de droite.</td></tr> <tr class='row_odd odd'> <td headers='idb2ca_c0'>Section</td> <td headers='idb2ca_c1'><code class='spip_code spip_code_inline' dir='ltr'>\section</code></td> <td headers='idb2ca_c2'>Une section provoque un changement de paragraphe.</td></tr> <tr class='row_even even'> <td headers='idb2ca_c0'>Sous-section</td> <td headers='idb2ca_c1'><code class='spip_code spip_code_inline' dir='ltr'>\subsection</code></td> <td headers='idb2ca_c2'>Une sous-section provoque un changement de paragraphe</td></tr> </tbody> </table> <p>Il existe également les niveaux <code class='spip_code spip_code_inline' dir='ltr'>\subsubsection</code>, <code class='spip_code spip_code_inline' dir='ltr'>\paragraph</code> et <code class='spip_code spip_code_inline' dir='ltr'>\subparagraph</code>, mais ces nivaux ne sont pas utilisés lors de la génération des fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> par SPIP.</p> <p>À ces niveaux de titre LaTeX correspondent des nivaux dans la hiérachie des rubriques.</p> <p>- Le premier niveau (secteur) correspond à un livre entier. Un secteur correspondant à une langue. <br />- Le second niveau correspond à un partie au sens LaTeX (<code class='spip_code spip_code_inline' dir='ltr'>\part</code>). Exemple de rubrique de niveau <code class='spip_code spip_code_inline' dir='ltr'>\part</code> : <a href="http://programmer.spip.org/-Ecriture-des-squelettes-" class="spip_url spip_out auto" rel="nofollow external">http://programmer.spip.org/-Ecriture-des-squelettes-</a>. <br />- Le troisième niveau correspond à un chapitre au sens LaTeX (<code class='spip_code spip_code_inline' dir='ltr'>\chapter</code>) <a href="http://programmer.spip.org/-Les-boucles-" class="spip_url spip_out auto" rel="nofollow external">http://programmer.spip.org/-Les-boucles-</a>. <br />- Un article correspond à une section au sens LaTeX (<code class='spip_code spip_code_inline' dir='ltr'>\section</code>) <a href="http://programmer.spip.org/Syntaxe-des-boucles" class="spip_url spip_out auto" rel="nofollow external">http://programmer.spip.org/Syntaxe-des-boucles</a>. <br />- Les raccourcis <code class='spip_code spip_code_inline' dir='ltr'>{{{…}}}</code> provoquent des sous-sections. (<code class='spip_code spip_code_inline' dir='ltr'>\subsection</code>).</p> <p><strong>Contenu des articles</strong><br class='autobr' /> En plus du classique champs titre et texte, chaque article peut avoir un exemple, un exercice et une réponse à l'exercice. Le champ PS est également utilisé.</p> <p>Lors de l'export en <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>, les trois champs supplémentaires (<code class='spip_code spip_code_inline' dir='ltr'>exemple</code>, <code class='spip_code spip_code_inline' dir='ltr'>exercice</code>, <code class='spip_code spip_code_inline' dir='ltr'>réponse</code>) seront encadrés d'un code signalant qu'il faudra les mettre dans un cadre gris dans le PDF final.</p> <p>Les champs <code class='spip_code spip_code_inline' dir='ltr'>exemple</code>, <code class='spip_code spip_code_inline' dir='ltr'>exercice</code>, <code class='spip_code spip_code_inline' dir='ltr'>réponse</code> et <code class='spip_code spip_code_inline' dir='ltr'>PS</code> seront précédés d'intertitres.</p> <p><strong>Ordre des rubriques / articles</strong></p> <p>Il est possible de ne pas écrire les rubriques / articles dans leur ordre logiques. Pour déterminer l'ordre des rubriques / articles, il suffit de faire précéder les titres d'un nombre, suivi d'un point, suivi d'un espace :</p> <p><code class='spip_code spip_code_inline' dir='ltr'>1. Rubrique qui apparaîtra en premier</code></p> <h2 class="h2" id='Raccourcis-typographique'>Raccourcis typographique<a class='sommaire-back sommaire-back-4' href='#s-Raccourcis-typographique' title='Back to the table of contents'></a></h2> <p>On peut utiliser l'ensemble des raccourcis typographique de SPIP. Si on cite du code, il faut utiliser le plugin <a href='https://contrib.spip.net/Coloration-Code' class="spip_in" hreflang="fr">coloration code</a>.</p> <p>Un code entre <code class='spip_code spip_code_inline' dir='ltr'><cadre></code> aura ses lignes numérotées, pas un code entre <code class='spip_code spip_code_inline' dir='ltr'><code></code>.</p> <p>Par ailleurs, le module LaTeX de gestion du code sources colorés n'est pas capable de couper automatiquement les lignes trop longues : il faut donc les limiter directement au sein des balises <code class='spip_code spip_code_inline' dir='ltr'><cadre></code> ou <code class='spip_code spip_code_inline' dir='ltr'><code></code> (60 caractères approximativement, si vous gardez les réglage de format de papier et de marge standard).</p> <h2 class="h2" id='Production-du-PDF'>Production du PDF<a class='sommaire-back sommaire-back-4' href='#s-Production-du-PDF' title='Back to the table of contents'></a></h2> <p><a href='https://contrib.spip.net/Fabriquer-les-tex-puis-le-PDF' class="spip_in" hreflang="fr">La production du PDF est détaillé dans un autre article</a>.</p></div> </article> <article> <h1>Galleria guide complet</h1> <p>emthanh — 2012-05-05T01:48:58Z</p> <div class='rss_chapo'><p>Ce guide va vous aider à installer pas à pas le plugin Galleria.</p> <p>Ce plugin vous permet d'ajouter des galeries d'images à vos articles ou à vos squelettes.</p> <p>Galleria est une librairie javascript qui permet de créer une galerie d'image à partir d'une page HTML.Ce plugin est l'intégration de Galleria à SPIP.</p> <p>L'utilisation du plugin se fait par l'utilisation d'un modèle SPIP. Un modèle SPIP est une balise , ici nommée <i>galleria</i> , qui peut être ajoutée dans le texte d'un article. C'est donc un moyen souple d'édition de galeries.</p> <p>L'ajout de galerie peut aussi se faire d'une façon plus classique dans un squelette.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-8" id="nav6a60d1498604f2.87981374"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation-du-plugin"></a><a href="#Installation-du-plugin" class="spip_ancre">Installation du plugin</a></li><li> <a id="s-Le-premier-essai"></a><a href="#Le-premier-essai" class="spip_ancre">Le premier essai</a></li><li> <a id="s-Utilisation-des-options"></a><a href="#Utilisation-des-options" class="spip_ancre">Utilisation des options</a></li><li> <a id="s-Utiliser-le-modele-dans-un-squelette"></a><a href="#Utiliser-le-modele-dans-un-squelette" class="spip_ancre">Utiliser le modèle dans un squelette</a></li><li> <a id="s-Apparence"></a><a href="#Apparence" class="spip_ancre">Apparence</a></li><li> <a id="s-Trucs-et-Astuces"></a><a href="#Trucs-et-Astuces" class="spip_ancre">Trucs et Astuces</a></li><li> <a id="s-References"></a><a href="#References" class="spip_ancre">Références</a></li><li> <a id="s-Bug-connu"></a><a href="#Bug-connu" class="spip_ancre">Bug connu</a></li></ul></div><h2 class="h2" id='Installation-du-plugin'>Installation du plugin<a class='sommaire-back sommaire-back-8' href='#s-Installation-du-plugin' title='Back to the table of contents'></a></h2> <p>Il y a 2 moyens d'installer un plugin SPIP , par fichier zip ou en ligne. <br />- <u><strong>Pour installer un plugin par son fichier zip</strong></u>, vous devez récupérer l'archive <a href="http://files.spip.org/spip-zone/galleria.zip" class="spip_out" rel="external">ZIP</a> et la décompresser dans l'arborescence SPIP, sous le dossier <code class='spip_code spip_code_inline' dir='ltr'>./plugins</code><br class='autobr' /> On a alors l'arborescence suivante :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> config ecrire extensions images IMG local plugins->galleria prive ...</code></pre></div> <p>Vous devez ensuite activer le plugin dans l'espace privé ; dans le menu <strong>Configuration->Gestion des plugins->Liste des plugins</strong><br class='autobr' /> Vérifiez que le plugins est activé dans le menu <br class='autobr' /> <strong>Configuration->Gestion des plugins->Plugins actifs</strong></p> <p>- <u><strong>Installation automatique</strong></u> , SPIP charge pour vous le plugin et l'installe à partir d'internet<span class="spip_note_ref"> [<a href="#nb15-1" class="spip_note" rel="appendix" title="Cela suppose que vous ayez créé un sous-dossier" id="nh15-1">1</a>]</span>. Dans le menu <br class='autobr' /> <strong>Configuration->Gestion des plugins->Ajouter des plugins</strong> , trouvez Galleria dans la liste et cliquez sur télécharger. Le plugin est automatiquement télécharger ,installer et activer.<br class='autobr' /> Cette installation est plus simple et vous permettra d'avoir toujours la dernière version du plugin.</p> <h2 class="h2" id='Le-premier-essai'>Le premier essai<a class='sommaire-back sommaire-back-8' href='#s-Le-premier-essai' title='Back to the table of contents'></a></h2> <p>Le plugin est actif , il ne vous reste qu'à créer un article , ajouter des images à cet article. Puis dans le texte de cet article ajoutez la balise <galleriaXX> , ou XX est le numéro de l'article</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><galleria12></code></pre></div> <p>enregistrez votre article publiez le , vous aurez une galerie d'images avec les images de l'article 12.</p> <blockquote class="spip"> <p>Le numéro de l'article est inscrit en haut à gauche</p> </blockquote><h2 class="h2" id='Utilisation-des-options'>Utilisation des options<a class='sommaire-back sommaire-back-8' href='#s-Utilisation-des-options' title='Back to the table of contents'></a></h2> <p>L'utilisation des options se fait par le biais des paramètres d'un modèle.<br class='autobr' /> Pour utiliser l'option lightbox de Galleria modifiez l'article que vous venez de créer par</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><galleria12|lightbox=true></code></pre></div> <p>puis visionnez le résultat . Rien de différent pour l'instant , mais cliquez sur l'image affichée. Celle-ci doit s'ouvrir en plein écran.</p> <p>Vous pouvez aussi mixer les options</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><galleria12|lightbox=true|transition=fade></code></pre></div> <p>Une galerie avec l'effet lightbox et une transition en fondu.</p> <p>liste des options standards Galleria <br />- width <i>la largeur de la galerie d'images</i> <br />- height <i>la hauteur</i> <br />- lightbox :<abbr title="false">true</abbr> <i>activation de l'effet lightbox , image en plein écran</i> <br />- transition :[fade|flash|pulse|slide|fadeslide|doorslide] <i>la transition entre les images</i> <br />- theme : le nom d'un thème Galleria <i>voir les thèmes Galleria</i> <br />- pagesize : le nombre d'image par page <i>une option pour ce plugin SPIP seulement</i></p> <p>Il existe un très grand nombre d'autres options , veuillez vous référez au <a href="http://galleria.io/docs/options/#list-of-options" class="spip_out" rel="external">site de Galleria</a></p> <h2 class="h2" id='Utiliser-le-modele-dans-un-squelette'>Utiliser le modèle dans un squelette<a class='sommaire-back sommaire-back-8' href='#s-Utiliser-le-modele-dans-un-squelette' title='Back to the table of contents'></a></h2> <p>Un modele SPIP peut aussi être inclus dans un squelette.<br class='autobr' /> Ici la balise et le code équivalent dans le squelette.</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><galleria12> [(#MODELE{galleria}{id_article})] <galleria12|lightbox=true> [(#MODELE{galleria}{id_article,lightbox=true})] <galleria12|lightbox=true|transition=fade> [(#MODELE{galleria}{id_article,lightbox=true,transition=fade})]</code></pre></div><h2 class="h2" id='Apparence'>Apparence<a class='sommaire-back sommaire-back-8' href='#s-Apparence' title='Back to the table of contents'></a></h2> <div class='spip_document_10090 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <div class='spip_document_10089 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="44" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10089 '><strong>ouverture avec lightbox/open with lightbox </strong></div> </figcaption></figure> </div><h2 class="h2" id='Trucs-et-Astuces'>Trucs et Astuces<a class='sommaire-back sommaire-back-8' href='#s-Trucs-et-Astuces' title='Back to the table of contents'></a></h2> <p><br />- Ajouter une galerie avec les images d'un autre article.<br class='autobr' /> Il est possible de publier une galerie dans un article qui contiendra les images d'un autre article.<br class='autobr' /> ex: Si un article10 contient les images :img20 ,img21 ,img22 , en publiant dans un article13 ,la balise <tt><galleria10></tt> , cette galerie contiendra les images :img20 ,img21 ,img22 , même si article13 ne contient pas ces images.</p> <p>- Ajouter un titre et une description<br class='autobr' /> Vous pouvez renseigner le titre et la description d'une image liée à un article , qui apparaitront en haut à gauche la galerie</p> <div class='spip_document_10662 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>- Ajouter les images du portfolio <strong>version 1.3.2</strong><br class='autobr' /> Utilisez l'option mode=document pour choisir le portfolio comme source de vos images <br class='autobr' /> <tt><galleria22|mode=document></tt></p> <h2 class="h2" id='References'>Références<a class='sommaire-back sommaire-back-8' href='#s-References' title='Back to the table of contents'></a></h2><table class="table spip"> <thead><tr class='row_first'><th id='idf456_c0'> version </th><th id='idf456_c1'> 1.3.2 </th><th id='idf456_c2'> </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='idf456_c0'>installer un plugin SPIP</td> <td headers='idf456_c1'></td> <td headers='idf456_c2'><a href="http://www.spip.net/fr_article3396.html" class="spip_url spip_out" rel="external">http://www.spip.net/fr_article3396.html</a></td></tr> <tr class='row_even even'> <td headers='idf456_c0'>les modèles SPIP</td> <td headers='idf456_c1'></td> <td headers='idf456_c2'><a href="http://www.spip.net/fr_article3454.html" class="spip_url spip_out" rel="external">http://www.spip.net/fr_article3454.html</a></td></tr> <tr class='row_odd odd'> <td headers='idf456_c0'>liste des options Galleria</td> <td headers='idf456_c1'></td> <td headers='idf456_c2'><a href="http://galleria.io/docs/options/#list-of-options" class="spip_url spip_out" rel="external">http://galleria.io/docs/options/#li...</a></td></tr> <tr class='row_even even'> <td headers='idf456_c0'>SPIP minimum</td> <td headers='idf456_c1'>1.9.2</td> <td headers='idf456_c2'>librairie JQuery</td></tr> <tr class='row_odd odd'> <td headers='idf456_c0'>version Galleria actuelle</td> <td headers='idf456_c1'>latest</td> <td headers='idf456_c2'><a href="https://github.com/GalleriaJS/galleria/releases/latest" class="spip_out" rel="external">site de Galleria</a></td></tr> <tr class='row_even even'> <td headers='idf456_c0'>version Galleria du plugin</td> <td headers='idf456_c1'>1.2.9</td> <td headers='idf456_c2'>lien inactif</td></tr> <tr class='row_odd odd'> <td headers='idf456_c0'>version de développement</td> <td headers='idf456_c1'>2.1.11</td> <td headers='idf456_c2'></td></tr> <tr class='row_even even'> <td headers='idf456_c0'>svn</td> <td headers='idf456_c1'></td> <td headers='idf456_c2'><a href="svn://zone.spip.org/spip-zone/_plugins_/galleria" class="spip_url spip_out">svn://zone.spip.org/spip-zone/_plug...</a></td></tr> </tbody> </table><h2 class="h2" id='Bug-connu'>Bug connu<a class='sommaire-back sommaire-back-8' href='#s-Bug-connu' title='Back to the table of contents'></a></h2> <p>Lorsqu'on ajoute plusieurs galerie dans un même article, la galerie ne fonctionne pas correctement. (bug fermé avec la version 1.3.1)</p></div> <hr /> <div class='rss_notes'><div id="nb15-1"> <p><span class="spip_note_ref">[<a href="#nh15-1" class="spip_note" title="Footnotes 15-1" rev="appendix">1</a>] </span>Cela suppose que vous ayez créé un sous-dossier <code class='spip_code spip_code_inline' dir='ltr'>./plugins/auto</code></p> </div></div> </article> <article> <h1>Fabriquer les .tex puis le .PDF</h1> <p>Maïeul — 2012-01-17T16:54:09Z</p> <div class='rss_chapo'><p>Maintenant que votre livre est rédigé en version web grâce au <a href='https://contrib.spip.net/Utiliser-le-squelette-Documentation-pour-rediger-un' class="spip_in" hreflang="fr">squelette documentation</a>, il s'agit de produire le PDF, pour ensuite l'imprimer.</p> <p>Ceci se passe en deux étapes : <br />- générer un ensemble de fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> <br />- passer ces fichiers dans le « compilateur » LaTeX pour produire le PDF.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d14988ff57.14840035"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Faire-une-copie-locale"></a><a href="#Faire-une-copie-locale" class="spip_ancre">Faire une copie locale</a></li><li> <a id="s-Generer-les"></a><a href="#Generer-les" class="spip_ancre">Générer les <code class='spip_code spip_code_inline' dir='ltr'>.tex</code></a></li><li> <a id="s-Fabriquer-le-fichier-a-partir-des-fichiers"></a><a href="#Fabriquer-le-fichier-a-partir-des-fichiers" class="spip_ancre">Fabriquer le fichier <code class='spip_code spip_code_inline' dir='ltr'>PDF</code> à partir des fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code></a></li><li> <a id="s-Et-si-cela-ne-marche-pas"></a><a href="#Et-si-cela-ne-marche-pas" class="spip_ancre">Et si cela ne marche pas ?</a></li></ul></div><h2 class="h2" id='Faire-une-copie-locale'>Faire une copie locale<a class='sommaire-back sommaire-back-4' href='#s-Faire-une-copie-locale' title='Back to the table of contents'></a></h2> <p>La génération de l'ensemble des fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> est assez energivore. En effet il faut dans une même action : <br />- convertir les raccourcis SPIP en code LaTeX <br />- créer l'ensemble des fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> depuis la base de donnée. <br />- les mettre en ZIP.</p> <p>Pour cette raison, nous recommandons lors du passage en <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> de faire une copie locale du site.</p> <p>Pour ce faire, on se reportera à l'un des tutoriels suivant : <br />- <a href='https://contrib.spip.net/Installer-SPIP-sous-Mac-OS-X-avec-MAMP' class="spip_in" hreflang="fr">Pour Mac</a> <br />- <a href="http://www.generationcyb.net/Installer-SPIP-en-local-avec,1566" class="spip_out" rel="external">Pour Windows</a></p> <p>Une fois l'installation locale faite, il faut bien sûr récupérer le contenu de la base de donnée pour la copier en local. Ainsi que les éventuelles images du dossier IMG.</p> <h2 class="h2" id='Generer-les'>Générer les <code class='spip_code spip_code_inline' dir='ltr'>.tex</code><a class='sommaire-back sommaire-back-4' href='#s-Generer-les' title='Back to the table of contents'></a></h2> <p>Pour générér les <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>, il faudra installer : <br />- le plugin <strong>latexwheel</strong>, qui permet de convertir les raccourcis SPIP en code LaTeX. <br />- le plugin <strong>Zippeur</strong> version 2, pour assembler un ensemble de fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> en un zip. <br />- le jeu de squelettes <strong>documentation2latex</strong> qui proposent des squelettes produisants des fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> correspondants au squelette documentations.</p> <p>Une fois cela fait, on se rendra sur la page <code class='spip_code spip_code_inline' dir='ltr'>adressedusiteenlocal/?page=generer-zip</code>.</p> <p>L'ordinateur va ramer un peu pour générer les zips. Donc c'est normal que la page ne s'affiche pas tout de suite. Mais après, une fois que la page s'affiche, il suffit de cliquer sur le liens pour récuperer le zip.</p> <h2 class="h2" id='Fabriquer-le-fichier-a-partir-des-fichiers'>Fabriquer le fichier <code class='spip_code spip_code_inline' dir='ltr'>PDF</code> à partir des fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code><a class='sommaire-back sommaire-back-4' href='#s-Fabriquer-le-fichier-a-partir-des-fichiers' title='Back to the table of contents'></a></h2> <p>- Il faut disposer d'une installation LaTeX.</p> <ul class="spip" role="list"><li> Sous Windows : <a href="http://miktex.org/" class="spip_url spip_out auto" rel="nofollow external">http://miktex.org/</a></li><li> Sous Mac : <a href="https://www.tug.org/mactex/" class="spip_url spip_out auto" rel="nofollow external">https://www.tug.org/mactex/</a></li><li> Sous Linux : <a href="https://www.tug.org/texlive/" class="spip_url spip_out auto" rel="nofollow external">https://www.tug.org/texlive/</a></li></ul> <p>- En outre</p> <ul class="spip" role="list"><li> Si on utilise <code class='spip_code spip_code_inline' dir='ltr'>colorationcode</code> ou si on cite du code, il faut installer pygments : <a href="http://pygments.org/docs/installation/" class="spip_url spip_out auto" rel="nofollow external">http://pygments.org/docs/installation/</a>. Il faut du coup faire un peu de ligne de commande.</li><li> Si dans ce code coloré, il y a du code SPIP, il faut <a href='https://contrib.spip.net/Installer-la-coloration-syntaxique-pour-SPIP-dans' class="spip_in" hreflang="fr">installer la coloration syntaxique pour SPIP dans Pygments</a>.</li></ul> <p>La démarche varie selon que l'on utilise la coloration syntaxique ou non : <br />- Si on n'utilise pas la coloration syntaxique, on peut utiliser une interface graphique pour compiler. Il faut ouvrir le fichier <code class='spip_code spip_code_inline' dir='ltr'>documentation.tex</code> du dossier contenu dans le zip avec le logiciel TeXWorks. Dans le menu déroulant en haut de la fenêtre, choisir <code class='spip_code spip_code_inline' dir='ltr'>XeLaTeX</code> puis cliquer sur le bouton vert.</p> <div class='spip_document_10335 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p> Une première compilation (= transformation du <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> en <code class='spip_code spip_code_inline' dir='ltr'>.pdf</code> se lance. Une fois achevée, il faut cliquer une deuxième fois sur le bouton vert. Puis une troisième fois, pour s'assurer que le sommaire soit correcte. Une fois cela fait, on trouve le <code class='spip_code spip_code_inline' dir='ltr'>.pdf</code> à côté du fichier <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> <br />- Si on utilise la coloration syntaxique, on doit utiliser la ligne de commande. Il faut alors se rendre dans le dossier du zip décompressé. Puis il faut frapper <code class='spip_code spip_code_inline' dir='ltr'>latexmk</code>. Lorsque l'exécution est terminée (cela peut prendre plus ou moins de temps), on trouve le fichier <code class='spip_code spip_code_inline' dir='ltr'>.pdf</code> à côté du fichier <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>.</p> <h2 class="h2" id='Et-si-cela-ne-marche-pas'>Et si cela ne marche pas ?<a class='sommaire-back sommaire-back-4' href='#s-Et-si-cela-ne-marche-pas' title='Back to the table of contents'></a></h2> <p><br />- Vérifier que tout les raccourcis SPIP sont bien appareillés. <br />- M'écrire en me fournissant les fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>, pour que je puisse voir où est le problème (ou alors connaître LaTeX). C'est encore expérimental ! Me dire aussi le système sous lequel le fichier se fabrique.</p></div> </article> <article> <h1>Galleria (en)</h1> <p>emthanh — 2011-12-14T17:28:04Z</p> <div class='rss_chapo'><p>An image gallery that use the javascript library Galleria.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-6" id="nav6a60d1498ba210.98770880"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Description"></a><a href="#Description" class="spip_ancre">Description</a></li><li> <a id="s-Usage"></a><a href="#Usage" class="spip_ancre">Usage</a></li><li> <a id="s-Options"></a><a href="#Options" class="spip_ancre">Options</a></li><li> <a id="s-Known-Bug"></a><a href="#Known-Bug" class="spip_ancre">Known Bug</a></li><li> <a id="s-References"></a><a href="#References" class="spip_ancre">References</a></li><li> <a id="s-Screenshots"></a><a href="#Screenshots" class="spip_ancre">Screenshots</a></li></ul></div><h2 class="h2" id='Description'>Description<a class='sommaire-back sommaire-back-6' href='#s-Description' title='Back to the table of contents'></a></h2> <p>This plugin allow you to add an image gallery to your article. The gallery use the javascript library Galleria. The plugin implement a modèle <i><galleria></i>.</p> <h2 class="h2" id='Usage'>Usage<a class='sommaire-back sommaire-back-6' href='#s-Usage' title='Back to the table of contents'></a></h2> <p>To create a image gallery add a tag <code class='spip_code spip_code_inline' dir='ltr'><galleria##></code> in an article , <code class='spip_code spip_code_inline' dir='ltr'>##</code> is the ID of the article. The images of the gallery are those bounded to the article.</p> <h2 class="h2" id='Options'>Options<a class='sommaire-back sommaire-back-6' href='#s-Options' title='Back to the table of contents'></a></h2> <p>The commons options are : <br />- width <br />- height <br />- lightbox :<abbr title="false">true</abbr> <br />- transition :[fade|flash|pulse|slide|fadeslide|doorslide] <br />- theme : the name of the Galleria theme <br />- pagesize : the number of image per page</p> <p>Ex : <code class='spip_code spip_code_inline' dir='ltr'><galleria22></code> a gallery in the article 22 ; <code class='spip_code spip_code_inline' dir='ltr'><galleria22|lightbox=true></code> activate the lightbox effect</p> <p>For more options and customisations of your gallery refere directly to <a href="http://galleria.aino.se/" class="spip_out" rel="external">the Galleria website</a></p> <h2 class="h2" id='Known-Bug'>Known Bug<a class='sommaire-back sommaire-back-6' href='#s-Known-Bug' title='Back to the table of contents'></a></h2> <p>Then we add several gallery in a same article , the gallery doesn't work. (bug fixed with version 1.3.1)</p> <h2 class="h2" id='References'>References<a class='sommaire-back sommaire-back-6' href='#s-References' title='Back to the table of contents'></a></h2><table class="table spip"> <thead><tr class='row_first'><th id='id3232_c0'> version </th><th id='id3232_c1'> 1.3.2 </th><th id='id3232_c2'> </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='id3232_c0'>SPIP minimum</td> <td headers='id3232_c1'>1.9.2</td> <td headers='id3232_c2'>library JQuery</td></tr> <tr class='row_even even'> <td headers='id3232_c0'>Galleria version</td> <td headers='id3232_c1'>1.2.9</td> <td headers='id3232_c2'><a href="http://galleria.aino.se/" class="spip_out" rel="external">Galleria website</a></td></tr> <tr class='row_odd odd'> <td headers='id3232_c0'>development version</td> <td headers='id3232_c1'>2.1.11</td> <td headers='id3232_c2'></td></tr> <tr class='row_even even'> <td headers='id3232_c0'>svn</td> <td headers='id3232_c1'></td> <td headers='id3232_c2'><a href="svn://zone.spip.org/spip-zone/_plugins_/galleria" class="spip_url spip_out">svn://zone.spip.org/spip-zone/_plug...</a></td></tr> </tbody> </table><h2 class="h2" id='Screenshots'>Screenshots<a class='sommaire-back sommaire-back-6' href='#s-Screenshots' title='Back to the table of contents'></a></h2> <div class='spip_document_10090 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <div class='spip_document_10089 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="44" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10089 '><strong>ouverture avec lightbox/open with lightbox </strong></div> </figcaption></figure> </div></div> </article> <article> <h1>Tutoriel : produire sa propre structure de livre (nouvelle version)</h1> <p>Maïeul — 2012-04-02T07:56:33Z</p> <div class='rss_chapo'><p>La structure proposée ne vous convient pas ? Il est possible de produire les fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> correspondant à vos besoins.</p> <p>Pour ce faire, c'est entièrement des boucles SPIP, avec une API spéciale.</p> <p>Ceci est donc une documentation dévellopeur. Pour être comprise, elle nécessite des compétences : <br />- En SPIP <br />- En LaTeX</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-8" id="nav6a60d14990b458.81511972"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Les-different-elements-de-l-API"></a><a href="#Les-different-elements-de-l-API" class="spip_ancre">Les différent élèments de l'API</a></li><li> <a id="s-Exemple-de-la-structure-prise"></a><a href="#Exemple-de-la-structure-prise" class="spip_ancre">Exemple de la structure prise</a></li><li> <a id="s-Organisation-finale-de-notre-Zip"></a><a href="#Organisation-finale-de-notre-Zip" class="spip_ancre">Organisation finale de notre Zip</a></li><li> <a id="s-Etape-1-le-fichier-parent"></a><a href="#Etape-1-le-fichier-parent" class="spip_ancre">Étape 1 : le fichier parent</a></li><li> <a id="s-Etape-2-les-fichiers-fils"></a><a href="#Etape-2-les-fichiers-fils" class="spip_ancre">Étape 2, les fichiers fils</a></li><li> <a id="s-Etape-3-generer-automatiquement-les-fichiers-fils"></a><a href="#Etape-3-generer-automatiquement-les-fichiers-fils" class="spip_ancre">Étape 3 : générer automatiquement les fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> fils</a></li><li> <a id="s-Etape-4-Fabriquer-un-zip-contenant-tout-les-fichiers"></a><a href="#Etape-4-Fabriquer-un-zip-contenant-tout-les-fichiers" class="spip_ancre">Étape 4 Fabriquer un zip contenant tout les fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code></a></li><li> <a id="s-Conclusion"></a><a href="#Conclusion" class="spip_ancre">Conclusion</a></li></ul></div><h2 class="h2" id='Les-different-elements-de-l-API'>Les différent élèments de l'API<a class='sommaire-back sommaire-back-8' href='#s-Les-different-elements-de-l-API' title='Back to the table of contents'></a></h2> <p>- Le plugin latexwheel propose des règles de transformation des raccourcis SPIP en code LaTeX. <a href="http://zzz.rezo.net/Presentation-de-Textwheel.html" class="spip_out" rel="external">Il se base sur TextWheel</a>. <br />- Le plugin Zippeur et ses <a href='https://contrib.spip.net/Zipper-des-fichiers-produits-par-des-squelettes' class="spip_in" hreflang="fr">fonctionnalité de la version 2</a>.</p> <p>Cet article se veut un tutoriel visant à montrer comment se servir de ces deux plugins pour créer sa propre structure de liste avec SPIP.</p> <p>Deux articles plus détaillés donnent les détails de l'API.</p> <h2 class="h2" id='Exemple-de-la-structure-prise'>Exemple de la structure prise<a class='sommaire-back sommaire-back-8' href='#s-Exemple-de-la-structure-prise' title='Back to the table of contents'></a></h2> <p>La structure sera simple : il s'agira dans un livre de regrouper <strong>tout</strong> les articles d'une rubrique. Par exemple, la rubrique <i>éditoriale</i>, en les classant par ordre chronologique, en mettant à chaque fois le titre, suivi de la date, du chapo, du corps du texte, puis de la signature des auteurs.</p> <h2 class="h2" id='Organisation-finale-de-notre-Zip'>Organisation finale de notre Zip<a class='sommaire-back sommaire-back-8' href='#s-Organisation-finale-de-notre-Zip' title='Back to the table of contents'></a></h2> <p>Il est possible en LaTeX de diviser un projet en plusieurs fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>, un peu comme on ferait en SPIP <a href="http://programmer.spip.org/Inclure-des-squelettes" class="spip_out" rel="external">avec des squelettes inclus</a>, via <code class='spip_code spip_code_inline' dir='ltr'><INCLURE></code> ou <code class='spip_code spip_code_inline' dir='ltr'>#INCLURE</code>.</p> <p>Dans cette logique, le but est que SPIP produise un fichier <code class='spip_code spip_code_inline' dir='ltr'>livre.tex</code>, qui appelle lui-même des des fichiers <code class='spip_code spip_code_inline' dir='ltr'>inclure/articlexxx.html</code> correspondant à chaque article. L'ensemble de ces fichiers étant regroupés dans un fichier <code class='spip_code spip_code_inline' dir='ltr'>.zip</code>.</p> <p>Pour les besoins de l'exercice, nous nous servirons de la base de donnée sqlite jointe<span class="spip_note_ref"> [<a href="#nb16-1" class="spip_note" rel="appendix" title="Le niveau intellectuel qui est y présent n'engage pas son auteur, qui avait (…)" id="nh16-1">1</a>]</span>. L'identifiant pour se connecter est <code class='spip_code spip_code_inline' dir='ltr'>auteur</code> et le mot de passe est <code class='spip_code spip_code_inline' dir='ltr'>demodemo</code>.</p> <div class='spip_document_10349 spip_document spip_documents spip_document_file spip_documents_right spip_document_right spip_document_avec_legende' data-legende-len="24" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/zip/mu_livredem96a2.sqlite.zip' class=" spip_doc_lien" title='Zip - 81 KiB' type="application/zip"></a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10349 '><strong>Base de donnée exemple </strong></div> </figcaption></figure> </div> <p>Nous supposerons qu'il n'y a ni images dans nos articles, ni code informatique, ni liens. L'article détaillé sur l'API fournit les outils pour les intégrer le cas échéant.</p> <p>Pour éviter tout ennui de cache, désactivez le en mettant la ligne suivante dans le fichier <code class='spip_code spip_code_inline' dir='ltr'>mes_options.php</code> :</p> <div class="precode"><pre class='php spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>define('_NO_CACHE',-1);</code></pre></div><h2 class="h2" id='Etape-1-le-fichier-parent'>Étape 1 : le fichier parent<a class='sommaire-back sommaire-back-8' href='#s-Etape-1-le-fichier-parent' title='Back to the table of contents'></a></h2> <p>Créons un squelette <code class='spip_code spip_code_inline' dir='ltr'>livre.tex.html</code>, en y mettant le contenu suivant :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>#HTTP_HEADER{content-type:application/x-latex} \documentclass[a4paper,12pt]{book} \begin{document} <BOUCLE_articles(ARTICLES){id_rubrique}{!par date}> \input{inclus/article#ID_ARTICLE} </BOUCLE_articles> \end{document}</code></pre></div> <p>Analysons le code :</p> <ul class="spip" role="list"><li> ligne 1, la <a href="http://www.spip.net/fr_article4631.html" class="spip_out" rel="external">balise #HTTP_HEADER</a> permet, dans notre cas, deux choses : <ol class="spip" role="list"><li> de dire au navigateur qu'on produit du latex et pas du html.</li><li> d'empêcher SPIP d'insérer les boutons d'administrations.</li></ol></li><li> ligne 2, nous déclarons la classe de notre fichier <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>. Pour rappel, un <a href="https://fr.wikibooks.org/wiki/LaTeX/Les_classes" class="spip_out" rel="external">fichier latex doit toujours commencer par une déclaration de classe</a>. Ici nous disons que nous produisons un livre, sur du papier A4, avec une police de base de 12 pt.</li><li> ligne 3, nous commençons le corps du document.</li><li> ligne 4, une Boucle classique de SPIP : on demande les articles de la rubrique passée en argument lors de l'appel au squelette, classés par ordre antéchronologique.</li><li> ligne 5, pour chaque article, nous insérons le code <code class='spip_code spip_code_inline' dir='ltr'>\input{inclus/articlexxx}</code> qui permettra à LaTeX d'appeler le fichier <code class='spip_code spip_code_inline' dir='ltr'>inclus/articlexxx.tex</code>.</li><li> ligne 6, fin de la boucle.</li><li> ligne 7, fin du corps du document LaTeX.</li><li> Maintenant, rendons-nous sur <code class='spip_code spip_code_inline' dir='ltr'>http://votresite.dev/?page=livre.tex&id_rubrique=1</code>. Notre navigateur va nous télécharger un fichier contenant les lignes suivantes :</li></ul><div class="precode"><pre data-language="latex" class='spip_code spip_code_block language-latex' dir='ltr' style='text-align:left;'><code>\documentclass[a4paper,12pt]{book} \begin{document} \input{inclus/article1} \input{inclus/article2} \end{document}</code></pre></div> <p>C'est bien, mais il serait bon d'avoir un préambule appelant les packages nécéssaires. Ces packages peuvent varier en fonction du contenu des articles, si par exemple on a des images, du code, des tableaux. Mais tout cela <s>est</s> sera détaillé dans l'article sur l'API LaTeXWheels.</p> <p>Pour le moment, contentons nous des packages minimums.</p> <p>Il nous faut : <br />- <code class='spip_code spip_code_inline' dir='ltr'>fontspec</code> et <code class='spip_code spip_code_inline' dir='ltr'>xunicode</code> pour gérer correctement l'UTF-8. <br />- <code class='spip_code spip_code_inline' dir='ltr'>polyglossia</code>, pour gérer les langues.</p> <p>Insérons donc entre le <code class='spip_code spip_code_inline' dir='ltr'>\documentclass[a4paper,12pt]{book}</code> et le <code class='spip_code spip_code_inline' dir='ltr'>\begin{document}</code> l'appel à ces packages :</p> <div class="precode"><pre class='latex spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>\usepackage{fontspec} \usepackage{xunicode} \usepackage{polyglossia}</code></pre></div> <p>Et puis, précisons quand même la langue, avec le code suivant :</p> <p><code class='spip spip_code spip_code_inline' dir='ltr'>\setmainlanguage{[(#LANG|lang_polyglossia)]}</code></p> <p>Alors là, on a un mélange de LaTeX, la commande <code class='spip_code spip_code_inline' dir='ltr'>\setmainlanguage</code> qui permet de dire à <code class='spip_code spip_code_inline' dir='ltr'>polyglossia</code> qu'elle est la langue principale, et donc de gérer correctement les césures et la ponctuation, et le code <code class='spip_code spip_code_inline' dir='ltr'>[(#LANG|lang_polyglossia)]</code>, qui prend le code de la langue courante, en l'occurence <code class='spip_code spip_code_inline' dir='ltr'>fr</code> et le transforme en code compréhensible par <code class='spip_code spip_code_inline' dir='ltr'>polyglossia</code>, à savoir <code class='spip_code spip_code_inline' dir='ltr'>french</code>, par le biais du filtre <code class='spip_code spip_code_inline' dir='ltr'>|lang_polyglossia</code>.</p> <p>Tout ceci donne donc :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#HTTP_HEADER{content-type:application/x-latex} \documentclass[a4paper,12pt]{book} \usepackage{fontspec} \usepackage{xunicode} \usepackage{polyglossia} \setmainlanguage{[(#LANG|lang_polyglossia)]} \begin{document} <BOUCLE_articles(ARTICLES){id_rubrique}{!par date}> \input{inclus/article#ID_ARTICLE} </BOUCLE_articles> \end{document}</code></pre></div> <p>Ce qui une fois interprété par SPIP, produit :</p> <div class="precode"><pre class='latex spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>\documentclass[a4paper,12pt]{book} \usepackage{fontspec} \usepackage{xunicode} \usepackage{polyglossia} \setmainlanguage{french} \begin{document} \input{inclus/article2} \input{inclus/article1} \end{document}</code></pre></div> <p>Et puis soyions fous, ajoutons une table des matières, à la fin, avec la commande <code class='spip_code spip_code_inline' dir='ltr'>\tableofcontents</code> :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#HTTP_HEADER{content-type:application/x-latex} \documentclass[a4paper,12pt]{book} \usepackage{fontspec} \usepackage{xunicode} \usepackage{polyglossia} \setmainlanguage{[(#LANG|lang_polyglossia)]} \begin{document} <BOUCLE_articles(ARTICLES){id_rubrique}{!par date}> \input{inclus/article#ID_ARTICLE} </BOUCLE_articles> \tableofcontents \end{document}</code></pre></div><h2 class="h2" id='Etape-2-les-fichiers-fils'>Étape 2, les fichiers fils<a class='sommaire-back sommaire-back-8' href='#s-Etape-2-les-fichiers-fils' title='Back to the table of contents'></a></h2> <p>Préparons le squelette qui va engendrer les fichiers <code class='spip_code spip_code_inline' dir='ltr'>inclus/articlexxx.tex</code>. Appelons ce squelette <code class='spip_code spip_code_inline' dir='ltr'>article.tex</code>.</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#HTTP_HEADER{content-type:application/x-latex} <BOUCLE_article(ARTICLES){id_article}> \chapter{[(#TITRE*|propre_latex)]} [(#DATE|affdate|propre_latex)] [(#CHAPO*|propre_latex)] [(#TEXTE*|propre_latex)] <B_auteurs><BOUCLE_auteurs(AUTEURS){id_article}{","}>[(#NOM*|propre_latex)</BOUCLE_auteurs></B_auteurs> </BOUCLE_article></code></pre></div> <p>Analysons :</p> <ul class="spip" role="list"><li> Ligne 1, le même <code class='spip_code spip_code_inline' dir='ltr'>#HTTP_HEADER</code> que précédemment, vu que je veux à nouveau produire un fichier <code class='spip_code spip_code_inline' dir='ltr'>.tex</code></li><li> Ligne 2 et 12, boucle ARTICLES classique.</li><li> Ligne 3, mettre le titre dans la commande LaTeX <code class='spip_code spip_code_inline' dir='ltr'>\chapter{}</code>.</li><li> Ligne 5, mettre la date.</li><li> Ligne 7, mettre le chapeau.</li><li> Ligne 9, mettre le texte.</li><li> Ligne 11, mettre les auteurs.</li></ul> <p>On remarque les lignes vides : rappelons qu'en LaTeX, les lignes vides produisent des changements de paragraphes.</p> <p>Toutes les balises SPIP qui retournent du texte sont présentés de la manière suivante :<br class='autobr' /> <code class='spip spip_code spip_code_inline' dir='ltr'>[(#BALISE*|propre_latex)]</code></p> <p>Rappelons une règle de fonctionnement de SPIP : le contenu de chaque champ de type texte est filtré automatiquement par le filtre <code class='spip_code spip_code_inline' dir='ltr'>|propre</code>, qui transforme les raccourcis SPIP en code HTML.</p> <p>En revanche, si on écrit <code class='spip_code spip_code_inline' dir='ltr'>#BALISE*</code>, <code class='spip_code spip_code_inline' dir='ltr'>|propre</code> n'est pas appelé : on obtient alors le contenu du champ, de manière brute<span class="spip_note_ref"> [<a href="#nb16-2" class="spip_note" rel="appendix" title="À l'exception des sécurités vis-à-vis des codes javascripts et PHP." id="nh16-2">2</a>]</span>.</p> <p>C'est ce contenu brut qui est passé dans le filtre <code class='spip_code spip_code_inline' dir='ltr'>|propre_latex</code> du plugin <code class='spip_code spip_code_inline' dir='ltr'>latexwheel</code>. Ce filtre transforme les raccourcis SPIP en code LaTeX.</p> <p>Au final, si je me rend sur la page <code class='spip_code spip_code_inline' dir='ltr'>http://site/?page=article.tex&id_article=1</code>, j'obtiens :</p> <div class="precode"><pre class='latex spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>\chapter{De l'influence de LaTeX sur la sexualité humaine} 28 décembre 2011 Si selon le mot, peut-être apocryphe, de Freud, « tout est sexe », alors LaTeX a une influence sur la sexualité humaine. Qu'en est-il ? On pourrait montrer trois influences de LaTeX en matière de sexualité humaine : \begin{enumerate} \item En tant que le LaTeX est généralement le principal composant des préservatifs. \item Dans certaines pratiques sexuelles avec certains vêtements. \item Dans la constitution de groupes d'utilisateurs de LaTeX, pouvant constituer des lieux de rencontres. \end{enumerate} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. auteur</code></pre></div><h2 class="h2" id='Etape-3-generer-automatiquement-les-fichiers-fils'>Étape 3 : générer automatiquement les fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> fils<a class='sommaire-back sommaire-back-8' href='#s-Etape-3-generer-automatiquement-les-fichiers-fils' title='Back to the table of contents'></a></h2> <p>L'étape suivante consiste à dire au squelette <code class='spip_code spip_code_inline' dir='ltr'>livre.tex.html</code> de générer automatiquement, lorsqu'il est appelé, les fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> fils, comme <code class='spip_code spip_code_inline' dir='ltr'>article1.tex</code> et <code class='spip_code spip_code_inline' dir='ltr'>article2.tex</code>.</p> <p>Pour ce faire, on utilise le filtre <code class='spip_code spip_code_inline' dir='ltr'>|zippeur_creer_fichier</code> du <a href='https://contrib.spip.net/Zipper-des-fichiers-produits-par-des-squelettes' class="spip_in" hreflang="fr">plugin <code class='spip_code spip_code_inline' dir='ltr'>zippeur</code></a>.</p> <p>Ce filtre s'applique sur le nom du squelette à interpréter, sans le <code class='spip_code spip_code_inline' dir='ltr'>.html</code> final. Il reçoit comme premier argument le chemin du fichier à produire, à l'intérieur du dossier <code class='spip_code spip_code_inline' dir='ltr'>local</code>, et comme second argument un tableau d'arguments à passer lors de l'appel au squelette.</p> <p>Dans notre cas, nous souhaitons interpréter le squelette <code class='spip_code spip_code_inline' dir='ltr'>article.tex.html</code>, pour produire un fichier <code class='spip_code spip_code_inline' dir='ltr'>inclus/articlexxx.tex</code>, en passant à chaque fois au squelette l'<code class='spip_code spip_code_inline' dir='ltr'>id_article</code> nous intéressant.</p> <p>Nous allons donc insérer dans le fichier <code class='spip_code spip_code_inline' dir='ltr'>livre.tex.html</code>, après <code class='spip_code spip_code_inline' dir='ltr'>\input{inclus/article#ID_ARTICLE}</code> la ligne suivante :</p> <div class="precode"><pre class='latex spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#VAL{article.tex}|zippeur_creer_fichier{ziptex/inclus/article#ID_ARTICLE.tex,#ARRAY{id_article,#ID_ARTICLE}})]</code></pre></div> <p>Au final, :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#HTTP_HEADER{content-type:application/x-latex} \documentclass[a4paper,12pt]{book} \usepackage{fontspec} \usepackage{xunicode} \usepackage{polyglossia} \setmainlanguage{[(#LANG|lang_polyglossia)]} \begin{document} <BOUCLE_articles(ARTICLES){id_rubrique}{!par date}> \input{inclus/article#ID_ARTICLE} [(#VAL{article.tex}|zippeur_creer_fichier{ziptex/inclus/article#ID_ARTICLE.tex,#ARRAY{id_article,#ID_ARTICLE}})] </BOUCLE_articles> \tableofcontents \end{document}</code></pre></div> <p>Désormais, en allant sur <code class='spip_code spip_code_inline' dir='ltr'>http://site.com/?page=livre&id_rubrique=1</code>, non seulement SPIP nous retourne un fichier LaTeX, mais en plus il produit les fichiers <code class='spip_code spip_code_inline' dir='ltr'>inclus/article1.tex</code> et <code class='spip_code spip_code_inline' dir='ltr'>inclus/article2.tex</code> dans le dossier local/ziptex</code>.</p> <h2 class="h2" id='Etape-4-Fabriquer-un-zip-contenant-tout-les-fichiers'>Étape 4 Fabriquer un zip contenant tout les fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code><a class='sommaire-back sommaire-back-8' href='#s-Etape-4-Fabriquer-un-zip-contenant-tout-les-fichiers' title='Back to the table of contents'></a></h2> <p>Il va maintenant falloir produire un zip contenant tout les <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> nécéssaires à la production du livre.</p> <p>Pour ce faire, nous allons créer un squelette <code class='spip_code spip_code_inline' dir='ltr'>livre.html</code>, qui nous retournera l'adresse du Zip.</p> <p>Pour que ce zip soit généré, on va appeler le filtre <code class='spip_code spip_code_inline' dir='ltr'>zippeur_dynamique</code>.</p> <p>Ce filtre zippe s'applique sur le nom du zip à produire, sans l'extension .zip.</p> <p>Il reçoit comme premier argument une date, qui est utilisée pour éviter de calculer plusieurs fois un zip (<i>cf</i>. la <a href='https://contrib.spip.net/Zippeur#date' class="spip_in" hreflang="fr">documentation de base de Zippeur</a>.). Si cet argument est vide, comme ici, la date de calcul du squelette est utilisée.</p> <p>Le second argument correspond à <a href='https://contrib.spip.net/Zippeur#methode' class="spip_in" hreflang="fr">la méthode de zippage</a>. S'il est vide, la méthode définie par la configuration du plugin est utilisée.</p> <p>Le troisième argument est un tableau contenant la liste des squelettes à interpréter, ici nous n'en avons qu'un seul. Chaque squelette est défini par un tableau à trois entrées :</p> <ul class="spip" role="list"><li> <a href="http://programmer.spip.org/La-notion-de-chemin" class="spip_out" rel="external">chemin du squelette au sens SPIP</a>, sans l'extension <code class='spip_code spip_code_inline' dir='ltr'>html</code>. Ici <code class='spip_code spip_code_inline' dir='ltr'>squelette</code></li><li> chemin du fichier calculé, à l'intérieur du Zip, avec l'extension. Ici <code class='spip_code spip_code_inline' dir='ltr'>squelette1</code>.</li><li> paramètres d'environnement passés au squelette, sous forme de tableau. Ici un seul paramètre : <code class='spip_code spip_code_inline' dir='ltr'>id_article</code>, égale à <code class='spip_code spip_code_inline' dir='ltr'>1</code>.</li></ul> <p>Dans notre cas, ce troisième argument contiendra un tableau à une entrée, correspondant à la transformation du squelette <code class='spip_code spip_code_inline' dir='ltr'>livre.tex.html</code> en fichier <code class='spip_code spip_code_inline' dir='ltr'>livre.tex</code>. On passera la rubrique courante comme argument.</p> <p>On pourrait avoir un quatrième argument, pour d'éventuelle fichiers à inclure sans les calculer à partir d'un squelette. Ce n'est pas le cas ici.</p> <p>Au final, on obtient on obtient dans <code class='spip_code spip_code_inline' dir='ltr'>livre.html</code> :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code><a href="[(#VAL{ziptex}|zippeur_dynamique{'','',#ARRAY{0,#ARRAY{0,livre.tex,1,livre.tex,2,#ARRAY{id_rubrique,#ID_RUBRIQUE}}}})]">Le zip</a></code></pre></div> <p>Si je me rend sur <code class='spip_code spip_code_inline' dir='ltr'>http://site.com/?page=livre&id_rubrique=1</code>, j'obtiens un liens vers le zip contenant les fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code>.</p> <p>Si on compile deux fois ce fichier, avec XeLaTeX, on obtient alors le PDF joint.</p> <div class='spip_document_10374 spip_document spip_documents spip_document_file spip_document_avec_legende' data-legende-len="28" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/zip/ziptex-2.zip' class=" spip_doc_lien" title='Zip - 2.7 KiB' type="application/zip"></a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10374 '><strong>Ensemble des fichiers <code class='spip_code spip_code_inline' dir='ltr'>.tex</code> </strong></div> </figcaption></figure> </div> <div class='spip_document_10375 spip_document spip_documents spip_document_file spip_document_avec_legende' data-legende-len="19" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/pdf/livre.pdf' class=" spip_doc_lien" title='PDF - 23.2 KiB' type="application/pdf"></a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10375 '><strong>Fichier PDF final </strong></div> </figcaption></figure> </div><h2 class="h2" id='Conclusion'>Conclusion<a class='sommaire-back sommaire-back-8' href='#s-Conclusion' title='Back to the table of contents'></a></h2><div class='spip_document_10541 spip_document spip_documents spip_document_file spip_documents_left spip_document_left spip_document_avec_legende' data-legende-len="19" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href="https://files.spip.net/contribs/tutolivre_v2.zip" class=" spip_doc_lien" title='Zip - 1.5 KiB' type="application/zip"></a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10541 '><strong>Squelette complet </strong></div> </figcaption></figure> </div> <p>Cet article vous présente les base pour transformer du SPIP en LaTeX. Vous pouvez trouver ci joint le squelette complet de ce tutoriel.</p> <p> Il faut ensuite évidemment connaître LaTeX pour gérer la présentation. En outre, si nos textes sont plus complexes (liens, code, etc.) il faut appeler d'autres packages, ajouter des codes.</p> <p>On se reportera aux deux articles de références :</p> <ul class="spip" role="list"><li> <a href='https://contrib.spip.net/Reference-de-LaTeXWheel' class="spip_in" hreflang="fr">Référence de LaTeXWheel</a></li><li> <a href='https://contrib.spip.net/Zipper-des-fichiers-produits-par-des-squelettes' class="spip_in" hreflang="fr">Zipper des fichiers produits par des squelettes</a></li></ul></div> <hr /> <div class='rss_notes'><div id="nb16-1"> <p><span class="spip_note_ref">[<a href="#nh16-1" class="spip_note" title="Footnotes 16-1" rev="appendix">1</a>] </span>Le niveau intellectuel qui est y présent n'engage pas son auteur, qui avait besoin de textes mais n'avait pas envie de se creuser la tête …</p> </div><div id="nb16-2"> <p><span class="spip_note_ref">[<a href="#nh16-2" class="spip_note" title="Footnotes 16-2" rev="appendix">2</a>] </span>À l'exception des sécurités vis-à-vis des codes javascripts et PHP.</p> </div></div> </article> <article> <h1>Plugin Coordonnées</h1> <p>Cyril Marion, Matthieu Marcillaud — 2010-08-19T09:11:35Z</p> <div class='rss_chapo'><p>Le plugin «Coordonnées» fournit la possibilité d'attribuer aux objets de SPIP des indications de coordonnées multiples tel que plusieurs adresses postales, emails, numéros de téléphone ou réseaux sociaux.</p> <p>Ce plugin fonctionne de manière autonome ou peut être couplé au plugin «<a href='https://contrib.spip.net/Plugin-Contacts-Organisations' class="spip_in" hreflang="fr">Contacts et Organisations</a>».</p> <p>Vous pouvez accéder directement aux <a href="#news" class="spip_ancre">nouveautés</a> concernant ce plugin.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-7" id="nav6a60d14996e594.36918033"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Objectif"></a><a href="#Objectif" class="spip_ancre">Objectif</a></li><li> <a id="s-Origine"></a><a href="#Origine" class="spip_ancre">Origine</a></li><li> <a id="s-Fonctionnement"></a><a href="#Fonctionnement" class="spip_ancre">Fonctionnement</a></li><li> <a id="s-Champs"></a><a href="#Champs" class="spip_ancre">Champs</a></li><li> <a id="s-Dependances"></a><a href="#Dependances" class="spip_ancre">Dépendances</a></li><li> <a id="s-Nouveautes"></a><a href="#Nouveautes" class="spip_ancre">Nouveautés !</a></li><li> <a id="s-Experimentation-de-la-version-2-3-5"></a><a href="#Experimentation-de-la-version-2-3-5" class="spip_ancre">Expérimentation de la version 2.3.5</a></li></ul></div><h2 class="h2" id='Objectif'>Objectif<a class='sommaire-back sommaire-back-7' href='#s-Objectif' title='Back to the table of contents'></a></h2> <p>Ce plugin a pour objet de compléter les informations relatives aux auteurs par des éléments de contact, tel que des adresses postales, emails ou téléphoniques.</p> <h2 class="h2" id='Origine'>Origine<a class='sommaire-back sommaire-back-7' href='#s-Origine' title='Back to the table of contents'></a></h2> <p>Ce plugin est né du projet «<a href='https://contrib.spip.net/Plugin-Contacts-Organisations' class="spip_in" hreflang="fr">Contacts & Organisations</a>» (avec la même finalité) dont il est une sous-partie fonctionnant de manière autonome.</p> <p>Ce qui le différencie de plugins existants actuellement pour étendre les auteurs (Inscription2 par exemple) est le fait que l'on peut attribuer, pour un auteur donné, <strong>autant d'adresses que souhaité</strong>, ce qui était, pour certains, une limitation.</p> <h2 class="h2" id='Fonctionnement'>Fonctionnement<a class='sommaire-back sommaire-back-7' href='#s-Fonctionnement' title='Back to the table of contents'></a></h2> <p>«Coordonnées» utilise 3 tables liées aux auteurs : une table <code class='spip_code spip_code_inline' dir='ltr'>adresses</code>, une table <code class='spip_code spip_code_inline' dir='ltr'>emails</code> et une table <code class='spip_code spip_code_inline' dir='ltr'>numeros</code> sur lesquelles il est possible de faire des boucles :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code><BOUCLE_auteur(AUTEURS){id_auteur}> <h2>#NOM :</h2> <BOUCLE_adresses_auteur(ADRESSES){id_auteur}> #NUMERO #VOIE<br /> #COMPLEMENT<br /> #CODE_POSTAL #VILLE </BOUCLE_adresses_auteur> </BOUCLE_auteur></code></pre></div> <p>Dans l'espace privé, la vue des auteurs permet d'attribuer des adresses :</p> <div class='spip_document_8564 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Le formulaire est ajouté simplement en dessous. Les champs par défaut peuvent être complétés avec le plugin Champs Extras 2, comme ici le champ «région» :</p> <div class='spip_document_8565 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Une fois l'adresse complétée, elle s'affiche sur la vue de l'auteur :</p> <div class='spip_document_8563 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Champs'> Champs <a class='sommaire-back sommaire-back-7' href='#s-Champs' title='Back to the table of contents'></a></h2> <p>Les 3 types de coordonnées fournissent les champs suivants (extensibles avec le plugin Champs Extras 2) :</p> <ul class="spip" role="list"><li> <strong> Boucles ADRESSES</strong> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>#ADRESSE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#VOIE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#COMPLEMENT</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#BOITE_POSTALE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#CODE_POSTAL</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#VILLE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#REGION</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#PAYS</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#TITRE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#TYPE</code> lorsqu'on fait un lien avec un objet SPIP</li></ul></li><li> <strong>Boucles EMAILS </strong> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>#EMAIL</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#TITRE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#TYPE</code> lorsqu'on fait un lien avec un objet SPIP</li></ul></li><li> <strong>Boucles NUMEROS</strong> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>#NUMERO</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#TITRE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#TYPE</code> lorsqu'on fait un lien avec un objet SPIP</li></ul></li></ul> <p>Il est possible d'utiliser des réseaux sociaux via le plugin <a href="http://zone.spip.org/trac/spip-zone/browser/_plugins_/rezosocios/trunk" class="spip_url spip_out auto" rel="nofollow external">http://zone.spip.org/trac/spip-zone/browser/_plugins_/rezosocios/trunk</a></p> <h2 class="h2" id='Dependances'> Dépendances <a class='sommaire-back sommaire-back-7' href='#s-Dependances' title='Back to the table of contents'></a></h2> <p>La version 1.1 du plugin nécessite SPIP 2.1 ainsi que : <br />- <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">Saisies</a> <br />- le plugin «<a href='https://contrib.spip.net/Liste-des-pays-Iso-3166-1' class="spip_in" hreflang="fr">Pays</a>» ou le plugin «Géographie»</p> <h2 class="h2" id='Nouveautes'><a id="news"></a>Nouveautés !<a class='sommaire-back sommaire-back-7' href='#s-Nouveautes' title='Back to the table of contents'></a></h2> <p>Depuis la version 1.4.5 le plugin Coordonnées permet d'attribuer de adresses, numéros de téléphone et adresses mail <strong>à d'autres objets que des auteurs</strong>. Pour ce faire, il suffit d'aller directement sur la page “?exec=configurer_coordonnees” (ou en passant par le bouton configuration > Gestion des plugins > Coordonnées, puis cliquer sur le petit bouton “configurer” :</p> <div class='spip_document_9999 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>On peut alors choisir les objets “coordonnables”...</p> <h2 class="h2" id='Experimentation-de-la-version-2-3-5'>Expérimentation de la version 2.3.5<a class='sommaire-back sommaire-back-7' href='#s-Experimentation-de-la-version-2-3-5' title='Back to the table of contents'></a></h2> <p>Cette version a essayé l'intégration des réseaux sociaux au même titre que les autres type de coordonnées. <br class='autobr' /> Aprés discussion sur la liste de developpement, il a été constaté qu'il était plus pertinent de s'appuyer sur le plugin <a href="http://zone.spip.org/trac/spip-zone/browser/_plugins_/rezosocios/trunk" class="spip_out" rel="external">rezosociaux</a></p></div> </article> <article> <h1>Plugin Contacts & Organisations</h1> <p>Cyril Marion, Matthieu Marcillaud, RastaPopoulos — 2010-01-04T10:48:16Z</p> <div class='rss_chapo'><p>Ce plugin ajoute à SPIP des fonctionnalités de gestionnaire de contacts. Distingue les personnes morales (organisations) des personnes physiques (contacts) en conservant tous les attributs des auteurs SPIP.</p> <p>En conjonction avec le plugin <a href='https://contrib.spip.net/Plugin-Coordonnees' class="spip_in" hreflang="fr">Coordonnées</a>, il permet d'étendre à la fois les champs unitaires (prénom, date de naissance…) et les champs multiples (numéros de téléphone, adresses mail…).</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-10" id="nav6a60d1499c8c73.74546976"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Principe"></a><a href="#Principe" class="spip_ancre">Principe</a></li><li> <a id="s-Objectif"></a><a href="#Objectif" class="spip_ancre">Objectif</a></li><li> <a id="s-Fonctionnement"></a><a href="#Fonctionnement" class="spip_ancre">Fonctionnement</a></li><li> <a id="s-Exemple-1-ajouter-un-contact"></a><a href="#Exemple-1-ajouter-un-contact" class="spip_ancre">Exemple 1 : ajouter un contact</a></li><li> <a id="s-Exemple-2-ajouter-une-organisation"></a><a href="#Exemple-2-ajouter-une-organisation" class="spip_ancre">Exemple 2 : ajouter une organisation</a></li><li> <a id="s-Exemple-3-lier-un-contact-a-une-organisation"></a><a href="#Exemple-3-lier-un-contact-a-une-organisation" class="spip_ancre">Exemple 3 : lier un contact à une organisation</a></li><li> <a id="s-Dependances"></a><a href="#Dependances" class="spip_ancre">Dépendances</a></li><li> <a id="s-Nouvelles-tables-nouveaux-champs"></a><a href="#Nouvelles-tables-nouveaux-champs" class="spip_ancre">Nouvelles tables / nouveaux champs</a></li><li> <a id="s-Annuaires"></a><a href="#Annuaires" class="spip_ancre">Annuaires</a></li><li> <a id="s-Partie-experimentale"></a><a href="#Partie-experimentale" class="spip_ancre">Partie expérimentale</a></li></ul></div><h2 class="h2" id='Principe'>Principe<a class='sommaire-back sommaire-back-10' href='#s-Principe' title='Back to the table of contents'></a></h2> <p>Comme un certain nombre d'autres plugins jusque là, “Contacts & Organisations” ajoute des champs indispensables à la table spip_auteurs, dès lors qu'il s'agit de gérer des personnes d'une manière un peu poussée. La table spip_auteurs est par nature, et historiquement sans doute, limitée aux champs nécessaires pour la rédaction d'articles. Dès que cette table doit être utilisée pour d'autres fonctions (inscription, transaction, etc.) certaines caractéristiques lui font défaut, et parmi elles :</p> <p>- prénom, date de naissance, autres informations personnelles <br />- notion de “groupes d'auteurs” <br />- plus de une adresse mail, plusieurs numéros de téléphone ou ID communautaires (ICQ, MSN) <br />- autres informations spécifiques à l'utilisation</p> <h2 class="h2" id='Objectif'>Objectif<a class='sommaire-back sommaire-back-10' href='#s-Objectif' title='Back to the table of contents'></a></h2> <p>Lors du développement du plugin nous avons veillé à ce que la notion d'auteur SPIP soit conservée. Nous avons par exemple choisi de ne pas modifier l'intégrité de la table spip_auteurs, ce qui permet de conserver possibilités de gestion déjà développées, telles que celles fournies par les plugins acces_restreint ou spip_liste. Ainsi, nous avons seulement ajouté les tables nécessaires à l'ajout de propriétés aux auteurs et les avons liées à la table spip_auteurs.</p> <p>Ce plugin est déjà utilisé par le plugin <a href="https://contrib.spip.net/Catalogue">Catalogue</a>, et le plugin <a href="https://contrib.spip.net/Spipmine">SPIPMine</a>.</p> <h2 class="h2" id='Fonctionnement'>Fonctionnement<a class='sommaire-back sommaire-back-10' href='#s-Fonctionnement' title='Back to the table of contents'></a></h2> <p>Une fois le plugin installé, une nouvelle boîte de dialogue apparait dans l'interface privée sur la page d'un auteur :</p> <div class='spip_document_8603 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p><strong>Tous les auteurs SPIP du site peuvent désormais acquérir un statut de “contact” ou d'“organisation”. </strong></p> <h2 class="h2" id='Exemple-1-ajouter-un-contact'>Exemple 1 : ajouter un contact<a class='sommaire-back sommaire-back-10' href='#s-Exemple-1-ajouter-un-contact' title='Back to the table of contents'></a></h2> <p>Prenons l'exemple d'un auteur SPIP dont on veuille gérer distinctement le nom, le prénom et l'activité (fonction). Si on attribue à cet auteur le statut de contact, les champs nom, prénom, et activité seront disponibles dans les boucles <code class='spip_code spip_code_inline' dir='ltr'>#AUTEUR</code>. Pour conférer le statut de “contact” à un auteur SPIP, dépliez la boîte et cliquez sur “devenir contact” :</p> <div class='spip_document_8604 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Dès lors, les champs supplémentaires de la fiche contact sont disponibles sur la fiche auteur sur la page d'édition d'un auteur. Pour ajouter les informations correspondant à ces champs, cliquez sur “modifier cet auteur”, puis descendez jusqu'à “détails du contact” :</p> <div class='spip_document_8605 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Si le plugin coordonnées est aussi installé, il est possible d'ajouter des numéros de téléphone, adresses mail ou adresses postales à ce contact :</p> <div class='spip_document_8606 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Exemple-2-ajouter-une-organisation'>Exemple 2 : ajouter une organisation<a class='sommaire-back sommaire-back-10' href='#s-Exemple-2-ajouter-une-organisation' title='Back to the table of contents'></a></h2> <p>De la même manière, on peut attribuer à un auteur SPIP le statut “organisation” (une société, une association...) afin de gérer par exemple une liste de fournisseurs ou de clients.</p> <p>Choisissez l'auteur SPIP à qui attribuer le statut d'organisation, puis dépliez la boite de dialogue “Contacts & Organisations” et cliquez sur “Devenir une organisation”. Modifiez l'auteur (maintenant devenu une organisation) et ajoutez lui les informations nécessaires. Ce qui donnera, par exemple :</p> <div class='spip_document_8608 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Exemple-3-lier-un-contact-a-une-organisation'>Exemple 3 : lier un contact à une organisation<a class='sommaire-back sommaire-back-10' href='#s-Exemple-3-lier-un-contact-a-une-organisation' title='Back to the table of contents'></a></h2> <p>Le plugin permet de lier un ou plusieurs contacts, à une ou plusieurs organisations. Cette fonctionnalité (en cours de test) est inspirée des logiciels CRM de gestion de contacts.</p> <p>On peut lier un contact avec une organisation, soit depuis une fiche contact, soit depuis une fiche organisation. Voici un exemple de liaison d'un contact avec une organisation à partir d'une fiche organisation.</p> <p>Depuis la fiche “auteur” de l'organisation, dépliez la la boite de dialogue; un champ de saisie apparait et permet de rechercher un contact<span class="spip_note_ref"> [<a href="#nb17-1" class="spip_note" rel="appendix" title="un spip_auteur ayant le statut de contact" id="nh17-1">1</a>]</span> à lier à l'organisation.</p> <div class='spip_document_8614 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Une fois le(s) contact(s) trouvé(s) par SPIP affiché(s), cliquez sur le “+” pour lier ce contact à l'organisation. Pour “délier” le contact de l'organisation, il suffit de cliquer sur le bouton “délier” (icône en forme de maillon de chaine rompu).</p> <h2 class="h2" id='Dependances'>Dépendances<a class='sommaire-back sommaire-back-10' href='#s-Dependances' title='Back to the table of contents'></a></h2> <p>Le plugin “Contacts & organisations” nécessite le <a href="https://contrib.spip.net/Saisies">plugin saisies</a> en version 1.7.7 minimum (pour la saisie du champ date).</p> <h2 class="h2" id='Nouvelles-tables-nouveaux-champs'>Nouvelles tables / nouveaux champs<a class='sommaire-back sommaire-back-10' href='#s-Nouvelles-tables-nouveaux-champs' title='Back to the table of contents'></a></h2> <p>Le plugin installe 3 nouvelles tables, et permet d'utiliser de nouveaux champs dans les boucles <code class='spip_code spip_code_inline' dir='ltr'>#AUTEURS</code> :</p> <ul class="spip" role="list"><li> <strong>table spip_contacts :</strong> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>#CIVILITE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#NOM</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#PRENOM</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#FONCTION</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#DATE_NAISSANCE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#DESCRIPTIF</code></li></ul></li><li> <strong>table spip_organisations :</strong> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>#NOM</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#STATUT_JURIDIQUE</code> (anciennement “type”)</li><li> <code class='spip_code spip_code_inline' dir='ltr'>#IDENTIFICATION</code> (anciennement “siret”)</li><li> <code class='spip_code spip_code_inline' dir='ltr'>#ACTIVITE</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#DATE_CREATION</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>#DESCRIPTIF</code></li></ul></li><li> <strong>table spip_contacts_organisations</strong> <ul class="spip" role="list"><li> pas de champ nouveau, mais permet de déterminer des liaisons entre contacts et organisations</li></ul></li></ul><h2 class="h2" id='Annuaires'>Annuaires<a class='sommaire-back sommaire-back-10' href='#s-Annuaires' title='Back to the table of contents'></a></h2> <p>Il est possible de regrouper des organisations et/ou des contacts, en les séparant dans des annuaires différents. Chaque fiche ne peut appartenir qu'à un seul annuaire.</p> <h2 class="h2" id='Partie-experimentale'>Partie expérimentale<a class='sommaire-back sommaire-back-10' href='#s-Partie-experimentale' title='Back to the table of contents'></a></h2> <p>Rq: les pages présentées ici ont bien évolué depuis la création de cette documentation.</p> <p>Deux pages de gestion des contact et des organisations sont en cours d'élaboration et présentes dans le plugin :</p> <div class='spip_document_8616 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <div class='spip_document_8615 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Les fonctionnalités sont à imaginer à partir de ces pages (imports, transformations en masse, etc.). N'hésitez pas à faire des suggestions.</p></div> <hr /> <div class='rss_notes'><div id="nb17-1"> <p><span class="spip_note_ref">[<a href="#nh17-1" class="spip_note" title="Footnotes 17-1" rev="appendix">1</a>] </span>un spip_auteur ayant le statut de contact</p> </div></div> </article> <article> <h1>À propos des plugins actifs</h1> <p>J-Ph Guihard — 2010-11-13T10:34:40Z</p> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-3" id="nav6a60d1499fbb92.75615285"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Exemple-de-mise-en-oeuvre"></a><a href="#Exemple-de-mise-en-oeuvre" class="spip_ancre">Exemple de mise en œuvre</a></li><li> <a id="s-Utilisation-pour-les-redacteurs"></a><a href="#Utilisation-pour-les-redacteurs" class="spip_ancre">Utilisation pour les rédacteurs</a></li><li> <a id="s-Utilisation-dans-les-squelettes"></a><a href="#Utilisation-dans-les-squelettes" class="spip_ancre">Utilisation dans les squelettes</a></li></ul></div><p><i>À propos des plugins actifs</i> affiche dans la partie publique de votre site la version de SPIP utilisée et la liste des Plugins activés avec affichage de l'icône, le nom, la version, l'état et une introduction de sa fonction. Si le Plugin n'a pas d'icône, une icône générique sera affichée. Vous pouvez utiliser ce plugin dans une page de type «À propos du site» par exemple.</p> <h2 class="h2" id='Exemple-de-mise-en-oeuvre'>Exemple de mise en œuvre<a class='sommaire-back sommaire-back-3' href='#s-Exemple-de-mise-en-oeuvre' title='Back to the table of contents'></a></h2> <p>Apercu du rendu sous SPIP 4.0</p> <div class='spip_document_22024 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Page d'exemple sur le site de l'auteur (en SPIP 2) :<br class='autobr' /> <a href="https://jp.guihard.net/spip.php?article92" class="spip_url spip_out auto" rel="nofollow external">https://jp.guihard.net/spip.php?article92</a>.</p> <h2 class="h2" id='Utilisation-pour-les-redacteurs'>Utilisation pour les rédacteurs<a class='sommaire-back sommaire-back-3' href='#s-Utilisation-pour-les-redacteurs' title='Back to the table of contents'></a></h2> <p>Vous pouvez aussi utiliser ce plugin directement dans un article. Vous disposez des différents paramètres :</p> <ul class="spip" role="list"><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|lister_tout></code> pour afficher la liste de tous plugins tiers et plugins verrouillés actifs et inactifs ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|liste></code> pour afficher la liste des plugins et plugins verrouillés actifs ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|tous></code> pour afficher la liste de tous les plugins ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|nombre></code> pour n'afficher que le nombre de plugins ET de plugins verrouillés actifs ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|plugins></code> pour n'afficher que le nombre de plugins actifs ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|extensions></code> pour n'afficher que le nombre de plugins verrouillés actifs ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|adisposition></code> pour n'afficher que le nombre de plugins dans le dossier plugins ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|disponible></code> pour n'afficher que le nombre total de plugins verrouillés et de plugins de votre configuration.</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|stats|prefixe=le prefixe du plugin></code> pour afficher le nombre de site utilisant le plugin dont vous aurez indiqué le préfixe</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|prefixe=le prefixe du plugin></code> si vous souhaitez afficher la description complète d\'un plugin spécifique, écrivez <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|prefixe=le prefixe du plugin></code>. Ainsi, par exemple, pour afficher dans un article la description complète de ce plugin, utilisez <code class='spip spip_code spip_code_inline' dir='ltr'><apropos|prefixe=apropos></code>.</li></ul> <p>Pour personnaliser ce qui est affiché avant et après la liste des plugins actifs, modifiez le fichier modeles/apropos_liste.html que vous aurez préalablement copié dans le dossier squelettes/modeles.</p> <h2 class="h2" id='Utilisation-dans-les-squelettes'>Utilisation dans les squelettes<a class='sommaire-back sommaire-back-3' href='#s-Utilisation-dans-les-squelettes' title='Back to the table of contents'></a></h2><ul class="spip" role="list"><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos_lister_tout}></code> pour afficher la liste de tous plugins tiers et plugins verrouillés actifs et inactifs ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos_liste}></code> pour afficher la liste des plugins et plugins verrouillés actifs ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos_tous}></code> pour afficher la liste de tous les plugins ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos_nombre}></code> pour n'afficher que le nombre de plugins ET de plugins verrouillés actifs ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos_plugins}></code> pour n'afficher que le nombre de plugins actifs ;<br /></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos_extensions}></code> pour n'afficher que le nombre de plugins verrouillés actifs ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos_adisposition}></code> pour n'afficher que le nombre de plugins dans le dossier plugins ;</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos_disponible}></code> pour n'afficher que le nombre total de plugins verrouillés et de plugins de votre configuration.</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos_stats,prefixe=le préfixe du plugin}></code> pour afficher le nombre de site utilisant le plugin dont vous aurez indiqué le préfixe</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos,prefixe=le préfixe du plugin}></code> si vous souhaitez afficher la description complète d'un plugin spécifique. Ainsi, par exemple, pour afficher dans un article la description complète du plugin À propos des plugins, utilisez <code class='spip spip_code spip_code_inline' dir='ltr'><INCLURE{fond=modeles/apropos,prefixe=apropos}></code>.</li></ul></div> </article> <article> <h1>Abomailmans pour s'abonner à des listes de diffusion</h1> <p>jeanmarie, kent1, NetAktiv, touti, Yffic — 2007-08-01T20:54:53Z</p> <div class='rss_chapo'><p>Un plugin qui permet d'interfacer vos listes de diffusions avec votre SPIP. Créé à l'origine pour fonctionner avec le robot Mailman, il a évolué et permet maintenant de gérer aussi les inscriptions aux listes Sympa, Ezmlm et mlmmj.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-10" id="nav6a60d149a52a80.83600445"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Principe"></a><a href="#Principe" class="spip_ancre">Principe</a></li><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Ajouter-des-listes"></a><a href="#Ajouter-des-listes" class="spip_ancre">Ajouter des listes</a></li><li> <a id="s-Envoyer-du-contenu-de-votre-SPIP-aux-listes"></a><a href="#Envoyer-du-contenu-de-votre-SPIP-aux-listes" class="spip_ancre">Envoyer du contenu de votre SPIP aux listes</a></li><li> <a id="s-Utilisation-par-l-internaute"></a><a href="#Utilisation-par-l-internaute" class="spip_ancre">Utilisation par l'internaute</a></li><li> <a id="s-Personnalisation"></a><a href="#Personnalisation" class="spip_ancre">Personnalisation</a></li><li> <a id="s-Abonnement-a-une-liste-particuliere"></a><a href="#Abonnement-a-une-liste-particuliere" class="spip_ancre">Abonnement à une liste particulière</a></li><li> <a id="s-Cas-particulier-du-gestionnaire-de-liste-EZMLM-chez-OVH-avec-de-la-fonction-nbsp"></a><a href="#Cas-particulier-du-gestionnaire-de-liste-EZMLM-chez-OVH-avec-de-la-fonction-nbsp" class="spip_ancre">Cas particulier du gestionnaire de liste EZMLM chez OVH avec de la fonction mail() de PHP</a></li><li> <a id="s-Details-du-code"></a><a href="#Details-du-code" class="spip_ancre">Détails du code</a></li><li> <a id="s-Evolutions-envisagees"></a><a href="#Evolutions-envisagees" class="spip_ancre">Évolutions envisagées</a></li></ul></div><h2 class="h2" id='Principe'>Principe<a class='sommaire-back sommaire-back-10' href='#s-Principe' title='Back to the table of contents'></a></h2> <p>Mailman est un outil puissant de mailing liste <a href="http://www.gnu.org/software/mailman/" class="spip_url spip_out" rel="external">http://www.gnu.org/software/mailman/</a>. Il peut gérer plusieurs centaines, voir plusieurs milliers d'adresses e-mail, pour une seule liste de diffusion/ discussion. Il manquait à ma connaissance un plugin permettant de l'interfacer avec SPIP, voilà la chose faite.</p> <p>Une partie de ce plugin est inspirée par le plugin <a href='https://contrib.spip.net/SPIP-Listes' class="spip_in" hreflang="fr">Spip-Listes</a>. Contrairement à ce plugin, Abomailmans laisse la gestion des abonnements, des désabonnements, l'envoi et l'échange d'e-mails à Mailman.</p> <p>Ce plugin permet via une balise <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_ABOMAILMAN</code> d'afficher un formulaire d'abonnement à l'ensemble des listes renseignées Mailman. Cette inscription se fait via l'interface privée de SPIP par le menu «Edition > Abomailmans > les listes de diffusions mailman» Ensuite il vous est possible de sélectionner des articles de votre SPIP, par des critères de date, de rubrique et/ou de mot clé et envoyer leurs contenus à ces listes, en utilisant des squelettes de mise en page du contenu.</p> <p>Le lien avec les listes Mailman se fait par des envois d'e-mail.</p> <p>Voici comment cela se présente sur la partie publique.</p> <div class='spip_document_4650 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-10' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Copiez le répertoire <i>abomailmans</i> dans votre répertoire plugins, puis installez le plugin selon la procédure habituelle, cf. <a href="http://www.spip.net/fr_article3396.html" class="spip_url spip_out" rel="external">http://www.spip.net/fr_article3396.html</a>.</p> <p>Le plugin nécessite les plugins <a href='https://contrib.spip.net/Facteur' class="spip_in" hreflang="fr">Facteur</a> (spip 2 et spip 3) et <a href='https://contrib.spip.net/SPIP-Bonux' class="spip_in" hreflang="fr">spip-bonux</a> (Spip 2)</p> <p>Placez la balise <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_ABOMAILMAN</code> dans vos squelettes la ou vous le souhaitez.</p> <h2 class="h2" id='Ajouter-des-listes'>Ajouter des listes<a class='sommaire-back sommaire-back-10' href='#s-Ajouter-des-listes' title='Back to the table of contents'></a></h2> <p>Cliquez sur <strong>Les listes de diffusion</strong> dans le menu «Édition» de l'espace privé</p> <div class='spip_document_4651 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Vous obtenez la page de la gestion de vos listes</p> <div class='spip_document_4652 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Cliquez sur «Ajouter une nouvelle liste», vous obtenez la page d'ajout d'une liste</p> <div class='spip_document_4653 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Renseigner ces champs, veuillez vérifier que l'adresse e-mail de votre liste est bien correcte.</p> <p>L'ensemble des listes que vous aurez renseignées, vont apparaître dans votre site via la balise <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_ABOMAILMAN</code> que vous aurez placé dans vos squelettes.</p> <h2 class="h2" id='Envoyer-du-contenu-de-votre-SPIP-aux-listes'>Envoyer du contenu de votre SPIP aux listes<a class='sommaire-back sommaire-back-10' href='#s-Envoyer-du-contenu-de-votre-SPIP-aux-listes' title='Back to the table of contents'></a></h2> <p>À la page de la gestion de vos listes, cliquez sur «Envoyer un e-mail aux listes à partir du contenu de ce site»</p> <div class='spip_document_4658 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Sélectionnez le modèle de présentation d'e-mail («nouveautés» est présent par défaut). Les modèles se retrouvent dans <i>/(...)/abomailmans/templates/</i> (Cf. Personnalisation). Vous pouvez choisir de lister : <br />- les articles à partir d'une date via «Contenu a partir de cette date» <br />- et les articles d'une rubrique via «Et lister les articles de la rubrique» <br />- et les articles liés à un mot clé via «Et lister les articles du mot clé»</p> <p>Renseignez le sujet de votre e-mail, et introduisez le contenu issu du site. Cliquez sur «Aperçu». Ensuite choisissez la liste à laquelle vous souhaitez envoyer cet aperçu</p> <div class='spip_document_4660 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Utilisation-par-l-internaute'>Utilisation par l'internaute<a class='sommaire-back sommaire-back-10' href='#s-Utilisation-par-l-internaute' title='Back to the table of contents'></a></h2> <p>L'internaute saisi son Nom, son Prénom et son adresse e-mail (Obligatoire, un test PHP est effectué sur ce champ), et coche les listes auxquelles il souhaite s'abonner. Ensuite il reçoit éventuellement les demandes de confirmation du gestionnaire de liste. La gestion de son abonnement s'effectuera via ce gestionnaire de liste.</p> <h2 class="h2" id='Personnalisation'>Personnalisation<a class='sommaire-back sommaire-back-10' href='#s-Personnalisation' title='Back to the table of contents'></a></h2> <p>Vous pouvez créer plusieurs modèles d'envoi d'e-mail à vos listes en les ajoutant dans votre répertoire <i>/(...)/squelettes/templates/</i>.</p> <p>Ce sont de simples squelettes SPIP, faites attention aux points suivants : <br />- ne pas placer les balises d'ouverture et de fermeture html </code><html><body></code>. <br />- mettre les styles CSS directement dans les balises pour être sur qu'ils seront interprétés (même par les webmails) <br />- les urls et liens images doivent être convertis en urls absolues, utilisez pour ce faire le filtre <code class='spip_code spip_code_inline' dir='ltr'>liens_absolus</code></p> <p>Depuis la version 0.7, il est possible de créer aussi un template pour la version texte de votre e-mail. Si votre template de base s'appelle ma_newsletter.html, la version texte devra se nommer ma_newsletter.txt.html</p> <h2 class="h2" id='Abonnement-a-une-liste-particuliere'>Abonnement à une liste particulière<a class='sommaire-back sommaire-back-10' href='#s-Abonnement-a-une-liste-particuliere' title='Back to the table of contents'></a></h2> <p>Il est possible de proposer un formulaire d'inscription ciblant une liste bien précise, au moyen de la balise <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_ABOMAILMAN_MINI_UNE_LISTE</code></p> <p>Exemple d'utilisation, pour permettre l'abonnement à la liste id n°1 :<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>#FORMULAIRE_ABOMAILMAN_MINI_UNE_LISTE{1}</code></p> <h2 class="h2" id='Cas-particulier-du-gestionnaire-de-liste-EZMLM-chez-OVH-avec-de-la-fonction-nbsp'>Cas particulier du gestionnaire de liste EZMLM chez OVH avec de la fonction mail() de PHP<a class='sommaire-back sommaire-back-10' href='#s-Cas-particulier-du-gestionnaire-de-liste-EZMLM-chez-OVH-avec-de-la-fonction-nbsp' title='Back to the table of contents'></a></h2> <p>Chez OVH, dans le cas d'envois de mails via un script PHP, le Return-path est réécrit pour pouvoir comptabiliser les erreurs via un robot (gestion des spams). Or, EZMLM se base sur ce champ plutôt que sur le From. Du coup l'abonnement est impossible.</p> <p>Pour palier à ce souci, Yffic avait fait une bidouille pour que le To soit sous la forme maliste-subscribe-lemail=ledomaine.tld@monsite.tld et que l'inscription fonctionne (<a href="https://git.spip.net/spip-contrib-extensions/abomailmans/commit/952db37d47221011b8414ae84f8bbe23d2c86a9f" class="spip_out" rel="external">voir ici</a>). Il faut donc ajouter un define à votre fichier mes_options.php.</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>define('_ABOMAILMAN_ROBOT_EZMLM','true');</code></pre></div> <p>Ce problème est peut être présent chez d'autres hébergeurs...</p> <h2 class="h2" id='Details-du-code'>Détails du code<a class='sommaire-back sommaire-back-10' href='#s-Details-du-code' title='Back to the table of contents'></a></h2> <p>- Utilisation de Jquery (inclus dans spip 1.9.2 et +) (<a href="http://jquery.com/" class="spip_url spip_out" rel="external">http://jquery.com/</a>) <br />- Utilisation du plugin JQuery date picker (inclus dans ce plugin) (<a href="http://www.kelvinluck.com/assets/jquery/datePicker/" class="spip_url spip_out" rel="external">http://www.kelvinluck.com/assets/jq...</a>) <br />- Utilisation du plugin facteur pour Spip > 2</p> <h2 class="h2" id='Evolutions-envisagees'>Évolutions envisagées<a class='sommaire-back sommaire-back-10' href='#s-Evolutions-envisagees' title='Back to the table of contents'></a></h2> <p>- Gestion de listes privées <br />- Pouvoir mettre en avant une seule liste <br />- Modifier le destinataire d'envoi dans le cas ezmlm pour que les inscriptions fonctionnent si facteur utilise l'envoi via la fonction mail() de php. En effet dans ce cas, le header return-path n'est pas renseigné. Or c'est ce header qui est utilisé par le robot pour répondre et non le champ from... Il faudrait modifier le destinataire comme ceci maliste-subscribe-lemail=ledomaine.tld@monsite.tld</p></div> </article> <article> <h1>Abonnements</h1> <p>RastaPopoulos — 2015-01-31T11:00:00Z</p> <div class='rss_chapo'><p>Gérer des abonnements à des offres, et uniquement cela.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-5" id="nav6a60d149a7a081.04359152"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Offres-d-abonnement"></a><a href="#Offres-d-abonnement" class="spip_ancre">Offres d'abonnement</a></li><li> <a id="s-Ajouter-un-e-abonne-e"></a><a href="#Ajouter-un-e-abonne-e" class="spip_ancre">Ajouter un⋅e abonné⋅e</a></li><li> <a id="s-Suivre-les-abonne-es"></a><a href="#Suivre-les-abonne-es" class="spip_ancre">Suivre les abonné⋅es</a></li><li> <a id="s-Notifications-de-relance"></a><a href="#Notifications-de-relance" class="spip_ancre">Notifications de relance</a></li><li> <a id="s-Oui-mais-des-abonnements-a-quoi"></a><a href="#Oui-mais-des-abonnements-a-quoi" class="spip_ancre">Oui mais des abonnements à quoi ?</a></li></ul></div><p>Ce plugin a pour but de regrouper tout ce qui est commun aux différents types d'abonnements possibles (à des zones restreintes, à des contenus précis, à une version papier pourquoi pas aussi...).</p> <p>Il permet de définir les offres d'abonnement proposées par le site, et gère les personnes qui y sont abonnées, désactivant l'abonnement au bout d'un temps donné.</p> <p>Comme il peut y avoir toute sorte de cas, ce n'est pas ce plugin qui décide quels droits sont donnés lors d'un abonnement. C'est à d'autres plugins d'implémenter cela, par exemple <a href='https://contrib.spip.net/Abonnements-a-des-zones-restreintes' class="spip_in" hreflang="fr">pour lier alors automatiquement un utilisateur à une zone restreinte</a>.</p> <h2 class="h2" id='Offres-d-abonnement'>Offres d'abonnement<a class='sommaire-back sommaire-back-5' href='#s-Offres-d-abonnement' title='Back to the table of contents'></a></h2> <p>L'élément central proposé par ce plugin est l'offre d'abonnement. Une offre contient :</p> <ul class="spip" role="list"><li> un titre</li><li> un descriptif</li><li> une durée (un nombre) et un type de période (mois, jours, ou heures)</li><li> un prix (qui peut être 0, donc gratuit)</li></ul> <p>Vous devez donc créer au moins une offre pour ensuite avoir des abonnés. Pour cela il faut aller dans <strong>Publication => Offres d'abonnement</strong>.</p> <h2 class="h2" id='Ajouter-un-e-abonne-e'>Ajouter un⋅e abonné⋅e<a class='sommaire-back sommaire-back-5' href='#s-Ajouter-un-e-abonne-e' title='Back to the table of contents'></a></h2> <p>Dans ce plugin, un⋅e abonné⋅e met en relation un⋅e utilisateurice de SPIP et une offre d'abonnement. Cette relation est datée avec un début et une fin.</p> <p>Pour ajouter des abonné⋅e⋅s, vous devez donc déjà avoir des gens inscrits sur votre site, quelque soit leur statut. Dans la plupart des cas, il s'agira du statut “visiteur”, qui sert uniquement dans le site (sans accès à l'admin). Il faut ensuite aller sur la page d'une offre où se situe un lien d'ajout.</p> <p>Lorsqu'on ajoute un⋅e nouvel⋅le abonné⋅e, il est seulement possible de sélectionner un⋅e utilisateurice. Automatiquement, le formulaire utilisera la date de création comme date de début, et calculera la date de fin en ajoutant la durée de l'offre dans laquelle on se trouve.</p> <p>Pour des besoins particulier, ces dates sont toujours modifiables après-coup. On peut donc éditer un abonnement, et changer ces deux dates. En revanche, le compte SPIP lié à l'abonnement n'est pas modifiable.</p> <h2 class="h2" id='Suivre-les-abonne-es'>Suivre les abonné⋅es<a class='sommaire-back sommaire-back-5' href='#s-Suivre-les-abonne-es' title='Back to the table of contents'></a></h2> <p>Sur la page de chaque offre, on trouve la liste des abonné⋅e⋅s à celle-ci. Mais il existe aussi une page de suivi générale qui permet d'avoir une vue d'ensemble de tous les abonnements dans <strong>Activités => Suivre les abonnements</strong>.</p> <p>Cette page liste les abonnements actifs dans une liste et les abonnements terminés dans une autre.</p> <p>Dans tous les listes, vous trouverez un bouton de renouvellement rapide pour chaque abonnement. Cette action va automatiquement changer la date de fin de l'abonnement en ajoutant la durée de l'offre. Si l'offre est pour 12 mois, l'abonnement durera 12 mois supplémentaires.</p> <h2 class="h2" id='Notifications-de-relance'>Notifications de relance<a class='sommaire-back sommaire-back-5' href='#s-Notifications-de-relance' title='Back to the table of contents'></a></h2> <p>Sur la page d'une offre, il est possible de configurer des dates de relance automatique. Ce sont des emails envoyés aux abonné⋅e⋅s aux dates choisies dans ce formulaire. Comme pour les offres, on choisit une durée (un nombre) et un type de période (mois ou jours).</p> <p>On peut par exemple ajouter deux relances : 1 mois et 7 jours. Dans ce cas, 1 mois avant la fin, et 7 jours avant la fin, la personne recevra un email l'invitant à renouveler son abonnement.</p> <p>Il est possible de personnaliser cet email en surchargeant le squelette <code class='spip_code spip_code_inline' dir='ltr'>notifications/abonnement_echeance.html</code>.</p> <h2 class="h2" id='Oui-mais-des-abonnements-a-quoi'>Oui mais des abonnements à quoi ?<a class='sommaire-back sommaire-back-5' href='#s-Oui-mais-des-abonnements-a-quoi' title='Back to the table of contents'></a></h2> <p>Comme expliqué précédemment, ce plugin ne gère que le mécanisme central d'abonnement, sans préjuger de ce qui se passe lorsqu'on est abonné⋅e.</p> <p>Actuellement il existe un premier plugin qui active l'autorisation de voir des contenus restreints lorsqu'on a un abonnement valide : <a href='https://contrib.spip.net/Abonnements-a-des-zones-restreintes' class="spip_in" hreflang="fr">Abonnements à des zones restreintes</a>.</p></div> </article> <article> <h1>Abonnements à des zones restreintes</h1> <p>RastaPopoulos — 2015-01-31T11:00:00Z</p> <div class='rss_chapo'><p>Permettre de voir du contenu restreint pour les abonné⋅e⋅s d'une offre.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-1" id="nav6a60d149aaaec7.76190015"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Fonctionnement"></a><a href="#Fonctionnement" class="spip_ancre">Fonctionnement</a></li></ul></div><p>Ce plugin permet de lier des zones restreintes du plugin <a href='https://contrib.spip.net/Acces-Restreint-3-0' class="spip_in" hreflang="fr">Accès Restreint</a> à des <a href='https://contrib.spip.net/Abonnements-4607' class="spip_in" hreflang="fr">offres d'abonnement</a>. Tout nouvel abonné à ces offres sera alors automatiquement ajouté aux zones, et inversement lors de la désactivation de l'abonnement.</p> <h2 class="h2" id='Fonctionnement'>Fonctionnement<a class='sommaire-back sommaire-back-1' href='#s-Fonctionnement' title='Back to the table of contents'></a></h2> <p>Pour utiliser ce plugin, il faut avoir au moins une offre d'abonnement et une zone restreinte.</p> <p>Sur la page d'admin de l'offre, on trouve alors un bloc permettant de configurer les zones qui lui sont liées. On peut en ajouter une ou plusieurs ainsi que retirer celles qui sont déjà listées.</p> <div class='spip_document_12722 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="70" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12722 '><strong>Aperçu du bloc de configuration des zones sur une offre d'abonnement </strong></div> </figcaption></figure> </div> <p>Dès qu'une zone est ajoutée à une offre, toutes les personnes ayant un abonnement valide vont automatiquement être autorisée à voir la zone en question.</p> <p>Lorsqu'un abonnement se termine, et qu'il devient inactif, alors l'autorisation est immédiatement retirée pour le compte lié.</p></div> </article> <article> <h1>Acces Restreint 3.0+</h1> <p>Cerdic — 2008-12-11T16:05:05Z</p> <div class='rss_chapo'><p>Le plugin accès restreint permet de définir et de gérer des zones de l'espace public en accès restreint.</p> <p>L'interface a été remaniée pour une meilleure ergonomie, mais le fonctionnement des boucles et des squelettes reste identique à <a href='https://contrib.spip.net/Le-plugin-Acces-Restreint' class="spip_in" hreflang="fr">la version initiale du plugin</a></p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-7" id="nav6a60d149af3488.51413987"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Utilite-et-fonctionnalites-du-plugin"></a><a href="#Utilite-et-fonctionnalites-du-plugin" class="spip_ancre">Utilité et fonctionnalités du plugin</a></li><li> <a id="s-I-Installation-du-plugin-acces-restreint"></a><a href="#I-Installation-du-plugin-acces-restreint" class="spip_ancre">I. Installation du plugin accès restreint</a></li><li> <a id="s-II-Definir-les-zones-en-acces-restreint"></a><a href="#II-Definir-les-zones-en-acces-restreint" class="spip_ancre">II. Définir les zones en accès restreint</a></li><li> <a id="s-III-Ajouter-des-auteurs-a-une-zone"></a><a href="#III-Ajouter-des-auteurs-a-une-zone" class="spip_ancre">III. Ajouter des auteurs à une zone</a></li><li> <a id="s-IV-Fonctionnement-et-boucles-du-plugin"></a><a href="#IV-Fonctionnement-et-boucles-du-plugin" class="spip_ancre">IV. Fonctionnement et boucles du plugin</a></li><li> <a id="s-V-Proteger-les-documents-de-SPIP"></a><a href="#V-Proteger-les-documents-de-SPIP" class="spip_ancre">V. Protéger les documents de SPIP</a></li><li> <a id="s-VI-Parametrage-plus-fin-des-restrictions"></a><a href="#VI-Parametrage-plus-fin-des-restrictions" class="spip_ancre">VI. Paramétrage plus fin des restrictions</a></li></ul></div><h2 class="h2" id='Utilite-et-fonctionnalites-du-plugin'>Utilité et fonctionnalités du plugin<a class='sommaire-back sommaire-back-7' href='#s-Utilite-et-fonctionnalites-du-plugin' title='Back to the table of contents'></a></h2> <p>Le plugin accès restreint vous permet de protéger et de restreindre l'accès à certaines rubriques uniquement aux visiteurs authentifiés et autorisés.</p> <p>Si un visiteur n'est pas identifié ou s'il n'est pas autorisé, alors l'intégralité de la rubrique (ce qui inclut les sous-rubriques, les articles, les liens ...) ne sera pas visible par ce visiteur.</p> <p>Si le visiteur est identifié, alors ce visiteur pourra accéder aux rubriques pour lesquelles il a reçu une autorisation d'accès.</p> <p>Ainsi, ce plugin vous permet de masquer du contenu aux visiteurs non identifiés, et de créer des droits d'accès aux visiteurs identifiés.</p> <p>Le plugin vous permet également de filtrer l'espace privé.</p> <p>En résumé, le plugin Accès restreint permet de définir et de gérer des zones de l'espace public et de l'espace privé en accès restreint.</p> <ul class="spip" role="list"><li> Chaque zone contient des rubriques, et les auteurs peuvent être associés à des zones pour avoir le droit d'y accéder.</li><li> Toutes les boucles natives de SPIP sont modifiées pour en filtrer les résultats en fonction des droits du visiteur.</li></ul><h2 class="h2" id='I-Installation-du-plugin-acces-restreint'>I. Installation du plugin accès restreint<a class='sommaire-back sommaire-back-7' href='#s-I-Installation-du-plugin-acces-restreint' title='Back to the table of contents'></a></h2> <p>Le plugin s'installe comme tous les autres, en ajoutant le dossier dans <code class='spip_code spip_code_inline' dir='ltr'>plugins/</code> et en l'activant dans l'espace privé.</p> <div class="error"> <strong>Attention : en activant ou en désactivant ce plugin, il faut penser à vider le cache de SPIP pour que les droits d'accès soient modifiés. En particulier, en cas de désactivation, si le cache n'est pas vidé, des erreurs vont apparaître sur le site public. Ce n'est pas un bug, mais une sécurité, pour éviter une divulgation de contenu en cas de désactivation involontaire du plugin.</strong></div> <p>Le plugin pourrait gérer automatiquement le changement de cache lors de son activation/désactivation, mais dans ce cas, en cas de désactivation involontaire, le contenu protégé serait immédiatement visible, ce qui peut être considéré comme une faille de sécurité.</p> <h2 class="h2" id='II-Definir-les-zones-en-acces-restreint'>II. Définir les zones en accès restreint<a class='sommaire-back sommaire-back-7' href='#s-II-Definir-les-zones-en-acces-restreint' title='Back to the table of contents'></a></h2> <p>Une fois activé, le plugin apparait dans le menu <strong>Publication > Accès restreint</strong> sous la forme d'une petite icône de cadenas : <code class='spip_code spip_code_inline' dir='ltr'>ecrire/?exec=zones</code></p> <div class='spip_document_23189 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>C'est cette page qui va vous permettre:</p> <ul class="spip" role="list"><li> de gérer les zones d'accès restreint de votre site,</li><li> créer de nouvelles zones ou modifier les zones existantes.</li></ul> <p>Pour créer votre première zone, cliquez sur le raccourci <i>Créer une nouvelle zone</i>.</p> <div class='spip_document_23188 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/02-ac-zone.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>L'administrateur qui crée la zone peut s'octroyer immédiatement les droits d'accès. Seul un administrateur général du site peut créer, modifier ou supprimer une zone.</p> <p>Renseignez le titre, le descriptif, la portée (publique et/ou privée) de la zone.<br class='autobr' /> Par défaut, l'option “m'ajouter les droits d'accès à cette zone” est cochée car cela correspond à l'usage le plus fréquent.</p> <div class='spip_document_23187 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/03-ac-zone3.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Il faut ensuite définir les rubriques qui en font partie. Si on coche la racine du site, il n'y a plus aucun affichage sur l'espace public pour ceux qui ne sont pas identifiés. C'est pratique, par exemple, pour mettre un site en ligne pour les administrateurs et les auteurs sans qu'il soit visible pour le simple visiteur.</p> <p>Les rubriques qui sont cochées sont explicitement restreintes. Si elles sont déplacées dans le site, elle le resteront. Les rubriques qui ne sont pas cochées mais dépendent d'une rubrique restreinte sont elles aussi restreintes, par héritage. Mais si elles sont déplacées dans l'arborescence dans une zone non restreinte elles seront visibles.</p> <p>Il faut imaginer la restriction d'accès des rubriques comme une restriction d'accès dans un immeuble : lorsqu'il faut une autorisation pour franchir une porte, tout ce qui est derrière se retrouve en accès restreint.</p> <p>Cliquez sur “Enregistrer” pour créer la zone. Vous revenez alors à la liste des zones, ou apparaît votre nouvelle zone :</p> <div class='spip_document_23186 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/43-ac-zone-saved.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Pour chaque zone, un résumé apparaît indiquant le titre et le descriptif de la zone, le nombre de rubriques restreintes, le nombre d'auteurs autorisés, et si la zone et publique et/ou privée.</p> <p>Le pictogramme en haut à droite de la zone vous indique si vous avez personnellement accès à la zone. Dans le cas où vous n'avez pas accès, il indique un sens interdit sur fond rouge, et sinon une coche sur fond vert, comme ici.</p> <h2 class="h2" id='III-Ajouter-des-auteurs-a-une-zone'>III. Ajouter des auteurs à une zone<a class='sommaire-back sommaire-back-7' href='#s-III-Ajouter-des-auteurs-a-une-zone' title='Back to the table of contents'></a></h2> <p><strong>Depuis la zone</strong></p> <p>Vous pouvez maintenant ajouter d'autres auteurs à la zone qui auront le droit de voir son contenu.<br class='autobr' /> Pour cela, cliquez sur <code class='spip_code spip_code_inline' dir='ltr'>modifier</code></p> <p>Vous retrouvez le formulaire d'édition de la zone avec :</p> <ul class="spip" role="list"><li> les rubriques concernées repérées visuellement par un fond coloré</li><li> la liste des auteurs autorisés</li></ul><div class='spip_document_23192 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/05-ac-auteurs.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Vous pouvez cliquer sur “Ajouter des auteurs” pour visualiser la liste des auteurs du site, triés par nom et paginés :</p> <div class='spip_document_23191 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/06-auteurs.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Vous pouvez ainsi administrer la liste des auteurs autorisés en la complétant comme par exemple ici :</p> <div class='spip_document_23190 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/07-auteurs.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Les mises à jour de la liste des auteurs autorisés sont appliquées immédiatement, sans qu'il soit nécessaire d'enregistrer la zone.</p> <p>Lorsque vous avez fini, revenez à la liste des zones (par le bouton retour donc, ou le bouton enregistrer si vous avez fait d'autres modifications). Vous pouvez voir que le nombre d'auteurs a été mis à jour.</p> <p><strong>Depuis une fiche auteur</strong></p> <p>Vous pouvez aussi gérer les droits d'un auteur depuis sa page personnelle dans l'interface privée :</p> <div class='spip_document_23195 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/08-auteurs.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Vous pouvez sélectionner une zone et cliquer sur “Ajouter une zone” :</p> <div class='spip_document_23194 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>La liste des zones autorisées est alors mise à jour :</p> <div class='spip_document_23193 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/10-ac-zone.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Le lien “Enlever la zone” vous permet de retirer les droits d'accès à une zone pour cet auteur.</p> <h2 class="h2" id='IV-Fonctionnement-et-boucles-du-plugin'>IV. Fonctionnement et boucles du plugin<a class='sommaire-back sommaire-back-7' href='#s-IV-Fonctionnement-et-boucles-du-plugin' title='Back to the table of contents'></a></h2> <p>Tout le fonctionnement des squelettes et des boucles est inchangé par rapport à <a href='https://contrib.spip.net/Le-plugin-Acces-Restreint#boucles' class="spip_in" hreflang="fr">la version précedente du plugin</a>. On se reportera donc à la partie concernée de sa documentation.</p> <p><a id="V"></a></p> <h2 class="h2" id='V-Proteger-les-documents-de-SPIP'>V. Protéger les documents de SPIP <a class='sommaire-back sommaire-back-7' href='#s-V-Proteger-les-documents-de-SPIP' title='Back to the table of contents'></a></h2> <p>La protection des documents de SPIP associé aux articles protégés est une fonctionnalité souvent demandée.</p> <p>Le plugin accès restreint permet cela, si votre hébergement remplit deux conditions :</p> <ul class="spip" role="list"><li> qu'il accepte les fichiers <code class='spip_code spip_code_inline' dir='ltr'>.htaccess</code> permettant de donner des directives au serveur</li><li> qu'il soit suffisamment bien dimensionné, car les accès aux images et documents du site vont tous générer un accès à la base de données (pour savoir si les documents concernés peuvent être vus), ce qui ralentit fortement le site.</li></ul> <p>Si vous êtes dans ces conditions, ou que vous voulez tout de même essayer (mais on vous aura prévenu), voici comment faire :</p> <p>Cliquez sur le raccourci “Configuration des accès .htaccess” :</p> <div class='spip_document_23197 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Vous arriverez sur cette page :</p> <div class='spip_document_23196 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/12-ac-htaccess.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Il suffit de cocher</p> <ul class="spip" role="list"><li> “Interdire la lecture”, dans le premier cadre “Accès aux documents joints par leur URL”</li><li> et “Créer les fichiers .htpasswd” dans le second cadre.</li></ul> <p>Vider ensuite votre cache. Tous les urls vers des images et documents de SPIP seront alors remplacés par un url de la forme <code class='spip_code spip_code_inline' dir='ltr'>spip.php?action=acceder_document&file=xxx</code>, qui provoquera la lecture de l'autorisation d'accès au document<span class="spip_note_ref"> [<a href="#nb18-1" class="spip_note" rel="appendix" title="A partir de la version 3.8 du plugin, les URLs des documents protégés sont (…)" id="nh18-1">1</a>]</span>.</p> <p>Si votre site devient très lent ou plante sans arrêt sur une erreur du type “Accès impossible à mySQL”, alors votre hébergement n'est pas suffisant pour ce fonctionnement. Désactiver la fonction pour revenir à un fonctionnement normal.</p> <p>En complément, si après la mise en place du fichier .htaccess certaines pages de l'interface privée vous sont inaccessibles et que vous obtenez des messages “Accès interdit”, vous pouvez désactiver la vérification htaccess de l'interface privée, dans <a href='https://contrib.spip.net/Message-d-erreur-Acces-interdit' class="spip_in" hreflang="fr">les options du site</a>.</p> <p><strong>Protection forte de l'accès aux documents</strong></p> <p>Par défaut, la protection des documents est faible. Si une personne ayant accès à un document partage son URL avec une personne non autorisée, celle-ci pourra accéder au document.</p> <p>Il est possible de modifier ce comportement afin de vérifier que la personne est bien autorisée lors de chaque accès à un document à l'aide de la constante <code class='spip_code spip_code_inline' dir='ltr'>ACCES_RESTREINT_FORCE_AUTORISE</code>.</p> <p>Exemple, dans config/mes_options.php :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>define('ACCES_RESTREINT_FORCE_AUTORISE', true); </code></pre></div> <p><a id="VI"></a></p> <h2 class="h2" id='VI-Parametrage-plus-fin-des-restrictions'>VI. Paramétrage plus fin des restrictions<a class='sommaire-back sommaire-back-7' href='#s-VI-Parametrage-plus-fin-des-restrictions' title='Back to the table of contents'></a></h2> <p><strong>AR_TYPE_RESTRICTION</strong> définit le type de restriction pour traiter les élements communs à plusieurs zones :</p> <ul class="spip" role="list"><li> Une restriction exclusive (ou forte) donne l'acces aux rubriques restreintes par plusieurs zones aux seuls membres de <strong>toutes</strong> les zones concernées.</li><li> Une restriction faible donne acces à une rubrique, même restreinte par plusieurs zones, aux membres de chaque zone concernée.</li><li> Valeurs possibles : <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>faible</code>,</li><li> <code class='spip_code spip_code_inline' dir='ltr'>forte</code> ou <code class='spip_code spip_code_inline' dir='ltr'>exclusive</code> (par défaut)</li></ul></li></ul> <p>Autrement dit, si une rubrique 2 est enfant d'une rubrique 1, et qu'il existe une zone 1 (rubrique 1) et une zone 2 (rubrique 2) :</p> <ul class="spip" role="list"><li> un auteur présent dans la zone 1 (uniquement) ne pourra pas voir la rubrique 2 lorsque la restriction est “forte”. Il le pourra avec une restriction “faible”</li><li> À l'inverse, un auteur présent uniquement dans la zone 2 ne pourra pas voir la rubrique 1 même si la restriction est “faible” car la parentée n'est pas concernée. Il faut (si souhaité) dans ce cas définir en plus <strong>AR_TYPE_RESTRICTION_PARENTEE</strong> à “faible” pour l'autoriser.</li></ul> <p>Exemple, dans config/mes_options.php :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code># Pour qu'une rubrique placée dans une Zone puisse # être accédée en étant une sous rubrique d'une autre Zone define('AR_TYPE_RESTRICTION', 'forte'); define('AR_TYPE_RESTRICTION_PARENTEE', 'faible'); </code></pre></div> <p><strong>AR_TOUJOURS_TOUT_VOIR</strong> est une constante qui, si elle est définie dans le fichier mes_options.php de votre site (ou le fichier d'options de votre plugin qui utilise acces_restreint) modifie le comportement des boucles afin qu'elles affichent tous les résultats, sans aucune restriction. Pour restreindre un affichage, le squelette doit donc tester à la main, par exemple avec le filtre <code class='spip_code spip_code_inline' dir='ltr'>accesrestreint_article_restreint</code>.</p> <p>Exemple : <br />- dans <code class='spip_code spip_code_inline' dir='ltr'>mes_options.php</code> :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>define ('AR_TOUJOURS_TOUT_VOIR', 1); </code></pre></div> <p><br />- dans un fichier squelette :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code><BOUCLE_a(ARTICLES)> [(#ID_ARTICLE|accesrestreint_article_restreint|oui) <INCLURE{fond=intro_article, id_article}> ] [(#ID_ARTICLE|accesrestreint_article_restreint|non) Pas accès à cette page] </BOUCLE_a> </code></pre></div> <p><strong>AR_RESTRICTION_LIENS_STRICTE</strong> (après 4.1.0) est une constante qui, si elle est définie dans le fichier mes_options.php de votre site (ou le fichier d'options de votre plugin qui utilise acces_restreint) permet de ne jamais autoriser l'accès à un document ou un forum lié à un objet en accès restreint.</p> <p>Exemple : <br />- dans <code class='spip_code spip_code_inline' dir='ltr'>mes_options.php</code> :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>define ('AR_RESTRICTION_LIENS_STRICTE', 1); </code></pre></div></div> <hr /> <div class='rss_notes'><div id="nb18-1"> <p><span class="spip_note_ref">[<a href="#nh18-1" class="spip_note" title="Footnotes 18-1" rev="appendix">1</a>] </span>A partir de la version 3.8 du plugin, les URLs des documents protégés sont soit sous la forme plus perenne <code class='spip_code spip_code_inline' dir='ltr'>/IMG/xxxxxx.xxx?nn/hash</code> si les réécritures d'URLs sont possible sur votre hébergement, soit de la forme <code class='spip_code spip_code_inline' dir='ltr'>docrestreint.api/nn/hash/xxxxxxx.xxx</code></p> </div></div> </article> <article> <h1>Accès Restreint Partiel</h1> <p>bruno31, mossad — 2014-09-08T20:34:02Z</p> <div class='rss_chapo'><p>Voulez-vous masquer une partie du contenu de vos articles aux visiteurs de passage ? et réserver la totalité à certains de vos membres ? Voulez-vous remplacer le contenu occulté par un appel à l'action (pour devenir Membre, bla bla bla...) ?</p> <p>Le plugin Accès Restreint Partiel permet d'afficher <strong>partiellement</strong> les articles faisant partie d'une zone à accès restreint. Il s'utilise en complément du plugin Accès Restreint.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-9" id="nav6a60d149b4bd26.03304267"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Utilite-et-fonctionnalites-du-plugin"></a><a href="#Utilite-et-fonctionnalites-du-plugin" class="spip_ancre">Utilité et fonctionnalités du plugin</a></li><li> <a id="s-I-Installation-du-plugin"></a><a href="#I-Installation-du-plugin" class="spip_ancre">I. Installation du plugin</a></li><li> <a id="s-II-Definir-les-regles-de-filtrage"></a><a href="#II-Definir-les-regles-de-filtrage" class="spip_ancre">II. Définir les règles de filtrage</a></li><li> <a id="s-Les-filtres"></a><a href="#Les-filtres" class="spip_ancre">Les filtres</a></li><li> <a id="s-III-Configurer-chaque-zone"></a><a href="#III-Configurer-chaque-zone" class="spip_ancre">III. Configurer chaque zone</a></li><li> <a id="s-Deux-modeles-pour-donner-envie"></a><a href="#Deux-modeles-pour-donner-envie" class="spip_ancre">Deux modèles pour donner envie</a></li><li> <a id="s-Definir-des-regles-specifiques-a-certains-articles"></a><a href="#Definir-des-regles-specifiques-a-certains-articles" class="spip_ancre">Définir des règles spécifiques à certains articles</a></li><li> <a id="s-Choisir-precisement-l-endroit-de-la-coupe"></a><a href="#Choisir-precisement-l-endroit-de-la-coupe" class="spip_ancre">Choisir précisément l'endroit de la coupe</a></li><li> <a id="s-Pour-eviter-de-tourner-en-rond"></a><a href="#Pour-eviter-de-tourner-en-rond" class="spip_ancre">Pour éviter de tourner en rond</a></li></ul></div><h2 class="h2" id='Utilite-et-fonctionnalites-du-plugin'>Utilité et fonctionnalités du plugin<a class='sommaire-back sommaire-back-9' href='#s-Utilite-et-fonctionnalites-du-plugin' title='Back to the table of contents'></a></h2> <p>Ce plugin est utilisé en sur-couche du <a href='https://contrib.spip.net/Acces-Restreint-3-0' class="spip_in" hreflang="fr">plugin Accès Restreint</a>. Ce dernier permet de définir des zones à accès restreint et d'attribuer des droits d'accès aux visiteurs et rédacteurs. Sur ce dernier point cela ne change pas.</p> <p><strong>Alors quelles sont les différences ?</strong><br class='autobr' /> Avec le plugin Accès Restreint, tout le contenu est occulté. Et même plus, puisque les articles concernés ne sortent même plus des résultats des boucles, sauf si le visiteur possède les droits d'accès à la zone restreinte, bien évidemment.</p> <p>Avec le plugin Accès Restreint Partiel, tous les articles sortent dans les résultats de la boucle, mais c'est le contenu affiché par la balise <code class='spip_code spip_code_inline' dir='ltr'>#TEXTE</code> de l'article protégé qui sera partiellement occulté, en fonction des filtres que vous aurez sélectionnés et configurés.</p> <p>Par exemple, il est possible d'afficher seulement N mots, un certain pourcentage de l'article, couper juste avant le N<sup>ième</sup> intertitre, rien du tout, etc.</p> <p>Il est également possible de configurer ce qui doit être affiché avant et après un texte qui a subit un filtrage.</p> <p>Pour voir ce que cela donne, voici un exemple avec un guide de construction partiellement occulté : <a href="https://cabane.bilp.fr/guide-construction-cabanes/" class="spip_url spip_out" rel="external">https://cabane.bilp.fr/guide-constr...</a></p> <h2 class="h2" id='I-Installation-du-plugin'>I. Installation du plugin<a class='sommaire-back sommaire-back-9' href='#s-I-Installation-du-plugin' title='Back to the table of contents'></a></h2> <p>Le plugin s'installe comme tout autre plugin. Cependant, le plugin Accès Restreint 3.x doit être préalablement installé. Les zone doivent aussi être définies.</p> <p>Il faut ensuite passer à la configuration du plugin. Si vous omettez de le faire, tous les articles des zones restreintes seront listés mais le <code class='spip_code spip_code_inline' dir='ltr'>#TEXTE</code> sera complètement occulté à l'affichage.</p> <h2 class="h2" id='II-Definir-les-regles-de-filtrage'>II. Définir les règles de filtrage<a class='sommaire-back sommaire-back-9' href='#s-II-Definir-les-regles-de-filtrage' title='Back to the table of contents'></a></h2> <p>Les règles de filtrage indiquent comment on souhaite occulter le texte des articles.<br class='autobr' /> Il est possible de configurer jusqu'à 8 règles de filtrage, à choisir parmi un choix de filtre.</p> <div class='spip_document_12472 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>On peut choisir la règle qui est appliquée par défaut. Ainsi on peut rapidement choisir une règle de filtrage pour l'ensemble du site, puis choisir une règle spécifique pour chaque zone, ou pour chaque article.</p> <p>Pour chaque règle, on choisit un filtre et on indique les paramètres du filtre.<br class='autobr' /> Le paramètre “Nombre de caractère minimum” n'est pas encore implémenté.</p> <p>Dans l'exemple ci-dessous, la règle #2 consiste à filtrer 50% du texte :</p> <div class='spip_document_12473 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Les-filtres'>Les filtres<a class='sommaire-back sommaire-back-9' href='#s-Les-filtres' title='Back to the table of contents'></a></h2><table class="table spip"> <thead><tr class='row_first'><th id='id3525_c0'> Diminutif </th><th id='id3525_c1'> Description </th><th id='id3525_c2'> Paramètre xxx </th><th id='id3525_c3'> Remarque </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='id3525_c0'>arp_filtre_ncar</td> <td headers='id3525_c1'>Couper à xxx caractères</td> <td headers='id3525_c2'>Nombre de caractères à conserver dans l'article</td> <td headers='id3525_c3'>Les modéles, balises html, raccourcis typographiques, comptent pour 1 caractère</td></tr> <tr class='row_even even'> <td headers='id3525_c0'>arp_filtre_pourcentage</td> <td headers='id3525_c1'>Ne conserver que xxx<small class="fine d-inline"> </small>% de l'article</td> <td headers='id3525_c2'>Définit le<small class="fine d-inline"> </small>% de caractères à afficher</td> <td headers='id3525_c3'>idem</td></tr> <tr class='row_odd odd'> <td headers='id3525_c0'>arp_filtre_nintertitre</td> <td headers='id3525_c1'>Couper juste avant le xxx ième intertitre</td> <td headers='id3525_c2'>Exemple : si xxx=3, on affiche uniquement les 2 premiers intertitres avec leur texte</td> <td headers='id3525_c3'>Si xxx est supérieur au nombre d'intertitres présents dans l'article, alors tout l'article est affiché</td></tr> <tr class='row_even even'> <td headers='id3525_c0'>arp_filtre_que_intertitre</td> <td headers='id3525_c1'>Ne laisser que les intertitres et remplacer le texte par xxx</td> <td headers='id3525_c2'></td> <td headers='id3525_c3'>ATTENTION, pas encore implémenté</td></tr> <tr class='row_odd odd'> <td headers='id3525_c0'>arp_filtre_tout</td> <td headers='id3525_c1'>Tout le texte est filtré (aucun affichage)</td> <td headers='id3525_c2'>non utilisé</td> <td headers='id3525_c3'></td></tr> <tr class='row_even even'> <td headers='id3525_c0'>arp_filtre_rien</td> <td headers='id3525_c1'>Rien n'est filtré, le texte est affiché tel que</td> <td headers='id3525_c2'>non utilisé</td> <td headers='id3525_c3'>Utile pour désactiver ponctuellement le filtrage partiel</td></tr> </tbody> </table><h2 class="h2" id='III-Configurer-chaque-zone'>III. Configurer chaque zone<a class='sommaire-back sommaire-back-9' href='#s-III-Configurer-chaque-zone' title='Back to the table of contents'></a></h2> <p>Pour chaque zone, on peut indiquer la règle de filtrage à appliquer.</p> <p>On peut également définir les textes AVANT et APRES : si le texte de l'article a subi un filtrage, il est possible d'insérer un bout de texte AVANT et APRES le texte de l'article.</p> <div class='spip_document_12474 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>On peut définir ces textes AVANT/APRES pour l'ensemble des zones par défaut. Mais on peut aussi le définir spécifiquement pour chaque zone. Dans ce cas, ce sont les textes spécifiques qui sont prioritaires sur les textes définis globalement.</p> <div class='spip_document_12475 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="166" data-legende-lenx="xxx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/jpg/2014-09-04_123647.jpg' class="spip_doc_lien mediabox" type="image/jpeg"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12475 '><strong>Exemple de configuration d'une zone </strong></div> <div class='spip_doc_descriptif crayon document-descriptif-12475 '>On peut insérer des modèles et du HTML. Voir plus loin l'explication des modèles <tt><liste_intertitre1></tt> et <tt><liste_doc1></tt> </div> </figcaption></figure> </div> <p>Les textes AVANT/APRES sont au standard typographique SPIP. On peut même ajouter des modèles, des balises HTML, etc.</p> <h2 class="h2" id='Deux-modeles-pour-donner-envie'>Deux modèles pour donner envie<a class='sommaire-back sommaire-back-9' href='#s-Deux-modeles-pour-donner-envie' title='Back to the table of contents'></a></h2> <div class='spip_document_12476 spip_document spip_documents spip_document_image spip_documents_right spip_document_right spip_document_avec_legende' data-legende-len="25" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/jpg/2014-09-04_124508.jpg' class="spip_doc_lien mediabox" type="image/jpeg"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12476 '><strong>Voilà ce que cela donne </strong></div> </figcaption></figure> </div> <p>Occulter une partie du texte pour susciter la curiosité, c'est une chose. Mais dévoiler subtilement, c'est encore mieux.</p> <p>Alors voici deux modèles à insérer dans les textes AVANT ou APRES. <br />- <code class='spip_code spip_code_inline' dir='ltr'><liste_intertitre></code> : liste tous les intertitres de l'article <br />- <code class='spip_code spip_code_inline' dir='ltr'><liste_doc></code> : liste tous les documents de l'article sous forme de mini-vignette non cliquables. Avec deux paramètres :</p> <ul class="spip" role="list"><li> width : largeur de la vignette en px,</li><li> raz : nombre de vignette sur une seule ligne. Juste après la Nième(raz) vignette, un <code class='spip_code spip_code_inline' dir='ltr'><br class='nettoyeur'></code> est inséré.</li></ul><h2 class="h2" id='Definir-des-regles-specifiques-a-certains-articles'>Définir des règles spécifiques à certains articles<a class='sommaire-back sommaire-back-9' href='#s-Definir-des-regles-specifiques-a-certains-articles' title='Back to the table of contents'></a></h2> <p>Comme nous l'avons vu, on définit des règles de filtrage globalement pour tout le site, ou zone par zone.<br class='autobr' /> Mais il est également possible d'agir localement au niveau d'un article. Par exemple, on peut choisir d'afficher 80% du texte pour tous les articles d'une zone donnée. Et pour un article précis de cette zone, on choisit de tout afficher.</p> <p>Pour cela, il suffit de décider quelle règle à on souhaite affecter à un article, en lui attribuant un mot-clé de la forme arp_regle# ou # est le numéro de la règle.</p> <h2 class="h2" id='Choisir-precisement-l-endroit-de-la-coupe'>Choisir précisément l'endroit de la coupe<a class='sommaire-back sommaire-back-9' href='#s-Choisir-precisement-l-endroit-de-la-coupe' title='Back to the table of contents'></a></h2> <p>Enfin, on peut être encore plus précis en choisissant l'endroit exact où on souhaite que le texte soit coupé. Il suffit d'insérer la balise <code class='spip_code spip_code_inline' dir='ltr'><couper_ici></code> à l'endroit exact dans le texte.<br class='autobr' /> Cette disposition est la plus prioritaire de toutes les règles.</p> <h2 class="h2" id='Pour-eviter-de-tourner-en-rond'>Pour éviter de tourner en rond<a class='sommaire-back sommaire-back-9' href='#s-Pour-eviter-de-tourner-en-rond' title='Back to the table of contents'></a></h2> <p><strong>Avant de crier à l'aide, je ne peux que vous encourager à lire la doc ci-dessus et à appliquer.<br class='autobr' /> En particulier : <br />- vous devez définir au moins règle, c'est-à-dire définir un filtrage. <br />- vous devez définir au moins une zone en accès restreint. <br />- vous devez indiquer quelle règle doit-être appliquée à cette zone, ou alors au moins déclarer la règle par défaut.</strong></p></div> </article> <article> <h1>Accessibilité pour les rédacteurs</h1> <p>goetsu, RealET — 2010-08-16T22:48:30Z</p> <div class='rss_chapo'><p>SPIP est un CMS largement répandu dans la sphère publique. Tout les jours des centaines de webmestres gérant des services de communication publique en ligne utilisent SPIP pour mettre leur contenu en ligne que ce soit dans de petites communes ou de <a href="https://www.ecologique-solidaire.gouv.fr/" class="spip_out" rel="external">très grand Ministère</a>.</p> <p>Depuis le 29 octobre 2009, les services de communication publique en ligne doivent se mettre en conformité par rapport au Référentiel Général d'Accessibilité pour les Administrations (<a href="http://www.references.modernisation.gouv.fr/rgaa-accessibilite" class="spip_out" rel="external">RGAA</a>) qui demande à ce que les sites web publics soient accessibles au plus grand nombre, notamment les personnes en situations de handicaps.</p> <p>L'objectif de cet article n'est pas de présenter <a href="http://www.references.modernisation.gouv.fr/sites/default/files/RGAA_040310.pdf" class="spip_in" rel="external" type='application/pdf'>le contenu du RGAA</a> ou <a href="https://openweb.eu.org/articles/accessibilite_numerique_pourqu" class="spip_out" rel="external">l'intérêt d'une démarche d'accessibilité</a> mais de voir thématique par thématique en quoi SPIP permet, nativement ou avec quelques ajouts, de produire du contenu accessible pour un rédacteur.</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-7" id="nav6a60d149b8bef6.93209668"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Images"></a><a href="#Images" class="spip_ancre">Images</a></li><li> <a id="s-Multimedia"></a><a href="#Multimedia" class="spip_ancre">Multimédia</a></li><li> <a id="s-Texte"></a><a href="#Texte" class="spip_ancre">Texte</a></li><li> <a id="s-Structuration"></a><a href="#Structuration" class="spip_ancre">Structuration</a></li><li> <a id="s-Tableau"></a><a href="#Tableau" class="spip_ancre">Tableau</a></li><li> <a id="s-Navigation"></a><a href="#Navigation" class="spip_ancre">Navigation</a></li><li> <a id="s-Conclusion"></a><a href="#Conclusion" class="spip_ancre">Conclusion</a></li></ul></div></p> <h2 class="h2" id='Images'>Images<a class='sommaire-back sommaire-back-7' href='#s-Images' title='Back to the table of contents'></a></h2> <p><strong>Les règles :</strong></p> <p>Lors de l'inclusion d'image dans un article le rédacteur doit pouvoir :</p> <ul class="spip" role="list"><li> spécifier l'<strong>alternative courte</strong> des images</li><li> spécifier une <strong>description dite longue</strong> reprenant l'ensemble des informations apportés par l'image (par exemple: toutes les informations récupérables sur un graphique statistiques).</li><li> spécifier la <strong>langue de l'alternative</strong> si elle est différente de la langue de la page</li></ul> <p>Ces alternatives doivent être adaptées au contexte d'utilisation de l'image en fonction de la façon dont elle est utilisée (alt='' si décorative, alt='fonction du lien' si image lien, alt='information apportée par l'image' si l'image est porteuse d'information).</p> <p><strong>Les images dans SPIP :</strong></p> <p>Pour l'heure, il est possible d'insérer une image dans un article à l'aide des modèles <code class='spip_code spip_code_inline' dir='ltr'><imgXX></code>, <code class='spip_code spip_code_inline' dir='ltr'><imageXX></code>, <code class='spip_code spip_code_inline' dir='ltr'><docXX></code> ou <code class='spip_code spip_code_inline' dir='ltr'><embXX></code>. Le fonctionnement par défaut des modèles prévoit :</p> <ul class="spip" role="list"><li> un attribut alt='' si l'utilisateur ne spécifie rien</li><li> un alt='titre' si le rédacteur spécifie un titre à l'image.</li><li> un alt='format de l'image ou du document – poids de l'image ou du document' si c'est un lien vers un document avec icône du format (raccourci doc).</li></ul> <p>Ces comportements sont bons mais ils présentent néanmoins quelques problèmes.</p> <p><strong>Les problèmes : </strong></p> <ul class="spip" role="list"><li> Aucune gestion des descriptions longues</li><li> Un titre = Une alternative, il est donc impossible d'avoir des alternatives adaptés aux différents contextes d'utilisation d'une même image.</li><li> Aucune gestion des changements de langue</li></ul> <p><strong>Les solutions :</strong></p> <p>Utiliser <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/accessibilite" class="spip_out" rel="external">le plugin accessibilité</a> qui modifie les modèles <code class='spip_code spip_code_inline' dir='ltr'><imgXX>, <imageXX>, <docXX> et <embXX></code> afin de pouvoir par défaut :</p> <ul class="spip" role="list"><li> spécifier une description longue. Pour cela il suffit de renseigner une description dans la base de données. Si vous souhaitez avoir une description et un titre visible différent de ceux enregistrés dans la base de donnée (raccourci <code class='spip_code spip_code_inline' dir='ltr'><docXX></code>) il est possible d'utiliser des paramètres supplémentaires sur les modèles sous la forme : <code class='spip_code spip_code_inline' dir='ltr'><docXX|titre=titre de votre document/image|legende=legende de votre document/image></code></li><li> spécifier une alternative différente du titre de l'image lorsqu'il y en a un enregistré dans la base de donnée en utilisant un paramètre supplémentaire sur les modèles sous la forme : <code class='spip_code spip_code_inline' dir='ltr'><imgXX|alt=votre alternative></code></li><li> spécifier une langue pour votre alternative en utilisant un paramètre supplémentaire sur les modèles sous la forme : <code class='spip_code spip_code_inline' dir='ltr'><imgXX|lang=le code de la langue utilisé></code></li></ul> <p>Ce qui donnerait pour une image avec une alternative en anglais</p> <p><code class='spip_code spip_code_inline' dir='ltr'><imgXX|alt=your text alternative even if there is already a title to the image defined in the database|lang=en></code></p> <h2 class="h2" id='Multimedia'>Multimédia<a class='sommaire-back sommaire-back-7' href='#s-Multimedia' title='Back to the table of contents'></a></h2> <p><strong>Les règles :</strong></p> <p>Le rédacteur insérant un contenu multimédia dans son contenu devra porter attention à :</p> <ul class="spip" role="list"><li> fournir une alternative/un transcript aux éléments multimédia (exemple si l'utilisateur n'a pas le plugin flash il aura l'alternative);</li><li> proposer des sous-titres et une piste d'audio description si nécessaire;</li><li> laisser le contrôle à l'utilisateur de la lecture, du son, des éléments clignotants, flashant et mouvant;</li><li> produire du code HTML valide dans la méthode d'insertion de l'élément multimédia.</li></ul> <p><strong>Le multimédia dans SPIP:</strong></p> <p>Il est possible d'insérer une vidéo, un son ou une animation Flash dans un article Spip à l'aide des raccourci <code class='spip_code spip_code_inline' dir='ltr'><embXX>,<audioXX>,<videoXX>,<audioXX></code>. Par défaut ce raccourci essai d'afficher l'élément multimédia avec le lecteur adapté et affiche si ils sont défini dans la base de donnée le titre et le descriptif en dessous.</p> <p><strong>Les problèmes :</strong></p> <ul class="spip" role="list"><li> Il est impossible de définir un contenu qui s'insérera dans la balise object et servira d'alternative.</li><li> Le code html produit n'est pas toujours conforme aux spécifications HTML à cause de l'utilisation de la balise <code class='spip_code spip_code_inline' dir='ltr'></code></li></ul> <p><strong>Les solutions :</strong></p> <ul class="spip" role="list"><li> Mettre un lien juste après l'élément multimédia pointant vers un autre article SPIP ou vers un fichier en téléchargement (dans un format accessible) contenant l'alternative.</li><li> Utiliser les modèles de documents accessible du <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/accessibilite" class="spip_out" rel="external">plugin accessibilité</a> pour éviter l'utilisation de balise <code class='spip_code spip_code_inline' dir='ltr'></code> et pouvoir également spécifier une alternative en utilisant un paramètre supplémentaire sur les modèles sous la forme : <code class='spip_code spip_code_inline' dir='ltr'><embXX|alternative=votre texte alternatif pour votre élément multimédia></code></li></ul> <p>Pour ce qui concerne le sous-titrage et l'audio-description : soit ces éléments sont incrustés nativement dans la vidéo, soit ils doivent être mis en pièce jointe à l'article et synchroniser au travers de l'utilisation d'un modèle spécifique de player vidéo supportant le sous-titrage et l'audio description (par exemple le <a href="http://another-teacher.net/spip.php?article354" class="spip_out" rel="external">Jwplayer</a> ; à noter que portage du jwplayer plus complet dans le plugin accessibilité est également prévu)</p> <p>Pour ce qui concerne le contrôle des animations / vidéos les éléments doivent eux-mêmes être contrôlable par l'utilisateur, SPIP ne pourra rien pour vous.</p> <p>Mais le plugin <a href='https://contrib.spip.net/Video-Accessible' class="spip_in" hreflang="fr">Vidéo Accessible</a> a été créé pour répondre explicitement aux problématiques d'accessibilité des vidéo !</p> <h2 class="h2" id='Texte'>Texte<a class='sommaire-back sommaire-back-7' href='#s-Texte' title='Back to the table of contents'></a></h2> <p><strong>Les règles :</strong></p> <p>Un texte peut parfois être difficile à comprendre pour un lecteur notamment à cause de passage dans une langue différente, de l'utilisation d'acronymes ou d'abréviation, ou de mot complexe. Il est alors nécessaire de :</p> <ul class="spip" role="list"><li> signaler les changements de langue à l'aide de l'attribut lang='code de langue' pour les passages de textes, les mots et les attributs dans une langue différente de celle du contenu principale de la page. L'indication du changement de langue permet notamment aux utilisateurs de lecteur d'écrans qui restitue vocalement les textes de parler dans la bonne langue.</li><li> signaler les abréviations et les acronymes à l'aide de la balise <code class='spip_code spip_code_inline' dir='ltr'><abbr></code> et <code class='spip_code spip_code_inline' dir='ltr'><acronym></code></li><li> mettre des liens vers un lexique/glossaire/dictionnaire/encyclopédie pour les mots complexes.</li></ul> <p><strong>Le texte dans SPIP:</strong></p> <p>SPIP est nativement multilingue, il permet de déclarer la langue d'un article et de son site. Il est particulier de préciser qu'un contenu est en langue parlée complétée, langue des signes française ou français simplifié (à activer dans la page de gestion des langues). Néanmoins il n'est pas aussi performant quand il s'agit des changements de langue dans un texte. Il permet également d'insérer des liens vers Wikipédia à l'aide du raccourci <code class='spip_code spip_code_inline' dir='ltr'>[?xxx]</code>.</p> <p><strong>Les problèmes :</strong></p> <p>Il n'existe aucun raccourci pour déclarer les changements de langue au sein d'un article, pour déclarer les acronymes et les abréviations et pour faire facilement un glossaire interne.</p> <p><strong> Les solutions :</strong></p> <ul class="spip" role="list"><li> Pour les images utiliser les modèles de document accessible de plugin accessibilité permettant de définir la langue sur les balises images</li><li> Utiliser <a href="https://contrib.spip.net/Decorer-ou-colorer-vos-textes">la lame décoration du plugin couteau suisse</a> pour créer des raccourcis typographiques supplémentaires permettant de signaler les changements de langue dont vous avez besoin. Une configuration possible de cette lame est la suivante : <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>span.en.lang = en span.de.lang = de span.it.lang = it span.es.lang = es div.bloc-en.lang = en div.bloc-de.lang = de div.bloc-it.lang = it div.bloc-es.lang = es</code></pre></div> <p>Vous disposerez alors des raccourcis suivant <code class='spip_code spip_code_inline' dir='ltr'><en></en>,<de></de>,<es></es>,<it></it>,<bloc-en></bloc-en>,<bloc-de></bloc-de>,<bloc-es></bloc-es>,<bloc-it></bloc-it></code> à utiliser sur les mots ou bloc de texte en anglais, allemand, espagnol ou italien. Exemple :<br class='manualbr' />Phrase en français avec <code class='spip_code spip_code_inline' dir='ltr'><en>some words in english</en></code>.</p> </li></ul><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><bloc-en>Block of text in english. With some paragraphs inside</bloc-en></code></pre></div><ul class="spip" role="list"><li> Pour une gestion centralisée des abréviations et des acronymes, utilisez les plugins <a href="svn://zone.spip.org/spip-zone/_plugins_/forms/forms_et_tables_2_0" class="spip_out">Forms et Tables 2.0</a> et <a href="svn://zone.spip.org/spip-zone/_plugins_/acronymes" class="spip_out">Acronymes</a> il vous suffira alors de renseigner dans la base de données un acronyme ou une abréviation pour qu'il soit automatiquement balisé correctement</li><li> Pour la gestion d'un glossaire interne il est possible d'utiliser <a href="https://contrib.spip.net/Un-glossaire-interne-pour-vos-sites">la lame glossaire du couteau suisse</a> ou <a href="https://contrib.spip.net/Plugin-glossaire">le plugin glossaire</a></li></ul> <p><strong>Autre solution pour indiquer le changement de langue</strong></p> <ul class="spip" role="list"><li> Installer le plugin <a href='https://contrib.spip.net/Bouton-Changement-de-langue-pour-le-Porte-Plume' class="spip_in" hreflang="fr">Bouton Changement de langue pour le Porte-Plume</a></li><li> Indiquer le changement de langue en cliquant sur le bouton et en indiquant la langue</li><li> ou avec les raccourcis typo <code class='spip_code spip_code_inline' dir='ltr'><multi[en]english text</multi></code></li></ul> <p>Cette solution est meilleure que celle du Couteau Suisse.</p> <h2 class="h2" id='Structuration'>Structuration<a class='sommaire-back sommaire-back-7' href='#s-Structuration' title='Back to the table of contents'></a></h2> <p><strong>Les règles:</strong></p> <p>Le contenu textuel doit être correctement structuré afin de faciliter sa lectuer et sa restitution au sein des aides techniques. Cela passe notamment par :</p> <ul class="spip" role="list"><li> l'utilisation d'intertitre dans vos textes</li><li> l'utilisation de liste ordonnées et non ordonnées</li><li> l'utilisation de citation</li></ul> <p><strong>La structuration des textes dans SPIP :</strong></p> <p>SPIP permet nativement de créer des intertitres qui seront transformé en <code class='spip_code spip_code_inline' dir='ltr'><h3></code> par l'intermédiaire du raccourci <code class='spip_code spip_code_inline' dir='ltr'>{{{votre intertitre}}}</code>.</p> <p>Il permet la création de liste ordonnée et non ordonnée par l'intermédiaire des raccourcis <code class='spip_code spip_code_inline' dir='ltr'>-#</code> et <code class='spip_code spip_code_inline' dir='ltr'>-*</code> (<code class='spip_code spip_code_inline' dir='ltr'><ol></code> et <code class='spip_code spip_code_inline' dir='ltr'><ul></code>).</p> <p>Enfin, il permet de définir des passages de texte comme étant des citations courtes ou longues grâce au raccourci <code class='spip_code spip_code_inline' dir='ltr'><quote>citation</quote></code>.</p> <p><strong>Les problèmes :</strong></p> <ul class="spip" role="list"><li> SPIP ne gère qu'un seul niveau d'intertitre et il peut parfois être nécessaire de structurer son texte de façon plus complète (comme dans cet article où j'ai dût artificiellement utiliser le gras pour matérialiser un 2<sup>e</sup> niveau d'intertitre)</li><li> l'utilisateur peut commencer une suite de paragraphes par un – ce qui aura pour effet de simuler visuellement une liste non ordonnées mais ne la balisera pas comme tel</li><li> On peut avoir besoin de faire une citation à l'intérieur d'un paragraphe.</li><li> Il faudrait pouvoir indiquer la langue, et la source de la citation</li></ul> <p><strong>Les solutions :</strong></p> <ul class="spip" role="list"><li> Utiliser le plugin <a href="https://contrib.spip.net/Enluminures-typographiques-V3-pour-SPIP-2-avec">« Enluminures Typographiques V3 pour Porte Plume »</a> afin de disposer de raccourcis typographiques permettant de gérer des niveaux d'intertitres supplémentaires à l'aide de <code class='spip_code spip_code_inline' dir='ltr'>{{{** intertitre de niveau deux }}}</code> et<code class='spip_code spip_code_inline' dir='ltr'> {{{*** intertitre de niveau trois }}}</code></li><li> Activer dans la configuration du plugin l'option permettant de transformer les paragraphes commençant par '-' par de vraies listes à puces. Cela se fait grâce à la globale <code class='spip_code spip_code_inline' dir='ltr'>$GLOBALS['barre_typo_pas_de_fausses_puces'] = true;</code> ou est réglable dans la page de configuration du plugin.</li><li> il peut également être utile d'ajouter dans votre fichier config/mes_options.php la configuration suivante : <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code><?php $GLOBALS['barre_typo_pas_de_fork_typo'] = false; // Pour tenir compte de https://zone.spip.org/trac/spip-zone/changeset/22723 et disposer des raccourcis typo supplémentaires ! $GLOBALS['debut_italique'] = "<em$class_spip>"; $GLOBALS['fin_italique'] = '</em>';?></code></pre></div></li></ul> <p>Pour les citations, le plugin Accessibilité rajoute un modèle pour gérer finement les citations.</p> <p>Exemple :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>Ceci est une citation : <citation|type=courte|texte=SPIP, la création du plaisir|langue=fr|cite=https://www.spip.net/> <citation|cite=https://www.spip.net/|langue=fr|texte=100 fois sur le métier _ tu boucleras ton ouvrage.|auteur=RealET|titre=Bouclage></code></pre></div> <p>- <strong>citation courte</strong></p> <ul class="spip" role="list"><li> |type=courte</li><li> texte=Texte de la citation</li><li> langue=code de la langue (fr, de, en, ...)</li><li> cite=URL de la source de la citation</li></ul> <p>- <strong>citation sous forme de bloc</strong></p> <ul class="spip" role="list"><li> texte=Texte de la citation</li><li> langue=code de la langue (fr, de, en, ...)</li><li> cite=URL de la source de la citation</li><li> titre=Titre du lien affiché sous la citation</li><li> auteur=Nom de l'auteur affiché sous la citation</li></ul><h2 class="h2" id='Tableau'>Tableau<a class='sommaire-back sommaire-back-7' href='#s-Tableau' title='Back to the table of contents'></a></h2> <p><strong>Les règles :</strong></p> <ul class="spip" role="list"><li> donner un titre à vos tableaux de données pour décrire brièvement son contenu,</li><li> donner un résumé précisant l'organisation du contenu dans le tableau</li><li> Utiliser des entêtes dans vos tableaux afin de pouvoir y rattacher le contenu des cellules et faciliter la compréhension de son contenu.</li></ul> <p><strong>Les tableaux dans SPIP :</strong></p> <p>SPIP gère nativement les tableaux de données simples organisés verticalement et permet de préciser un titre, un résumé et des entêtes au tableau. Cela ce fait à l'aide de la syntaxe suivante :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>||Légende|Résumé|| | {{Nom}} | {{Date de naissance}} | {{Ville}} | | Jacques | 5/10/1970 | Paris | | Claire | 12/2/1975 | Belfort | | Martin | 1/31/1957 | Nice | | Marie | 23/12/1948 | Perpignan |</code></pre></div> <p><strong>Les problèmes :</strong></p> <p>SPIP ne permet pas de gérer les tableaux de données complexe organisés horizontalement ou verticalement et horizontalement.</p> <p><strong>Les solutions :</strong></p> <p>Il n'existe malheureusement pas à l'heure actuelle de solution à ce problème. La solution la plus simple consiste à faire son tableau au sein d'un éditeur HTML permettant de structurer un tableau de donnée de façon accessible et de coller le code au sein du champ texte de SPIP.</p> <h2 class="h2" id='Navigation'>Navigation<a class='sommaire-back sommaire-back-7' href='#s-Navigation' title='Back to the table of contents'></a></h2> <p><strong>Les règles :</strong></p> <ul class="spip" role="list"><li> avoir des intitulés de liens explicites</li><li> indiquer les ouvertures dans une nouvelle fenêtre, les formats/poids de fichier en téléchargement</li><li> avoir une table de matière quand l'article est long</li></ul> <p><strong>La navigation dans SPIP :</strong></p> <p>SPIP permet dans un article de placer de liens par l'utilisation du raccourci <code class='spip_code spip_code_inline' dir='ltr'>[texte->url]</code>. Il est également possible de définir des ancres <code class='spip_code spip_code_inline' dir='ltr'>[<-monancre]</code> et des infos bulles sur les liens <code class='spip_code spip_code_inline' dir='ltr'>[texte| info bulle->url]</code>. Spip ne permet pas par défaut d'ouvrir des liens dans une nouvelle fenêtre. Enfin Spip ajoute automatiquement le format et le poids dans l'alternative de l'icone des documents insérés dans un article à l'aide <code class='spip_code spip_code_inline' dir='ltr'><docXX></code></p> <p><strong>Les problèmes :</strong></p> <p>Pas de problème en particulier mais il existe néanmoins des solutions facilitant la tache du rédacteur.</p> <p><strong>Les solutions :</strong></p> <ul class="spip" role="list"><li> Utiliser <a href="https://contrib.spip.net/Un-sommaire-pour-vos-articles">la lame sommaire automatique du couteau suisse</a> pour créer automatiquement des sommaires à vos articles</li><li> Utiliser <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/accessibilite" class="spip_out" rel="external">le plugin accessibilité</a> pour ajouter automatiquement les formats et les poids quand un lien vers un document est inséré (attention cela ne traite que les liens vers des fichiers docXX <code class='spip_code spip_code_inline' dir='ltr'>[xxx->docXX]</code> et non les liens vers des urls directes <code class='spip_code spip_code_inline' dir='ltr'>[xxx->http://www.xxx.com/xxx.pdf]</code></li></ul><h2 class="h2" id='Conclusion'>Conclusion<a class='sommaire-back sommaire-back-7' href='#s-Conclusion' title='Back to the table of contents'></a></h2> <p>Vous voilà désormais bien armé pour permettre à vos rédacteurs de produire du contenu accessible ou les aider à le faire.</p></div> <div class='rss_ps'><p>Un article complémentaire vous listant les éléments nécessaire coté squelette devrait suivre dès que <a href='https://contrib.spip.net/_goetsu_' class="spip_in">goetsu</a> aura un moment. D'ici là bonne production de contenu accessible.</p></div> </article> <article> <h1>Accordion JQuery</h1> <p>touti — 2016-02-22T08:00:00Z</p> <div class='rss_chapo'><p>Un plugin qui permet d'activer la librairie Jquery accordion <a href="https://jqueryui.com/accordion/" class="spip_url spip_out auto" rel="nofollow external">https://jqueryui.com/accordion/</a> et de l'utiliser directement dans votre contenu rédactionnel ou même ailleurs comme dans un menu.</p> <p>Obtenez des paragraphes repliables en accordéon avec le raccourci <code class='spip_code spip_code_inline' dir='ltr'><accordeon></code> et les <code class='spip_code spip_code_inline' dir='ltr'>{{{intertitres}}}</code> SPIP.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-6" id="nav6a60d149bb6e28.14645884"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-t1-Prerequis-et-activation-du-plugin"></a><a href="#t1-Prerequis-et-activation-du-plugin" class="spip_ancre">1. Prérequis et activation du plugin</a></li><li> <a id="s-t2-Redigez-votre-texte"></a><a href="#t2-Redigez-votre-texte" class="spip_ancre">2. Rédigez votre texte</a></li><li> <a id="s-Comprendre-le-plugin"></a><a href="#Comprendre-le-plugin" class="spip_ancre">Comprendre le plugin</a></li><li> <a id="s-En-SPIP4"></a><a href="#En-SPIP4" class="spip_ancre">En SPIP4</a></li><li> <a id="s-Pour-aller-plus-loin"></a><a href="#Pour-aller-plus-loin" class="spip_ancre">Pour aller plus loin</a></li><li> <a id="s-Todo"></a><a href="#Todo" class="spip_ancre">Todo</a></li></ul></div><h2 class="h2" id='t1-Prerequis-et-activation-du-plugin'>1. Prérequis et activation du plugin<a class='sommaire-back sommaire-back-6' href='#s-t1-Prerequis-et-activation-du-plugin' title='Back to the table of contents'></a></h2> <p><br />- Ce plugin fonctionne à partir d'un version de SPIP 3.1 pour raisons de compatibilité de version JQuery préchargée. <br />- Activez ce plugin comme tous les plugins SPIP dans l'interface privé. <br />- Il n'y a aucune dépendance, la librairie JQuery et JQueryUI étant préinstallées dans SPIP3.</p> <h2 class="h2" id='t2-Redigez-votre-texte'>2. Rédigez votre texte<a class='sommaire-back sommaire-back-6' href='#s-t2-Redigez-votre-texte' title='Back to the table of contents'></a></h2> <p>Dans le texte d'un article en rédaction, encadrer les intertitres et leurs paragraphes de la balise <code class='spip_code spip_code_inline' dir='ltr'><accordeon></code> comme ceci</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><accordeon> {{{Titre du premier accordéon}}} Voici le contenu du premier accordéon. {{{Titre du deuxième accordéon}}} Voilà le contenu du deuxième accordéon. {{{Titre du troisième accordéon}}} <div> Et le contenu du troisième accordéon avec des paragraphes et/ou des images. </div> </accordeon></code></pre></div> <p>Le rendu de l'accordeon</p> <div class='spip_document_13319 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p><strong>En dehors d'un contenu SPIP, dans une FAQ par exemple</strong></p> <p>Respecter l'écriture suivante pour ouvrir les blocs qui suivent chaque titre h3 cliquable</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><div class="spip_accordeon"> <h3>Titre du premier accordéon</h3> Voici le contenu du premier accordéon. <h3>Titre du deuxième accordéon</h3> Voilà le contenu du deuxième accordéon. etc </div></code></pre></div><h2 class="h2" id='Comprendre-le-plugin'>Comprendre le plugin<a class='sommaire-back sommaire-back-6' href='#s-Comprendre-le-plugin' title='Back to the table of contents'></a></h2> <p>Merci à Arno* qui m'a mis sur la voie du Yaml très simple de TextWheel pour traiter le raccourci <code class='spip_code spip_code_inline' dir='ltr'><accordeon></code> qui génére un <br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'><div class="spip_accordeon"></code> pris en compte par le javascript.<br class='autobr' /> <a href="https://git.spip.net/spip-contrib-extensions/accordion/src/branch/master/wheels/accordeon.yaml" class="spip_url spip_out auto" rel="nofollow external">https://git.spip.net/spip-contrib-extensions/accordion/src/branch/master/wheels/accordeon.yaml</a></p> <p>Le plugin utilise également le pipeline de chargement des effets UI de JQuery “jqueryui_plugins” très simple d'usage une fois déclaré dans le paquet.xml</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>function accordion_jqueryui_plugins($plugins){ $plugins[] = "jquery.ui.accordion"; return $plugins; }</code></pre></div><h2 class="h2" id='En-SPIP4'>En SPIP4<a class='sommaire-back sommaire-back-6' href='#s-En-SPIP4' title='Back to the table of contents'></a></h2> <p>SPIP4 ne chargeant plus jquery_ui, il faut télécharger le plugin jquery_ui <a href="https://git.spip.net/spip/jquery_ui.git" class="spip_url spip_out auto" rel="nofollow external">https://git.spip.net/spip/jquery_ui.git</a> et l'installer si celui-ci ne s'installe pas automatiquement.</p> <h2 class="h2" id='Pour-aller-plus-loin'>Pour aller plus loin<a class='sommaire-back sommaire-back-6' href='#s-Pour-aller-plus-loin' title='Back to the table of contents'></a></h2> <p>Les options de la librairie JQuery UI Accordion sont sur <a href="https://jqueryui.com/accordion/" class="spip_url spip_out auto" rel="nofollow external">https://jqueryui.com/accordion/</a></p> <p>On peut utiliser accordion JQuery où l'on veut, dans son propre dossier de squelettes, il suffit de dupliquer <code class='spip_code spip_code_inline' dir='ltr'>javascript/spip_accordion.js</code> et de réécrire les options du fichier js.</p> <h2 class="h2" id='Todo'>Todo<a class='sommaire-back sommaire-back-6' href='#s-Todo' title='Back to the table of contents'></a></h2> <p>Modifier le yaml pour qu'il n'y ait plus à ajouter à la main un div juste après un intertitre si l'on souhaite paragrapher ou insérer des images dans les soufflets de l'accordéon.</p></div> </article> <article> <h1>ACS plugin</h1> <p>Daniel FAIVRE — 2008-07-27T20:24:00Z</p> <div class='rss_chapo'><p>ACS is a Spip plugin to configure quickly some components-based Spip skeletons sets</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d149bff468.76480185"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-ACS-for-webmaster"></a><a href="#ACS-for-webmaster" class="spip_ancre">ACS for webmaster</a></li><li> <a id="s-ACS-for-Spip-skeletons-developpers"></a><a href="#ACS-for-Spip-skeletons-developpers" class="spip_ancre">ACS for Spip skeletons developpers</a></li><li> <a id="s-Improve-existing-component"></a><a href="#Improve-existing-component" class="spip_ancre">Improve existing component</a></li><li> <a id="s-Contribute"></a><a href="#Contribute" class="spip_ancre">Contribute</a></li></ul></div><p>ACS is a Spip plugin to configure quickly some skeletons sets from a “click-playground” of the Spip site private area.</p> <p>- For projects managers, ACS simplifies tasks sharing between developpers, web-designers, and webmasters: a web-designer is not supposed to be a skeleton specialist.</p> <p>- For developers, ACS provides an Application Programming Interface (API) to create new components and/or include existing components to their skeletons.</p> <p>- For web-designers, ACS helps set a web-design much more quickly, in total independence from Spip skeletons developers.</p> <p>ACS components are multi-languages compliant. Here are samples of some available components:</p> <div class='spip_document_5777 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="18" data-legende-lenx="" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-5777 '><strong>Agenda component </strong></div> </figcaption></figure> </div> <div class='spip_document_5778 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="45" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-5778 '><strong>Audio playlist component </strong></div> <div class='spip_doc_descriptif crayon document-descriptif-5778 '>Administration GUI </div> </figcaption></figure> </div><h2 class="h2" id='ACS-for-webmaster'>ACS for webmaster<a class='sommaire-back sommaire-back-4' href='#s-ACS-for-webmaster' title='Back to the table of contents'></a></h2> <p>To be directly usable by non-Spip-experts webmasters, ACS distribution include sets of highly configurable ready-to-use skeletons sets, like the Cat model (Components catalog).</p> <p>When plugin ACS downloaded, installed, activated, and configured, webmaster (and other authorized ACS administrators) can go to a new menu choice in the Spip <strong>Configuration</strong> menu: sub-menu “<strong>Configure website</strong>”.</p> <div class='spip_document_5779 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="51" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/jpg/acs_pages_0_4en.jpg' class="spip_doc_lien mediabox" type="image/jpeg"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-5779 '><strong>ACS admin </strong></div> <div class='spip_doc_descriptif crayon document-descriptif-5779 '>Graphic User Interface, ACS version 0.4 </div> </figcaption></figure> </div> <p>The simplest way to begin ? Go to <strong>Components</strong> pane and configure desired components of active ACS model.</p> <p>In the Cat model<span class="spip_note_ref"> [<a href="#nb19-1" class="spip_note" rel="appendix" title="ACS uses models, which are sets of skeletons elements and dependencies. Cat (…)" id="nh19-1">1</a>]</span>, as sample, configuring the <strong>Fond</strong> (background) component is enough to set default values for whole website, and configuring the <strong>Onglets</strong> (panes) component is enough to activate default values for the built-in navigation menu panes.</p> <h2 class="h2" id='ACS-for-Spip-skeletons-developpers'>ACS for Spip skeletons developpers<a class='sommaire-back sommaire-back-4' href='#s-ACS-for-Spip-skeletons-developpers' title='Back to the table of contents'></a></h2> <p>ACS fit with any Spip skeleton, in which you can embed your own components and/or some existing components from active ACS model<span class="spip_note_ref"> [<a href="#nb19-2" class="spip_note" rel="appendix" title="Active ACS model: choose it in ACS administration GUI : Spip private area, (…)" id="nh19-2">2</a>]</span>.</p> <h2 class="h2" id='Improve-existing-component'>Improve existing component<a class='sommaire-back sommaire-back-4' href='#s-Improve-existing-component' title='Back to the table of contents'></a></h2> <p>ACS uses Spip override system for components: components included in skeleton(s) set(s) choosen on ACS administration pane overrides same-named components from active ACS model.</p> <p>To develop new components as to customize an existing one, define a skeleton directory with a <strong>composants</strong> sub-directory that contain only new created components. ACS can define several levels for override: you can properly and easily isolate downloaded skeletons elements from customized elements. (So, it's NOT useful, and discouraged, to directly modify components in the plugin distribution directories)</p> <h2 class="h2" id='Contribute'>Contribute<a class='sommaire-back sommaire-back-4' href='#s-Contribute' title='Back to the table of contents'></a></h2> <p>ACS plugin will fit more and more requirements as many contributors helps enhance the ACS models choices.</p> <p>Repository is the Spip-zone one. A community website is now available, powered by the ACS-development version, with documentation, FAQ, downloads urls, ...</p></div> <hr /> <div class='rss_notes'><div id="nb19-1"> <p><span class="spip_note_ref">[<a href="#nh19-1" class="spip_note" title="Footnotes 19-1" rev="appendix">1</a>] </span>ACS uses models, which are sets of skeletons elements and dependencies. Cat is a special one: a components catalog, highly configurable.</p> </div><div id="nb19-2"> <p><span class="spip_note_ref">[<a href="#nh19-2" class="spip_note" title="Footnotes 19-2" rev="appendix">2</a>] </span>Active ACS model: choose it in ACS administration GUI : Spip private area, Configuration menu, Configure website submenu, Administration pane</p> </div></div> <div class='rss_ps'><p>Genuine documentation: <a href='https://contrib.spip.net/acs.geomaticien.org'>here</a>.</p></div> </article> <article> <h1>Activite éditoriale</h1> <p>chankalan, Maïeul, Nicolas Hoizey, scaron — 2010-05-18T19:23:50Z</p> <div class='rss_chapo'><p>Un site, c'est bien !</p> <p>Un site à jour, c'est mieux !</p> <p>Pour un site qui n'est pas d'«actualité», il arrive fréquemment que les administrateurs oublient de le mettre à jour. Ce plugin permet de rappeler régulièrement, par courriel, de mettre à jour certaines rubriques du site.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-5" id="nav6a60d149c34817.96701068"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Fonctionnement"></a><a href="#Fonctionnement" class="spip_ancre">Fonctionnement</a></li><li> <a id="s-Signaler-quelle-rubrique-doit-etre-mise-a-jour-frequemment"></a><a href="#Signaler-quelle-rubrique-doit-etre-mise-a-jour-frequemment" class="spip_ancre">Signaler quelle rubrique doit être mise à jour fréquemment</a></li><li> <a id="s-Recapitulatif-des-rubriques-non-a-jour"></a><a href="#Recapitulatif-des-rubriques-non-a-jour" class="spip_ancre">Récapitulatif des rubriques non à jour</a></li><li> <a id="s-Auteur-et-Licence"></a><a href="#Auteur-et-Licence" class="spip_ancre">Auteur et Licence</a></li></ul></div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-5' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Le plugin s'installe comme n'importe quel plugin. Il nécessite le plugin <a href='https://contrib.spip.net/Champs-Extras-2' class="spip_in" hreflang="fr">Champs Extra 2</a>.</p> <p>Pour un réglage avancé il nécessite <a href='https://contrib.spip.net/cfg-references' class="spip_in" hreflang="fr">CFG</a> sous SPIP 2 et 2.1. En revanche nul besoin sous SPIP 3.</p> <h2 class="h2" id='Fonctionnement'>Fonctionnement<a class='sommaire-back sommaire-back-5' href='#s-Fonctionnement' title='Back to the table of contents'></a></h2> <p>Après l'installation, allez dans la page de configuration (via “Configuration”->“CFG”).</p> <p>Choisissez sur quel champ le plugin calcule la mise à jour d'une rubrique :</p> <ul class="spip" role="list"><li> Réglage par défaut : champ «maj» de la <i>rubrique</i>. Ce champ n'est mis à jour que si un des champs (titre, descriptif, texte) de la rubrique a été mis à jour.</li><li> Champ «date_modif» des articles de la <i>branche</i>. Dès qu'un article (ou une brève) de la branche (= rubrique et ensemble des sous-rubriques, des sous-sous-rubriques etc.) est mis à jour, ce champ est mis à jour.</li><li> Champ «date_modif» des articles de la <i>rubrique</i>. Dès qu'un article (ou une brève) de la rubrique est mis à jour, ce champ est mis à jour.</li></ul><h2 class="h2" id='Signaler-quelle-rubrique-doit-etre-mise-a-jour-frequemment'>Signaler quelle rubrique doit être mise à jour fréquemment<a class='sommaire-back sommaire-back-5' href='#s-Signaler-quelle-rubrique-doit-etre-mise-a-jour-frequemment' title='Back to the table of contents'></a></h2> <p>Se rendre sur le formulaire d'édition de la rubrique. Deux nouveaux champs sont apparus :</p> <ul class="spip" role="list"><li> Dans « Identifiants des auteurs à alerter », mettre les auteurs qui seront avertis par mail si la rubrique n'a pas été mise à jour régulièrement. Pour cela, mettre les id (les numéros) de ces auteurs, séparés par des virgules. Depuis la version 0.4, on peut mettre aussi des courriels.</li><li> Dans « Délai », mettre la fréquence, en jour(s), à laquelle la rubrique doit être actualisée.</li></ul> <p>Si la rubrique n'a pas été mise à jour au bout du délai imparti, les auteurs signalés recevront un courriel. Si la rubrique est mise à jour (selon les critères définis dans la configuration du plugin), alors le décompte repart à zéro.</p> <h2 class="h2" id='Recapitulatif-des-rubriques-non-a-jour'>Récapitulatif des rubriques non à jour<a class='sommaire-back sommaire-back-5' href='#s-Recapitulatif-des-rubriques-non-a-jour' title='Back to the table of contents'></a></h2> <p>En vous rendant sur “Édition”->“Activité éditoriale” vous arriverez sur une liste indiquant la liste des rubriques non à jour.</p> <h2 class="h2" id='Auteur-et-Licence'>Auteur et Licence<a class='sommaire-back sommaire-back-5' href='#s-Auteur-et-Licence' title='Back to the table of contents'></a></h2> <p>Développement original : Stéphanie Caron.<br class='manualbr' />Amélioration : Maïeul Rouquette<br class='manualbr' />Licence GPL (développé sur la SPIP-Zone).</p></div> </article> <article> <h1>Activité principale (APE) et Nomenclature d'activité française (NAF)</h1> <p>Thrax — 2024-10-15T22:11:48Z</p> <div class='rss_chapo'><p>Ce plugin propose une liste des codes APE (<i>a</i>ctivité <i>p</i>rincipal<i>e</i>) et NAF (<i>n</i>omenclature d'<i>a</i>ctivité <i>f</i>rançaise). Il est accompagné d'une saisie, d'une vérification, et de fonctions pour mettre à jour la liste.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-3" id="nav6a60d149c60859.95573089"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Configuration"></a><a href="#Configuration" class="spip_ancre">Configuration</a></li><li> <a id="s-Utilisations"></a><a href="#Utilisations" class="spip_ancre">Utilisations</a></li></ul></div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-3' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Pas de dépendance : le plugin ne nécessite aucun autre plugin.<br class='autobr' /> Reconnaissance : le plugin utilise, s'ils sont actifs, <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">Saisies pour formulaires</a> et <a href='https://contrib.spip.net/Verifier' class="spip_in" hreflang="fr">Vérifier</a>.</p> <h2 class="h2" id='Configuration'>Configuration<a class='sommaire-back sommaire-back-3' href='#s-Configuration' title='Back to the table of contents'></a></h2> <p>Le plugin ne nécessite aucune configuration. Il contient une démonstration.</p> <h2 class="h2" id='Utilisations'>Utilisations<a class='sommaire-back sommaire-back-3' href='#s-Utilisations' title='Back to the table of contents'></a></h2><h5 class="h5"> Les fonctions pour la gestion de la base de données des codes</h5> <p>Une API est disponible dans le répertoire /inc du plugin. Elle permet de gérer les codes stocker dans un fichier json (voir le répertoire de SPIP <code class='spip_code spip_code_inline' dir='ltr'>local/cache-json</code>)</p> <p>Exemples d'utilisation :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>include_spip('inc/ape_naf'); // avoir le libellé du code 0520Z print_r(lire_ape_naf('0520Z',['libelle' => ''])); // avoir tous les codes et libellés print_r(lire_ape_naf('*',['libelle' => 'avec_code'])); </code></pre></div> <p>La fonction <code class='spip_code spip_code_inline' dir='ltr'>lire_ape_naf(string $valeur, ?array $options = [])</code> lit le fichier en local stockant les codes à la recherche d'une valeur ou des valeurs. La valeur est précisée dans la variable <code class='spip_code spip_code_inline' dir='ltr'>$valeurs</code>. Elle peut être soit un code, soit le signe <code class='spip_code spip_code_inline' dir='ltr'>*</code>. La fonction retournera alors soit le libellé soit le code accompagné du libellé, selon les <code class='spip_code spip_code_inline' dir='ltr'>$options</code> précisées, soit l'ensemble des valeurs possibles.</p> <h5 class="h5"> Une gestion périodique des tâches permet de réactualiser la liste des codes.</h5> <p>Une gestion périodique des tâches (Cron), permet de réactualiser le fichier avec une API afin qu'il détienne les derniers codes en vigueur (voir le pipeline <code class='spip_code spip_code_inline' dir='ltr'>taches_generales_cron</code> et le fichier <code class='spip_code spip_code_inline' dir='ltr'>genie/ape_naf_actualisation.php</code>).</p> <h4 class="h4"> Renouvellement manuel de la liste</h4> <p>Pour des usages avancées, la fonction <code class='spip_code spip_code_inline' dir='ltr'>creer_ape_naf(int $jours)</code> renouvelle ou crée le répertoire des codes APE et NAF. La variable <code class='spip_code spip_code_inline' dir='ltr'>$jours</code> précise les jours d'ancienneté du fichier avant qu'il ne soit considéré comme obsolète. Avec 100, si le fichier en local stockant les codes à plus de 100 jours, il sera renouvelé en allant chercher les valeurs sur une API externe.</p> <h5 class="h5"> La saisie <code class='spip_code spip_code_inline' dir='ltr'>ape_naf</code> pour sélectionner un code</h5> <p>Lorsque le plugin <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">Saisies pour formulaires</a> est actif, une nouvelle saisie peut être utilisée et est dénommée <code class='spip_code spip_code_inline' dir='ltr'>ape_naf</code>. Il s'agit d'un sélecteur regroupant les codes et leurs libellés.</p> <p>Exemple d'utilisation de la saisie:</p> <div class='spip_document_23011 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/ape_naf_saisie.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div><h5 class="h5"> La vérification <code class='spip_code spip_code_inline' dir='ltr'>ape_naf</code> pour vérifier la conformité d'un code</h5> <p>Lorsque le plugin <a href='https://contrib.spip.net/Verifier' class="spip_in" hreflang="fr">Vérifier</a> est actif, une nouvelle vérification est utilisable, dénommée simplement <code class='spip_code spip_code_inline' dir='ltr'>ape_naf</code>. Elle permet de vérifier une valeur et de la normaliser si nécessaire.</p></div> </article> <article> <h1>Adaptive Images</h1> <p>Cerdic — 2013-11-15T08:39:15Z</p> <div class='rss_chapo'><p>Un plugin pour permettre aux sites <i lang="en">responsive</i> d'adapter automatiquement les images de la page à l'écran de consultation.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-7" id="nav6a60d149caaa88.27764812"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Mise-en-place"></a><a href="#Mise-en-place" class="spip_ancre">Mise en place</a></li><li> <a id="s-Optimisation"></a><a href="#Optimisation" class="spip_ancre">Optimisation</a></li><li> <a id="s-Personnalisation"></a><a href="#Personnalisation" class="spip_ancre">Personnalisation</a></li><li> <a id="s-Variante-d-image-pour-petits-ecrans"></a><a href="#Variante-d-image-pour-petits-ecrans" class="spip_ancre">Variante d'image pour petits écrans</a></li><li> <a id="s-Classes-specifiques-au-plugin"></a><a href="#Classes-specifiques-au-plugin" class="spip_ancre">Classes spécifiques au plugin</a></li><li> <a id="s-Utilisation-avancee-dans-les-squelettes"></a><a href="#Utilisation-avancee-dans-les-squelettes" class="spip_ancre">Utilisation avancée dans les squelettes</a></li><li> <a id="s-Les-autres-reglages-moins-utiles"></a><a href="#Les-autres-reglages-moins-utiles" class="spip_ancre">Les autres réglages (moins utiles)</a></li></ul></div><p><i lang="en">Adaptive Images</i>, que l'on pourrait traduire par Images adaptatives, désigne la pratique qui vise à adapter les taille, résolution et qualité des images utilisées dans une page web en fonction de l'utilisateur.</p> <p>Les images adaptatives sont nécessaires pour les sites <i lang="en">responsive</i> qui vont adapter leur affichage au périphérique de consultation<span class="spip_note_ref"> [<a href="#nb20-1" class="spip_note" rel="appendix" title="on parle de device en anglais" id="nh20-1">1</a>]</span> : sur un site <i lang="en">responsive</i> la même page est rendue de manière différente selon la taille de l'écran.</p> <p>Il y a 4 raisons d'adapter l'image envoyée à l'utilisateur :</p> <ul class="spip" role="list"><li> la taille de l'écran (inutile d'envoyer une image de 1000px de large sur un téléphone qui affiche la page en 320px de large) ;</li><li> la résolution de l'écran (écrans de haute densité, capables d'afficher plus de pixels par pouce qu'un écran habituel) ;</li><li> la qualité de la connexion internet (notamment en mobilité) ;</li><li> le contenu éditorial (une image affichée en petit peut devenir illisible et il est alors préférable de la recadrer).</li></ul> <p>Adapter les images vise donc à améliorer l'expérience utilisateur, en lui délivrant l'image qui convient le mieux à son usage.</p> <p><a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/picture" class="spip_out" rel="external"><strong>HTML5 propose un markup spécifique</strong></a> pour permettre au navigateur de savoir quelle image charger, composé de plusieurs éléments : une balise <code class='spip_code spip_code_inline' dir='ltr'></code>, une balise <code class='spip_code spip_code_inline' dir='ltr'></code> et des attributs <code class='spip_code spip_code_inline' dir='ltr'>srcset</code> et <code class='spip_code spip_code_inline' dir='ltr'>sizes</code>.<span class="spip_note_ref"> [<a href="#nb20-2" class="spip_note" rel="appendix" title="Cf. aussi et pour un aperçu de leur usage" id="nh20-2">2</a>]</span>.</p> <p>Cependant la génération de ce markup est assez complexe dès lors qu'on veut commencer à gérer tous les cas, et nécessite la génération d'un certain nombre de variantes d'images.</p> <p>De plus le support n'est pas universel, les plus anciens navigateurs ne prennent pas en charge ce markup et doivent être gérés. <br class='autobr' /> A cet effet le plugin offre aussi historiquement l'implémentation d'une technique alternative, <a href="http://blog.nursit.net/37" class="spip_out" rel="external"><strong>la technique des 3 couches</strong></a> basée sur HTML/CSS/JS, qui peut être utilisée pour supporter les navigateurs plus anciens supportant seulement les media-queries<span class="spip_note_ref"> [<a href="#nb20-3" class="spip_note" rel="appendix" title="dans tous les cas IE est exclu du support" id="nh20-3">3</a>]</span>.<br class='autobr' /> <span class="spip_note_ref"> [<a href="#nb20-4" class="spip_note" rel="appendix" title="Cette technique requiert un markup un peu compliqué mais elle a quelques (…)" id="nh20-4">4</a>]</span></p> <p><strong>Ce plugin a donc pour objet d'automatiser la prise en charge des images adaptives</strong>, via l'une ou l'autre des 2 techniques disponibles. Le choix de la technique utilisé est normalement transparent, les 2 markups générés ressemblant beaucoup l'un à l'autre.</p> <div class='notice'> L'utilisation du plugin Adaptive Images n'a de sens que si on veut servir à la fois de grandes images de haute résolution pour les tablettes et desktop, sans pénaliser pour autant les smartphones à petits écrans.<br class='manualbr' />Si les plus grandes images dont on dispose ont des dimensions de l'ordre de 640px, il sera aussi rapide et bien plus simple de servir ces images pour tous les utilisateurs sans recourir à ce plugin. </div><h2 class="h2" id='Mise-en-place'>Mise en place<a class='sommaire-back sommaire-back-7' href='#s-Mise-en-place' title='Back to the table of contents'></a></h2> <p>Il suffit d'installer et activer le plugin pour qu'il prenne immédiatement en charge toutes les images du site.</p> <p>Par défaut le plugin va intercepter toutes les pages HTML, et agir sur toutes les images plus larges que 320px et les adapter à l'utilisateur :</p> <ul class="spip" role="list"><li> adaptation à la largeur de l'écran, en supposant une largeur maximale affichée de 640px dans tous les cas ;</li><li> adaptation à la résolution de l'écran en envoyant une image 1.5x ou 2x ;</li><li> génération d'un aperçu de basse qualité visible pendant le chargement de l'image de haute qualité</li><li> adaptation à la qualité de la connexion, et pas d'image 1.5x ou 2x si mauvaise connexion<span class="spip_note_ref"> [<a href="#nb20-5" class="spip_note" rel="appendix" title="uniquement avec la technique des 3 couches et javascript activé" id="nh20-5">5</a>]</span><small class="fine d-inline"> </small>;</li><li> adaptation du contenu : possibilité de fournir une version recadrée de l'image pour les petits écrans mobiles.</li></ul> <p><strong>Limitations</strong></p> <p>Avec la technique des 3 couches :</p> <ul class="spip" role="list"><li> Le plugin ne fournit pas d'image adaptée dans Internet Explorer<10.</li><li> Les périphériques Androïd 2.x sans JavaScript risquent de charger plusieurs versions de la même image. Mais ce devrait être un cas très rare.</li></ul> <p>Avec la technique HTML5 <code class='spip_code spip_code_inline' dir='ltr'>srcset + </code> :</p> <ul class="spip" role="list"><li> Le plugin <a href="https://caniuse.com/#feat=srcset" class="spip_out" rel="external">nécessite les versions récentes de Edge, Chrome, Safari ou Firefox</a> pour utiliser le markup HTML5</li><li> La qualité de connexion n'est pas prise en compte avec cette technique, et les mobiles peuvent se retrouver à charger des images HD à cause de leur qualité d'écran malgré un faible débit</li></ul><h2 class="h2" id='Optimisation'>Optimisation<a class='sommaire-back sommaire-back-7' href='#s-Optimisation' title='Back to the table of contents'></a></h2> <p>Certains squelettes, notamment <tt>squelettes-dist/</tt> fourni avec SPIP, appliquent automatiquement un filtre <code class='spip_code spip_code_inline' dir='ltr'>|image_reduire</code> sur tous les contenus éditoriaux, comme par exemple :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#TEXTE|image_reduire{500})] </code></pre></div> <p>Dans ce cas le plugin ne pourra pas bien faire son travail, car la taille maximale dont il dispose pour l'image est de 500px. Il <strong>faut</strong> supprimer ces filtres, et essayer de toujours conserver la taille d'image maximale dans le code source.</p> <p>Pour limiter la taille affichée, <strong>il faut utiliser le filtre <code class='spip_code spip_code_inline' dir='ltr'>|adaptive_images</code></strong> fourni par le plugin, qui permettra la mise en cache des images adaptées (ce qui est plus écologique et permettra à votre site d'être plus rapide) :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#TEXTE|adaptive_images{640})] </code></pre></div> <p>L'argument fourni est la largeur maximale dans laquelle l'image est affichée tous écrans confondus. Ici on met 640 px comme largeur maximale d'affichage, ce qui veut dire que le plugin sera susceptible d'envoyer une image en 1280px de large pour les écrans Retina (si l'image d'origine est assez grande).</p> <p>Si vous ne mettez pas d'argument c'est la valeur par défaut qui est utilisée, qui est personnalisable comme indiqué ci-dessous.</p> <h2 class="h2" id='Personnalisation'>Personnalisation<a class='sommaire-back sommaire-back-7' href='#s-Personnalisation' title='Back to the table of contents'></a></h2> <p>Il est possible de personnaliser un certain nombre de réglages du plugin via la page de configuration du plugin, si les réglages par défauts, aussi génériques que possibles, ne vous conviennent pas.</p> <p>Attention, évolution sur la config par defaut, comme signalé sur la forge <a href="https://git.spip.net/spip-contrib-extensions/adaptive_images/-/work_items/14#note_151083" class="spip_out" rel="external">GIT.spip.net</a></p> <blockquote class="spip"> <p>tout ça pour dire que les valeurs par défaut de config du plugin sont vraiment des “par défaut” qui devraient jamais rester telles quelles...<br class='autobr' /> Mais donc si il faut vraiment du par défaut je mettrais :</p> </blockquote><div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>Largeur max. des images adaptées (px) : 1440 Largeur max. de la version mobile (px) : 480 Largeur min. pour adapter (px) : 480 Poids min. pour adapter (ko) : 20 Breakpoints pour les variantes d'image : 480,720,960,1440 --- Largeur de l'aperçu (px) : 48 Qualité de l'aperçu : 30 </code></pre></div> <p>En pratique il y a très peu de choses à personnaliser : si vous avez besoin d'une largeur maximale supérieure à 640px, le mieux est d'appliquer le filtre <code class='spip_code spip_code_inline' dir='ltr'>|adaptive_images</code> avec la bonne valeur, comme indiqué ci-dessus. <br class='autobr' /> Une fois l'image adaptée à la bonne largeur, elle ne sera plus modifiée ensuite.</p> <div class='spip_document_12140 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/config-adaptive-images.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p><strong>Markup généré</strong><br class='manualbr' />Vous pouvez choisir entre la méthode des 3 couches et la méthode HTML5, donc</p> <p><strong>Couleur de fond</strong><br class='manualbr' />Si jamais votre site utilise un fond de couleur foncé (noir ou autre), il peut alors être utile de personnaliser cette couleur utilisée quand l'aperçu au format JPG est produit à partir d'une image PNG ou GIF qui utilise la transparence.</p> <p><strong>Largeur maximale affichée pour les images adaptées</strong><br class='manualbr' />Cette valeur permet de définir la largeur maximale affichée des images. Il faut éventuellement l'adapter à votre site, en fonction de la largeur maximale de la zone de contenu dans les différentes tailles d'écran.</p> <p><strong>Largeur maximale de la version mobile</strong><br class='manualbr' />Permet de définir la largeur maximale pour laquelle la version mobile —si elle existe— est utilisée. Par défaut c'est 320px : quand l'image est affichée en 320px ou moins de large, on utilise la version recadrée pour les mobiles, sinon la version complète de l'image. <strong>On recommande plutôt d'utiliser 480px</strong></p> <p><strong>Largeur minimale pour adapter</strong><br class='manualbr' />Permet de définir la largeur minimale des images qui seront adaptées à l'utilisateur. Les images plus petites seront laissées telles quelles et identiques pour tout le monde. <strong>On recommande d'utiliser 480px</strong></p> <p><strong>Poids minimal pour adapter</strong><br class='manualbr' />Permet de définir le poids minimal des images qui seront adaptées à l'utilisateur. Les images plus légères seront laissées telles quelles et identiques pour tout le monde, car générer une image adaptée augmenterait le poids total téléchargé.</p> <p><strong><i lang="en">Breakpoints</i></strong><br class='manualbr' />Permet de définir les <i lang="en">breakpoints</i> pour lesquels on produit des variantes d'image. Indiquez une liste de largeur en px, séparés par une virgule, dans l'ordre croissant. Les valeurs par défaut sont calées sur des multiples de 160px.</p> <p><strong>Production des images à la demande</strong><a id="htaccess"></a><br class='manualbr' />Par défaut, le plugin fabrique toutes les variantes d'images au calcul de la page. Si vous avez beaucoup de grosses images dans vos pages, cela peut provoquer des <i lang="en">timeout</i> et vous obliger à recharger la page plusieurs fois.</p> <p>Cette option permet de fabriquer chaque variante d'image adaptée lorsqu'elle est demandée pour la première fois par un utilisateur.<br class='manualbr' />Pour l'utiliser il faut ajouter les lignes suivantes dans votre fichier <tt>.htaccess</tt>, après la partie qui vérifie l'existence du fichier, c'est-à-dire juste avant la section <code class='spip_code spip_code_inline' dir='ltr'># URLs "propres", "propres2", "libres", "arbo"</code><span class="spip_note_ref"> [<a href="#nb20-6" class="spip_note" rel="appendix" title="C'est normalement le cas par défaut sur SPIP 3.1 et versions plus récentes" id="nh20-6">6</a>]</span> :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>### # Adaptive Images RewriteRule \badapt-img/(\d+/\d\dx/.*)$ spip.php?action=adapt_img&arg=$1 [QSA,L] # Fin des Adaptive Images ### </code></pre></div> <p><strong>Compression JPG</strong><br class='manualbr' />Vous pouvez définir la qualité de la compression des images JPG utilisées pour les différents affichages : Image 1x, image 1.5x, image 2x.</p> <p><strong>Génération de l'image d'aperçu</strong><br class='manualbr' />Le plugin propose plusieurs méthodes pour générer un aperçu visible pendant que l'image de bonne qualité se charge (cf <a href="https://jmperezperez.com/svg-placeholders/" class="spip_url spip_out auto" rel="nofollow external">https://jmperezperez.com/svg-placeholders/</a> et <a href="https://seenthis.net/messages/645575" class="spip_url spip_out auto" rel="nofollow external">https://seenthis.net/messages/645575</a> sur les méthodes proposées) :</p> <ul class="spip" role="list"><li> <i>Fond dégradé horizontal+vertical</i> : c'est le plus léger, composé de 2 gradients croisés et superposés, donne juste une vague idée de la couleur de l'image</li><li> <i>Image basse définition floutée</i> : c'est une méthode assez courante. Le plugin génère une toute petite image, très légère, et l'affiche en grand format en la floutant. Vous pouvez régler la largeur de la vignette générée (128px par défaut) et la qualité utilisée pour la compression JPG (40 par défaut)<span class="spip_note_ref"> [<a href="#nb20-7" class="spip_note" rel="appendix" title="Ce sont des valeurs de base autour desquelles e plugin pourra varier de +/- (…)" id="nh20-7">7</a>]</span>. Attention, l'image générée est embarquée dans la page, il faut donc qu'elle reste très légère.</li><li> <i>Tracé d'un contour issu de l'image</i> : le plugin va créer un tracé vectoriel à partir de l'image, pour avoir une forme monochrome la représentant</li><li> <i>Géométrization de l'image</i> : calcul d'une approximation géometrique de basse qualité à l'aide de quelques dizaines de triangles[[utilise la librairie PHP <a href="https://github.com/Cerdic/geometrize-php/" class="spip_url spip_out auto" rel="nofollow external">https://github.com/Cerdic/geometrize-php/</a>]</li></ul> <p>Pour faire votre choix, ou ajuster les réglages, vous cocher l'option <i>Activer le debug (les aperçus apparaissent au survol de l'image)</i>. Dans ce cas, au survol de la souris sur une image adaptée, l'image de bonne qualité disparait et l'aperçu de basse qualité est visible. C'est un outil de développement, pensez à décocher quand vous avez fini !</p> <h2 class="h2" id='Variante-d-image-pour-petits-ecrans'>Variante d'image pour petits écrans<a class='sommaire-back sommaire-back-7' href='#s-Variante-d-image-pour-petits-ecrans' title='Back to the table of contents'></a></h2> <p>Le plugin permet également de joindre à chaque image une variante pour mobiles. Pour cela il suffit de modifier l'image dans l'espace privé de SPIP, et de joindre la version recadrée dans le cartouche du bas intitulé <q>Version mobile</q> :</p> <div class='spip_document_12065 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/adaptive-images-upload-1.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>À noter que pour pouvoir fournir une version haute résolution aux écrans de type Retina, il convient de fournir une image dont la largeur minimale est au moins 2x la valeur de la configuration pour la largeur maximum de la version mobile. L'interface indique la largeur minimum attendue, ici 640px donc.</p> <p>Si la variante que vous ajoutez ne respecte pas ces proportions, un message d'avertissement vous le signalera accompagné d'une suggestion de dimensions :</p> <div class='spip_document_12090 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/adaptive-images-upload-2.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p><i>Si vous utilisez la méthode HTML5</i>, vous pouvez conserver une version mobile avec des proportions différentes.<br class='manualbr' /><i>Si vous utilisez la méthode des 3 couches</i>, le rendu risque d'être déformé, et il est fortement conseillé que la variante pour petits écrans aie les mêmes proportions que l'image principale.</p> <p>Si vous voulez spécifier une variante mobile d'une image insérée par votre squelette ou autrement que par le contenu éditorial de SPIP, il suffit de préciser le chemin de l'image dans un attribut <code class='spip_code spip_code_inline' dir='ltr'>data-src-mobile</code> :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> </code></pre></div> <p>Le plugin repèrera automatiquement l'attribut et utilisera cette variante pour les mobiles.</p> <h2 class="h2" id='Classes-specifiques-au-plugin'>Classes spécifiques au plugin<a class='sommaire-back sommaire-back-7' href='#s-Classes-specifiques-au-plugin' title='Back to the table of contents'></a></h2> <p>Le plugin utilise quelques classes dont vous pouvez avoir besoin dans vos feuilles CSS.</p> <p>Les images adaptées ont une classe <code class='spip_code spip_code_inline' dir='ltr'>adapt-img</code> et sont encapsulées dans un wrapper avec la classe <code class='spip_code spip_code_inline' dir='ltr'>adapt-img-wrapper</code>. Si par exemple vous voulez mettre des coins arrondis sur vos images, il faudra aussi les appliquer sur <code class='spip_code spip_code_inline' dir='ltr'>.adapt-img-wrapper</code> :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>img,.adapt-img-wrapper { border-radius:5px; } </code></pre></div> <p>Les images fournies à Internet Explorer < 10 ont aussi une classe spécifique <code class='spip_code spip_code_inline' dir='ltr'>adapt-img-ie</code>.</p> <p>Il est possible de demander de ne pas appliquer Adaptive Images sur certaines images en leur ajoutant la class <code class='spip_code spip_code_inline' dir='ltr'>no-adapt-img</code>.</p> <h2 class="h2" id='Utilisation-avancee-dans-les-squelettes'>Utilisation avancée dans les squelettes<a class='sommaire-back sommaire-back-7' href='#s-Utilisation-avancee-dans-les-squelettes' title='Back to the table of contents'></a></h2> <p><strong>Une image plus grande sur la <i lang="en">home</i></strong></p> <p>Certaines pages peuvent contenir une image plus large que dans le reste du site. Par exemple votre contenu ne dépasse jamais 640px de large, mais sur la page d'accueil du site vous avez une image en 960px de large sur les grands écrans.</p> <p>Pour traiter ce cas il suffit de lui appliquer le filtre <code class='spip_code spip_code_inline' dir='ltr'>|adaptive_images</code> avec la largeur adaptée :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#FICHIER|balise_img|adaptive_images{960})] </code></pre></div> <p><strong>Des <i lang="en">breakpoints</i> spécifiques</strong></p> <p>De la même façon, vous pouvez avoir besoin de fixer des <i lang="en">breakpoints</i> spécifiques pour une image données. Cela se fait toujours avec l'argument du filtre en lui indiquant les différents <i lang="en">breakpoints</i> séparés par un <kbd>/</kbd> :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#FICHIER|balise_img|adaptive_images{480/960/1440})] </code></pre></div> <p>Dans ce cas la dernière valeur de la série de <i lang="en">breakpoints</i> correspond à la taille maximale</p> <p><strong>Une image qui n'occupe pas toujours la largeur maximale</strong></p> <p><i>Si vous utilisez la méthode HTML5</i>, vous pouvez préciser le comportement de votre image en fonction de la taille de l'écran <a href="https://developer.mozilla.org/fr/docs/Web/HTML/Element/img" class="spip_out" rel="external">via l'attribut <code class='spip_code spip_code_inline' dir='ltr'>sizes</code></a></p> <p>Par défaut le plugin suppose que votre image occupe la pleine largeur de votre page, et renseigne un attribut <code class='spip_code spip_code_inline' dir='ltr'>sizes</code>.</p> <p>Dans les autres cas vous pouvez ajuster ce comportement, via le second argument du filtre <code class='spip_code spip_code_inline' dir='ltr'>|adaptive_images</code></p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#FICHIER|balise_img|adaptive_images{1024,'(max-width: 768px) 100vw, (max-width: 900px) 50vw, 33vw'})] </code></pre></div> <p>Ici on indique que</p> <ul class="spip" role="list"><li> jusqu'à 768px de largeur d'écran, l'image occupe toute la largeur de l'écran</li><li> puis jusqu'à 900px de largeur d'écran, l'image occupe 50% de la largeur de l'écran</li><li> puis par défaut, au delà, l'image occupe 33% de la largeur de l'écran</li></ul> <p>Dans ce cas le plugin ajoutera une règle implicite pour dire que dans tous les cas l'image fait 1024px maximum (et c'est donc pour les écrans de 1024/0.33 = 3103px de large).</p> <p>Pour alléger l'écriture, il est aussi possible de fournir un tableau en guise d'information pour <code class='spip_code spip_code_inline' dir='ltr'>sizes</code>. L'écriture suivante est équivalente :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#FICHIER|balise_img|adaptive_images{1024,#ARRAY{768px,100vw,900px,50vw,*,33vw}})] </code></pre></div> <p><strong>Ne pas adapter certaines images</strong></p> <p>Pour empêcher le plugin d'adapter certaines images que vous voulez conserver intactes, il suffit de leur ajouter une classe <code class='spip_code spip_code_inline' dir='ltr'>no-adapt-img</code>.</p> <p><strong>Utilisation d'une image adaptée en background</strong></p> <p>Parfois on peut avoir besoin d'une image adaptée en background : c'est de la décoration, mais on veut que la qualité de l'image s'adapte à la taille de l'écran.</p> <p>Il est possible pour cela d'utiliser le filtre <code class='spip_code spip_code_inline' dir='ltr'>|adaptive_images_background</code>, qui prend en arguments optionnels : une largeur maxi (idem ci-dessus), un attribut de <code class='spip_code spip_code_inline' dir='ltr'>class</code> et une couleur par défaut</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#FICHIER|balise_img|adaptive_images_background{1024,super-bg,#f4f4f4})] </code></pre></div> <p>Le code généré est plus léger, ne comporte qu'un <code class='spip_code spip_code_inline' dir='ltr'><span></code>, avec la classe <code class='spip_code spip_code_inline' dir='ltr'>adapt-img-background</code>. <br class='autobr' /> A noter que le code généré est le même quelle que soit la méthode choisie dans la configuration du plugin.</p> <h2 class="h2" id='Les-autres-reglages-moins-utiles'>Les autres réglages (moins utiles)<a class='sommaire-back sommaire-back-7' href='#s-Les-autres-reglages-moins-utiles' title='Back to the table of contents'></a></h2> <p>Bon, si vous aimez vraiment bidouiller, vous pouvez jouer avec les quelques autres réglages via le fichier <tt>mes_options.php</tt>.</p> <p><strong><code class='spip_code spip_code_inline' dir='ltr'>_ADAPTIVE_IMAGES_NOJS_PNGGIF_PROGRESSIVE_RENDERING</code></strong> permet de conserver ou non le rendu progressif des images PNG et GIF quand JavaScript est désactivé. Si le rendu progressif est conservé sans JavaScript, les images avec transparence pourront être dégradées. Par défaut on ne le conserve donc pas.</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>define('_ADAPTIVE_IMAGES_NOJS_PNGGIF_PROGRESSIVE_RENDERING',false); </code></pre></div> <p><strong><code class='spip_code spip_code_inline' dir='ltr'>_ADAPTIVE_IMAGES_DOMAIN</code></strong> permet de définir un nom de domaine qui sera utilisé pour les URLs des images adaptatives. Cela peut-être utile si vous voulez placer vos images sur un domaine statique sans cookie par exemple.</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>define('_ADAPTIVE_IMAGES_DOMAIN','http://example.org/'); </code></pre></div><hr class="spip" /> <p>NB<br class='autobr' /> Au 22 avril 2026, le plugin ne fonctionne pas avec des images webp en entrée.<br class='autobr' /> Dans la configuration il y a une option fonctionnelle pour convertir à la volée les images en webp.</p></div> <hr /> <div class='rss_notes'><div id="nb20-1"> <p><span class="spip_note_ref">[<a href="#nh20-1" class="spip_note" title="Footnotes 20-1" rev="appendix">1</a>] </span>on parle de <q lang="en">device</q> en anglais</p> </div><div id="nb20-2"> <p><span class="spip_note_ref">[<a href="#nh20-2" class="spip_note" title="Footnotes 20-2" rev="appendix">2</a>] </span>Cf. aussi <a href="https://www.smashingmagazine.com/2014/05/responsive-images-done-right-guide-picture-srcset/" class="spip_url spip_out auto" rel="nofollow external">https://www.smashingmagazine.com/2014/05/responsive-images-done-right-guide-picture-srcset/</a> et <a href="https://css-tricks.com/responsive-images-youre-just-changing-resolutions-use-srcset/" class="spip_url spip_out auto" rel="nofollow external">https://css-tricks.com/responsive-images-youre-just-changing-resolutions-use-srcset/</a> pour un aperçu de leur usage</p> </div><div id="nb20-3"> <p><span class="spip_note_ref">[<a href="#nh20-3" class="spip_note" title="Footnotes 20-3" rev="appendix">3</a>] </span>dans tous les cas IE est exclu du support</p> </div><div id="nb20-4"> <p><span class="spip_note_ref">[<a href="#nh20-4" class="spip_note" title="Footnotes 20-4" rev="appendix">4</a>] </span>Cette technique requiert un <i lang="en">markup</i> un peu compliqué mais elle a quelques avantages :</p> <ul class="spip" role="list"><li> elle préserve l'accessibilité ;</li><li> elle ne nécessite pas JavaScript ;</li><li> elle permet un rendu progressif ;</li><li> elle prend en compte les problèmes de performance et de cache. </div></li></ul><div id="nb20-5"> <p><span class="spip_note_ref">[<a href="#nh20-5" class="spip_note" title="Footnotes 20-5" rev="appendix">5</a>] </span>uniquement avec la technique des 3 couches et javascript activé</p> </div><div id="nb20-6"> <p><span class="spip_note_ref">[<a href="#nh20-6" class="spip_note" title="Footnotes 20-6" rev="appendix">6</a>] </span>C'est normalement le cas par défaut sur SPIP 3.1 et versions plus récentes</p> </div><div id="nb20-7"> <p><span class="spip_note_ref">[<a href="#nh20-7" class="spip_note" title="Footnotes 20-7" rev="appendix">7</a>] </span>Ce sont des valeurs de base autour desquelles e plugin pourra varier de +/- 50% pour respecter au mieux la proportion de l'image malgré les arrondis, et garder un poids léger</p> </div></div> </article> <article> <h1>Adminer</h1> <p>Fil — 2013-03-15T14:26:57Z</p> <div class='rss_chapo'><p>Cet article constituait initialement le mode d'emploi du script adminer.php,<br class='autobr' /> avant que soit développé le plugin <a href="https://plugins.spip.net/adminer.html" class="spip_url spip_out" rel="external">https://plugins.spip.net/adminer.html</a> pour SPIP 2 et SPIP 3, qui intègre directement l'accès au script à l'interface privée de SPIP.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-3" id="nav6a60d149cdef15.30003514"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Utilisation"></a><a href="#Utilisation" class="spip_ancre">Utilisation</a></li><li> <a id="s-Restaurer-depuis-le-serveur"></a><a href="#Restaurer-depuis-le-serveur" class="spip_ancre">Restaurer depuis le serveur</a></li><li> <a id="s-Ajout-de-plugins"></a><a href="#Ajout-de-plugins" class="spip_ancre">Ajout de plugins</a></li></ul></div><p>Ce plugin permet d'intégrer le script <a href="https://www.adminer.org" class="spip_out" rel="external">Adminer</a> dans SPIP, en en limitant l'usage aux webmestres du site.</p> <p>(Une autre contrib explique comment utiliser Adminer “brut” : <a href='https://contrib.spip.net/Editer-votre-base-en-ligne-avec-Adminer' class="spip_in" hreflang="fr">Editer votre base “en ligne” avec Adminer</a> )</p> <h2 class="h2" id='Utilisation'>Utilisation<a class='sommaire-back sommaire-back-3' href='#s-Utilisation' title='Back to the table of contents'></a></h2> <p>Adminer se lance depuis un lien dans une fenetre séparée, depuis le menu <strong>Maintenance</strong>.</p> <h2 class="h2" id='Restaurer-depuis-le-serveur'>Restaurer depuis le serveur<a class='sommaire-back sommaire-back-3' href='#s-Restaurer-depuis-le-serveur' title='Back to the table of contents'></a></h2> <p>Il est possible de restaurer un dump SQL (généré par Adminer ou le plugin sauveauto), sans devoir utiliser PhpMyAdmin, en lecture directe depuis le serveur.</p> <p>Il faut uploader un fichier SQL (éventuellement “gzippé”), obligatoirement sous le nom <code class='spip_code spip_code_inline' dir='ltr'>adminer.sql</code> (ou <code class='spip_code spip_code_inline' dir='ltr'>adminer.sql.gz</code>) en chargeant le fichier uniquement sous ce nom, directement sous le répertoire principal d'Adminer, soit -pour SPIP- sous le répertoire <code class='spip_code spip_code_inline' dir='ltr'>/plugins/auto/adminer/x.y.z/</code> (ou équivalent, en fonction de votre installation du plugin).</p> <p>Ce fichier peut ne pas être un dump complet d'ailleurs, mais juste un ensemble de requêtes.</p> <h2 class="h2" id='Ajout-de-plugins'>Ajout de plugins<a class='sommaire-back sommaire-back-3' href='#s-Ajout-de-plugins' title='Back to the table of contents'></a></h2> <p>Le pipeline <code class='spip_code spip_code_inline' dir='ltr'>adminer_plugins</code> permet d'ajouter des plugins à Adminer, dont on peut trouver la liste <a href="https://www.adminer.org/en/plugins/" class="spip_out" rel="external">sur le site officiel</a> (plugins officiels et <i>user-contributed</i>).</p> <p>Exemple d'utilisation :</p> <p>Copier les plugins choisis dans <code class='spip_code spip_code_inline' dir='ltr'>monplugin/adminer/plugins</code> (convention adoptée par ce plugin SPIP Adminer, mais pas obligatoire).<br class='autobr' /> Les plugins Adminer sont la plupart du temps sous la forme d'un seul fichier PHP.</p> <p>Dans <code class='spip_code spip_code_inline' dir='ltr'>paquet.xml</code> :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><pipeline nom="adminer_plugins" inclure="monplugin_pipelines.php"/> </code></pre></div> <p>Dans <code class='spip_code spip_code_inline' dir='ltr'>monplugin_pipelines.php</code> :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>function monplugin_adminer_plugins($flux) { foreach (glob(__DIR__ . '/adminer/plugins/*.php') as $filename) { require_once $filename; } $flux['data'] = array_merge( $flux['data'], [ new AdminerTablesFilter(), new AdminerPHPSerializedColumn(), new AdminerRestoreMenuScroll(), ]); return $flux; } </code></pre></div> <p><strong>PS : </strong> le nom de la classe à instancier (exemple : <code class='spip_code spip_code_inline' dir='ltr'>AdminerRestoreMenuScroll</code>) est obtenu en ouvrant le fichier PHP correspondant (exemple : <code class='spip_code spip_code_inline' dir='ltr'>monplugin/adminer/plugins/restore-menu-scroll.php</code>) et en regardant le nom de la classe au tout début :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code><?php class AdminerFloatThead { ... </code></pre></div></div> </article> <article> <h1>ADX Menu : un joli menu déroulant</h1> <p>PieroWbmstr — 2010-09-07T15:53:49Z</p> <div class='rss_chapo'><p>Le plugin ADX Menu pour SPIP 2.0 (<i>et plus</i>) est une adaptation du menu CSS/JavaScript “ADXmenu” de <u>Aleksandar Vacic</u> ; il permet de mettre en place un menu ouvrant horizontalement ou verticalement en CSS (et Javascript pour IE<7).</p> <p>Script original et informations sur le site : <a href="http://aplus.rs/adxmenu/" class="spip_url spip_out" rel="external">http://aplus.rs/adxmenu/</a>.</p> <p>Page de démonstration : <a href="http://demo-spip3.ateliers-pierrot.fr/spip.php?article6" class="spip_url spip_out" rel="external">http://demo-spip3.ateliers-pierrot....</a> (<i>documentation livrée avec le plugin</i>).</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-8" id="nav6a60d149d14fd1.61330581"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Utilisation-amp-configuration"></a><a href="#Utilisation-amp-configuration" class="spip_ancre">Utilisation & configuration</a></li><li> <a id="s-Apercu"></a><a href="#Apercu" class="spip_ancre">Aperçu</a></li><li> <a id="s-La-balise-ADXMENU"></a><a href="#La-balise-ADXMENU" class="spip_ancre">La balise #ADXMENU</a></li><li> <a id="s-La-classe-adxm-admenu"></a><a href="#La-classe-adxm-admenu" class="spip_ancre">La classe “adxm admenu”</a></li><li> <a id="s-Personnalisation"></a><a href="#Personnalisation" class="spip_ancre">Personnalisation</a></li><li> <a id="s-Compatibilite"></a><a href="#Compatibilite" class="spip_ancre">Compatibilité</a></li><li> <a id="s-Conditions-d-utilisation"></a><a href="#Conditions-d-utilisation" class="spip_ancre">Conditions d'utilisation</a></li></ul></div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-8' href='#s-Installation' title='Back to the table of contents'></a></h2><ol class="spip" role="list"><li> Téléchargez l'archive '.zip' de cette page vers le dossier de plugins de votre SPIP</li><li> Installez le plugin depuis votre espace privé comme expliqué ici : <a href="https://www.spip.net/fr_article3396.html" class="spip_url spip_out" rel="external">https://www.spip.net/fr_article3396.html</a></li><li> Si vous avez <a href='https://contrib.spip.net/Config-CFG' class="spip_in" hreflang="fr">CFG</a>, accédez à la page du plugin via le bouton de l'onglet 'Configuration' de l'espace privé (<i>réservé aux webmestres du site</i>).</li></ol><h2 class="h2" id='Utilisation-amp-configuration'>Utilisation & configuration<a class='sommaire-back sommaire-back-8' href='#s-Utilisation-amp-configuration' title='Back to the table of contents'></a></h2> <p>Le plugin peut s'utiliser de deux façons détaillées plus loin :</p> <ul class="spip" role="list"><li> en utilisant la balise <strong>#ADXMENU</strong>,</li><li> en utilisant la classe CSS “<strong>adxm admenu</strong>”.</li></ul> <p>Il est prévu pour proposer une page de configuration grâce au plugin <strong><a href="https://contrib.spip.net/Config-CFG">CFG : moteur de configuration</a></strong> mais celui-ci n'est pas obligatoire.</p> <p>La page de configuration permet de définir notamment le sens d'ouverture du menu ; celui-ci peut être <strong>horizontal</strong>, de <strong>bas en haut</strong> ou de <strong>haut en bas</strong>, mais aussi <strong>vertical</strong>, de <strong>gauche à droite</strong> ou de <strong>droite à gauche</strong><span class="spip_note_ref"> [<a href="#nb21-1" class="spip_note" rel="appendix" title="Cette option n'est accessible que si le plugin CFG est installé sur votre (…)" id="nh21-1">1</a>]</span>.</p> <h2 class="h2" id='Apercu'>Aperçu<a class='sommaire-back sommaire-back-8' href='#s-Apercu' title='Back to the table of contents'></a></h2><div class='spip_document_8631 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="24" data-legende-lenx="" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-8631 '><strong>Copie d'écran ADX Menu </strong></div> </figcaption></figure> </div><h2 class="h2" id='La-balise-ADXMENU'>La balise #ADXMENU<a class='sommaire-back sommaire-back-8' href='#s-La-balise-ADXMENU' title='Back to the table of contents'></a></h2> <p>Cette balise s'utilise seule par défaut, mais peut prendre les trois arguments suivants : <br />- <strong>liste des rubriques</strong> (<i>par défaut tous les secteurs</i>) : <br />Liste des ID de rubriques à inclure dans le menu, séparés par deux-points ; cette valeur est détaillée ci-dessous ; <br />- <strong>longueur avant de couper les titres</strong> (<i>par défaut 30</i>) : <br />Nombre de caractères au-delà desquels les titres seront tronqués ; <br />- <strong>caractère(s) de coupe</strong> (<i>par défaut “.”</i>) : <br />Le ou les caractères qui seront indiqués pour un titre tronqué.</p> <p>Exemple pour un menu contenant les rubriques 1, 3 et 12, des titres coupés à 50 caractères et auxquels on ajoute “...” :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>#ADXMENU{1:3:12,50,...}</code></pre></div> <p>Le modèle utilisé par la balise <i>expose</i> la rubrique ou l'article courant, à la façon de SPIP. Si un identifiant de rubrique est trouvé dans le contexte (<i>dans les boucles de la page</i>), le titre de la rubrique en question portera la classe CSS <code class='spip_code spip_code_inline' dir='ltr'>on</code>, ainsi que tous ses parents. S'il s'agit d'un article, le titre de l'article portera la classe CSS <code class='spip_code spip_code_inline' dir='ltr'>on</code> ainsi que toutes ses rubriques parentes : secteur, rubrique, sous-rubrique puis article ...</p> <p>La liste des rubriques affichées peut être écrite de différentes façons : <br />- <strong>une liste simple d'ID</strong>, séparés par deux-points ; par exemple <code class='spip_code spip_code_inline' dir='ltr'>1:2:5</code> ; <br />- <strong>le mot-clé “<i>secteurs</i>”</strong> (valeur par défaut) pour lister tous les secteurs du site ; <br />- <strong>le mot-clé “<i>tout</i>”</strong> pour lister toutes les rubriques du site.<br class='autobr' /> Dans chacune des alternatives ci-dessus, vous pouvez ajouter une liste d'identifiants que <strong>vous voulez exclure</strong> du menu, en précédant cette liste par un point d'exclamation ; par exemple :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>#ADXMENU{ secteurs!1:3 }</code></pre></div> <p>qui listera tous les secteurs sauf ceux ayant les ID 1 et 3<span class="spip_note_ref"> [<a href="#nb21-2" class="spip_note" rel="appendix" title="Cette fonctionnalité a été ajouté au plugin en version 1.23.2." id="nh21-2">2</a>]</span>.</p> <h2 class="h2" id='La-classe-adxm-admenu'>La classe “adxm admenu”<a class='sommaire-back sommaire-back-8' href='#s-La-classe-adxm-admenu' title='Back to the table of contents'></a></h2> <p>L'effet menu ouvrant s'applique en ajoutant simplement la classe “adxm adxmenu” à n'importe quel menu (<i>liste imbriquée de <ul><li></i>)<span class="spip_note_ref"> [<a href="#nb21-3" class="spip_note" rel="appendix" title="Cette méthode permet notamment d'utiliser le plugin sur des menus définis (…)" id="nh21-3">3</a>]</span>.</p> <p>Exemple :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code><ul class="adxm adxmenu"> <li>un item de menu</li> </ul></code></pre></div><h2 class="h2" id='Personnalisation'><a id="perso_css"></a>Personnalisation<a class='sommaire-back sommaire-back-8' href='#s-Personnalisation' title='Back to the table of contents'></a></h2> <p>Les styles CSS des différents liens ou items du menu sont personnalisables dans le fichier CSS présent à la racine du plugin : <br />- <strong>“adxmenu_css_styles.css.html”</strong></p> <p>A noter également, si vous avez besoin de modifier l'ensemble de l'apparence du menu, que les styles définissant la disposition des blocs, leur apparence au passage de la souris et toute la mécanique du menu sont modifiables dans les fichiers CSS (<i>complexes</i>) : <br />- <strong>“adxmenu_css.css.html”</strong> <br />- <strong>“adxmenu_css_ie.css.html”</strong></p> <p>Il est conseillé de bien tester vos personnalisations pour vérifier que le menu est toujours présentable (!). À noter ici qu'il est possible de coloriser la zone de sécurité des items du menu en décommentant la ligne 91 du fichier “adxmenu_css.css.html” (<i>une zone rouge encadrera chaque item</i>).</p> <h2 class="h2" id='Compatibilite'>Compatibilité<a class='sommaire-back sommaire-back-8' href='#s-Compatibilite' title='Back to the table of contents'></a></h2> <p>Les CSS utilisés pour générer le menu sont compatibles avec la distribution (<i>bien-sûr</i>) mais également avec les squelettes Z compatibles. Vous pouvez notamment, si vous utilisez un squelette <a href="https://contrib.spip.net/Zpip">Zpip</a>, préciser la classe “adxm adxmenu” au menu général utilisé par le squelette, l'effet ouvrant s'ajoutera automatiquement, en accord avec le sens d'ouverture de vos réglages<span class="spip_note_ref"> [<a href="#nb21-4" class="spip_note" rel="appendix" title="À noter ici que des problèmes d'affichage persistent sur des squelettes Z (…)" id="nh21-4">4</a>]</span>.</p> <h2 class="h2" id='Conditions-d-utilisation'>Conditions d'utilisation<a class='sommaire-back sommaire-back-8' href='#s-Conditions-d-utilisation' title='Back to the table of contents'></a></h2> <p>La version originale du script du menu est proposée par son auteur sous licence <a href="http://creativecommons.org/licenses/by/3.0/" class="spip_out" rel="external">Creative Commons Attribution</a>. Il est donc demandé d'indiquer sur la page de crédits de votre site l'information :</p> <blockquote class="spip"> <p>Ce site web utilise <a href="http://aplus.rs/adxmenu/" class="spip_out" rel="external">ADxMenu</a>, par <a href="http://aplus.rs/" class="spip_out" rel="external">studio.aplus</a></p> </blockquote> <p>Pour plus d'informations, reportez-vous à la page dédiée par l'auteur : <a href="http://aplus.rs/adxmenu/buy/" class="spip_url spip_out" rel="external">http://aplus.rs/adxmenu/buy/</a>.</p></div> <hr /> <div class='rss_notes'><div id="nb21-1"> <p><span class="spip_note_ref">[<a href="#nh21-1" class="spip_note" title="Footnotes 21-1" rev="appendix">1</a>] </span>Cette option n'est accessible que si le plugin <strong>CFG</strong> est installé sur votre site. À défaut, vous pouvez éditer directement le fichier 'adxmenu_options.php' à la racine du plugin.</p> </div><div id="nb21-2"> <p><span class="spip_note_ref">[<a href="#nh21-2" class="spip_note" title="Footnotes 21-2" rev="appendix">2</a>] </span>Cette fonctionnalité a été ajouté au plugin en version <strong>1.23.2</strong>.</p> </div><div id="nb21-3"> <p><span class="spip_note_ref">[<a href="#nh21-3" class="spip_note" title="Footnotes 21-3" rev="appendix">3</a>] </span>Cette méthode permet notamment d'utiliser le plugin sur des menus définis grâce au plugin <strong><a href="http://www.spip-contrib.net/Plugin-Menus" class="spip_out" rel="external">Menus</a></strong>, en ajoutant au menu concerné la classe “adxm adxmenu”.</p> </div><div id="nb21-4"> <p><span class="spip_note_ref">[<a href="#nh21-4" class="spip_note" title="Footnotes 21-4" rev="appendix">4</a>] </span>À noter ici que des problèmes d'affichage persistent sur des squelettes Z pour les menus verticaux ...</p> </div></div> </article> <article> <h1>Afficher les logos dans les textes</h1> <p>chankalan — 2016-03-03T07:00:00Z</p> <div class='rss_chapo'><p>Ce plugin propose des modèles simples pour afficher les logos dans les textes du site.</p></div> <div class='rss_texte'><p>Les modèles utilisables dans vos textes sont :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'><articleXX|logo></code></li><li> <code class='spip_code spip_code_inline' dir='ltr'><rubriqueXX|logo></code></li><li> <code class='spip_code spip_code_inline' dir='ltr'><auteurXX|logo></code></li><li> <code class='spip_code spip_code_inline' dir='ltr'><siteXX|logo></code></li><li> <code class='spip_code spip_code_inline' dir='ltr'><motXX|logo></code></li><li> <code class='spip_code spip_code_inline' dir='ltr'><groupe_motXX|logo></code></li><li> <code class='spip_code spip_code_inline' dir='ltr'><breveXX|logo></code></li></ul> <p>XX représente le numéro identifiant de l'objet en question.</p> <p>Il est possible de réduire l'image en passant en paramètre soit la largeur soit la hauteur, soit les deux, valeurs en pixels. Exemple :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'><articleXX|logo|largeur=150></code></li><li> <code class='spip_code spip_code_inline' dir='ltr'><articleXX|logo|hauteur=100></code></li></ul> <p>Il est aussi possible, comme pour les documents, de les positionner à gauche, à droite ou au centre du texte avec ces paramètres habituels :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'><articleXX|logo|left></code></li><li> <code class='spip_code spip_code_inline' dir='ltr'><articleXX|logo|right></code></li><li> <code class='spip_code spip_code_inline' dir='ltr'><articleXX|logo|center></code></li></ul> <p>Bonus pour afficher le logo du site : <code class='spip_code spip_code_inline' dir='ltr'><logo_site_spip|></code><br class='autobr' /> avec les paramètres comme les autres si besoin : <code class='spip_code spip_code_inline' dir='ltr'><logo_site_spip|left|largeur=300></code></p></div> </article> <article> <h1>Afficher le logo de SPIP</h1> <p>tetue — 2015-05-27T07:00:00Z</p> <div class='rss_chapo'><p>Affichez facilement le logo de SPIP sur votre site !</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-3" id="nav6a60d149d5b9b1.06619916"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Dans-un-article"></a><a href="#Dans-un-article" class="spip_ancre">Dans un article : <code class='spip_code spip_code_inline' dir='ltr'><spip|></code></a></li><li> <a id="s-Dans-vos-squelettes"></a><a href="#Dans-vos-squelettes" class="spip_ancre">Dans vos squelettes</a></li><li> <a id="s-Quel-logo"></a><a href="#Quel-logo" class="spip_ancre">Quel logo ?</a></li></ul></div><h2 class="h2" id='Dans-un-article'>Dans un article : <code class='spip_code spip_code_inline' dir='ltr'><spip|></code><a class='sommaire-back sommaire-back-3' href='#s-Dans-un-article' title='Back to the table of contents'></a></h2> <p>Ce minuscule plugin vous permet d'afficher facilement le logo de SPIP sur votre site, par exemple dans une page citants les crédits (souvent après les « mentions légales »), grâce au raccourci suivant :</p> <p><code class='spip_code spip_code_inline' dir='ltr'><spip|></code></p> <p>Celui-ci affichera le logo de SPIP, réduit à une taille raisonnable, avec lien vers le site officiel de SPIP, dans la langue de l'article. Ce modèle accepte les paramètres d'alignement habituels : <code class='spip_code spip_code_inline' dir='ltr'><spip|right></code> et <code class='spip_code spip_code_inline' dir='ltr'><spip|left></code>. Sa largeur également est paramètrable.</p> <p>Exemple :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><spip|right|width=100>Ce site fonctionne avec le système de publication SPIP, logiciel libre distribué sous licence GNU/GPL.</code></pre></div><h2 class="h2" id='Dans-vos-squelettes'>Dans vos squelettes<a class='sommaire-back sommaire-back-3' href='#s-Dans-vos-squelettes' title='Back to the table of contents'></a></h2> <p>Utilisez la balise <code class='spip_code spip_code_inline' dir='ltr'>#LOGO_SPIP</code> pour afficher le logo seul, dans sa pleine largeur.</p> <p>Utilisez <code class='spip_code spip_code_inline' dir='ltr'>#MODELE{spip}</code> pour afficher le logo en taille raisonnable, avec lien vers le site officiel de SPIP.</p> <p>La balise comme le modèle acceptent les <a href="http://www.spip.net/fr_article3327.html" class="spip_out" rel="external">filtres de traitement d'image</a> qui permettent d'ajuster l'affichage du logo à votre goût.</p> <p>Exemple, dans un pied de page :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#MODELE{spip}|image_reduire{60})]</code></pre></div><h2 class="h2" id='Quel-logo'>Quel logo ?<a class='sommaire-back sommaire-back-3' href='#s-Quel-logo' title='Back to the table of contents'></a></h2> <p>SPIP a connu bien des transformations de son logo au cours de sa longue histoire, changeant souvent d'apparence, parfois à chaque publication de nouvelle version. Ce plugin vous fournit la dernière version du logo, à jour.</p> <p>Le logo de SPIP est disponible dans votre site, à la racine, sous la forme d'un fichier graphique spip.png, mais en petite taille, et seulement depuis la version 3. Ce n'est effectivement pas le cas des versions antérieures. C'est pourquoi ce plugin distribue le logo dans une version plus grosse et utilisable dans les sites plus anciens.</p></div> <div class='rss_ps'><p>Ce plugin répond aux tickets de demande d'évolution <a href="https://core.spip.net/issues/2185" class="spip_out" rel="external">#2185</a> et <a href="https://core.spip.net/issues/3431" class="spip_out" rel="external">#3431</a>.</p></div> </article> <article> <h1>Agenda 2.0</h1> <p>Martin Gaitan — 2009-09-18T00:49:15Z</p> <div class='rss_chapo'><p>Aquí está la versión para SPIP 2.0 del <a href='https://contrib.spip.net/Plugin-Agenda-pour-SPIP-1-9' class="spip_in" hreflang="fr">Plugin Agenda para SPIP 1.9.2</a>, con una interfaz rediseñada para más diversión!</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-9" id="nav6a60d149dba218.38206482"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Navegar-por-los-eventos-del-sitio"></a><a href="#Navegar-por-los-eventos-del-sitio" class="spip_ancre">Navegar por los eventos del sitio</a></li><li> <a id="s-Crear-un-nuevo-evento"></a><a href="#Crear-un-nuevo-evento" class="spip_ancre">Crear un nuevo evento</a></li><li> <a id="s-Modificar-un-evento"></a><a href="#Modificar-un-evento" class="spip_ancre">Modificar un evento</a></li><li> <a id="s-Edicion-de-un-evento"></a><a href="#Edicion-de-un-evento" class="spip_ancre">Edición de un evento</a></li><li> <a id="s-Dentro-de-los-esqueletos"></a><a href="#Dentro-de-los-esqueletos" class="spip_ancre">Dentro de los esqueletos</a></li><li> <a id="s-Ejemplos-de-bucles"></a><a href="#Ejemplos-de-bucles" class="spip_ancre">Ejemplos de bucles</a></li><li> <a id="s-Equeletos"></a><a href="#Equeletos" class="spip_ancre">Equeletos</a></li><li> <a id="s-El-Mini-Calendario"></a><a href="#El-Mini-Calendario" class="spip_ancre">El Mini-Calendario</a></li><li> <a id="s-Un-formulario-de-edicion-de-edicion-de-eventos"></a><a href="#Un-formulario-de-edicion-de-edicion-de-eventos" class="spip_ancre">Un formulario de edición de edición de eventos</a></li></ul></div><p>La migración del plugin Agenda a SPIP 2.0 fue una oportunidad para repensar y mejorar la ergonomía de su interfaz.</p> <h2 class="h2" id='Navegar-por-los-eventos-del-sitio'>Navegar por los eventos del sitio<a class='sommaire-back sommaire-back-9' href='#s-Navegar-por-los-eventos-del-sitio' title='Back to the table of contents'></a></h2> <p>La navegación de los eventos en la agenda está accesible directamente dentro de un submenú del menú Edición del Sitio:</p> <div class='spip_document_7182 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/Pantallazo.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Los eventos ya no se presentan a través de un calendario sino con una listado más fácil de utilizar. <br class='manualbr' />De forma predeterminada sólo se muestran los próximos eventos:</p> <div class='spip_document_7183 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Este funcionamiento intenta no saturar la pantalla con infomación que en general ya no es demasiado útil.</p> <p>Un menú de navegación lateral permite ver todos los eventos, paginados y ordenados por fecha:</p> <div class='spip_document_6009 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>El menú también incluye un calendario mensual anticronológico para mostrar todos los eventos de un mes</p> <p>La lista central proporciona un resúmen de cada evento. Puedes ver más detalles haciendo click en el titulo del evento:</p> <p>Un link <code class='spip_code spip_code_inline' dir='ltr'>[article]</code> permite acceder al artículo que contiene dicho evento:</p> <div class='spip_document_7185 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Crear-un-nuevo-evento'> Crear un nuevo evento <a class='sommaire-back sommaire-back-9' href='#s-Crear-un-nuevo-evento' title='Back to the table of contents'></a></h2> <p>El vínculo sobre el borde superior del contenedor de la agenda permite crear un nuevo evento.</p> <div class='spip_document_7184 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Modificar-un-evento'> Modificar un evento <a class='sommaire-back sommaire-back-9' href='#s-Modificar-un-evento' title='Back to the table of contents'></a></h2> <p>Cuando despliegas los detalles de un evento, un botón <code class='spip_code spip_code_inline' dir='ltr'>[modificar]</code> te permitirá acceder a la edición del artículo.</p> <div class='spip_document_7186 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Si el evento es una repetición no será posible editarlo directamente. En este caso, el vínculo de edición se sustituirá por un enlace <code class='spip_code spip_code_inline' dir='ltr'>[source] </code>, que permite el acceso a la fuente de evento para cambiarlo.</p> <h2 class="h2" id='Edicion-de-un-evento'> Edición de un evento <a class='sommaire-back sommaire-back-9' href='#s-Edicion-de-un-evento' title='Back to the table of contents'></a></h2> <p>Ya sea la hora de crear o editar, ahora existe una página independiente dedicada a la carga de datos:</p> <div class='spip_document_7187 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Además de los habituales campos de título y descripción, se encuentra la edición de inicio y finalización. Una casilla de verificación <code class='spip_code spip_code_inline' dir='ltr'>todo el día</code> permite obviar el horario.</p> <p>En cada campo de dato tipo fecha, un ícono da acceso a un calendario desplegable.</p> <p>Las repeticiones se configuran desde el apartado bajo la configuración de fecha, con un calendario dedicado ad hoc. El principio de funcionamiento de los eventos repititivos es que conservan la hora de inicio y duración del evento original, sólo cambiando el día en que se produce.</p> <p>Después de configurar y guardar el evento, se regresa a la página del artículo y se muestra el detalle:</p> <div class='spip_document_7188 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Allí puedes verificar las fechas.</p> <p>Puedes ver todos los eventos asociados al artículo o sólo aquellos que están programados para los días posteriores, cliqueando en los links correspondientes.</p> <h2 class="h2" id='Dentro-de-los-esqueletos'> Dentro de los esqueletos<a class='sommaire-back sommaire-back-9' href='#s-Dentro-de-los-esqueletos' title='Back to the table of contents'></a></h2> <p>La introducción de eventos de agenda se realiza a través de un nuevo bucle<br class='autobr' /> el bucle EVENEMENTS</p> <p><strong>Balizas</strong></p> <p>Corresponden a los campos del evento:</p> <ul class="spip" role="list"><li> #TITRE (título)</li><li> #DATE_DEBUT (fecha de inicio)</li><li> #DATE_FIN (fecha de finalización)</li><li> #LIEU (lugar)</li><li> #DESCRIPTIF (descripción)</li><li> #HORAIRE (horario) que toma valor sí/no, y es útil saber si se debe mostrar la hora o no en el bucle (ver 2° ejemplo)</li><li> #ID_EVENEMENT_SOURCE : cuando el evento es una repetición, devuelva el id del evento original y 0 en caso contrario</li></ul> <p><strong>Los critérios</strong></p> <p>Por supuesto, puedes utilizar los campos de los eventos como criterios:<br class='autobr' /> id_evenement, date_debut, date_fin, lieu, descriptif, horaire y id_evenement_source. Notar que el criterio <i>date</i> también se puede usar, que dentro de este contexto es identico a <i>date_debut</i>.</p> <p>Pero hay otros critérios que también están disponibles:</p> <ul class="spip" role="list"><li> <i>Critérios de fecha</i><br class='manualbr' />Todos los criterios relacionados con fecha como age, age_relatif, mois_relatif, jour_relatif son utilizados respecto a las fechas de inicio y finalización : age_debut, age_relatif_debut, mois_relatif_debut, jour_relatif_debut, y análogamente age_fin, age_relatif_fin, mois_relatif_fin, jour_relatif_fin<br class='manualbr' />En este caso, vale señalar que la comparación se realiza respecto a los valores de date_debut y date_fin del contexto. <br class='manualbr' />De esta manera, si utilizas <code class='spip_code spip_code_inline' dir='ltr'>{mois_relatif_debut<0}</code> como critério de un bucle EVENEMENTS, obtendrás los eventos cuyo mes de inicio sea superior o igual al mes de date_debut del contexto (sea <code class='spip_code spip_code_inline' dir='ltr'>#ENV{date_debut}</code> o el #DATE_DEBUT del bucle padre)</li></ul> <p>Para obtener los eventos de una fecha específica, puedes pasar como parámetros date_debut y date_fin a través de una inclusión.</p> <ul class="spip" role="list"><li> <i>Critérios de árbol</i><br class='manualbr' />Dado que los eventos están asociados a un artículo, es posible utilizar dentro de un bucle de eventos los criterios asociados a la estructura del sitio: id_article, por supuesto, pero también id_rubrique, id_secteur, branche, que se interpretan implícitamente a través del artículo que contiene al evento en contexto.</li></ul><ul class="spip" role="list"><li> <i>Critérios de palabras clave</i><br class='manualbr' />Al poder asociar palabras clave a los eventos, los criterios de este elemento están disponibles (id_mot, type_mot ...).</li></ul><ul class="spip" role="list"><li><i>Critérios agenda</i><br class='manualbr' />El <a href="http://www.spip.net/es_article3183.html" class="spip_out" rel="external">critério agenda</a> de SPIP permite seleccionar eventos de un día, semana, mes o período teniendo en cuenta las fechas de inicio y finalización. Ejemplo :<br class='manualbr' /><code class='spip_code spip_code_inline' dir='ltr'>{agendafull date_debut,date_fin, mois, #ENV{annee}, #ENV{mois}}</code></li></ul> <p><strong>Los filtros</strong></p> <ul class="spip" role="list"><li> Agenda incluye los filtros <i>Agenda_memo_full</i>, <i>Agenda_memo_evt_full</i> y <i>Agenda_affiche_full</i><br class='manualbr' />Son la transposición de filtros nativos de SPIP (agenda_memo y agenda_affiche) para eventos. Se debe tener en cuenta la fecha de finalización. Ejemplos : <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'> [(#DATE_DEBUT|Agenda_memo_full{#DATE_FIN,#TITRE,#DESCRIPTIF,#LIEU,#URL_ARTICLE, 'color'})]</code> recordar un evento que será mostrado con la clase 'color' en la agenda, al horario correspondiente.</li><li> <code class='spip_code spip_code_inline' dir='ltr'> [(#DATE_DEBUT|Agenda_memo_evt_full{#DATE_FIN,#TITRE,#DESCRIPTIF,#LIEU,#URL_ARTICLE, 'color'})]</code> recordar un evento si noción de horario (#HORAIRE=non) que se mostrará en la agenda con la clase 'color'.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>[(#TOTAL_BOUCLE|Agenda_affiche_full{<:aucun_article:>, 'mois'})]</code> muestra la agenda con los eventos recordados en la aplicación de los filtros precedentes.</li></ul></li><li> el filtro <i>Agenda_affdate_debut_fin</i> muestra la fecha de los eventos teniendo en cuenta que la fecha de inicio y la de finalización pueden no corresponder al mismo día, mes o año, y contemplando si se debe mostrar la hora o no. Ejemplo:emple :<br class='manualbr' /><code class='spip_code spip_code_inline' dir='ltr'>[(#DATE_DEBUT|Agenda_affdate_debut_fin{#DATE_FIN,#HORAIRE})]</code></li></ul><ul class="spip" role="list"><li> El filtro <i>Agenda_dateplus</i> mostrará la fecha desfasa una cantidad de segundos: <br class='manualbr' /><code class='spip_code spip_code_inline' dir='ltr'> [(#DATE_FIN|Agenda_dateplus{3600,'H:i'})]</code> muestra la fecha de finalización más 1 hora (3600 segundos) en formato 'H:i' (horas:minutos, ver affdate para opciones formato)</li></ul><h2 class="h2" id='Ejemplos-de-bucles'>Ejemplos de bucles<a class='sommaire-back sommaire-back-9' href='#s-Ejemplos-de-bucles' title='Back to the table of contents'></a></h2> <p><strong>1° ejemplo</strong></p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><B_agenda> <h3><:agenda:></h3> <dl> <BOUCLE_agenda(EVENEMENTS){age<0}{par date}{statut=publie}> <dt>#TITRE</dt> [<dd>(#DATE_DEBUT|Agenda_affdate_debut_fin{#DATE_FIN,#HORAIRE})</dd>] <dd>#LIEU</dd> <dd>#DESCRIPTIF</dd> </BOUCLE_agenda> </dl> </B_agenda></code></pre></div> <p><strong>2° exemple</strong></p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><B_lesevenements> <h3 class="spip">Eventos asociados</h3> <ul class="spip"> <BOUCLE_lesevenements(EVENEMENTS) {par date} {id_article}> <li class="spip"><strong>[(#TITRE|supprimer_numero|couper{80})] :</strong> [(#DATE_DEBUT|jour|=={[(#DATE_FIN|jour)]}|?{ le [(#DATE_DEBUT|nom_jour)] [(#DATE_DEBUT|affdate)] [(#HORAIRE|=={oui}|?{ [(#REM) misma hora ?] [(#DATE_DEBUT|=={#DATE_FIN}|?{ a las [(#DATE_DEBUT|heures)]h[(#DATE_DEBUT|minutes)],''})] [(#REM) duracion definida ?] [(#DATE_DEBUT|!={#DATE_FIN}|?{ Desde [(#DATE_DEBUT|heures)]:[(#DATE_DEBUT|minutes)] hasta las [(#DATE_FIN|heures)]:[(#DATE_FIN|minutes)],''})] ,''})] , el [(#DATE_DEBUT|nom_jour)] [(#DATE_DEBUT|affdate)] [(#HORAIRE|=={oui}|?{ a partir de las [(#DATE_DEBUT|heures)]H[(#DATE_DEBUT|minutes)],''})] de [(#DATE_FIN|nom_jour)] [(#DATE_FIN|affdate)] [(#HORAIRE|=={oui}|?{ a [(#DATE_FIN|heures)]H[(#DATE_FIN|minutes)],''})] })] [Lugar: (#LIEU)] </li> </BOUCLE_lesevenements> </ul> </B_lesevenements></code></pre></div><h2 class="h2" id='Equeletos'>Equeletos<a class='sommaire-back sommaire-back-9' href='#s-Equeletos' title='Back to the table of contents'></a></h2> <p><strong>agenda_xx</strong></p> <p>La adaptación al bucle EVENEMENTS los esqueletos agenda_jour, agenda_semaine, agenda_mois y agenda_periode y utilizando los criterios agendafull y filtros asociados se incluyen en este plugin. Así, cuando se activa el plugin ?page=agenda muestra el calendario con todos los eventos definidos en lugar de los artículos.</p> <p><strong>ical-agenda</strong></p> <p>Se muestran los eventos en formato ical. Podemos optar por seleccionar sólo los eventos asociados a un artículo especificandolo en la dirección URL</p> <h2 class="h2" id='El-Mini-Calendario'>El Mini-Calendario<a class='sommaire-back sommaire-back-9' href='#s-El-Mini-Calendario' title='Back to the table of contents'></a></h2> <p>El plugin incluye un ejemplo de #CALENDRIER_MINI que es una adaptación al bucle EVENEMENTS de la versión propuesta por James. Está definido dentro de formulaires/calendrier_mini.html, y puedes personalizarlo en tu propia carpeta de esqueletos (dentro de un subdirectorio formulaires/ ).</p> <p>Por defecto, su sintáxis es :</p> <p><code class='spip_code spip_code_inline' dir='ltr'>#CALENDRIER_MINI{#ENV{date},'date',#SELF}</code></p> <ul class="spip" role="list"><li> el primer argumento es la fecha en curso</li><li> el segundo el nombre de la variable de fecha en la url</li><li> el tercero es la url base sobre a la que el calendario debe remitir</li></ul> <p>Dentro de la versión definida en el plugin, el calendario lista los artículo los artículos ligados a un id_article del contexto y eventualmente a un id_mot de contexto.</p> <p><strong>Personalización de #CALENDRIER_MINI</strong></p> <p>Por defecto, la baliza colecta el id_rubrique, id_article e id_mot del contexto en que es llamada. Para mostrar, por ejemplo, todos los eventos de una misma sección, sin contemplar el id_article ni el id_mot, se deberá modificar los criterios BOUCLE_calendrier dentro calendrier_mini.html</p> <p>Un ejemplo de utilización de la baliza se ilustra en el esqueleto de demostración demo_calendrier_mini.html</p> <h2 class="h2" id='Un-formulario-de-edicion-de-edicion-de-eventos'>Un formulario de edición de edición de eventos<a class='sommaire-back sommaire-back-9' href='#s-Un-formulario-de-edicion-de-edicion-de-eventos' title='Back to the table of contents'></a></h2> <p>Es posible mostrar un formulario para permitir a lo visitantes editar o proponer eventos. Como estos deben asociarse a un artículo, este formulario debe invocarse dentro de un bucle articles a través de la baliza #FORMULAIRE_EDITION_EVENEMENT.</p> <p>Si se especifica un id_evenement en la url, el formulario permitirá modificar el evento seleccionado. En cambio, si el parámetro ajout_evenement=oui está presente en la url, permitirá crear un evento nuevo.</p> <p>El formulario recolecta todos los id_article y id_evenement del contexto.</p> <p>Para hacer un link que permita adjuntar un evento, puedes utilizar esta forma de contruir la url:<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'><a href='[(#SELF|parametre_url{ajout_evenement,oui}|parametre_url{id_evenement,''})]'><:agenda:titre_cadre_ajouter_evenement:></a></code></p> <p>Para permitir proponer eventos pero no editarlos, puedes mostrar el formulario con un estilo display:none en función de la presencia de un id_evenement:</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><div [style='(#ID_EVENEMENT|?{display:none,''})']> #FORMULAIRE_EVENEMENT </div></code></pre></div></div> </article> <article> <h1>Agenda 2.0 et ultérieur</h1> <p>Cerdic — 2008-11-03T10:18:11Z</p> <div class='rss_chapo'><p>Voici la version pour SPIP 2.0 du <a href='https://contrib.spip.net/Plugin-Agenda-pour-SPIP-1-9' class="spip_in" hreflang="fr">Plugin Agenda pour SPIP 1.9.2</a>, avec une interface remaniée pour encore plus de plaisir.</p> <p> La lecture de <a href='https://contrib.spip.net/Calendrier-Mini-2-0' class="spip_in" hreflang="fr">Calendrier Mini 2.0</a> est également chaudement recommandée, étant donné que Agenda 3 est dépendant de ce plugin.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-5" id="nav6a60d149e06bc4.15350885"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Navigation-dans-les-evenements-du-site"></a><a href="#Navigation-dans-les-evenements-du-site" class="spip_ancre">Navigation dans les événements du site</a></li><li> <a id="s-Creer-un-nouvel-evenement"></a><a href="#Creer-un-nouvel-evenement" class="spip_ancre">Créer un nouvel événement</a></li><li> <a id="s-Modifier-un-evenement"></a><a href="#Modifier-un-evenement" class="spip_ancre">Modifier un événement</a></li><li> <a id="s-Edition-d-un-evenement"></a><a href="#Edition-d-un-evenement" class="spip_ancre">Edition d'un événement</a></li><li> <a id="s-Squelettes-et-boucle"></a><a href="#Squelettes-et-boucle" class="spip_ancre">Squelettes et boucle <code class='spip_code spip_code_inline' dir='ltr'>EVENEMENTS</code></a></li></ul></div><p>Le portage du plugin Agenda pour SPIP 2.0 a été l'occasion de repenser et améliorer l'ergonomie de son interface. <strong> La version 2.0 du plugin agenda ne nécessite plus le plugin Widget Calendar, mais nécessite le plugin <a href='https://contrib.spip.net/SPIP-Bonux' class="spip_in" hreflang="fr">SPIP Bonux</a></strong></p> <h2 class="h2" id='Navigation-dans-les-evenements-du-site'>Navigation dans les événements du site<a class='sommaire-back sommaire-back-5' href='#s-Navigation-dans-les-evenements-du-site' title='Back to the table of contents'></a></h2> <p>La navigation dans les événements est directement accessible par un sous-menu du menu edition :</p> <div class='spip_document_6008 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/menu-5.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>La présentation de ces événements délaisse le mode calendrier pour un affichage en liste plus pratique à l'usage.<br class='manualbr' />Par défaut seuls les événements à venir sont affichés :</p> <div class='spip_document_6007 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Ce fonctionnement évite d'encombrer l'affichage avec les événements passés toujours plus nombreux.</p> <p>Un menu de navigation latéral permet d'afficher tous les événements, paginés, triés par date :</p> <div class='spip_document_6009 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Le menu latéral inclut également une navigation antéchronologique par mois calendaire permettant l'affichage de tous les événements d'un mois</p> <div class='spip_document_6010 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>La liste centrale présente une vue résumée de chaque événement. Il est possible de voir plus de détails en cliquant sur le titre de l'événement :</p> <div class='spip_document_6011 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Un lien <code class='spip_code spip_code_inline' dir='ltr'>[article]</code> permet d'accéder à l'article qui contient cet événement :</p> <div class='spip_document_6012 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>On y retrouve exactement le même type de navigation, mais limitée aux événements de l'article.</p> <h2 class="h2" id='Creer-un-nouvel-evenement'> Créer un nouvel événement <a class='sommaire-back sommaire-back-5' href='#s-Creer-un-nouvel-evenement' title='Back to the table of contents'></a></h2> <p>Le lien situé dans le bandeau titre de la boîte agenda permet de créer un nouvel événement</p> <div class='spip_document_6016 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Modifier-un-evenement'> Modifier un événement <a class='sommaire-back sommaire-back-5' href='#s-Modifier-un-evenement' title='Back to the table of contents'></a></h2> <p>Lorsque vous dépliez un événement, un bouton <code class='spip_code spip_code_inline' dir='ltr'>[modifier]</code> permet d'accéder à l'édition de l'événement.</p> <div class='spip_document_6013 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Si l'événement est une répétition, il n'est pas possible de l'éditer directement. Dans ce cas le lien modifier est remplacé par un lien <code class='spip_code spip_code_inline' dir='ltr'>[source]</code> qui permet d'accéder à l'événement source pour le modifier.</p> <h2 class="h2" id='Edition-d-un-evenement'> Edition d'un événement<a class='sommaire-back sommaire-back-5' href='#s-Edition-d-un-evenement' title='Back to the table of contents'></a></h2> <p>Que ce soit lors de la création ou l'édition d'un événement, la saisie se déroule désormais sur une page indépendante dédiée :</p> <div class='spip_document_6014 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Outre les champs habituels de titre et descriptif, vous y retrouverez la zone d'édition des dates de début et de fin. Une case à cocher <code class='spip_code spip_code_inline' dir='ltr'>toute la journée</code> permet de ne pas sélectionner d'horaire.</p> <p>Sur chaque champ de saisie de la date, une icone calendrier permet d'accéder à un mini calendrier de saisie.</p> <p>Les répétitions sont saisies après la date de début et de fin, sur un calendrier de saisie dédié. Le principe des événements répétés et que l'heure de début et la durée sont toujours conservées de l'événement d'origine, mais seul les jours de début changent en prenant les valeurs cochées dans le calendrier des répétitions.</p> <p>Après saisie, lorsque vous enregistrez votre événement, vous revenez sur la page d'origine avec ce seul événement affiché en détail :</p> <div class='spip_document_6015 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Vous pouvez ainsi vérifier votre saisie.</p> <p>Vous pouvez retrouver tous les événements, ou les événements à venir seulement, en cliquant sur les liens correspondants.</p> <p><a id="squelettes"></a></p> <h2 class="h2" id='Squelettes-et-boucle'> Squelettes et boucle <code class='spip_code spip_code_inline' dir='ltr'>EVENEMENTS</code><a class='sommaire-back sommaire-back-5' href='#s-Squelettes-et-boucle' title='Back to the table of contents'></a></h2> <p>En ce qui concerne l'utilisation du plugin agenda dans les squelettes, vous pouvez vous référer à la documentation du <a href='https://contrib.spip.net/Plugin-Agenda-pour-SPIP-1-9#squelettes' class="spip_in" hreflang="fr">Plugin Agenda pour SPIP 1.9.2</a>.</p> <p><strong>Nouveaux critères</strong></p> <p><code class='spip_code spip_code_inline' dir='ltr'>{evenement_a_venir}</code> pour sélectionner les événements pas encore commencés à la date courante<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>{evenement_a_venir #ENV{date}}</code> pour sélectionner les événements pas encore commencés à la date <code class='spip_code spip_code_inline' dir='ltr'>#ENV{date}</code><br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>{!evenement_a_venir #ENV{date}}</code> pour sélectionner les événements finis ou en cours à la date <code class='spip_code spip_code_inline' dir='ltr'>#ENV{date}</code></p> <p><code class='spip_code spip_code_inline' dir='ltr'>{evenement_en_cours}</code> pour sélectionner les événements en cours à la date courante<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>{evenement_en_cours #ENV{date}}</code> pour sélectionner les événements en cours à la date <code class='spip_code spip_code_inline' dir='ltr'>#ENV{date}</code><br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>{!evenement_en_cours #ENV{date}}</code> pour sélectionner les événements *pas* en cours à la date <code class='spip_code spip_code_inline' dir='ltr'>#ENV{date}</code></p> <p><code class='spip_code spip_code_inline' dir='ltr'>{evenement_passe}</code> pour sélectionner les événements passés/finis à la date courante<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>{evenement_passe #ENV{date}}</code> pour sélectionner les événements passés/finis à la date <code class='spip_code spip_code_inline' dir='ltr'>#ENV{date}</code><br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>{!evenement_passe #ENV{date}}</code> pour sélectionner les événements en cours ou pas encore commencés à la date <code class='spip_code spip_code_inline' dir='ltr'>#ENV{date}</code></p> <p>Il est possible combiner ces 3 critères pour effectuer une sélection fine.</p> <p>Pour un affichage sous forme d'agenda en case, voir <a href='https://contrib.spip.net/SPIP-3-Agenda-et-FullCalendar' class="spip_in" hreflang="fr">SPIP 3, Agenda et FullCalendar</a> ou encore <a href='https://contrib.spip.net/Agenda-Fullcalendar-facile' class="spip_in" hreflang="fr">Agenda Fullcalendar facile</a>.</p></div> </article> <article> <h1>Agenda Fullcalendar facile</h1> <p>Maïeul — 2016-10-29T12:47:27Z</p> <div class='rss_chapo'><p>Dans un précédent article, nous expliquions <a href='https://contrib.spip.net/SPIP-3-Agenda-et-FullCalendar' class="spip_in" hreflang="fr">comment afficher un agenda Fullcalendar sur son site avec le plugin agenda</a>. Cependant, ceci nécessite des manipulation de squelettes, ce qui n'est pas toujours évident lorsqu'on débute.</p> <p>La présente contribution permet d'intégrer plus facilement un agenda Fullcalendar, sans qu'il ne soit cependant possible d'avoir une configuration avancée<span class="spip_note_ref"> [<a href="#nb22-1" class="spip_note" rel="appendix" title="Si le besoin s'en fait sentir, il est nécessaire d'apprendre des notions de (…)" id="nh22-1">1</a>]</span>.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-6" id="nav6a60d149e42be9.43710612"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Fonctionnalite"></a><a href="#Fonctionnalite" class="spip_ancre">Fonctionnalité</a></li><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Utilisation"></a><a href="#Utilisation" class="spip_ancre">Utilisation</a></li><li> <a id="s-Options"></a><a href="#Options" class="spip_ancre">Options</a> <ul class="spip" role="list"><li> <a id="s-Colorer-les-evenements"></a><a href="#Colorer-les-evenements" class="spip_ancre">Colorer les évènements</a></li></ul></li><li> <a id="s-Ne-pas-inserer-de-lien"></a><a href="#Ne-pas-inserer-de-lien" class="spip_ancre">Ne pas insérer de lien</a></li></ul></div><h2 class="h2" id='Fonctionnalite'>Fonctionnalité<a class='sommaire-back sommaire-back-6' href='#s-Fonctionnalite' title='Back to the table of contents'></a></h2> <p>Avec le plugin <a href='https://contrib.spip.net/Agenda-2-0-et-ulterieur' class="spip_in" hreflang="fr">Agenda</a> activé, le présent plugin permet d'afficher dans un article un agenda Fullcalendar, affichant les évènements par mois, semaine ou jour, et liant chaque évènement à la page de l'article qui lui est associé.</p> <div class='spip_document_11010 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="26" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/mon_site_spip.png' class="spip_doc_lien mediabox" type="image/png"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11010 '><strong>Agenda souhaité au final </strong></div> </figcaption></figure> </div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-6' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Le plugin nécessite SPIP 3.1, il <a href="https://www.spip.net/fr_article3396.html" class="spip_out" rel="external">s'installe comme n'importe quel plugin</a>. Sous SPIP 4 et supérieur, il nécessite d'installer le plugin “organiseur” qui n'est plus livré en standard. Pour ce faire, ajouter le dépot suivant à la liste des dépots <code class='spip_code spip_code_inline' dir='ltr'>https://files.spip.org/core/archives.xml</code>.</p> <h2 class="h2" id='Utilisation'>Utilisation<a class='sommaire-back sommaire-back-6' href='#s-Utilisation' title='Back to the table of contents'></a></h2> <p>Une fois le plugin installé, et les événements créés, il suffit d'insérer le code suivant dans un article:</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><agenda_fullcalendar|></code></pre></div> <h2 class="h2" id='Options'>Options<a class='sommaire-back sommaire-back-6' href='#s-Options' title='Back to the table of contents'></a></h2> <h3 class="h3" id='Colorer-les-evenements'>Colorer les évènements<a class='sommaire-back sommaire-back-6' href='#s-Colorer-les-evenements' title='Back to the table of contents'></a></h3> <p>À partir de la version 2.1.0, il est possible de choisir la couleur associé aux événements.</p> <p>Pour ce faire, il vous faut:</p> <ul class="spip" role="list"><li> avoir le plugin <a href='https://contrib.spip.net/Couleur-d-Objet' class="spip_in" hreflang="fr">Couleur d'Objet</a> activé, en version 0.3.0 minimum et les couleurs réglées</li><li> passer en paramètre du modèle l'objet sur lequel on prend la couleur: <ul class="spip" role="list"><li><code class='spip_code spip_code_inline' dir='ltr'><agenda_fullcalendar|couleur=rubrique></code> prend la couleur associé à la rubrique où se trouve l'évènement.</li><li><code class='spip_code spip_code_inline' dir='ltr'><agenda_fullcalendar|couleur=article></code> prend la couleur associé à l'article où se trouve l'évènement.</li><li><code class='spip_code spip_code_inline' dir='ltr'><agenda_fullcalendar|couleur=evenement></code> prend la couleur associé à l'évènement lui-même.</li><li> <code class='spip_code spip_code_inline' dir='ltr'><agenda_fullcalendar|couleur=mot></code> prend la couleur associé à un mot clé associé à l'évènement ; si plusieurs mots-clé avec une couleur sont associés à l'évènement, celui ayant l'identifiant le plus important l'emportera. Option disponible à partir de la version 2.5.0 du plugin.</li></ul></li></ul><h2 class="h2" id='Ne-pas-inserer-de-lien'>Ne pas insérer de lien<a class='sommaire-back sommaire-back-6' href='#s-Ne-pas-inserer-de-lien' title='Back to the table of contents'></a></h2> <p>À partir de la version 3,1,0, on peut passer le paramètre <code class='spip_code spip_code_inline' dir='ltr'>|sans_lien=oui</code> au modèle pour ne pas insérer de lien.</p></div> <hr /> <div class='rss_notes'><div id="nb22-1"> <p><span class="spip_note_ref">[<a href="#nh22-1" class="spip_note" title="Footnotes 22-1" rev="appendix">1</a>] </span>Si le besoin s'en fait sentir, il est nécessaire d'apprendre des notions de squelettes SPIP, puis de lire mon tutoriel.</p> </div></div> </article> <article> <h1>Aide par Objet</h1> <p>Thrax — 2020-04-28T06:00:00Z</p> <div class='rss_chapo'><p>Ce plugin pour les personnes qui font du développement propose une aide contextuelle sommaire, dans la partie privée, sur la partie gauche, pour les objets ou exec de vos plugins. Cette aide est extrêmement aisée à mettre en oeuvre et absolument pas chronophage. C'est cette dernière raison qui m'a amené à la développer.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-12" id="nav6a60d149e80e09.37356051"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-t1-Objet-du-plugin"></a><a href="#t1-Objet-du-plugin" class="spip_ancre">1. Objet du plugin</a> <ul class="spip" role="list"><li> <a id="s-a-Les-aides-existantes"></a><a href="#a-Les-aides-existantes" class="spip_ancre">a) Les aides existantes</a></li><li> <a id="s-b-Les-avantages-et-inconvenients-de-la-nouvelle-aide-proposee"></a><a href="#b-Les-avantages-et-inconvenients-de-la-nouvelle-aide-proposee" class="spip_ancre">b) Les avantages et inconvénients de la nouvelle aide proposée</a></li></ul></li><li> <a id="s-t2-Installation-preferences-configuration"></a><a href="#t2-Installation-preferences-configuration" class="spip_ancre">2. Installation, préférences, configuration</a> <ul class="spip" role="list"><li> <a id="s-a-Installation"></a><a href="#a-Installation" class="spip_ancre">a) Installation</a></li><li> <a id="s-b-Preferences"></a><a href="#b-Preferences" class="spip_ancre">b) Préférences</a></li><li> <a id="s-c-Configuration"></a><a href="#c-Configuration" class="spip_ancre">c) Configuration</a></li></ul></li><li> <a id="s-t3-Utilisation-dans-votre-plugin"></a><a href="#t3-Utilisation-dans-votre-plugin" class="spip_ancre">3. Utilisation dans votre plugin</a> <ul class="spip" role="list"><li> <a id="s-a-La-dependance"></a><a href="#a-La-dependance" class="spip_ancre">a) La dépendance</a></li><li> <a id="s-b-Les-chaines-de-langues"></a><a href="#b-Les-chaines-de-langues" class="spip_ancre">b) Les chaînes de langues</a></li><li> <a id="s-c-Transmission-d-arguments-de-personnalisation"></a><a href="#c-Transmission-d-arguments-de-personnalisation" class="spip_ancre">c) Transmission d'arguments de personnalisation</a></li></ul></li><li> <a id="s-t4-Restriction"></a><a href="#t4-Restriction" class="spip_ancre">4. Restriction</a></li></ul></div><h2 class="h2" id='t1-Objet-du-plugin'> 1. Objet du plugin<a class='sommaire-back sommaire-back-12' href='#s-t1-Objet-du-plugin' title='Back to the table of contents'></a></h2><h3 class="h3" id='a-Les-aides-existantes'> a) Les aides existantes<a class='sommaire-back sommaire-back-12' href='#s-a-Les-aides-existantes' title='Back to the table of contents'></a></h3> <p>Il y a beaucoup de façon de proposer de l'aide aux utilisateurs de vos plugins.</p> <ol class="spip" role="list"><li> Il y a tout d'abord la possibilité d'<a href='https://contrib.spip.net/Creer-une-aide-en-ligne-pour-un-plugin' class="spip_in" hreflang="fr">étendre l'aide en ligne de SPIP</a> ;</li><li> Il y a la possibilité de créer <i>un assistant de premiers pas</i> avec SPIP, <a href="https://plugins.spip.net/compagnon.html" class="spip_out" rel="external">Compagnon</a>.</li><li> Enfin, il y a la possibilité d'expliquer vous-même les champs de vos saisies, par une info bulle ou un label explicatif. Par exemple, le plugin <a href="https://plugins.spip.net/saisies.html" class="spip_out" rel="external">Saisies pour formulaires</a> propose un attribut <i>explication</i> rien que pour cela.</li></ol> <p>Le présent plugin vous propose une nouvelle façon d'apporter de l'aide en créant une bulle informative sur la partie gauche, par objet ou par exec.</p> <h3 class="h3" id='b-Les-avantages-et-inconvenients-de-la-nouvelle-aide-proposee'> b) Les avantages et inconvénients de la nouvelle aide proposée<a class='sommaire-back sommaire-back-12' href='#s-b-Les-avantages-et-inconvenients-de-la-nouvelle-aide-proposee' title='Back to the table of contents'></a></h3> <p>Cette aide présente l'inconvénient de venir proposer l'aide sur la partie gauche de la partie privée, ce qui peut provoquer une surabondance d'informations si votre plugin y affiche beaucoup d'éléments.</p> <p>Cette aide présente l'avantage :</p> <ul class="spip" role="list"><li> De répondre à un <strong>niveau d'information</strong> qui est celui de <i>l'Objet</i> ou de <i>l'Exec</i>. En d'autres termes, l'aide n'explique pas tous les champs d'un formulaire, ce qui est chronophage, mais l'objet lui-même, permettant d'aller à l'essentiel. On n'a donc pas à expliciter des étapes de saisies ou des détails sur des données mais simplement à expliquer <i>le traitement</i> fait.</li><li> L'aide est <strong>en permanence visible</strong>, ce qui répond à un besoin que ne remplit pas l'aide en ligne, qui sollicite un appel, ou l'aide de <i>premiers pas</i>, par vocation éphémère.</li></ul><h2 class="h2" id='t2-Installation-preferences-configuration'>2. Installation, préférences, configuration<a class='sommaire-back sommaire-back-12' href='#s-t2-Installation-preferences-configuration' title='Back to the table of contents'></a></h2> <p>Le plugin ne nécessite aucun autre plugin.</p> <h3 class="h3" id='a-Installation'> a) Installation<a class='sommaire-back sommaire-back-12' href='#s-a-Installation' title='Back to the table of contents'></a></h3> <p>Le plugin a été soumis sur la Zone. Il <a href="https://www.spip.net/fr_article3396.html" class="spip_out" rel="external">s'installe comme n'importe quel plugin de SPIP</a>.</p> <h3 class="h3" id='b-Preferences'> b) Préférences<a class='sommaire-back sommaire-back-12' href='#s-b-Preferences' title='Back to the table of contents'></a></h3> <p>Vos utilisateurs pourront par eux-même décider si vos bulles d'information sont utiles ou non. En effet, un auteur, dans ses préférences, peut retirer ou non cette fonctionnalité.</p> <div class='spip_document_19039 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h3 class="h3" id='c-Configuration'> c) Configuration<a class='sommaire-back sommaire-back-12' href='#s-c-Configuration' title='Back to the table of contents'></a></h3> <p>Il est possible de forcer la présence de l'aide, même si ce n'est pas très convivial, en accédant la configuration du plugin.</p> <div class='spip_document_19038 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/configuration_aide_par_objet.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div><h2 class="h2" id='t3-Utilisation-dans-votre-plugin'>3. Utilisation dans votre plugin<a class='sommaire-back sommaire-back-12' href='#s-t3-Utilisation-dans-votre-plugin' title='Back to the table of contents'></a></h2> <p>Votre plugin peut utiliser ce plugin. Il suffit de deux opérations :</p> <ul class="spip" role="list"><li> déclarer l'usage du plugin;</li><li> l'étendre à vos besoins par des chaînes de langue.</li></ul><h3 class="h3" id='a-La-dependance'> a) La dépendance<a class='sommaire-back sommaire-back-12' href='#s-a-La-dependance' title='Back to the table of contents'></a></h3> <p>Préciser la <a href="https://programmer.spip.net/Gestion-des-dependances" class="spip_out" rel="external">dépendance</a> dans votre plugin comme optionnelle, car le fait de ne pas pouvoir avoir d'aide contextuelle sur un objet ne devrait pas être bloquant ni nécessaire...</p> <p>L'attribut <code class='spip_code spip_code_inline' dir='ltr'>utilise</code> vous permettra de le faire dans la déclaration précitée le <code class='spip_code spip_code_inline' dir='ltr'>paquet.xml</code> définissant votre plugin.</p> <h3 class="h3" id='b-Les-chaines-de-langues'> b) Les chaînes de langues<a class='sommaire-back sommaire-back-12' href='#s-b-Les-chaines-de-langues' title='Back to the table of contents'></a></h3> <p>Créer un fichier déclarant les chaînes de langue que vous souhaitez voir afficher pour un objet, dans le répertoire <code class='spip_code spip_code_inline' dir='ltr'>lang/</code> et sous le nom <code class='spip_code spip_code_inline' dir='ltr'>aide_par_objet_fr</code> de votre plugin.</p> <p>La normalisation de la déclaration est la suivante :<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>[exec_ou_objet]_texte</code> qui correspond à la chaîne de langue qui affichera l'aide elle-même ;<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>[exec_ou_objet]_titre</code> qui correspond à la chaîne de langue qui affichera le titre de l'aide.</p> <p>Voici un exemple, pour l'exec <code class='spip_code spip_code_inline' dir='ltr'>configurer_aide_par_objet</code> que vous trouverez dans le fichier <code class='spip_code spip_code_inline' dir='ltr'>/lang/aide_par_objet_fr</code>.</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code> 'configurer_aide_par_objet_texte' => 'L'aide est une boite qui apparaitra à gauche lors de la consultation de l'objet ou de l'exec. Pour la mettre en oeuvre, il faut définir deux idiomes de langue, l'un intitulé <code>OBJET_titre</code> - qui sera le titre de la boite -, l'autre intitulé <code>OBJET_texte</code> - qui sera le contenu de la boite. Cette présente bulle d'aide est un exemple que vous trouverez dans le fichier <code>lang/aide_par_objet_fr</code> !<br><br>L'idiome <code>OBJET_titre</code> peut vous permettre de transmettre des arguments permettant de personnaliser la boite, en les plaçant dans les balises suivantes :<br><small>cadenas-24.svg</img><br><class>basic inverse</class><br><class_titre>centered</class_titre></small>', 'configurer_aide_par_objet_titre' => 'Comme ça marche ?',</code></pre></div><h3 class="h3" id='c-Transmission-d-arguments-de-personnalisation'> c) Transmission d'arguments de personnalisation<a class='sommaire-back sommaire-back-12' href='#s-c-Transmission-d-arguments-de-personnalisation' title='Back to the table of contents'></a></h3> <p>L'aide peut être personnalisée en transmettant des arguments<span class="spip_note_ref"> [<a href="#nb23-1" class="spip_note" rel="appendix" title="L'aide est une boite (#BOITE_OUVRIR #BOITE_FERMER) incluse par le pipeline . (…)" id="nh23-1">1</a>]</span>, en les plaçant dans les balises suivantes :<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'>cadenas-24.svg</img></code><br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'><class>basic inverse</class></code><br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'><class_titre>centered</class_titre></code></p> <p>Ces balises sont a incorporer dans l'idiome de langue <code class='spip_code spip_code_inline' dir='ltr'>OBJET_titre</code>.</p> <p>Exemple :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>'configurer_aide_par_objet_titre' => 'cadenas-24.svg</img><class>basic inverse</class><class_titre>centered</class_titre>Comme ça marche ?',</code></pre></div><h2 class="h2" id='t4-Restriction'>4. Restriction<a class='sommaire-back sommaire-back-12' href='#s-t4-Restriction' title='Back to the table of contents'></a></h2> <p>Il n'y a pas de restriction technique, mais simplement un usage de bon sens.<br class='autobr' /> <strong>N'écrivez pas un roman</strong>.</p> <ul class="spip" role="list"><li> Pour une raison <i>logique</i>, tout d'abord : une aide doit être brève et précise. Ce n'est pas très aidant d'avoir une explication qui demande réflexion...</li><li> Pour une raison <i>technique</i>, ensuite : si votre aide est trop longue elle monopolisera la partie gauche, empêchant d'autres fonctionnalités de s'afficher.</li></ul></div> <hr /> <div class='rss_notes'><div id="nb23-1"> <p><span class="spip_note_ref">[<a href="#nh23-1" class="spip_note" title="Footnotes 23-1" rev="appendix">1</a>] </span>L'aide est une boite (#BOITE_OUVRIR #BOITE_FERMER) incluse par le pipeline <code class='spip_code spip_code_inline' dir='ltr'>affiche_gauche</code>. Le fichier inclu est <code class='spip_code spip_code_inline' dir='ltr'>prive/objets/infos/inc-aide_par_objet.html</code>. Il est accompagné d'un fichier de fonctions.</p> </div></div> </article> <article> <h1>Albums</h1> <p>tetue — 2011-11-08T09:09:00Z</p> <div class='rss_chapo'><p>Ce plugin permet d'afficher une ou plusieurs galeries d'images au fil du texte, dans les articles et ailleurs.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d149ec35f1.73359339"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Insertion-d-un-album-au-fil-du-texte"></a><a href="#Insertion-d-un-album-au-fil-du-texte" class="spip_ancre">Insertion d'un album au fil du texte</a></li><li> <a id="s-Utilisation-dans-les-squelettes"></a><a href="#Utilisation-dans-les-squelettes" class="spip_ancre">Utilisation dans les squelettes</a></li><li> <a id="s-Structure-et-style-des-albums"></a><a href="#Structure-et-style-des-albums" class="spip_ancre">Structure et style des albums</a></li><li> <a id="s-Evolution-todolist"></a><a href="#Evolution-todolist" class="spip_ancre">Évolution / todolist</a></li></ul></div><div class='spip_document_10333 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="28" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/albums.png' class="spip_doc_lien mediabox" type="image/png"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10333 '><strong>Un portfolio… des albums ! </strong></div> </figcaption></figure> </div> <p>Qui rédige un récit de voyage, par exemple, aimerait pouvoir illustrer son article de plusieurs petites séries de photos, une par jour. Or SPIP ne permet de faire qu'un seul album photo par article, le « portfolio ». Ce plugin permet de créer et afficher plusieurs « albums » au fil du texte, au sein d'un même article. Et où bon vous semble.</p> <h2 class="h2" id='Insertion-d-un-album-au-fil-du-texte'>Insertion d'un album au fil du texte<a class='sommaire-back sommaire-back-4' href='#s-Insertion-d-un-album-au-fil-du-texte' title='Back to the table of contents'></a></h2> <p>Pour afficher un album dans un article, il suffit d'appeler le modèle homonyme, dans le champ de saisie, en indiquant les identifiants des documents voulus, comme ceci :</p> <p><code class='spip_code spip_code_inline' dir='ltr'><album|id=17,2,63,15></code></p> <p>Il est également possible d'afficher tous les documents d'un article (c'est-à-dire le « portfolio » SPIP d'un article), comme ceci :</p> <p><code class='spip_code spip_code_inline' dir='ltr'><album|id_article=211></code></p> <p>Il est possible de donner un titre à chaque album, comme ceci :</p> <p><code class='spip_code spip_code_inline' dir='ltr'><album|id=17,2,63,15|titre=Mon super titre, hé !></code></p> <p>C'est peu utile, mais il est possible d'aligner chaque album, comme on le fait pour les images et documents : en passant le paramètre <code class='spip_code spip_code_inline' dir='ltr'>center</code>, <code class='spip_code spip_code_inline' dir='ltr'>left</code> ou <code class='spip_code spip_code_inline' dir='ltr'>right</code>. Par exemple :</p> <p><code class='spip_code spip_code_inline' dir='ltr'><album|right|id=17,2,63,15></code></p> <h2 class="h2" id='Utilisation-dans-les-squelettes'>Utilisation dans les squelettes<a class='sommaire-back sommaire-back-4' href='#s-Utilisation-dans-les-squelettes' title='Back to the table of contents'></a></h2> <p>L'album s'insère dans les squelettes comme n'importe quel autre modèle, sans oublier de passer les id des documents voulus, comme suit :</p> <p><code class='spip_code spip_code_inline' dir='ltr'>#MODELE{album,id=17,2,63,15}</code></p> <p>Pour remplacer le portfolio par défaut de SPIP, sous l'article, on écrira :</p> <p><code class='spip_code spip_code_inline' dir='ltr'>[(#MODELE{album,id_article,env}{titre=<:info_portfolio:>})]</code></p> <h2 class="h2" id='Structure-et-style-des-albums'>Structure et style des albums<a class='sommaire-back sommaire-back-4' href='#s-Structure-et-style-des-albums' title='Back to the table of contents'></a></h2> <p>L'habituel « portfolio » de SPIP est remplacé par le modèle « album », afin d'homogénéiser le rendu et vous faciliter le travail. Ainsi style et structure sont les mêmes pour les albums insérés au fil du texte que pour portfolio qui fait suite à l'article.</p> <p><strong>Code généré</strong></p> <p>Un album est une liste de documents. Voici sa structure HTML de base :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><div class="album clearfix p right" id="album15"> <h2>Titre de l'album</h2> <ul> <li><a href="#"></a></li> <li>etc.</li> </ul> </div></code></pre></div> <p><strong>Habillage CSS</strong></p> <p>- <code class='spip_code spip_code_inline' dir='ltr'>.clearfix</code>, <code class='spip_code spip_code_inline' dir='ltr'>.p</code>, <code class='spip_code spip_code_inline' dir='ltr'>.left</code>, <code class='spip_code spip_code_inline' dir='ltr'>.right</code> et <code class='spip_code spip_code_inline' dir='ltr'>.center</code> : étant déjà définis dans les feuilles de styles de la dist ou dans votre framework CSS de prédilection, il est inutile (et déconseillé) de les redéfinir dans ce plugin. S'il vous font défaut, déclarez-les dans vos propres feuilles de styles, en prenant modèle sur la dist de SPIP3. <br />- C'est le sélecteur <strong><code class='spip_code spip_code_inline' dir='ltr'>.album</code></strong> que vous utiliserez pour cibler tous les albums d'un coup et les habiller à votre goût.</p> <p>Pour personnaliser, vous pouvez déposer votre CSS dans une feuille de style nommée « <strong><code class='spip_code spip_code_inline' dir='ltr'>album.css</code></strong> » dans le sous-répertoire <code class='spip_code spip_code_inline' dir='ltr'>/css</code> de votre dossier <code class='spip_code spip_code_inline' dir='ltr'>squelettes</code>.</p> <h2 class="h2" id='Evolution-todolist'>Évolution / todolist<a class='sommaire-back sommaire-back-4' href='#s-Evolution-todolist' title='Back to the table of contents'></a></h2> <p>Cette première version du plugin ne fait que se greffer sur la dist de SPIP pour proposer un modèle d'insertion d'album. Ce plugin devrait évoluer pour <br />- être complété d'un objet SPIP « album » de façon à <br />- pouvoir constituer des albums<span class="spip_note_ref"> [<a href="#nb24-_2A" class="spip_note" rel="appendix" title="Un album est un ensemble de documents, que l'on peut afficher en galerie (ou (…)" id="nh24-_2A">*</a>]</span> dans la médiathèque avant de <br />- les insérer plus simplement dans les articles, via le raccourci « <code class='spip_code spip_code_inline' dir='ltr'><album25></code> ».</p> <div class='spip_document_10153 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="110" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10153 '><strong>Un même document peut appartenir à deux albums différents </strong></div> <div class='spip_doc_descriptif crayon document-descriptif-10153 '>Voir : <a href="http://romy.tetue.net/557" class="spip_out" rel="external">Mais où est passée la médiathèque de SPIP ?</a> </div> </figcaption></figure> </div></div> <hr /> <div class='rss_notes'><div id="nb24-_2A"> <p><span class="spip_note_ref">[<a href="#nh24-_2A" class="spip_note" title="Footnotes 24-_2A" rev="appendix">*</a>] </span>Un <dfn>album</dfn> est un ensemble de documents, que l'on peut afficher en galerie (ou en liste) au fil du texte, dans un article ou ailleurs.</p> </div></div> </article> <article> <h1>Albums 3</h1> <p>tcharlss — 2014-08-08T08:30:00Z</p> <div class='rss_chapo'><p>Le plugin «Albums» évolue dans une version 3 pour SPIP 3.</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-13" id="nav6a60d14a071737.43700602"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Evolutions"></a><a href="#Evolutions" class="spip_ancre">Évolutions</a></li><li> <a id="s-Des-albums-pour-quoi-faire"></a><a href="#Des-albums-pour-quoi-faire" class="spip_ancre">Des albums, pour quoi faire ?</a></li><li> <a id="s-Installation-amp-configuration"></a><a href="#Installation-amp-configuration" class="spip_ancre">Installation & configuration</a></li><li> <a id="s-Utilisation"></a><a href="#Utilisation" class="spip_ancre">Utilisation</a></li><li> <a id="s-Gestion-des-albums-sur-la-fiche-d-un-objet"></a><a href="#Gestion-des-albums-sur-la-fiche-d-un-objet" class="spip_ancre">Gestion des albums sur la fiche d'un objet</a></li><li> <a id="s-Gestion-des-albums-lors-de-l-edition-d-un-objet"></a><a href="#Gestion-des-albums-lors-de-l-edition-d-un-objet" class="spip_ancre">Gestion des albums lors de l'édition d'un objet</a></li><li> <a id="s-Les-modeles"></a><a href="#Les-modeles" class="spip_ancre">Les modèles</a></li><li> <a id="s-Albumotheque"></a><a href="#Albumotheque" class="spip_ancre">Albumothèque</a></li><li> <a id="s-Deplacer-des-documents-entre-albums-par-cliquer-glisser"></a><a href="#Deplacer-des-documents-entre-albums-par-cliquer-glisser" class="spip_ancre">Déplacer des documents entre albums par cliquer-glisser</a></li><li> <a id="s-Boucles-amp-criteres"></a><a href="#Boucles-amp-criteres" class="spip_ancre">Boucles & critères</a></li><li> <a id="s-Autorisations"></a><a href="#Autorisations" class="spip_ancre">Autorisations</a></li><li> <a id="s-Retro-compatibilite"></a><a href="#Retro-compatibilite" class="spip_ancre">Rétro-compatibilité</a></li><li> <a id="s-Parametrage-fin-par-les-constantes"></a><a href="#Parametrage-fin-par-les-constantes" class="spip_ancre">Paramétrage fin par les constantes</a></li></ul></div></p> <p class="notice">Avant d'effectuer une mise à jour depuis la version 1 ou 2, consultez les notes sur la <a href="#retro_compatibilite" class="spip_ancre">rétro-compatibilité</a>. Les modèles, notamment, on reçut quelques changements pour la bonne cause.</p> <p>En préambule, une courte vidéo de présentation.<br class='autobr' /> Si vous rencontrez des difficultés pour la lecture, rendez vous sur <a href="https://medias.spip.net/medias/video-tutorials/article/plugin-albums-3" class="spip_out" rel="external">medias.spip.net</a> où le fichier source est téléchargeable.</p> <div class="spip_document_13818 spip_document spip_documents spip_document_video spip_documents_center spip_document_center"> <figure class="spip_doc_inner"> <div class="video-intrinsic-wrapper" style='height:0;width:600px;max-width:100%;padding-bottom:57.83%;position:relative;'> <div class="video-wrapper" style="position: absolute;top:0;left:0;width:100%;height:100%;"> </video> </div> </div> <div class="base64javascript20357411656a60d149f2c8b6.58022690" title="PHNjcmlwdD4gdmFyIG1lanNwYXRoPSdwbHVnaW5zLWRpc3QvZGlzdC9jb3JlL21lZGlhcy9saWIvbWVqcy9tZWRpYWVsZW1lbnQtYW5kLXBsYXllci5taW4uanM/MTc4NDU1MzM0MCcsbWVqc2Nzcz0ncGx1Z2lucy1kaXN0L2Rpc3QvY29yZS9tZWRpYXMvbGliL21lanMvbWVkaWFlbGVtZW50cGxheWVyLm1pbi5jc3M/MTc4NDU1MzM0MCc7CnZhciBtZWpzbG9hZGVyOwooZnVuY3Rpb24oKXt2YXIgYT1tZWpzbG9hZGVyOyJ1bmRlZmluZWQiPT10eXBlb2YgYSYmKG1lanNsb2FkZXI9YT17Z3M6bnVsbCxwbHVnOnt9LGNzczp7fSxpbml0Om51bGwsYzowLGNzc2xvYWQ6bnVsbH0pO2EuaW5pdHx8KGEuY3NzbG9hZD1mdW5jdGlvbihjKXtpZigidW5kZWZpbmVkIj09dHlwZW9mIGEuY3NzW2NdKXthLmNzc1tjXT0hMDt2YXIgYj1kb2N1bWVudC5jcmVhdGVFbGVtZW50KCJsaW5rIik7Yi5ocmVmPWM7Yi5yZWw9InN0eWxlc2hlZXQiO2IudHlwZT0idGV4dC9jc3MiO2RvY3VtZW50LmdldEVsZW1lbnRzQnlUYWdOYW1lKCJoZWFkIilbMF0uYXBwZW5kQ2hpbGQoYil9fSxhLmluaXQ9ZnVuY3Rpb24oKXshMD09PWEuZ3MmJmZ1bmN0aW9uKGMpe2pRdWVyeSgiYXVkaW8ubWVqcyx2aWRlby5tZWpzIikubm90KCIuZG9uZSwubWVqc19fcGxheWVyIikuZWFjaChmdW5jdGlvbigpe2Z1bmN0aW9uIGIoKXt2YXIgZT0hMCxoO2ZvcihoIGluIGQuY3NzKWEuY3NzbG9hZChkLmNzc1toXSk7Zm9yKHZhciBmIGluIGQucGx1Z2lucykidW5kZWZpbmVkIj09CnR5cGVvZiBhLnBsdWdbZl0/KGU9ITEsYS5wbHVnW2ZdPSExLGpRdWVyeS5nZXRTY3JpcHQoZC5wbHVnaW5zW2ZdLGZ1bmN0aW9uKCl7YS5wbHVnW2ZdPSEwO2IoKX0pKTowPT1hLnBsdWdbZl0mJihlPSExKTtlJiZqUXVlcnkoIiMiK2MpLm1lZGlhZWxlbWVudHBsYXllcihqUXVlcnkuZXh0ZW5kKGQub3B0aW9ucyx7c3VjY2VzczpmdW5jdGlvbihhLGMpe2Z1bmN0aW9uIGIoKXt2YXIgYj1qUXVlcnkoYSkuY2xvc2VzdCgiLm1lanNfX2lubmVyIik7YS5wYXVzZWQ/KGIuYWRkQ2xhc3MoInBhdXNpbmciKSxzZXRUaW1lb3V0KGZ1bmN0aW9uKCl7Yi5maWx0ZXIoIi5wYXVzaW5nIikucmVtb3ZlQ2xhc3MoInBsYXlpbmciKS5yZW1vdmVDbGFzcygicGF1c2luZyIpLmFkZENsYXNzKCJwYXVzZWQiKX0sMTAwKSk6Yi5yZW1vdmVDbGFzcygicGF1c2VkIikucmVtb3ZlQ2xhc3MoInBhdXNpbmciKS5hZGRDbGFzcygicGxheWluZyIpfWIoKTthLmFkZEV2ZW50TGlzdGVuZXIoInBsYXkiLGIsITEpOwphLmFkZEV2ZW50TGlzdGVuZXIoInBsYXlpbmciLGIsITEpO2EuYWRkRXZlbnRMaXN0ZW5lcigicGF1c2UiLGIsITEpO2EuYWRkRXZlbnRMaXN0ZW5lcigicGF1c2VkIixiLCExKTtnLmF0dHIoImF1dG9wbGF5IikmJmEucGxheSgpfX0pKX12YXIgZz1qUXVlcnkodGhpcykuYWRkQ2xhc3MoImRvbmUiKSxjOyhjPWcuYXR0cigiaWQiKSl8fChjPSJtZWpzLSIrZy5hdHRyKCJkYXRhLWlkIikrIi0iK2EuYysrLGcuYXR0cigiaWQiLGMpKTt2YXIgZD17b3B0aW9uczp7fSxwbHVnaW5zOnt9LGNzczpbXX0sZSxoO2ZvcihlIGluIGQpaWYoaD1nLmF0dHIoImRhdGEtbWVqcyIrZSkpZFtlXT1qUXVlcnkucGFyc2VKU09OKGgpO2IoKX0pfShqUXVlcnkpfSk7YS5nc3x8KCJ1bmRlZmluZWQiIT09dHlwZW9mIG1lanNjc3MmJmEuY3NzbG9hZChtZWpzY3NzKSxhLmdzPWpRdWVyeS5nZXRTY3JpcHQobWVqc3BhdGgsZnVuY3Rpb24oKXthLmdzPSEwO2EuaW5pdCgpO2pRdWVyeShhLmluaXQpO29uQWpheExvYWQoYS5pbml0KX0pKX0pKCk7PC9zY3JpcHQ+"></div> </figure> </div> <p><a id="evolutions"></a></p> <h2 class="h2" id='Evolutions'>Évolutions<a class='sommaire-back sommaire-back-13' href='#s-Evolutions' title='Back to the table of contents'></a></h2><ul class="spip" role="list"><li> v3.6.0 : permet de réordonner les documents des albums par glisser-déposer</li></ul> <p><a id="presentation"></a></p> <h2 class="h2" id='Des-albums-pour-quoi-faire'>Des albums, pour quoi faire ?<a class='sommaire-back sommaire-back-13' href='#s-Des-albums-pour-quoi-faire' title='Back to the table of contents'></a></h2> <p><a href='https://contrib.spip.net/Albums' class="spip_in" hreflang="fr">Dans sa première version</a>, le plugin permettait d'insérer des galeries d'images au fil du texte, dans les articles.</p> <p>Depuis <a href="#v2" class="spip_ancre">la version 2</a>, les albums sont des objets éditoriaux à part entière, aussi la portée du plugin est plus générale : il sert à la gestion de groupes de documents.</p> <p>⇒ <strong>Des groupes de documents</strong></p> <p>Un album, c'est donc un conteneur pour une série de documents.<br class='autobr' /> Précisons le bien, si le terme «album» évoque des albums d'images, il peut contenir tout type de document : images, bandes-son, vidéos et autres.<br class='autobr' /> Un même document peut appartenir à plusieurs albums : toutes sortes de combinaisons sont envisageables.</p> <div class='spip_document_11774 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="32" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/principe_albums.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11774 '><strong>Albums are groups of documents</strong></div> </figcaption></figure> </div> <p>⇒ <strong>Albums et documents liés à un objet</strong></p> <p>En SPIP 3, les documents liés à un objet sont présentés sous forme de 3 groupes : «illustrations», «portfolio» et «documents». Leur finalité est expliquée <a href="https://www.spip.net/fr_article5632.html" class="spip_out" rel="external">dans cet article</a>, mais retenons qu'il s'agit d'une séparation arbitraire pensée pour les articles.<br class='autobr' /> Dans cette documentation, on va se référer à ces documents comme des documents «individuels», par opposition au documents regroupés au sein d'albums.</p> <p>Les documents individuels et les albums sont indépendants et n'ont pas d'incidence l'un sur l'autre : on peut continuer à gérer les documents individuels comme avant.<br class='autobr' /> En pratique, vous avez le choix au moment d'ajouter des documents à un objet : ils peuvent être ajoutés individuellement, ou regroupés au sein d'albums.</p> <div class='spip_document_11773 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="80" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/principe_albums_et_documents.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11773 '><strong>Albums et documents liés</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11773 '>Documents individuels et regroupés aux seins d'albums</div> </figcaption></figure> </div> <p><a id="installation"></a></p> <h2 class="h2" id='Installation-amp-configuration'>Installation & configuration<a class='sommaire-back sommaire-back-13' href='#s-Installation-amp-configuration' title='Back to the table of contents'></a></h2> <p>L'installation se fait <a href="https://www.spip.net/fr_article3396.html" class="spip_out" rel="external">comme n'importe que plugin</a>.<br class='autobr' /> 2 tables vont être ajoutées : <code class='spip_code spip_code_inline' dir='ltr'>spip_albums</code> et <code class='spip_code spip_code_inline' dir='ltr'>spip_albums_liens</code>.</p> <p>Des plugins supplémentaires doivent être installés si vous souhaitez bénéficier du formulaire qui permet de <a href="#personnaliser_balise" class="spip_ancre">personnaliser les balises <album></a> à insérer dans le texte. Il s'agit de dépendances <strong>optionnelles</strong>.</p> <ul class="spip" role="list"><li> <a href='https://contrib.spip.net/Le-plugin-YAML' class="spip_in" hreflang="fr">YAML</a> : <a href="https://files.spip.net/spip-zone/yaml.zip" class="spip_out" rel="external">télécharger</a></li><li> <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">Saisies</a> : <a href="https://files.spip.net/spip-zone/saisies_v2.zip" class="spip_out" rel="external">télécharger</a></li><li> <a href='https://contrib.spip.net/Verifier' class="spip_in" hreflang="fr">Vérifier</a> : <a href="https://files.spip.net/spip-zone/verifier.zip" class="spip_out" rel="external">télécharger</a></li></ul> <p>Une fois l'installation effectuée, un passage sur la page de configuration est ensuite nécessaire. Elle est constituée de 2 onglets.</p> <p>⇒ <strong>Onglet «options»</strong><br class='autobr' /> L'option principale permet de définir sur quels objets les albums pourront être ajoutés.<br class='autobr' /> 2 autres options permettent de proposer un titre par défaut lorsqu'on ajoute un nouvel album à un objet, et d'activer le déplacement de documents par <a href="#dragdrop" class="spip_ancre">cliquer-glisser</a>.</p> <p>⇒ <strong>Onglet «outils»</strong><br class='autobr' /> Un formulaire permet de migrer des articles en albums.<br class='autobr' /> Il est prévu dans le cas où l'on se servait d'articles comme de pseudo albums, et se charge de créer des vrais albums à l'identique à partir de ceux-ci.</p> <p><a id="utilisation"></a></p> <h2 class="h2" id='Utilisation'>Utilisation<a class='sommaire-back sommaire-back-13' href='#s-Utilisation' title='Back to the table of contents'></a></h2> <p>Les albums peuvent être autonomes ou liés à d'autres objets éditoriaux.</p> <p>⇒ Dans le cas d'albums autonomes, on les créera depuis la barre d'outil rapide ou depuis la page des albums, comme n'importe quel objet éditorial.</p> <p>⇒ Dans le cas d'albums liés à des objet éditoriaux, leur gestion est assez similaire à celle des documents : on peut gérer les albums depuis la fiche d'un objet ou lorsque celui-ci est en cours d'édition.</p> <p><a id="fiche_objet"></a></p> <h2 class="h2" id='Gestion-des-albums-sur-la-fiche-d-un-objet'>Gestion des albums sur la fiche d'un objet<a class='sommaire-back sommaire-back-13' href='#s-Gestion-des-albums-sur-la-fiche-d-un-objet' title='Back to the table of contents'></a></h2> <p>Sur la fiche d'un objet éditorial, les albums font suite aux documents. L'interface permet d'ajouter de nouveaux albums ou des albums existants, d'éditer leur texte et de manipuler leurs documents.</p> <div class='spip_document_11770 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="93" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/albums_et_documents.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11770 '><strong>Albums et documents liés</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11770 '>1) documents «individuels» 2) documents regroupés au sein d'albums</div> </figcaption></figure> </div> <p>⇒ <strong>Ajouter des albums</strong></p> <p>Le bouton «Ajouter un album» fait apparaître un formulaire proposant deux méthodes<span class="spip_note_ref"> [<a href="#nb26-1" class="spip_note" rel="appendix" title="Techniquement, le formulaire «ajouter_album» est une fusion des formulaires (…)" id="nh26-1">1</a>]</span> :</p> <div class='spip_document_12437 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Créer et remplir un nouvel album. Titre et descriptif sont optionnels : laissé vide, le titre sera rempli à posteriori avec «Nouvel album N° X».</p> <div class='spip_document_12438 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Choisir un ou plusieurs albums existants : on peut parcourir la liste, ou rentrer directement les numéros des albums.</p> <div class='spip_document_11777 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="119" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/ajouter_album.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11777 '><strong>Ajouter un album à un objet éditorial</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11777 '>1) Créer et remplir un nouvel album 2) Choisir un ou plusieurs albums existants</div> </figcaption></figure> </div> <p>⇒ <strong>Editer un album sur place</strong></p> <p>Les albums peuvent être édités sur place. Pour l'édition complète (gestion des auteurs, des mots-clés etc.), on se rendra sur leur fiche.</p> <div class='spip_document_12437 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Editer le texte : une icône apparaît au survol du header, elle permet d'afficher le formulaire d'édition du titre et du descriptif.</p> <div class='spip_document_12438 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Ajouter des documents : un lien situé en bas fait apparaître le formulaire d'ajout de documents.</p> <div class='spip_document_12439 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Manipuler les documents : les boutons d'édition apparaissent au survol de chaque document.</p> <p>Il est également possible, sous certaines conditions, de déplacer des documents entre albums par <a href="#dragdrop" class="spip_ancre">cliquer-glisser</a>.</p> <div class='spip_document_11775 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="108" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/edition_album.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11775 '><strong>Édition rapide d'un album</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11775 '>1) Editer titre et descriptif 2) Ajouter des documents 3) Modifier les documents</div> </figcaption></figure> </div> <p>⇒ <strong>Retirer des albums</strong></p> <p>Pour retirer un album, cliquer sur le bouton qui apparaît au survol, en bas de chaque album.<br class='autobr' /> Lorsqu'il y a plusieurs albums, un bouton présent à la fin de la liste permet de tous les retirer d'un coup.</p> <p><a id="edition_objet"></a></p> <h2 class="h2" id='Gestion-des-albums-lors-de-l-edition-d-un-objet'>Gestion des albums lors de l'édition d'un objet<a class='sommaire-back sommaire-back-13' href='#s-Gestion-des-albums-lors-de-l-edition-d-un-objet' title='Back to the table of contents'></a></h2> <p>Pendant l'édition d'un objet, la gestion des albums s'opère au même endroit que celle des documents, dans la colonne de gauche.<br class='autobr' /> Quand l'objet peut recevoir à la fois des documents et des albums, un menu permet de basculer entre les deux.</p> <div class='spip_document_12440 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="97" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/edition_objet.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12440 '><strong>Albums et documents lors de l'édition d'un objet</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-12440 '>1) Gestion des documents 2) Gestion des albums</div> </figcaption></figure> </div> <p>⇒ <strong>Ajouter, éditer et retirer les albums</strong></p> <p>On gère les albums de la même façon que lorsqu'on se trouve sur la fiche de l'objet : même formulaire pour ajouter des documents, mêmes possibilités pour éditer les albums et manipuler leur documents.</p> <p><a id="personnaliser_balise"></a><br class='autobr' /> ⇒ <strong>Insertion des balises <album> dans le texte</strong></p> <p>Les albums insérés dans le texte au moyen de la balise <albumX> seront automatiquement associés à l'objet : ce comportement est similaire à celui des balises <doc>, et <emb> des documents.</p> <p>Un formulaire permet de personnaliser les balises de chaque album : choix de la variante, alignement, <a href="#parametres_modeles" class="spip_ancre">paramètres des modèles,</a> etc.</p> <p><strong>Important</strong> : pour bénéficier de cette fonctionnalité, des plugins supplémentaires doivent être installés. Consultez la section sur <a href="#installation" class="spip_ancre">l'installation</a>.</p> <div class='spip_document_12441 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="152" data-legende-lenx="xxx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/edition_balise.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12441 '><strong>Personnaliser la balise d'un album</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-12441 '>En mode édition, un formulaire permet de personnaliser la balise de chaque album en vue de l'insérer dans le texte.</div> </figcaption></figure> </div> <p><a id="modeles"></a></p> <h2 class="h2" id='Les-modeles'>Les modèles<a class='sommaire-back sommaire-back-13' href='#s-Les-modeles' title='Back to the table of contents'></a></h2><p class="notice">L'apparence, la structure et certains paramètres évoluent par rapport aux versions 1 et 2. Consultez les notes sur la <a href="#retro_compatibilite" class="spip_ancre">rétro-compatibilité</a>.</p> <p>2 modèles «album» sont proposés : le modèle de base est une vue en vignettes, complété d'une variante avec une vue en liste.<br class='autobr' /> Par défaut, ces 2 modèles produisent un affichage minimaliste : titre, descriptif, et autres éléments “superflus” ne sont pas affichés à moins d'utiliser les paramètres adéquats (détaillés <a href="#parametres_modeles" class="spip_ancre">plus bas</a>).<br class='autobr' /> De même, <a href="http://zone.spip.org/trac/spip-zone/browser/_plugins_/albums/trunk/css/albums.css" class="spip_out" rel="external">la feuille de style</a> chargée sur le site public ne contient que le strict minimum.</p> <p>Ces 2 modèles ne prétendent pas répondre à tous les cas de figure. Les usages possibles sont trop vastes pour être tous pris en compte par un modèle générique : listes de lecture audio ou vidéo, diaporamas, etc.<br class='autobr' /> Pour vos besoins spécifiques, <a href="#ajouter_modeles" class="spip_ancre">ajoutez des variantes du modèle</a>.</p> <p>⇒ <strong>Modèle <album> : vue en vignettes</strong></p> <div class='spip_document_11769 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="44" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/modele_vignettes.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11769 '><strong>Modèle album par défaut : vue en vignettes</strong></div> </figcaption></figure> </div> <p>Ce modèle est prévu pour afficher des séries d'images : les documents sont affichés sous forme de vignettes cliquables.<br class='autobr' /> Il est basé sur <a href="http://tinytypo.tetue.net/tinytypo.html#album" class="spip_out" rel="external">Tiny Typo</a>, la base CSS de <a href="http://romy.tetue.net/" class="spip_out" rel="external">Romy Têtue</a>.<br class='autobr' /> Les images peuvent être retaillées et recadrées pour obtenir un affichage uniforme, par défaut elles sont retaillées selon une hauteur de 100 pixels.</p> <p>La structure HTML de base est la suivante (avec <a href="http://www.spip.net/fr_article5057.html" class="spip_out" rel="external">#HTML5</a> activé) :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><figure class="album vignettes figure"> <ul> <li> <a href="#"></a> </li> </ul> <figcaption>...</figcaption> </figure></code></pre></div> <p>⇒ <strong>Modèle <album|liste> : vue en liste</strong></p> <div class='spip_document_12411 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="44" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/modele_liste.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12411 '><strong>Modèle album, variante sous forme de liste</strong></div> </figcaption></figure> </div> <p>Cette variante affiche les documents sous forme d'une simple liste. Elle est donc adaptée à tout type de documents.</p> <p>La structure HTML de base est la suivante :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><div class="album liste"> <ul class="spip"> <li> <a href="#">...</a> </li> </ul> </div></code></pre></div> <p><a id="parametres_modeles"></a><br class='autobr' /> ⇒ <strong>Paramètres des modèles</strong></p> <table class="table spip"> <caption>Paramètres communs aux 2 modèles</caption> <thead><tr class='row_first'><th id='iddccf_c0'> Paramètre </th><th id='iddccf_c1'> Description </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='iddccf_c0'><code class='spip_code spip_code_inline' dir='ltr'>titre</code></td> <td headers='iddccf_c1'>«oui» pour afficher le titre<br>N'importe quelle chaîne pour un titre personnalisé.</td></tr> <tr class='row_even even'> <td headers='iddccf_c0'><code class='spip_code spip_code_inline' dir='ltr'>balise_titre</code></td> <td headers='iddccf_c1'>Pour encapsuler le titre dans une balise, sans les chevrons.<br>→ strong, h4, etc.</td></tr> <tr class='row_odd odd'> <td headers='iddccf_c0'><code class='spip_code spip_code_inline' dir='ltr'>descriptif</code></td> <td headers='iddccf_c1'>«oui» pour afficher le descriptif</td></tr> <tr class='row_even even'> <td headers='iddccf_c0'><code class='spip_code spip_code_inline' dir='ltr'>par</code></td> <td headers='iddccf_c1'>Tri des documents, défaut : «titre»<br>→ date, titre, media, fichier, extension, taille</td></tr> <tr class='row_odd odd'> <td headers='iddccf_c0'><code class='spip_code spip_code_inline' dir='ltr'>media</code></td> <td headers='iddccf_c1'>Pour restreindre à un type de document <br>→ image, file, audio, video</td></tr> </tbody> </table><table class="table spip"> <caption>Paramètres propres à la variante «vignettes»</caption> <thead><tr class='row_first'><th id='id71cb_c0'> Paramètre </th><th id='id71cb_c1'> Description </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='id71cb_c0'><code class='spip_code spip_code_inline' dir='ltr'>largeur</code></td> <td headers='id71cb_c1'>Largeur maximale des vignettes</td></tr> <tr class='row_even even'> <td headers='id71cb_c0'><code class='spip_code spip_code_inline' dir='ltr'>hauteur</code></td> <td headers='id71cb_c1'>Hauteur maximale des vignettes, défaut: 100 (pixels)</td></tr> <tr class='row_odd odd'> <td headers='id71cb_c0'><code class='spip_code spip_code_inline' dir='ltr'>recadrer</code></td> <td headers='id71cb_c1'>«oui» pour recadrer les images</td></tr> <tr class='row_even even'> <td headers='id71cb_c0'><code class='spip_code spip_code_inline' dir='ltr'>label</code></td> <td headers='id71cb_c1'>«oui» pour afficher le titre de chaque document</td></tr> </tbody> </table><table class="table spip"> <caption>Paramètres propres à la variante «liste»</caption> <thead><tr class='row_first'><th id='idde14_c0'> Paramètre </th><th id='idde14_c1'> Description </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='idde14_c0'><code class='spip_code spip_code_inline' dir='ltr'>metas</code></td> <td headers='idde14_c1'>«oui» pour afficher les infos complémentaires de chaque fichier, ou une liste d'éléments séparés par des virgules : <br>→ extension, taille, dimensions</td></tr> </tbody> </table> <p><a id="ajouter_modeles"></a><br class='autobr' /> ⇒ <strong>Ajouter des modèles</strong></p> <p>Pour que vos propres variantes du modèle soient prises en compte par <a href="#personnaliser_balise" class="spip_ancre">le formulaire de personnalisation des balises</a>, il faut créer un fichier YAML en plus du squelette HTML.</p> <p>Ce fonctionnement est inspiré par celui du plugin <a href='https://contrib.spip.net/Plugin-Inserer-Modeles' class="spip_in" hreflang="fr">Insérer Modèles</a> : chaque fichier YAML décrit le modèle et ses paramètres, sous forme de saisies. <a href='https://contrib.spip.net/Comment-declarer-un-modele-pour-le-plugin-Inserer' class="spip_in" hreflang="fr">La syntaxe</a> est identique, avec toutefois 2 éléments supplémentaires :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>alias</code> : nom de la variante</li><li> <code class='spip_code spip_code_inline' dir='ltr'>description</code> : description de la variante (optionnelle)</li></ul> <p>Pour assurer la compatibilité avec le plugin cité plus haut, 4 paramètres sont obligatoires : <code class='spip_code spip_code_inline' dir='ltr'>modele</code>, <code class='spip_code spip_code_inline' dir='ltr'>id_modele</code>, <code class='spip_code spip_code_inline' dir='ltr'>id_album</code> et <code class='spip_code spip_code_inline' dir='ltr'>variante</code>.<br class='autobr' /> Les 3 premiers étant identiques pour toutes les variantes, ils sont regroupés dans un fichier <i>inc-yaml/album-compat.yaml</i> qu'il suffit d'inclure.</p> <p>Pour les saisies, une option supplémentaire <code class='spip_code spip_code_inline' dir='ltr'>config</code> permet d'avoir comme valeur par défaut un réglage stocké dans la table <code class='spip_code spip_code_inline' dir='ltr'>spip_meta</code>. <br class='autobr' /> Dans l'idée, <code class='spip_code spip_code_inline' dir='ltr'>config:'truc'</code> revient à faire <code class='spip_code spip_code_inline' dir='ltr'>'defaut'=>lire_config('truc')</code> en php.</p> <p><strong>Exemple</strong> : Imaginons un plugin fournissant une variante «diaporama».<br class='autobr' /> Ce modèle accepterait entre autre un paramètre <code class='spip_code spip_code_inline' dir='ltr'>vitesse</code> dont la valeur par défaut serait enregistrée dans une méta du plugin. Le squelette HTML serait nommé <i>album_diaporama.html</i> et le fichier YAML <i>album_diaporama.yaml</i>.<br class='autobr' /> Ce dernier ressemblerait à ça :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>nom: 'un album (diaporama)' logo: 'prive/themes/spip/images/album-24.png' icone_barre: 'album-diaporama.png' alias: 'Diaporama' parametres: - 'inclure:inc-yaml/album-compat.yaml' - saisie: 'hidden' options: nom: 'variante' defaut: 'diaporama' - saisie: 'input' options: nom: 'vitesse' config: 'plugin/vitesse' - le reste des saisies...</code></pre></div> <p>En cas de doute, vous pouvez prendre <a href="http://zone.spip.org/trac/spip-zone/browser/_plugins_/albums/trunk/modeles/album_liste.yaml" class="spip_out" rel="external">la variante «liste»</a> comme référence.</p> <p><a id="albumotheque"></a></p> <h2 class="h2" id='Albumotheque'>Albumothèque<a class='sommaire-back sommaire-back-13' href='#s-Albumotheque' title='Back to the table of contents'></a></h2><div class='spip_document_12436 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="14" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/albumotheque.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12436 '><strong>Albumothèque</strong></div> </figcaption></figure> </div> <p>L'albumothèque est l'équivalent de la médiathèque, pour les albums.</p> <p>Les filtres situés dans la colonne de gauche sont prévus pour sélectionner les albums en fonction de leurs documents et de leurs liaisons avec les objets : articles, auteurs, mots-clés etc. Attention, il ne s'agit pas de menus, mais bien de filtres : un clic pour activer, un autre pour désactiver.</p> <p>Des champs avec autocomplétion permettent de trouver un objet précis.<br class='autobr' /> Par exemple, pour afficher les albums liés à un article en particulier, il faut cliquer sur l'icône à droite du filtre «articles», puis rentrer les premières lettres du titre ou son numéro : les articles correspondants vont apparaître dans une liste déroulante, cliquer sur un résultat va mettre à jour la liste des albums.<br class='autobr' /> La fontion d'autocomplétion ne va chercher que les objets ayant un lien avec les albums.</p> <div class='spip_document_12435 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="105" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/filtres.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12435 '><strong>Albumothèque : filtres</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-12435 '>Des champs avec autocomplétion permettent de trouver les objets liés aux albums.</div> </figcaption></figure> </div> <p><a id="dragdrop"></a></p> <h2 class="h2" id='Deplacer-des-documents-entre-albums-par-cliquer-glisser'>Déplacer des documents entre albums par cliquer-glisser<a class='sommaire-back sommaire-back-13' href='#s-Deplacer-des-documents-entre-albums-par-cliquer-glisser' title='Back to the table of contents'></a></h2> <p>Il est possible de déplacer les documents entre albums par cliquer-glisser. L'option doit être activée dans la page de configuration, et vous devez y avoir <a href="#autorisations" class="spip_ancre">l'autorisation</a>.</p> <p>Gardez en tête qu'il s'agit d'une fonctionnalité un peu expérimentale !</p> <p>Lorsqu'on entame le déplacement d'un document, les albums pouvant recevoir celui-ci sont surlignés d'une bordure verte, il suffit d'y relacher le document. Dès qu'un document à été déplacé, un formulaire apparaît en bas de la liste pour enregistrer les modifications. On peut cependant effectuer plusieurs déplacement d'affilée avant de les enregistrer.</p> <p>Notez qu'il est possible de manipuler également les documents «individuels» liés aux objets.</p> <div class='spip_document_11778 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="149" data-legende-lenx="xxx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/deplacer_documents.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11778 '><strong>Déplacer des documents entre albums par cliquer-glisser</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11778 '>1) Effectuer un ou plusieurs déplacements 2) Valider avec le formulaire qui apparaît en bas</div> </figcaption></figure> </div> <p><a id="boucles"></a></p> <h2 class="h2" id='Boucles-amp-criteres'>Boucles & critères<a class='sommaire-back sommaire-back-13' href='#s-Boucles-amp-criteres' title='Back to the table of contents'></a></h2> <p>⇒ <strong>Critère <code class='spip_code spip_code_inline' dir='ltr'>{orphelins}</code></strong></p> <p>Le critère <code class='spip_code spip_code_inline' dir='ltr'>{orphelins}</code> permet de sélectionner les albums sans lien avec un objet éditorial (on qualifiait ces albums «d'autonomes» plus haut).</p> <p>⇒ <strong>Jointures</strong></p> <p>Les albums ont une jointure automatique pour tous les objets (cf. <a href="http://zone.spip.org/trac/spip-zone/browser/_plugins_/albums/trunk/base/albums.php#L93" class="spip_out" rel="external">déclaration de la base</a>).</p> <p>Dès qu'un qu'un <code class='spip_code spip_code_inline' dir='ltr'>id_xxx</code> est présent dans l'environnement, on peut donc sélectionner les albums liés à l'objet sans avoir à faire de jointure explicite avec la table de liens : <br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE_albums(ALBUMS){id_xxx}></code></p> <p>Attention, pour <code class='spip_code spip_code_inline' dir='ltr'>{id_auteur}</code>, le comportement est différent :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE_albums(ALBUMS){id_auteur}></code> sélectionne les albums de l'auteur (d'après la table spip_auteurs_liens).</li><li> <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE_albums(ALBUMS){objet=auteur}{id_objet=#ID_AUTEUR}></code> sélectionne les albums liés à l'auteur (d'après la table spip_albums_liens).</li></ul> <p><a id="criteres_documents"></a><br class='autobr' /> ⇒ <strong>Sélectionner les albums en fonction de leurs documents</strong></p> <p>En faisant une jointure avec la table <code class='spip_code spip_code_inline' dir='ltr'>spip_documents</code>, on peut utiliser certains critères des documents :<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE_albums(ALBUMS documents){documents.critere=xxx}></code><br class='autobr' /> Quelques exemples avec les critères les plus utiles :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.media IN image,audio}</code> : albums contenant des images ou des bandes-sons.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.id_document=x}</code> : albums contenant le document n°x.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.titre LIKE %truc%}</code> : albums contenant des documents dont le titre ou le nom de fichier comprend le terme «truc».</li><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.extension == mp3|ogg|oga}</code> : albums contenant des fichiers mp3 ou ogg audio.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.taille > 1000000}</code> : albums contenant des documents d'une taille supérieure à 1Mo<span class="spip_note_ref"> [<a href="#nb26-2" class="spip_note" rel="appendix" title="1000000 octets = 975ko, mais on ne va pas chipoter" id="nh26-2">2</a>]</span>.</li></ul> <p><a id="autorisations"></a></p> <h2 class="h2" id='Autorisations'>Autorisations<a class='sommaire-back sommaire-back-13' href='#s-Autorisations' title='Back to the table of contents'></a></h2> <p>Voici comment sont définies certaines autorisations particulières (les administrateurs complets peuvent tout faire).</p> <ul class="spip" role="list"><li> <strong>Modifier un album</strong> : il faut être auteur de l'album et avoir le droit de modifier tous les objets auquel l'album est lié.</li><li> <strong>Ajouter un album à un objet</strong> : il faut que l'objet soit activé dans les options, et avoir le droit de le modifier.</li><li> <strong>Déplacer des documents entre albums</strong> : il faut que l'option soit activée, et dans le contexte d'un objet, avoir le droit de modifier tous les albums liés.</li><li> <strong>Supprimer un album</strong> : il faut qu'il soit vide, inutilisé et non publié.</li></ul> <p><a id="retro_compatibilite"></a></p> <h2 class="h2" id='Retro-compatibilite'>Rétro-compatibilité<a class='sommaire-back sommaire-back-13' href='#s-Retro-compatibilite' title='Back to the table of contents'></a></h2> <p><strong>Modèles</strong></p> <p>La syntaxe de la version 1, qui avait disparu de la version 2, est à nouveau supportée dans cette version : <album|id_article=x> et <album|id=x,y,z></p> <p>La structure du modèle de base a changé, afin notamment de respecter l'usage des balises <figure> et <figcaption> en HTML5.</p> <p>Visuellement, quelques altérations ont eu lieu : <br />- par défaut, les titres sont cachés. <br />- le titre et le descriptif du modèle de base passent en bas.</p> <p>Changement de quelques paramètres : <br />- vignettes & liste : <code class='spip_code spip_code_inline' dir='ltr'>titraille</code> est supprimé <br />- vignettes & liste : <code class='spip_code spip_code_inline' dir='ltr'>balise_titraille</code> est déprécié au profit de <code class='spip_code spip_code_inline' dir='ltr'>balise_titre</code> <br />- liste : <code class='spip_code spip_code_inline' dir='ltr'>infos</code> est déprécié au profit de <code class='spip_code spip_code_inline' dir='ltr'>metas</code></p> <p><strong>Divers</strong></p> <p>- Le critère <code class='spip_code spip_code_inline' dir='ltr'>{contenu}</code> apparu dans la version 2 est supprimé : on peut utiliser à la place le critère <code class='spip_code spip_code_inline' dir='ltr'>{documents.media == x}</code> avec une jointure (ALBUMS documents) pour un résultat similaire.<br class='autobr' /> Voir la <a href="#criteres_documents" class="spip_ancre">section sur les jointures</a>.</p> <h2 class="h2" id='Parametrage-fin-par-les-constantes'>Paramétrage fin par les constantes<a class='sommaire-back sommaire-back-13' href='#s-Parametrage-fin-par-les-constantes' title='Back to the table of contents'></a></h2> <p>- Constante _ALBUMS_TITRE_COURT : si vous insérez <code class='spip_code spip_code_inline' dir='ltr'>define('_ALBUMS_TITRE_COURT','oui');</code> dans votre mes_options.php, le titre des images sous les images sera réduit à leur titre et n'incluera pas les indications techniques.</p></div> <hr /> <div class='rss_notes'><div id="nb26-1"> <p><span class="spip_note_ref">[<a href="#nh26-1" class="spip_note" title="Footnotes 26-1" rev="appendix">1</a>] </span>Techniquement, le formulaire «ajouter_album» est une fusion des formulaires «editer_album» et «ajouter_document»</p> </div><div id="nb26-2"> <p><span class="spip_note_ref">[<a href="#nh26-2" class="spip_note" title="Footnotes 26-2" rev="appendix">2</a>] </span>1000000 octets = 975ko, mais on ne va pas chipoter</p> </div></div> <div class='rss_ps'><p><a id="v2"></a><br class='autobr' /> La version 2 du plugin est <a href='https://contrib.spip.net/Albums-v2-DEV' class="spip_in" hreflang="fr">documentée ici</a>.<br class='autobr' /> Elle a en quelque sorte servi de transition entre la <a href='https://contrib.spip.net/Albums' class="spip_in" hreflang="fr">version 1</a> et la présente version, qui est la version «correcte» pour SPIP 3. La branche 2 n'est plus amenée à évoluer, et ne recevra que des corrections de bugs.<br class='autobr' /> D'ailleurs, n'hésitez pas à signaler les bugs de la version 2 sur ce forum, en précisant bien quelle version est concernée.</p></div> </article> <article> <h1>Albums 3 (en)</h1> <p>tcharlss — 2014-08-08T09:00:00Z</p> <div class='rss_chapo'><p>The plugin «Albums» evolves with a version 3 made for SPIP 3.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-11" id="nav6a60d14a119cb3.76511693"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Albums-purpose"></a><a href="#Albums-purpose" class="spip_ancre">Albums purpose</a></li><li> <a id="s-Installation-amp-configuration"></a><a href="#Installation-amp-configuration" class="spip_ancre">Installation & configuration</a></li><li> <a id="s-Utilisation"></a><a href="#Utilisation" class="spip_ancre">Utilisation</a></li><li> <a id="s-Managing-albums-from-an-object-s-page"></a><a href="#Managing-albums-from-an-object-s-page" class="spip_ancre">Managing albums from an object's page</a></li><li> <a id="s-Managing-albums-when-editing-an-object"></a><a href="#Managing-albums-when-editing-an-object" class="spip_ancre">Managing albums when editing an object</a></li><li> <a id="s-Les-modeles"></a><a href="#Les-modeles" class="spip_ancre">Les modèles</a></li><li> <a id="s-Albums-page"></a><a href="#Albums-page" class="spip_ancre">Albums page</a></li><li> <a id="s-Moving-documents-between-albums-with-drag-and-drop"></a><a href="#Moving-documents-between-albums-with-drag-and-drop" class="spip_ancre">Moving documents between albums with drag and drop</a></li><li> <a id="s-Boucles-amp-criteres"></a><a href="#Boucles-amp-criteres" class="spip_ancre">Boucles & critères</a></li><li> <a id="s-Autorisations"></a><a href="#Autorisations" class="spip_ancre">Autorisations</a></li><li> <a id="s-Retro-compatibility"></a><a href="#Retro-compatibility" class="spip_ancre">Retro-compatibility</a></li></ul></div><p class="notice">Before upgrading from previous versions, read the notes regarding the <a href="#retro_compatibilite" class="spip_ancre">retro-compatibility</a>.</p> <p>This quick presentation video is in french, but it might be helpfull nonetheless.</p> <div> <div style="width:480px;height:270px"> <param name="movie" value="https://medias.spip.net/extensions/html5/flash/flowplayer.swf?config=http%3A%2F%2Fmedias.spip.net%2Fspip.php%3Fpage%3Dflowplayer_embed.js%26id_document%3D2073" /> <param name="wmode" value="transparent" /> <param name="allowFullScreen" value="true" /> <span><a href="https://medias.spip.net/IMG/mp4/montage-encoded.mp4" rel="enclosure">https://medias.spip.net/IMG/mp4/montage-encoded.mp4</a></span> </object> </div> </div> <p><a id="presentation"></a></p> <h2 class="h2" id='Albums-purpose'>Albums purpose<a class='sommaire-back sommaire-back-11' href='#s-Albums-purpose' title='Back to the table of contents'></a></h2> <p><a href='https://contrib.spip.net/Albums' class="spip_in" hreflang="fr">In the first version</a>, the plugin's purpose was to insert galleries of images inside the text of articles.</p> <p>Since the <a href="#v2" class="spip_ancre">version 2</a>, albums are editorial objects, and so the plugin's scope is broader : its purpose is now to manage groups of documents.</p> <p>⇒ <strong>Groups of documents</strong></p> <p>An album is a container for a serie of documents.<br class='autobr' /> Despite its name, it may contain any types of documents, not just images.<br class='autobr' /> One document may belong to several different albums : all kind of combinations are possible.</p> <div class='spip_document_11774 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="32" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/principe_albums.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11774 '><strong>Albums are groups of documents</strong></div> </figcaption></figure> </div> <p>⇒ <strong>Albums, documents and objects</strong></p> <p>In SPIP 3, documents associated with an object are dispatched into 3 sections : «illustrations», «portfolio» and «documents».<br class='autobr' /> In this documentation, we will refer to these documents as «individual» documents, as opposed to documents grouped into albums.</p> <p>Individual documents and albums are independents and do not interfere with each other : you can continue to manage individual documents the same way as before.<br class='autobr' /> Except now, you have the choice when adding documents to an object : they can be added individually, or grouped into albums.</p> <div class='spip_document_11773 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="80" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/principe_albums_et_documents.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11773 '><strong>Albums et documents liés</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11773 '>Documents individuels et regroupés aux seins d'albums</div> </figcaption></figure> </div> <p><a id="installation"></a></p> <h2 class="h2" id='Installation-amp-configuration'>Installation & configuration<a class='sommaire-back sommaire-back-11' href='#s-Installation-amp-configuration' title='Back to the table of contents'></a></h2> <p>You can install the plugin <a href="https://www.spip.net/en_article3475.html" class="spip_out" rel="external">the standard way</a>.<br class='autobr' /> 2 tables will be added : <code class='spip_code spip_code_inline' dir='ltr'>spip_albums</code> and <code class='spip_code spip_code_inline' dir='ltr'>spip_albums_liens</code>.</p> <p>Additional plugins are neccesary in order to enable the <a href="#personnaliser_balise" class="spip_ancre">customization of <album> tags</a>. These are <strong>optional</strong> dependencies, install them if you whish to benefit from this functionnality.</p> <ul class="spip" role="list"><li> <a href='https://contrib.spip.net/Le-plugin-YAML' class="spip_in" hreflang="fr">YAML</a> : <a href="https://files.spip.net/spip-zone/yaml.zip" class="spip_out" rel="external">télécharger</a></li><li> <a href='https://contrib.spip.net/Saisies' class="spip_in" hreflang="fr">Saisies</a> : <a href="https://files.spip.net/spip-zone/saisies_v2.zip" class="spip_out" rel="external">télécharger</a></li><li> <a href='https://contrib.spip.net/Verifier' class="spip_in" hreflang="fr">Vérifier</a> : <a href="https://files.spip.net/spip-zone/verifier.zip" class="spip_out" rel="external">télécharger</a></li></ul> <p>Once the installation is done, visit the plugin's configuration page. It is divided in 2 tabs.</p> <p>⇒ <strong>«options» tab</strong><br class='autobr' /> First, choose which objects may receive albums.<br class='autobr' /> There are 2 more options : you can enable the suggestion of a default title when adding an album to an object, and enable moving documents between album with <a href="#dragdrop" class="spip_ancre">drag and drop</a>.</p> <p>⇒ <strong>«tools» tab</strong><br class='autobr' /> A form will convert articles into albums.<br class='autobr' /> Use it in case you were using articles as pseudo-albums : real ones will be created identically.</p> <p><a id="utilisation"></a></p> <h2 class="h2" id='Utilisation'>Utilisation<a class='sommaire-back sommaire-back-11' href='#s-Utilisation' title='Back to the table of contents'></a></h2> <p>Albums may be independents or associated with editorial objects.</p> <p>⇒ Independent albums can be created from the toolbar or from the «Albums» page.</p> <p>⇒ The management of albums associated with objects is quite similar to that of individual documents : albums can be managed from the object's page or when the object is being edited.</p> <p><a id="fiche_objet"></a></p> <h2 class="h2" id='Managing-albums-from-an-object-s-page'>Managing albums from an object's page<a class='sommaire-back sommaire-back-11' href='#s-Managing-albums-from-an-object-s-page' title='Back to the table of contents'></a></h2> <p>On the page of an object, albums are located after the documents. You can add new albums or existing ones, edit their text and manage their documents.</p> <div class='spip_document_11770 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="93" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/albums_et_documents.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11770 '><strong>Albums et documents liés</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11770 '>1) documents «individuels» 2) documents regroupés au sein d'albums</div> </figcaption></figure> </div> <p>⇒ <strong>Adding albums</strong></p> <p>The «Add an album» button displays a form which has two methods :</p> <div class='spip_document_12437 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Create and «fill» a new album. The title and the description are both optionals : if the title is leaved empty, it will be populated afterward with «New album No X».</p> <div class='spip_document_12438 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Choose existing albums : you can browse a list, or enter directly the album's numbers.</p> <div class='spip_document_11777 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="119" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/ajouter_album.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11777 '><strong>Ajouter un album à un objet éditorial</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11777 '>1) Créer et remplir un nouvel album 2) Choisir un ou plusieurs albums existants</div> </figcaption></figure> </div> <p>⇒ <strong>Editing an album</strong></p> <p>Albums can be quickly edited «on site». For the full-blown edition (managing authors, keywords...), go to the album's page.</p> <div class='spip_document_12437 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Editing text : an icon will appear when hovering the header, clicking it will display the form to edit the text and the description.</p> <div class='spip_document_12438 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Adding documents : a link located in the footer will display the form to add documents.</p> <div class='spip_document_12439 spip_document spip_documents spip_document_image spip_documents_left spip_document_left'> <figure class="spip_doc_inner"> </figure> </div> <p>Managing documents : the buttons will appear when hovering each document.</p> <p>It is also possible, under some conditions, to move documents between albums with <a href="#dragdrop" class="spip_ancre">drag and drop</a>.</p> <div class='spip_document_11775 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="108" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/edition_album.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11775 '><strong>Édition rapide d'un album</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11775 '>1) Editer titre et descriptif 2) Ajouter des documents 3) Modifier les documents</div> </figcaption></figure> </div> <p>⇒ <strong>Removing albums</strong></p> <p>To remove an album, hover the footer to reveal the corresponding button.<br class='autobr' /> When there are several albums, a button located at the end of the list can remove all of them at once.</p> <p><a id="edition_objet"></a></p> <h2 class="h2" id='Managing-albums-when-editing-an-object'>Managing albums when editing an object<a class='sommaire-back sommaire-back-11' href='#s-Managing-albums-when-editing-an-object' title='Back to the table of contents'></a></h2> <p>When editing an object, the albums can be managed in the same place as documents, in the left column.<br class='autobr' /> When the object can receive both individual documents and albums, a menu allows you to switch between them.</p> <div class='spip_document_12440 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="97" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/edition_objet.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12440 '><strong>Albums et documents lors de l'édition d'un objet</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-12440 '>1) Gestion des documents 2) Gestion des albums</div> </figcaption></figure> </div> <p>⇒ <strong>Adding, removing and editing albums</strong></p> <p>The management is the same as when you're on the object's page : same form to add albums, same way to edit them and manage their documents.</p> <p><a id="personnaliser_balise"></a><br class='autobr' /> ⇒ <strong>Inserting <album> inside texts</strong></p> <p>Albums inserted inside texts with the tag <albumX> will be automatically associated with the object.</p> <p>A form will help you to customize the tag of each album, providing both <a href="https://contrib.spip.net/YAML">YAML</a> and <a href="https://contrib.spip.net/Saisies">Saisies</a> plugins are installed.<br class='autobr' /> <strong>Important</strong> : for this functionality to be available, additional plugins must be installed. Consult the section regarding <a href="#installation" class="spip_ancre">dependencies</a>.</p> <div class='spip_document_12441 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="152" data-legende-lenx="xxx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/edition_balise.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12441 '><strong>Personnaliser la balise d'un album</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-12441 '>En mode édition, un formulaire permet de personnaliser la balise de chaque album en vue de l'insérer dans le texte.</div> </figcaption></figure> </div> <p><a id="modeles"></a></p> <h2 class="h2" id='Les-modeles'>Les modèles<a class='sommaire-back sommaire-back-11' href='#s-Les-modeles' title='Back to the table of contents'></a></h2><p class="notice">Models have slightly changed since versions 1 et 2. Read the notes about <a href="#retro_compatibilite" class="spip_ancre">retro-compatibility</a>.</p> <p>2 models are available : the basic one is a thumbnail view, and there is a variation as a list view.<br class='autobr' /> By default, both of them are minimalist : the title and description are not displayed unless you use the proper <a href="#parametres_modeles" class="spip_ancre">parameters</a>.</p> <p>The <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/albums/trunk/css/albums.css" class="spip_out" rel="external">stylesheet</a> loaded on the public site is also reduced to a minimum.</p> <p>These models will not fulfill all the use-cases, as the albums may contain all kind of documents and thus may be used for all kind of purposes : audio and video playlists, diaporamas...<br class='autobr' /> Do not hesitate to <a href="#ajouter_modeles" class="spip_ancre">create your own variations of the model</a>.</p> <p>⇒ <strong>Model «thumbnails»</strong></p> <div class='spip_document_11769 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="44" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/modele_vignettes.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11769 '><strong>Modèle album par défaut : vue en vignettes</strong></div> </figcaption></figure> </div> <p>This model is intended for series of images. It is based on <a href="http://tinytypo.tetue.net/tinytypo.html#album" class="spip_out" rel="external">Tiny Typo</a>.<br class='autobr' /> Images may be resized and cropped in order to obtain an even display, by default they are resized with a 100px height.</p> <p>The basic HTML structure is as follow (with <a href="https://www.spip.net/fr_article5057.html" class="spip_out" rel="external">#HTML5</a> activated) :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><figure class="album vignettes figure"> <ul> <li> <a href="#"></a> </li> </ul> </figure></code></pre></div> <p>⇒ <strong>Model «list»</strong></p> <div class='spip_document_12411 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="44" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/modele_liste.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12411 '><strong>Modèle album, variante sous forme de liste</strong></div> </figcaption></figure> </div> <p>This variation displays documents as a simple list.</p> <p>The basic HTML structure is as follow :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><div class="album liste"> <ul class="spip"> <li> <a href="#">...</a> </li> </ul> </div></code></pre></div> <p><a id="parametres_modeles"></a><br class='autobr' /> ⇒ <strong>Models parameters</strong></p> <table class="table spip"> <caption>Common parameters</caption> <thead><tr class='row_first'><th id='id14d1_c0'> Parameter </th><th id='id14d1_c1'> Description </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='id14d1_c0'><code class='spip_code spip_code_inline' dir='ltr'>titre</code></td> <td headers='id14d1_c1'>«oui» to display the title<br>Any string in order to use it as a custom title</td></tr> <tr class='row_even even'> <td headers='id14d1_c0'><code class='spip_code spip_code_inline' dir='ltr'>balise_titre</code></td> <td headers='id14d1_c1'>In order to wrap the title in a tag.<br>→ strong, h4, etc.</td></tr> <tr class='row_odd odd'> <td headers='id14d1_c0'><code class='spip_code spip_code_inline' dir='ltr'>descriptif</code></td> <td headers='id14d1_c1'>«oui» in order to display the description</td></tr> <tr class='row_even even'> <td headers='id14d1_c0'><code class='spip_code spip_code_inline' dir='ltr'>par</code></td> <td headers='id14d1_c1'>Documents ordering, default : «titre»<br>→ date, titre, media, fichier, extension, taille</td></tr> <tr class='row_odd odd'> <td headers='id14d1_c0'><code class='spip_code spip_code_inline' dir='ltr'>media</code></td> <td headers='id14d1_c1'>In order to restrain documents to one type <br>→ image, file, audio, video</td></tr> </tbody> </table><table class="table spip"> <caption>«thumbnails» specific parameters</caption> <thead><tr class='row_first'><th id='id0057_c0'> Parameter </th><th id='id0057_c1'> Description </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='id0057_c0'><code class='spip_code spip_code_inline' dir='ltr'>largeur</code></td> <td headers='id0057_c1'>Max width</td></tr> <tr class='row_even even'> <td headers='id0057_c0'><code class='spip_code spip_code_inline' dir='ltr'>hauteur</code></td> <td headers='id0057_c1'>Max height, default: 100 (pixels)</td></tr> <tr class='row_odd odd'> <td headers='id0057_c0'><code class='spip_code spip_code_inline' dir='ltr'>recadrer</code></td> <td headers='id0057_c1'>«oui» in order to crop images</td></tr> <tr class='row_even even'> <td headers='id0057_c0'><code class='spip_code spip_code_inline' dir='ltr'>label</code></td> <td headers='id0057_c1'>«oui» in order to display each document's title</td></tr> </tbody> </table><table class="table spip"> <caption>«list» specific parameters</caption> <thead><tr class='row_first'><th id='idecb8_c0'> Parameter </th><th id='idecb8_c1'> Description </th></tr></thead> <tbody> <tr class='row_odd odd'> <td headers='idecb8_c0'><code class='spip_code spip_code_inline' dir='ltr'>metas</code></td> <td headers='idecb8_c1'>«oui» in order to display additional information, or a list of elements comma-separated : <br>→ extension, taille, dimensions</td></tr> </tbody> </table> <p><a id="ajouter_modeles"></a><br class='autobr' /> ⇒ <strong>Adding models</strong></p> <p>When you create a new HTML template as a variation of the model, a YAML file must be created as well, in order for the model to be detected by <a href="#inserer_balise" class="spip_ancre">the form</a>.</p> <p>This method is inspired by the plugin <a href='https://contrib.spip.net/Plugin-Inserer-Modeles' class="spip_in" hreflang="fr">Insérer Modèles</a> : each YAML file describes the model and its parameters.<br class='autobr' /> <a href="http://contrib.spip.net/Inserer-Modeles-Carnet-de-developpement" class="spip_out" rel="external">The syntax</a> remains the same, though there are 2 more elements :</p> <ul class="spip" role="list"><li> alias : name of the variation</li><li> description : description of the variation</li></ul> <p>4 parameters are mandatory : <code class='spip_code spip_code_inline' dir='ltr'>modele</code>, <code class='spip_code spip_code_inline' dir='ltr'>id_modele</code>, <code class='spip_code spip_code_inline' dir='ltr'>id_album</code> et <code class='spip_code spip_code_inline' dir='ltr'>variante</code>.<br class='autobr' /> As the first 3 are identical for all variations, they are found in the file <i>inc-yaml/album-compat.yaml</i> which you can include.</p> <p>An additional <code class='spip_code spip_code_inline' dir='ltr'>config</code> option allows you to use a default value stored in the table <code class='spip_code spip_code_inline' dir='ltr'>spip_meta</code>.<br class='autobr' /> In a way, <code class='spip_code spip_code_inline' dir='ltr'>config:'truc'</code> is the equivalent of <code class='spip_code spip_code_inline' dir='ltr'>'defaut'=>lire_config('truc') </code> with php.</p> <p>Confusing? Take a look at the example.</p> <p><strong>Example</strong> : let's imagine a plugin with a «diaporama» model. It would have, among others, a <code class='spip_code spip_code_inline' dir='ltr'>speed</code> parameter whose default value would be stored in the plugin's meta. The HTML template would be named <i>album_diaporama.html</i> and the YAML file would be named <i>album_diaporama.yaml</i>.<br class='autobr' /> The later would be like that :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>nom: 'an album (diaporama)' logo: 'prive/themes/spip/images/album-24.png' icone_barre: 'album-diaporama.png' alias: 'Diaporama' parametres: - 'inclure:inc-yaml/album-compat.yaml' - saisie: 'hidden' options: nom: 'variante' defaut: 'diaporama' - saisie: 'selection_album' options: nom: speed' config: 'plugin/speed' - the remaining inputs...</code></pre></div> <p>Use the <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/albums/trunk/modeles/album_liste.yaml" class="spip_out" rel="external">«list» variation</a> as a reference.</p> <p><a id="albumotheque"></a></p> <h2 class="h2" id='Albums-page'>Albums page<a class='sommaire-back sommaire-back-11' href='#s-Albums-page' title='Back to the table of contents'></a></h2><div class='spip_document_12436 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="14" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/albumotheque.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12436 '><strong>Albumothèque</strong></div> </figcaption></figure> </div> <p>The filters located in the side column allow you to select albums according to their documents or their associations with objects : articles, authors, keywords...</p> <p>Some inputs with an autocomplete function will help you find specific objects.<br class='autobr' /> For instance, in order to display the albums associated with a given article, click on the icon on the right side, then enter the first letters of the article's title or its number : the corresponding articles will appear, and clicking on one entry will update the albums list.<br class='autobr' /> The autocomplete function only retrieves objects associated with albums.</p> <div class='spip_document_12435 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="105" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/filtres.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12435 '><strong>Albumothèque : filtres</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-12435 '>Des champs avec autocomplétion permettent de trouver les objets liés aux albums.</div> </figcaption></figure> </div> <p><a id="dragdrop"></a></p> <h2 class="h2" id='Moving-documents-between-albums-with-drag-and-drop'>Moving documents between albums with drag and drop<a class='sommaire-back sommaire-back-11' href='#s-Moving-documents-between-albums-with-drag-and-drop' title='Back to the table of contents'></a></h2> <p>If the option is activated, and provided you are <a href="#autorisations" class="spip_ancre">authorized</a>, it is possible to move documents between albums with drag and drop.<br class='autobr' /> Be aware that this is experimental-ish !</p> <p>When you start draging a document, the albums which may receive it are highlighted with a dotted border. Once a document has been released in a different album, a form will appear at the bottom of the list in order to save the modifications. You may however proceed with more modifications before saving them.</p> <p>Note that it is possible to include individual documents in the manipulations.</p> <div class='spip_document_11778 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="149" data-legende-lenx="xxx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/deplacer_documents.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11778 '><strong>Déplacer des documents entre albums par cliquer-glisser</strong></div> <div class='spip_doc_descriptif crayon document-descriptif-11778 '>1) Effectuer un ou plusieurs déplacements 2) Valider avec le formulaire qui apparaît en bas</div> </figcaption></figure> </div> <p><a id="boucles"></a></p> <h2 class="h2" id='Boucles-amp-criteres'>Boucles & critères<a class='sommaire-back sommaire-back-11' href='#s-Boucles-amp-criteres' title='Back to the table of contents'></a></h2> <p>⇒ <strong>Critère <code class='spip_code spip_code_inline' dir='ltr'>{orphelins}</code></strong></p> <p>The criteria <code class='spip_code spip_code_inline' dir='ltr'>{orphelins}</code> will select albums not associated with any other object.</p> <p>⇒ <strong>Joins</strong></p> <p>Albums have automatic joins with all objects.</p> <p>Provided that <code class='spip_code spip_code_inline' dir='ltr'>id_xxx</code> is present in the environnement, you may select albums associated with the object without using an explicit join : <br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE_albums(ALBUMS){id_xxx}></code></p> <p>Beware though, <code class='spip_code spip_code_inline' dir='ltr'>{id_auteur}</code> behaves differently :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE_albums(ALBUMS){id_auteur}></code> select the author's albums (on spip_auteurs_liens).</li><li> <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE_albums(ALBUMS){objet=auteur}{id_objet=#ID_AUTEUR}></code> selects albums associated with the author (on spip_albums_liens).</li></ul> <p><a id="criteres_documents"></a><br class='autobr' /> ⇒ <strong>Select albums according to their documents</strong></p> <p>When using a join with the table <code class='spip_code spip_code_inline' dir='ltr'>spip_documents</code>, it is use some criterias of documents :<br class='autobr' /> <code class='spip_code spip_code_inline' dir='ltr'><BOUCLE_albums(ALBUMS documents){documents.criteria=xxx}></code><br class='autobr' /> For instance :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.media IN image,audio}</code> : albums containing images or audio files.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.id_document=x}</code> : albums containing the document no x.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.titre LIKE %something%}</code> : albums containing documents whose title or filename corresponds to the term «something».</li><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.extension == mp3|ogg|oga}</code> : albums containing mp3 or ogg audio files.</li><li> <code class='spip_code spip_code_inline' dir='ltr'>{documents.taille > 1000000}</code> : albums containing documents whose weight exceeds 1Mo<span class="spip_note_ref"> [<a href="#nb28-1" class="spip_note" rel="appendix" title="1000000 octets = 975ko, but let's not chipote" id="nh28-1">1</a>]</span>.</li></ul> <p><a id="autorisations"></a></p> <h2 class="h2" id='Autorisations'>Autorisations<a class='sommaire-back sommaire-back-11' href='#s-Autorisations' title='Back to the table of contents'></a></h2> <p>Here are how some particular authorizations are defined (administrators can do everything).</p> <ul class="spip" role="list"><li> <strong>Modify an album</strong> : one must be the album's auhtor and be authorized to modify all the objects associated with the album.</li><li> <strong>Add an album to an object</strong> : the object must be activated in the options, and one must be authorized to modify the object.</li><li> <strong>Move documents between albums</strong> : the option must be activated, and in the context of an object, one must be authorized to modify all the associated albums.</li><li> <strong>Delete an album</strong> : the album must be empty, not used, and not published.</li></ul> <p><a id="retro_compatibilite"></a></p> <h2 class="h2" id='Retro-compatibility'>Retro-compatibility<a class='sommaire-back sommaire-back-11' href='#s-Retro-compatibility' title='Back to the table of contents'></a></h2> <p><strong>Models</strong></p> <p>The version 1 syntax, disabled in version 2, is supported anew : <album|id_article=x> and <album|id=x,y,z></p> <p>The structure of the basic model has changed, in order to respect the standards for the tags <figure> and <figcaption>.</p> <p>Visually, a few changes occured : <br />- titles are hidden by default. <br />- the title and the description of the basic model are now located on the bottom.</p> <p>Parameters : <br />- thumbnails & list : <code class='spip_code spip_code_inline' dir='ltr'>titraille</code> has been remove <br />- thumbnails & list : <code class='spip_code spip_code_inline' dir='ltr'>balise_titraille</code> is deprecated in favor of <code class='spip_code spip_code_inline' dir='ltr'>balise_titre</code> <br />- liste : <code class='spip_code spip_code_inline' dir='ltr'>infos</code> is deprecated in favor of <code class='spip_code spip_code_inline' dir='ltr'>metas</code></p> <p><strong>Divers</strong></p> <p>The <code class='spip_code spip_code_inline' dir='ltr'>{contenu}</code> criteria of the version 2 has been removed.<br class='autobr' /> See the <a href="#criteres_documents" class="spip_ancre">section about joins</a>.</p></div> <hr /> <div class='rss_notes'><div id="nb28-1"> <p><span class="spip_note_ref">[<a href="#nh28-1" class="spip_note" title="Footnotes 28-1" rev="appendix">1</a>] </span>1000000 octets = 975ko, but let's not chipote</p> </div></div> <div class='rss_ps'><p><a id="v2"></a><br class='autobr' /> The version 2 of the plugin has served as a transition, so to speak, between the <a href='https://contrib.spip.net/Albums' class="spip_in" hreflang="fr">version 1</a> and this version, which is the «correct» version for SPIP 3.<br class='autobr' /> It will only receive bug corrections.</p></div> </article> <article> <h1>Alerte d'urgence</h1> <p>RastaPopoulos — 2015-01-27T11:25:10Z</p> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d14a166c36.09640059"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Fonctionnement-par-defaut"></a><a href="#Fonctionnement-par-defaut" class="spip_ancre">Fonctionnement par défaut</a></li><li> <a id="s-Personnalisation"></a><a href="#Personnalisation" class="spip_ancre">Personnalisation</a></li><li> <a id="s-Edition-du-message"></a><a href="#Edition-du-message" class="spip_ancre">Édition du message</a></li><li> <a id="s-Personnalisation-de-l-emplacement"></a><a href="#Personnalisation-de-l-emplacement" class="spip_ancre">Personnalisation de l'emplacement</a></li></ul></div><p>Ce plugin permet d'afficher très rapidement et de manière très visible un message urgent que vous voulez fournir à vos visiteurs.</p> <h2 class="h2" id='Fonctionnement-par-defaut'>Fonctionnement par défaut<a class='sommaire-back sommaire-back-4' href='#s-Fonctionnement-par-defaut' title='Back to the table of contents'></a></h2> <p>Par défaut, le plugin n'affiche rien tant que le message est vide. Un formulaire de configuration du plugin permet de remplir un champ de texte libre pour le message. Vous pouvez y mettre ce que vous voulez, comme n'importe quel contenu.</p> <p>Dès que le message est rempli, le plugin ajoute un bloc contenant le message d'urgence au tout début de toutes les pages du site (juste après la balise <code class='spip_code spip_code_inline' dir='ltr'><body></code>).</p> <p>Le bloc contient déjà en interne quelques styles par défaut qui permettent d'utiliser le plugin directement, sans aucun besoin technique supplémentaire.</p> <p>Le message est éditable avec <a href='https://contrib.spip.net/Les-crayons' class="spip_in" hreflang="fr">Crayons</a> lorsqu'il est affiché dans le site.</p> <div class='spip_document_12719 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/alerte.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div><h2 class="h2" id='Personnalisation'>Personnalisation<a class='sommaire-back sommaire-back-4' href='#s-Personnalisation' title='Back to the table of contents'></a></h2> <p>Vous pouvez personnaliser l'affichage de deux manières différentes, suivant le niveau de complexité de votre besoin :</p> <ul class="spip" role="list"><li> soit en appliquant des styles supplémentaires dans votre thème graphique, en stylant ce que contient le bloc <code class='spip_code spip_code_inline' dir='ltr'>.alerte_urgence</code> ;</li><li> soit en surchargeant le squelette qui génère le message <code class='spip_code spip_code_inline' dir='ltr'>inclure/alerte_urgence.html</code>, ce qui permet de modifier aussi le HTML (c'est plus rare d'en avoir besoin).</li></ul><h2 class="h2" id='Edition-du-message'>Édition du message<a class='sommaire-back sommaire-back-4' href='#s-Edition-du-message' title='Back to the table of contents'></a></h2> <p>Par défaut, seul⋅e⋅s les admins peuvent éditer ce message d'urgence. Mais lorsqu'on est admin, sous le champ d'édition du message se trouve un second champ permettant d'ajouter des utilisateurices supplémentaires qui pourront aussi l'éditer. Ces personnes ne peuvent en revanche pas elles-mêmes modifier cette liste, c'est uniquement pour les admins.</p> <p>Cette fonctionnalité permet donc d'autoriser l'édition du message pour n'importe quel⋅le admin restreint⋅e ou rédacteurice, y compris temporairement (il suffit de l'enlever de la liste quand on ne veut plus l'autoriser).</p> <h2 class="h2" id='Personnalisation-de-l-emplacement'>Personnalisation de l'emplacement<a class='sommaire-back sommaire-back-4' href='#s-Personnalisation-de-l-emplacement' title='Back to the table of contents'></a></h2> <p>Il est possible d'insérer le message d'urgence autre part dans vos gabarits HTML ! Par défaut le message s'insère au tout début de chaque page. Mais si vous ajoutez exactement le code suivant :</p> <div class="precode"><pre data-language="html5" class='spip_code spip_code_block language-html5' dir='ltr' style='text-align:left;'><code></code></pre></div> <p>alors il s'insérera à cet endroit.</p> <p>Au-delà du style graphique, cela vous permet donc de l'insérer sous votre entête, ou en début de contenu principal, n'importe où qui vous paraîtra le plus pertinent par rapport à votre ergonomie.</p></div> </article> <article> <h1>Alias d'Article</h1> <p>Cerdic — 2008-11-01T16:37:42Z</p> <div class='rss_chapo'><p>Un plugin pour créer rapidement des Alias d'article, pour afficher un contenu identique en plusieurs endroits d'une arborescence.</p></div> <div class='rss_texte'><p>Il est assez fréquent de vouloir afficher une contenu identique en plusieurs endroits d'une arborescence. Même si ce genre de pratique n'est pas souhaitable, et si elle doit toujours nous amener à nous poser la question de la pertinence de notre rubriquage, elle n'en demeure pas moins nécessaire dans certains cas.</p> <p>SPIP ne permettant pas d'affecter un article à plusieurs rubriques, ce genre de problème se résoud en général par l'une ou l'autre des solutions suivantes :</p> <ul class="spip" role="list"><li> utilisation d'un article virtuel qui redirige vers l'article d'origine, ce qui est assez déroutant pour le visiteur car le fait changer de rubrique sans avertissement ;</li><li> duplication manuelle du contenu, ce qui est lourd à maintenir et conduit le plus souvent à ce que le contenu des pages devienne peu à peu différent, voire obsolète pour certaines.</li></ul> <p>Le plugin “Alias d'articles” vous offre une 3ème solution, par la création d'Alias d'Articles.</p> <p>Une fois installé, une petite boîte apparaît sur les pages Articles de l'espace privé.</p> <div class='spip_document_6017 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/alias_01.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>En cliquant sur l'icône vous aller créer un Alias de votre article. Vous pouvez ensuite éditer celui-ci et le changer de rubrique si nécessaire.</p> <div class='spip_document_5987 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/alias_02.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div> <p>Vous remarquerez que chaque champ est en fait rempli par un modèle qui va afficher le contenu du champ de l'article d'origine.</p> <p>Vous pouvez donc très bien modifier un champ de votre Alias, et laisser les autres identiques à l'article d'origine.</p> <p>Par ailleurs, dans l'espace privé, le titre de l'article affichera toujours la mention supplémentaire “(Alias de xxx)” vous permettant de vous souvenir l'origine de cet article.</p> <p>Cette mention n'est pas affichée dans le site public.</p></div> <div class='rss_ps'><p>Le plugin alias est indiqué en cas de besoin ponctuel. Toutefois, si votre besoin de retrouver un même article dans plusieurs rubriques est récurrent, alors il est conseillé de <a href='https://contrib.spip.net/Polyhierarchie' class="spip_in" hreflang="fr">voir aussi le plugin Polyhierarchie</a></p></div> </article> <article> <h1>Ancres douces</h1> <p>Eric Lupinacci, Fil — 2008-10-21T20:02:00Z</p> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-1" id="nav6a60d14a1d2761.85429927"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Restreindre-ancres_douces-a-certains-blocs"></a><a href="#Restreindre-ancres_douces-a-certains-blocs" class="spip_ancre">Restreindre ancres_douces à certains blocs</a></li></ul></div><p>Lorsqu'on clique sur un lien qui mène vers une ancre dans la même page et que le navigateur «saute» brutalement jusqu'à cette ancre, le visiteur perd la notion de l'endroit où il se trouve et ne visualise pas la structure globale de la page. En termes d'ergonomie c'est assez mauvais, et on attend le navigateur qui trouvera la solution.</p> <p>Dans l'immédiat, chacun peut améliorer cela sur son propre site SPIP. Le plugin <i>Ancres douces</i> fait une chose (et une seule) : il transforme toutes les ancres (<code class='spip_code spip_code_inline' dir='ltr'><a href="#xxx"></code>) des pages en « ancres douces », où le navigateur fait défiler doucement la page jusqu'à l'ancre. Ainsi le lecteur sait en permanence où il se trouve dans la page, et peut plus facilement remonter, etc.</p> <p>On peut voir ce plugin en action sur le site des <a href="http://blog.mondediplo.net/2008-06-27-Acces-a-l-eau-les-benefices-sanitaires-et" class="spip_out" rel="external">blogs du Monde diplo</a> (cliquer sur «XX commentaires» ou sur les appels de note, par exemple).</p> <p>Ce plugin est une intégration à SPIP de deux scripts jQuery d'Ariel Flesler, avec lesquels il est possible de faire plein d'autres jolis scrolls (voir les démos) : <br />— <a href="http://demos.flesler.com/jquery/localScroll/" class="spip_out" rel="external">localScroll</a> <br />— <a href="http://demos.flesler.com/jquery/scrollTo/" class="spip_out" rel="external">scrollTo</a></p> <h2 class="h2" id='Restreindre-ancres_douces-a-certains-blocs'>Restreindre ancres_douces à certains blocs<a class='sommaire-back sommaire-back-1' href='#s-Restreindre-ancres_douces-a-certains-blocs' title='Back to the table of contents'></a></h2> <p>Si vous utilisez d'autres scripts javascripts utilisant aussi les ancres (par exemple un slider jquery), il est possible que des interférences se produisent avec ancres_douces.</p> <p>Pour éviter ces interférences, il est nécessaire d'indiquer sur quel bloc ou quels types de blocs on veut restreindre le fonctionnement de ancres_douces.</p> <p>Pour cela, on doit définir dans mes_options.php la constante “CONTEXTE_ANCRES_DOUCES”.</p> <p>Exemple : <br />- Pour restreindre au bloc d'id contenu (convient sur un grand nombre de squelettes spip ) :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>define ('CONTEXTE_ANCRES_DOUCES','#contenu'); </code></pre></div> <p><br />- pour restreindre à tous les éléments de classe “ancres_douces”</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>define ('CONTEXTE_ANCRES_DOUCES','.ancres_douces'); </code></pre></div> <p><strong>Bugs connus :</strong> <br />- <del>fonctionne mal avec Opera.</del> (corrigé en 1.2)</p></div> <div class='rss_ps'><p>À noter, le plugin Ancres douces est aussi intégré sous forme d'une lame du <a href="http://www.spip-contrib.net/Le-Couteau-Suisse" class="spip_out" rel="external">Couteau suisse</a>.</p></div> </article> <article> <h1>Animated dropdown menu</h1> <p>Louis Possoz — 2015-09-12T13:29:59Z</p> <div class='rss_chapo'><p>Dynamic multilevel menubar - easy (?) adaptation of colors and sizes - Also suitable for small screens (mobile).</p></div> <div class='rss_chapo'><p>Very simple display of a multilevel animated dropdown menu!</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d14a1f78a7.93858852"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Introduction"></a><a href="#Introduction" class="spip_ancre">Introduction</a></li><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Use"></a><a href="#Use" class="spip_ancre">Use</a></li><li> <a id="s-Changing-colours-and-sizes"></a><a href="#Changing-colours-and-sizes" class="spip_ancre">Changing colours and sizes</a></li></ul></div></p> <p><i>The plugin is suitable for small screens (mobile)!<br class='autobr' /> The color themes and dimensions are modifiable, as explained in <a href="#Changing-colours-and-sizes" class="spip_ancre">the last section below</a>.</i></p> <h2 class="h2" id='Introduction'>Introduction<a class='sommaire-back sommaire-back-4' href='#s-Introduction' title='Back to the table of contents'></a></h2> <p>Flexibility and simplicity are the main keywords for this menu displayer. See an example on our <a href="https://rc.agora-lln.be/" class="spip_out" rel="external">Repair Café</a> website.<br class='autobr' /> It uses (all?) the potential of the various browsers: colour gradients, shadow for boxes and texts, as well as rounded corners, not to mention the dynamic menu boxes!</p> <p>For smaller screens, the plugin reacts differently and displays a vertical drop down menu. The menu can also be discrete, disappearing at printing!</p> <p>This animated dropdown menu is essentially based on a simple (!) style sheet (<code class='spip_code spip_code_inline' dir='ltr'>menu_anime.css</code>). It does all the work!<br class='autobr' /> This plugin is an ideal complement to the <a href='https://contrib.spip.net/Menus-3139'>menus</a> plugin but it is convenient for all menus containing a selector <code class='spip_code spip_code_inline' dir='ltr'>class="menu_anime"</code>.</p> <p>The plugin is also designed to simplify the adjustment of colours and dimensions to each particular site. A method for doing it is described in detail <a href="#Changing-colours-and-sizes" class="spip_ancre">at the end of this article</a>.</p> <p>The original idea of this menu is linked to the work of <a href="https://red-team-design.com/css3-dropdown-menu/" class="spip_out" rel="external">Catalin Rosu</a>. This plugin has originally been derived from his elegant and talented handling of style sheets.</p> <h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-4' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Choose a manual or automatic method provided by SPIP. The plugin has no dependencies.</p> <h2 class="h2" id='Use'>Use<a class='sommaire-back sommaire-back-4' href='#s-Use' title='Back to the table of contents'></a></h2> <p>The simplest and most general use of this plugin is through the <a href="https://plugins.spip.net/menus.html?lang=en" class="spip_out" rel="external">plugin menus</a>. After enabling this plugin (if not already), simply create a menu (or edit an existing menu) ensuring to assign the CSS class <code class='spip_code spip_code_inline' dir='ltr'>menu_anime</code> as can be seen on the following screen-shot.</p> <div class='spip_document_13107 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Here, the identifier “barrenav” causes the menu to display as the main navigation bar. No other intervention is necessary!</p> <p>More generally, the plugin will display an entire list of links (of one or several levels) of which the first level contains the selector <code class='spip_code spip_code_inline' dir='ltr'>.menu_anime</code> (ie <code class='spip_code spip_code_inline' dir='ltr'><ul class="menu_anime"></code>) and whose immediate parent belongs to the class <code class='spip_code spip_code_inline' dir='ltr'>.menu container</code> (eg <code class='spip_code spip_code_inline' dir='ltr'><div class="menu-container"></code>).</p> <p>Of course and as usual, the <code class='spip_code spip_code_inline' dir='ltr'>menu_anime.css</code> stylesheet can be modified (by placing the modified copy in the <code class='spip_code spip_code_inline' dir='ltr'>squelettes/css/</code> directory). You certainly will be impatient to change the menu colours. However, direct intervention on the style sheet itself is particularly complex and daunting. That is why an alternative method has been developed (see below).</p> <h2 class="h2" id='Changing-colours-and-sizes'>Changing colours and sizes<a class='sommaire-back sommaire-back-4' href='#s-Changing-colours-and-sizes' title='Back to the table of contents'></a></h2> <p>The plugin contains a file <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/menu_anime/trunk/css/menu_anime.less" class="spip_out" rel="external"><code class='spip_code spip_code_inline' dir='ltr'>menu_anime.less</code></a> allowing easy (?) adaptation to the specific characteristics of each website.<br class='autobr' /> Although the process may seem a little daunting, it is infinitely easier than direct edition of the <code class='spip_code spip_code_inline' dir='ltr'>menu_anime.css</code> style sheet.</p> <p>Step by step procedure:</p> <ol class="spip" role="list"><li>Open the file <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/menu_anime/trunk/css/menu_anime.less" class="spip_out" rel="external"><code class='spip_code spip_code_inline' dir='ltr'>menu_anime.less</code></a> for editing. This file is contained in the package.</li><li> In this file, change the colour and/or size values as desired. They are at the beginning of the file.</li><li> Compile the resulting file using a compiler <a href="https://en.wikipedia.org/wiki/Less_%28stylesheet_language%29" class="spip_out" rel="external">Less</a> compiler, eg <a href="https://leafo.net/lessphp/editor.html" class="spip_out" rel="external">online compiler</a>.</li><li> Create a <code class='spip_code spip_code_inline' dir='ltr'>menu_anime.css</code> empty file and copy-paste the result of the compilation in it.</li><li> Place the new file in the <code class='spip_code spip_code_inline' dir='ltr'>squelettes/css/</code> directory or replace the one located in the directory <code class='spip_code spip_code_inline' dir='ltr'>plugins/auto/menu_anime/css/</code>.</li><li> Carefully store your version of the file <code class='spip_code spip_code_inline' dir='ltr'>menu_anime.less</code> so you can recover your settings for later updates.</li></ol> <p>Example: changing the base colour of the menu</p> <ol class="spip" role="list"><li> Select a new colour using an <a href="https://html-color-codes.info/" class="spip_out" rel="external">online color utility</a>.</li><li> Open the file <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/menu_anime/trunk/css/menu_anime.less" class="spip_out" rel="external"><code class='spip_code spip_code_inline' dir='ltr'>menu_anime.less</code></a> in a text editor.</li><li> Replace the colour value (<code class='spip_code spip_code_inline' dir='ltr'>#b0422c</code>) in the line <code class='spip_code spip_code_inline' dir='ltr'>@theme-basic: #b0422c; / * ... * /</code> with the one that was chosen.</li><li> Compile the content of this new file through an <a href="https://leafo.net/lessphp/editor.html" class="spip_out" rel="external">online compiler</a>.</li><li> Create a new empty file <code class='spip_code spip_code_inline' dir='ltr'>menu_anime.css</code> and place the entire result of the compilation (copy and paste).</li><li> Set the resulting file <code class='spip_code spip_code_inline' dir='ltr'>menu_anime.css</code> in the <a href="https://www.spip.net/en_article4907.html" class="spip_out" rel="external"><code class='spip_code spip_code_inline' dir='ltr'>squelettes/css/</code></a> your favourite SPIP. By the way, add your modified <code class='spip_code spip_code_inline' dir='ltr'> menu_anime.less </code> file in the same directory (so you will not lose it).</li></ol> <p>Simple, isn't it?</p> <p>Another solution would perhaps be to use the <a href="https://plugins.spip.net/lesscss.html" class="spip_out" rel="external">LESS CSS plugin</a>. But I'm not sure it would give any advantage. Changing colours of a website menu is a very infrequent operation once it has been installed. To be discussed...</p></div> </article> <article> <h1>AnythingSlider version 2.x.x</h1> <p>Joseph — 2012-12-19T15:17:18Z</p> <div class='rss_chapo'><p>Ce plugin permet d'utiliser aisément le script <a href="http://css-tricks.github.com/AnythingSlider/" class="spip_out" rel="external">AnythingSlider</a> dans ses squelettes.</p> <p>ATTENTION : plugin pour utilisateur averti.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-7" id="nav6a60d14a2298c9.12249483"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Note-de-version"></a><a href="#Note-de-version" class="spip_ancre">Note de version</a></li><li> <a id="s-AnythingSlider"></a><a href="#AnythingSlider" class="spip_ancre">AnythingSlider</a></li><li> <a id="s-Inserer-un-slider-dans-son-squelette"></a><a href="#Inserer-un-slider-dans-son-squelette" class="spip_ancre">Insérer un slider dans son squelette</a></li><li> <a id="s-Transmettre-des-options-au-slider"></a><a href="#Transmettre-des-options-au-slider" class="spip_ancre">Transmettre des options au slider</a></li><li> <a id="s-Changer-le-theme-du-slider"></a><a href="#Changer-le-theme-du-slider" class="spip_ancre">Changer le thème du slider</a></li><li> <a id="s-Personnaliser-les-onglets-de-navigation"></a><a href="#Personnaliser-les-onglets-de-navigation" class="spip_ancre">Personnaliser les onglets de navigation</a></li><li> <a id="s-Utilisations-avancees"></a><a href="#Utilisations-avancees" class="spip_ancre">Utilisations avancées</a></li></ul></div><p><strong>Note :</strong> le numéro de version du plugin est différent du numéro de version du script embarqué.</p> <h2 class="h2" id='Note-de-version'>Note de version<a class='sommaire-back sommaire-back-7' href='#s-Note-de-version' title='Back to the table of contents'></a></h2> <p>Cette version 2 du plugin fonctionne de manière totalement différente des <a href='https://contrib.spip.net/AnythingSlider-version-1-x-x' class="spip_in" hreflang="fr">précédentes versions</a>, adoptant le fonctionnement proposé par <a href="https://github.com/Cerdic/anythingslider-for-spip" class="spip_out" rel="external">Cédric sur GitHub</a>.</p> <p>Dans cette version 2, le code javascript et CSS d'AnythingSlider n'est pas chargé sur toutes les pages mais seulement pour celles utilisant un slider.</p> <blockquote class="spip"> <p>Le parti pris est de considérer qu'on n'a a priori jamais de slider sur toutes les pages du site, et qu'insérer le JS et les css sur tout le site est dispendieux. Du coup on insère tout cela de manière intelligente uniquement quand un slider est présent dans la page, repéré par la classe slider-anythingslider.</p> </blockquote><h2 class="h2" id='AnythingSlider'>AnythingSlider<a class='sommaire-back sommaire-back-7' href='#s-AnythingSlider' title='Back to the table of contents'></a></h2> <p>Pour une présentation et une démo d'AnythingSlider, voir <a href="http://css-tricks.github.com/AnythingSlider/" class="spip_url spip_out" rel="external">http://css-tricks.github.com/Anythi...</a>.</p> <p>Le plugin intègre également les thèmes additionnels développés pour AnythingSlider (<a href="http://css-tricks.github.com/AnythingSlider-Themes/" class="spip_out" rel="external">démo</a>) distribués sur <a href="https://github.com/CSS-Tricks/AnythingSlider-Themes" class="spip_out" rel="external">GitHub</a>.</p> <p>Les différentes options du script ne sont pas détaillées ici. Merci de se référer à la <a href="https://github.com/CSS-Tricks/AnythingSlider/wiki" class="spip_out" rel="external">documentation d'AnythingSlider</a>.</p> <h2 class="h2" id='Inserer-un-slider-dans-son-squelette'>Insérer un slider dans son squelette<a class='sommaire-back sommaire-back-7' href='#s-Inserer-un-slider-dans-son-squelette' title='Back to the table of contents'></a></h2> <p>Un slider peut facilement être inséré dans un squelette, sans une seule ligne de javscript, de la manière suivante :</p> <div class="precode"><pre data-language="SPIP" class='spip_code spip_code_block language-SPIP' dir='ltr' style='text-align:left;'><code><B_slider> <div class="slider-conteneur liste article" style="width:500px;"> <ul class="slider-anythingslider liste-items"> <BOUCLE_slider(ARTICLES) {!par date}{par num titre} {0,10}> <li class="panel"> .... contenu de chaque item ..... </li> </BOUCLE_slider> </ul> </div> </B_slider></code></pre></div> <p>Le plugin détecte automatiquement les listes portant la classe <code class='spip_code spip_code_inline' dir='ltr'>slider-anythingslider</code>, charge le javascript nécessaire et initialise le slider. Bien entendu, on peut boucler sur ce que l'on veut.</p> <h2 class="h2" id='Transmettre-des-options-au-slider'>Transmettre des options au slider<a class='sommaire-back sommaire-back-7' href='#s-Transmettre-des-options-au-slider' title='Back to the table of contents'></a></h2> <p>Les options à transmettre au slider peuvent être précisées via un attribut <code class='spip_code spip_code_inline' dir='ltr'>data-slider</code> à ajouter au <code class='spip_code spip_code_inline' dir='ltr'>ul.slider-anythingslider</code>. Par exemple :</p> <div class="precode"><pre data-language="SPIP" class='spip_code spip_code_block language-SPIP' dir='ltr' style='text-align:left;'><code><B_slider> <div class="slider-conteneur liste article" style="width:500px;"> <ul class="slider-anythingslider liste-items" data-slider='{ startText : "Démarrer", stopText: "Arrêter", buildStartStop: false, buildNavigation: true }'> <BOUCLE_slider(ARTICLES) {!par date}{par num titre} {0,10}> <li class="panel"> .... contenu de chaque item ..... </li> </BOUCLE_slider> </ul> </div> </B_slider></code></pre></div> <p>Pour la liste complète des options disponibles et de leur valeur par défaut, voir la <a href="http://css-tricks.github.com/AnythingSlider/" class="spip_out" rel="external">documentation d'AnythingSlider</a>.</p> <h2 class="h2" id='Changer-le-theme-du-slider'>Changer le thème du slider<a class='sommaire-back sommaire-back-7' href='#s-Changer-le-theme-du-slider' title='Back to the table of contents'></a></h2> <p>Pour changer le thème du slider, on ajoutera à <code class='spip_code spip_code_inline' dir='ltr'>data-slider</code> une option <code class='spip_code spip_code_inline' dir='ltr'>css</code> contenant le chemin du fichier CSS du thème. Il est inutile de préciser le paramètre <code class='spip_code spip_code_inline' dir='ltr'>theme</code>, ce dernier étant calculé automatiquement d'après le nom de la CSS.</p> <p>Exemple :</p> <div class="precode"><pre data-language="SPIP2" class='spip_code spip_code_block language-SPIP2' dir='ltr' style='text-align:left;'><code><B_slider> <div class="slider-conteneur liste article" style="width:500px;"> <ul class="slider-anythingslider liste-items" data-slider='{ css:["#CHEMIN{lib/anythingslider/css/theme-simple.css}"], buildStartStop: false, buildNavigation: true }'> <BOUCLE_slider(ARTICLES) {!par date}{par num titre} {0,10}> <li class="panel"> .... contenu de chaque item ..... </li> </BOUCLE_slider> </ul> </div> </B_slider></code></pre></div><h2 class="h2" id='Personnaliser-les-onglets-de-navigation'>Personnaliser les onglets de navigation<a class='sommaire-back sommaire-back-7' href='#s-Personnaliser-les-onglets-de-navigation' title='Back to the table of contents'></a></h2> <p>Par défaut, et pour les thèmes les prenant en charge, les onglets de navigation sont numérotés séquentiellement. Il est cependant possible de les personnaliser en ajoutant dans chaque <code class='spip_code spip_code_inline' dir='ltr'><li></li></code> un élément avec la classe <code class='spip_code spip_code_inline' dir='ltr'>slider-nav</code> contenant le contenu de l'onglet de navigation. Par exemple :</p> <div class="precode"><pre data-language="SPIP2" class='spip_code spip_code_block language-SPIP2' dir='ltr' style='text-align:left;'><code><B_slider> <div class="slider-conteneur liste article" style="width:500px;"> <ul class="slider-anythingslider liste-items" data-slider='{ css:["#CHEMIN{lib/anythingslider/css/theme-default1.css}"], buildStartStop: false, buildNavigation: true }'> <BOUCLE_slider(ARTICLES) {!par date}{par num titre} {0,10}> <li class="panel"> .... contenu de chaque item ..... <span class="slider-nav" style="display: none;">[(#TITRE|couper{20})]</span> </li> </BOUCLE_slider> </ul> </div> </B_slider></code></pre></div><h2 class="h2" id='Utilisations-avancees'>Utilisations avancées<a class='sommaire-back sommaire-back-7' href='#s-Utilisations-avancees' title='Back to the table of contents'></a></h2> <p>Si pour des usages plus avancés d'AnythingSlider (voir documentation d'AnythingSlider), vous avez besoin de charger plusieurs CSS et/ou script JS supplémentaires, ces derniers peuvent être indiqués via les options <code class='spip_code spip_code_inline' dir='ltr'>css</code> et <code class='spip_code spip_code_inline' dir='ltr'>js</code> de l'attribut <code class='spip_code spip_code_inline' dir='ltr'>data-slider</code>.</p></div> </article> <article> <h1>Arborescence de l'intégration</h1> <p>tetue — 2011-05-20T07:04:00Z</p> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-3" id="nav6a60d14a2514c0.76393507"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Arborescence-des-fichiers-statiques-d-integration"></a><a href="#Arborescence-des-fichiers-statiques-d-integration" class="spip_ancre">Arborescence des fichiers statiques d'intégration</a></li><li> <a id="s-Arborescence-finale-dans-SPIP"></a><a href="#Arborescence-finale-dans-SPIP" class="spip_ancre">Arborescence finale dans SPIP</a></li><li> <a id="s-Arborescence-possible-dans-SPIP-Z"></a><a href="#Arborescence-possible-dans-SPIP-Z" class="spip_ancre">Arborescence possible dans SPIP+Z</a></li></ul></div><h2 class="h2" id='Arborescence-des-fichiers-statiques-d-integration'>Arborescence des fichiers statiques d'intégration<a class='sommaire-back sommaire-back-3' href='#s-Arborescence-des-fichiers-statiques-d-integration' title='Back to the table of contents'></a></h2><div class='spip_document_9737 spip_document spip_documents spip_document_file spip_documents_right spip_document_right spip_document_avec_legende' data-legende-len="74" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/zip/basecss-demo.zip' class=" spip_doc_lien" title='Zip - 352.8 KiB' type="application/zip"></a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-9737 '><strong>Demo statique </strong></div> <div class='spip_doc_descriptif crayon document-descriptif-9737 '>Kit statique (HTML/CSS/JS) de démarrage pour l'intégrateur </div> </figcaption></figure> </div> <p>Rien n'est imposé, mais voici comment organiser au mieux votre intégration statique afin de bénéficier de tous les automatismes :</p> <ul class="spip" role="list"><li> <strong>/theme</strong> <ul class="spip" role="list"><li> layout.html</li><li> typo.html</li><li> article.html</li><li> rubrique.html</li><li> ...</li><li> favicon.ico</li><li> <strong>/css</strong> <ul class="spip" role="list"><li> reset.css<span class="spip_note_ref"> [<a href="#nb29-_2A" class="spip_note" rel="appendix" title="Il est inutile de les personnaliser ces feuilles de styles : elles ne seront (…)" id="nh29-_2A">*</a>]</span></li><li> typo.css<span class="spip_note_ref"> [<a href="#nb29-_2A" class="spip_note" rel="appendix">*</a>]</span></li><li> form.css<span class="spip_note_ref"> [<a href="#nb29-_2A" class="spip_note" rel="appendix">*</a>]</span></li><li> spip.css<span class="spip_note_ref"> [<a href="#nb29-_2A" class="spip_note" rel="appendix">*</a>]</span></li><li> clear.css<span class="spip_note_ref"> [<a href="#nb29-_2A" class="spip_note" rel="appendix">*</a>]</span></li><li> grid.css</li><li> layout.css</li><li> style.css</li><li> <strong>/img</strong> : contient les images appelées dans les feuilles de style (réparties au besoin en sous-répertoires bg, border, sprite, etc.)</li><li> /font : contient, si nécessaire, les polices appelées dans les feuilles de style (avec <code class='spip_code spip_code_inline' dir='ltr'>@font-face</code>)</li></ul></li><li> <strong>/img</strong> : contient les images appelées directement dans le HTML (réparties au besoin en sous-répertoires buttons, tools, etc.)</li><li> <strong>/js</strong> <ul class="spip" role="list"><li> jquery.js<span class="spip_note_ref"> [<a href="#nb29-_2A_2A" class="spip_note" rel="appendix" title="Ces fichiers, indispensables au moment de l'intégration, ne doivent pas être (…)" id="nh29-_2A_2A">**</a>]</span></li><li> jquery.form.js<span class="spip_note_ref"> [<a href="#nb29-_2A_2A" class="spip_note" rel="appendix">**</a>]</span></li><li> ajaxCallback.js<span class="spip_note_ref"> [<a href="#nb29-_2A_2A" class="spip_note" rel="appendix">**</a>]</span></li><li> jquery.cookie.js<span class="spip_note_ref"> [<a href="#nb29-_2A_2A" class="spip_note" rel="appendix">**</a>]</span></li><li> script1.js</li><li> script2.js</li><li> ...</li></ul></li><li> /polices : contient, si nécessaire, les polices à utiliser dans les squelettes pour la génération auto d'<a href="http://www.spip.net/fr_article3325.html" class="spip_out" rel="external">images typo</a> <ul class="spip" role="list"><li> stencil.ttf</li></ul></li><li> /masque : contient, si nécessaire, les découpes PNG prêtes à être utilisées par SPIP dans les <a href="http://www.spip.net/fr_article3327.html" class="spip_out" rel="external">traitements automatisés d'images</a>, en passe-partout, texture, etc. <ul class="spip" role="list"><li> masque1.png</li><li> masque2.png</li><li> ...</li></ul></li><li> <strong>/toto</strong> : contient les illustrations et autres faux contenus, et tout ce qu'on ne sait pas où ranger, qui sera vraisemblablement supprimé une fois le site en fonctionnement <ul class="spip" role="list"><li> ...</li></ul></li></ul></li></ul><h2 class="h2" id='Arborescence-finale-dans-SPIP'>Arborescence finale dans SPIP<a class='sommaire-back sommaire-back-3' href='#s-Arborescence-finale-dans-SPIP' title='Back to the table of contents'></a></h2> <p>Si l'intégration est bien rangée, elle peut être déposée telle quelle dans SPIP, dans votre dossier « squelettes », qui ressemblera à ça sur le site final :</p> <ul class="spip" role="list"><li> <strong>/squelettes</strong> <ul class="spip" role="list"><li> sommaire.html</li><li> rubrique.html</li><li> article.html</li><li> ...</li><li> favicon.ico</li><li> <strong>/css</strong> <ul class="spip" role="list"><li> style.css</li><li> <strong>/img</strong></li><li> /font</li></ul></li><li> <strong>/js</strong> <ul class="spip" role="list"><li> script1.js</li><li> script2.js</li></ul></li><li> <strong>/img</strong></li><li> /masque</li><li> /polices</li><li> /modeles</li><li> /formulaires</li><li> /lang</li><li> ...</li></ul></li></ul> <p>D'autres fichiers (scripts, feuilles et images) sont appelés dans les pages finales du site, depuis les plugins, structurés selon la même arborescence. Pour surcharger, il suffit de glisser un fichier homonyme, au même emplacement de l'arborescence, dans ce dossier « squelettes ». SPIP, c'est simple !</p> <h2 class="h2" id='Arborescence-possible-dans-SPIP-Z'>Arborescence possible dans SPIP+Z<a class='sommaire-back sommaire-back-3' href='#s-Arborescence-possible-dans-SPIP-Z' title='Back to the table of contents'></a></h2> <p>Si vous utilisez SPIP+Z, c'est davantage morcelé. Par exemple :</p> <ul class="spip" role="list"><li> <strong>/squelettes</strong> <ul class="spip" role="list"><li> <strong>body.html</strong> : gabarit principal, à partir duquel seront généré <i>toutes</i> les pages, ce fichier ne contient que la balise <code class='spip_code spip_code_inline' dir='ltr'><body></code> et les quelques div des blocs principaux</li><li> <strong>/content</strong> : contient uniquement les cœurs de vos pages <ul class="spip" role="list"><li> dist.html</li><li> page.html</li><li> page_sommaire.html</li><li> rubrique.html</li><li> article.html</li><li> page_login.html</li><li> ...</li></ul></li><li> /aside <ul class="spip" role="list"><li> dist.html</li><li> page.html</li></ul></li><li> <strong>/inclure</strong> <ul class="spip" role="list"><li> head.html</li><li> header.html</li><li> nav.html</li><li> footer.html</li><li> ...</li></ul></li><li> /modeles</li><li> /formulaires</li><li> /lang</li><li> favicon.ico</li><li> <strong>/css</strong> <ul class="spip" role="list"><li> style.css</li><li> <strong>/img</strong></li><li> /font</li></ul></li><li> <strong>/js</strong> <ul class="spip" role="list"><li> script1.js</li><li> script2.js</li></ul></li><li> <strong>/img</strong></li><li> /masque</li><li> /polices</li><li> ...</li></ul></li></ul></div> <hr /> <div class='rss_notes'><div id="nb29-_2A"> <p><span class="spip_note_ref">[<a href="#nh29-_2A" class="spip_note" title="Footnotes 29-_2A" rev="appendix">*</a>] </span>Il est inutile de les personnaliser ces feuilles de styles : elles ne seront pas déposées sur le site final où elles sont insérées de façon automatisée par ce plugin. Elles sont alors paramétrables depuis l'espace privé de SPIP.</p> </div><div id="nb29-_2A_2A"> <p><span class="spip_note_ref">[<a href="#nh29-_2A_2A" class="spip_note" title="Footnotes 29-_2A_2A" rev="appendix">**</a>] </span>Ces fichiers, indispensables au moment de l'intégration, ne doivent pas être personnalisés, car ils ne seront pas déposés sur le site final où ils sont systématiquement insérés par SPIP.</p> </div></div> </article> <article> <h1>Article PDF</h1> <p>christophe vallois — 2007-06-09T17:06:24Z</p> <div class='rss_chapo'><p>Présentation d'un plugin fournissant une version PDF de l'article en cours</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-7" id="nav6a60d14a27b1b6.13599186"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Presentation"></a><a href="#Presentation" class="spip_ancre">Présentation</a></li><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-installation-SPIP-3"></a><a href="#installation-SPIP-3" class="spip_ancre">installation SPIP 3</a></li><li> <a id="s-Limites"></a><a href="#Limites" class="spip_ancre">Limites</a></li><li> <a id="s-Personnalisation"></a><a href="#Personnalisation" class="spip_ancre">Personnalisation</a></li><li> <a id="s-Auteurs-du-plugin"></a><a href="#Auteurs-du-plugin" class="spip_ancre">Auteurs du plugin:</a></li><li> <a id="s-Ajouts"></a><a href="#Ajouts" class="spip_ancre">Ajouts</a></li></ul></div><h2 class="h2" id='Presentation'>Présentation<a class='sommaire-back sommaire-back-7' href='#s-Presentation' title='Back to the table of contents'></a></h2> <p>Le plugin article PDF est encore développé sur la zone. Il est parfaitement fonctionnel mais possède peut être encore quelques bugs. Il permet de convertir votre article sous forme de fichier PDF. Vous pouvez alors à loisir l'enregistrer ou l'imprimer.</p> <p>Le fichier pdf généré gère les liens html ainsi que les images de l'article.</p> <h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-7' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>L'installation se déroule ensuite comme pour tous les autres plugins, cf. <a href="http://www.spip.net/fr_article3396.html" class="spip_url spip_out" rel="external">http://www.spip.net/fr_article3396.html</a>.</p> <p>Une fois le plugin activé vous disposez d'une balise <code class='spip_code spip_code_inline' dir='ltr'>#ARTICLE_PDF</code> à placer dans votre squelette sous la forme <code class='spip_code spip_code_inline' dir='ltr'>#ARTICLE_PDF{id_article}</code>, et d'une balise <code class='spip_code spip_code_inline' dir='ltr'>#RUBRIQUE_PDF</code> à placer sous la forme <code class='spip_code spip_code_inline' dir='ltr'>#RUBRIQUE_PDF{id_rubrique}</code>.</p> <div class='spip_document_4459 spip_document spip_documents spip_document_image spip_documents_left spip_document_left spip_document_avec_legende' data-legende-len="12" data-legende-lenx="" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-4459 '><strong>Format PDF </strong></div> </figcaption></figure> </div> <p>La balise génère alors un bouton qui vous permet d'afficher la version au format pdf de l'article</p> <p>Il est aussi possible d'ajouter, dans la partie <code class='spip_code spip_code_inline' dir='ltr'>head</code> du squelette html d'article, <code class='spip_code spip_code_inline' dir='ltr'><link rel="alternate" type="application/pdf" href="#URL_PAGE{article_pdf}|parametre_url{id_article,#ID_ARTICLE}" /></code> et/ou <code class='spip_code spip_code_inline' dir='ltr'><link rel="alternate" type="application/pdf" href="#URL_PAGE{rubrique_pdf}|parametre_url{id_rubrique,#ID_RUBRIQUE}" /></code>, afin de lier sémantiquement la version pdf à l'article en cours.</p> <p>Nota : ce plugin nécessite d'avoir <a href="http://www.spip.net/fr_article3024.html" class="spip_out" rel="external">la bibliothèque image GD2</a> sur votre serveur (ce qui est souvent le cas).</p> <div class='spip_document_4460 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='installation-SPIP-3'>installation SPIP 3<a class='sommaire-back sommaire-back-7' href='#s-installation-SPIP-3' title='Back to the table of contents'></a></h2> <p>Sous SPIP 3, il est nécessaire d'installer la librairie <a href="http://www.fpdf.org/fr/download/fpdf17.zip" class="spip_out" rel="external">FPDF</a> dans le répertoire /lib/h5c1accba-fpdf17 (le créer au besoin si l'installation automatique échoue)</p> <h2 class="h2" id='Limites'>Limites<a class='sommaire-back sommaire-back-7' href='#s-Limites' title='Back to the table of contents'></a></h2> <p>Le plugin a quelques limites, notamment le générateur de pdf, qui n'accepte pas de texte en utf-8 en entrée, ce qui nécessite une conversion préalable.</p> <h2 class="h2" id='Personnalisation'>Personnalisation<a class='sommaire-back sommaire-back-7' href='#s-Personnalisation' title='Back to the table of contents'></a></h2> <p>Vous pouvez remplacer l'icône du bouton article pdf en remplaçant le fichier <i>plugins/article_pdf/img_pack/article_pdf.png</i> par le votre</p> <p>Quelques icônes alternatives</p> <div class='spip_document_4461 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><div class='spip_document_4462 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><div class='spip_document_4463 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><div class='spip_document_4464 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Vous pouvez aussi adapter la page PDF générée, en modifiant des copies des squelettes d'origine <code class='spip_code spip_code_inline' dir='ltr'>article_pdf.html</code> et <code class='spip_code spip_code_inline' dir='ltr'>rubrique_pdf.html</code> dans votre propre dossier <code class='spip_code spip_code_inline' dir='ltr'>./squelettes/</code>.</p> <h2 class="h2" id='Auteurs-du-plugin'>Auteurs du plugin:<a class='sommaire-back sommaire-back-7' href='#s-Auteurs-du-plugin' title='Back to the table of contents'></a></h2> <p><br />- <a href='https://contrib.spip.net/_Paul-Sanches_' class="spip_in">Paul Sanches</a> <br />- <a href='https://contrib.spip.net/_Aquinatus_' class="spip_in">Aquinatus</a> <br />- <a href='https://contrib.spip.net/Cerdic' class="spip_in">Cédric Morin</a></p> <h2 class="h2" id='Ajouts'>Ajouts<a class='sommaire-back sommaire-back-7' href='#s-Ajouts' title='Back to the table of contents'></a></h2> <p>Cette documentation est sommaire et pourrait être enrichie.</p></div> </article> <article> <h1>Auteurs partout</h1> <p>cy_altern, Maïeul — 2013-07-26T17:12:00Z</p> <div class='rss_chapo'><p>Avec SPIP 3, il possible d'associer des auteurs à tout type d'objet SPIP. Cependant, il manquait une interface pour cela. Le plugin auteurs partout permet d'ajouter des auteurs à tout type d'objet.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-3" id="nav6a60d14a2ad7e1.38714214"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation-et-configuration"></a><a href="#Installation-et-configuration" class="spip_ancre">Installation et configuration</a></li><li> <a id="s-Utilisation-dans-l-espace-prive"></a><a href="#Utilisation-dans-l-espace-prive" class="spip_ancre">Utilisation dans l'espace privé</a></li><li> <a id="s-Utilisation-dans-les-squelettes"></a><a href="#Utilisation-dans-les-squelettes" class="spip_ancre">Utilisation dans les squelettes</a></li></ul></div><h2 class="h2" id='Installation-et-configuration'>Installation et configuration<a class='sommaire-back sommaire-back-3' href='#s-Installation-et-configuration' title='Back to the table of contents'></a></h2> <p>Le plugin nécéssite SPIP 3 minimum. Il s'installe comme <a href="https://www.spip.net/fr_article3396.html" class="spip_out" rel="external">n'importe quel plugin</a>.</p> <p>Une fois activé la page de configuration du contenu du site propose d'activer les auteurs sur tous les objets SPIP, à l'exception des : <br />- articles et messages, puisque la fonctionalité est standard. <br />- rubriques, à cause de la manière dont SPIP gère les administrateurs restreints.<span class="spip_note_ref"> [<a href="#nb30-1" class="spip_note" rel="appendix" title="La table utilise déjà l'objet pour l'associer à un auteur lorsque celui-ci (…)" id="nh30-1">1</a>]</span> <br />- auteurs, et pour cause !</p> <p>Le plugin fonctionne avec tous les objets SPIP natifs (mots, documents etc.) et avec tous ceux créés par des plugins qui respectent l'<a href="https://www.spip.net/fr_article5525.html" class="spip_out" rel="external">API de déclaration d'objet</a> (par exemple des point <a href='https://contrib.spip.net/GIS-2-GIS-3' class="spip_in" hreflang="fr">GIS</a>, ou des <a href='https://contrib.spip.net/Des-jeux-avec-des-scores' class="spip_in" hreflang="fr">jeux</a>).</p> <div class='spip_document_11877 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="41" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-11877 '><strong>Formulaire de configuration des auteurs </strong></div> </figcaption></figure> </div><h2 class="h2" id='Utilisation-dans-l-espace-prive'>Utilisation dans l'espace privé<a class='sommaire-back sommaire-back-3' href='#s-Utilisation-dans-l-espace-prive' title='Back to the table of contents'></a></h2> <p>Lorsqu'un personne crée un objet sur lequel les auteurs sont activés, il y est automatiquement associé.</p> <p>Par ailleurs, en bas de la page de modification d'un objet, il est possible d'associer/de dissocier des auteurs à l'objet.</p> <h2 class="h2" id='Utilisation-dans-les-squelettes'>Utilisation dans les squelettes<a class='sommaire-back sommaire-back-3' href='#s-Utilisation-dans-les-squelettes' title='Back to the table of contents'></a></h2> <p>On peut utiliser le critère <code class='spip_code spip_code_inline' dir='ltr'>{id_auteur}</code> sur n'importe quelle boucle d'objet. Par exemple :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_auteurs(AUTEURS)> <B_doc> <h3>Les documents de #NOM :</h3> <ul> <BOUCLE_doc(DOCUMENTS){id_auteur}> <li><a href="#URL_DOCUMENT">#TITRE</a></li> </BOUCLE_doc> </ul> </B_doc> </BOUCLE_auteurs></code></pre></div></div> <hr /> <div class='rss_notes'><div id="nb30-1"> <p><span class="spip_note_ref">[<a href="#nh30-1" class="spip_note" title="Footnotes 30-1" rev="appendix">1</a>] </span>La table <code class='spip_code spip_code_inline' dir='ltr'>spip_auteurs_liens</code> utilise déjà l'objet <code class='spip_code spip_code_inline' dir='ltr'>rubrique</code> pour l'associer à un auteur lorsque celui-ci est admin restreint de la rubrique. Et on ne peut pas activer ou désactiver cette association qui fait partie du core de SPIP.</p> </div></div> </article> <article> <h1>AutoLang : Aiguiller le visiteur selon sa langue de navigateur</h1> <p>HAPpy, RealET — 2017-12-06T09:23:26Z</p> <div class='rss_chapo'><p>Un moyen simple d'afficher un site dans la langue désirée par le visiteur</p></div> <div class='rss_texte'><p><div class="well nav-sommaire nav-sommaire-3" id="nav6a60d14a2dbf18.77036540"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Un-peu-de-theorie"></a><a href="#Un-peu-de-theorie" class="spip_ancre">Un peu de théorie</a></li><li> <a id="s-Pre-requis"></a><a href="#Pre-requis" class="spip_ancre">Pré-requis</a></li><li> <a id="s-Fonctionnement"></a><a href="#Fonctionnement" class="spip_ancre">Fonctionnement</a></li></ul></div></p> <h2 class="h2" id='Un-peu-de-theorie'>Un peu de théorie<a class='sommaire-back sommaire-back-3' href='#s-Un-peu-de-theorie' title='Back to the table of contents'></a></h2> <p>Tous les navigateurs web peuvent être configurés pour indiquer leurs préférences linguistiques<span class="spip_note_ref"> [<a href="#nb31-1" class="spip_note" rel="appendix" title="Par exemple : de préférence du Français, et puis sinon de l'anglais, et (…)" id="nh31-1">1</a>]</span>.</p> <p>Cette information est transmise aux serveurs web à chaque requête afin que le site web concerné puisse en tenir compte.</p> <p>C'est ce que traite ce plugin.</p> <h2 class="h2" id='Pre-requis'>Pré-requis<a class='sommaire-back sommaire-back-3' href='#s-Pre-requis' title='Back to the table of contents'></a></h2><ul class="spip" role="list"><li> un site web sous SPIP</li><li> avec le multilinguisme activé</li><li> avec un #MENU_LANG dans le squelette quelque part pour permettre au visiteur de changer sa langue de navigation ; ou mieux encore, utiliser <a href='https://contrib.spip.net/Menu-de-langues-sous-forme-de-liens' class="spip_in" hreflang="fr">Menu de langues sous forme de liens</a>.</li><li> et probablement avec <code class='spip_code spip_code_inline' dir='ltr'>$forcer_lang=true;</code> dans config/mes_options.php<span class="spip_note_ref"> [<a href="#nb31-2" class="spip_note" rel="appendix" title="Ce plugin n'a été testé que dans ce contexte, mais si les retours disent (…)" id="nh31-2">2</a>]</span></li></ul> <p>NB : ce plugin a été testé avec succès avec le <a href='https://contrib.spip.net/SoyezCreateurs-1237' class="spip_in" hreflang="fr">squelette SoyezCréateurs</a>.</p> <h2 class="h2" id='Fonctionnement'>Fonctionnement<a class='sommaire-back sommaire-back-3' href='#s-Fonctionnement' title='Back to the table of contents'></a></h2> <p>Une fois activé — si l'internaute n'a pas déjà visité le site et indiqué une langue préférée via le menu de langue du site — le plugin détecte la liste des langues passées par le navigateur au site, et prend :</p> <ul class="spip" role="list"><li> la première langue du site correspondant à une préférence de l'internaute</li><li> à défaut, la langue par défaut du site</li></ul> <p>Après ça, l'internaute peut bien évidemment choisir une autre langue de navigation via le menu de langue du site.</p></div> <hr /> <div class='rss_notes'><div id="nb31-1"> <p><span class="spip_note_ref">[<a href="#nh31-1" class="spip_note" title="Footnotes 31-1" rev="appendix">1</a>] </span>Par exemple : de préférence du Français, et puis sinon de l'anglais, et enfin de l'allemand.</p> </div><div id="nb31-2"> <p><span class="spip_note_ref">[<a href="#nh31-2" class="spip_note" title="Footnotes 31-2" rev="appendix">2</a>] </span>Ce plugin n'a été testé que dans ce contexte, mais si les retours disent que ça n'est pas nécessaire, l'article sera modifié en conséquence.</p> </div></div> <div class='rss_ps'><p>L'icone initiale de ce plugin venait du projet <a href="http://www.languageicon.org/" class="spip_out" rel="external">Language Icon</a>.</p></div> </article> <article> <h1>Badge pour dons</h1> <p>b_b — 2012-02-08T13:33:55Z</p> <div class='rss_chapo'><p>Ce plugin permet d'afficher un badge dans les pages publiques de votre site pour inciter les visiteurs à faire des dons.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-2" id="nav6a60d14a307de9.95743746"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation-et-configuration"></a><a href="#Installation-et-configuration" class="spip_ancre">Installation et configuration</a></li><li> <a id="s-Configuration-et-personnalisation"></a><a href="#Configuration-et-personnalisation" class="spip_ancre">Configuration et personnalisation</a></li></ul></div><p>Ce plugin a été réalisé afin d'afficher un badge d'appel au don sur plusieurs sites gérés par l'association «Les petits débrouillards Bretagne». Le badge est affiché dans le coin en bas à droite des pages publiques du site et il comporte un lien vers la page de votre choix.</p> <p>Vous pouvez observer le résultat sur <a href="http://www.lespetitsdebrouillardsbretagne.org/" class="spip_out" rel="external">le site de l'association</a> et sur le site <a href="http://www.lestaxinomes.org/" class="spip_out" rel="external">lestaxinomes.org</a>.</p> <h2 class="h2" id='Installation-et-configuration'>Installation et configuration<a class='sommaire-back sommaire-back-2' href='#s-Installation-et-configuration' title='Back to the table of contents'></a></h2><div class='spip_document_10432 spip_document spip_documents spip_document_file spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="60" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href="https://files.spip.net/spip-zone/badge_don.zip" class=" spip_doc_lien" title='Zip - 17.2 KiB' type="application/zip"></a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10432 '><strong>Badge pour dons (0.2.2) </strong></div> <div class='spip_doc_descriptif crayon document-descriptif-10432 '>Télécharger le plugin sur la zone. </div> </figcaption></figure> </div> <p><a href="http://www.spip.net/fr_article3396.html" class="spip_out" rel="external">Installation et activation comme tous les plugins</a>.</p> <h2 class="h2" id='Configuration-et-personnalisation'>Configuration et personnalisation<a class='sommaire-back sommaire-back-2' href='#s-Configuration-et-personnalisation' title='Back to the table of contents'></a></h2> <p>L'url du lien du badge est personnalisable de deux façons. Vous pouvez déclarer l'url depuis le fichier <code class='spip_code spip_code_inline' dir='ltr'>config/mes_options.php</code> de votre site en y ajoutant la ligne suivante :</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>define('_BADGE_DON_URL', 'http://www.spip.net'); </code></pre></div> <p>Si <a href='https://contrib.spip.net/SPIP-Bonux' class="spip_in" hreflang="fr">le plugin SPIP-bonux</a> est installé, vous pouvez aussi déclarer l'url de la page de don depuis la page de configuration du plugin.</p> <p><strong>Remarque</strong> : depuis la version 0.2.0 il est possible de définir l'url de la page de don en utilisant les raccourcis SPIP du type art23 ou rub32 (pour faire pointer le lien du badge vers l'article 23 ou la rubrique 32).</p> <div class='spip_document_10431 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="60" data-legende-lenx="x" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10431 '><strong>Badge par défaut - CC-BY Les petits débrouillards Bretagne </strong></div> </figcaption></figure> </div> <p>Vous pouvez aussi personnaliser l'image affichée par le badge en déposant un fichier nommé <code class='spip_code spip_code_inline' dir='ltr'>badge_don.png</code> dans le répertoire <code class='spip_code spip_code_inline' dir='ltr'>squelettes/images</code> de votre site. Votre image personnalisée doit être un carré de 100 pixels de côté.</p></div> </article> <article> <h1>Balise #BOLO</h1> <p>Cyril Marion — 2009-02-18T12:33:33Z</p> <div class='rss_chapo'><p>Cette balise évite de taper du faux texte (“bolo” ou “lorem ipsum”) à la main dans les squelettes pendant leur mise au point. Elle existe désormais sous forme d'un plugin pour une installation “en un clic”.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d14a32ebb0.86443576"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Utilisation"></a><a href="#Utilisation" class="spip_ancre">Utilisation</a></li><li> <a id="s-Utilisation-dans-les-squelettes"></a><a href="#Utilisation-dans-les-squelettes" class="spip_ancre">Utilisation dans les squelettes</a></li><li> <a id="s-Utilisation-avec-un-modele-SPIP"></a><a href="#Utilisation-avec-un-modele-SPIP" class="spip_ancre">Utilisation avec un modèle SPIP</a></li></ul></div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-4' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Installez le plugin <code class='spip_code spip_code_inline' dir='ltr'>Balise #BOLO</code> de manière tout à fait classique. Le plugin est le même pour SPIP 2.x ou SPIP 3.0.</p> <h2 class="h2" id='Utilisation'>Utilisation<a class='sommaire-back sommaire-back-4' href='#s-Utilisation' title='Back to the table of contents'></a></h2> <p>Si vous devez commencer la mise en place de votre site sans avoir à disposition tous les contenus, vous pourrez facilement simuler les textes avec la balise <code class='spip_code spip_code_inline' dir='ltr'>#BOLO</code>. Cette balise s'emploie aussi bien dans vos squelettes que dans les textes mêmes de vos articles avec le modèle <code class='spip_code spip_code_inline' dir='ltr'><bolo></code>.</p> <h2 class="h2" id='Utilisation-dans-les-squelettes'>Utilisation dans les squelettes<a class='sommaire-back sommaire-back-4' href='#s-Utilisation-dans-les-squelettes' title='Back to the table of contents'></a></h2> <p>Placez simplement la balise <code class='spip_code spip_code_inline' dir='ltr'>#BOLO</code> dans un de vos squelettes en cours de développement, par exemple à l'endroit où plus tard, lorsque les contenus de votre site seront disponibles, vous voudrez faire afficher un bloc de texte.</p> <p>A l'affichage la balise sera remplacée par du faux texte. Par défaut il y a environ 3000 caractères. Vous pouvez utiliser le filtre <code class='spip_code spip_code_inline' dir='ltr'>|couper{100}</code> pour limiter l'affichage à 100 caractères.</p> <p>Exemple :</p> <div class="precode"><pre data-language="texte" class='spip_code spip_code_block language-texte' dir='ltr' style='text-align:left;'><code><div id="partie_principale"> <div id="actus2"> <h1>BLOC ACTUS 2</h1> <p>[(#BOLO|couper{800})]</p> </div> <div id="une"> <h1>BLOC A la une</h1> <p>[(#BOLO|couper{500})]</p> </div> <div id="news"> <h1>BLOC NEWS</h1> <p>[(#BOLO|couper{400})]</p> </div> </div></code></pre></div> <h2 class="h2" id='Utilisation-avec-un-modele-SPIP'>Utilisation avec un modèle SPIP<a class='sommaire-back sommaire-back-4' href='#s-Utilisation-avec-un-modele-SPIP' title='Back to the table of contents'></a></h2> <p>Le cas d'utilisation précédent est utilisable au début d'un projet lorsque la base SPIP est vide ou quasi vide... Mais si vous voulez utiliser la balise au sein d'articles déjà écrits mais dont le contenu n'est pas encore définitif, vous pouvez utiliser un modèle. A la mise en ligne il vous suffira de remplacer l'appel au modèle par le “vrai” texte.</p> <p>Dans vos articles, placez simplement le code <code class='spip_code spip_code_inline' dir='ltr'><bolo300></code> dans n'importe quelle zone de texte (chapo, descriptif, texte, ps) pour obtenir 300 caractères de faux texte...</p> <p>Bonne utilisation !</p></div> </article> <article> <h1>Balise #IMAGE_PAR_DEFAUT</h1> <p>Cyril Marion — 2014-04-12T08:50:00Z</p> <div class='rss_chapo'><p>Cette balise génère à la volée des images dont on peut préciser la taille et la couleur. Elle s'utilise par exemple lors du développement d'un site, lorsqu'il manque des images. On la place alors dans la partie alternative de boucles requérant ces images, et elle sera appelée chaque fois qu'une image requise n'a pas été trouvée par la boucle.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-3" id="nav6a60d14a36fed3.95391573"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Cas-d-utilisation"></a><a href="#Cas-d-utilisation" class="spip_ancre">Cas d'utilisation</a></li><li> <a id="s-Parametres"></a><a href="#Parametres" class="spip_ancre">Paramètres</a></li><li> <a id="s-Exemples-d-appel"></a><a href="#Exemples-d-appel" class="spip_ancre">Exemples d'appel</a></li></ul></div><h2 class="h2" id='Cas-d-utilisation'>Cas d'utilisation<a class='sommaire-back sommaire-back-3' href='#s-Cas-d-utilisation' title='Back to the table of contents'></a></h2> <p>Imaginons le cas d'un site où l'on ait absolument besoin d'une série d'images d'une certaine taille par exemple pour alimenter un slider. Imaginons que ces images ne soient pas encore présentes sur le site.</p> <p>Créons un squelette de slider qui tente dans un premier temps de récupérer les images requises (de largeur 960px par exemple) depuis la bibliothèque dans une boucle<span class="spip_note_ref"> [<a href="#nb32-1" class="spip_note" rel="appendix" title="Les filtres sur la boucle document et sur la balise #FICHIER sont donnés à (…)" id="nh32-1">1</a>]</span> :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_a_la_une_image(DOCUMENTS){id_article}{extension IN png,jpg,gif}{0,1}{largeur >= 960}> [(#FICHIER |image_passe_partout{960,260}|image_recadre{960,260} |inserer_attribut{alt,""})] </BOUCLE_a_la_une_image> ...</code></pre></div> <p>Ajoutons une partie alternative à la boucle afin de traiter les cas où les images requises ne sont pas encore en bae. La balise #IMAGE_PAR_DEFAUT sera appelée en lieu et place du fichier manquant :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> ... [(#IMAGE_PAR_DEFAUT{960,260} |image_passe_partout{960,260}|image_recadre{960,260} |inserer_attribut{alt,""})] <//B_a_la_une_image></code></pre></div><h2 class="h2" id='Parametres'>Paramètres<a class='sommaire-back sommaire-back-3' href='#s-Parametres' title='Back to the table of contents'></a></h2> <p>Outre les dimensions de l'image à fabriquer, on peut passer à la balise #IMAGE_PAR_DEFAUT d'autres paramères : <br />- un texte (court...) <br />- une couleur pour le fond (par défaut gris #cccccc...) <br />- une couleur pour le texte (par défaut #444444...)</p> <h2 class="h2" id='Exemples-d-appel'>Exemples d'appel<a class='sommaire-back sommaire-back-3' href='#s-Exemples-d-appel' title='Back to the table of contents'></a></h2> <p>Voici quelques exemples d'appel avec les résultats produits :</p> <p><code class='spip spip_code spip_code_inline' dir='ltr'>#IMAGE_PAR_DEFAUT{300,200,'',#009AFE,#717286}</code></p> <div class='spip_document_12142 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p><code class='spip spip_code spip_code_inline' dir='ltr'>#IMAGE_PAR_DEFAUT{300,200,'Pouet'}</code></p> <div class='spip_document_12143 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Pour de petites images :</p> <p><code class='spip spip_code spip_code_inline' dir='ltr'>#IMAGE_PAR_DEFAUT{108,108,'Silhouette',#e6d39b,#4682C8}</code></p> <div class='spip_document_12144 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Et pour des images plus grandes<span class="spip_note_ref"> [<a href="#nb32-2" class="spip_note" rel="appendix" title="Dans le cas présent sur Contrib les images sont réduites pour ne pas nuire à (…)" id="nh32-2">2</a>]</span> :</p> <p><code class='spip spip_code spip_code_inline' dir='ltr'>#IMAGE_PAR_DEFAUT{960,260,'Un texte vraiment très très long, voire trop long',#e6d39b,#4682C8}</code></p> <div class='spip_document_12145 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/91ded311a7facd4d.png' class="spip_doc_lien mediabox" type="image/png"> </a> </figure> </div></div> <hr /> <div class='rss_notes'><div id="nb32-1"> <p><span class="spip_note_ref">[<a href="#nh32-1" class="spip_note" title="Footnotes 32-1" rev="appendix">1</a>] </span>Les filtres sur la boucle document et sur la balise #FICHIER sont donnés à titre d'exemple et n'influent pas sur le comportement de la balise</p> </div><div id="nb32-2"> <p><span class="spip_note_ref">[<a href="#nh32-2" class="spip_note" title="Footnotes 32-2" rev="appendix">2</a>] </span>Dans le cas présent sur Contrib les images sont réduites pour ne pas nuire à la mise en forme</p> </div></div> <div class='rss_ps'><p>Afin d'éviter que des images alternatives issues de la balise #IMAGE_PAR_DEFAUT n'apparaissent par mégarde aux yeux des visiteurs, il est recommandé de désactiver ce plugin sur les sites en production.</p></div> </article> <article> <h1>Balise #SESSION</h1> <p>James — 2007-06-28T20:29:31Z</p> <div class='rss_chapo'><blockquote class="spip"><h2 class="h2">Attention, SPIP 2</h2> <p>Ce plugin ne doit pas être utilisé avec les versions récentes de spip <br class='autobr' /> (notamment à partir de SPIP 2) car la balise SESSION a été incorporée dans le code du noyau de SPIP. Voir <a href="http://www.spip.net/fr_article3979.html" class="spip_out" rel="external">l'article sur #SESSION</a> sur spip.net.</p> </blockquote> <p>La balise #SESSION fonctionne comme #CONFIG à ceci près qu'elle s'appuie sur le tableau associatif <code class='spip_code spip_code_inline' dir='ltr'>$auteur_session</code>. Le paramètre passé en argument détermine la valeur de session à afficher. Pour avoir une liste exhaustive des valeurs possible, consultez la doc de la fonction <a href="http://doc.spip.org/@ajouter_session" class="spip_out" rel="external">ajouter_session</a></p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-5" id="nav6a60d14a3aec54.70463059"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Principe"></a><a href="#Principe" class="spip_ancre">Principe</a></li><li> <a id="s-Appel-specifique-des-noisettes"></a><a href="#Appel-specifique-des-noisettes" class="spip_ancre">Appel spécifique des noisettes</a></li><li> <a id="s-Gestion-de-valeurs-supplementaires"></a><a href="#Gestion-de-valeurs-supplementaires" class="spip_ancre">Gestion de valeurs supplémentaires</a></li><li> <a id="s-Demonstration"></a><a href="#Demonstration" class="spip_ancre">Démonstration</a></li></ul></div><h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-5' href='#s-Installation' title='Back to the table of contents'></a></h2><ul class="spip" role="list"><li> Récuperez le code à partir <a href="http://zone.spip.org/trac/spip-zone/browser/_grenier_/balise_session" class="spip_out" rel="external">du grenier de la zone</a></li><li> décompressez là dans le répertoire <code class='spip_code spip_code_inline' dir='ltr'>plugins/</code> de votre site,</li><li> dans la page de gestion des plugin de votre site, activez le plugin Balise Session</li></ul> <p>Vous pourrez accéder à cette même documentation sur votre propre site (<code class='spip_code spip_code_inline' dir='ltr'>spip.php?page=session</code>) avec des exemples interactifs.</p> <h2 class="h2" id='Principe'>Principe<a class='sommaire-back sommaire-back-5' href='#s-Principe' title='Back to the table of contents'></a></h2> <p>Pour reconnaître le visiteur authentifié, on s'appuie sur le mécanisme de session de SPIP. Toutefois, comme cette valeur est affichée dans un squelette, on doit aussi tenir compte du cache et empêcher que les données d'un visiteur soient utilisée par les suivants, le temps de la durée de vie de la page.</p> <p>Deux moyens peuvent être employés :</p> <ul class="spip" role="list"><li> Définir à 0 la durée de vie du cache de chaque page où on affichera ou testera le contenu de la balise #SESSION. C'est une mauvaise idée en matière de performance globale pour le site</li><li> Créer une page de cache de chaque page pour chaque visiteur authentifié. Ainsi, les visiteur accèdent à des pages distinctes calculées moins souvent. C'est le principe retenu dans cette page.</li></ul> <p>On introduit donc, en plus de la balise, un script session.php, appelable par la balise standard <code class='spip_code spip_code_inline' dir='ltr'><INCLURE()></code>. Ce script est un clone du script standard de spip (<code class='spip_code spip_code_inline' dir='ltr'>spip.php</code>) à ceci-près qu'il défini un marqueur de squelette basé sur l'identifiant du visiteur, s'il est défini.</p> <h2 class="h2" id='Appel-specifique-des-noisettes'>Appel spécifique des noisettes<a class='sommaire-back sommaire-back-5' href='#s-Appel-specifique-des-noisettes' title='Back to the table of contents'></a></h2> <p>On fera appel à la balise #SESSION dans des squelettes inclus (qu'on appelle aussi noisettes...)</p> <p><code class='spip_code spip_code_inline' dir='ltr'><INCLURE(session.php){fond=page_speciale}></code></p> <p>où <code class='spip_code spip_code_inline' dir='ltr'>page_speciale.html</code> contiendra l'un au l'autre des exemples du plugin, ou de leurs combinaisons, ou d'autres éléments issus de cette page de démonstration, ou bien encore, de votre propre cru ! :D</p> <h2 class="h2" id='Gestion-de-valeurs-supplementaires'>Gestion de valeurs supplémentaires<a class='sommaire-back sommaire-back-5' href='#s-Gestion-de-valeurs-supplementaires' title='Back to the table of contents'></a></h2> <p>Il est possible de gérer des valeurs supplémentaires à celles contenues dans le tableau <code class='spip_code spip_code_inline' dir='ltr'>$auteur_session</code>. Pour cela, il faut ajouter le paramètre <code class='spip_code spip_code_inline' dir='ltr'>{session}</code> à l'appel de squelettes inclus. Dès lors, la balise #SESSION s'appuiera aussi sur le tableau associatif <code class='spip_code spip_code_inline' dir='ltr'>$_SESSION</code> php standard (cf. <a href="http://fr2.php.net/session" class="spip_out" hreflang="fr" rel="external">Le support des sessions de PHP</a>).</p> <p>Exemple : <code class='spip_code spip_code_inline' dir='ltr'><INCLURE(session.php){session}{fond=boite_session}></code></p> <p>Ce plugin introduit pour ces valeurs, une action permettant de créer/affecter une valeur en lui précisant un nom, ou de vider cette valeur. Pour faire appel à cette action, on utlisera soit un formulaire ad hoc, soit, dans ce type précis de noisettes, la balise #URL_ACTION_AUTEUR de la manière suivante:</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><a href="[(#URL_ACTION_AUTEUR{session,[(#ENV{session})]-affecter-nom-valeur,url})]"> texte du lien </a></code></pre></div> <p>ou</p> <ul class="spip" role="list"><li> nom sera le code employé pour restituer la valeur via la notation <code class='spip_code spip_code_inline' dir='ltr'>#SESSION{nom}</code>,</li><li> valeur pourra être une balise spip ou une constante,</li><li> url, l'adresse de destination du lien, #SELF ou tout autre adresse imaginable.</li></ul> <p>ou bien</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><a href="[(#URL_ACTION_AUTEUR{session,[(#ENV{session})]-vider-nom,url})]"> texte du lien </a></code></pre></div><h2 class="h2" id='Demonstration'>Démonstration<a class='sommaire-back sommaire-back-5' href='#s-Demonstration' title='Back to the table of contents'></a></h2> <p><a href="http://spip-zone.info/spip.php?page=session" class="spip_out" rel="external">spip-zone.info</a></p></div> </article> <article> <h1>Balises #SWITCH #CASE et filtre |switchcase</h1> <p>JLuc — 2016-05-20T07:40:09Z</p> <div class='rss_chapo'><p>Ce plugin introduit dans SPIP les balises #SWITCH, #CASE et #CASE_DEFAULT, ainsi que le filtre <code class='spip_code spip_code_inline' dir='ltr'>|switchcase</code> qui reproduisent le fonctionnement des <code class='spip_code spip_code_inline' dir='ltr'>switch... case... default...</code> du PHP.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d14a3e5815.34741873"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Les-balises-SWITCH-et-CASE"></a><a href="#Les-balises-SWITCH-et-CASE" class="spip_ancre">Les balises #SWITCH et #CASE</a></li><li> <a id="s-Filtre"></a><a href="#Filtre" class="spip_ancre">Filtre <code class='spip_code spip_code_inline' dir='ltr'>|switchcase</code></a></li><li> <a id="s-Utiliser-les-balises-ou-le-filtre"></a><a href="#Utiliser-les-balises-ou-le-filtre" class="spip_ancre">Utiliser les balises ou le filtre ?</a></li><li> <a id="s-Un-luxe"></a><a href="#Un-luxe" class="spip_ancre">Un luxe</a></li></ul></div><h2 class="h2" id='Les-balises-SWITCH-et-CASE'>Les balises #SWITCH et #CASE<a class='sommaire-back sommaire-back-4' href='#s-Les-balises-SWITCH-et-CASE' title='Back to the table of contents'></a></h2> <p>Les balises <code class='spip_code spip_code_inline' dir='ltr'>#SWITCH, #CASE</code> et <code class='spip_code spip_code_inline' dir='ltr'>#CASE_DEFAULT</code> permettent de comparer un élément à de multiples cas valeurs, et de renvoyer une expression selon le cas satisfait.</p> <p>L'utilisation se fait donc en 2 ou 3 parties</p> <ol class="spip" role="list"><li> Un appel initial à <code class='spip spip_code spip_code_inline' dir='ltr'>#SWITCH</code> permet de spécifier quelle est l'expression testée. L'expression est évaluée et sa valeur est mémorisée.</li><li> De multiples appels à <code class='spip spip_code spip_code_inline' dir='ltr'>#CASE</code> permettent de tester la valeur mémorisée avec plusieurs valeurs candidates. En cas d'égalité, la balise #CASE renvoie une valeur non vide (un espace) et les parties conditionnelles avant et après sont affichées.</li><li> Un éventuel appel à <code class='spip spip_code spip_code_inline' dir='ltr'>#CASE_DEFAULT</code> renvoie une valeur vraie si aucun des <code class='spip spip_code spip_code_inline' dir='ltr'>#CASE</code> n'a été satisfait.</li></ol> <p><strong>Exemple</strong></p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#SWITCH{#ENV{couleur}} [(#CASE{bleu}) Wouah, ma couleur favorite !] [(#CASE{rouge}) Ouh, c'est chaud !] [(#CASE{vert}) L'avenir et l'espoir.] [(#CASE_DEFAULT) Encore une autre couleur ?]</code></pre></div> <p>Il est possible de spécifier plusieurs valeurs testées par un même #CASE :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#SWITCH{#ENV{couleur}} [(#CASE{bleu,vert,violet,gris}) Couleur froide] [(#CASE{jaune,rouge,orange}) Couleur chaude] [(#CASE_DEFAULT) Autre couleur]</code></pre></div> <p>On peut insérer d'autres éléments de HTML ou balises spip entre les différents appels, et appeler les #CASE dans une boucle.</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#SWITCH{#ENV{id_choix}} <BOUCLE_case(ARTICLES)> <span [class="(#CASE{#ID_ARTICLE}|?{choisi,pas_choisi})"]>#TITRE</span> </BOUCLE_case> <span [class="(#CASE_DEFAULT|?{choisi,pas_choisi})"]>Autre</span></code></pre></div> <p><strong>Exemple d'usage</strong></p> <p>Vous souhaitez ranger toute une panoplie de squelettes json (<code class='spip_code spip_code_inline' dir='ltr'>calendrier.json, lesfestivals.json, programmation.json... </code>) dans un sous répertoire <code class='spip_code spip_code_inline' dir='ltr'>json</code>, mais vous souhaitez pouvoir y accéder via ajax. Or, les squelettes rangés dans un sous répertoire ne peuvent être accédés que par un webmestre. Pour ajax, vous pouvez passer par un squelette d'aiguillage à la racine, qui prend un argument “squel” et dont le code serait :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#SWITCH{#SQUEL}) [(#CASE{calendrier}) <INCLURE{json/calendrier.json,mois=#MOIS}>] [(#CASE{lesfestivals}) <INCLURE{json/lesfestivals.json,region=#REGION}>] [(#CASE{programmation}) <INCLURE{json/programmation.json,groupe=#GROUPE}>]</code></pre></div> <p>On voit que ce plugin peut efficacement remplacer le plugin <i>composition</i> dans les cas simples, avec l'avantage de ne pas modifier la structure des tables.</p> <p><strong>Autre exemple</strong></p> <p>Comment faire une énumération de termes du genre “bleu, orange, vert et or” ? <br class='autobr' /> Une virgule sépare les termes listés, sauf le dernier pour lequel c'est la conjonction “et”.<br class='autobr' /> À l'intérieur de la boucle qui liste les termes, vous pouvez insérer le code suivant :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> #SWITCH{#COMPTEUR_BOUCLE} [(#CASE{#TOTAL_BOUCLE|moins{1}}|oui) et ] [(#CASE{#TOTAL_BOUCLE}|oui)] [(#CASE_DEFAULT), ]</code></pre></div> <p><strong>Particularités</strong></p> <p>- Si plusieurs #SWITCH se succèdent, la valeur d'un nouveau #SWITCH remplace la valeur du précédent. <br />- Les structures #SWITCH #CASE sont plates : pas d'emboîtement possible à l'intérieur d'un même squelette. Si vous voulez vraiment emboîter 2 switch, il faut le faire dans un squelette inclu.</p> <p><strong><code class='spip_code spip_code_inline' dir='ltr'>#CASE</code> à valeurs multiples</strong></p> <p>Depuis la version 0.5.0 du plugin, la balise <code class='spip_code spip_code_inline' dir='ltr'>#CASE</code> peut accepter plusieurs valeurs. Dans ce cas, son évaluation est vérifiée lorsque la valeur de <code class='spip_code spip_code_inline' dir='ltr'>#SWITCH</code> figure dans l'une de ces valeurs.</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>Le <i>#GET{couleur}</i> est une couleur [(#SWITCH{#GET{couleur})] [(#CASE{bleu,vert,noir}) froide] [(#CASE{rouge,orange,jaune}) chaude]</code></pre></div> <p><strong>Variables <code class='spip_code spip_code_inline' dir='ltr'>#GET</code> internes</strong></p> <p>À tout moment, il est possible d'accéder <br />- avec <code class='spip spip_code spip_code_inline' dir='ltr'>#GET{_switch_}</code> : à la valeur testée par le <code class='spip_code spip_code_inline' dir='ltr'>#SWITCH</code> <br />- avec <code class='spip spip_code spip_code_inline' dir='ltr'>#GET{_switch_matched_}</code> : au fait que la valeur testée a été reconnue ou non par l'un des <code class='spip_code spip_code_inline' dir='ltr'>#CASE</code> précédents.</p> <h2 class="h2" id='Filtre'>Filtre <code class='spip_code spip_code_inline' dir='ltr'>|switchcase</code><a class='sommaire-back sommaire-back-4' href='#s-Filtre' title='Back to the table of contents'></a></h2> <p>SPIP bénéficie déjà du <a href="https://spip.net/4186" class="spip_out" rel="external">filtre <code class='spip_code spip_code_inline' dir='ltr'>|?</code></a> qui renvoie une valeur ou une autre selon qu'une condition est vérifiée ou non. Le filtre <code class='spip_code spip_code_inline' dir='ltr'>|switchcase</code> implémenté par ce plugin permet de renvoyer différentes valeurs selon que la valeur testée vaut différentes valeurs.</p> <p>En argument, on énumère les valeurs testées, et la valeur de retour correspondant.<br class='autobr' /> S'il reste un argument seul, c'est la valeur par défaut. On peut aussi l'indiquer avec le cas 'case_default'. Ainsi les 2 expressions suivantes sont équivalentes :</p> <table class="table spip"> <tbody> <tr class='row_odd odd'> <td><div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#TRUC|switchcase{ banane,jaune, orange,orange, ciel,bleu, case_default,inconnue })]</code></pre></div></td> <td><div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#TRUC|switchcase{ banane,jaune, orange,orange, ciel,bleu, inconnue })]</code></pre></div></td></tr> </tbody> </table><h2 class="h2" id='Utiliser-les-balises-ou-le-filtre'>Utiliser les balises ou le filtre ?<a class='sommaire-back sommaire-back-4' href='#s-Utiliser-les-balises-ou-le-filtre' title='Back to the table of contents'></a></h2> <p>C'est comme vous voulez ! Voici un exemple issu de la discussion “<a href="https://discuter.spip.net/t/174382" class="spip_url spip_out" rel="external">https://discuter.spip.net/t/174382</a>”, pour afficher une icône selon la valeur d'un champ.</p> <p>Avec les balises :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>#SWITCH{#SITUATION} [(#CASE{Adoption}) [(#CHEMIN{img/adoption_coeur.png}|image_reduire{42})]] [(#CASE{Formulaire}) [(#CHEMIN{img/adoption_en-cours.png}|image_reduire{42})]] [(#CASE{Soins}) [(#CHEMIN{img/soins.png}|image_reduire{42})]] ... </code></pre></div> <p>Et avec le filtre :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>#SET{icone, #SITUATION|switchcase{ Soins,soins, Adoption,adoption_coeur, Formulaire,adoption_en_cours}} [(#CHEMIN{img/#GET{icone}.png}|image_reduire{42})] </code></pre></div><h2 class="h2" id='Un-luxe'>Un luxe<a class='sommaire-back sommaire-back-4' href='#s-Un-luxe' title='Back to the table of contents'></a></h2> <p>De même que les filtres <code class='spip_code spip_code_inline' dir='ltr'>|oui</code>, <code class='spip_code spip_code_inline' dir='ltr'>|non</code> ou <code class='spip_code spip_code_inline' dir='ltr'>|sinon</code> et d'autres balises SPIP, ces balises ne sont pas absolument nécessaires car il est possible d'écrire vos squelettes autrement, sans elles, avec des balises et filtres plus élémentaires.</p> <p>Mais c'est bien pratique de pouvoir les utiliser ! Et le code est plus lisible...</p> <p>Selon les cas, on préfèrera utiliser les balises ou les filtres.</p> <p>En effet, on peut aussi exprimer avec les balises les exemples donnés plus haut pour le filtre :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>[(#SWITCH{truc})] [(#CASE{banane}) jaune] [(#CASE{orange}) orange] [(#CASE{ciel}) bleu] [(#CASE_DEFAULT) inconnue]</code></pre></div> <p>Utiliser le filtre <code class='spip_code spip_code_inline' dir='ltr'>|switchcase</code> est plus léger lorsque les valeurs sont des constantes simples. Lorsque l'expression des valeurs est complexe, il arrive que le compilateur SPIP ne les accepte pas directement en tant qu'argument d'un filtre et qu'il faut préparer les valeurs avant de les utiliser, ce qui complique l'écriture. Les balises <code class='spip_code spip_code_inline' dir='ltr'>#SWITCH</code> et <code class='spip_code spip_code_inline' dir='ltr'>#CASE</code> peuvent alors être plus simples à utiliser et plus lisibles.</p></div> </article> <article> <h1>Bannière de grève</h1> <p>GuillaumeW — 2023-01-20T11:55:39Z</p> <div class='rss_chapo'><p>En quelques clics, vous pouvez, grâce à ce plugin, ajouter à votre site public une bannière de soutien ou d'appel à la grève.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d14a41bf05.54065108"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Installation-du-plugin"></a><a href="#Installation-du-plugin" class="spip_ancre">Installation du plugin</a></li><li> <a id="s-Personnaliser-la-banniere"></a><a href="#Personnaliser-la-banniere" class="spip_ancre">Personnaliser la bannière</a> <ul class="spip" role="list"><li> <a id="s-Integrer-la-banniere-a-un-endroit-prescis-du-site"></a><a href="#Integrer-la-banniere-a-un-endroit-prescis-du-site" class="spip_ancre">Intégrer la bannière à un endroit prescis du site</a></li></ul></li><li> <a id="s-Clin-d-oeil"></a><a href="#Clin-d-oeil" class="spip_ancre">Clin d'oeil</a></li></ul></div><h2 class="h2" id='Installation-du-plugin'>Installation du plugin<a class='sommaire-back sommaire-back-4' href='#s-Installation-du-plugin' title='Back to the table of contents'></a></h2> <p>Pour installer le plugin bannière de grève, ce n'est pas différent des autres plugins. Pour ceux qui n'ont jamais installé de plugins SPIP, référez-vous à cet article <a href="http://www.spip.net/fr_article3396.html" class="spip_url spip_out auto" rel="nofollow external">http://www.spip.net/fr_article3396.html</a></p> <p>Une fois installé, il est toujours bon d'aller jeter un coup d'œil au panneau de configuration CFG du plugin<span class="spip_note_ref"> [<a href="#nb33-1" class="spip_note" rel="appendix" title="Icone de clé-outil dans le panneau de “Gestion des plugins”.." id="nh33-1">1</a>]</span> afin de personaliser l'affichage de la bannière.</p> <h2 class="h2" id='Personnaliser-la-banniere'>Personnaliser la bannière <a class='sommaire-back sommaire-back-4' href='#s-Personnaliser-la-banniere' title='Back to the table of contents'></a></h2> <div class='spip_document_22428 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Vous pouvez grace à cet écran de configuration personnalisé la bannière:</p> <p>En changeant le titre de la bannière par exemple. Voila quelques idées de titre détourné de slogan bien connus.</p> <p>- Grèver plus pour gagner plus. <br />- En grève, tout devient possible <br />- La grève, c'est maintenant <br />- Le courage de faire ... la grève</p> <h3 class="h3" id='Integrer-la-banniere-a-un-endroit-prescis-du-site'> Intégrer la bannière à un endroit prescis du site <a class='sommaire-back sommaire-back-4' href='#s-Integrer-la-banniere-a-un-endroit-prescis-du-site' title='Back to the table of contents'></a></h3> <p>La bannière est directement intégré mais ce n'est pas une fatalité, on peut désactiver l'intégration automatique à partir de l'ecran de configuration du plugin et ensuite intégrer la bannière dans le squelettes</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>[(#MODELE{'banniere_greve'})]</code></pre></div> <p>Ou au milieu du texte d'un article :</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code><banniere_greve0></code></pre></div><h2 class="h2" id='Clin-d-oeil'>Clin d'oeil <a class='sommaire-back sommaire-back-4' href='#s-Clin-d-oeil' title='Back to the table of contents'></a></h2> <p>Merci à Tetue pour l'inspiration trouvée dans son article de 2019 : <a href="http://romy.tetue.net/comment-faire-greve" class="spip_out" rel="external">“Comment faire grève ?”</a>.</p> <p>Un autre plugin pour la grêve existe, il s'appelle <a href='https://contrib.spip.net/Mettre-son-site-en-greve' class="spip_in" hreflang="fr">Greves</a> et a été développé par Maïeul, il ajoute un objet éditorial greve; ce qui permet de lister les grèves passées et à venir. Ce plugin n'est plus à jour au moment ou ces lignes sont écrites.</p></div> <hr /> <div class='rss_notes'><div id="nb33-1"> <p><span class="spip_note_ref">[<a href="#nh33-1" class="spip_note" title="Footnotes 33-1" rev="appendix">1</a>] </span>Icone de clé-outil dans le panneau de “Gestion des plugins”..</p> </div></div> <div class='rss_ps'><p>Ce plugin a été développé suite à l'annonce d'Elisabeth Borne le 10 janvier 2023 concernant la énième réforme des retraites visant toujours à réduire la durée de retraite en bonne santé. On ne vit pas pour travailler.</p></div> </article> <article> <h1>Bannières 2</h1> <p>erational, Jeannot — 2009-11-16T14:50:30Z</p> <div class='rss_chapo'><p>Gérer des campagnes d'information composées d'images ou animations.</p></div> <div class='rss_chapo'><p>Ce plugin permet d'afficher et de gérer des campagnes d'information composées d'images ou animations. La balise <code class='spip_code spip_code_inline' dir='ltr'>#BANNIERE</code> permet de positionner facilement cet objet dans vos squelettes. Plusieurs objets peuvent être placés sur la page et gérés en fonction de leur position (ex.: <code class='spip_code spip_code_inline' dir='ltr'>#BANNIERE{1}</code>). Si vous lui faites passer des informations de localisation, vous pourrez choisir l'objet à afficher en conséquence. Un lien est placé sur les images et le clic est comptabilisé. Enfin, la campagne s'affiche pendant la période que vous définissez dans l'espace privé.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-9" id="nav6a60d14a455bd5.06929129"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Remerciements"></a><a href="#Remerciements" class="spip_ancre">Remerciements</a></li><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Mise-a-jour-a-partir-du-plugin-bannieres_2-0-de-FdM"></a><a href="#Mise-a-jour-a-partir-du-plugin-bannieres_2-0-de-FdM" class="spip_ancre">Mise à jour à partir du plugin bannieres_2.0 de FdM :</a></li><li> <a id="s-Support-des-campagnes-google-analytics"></a><a href="#Support-des-campagnes-google-analytics" class="spip_ancre">Support des campagnes google analytics</a></li><li> <a id="s-Utilisation-Webmaster-la-balise-BANNIERE"></a><a href="#Utilisation-Webmaster-la-balise-BANNIERE" class="spip_ancre">Utilisation Webmaster: la balise #BANNIERE</a></li><li> <a id="s-Utilisation-Redacteur-le-modele"></a><a href="#Utilisation-Redacteur-le-modele" class="spip_ancre">Utilisation Rédacteur: le modèle <banniere></a></li><li> <a id="s-Administration"></a><a href="#Administration" class="spip_ancre">Administration</a></li><li> <a id="s-Gestion-du-Flash"></a><a href="#Gestion-du-Flash" class="spip_ancre">Gestion du Flash</a></li><li> <a id="s-Evolutions"></a><a href="#Evolutions" class="spip_ancre">Evolutions...</a></li></ul></div><h2 class="h2" id='Remerciements'>Remerciements<a class='sommaire-back sommaire-back-9' href='#s-Remerciements' title='Back to the table of contents'></a></h2> <p>Ce plugin est une réécriture du <a href='https://contrib.spip.net/Plugin-Bannieres' class="spip_in" hreflang="fr">plugin bannières</a> de François de Montlivault et basé sur le <a href="http://marcimat.magraine.net/Creer-un-nouvel-objet-editorial" class="spip_out" rel="external">plugin exemple</a> de Matthieu Marcillaud.</p> <h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-9' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Comme tous les plugins SPIP. Le mieux est de se référer à la <a href="https://www.spip.net/fr_article3396.html" class="spip_out" rel="external">documentation officielle</a>.</p> <p>Les dépendances : <a href='https://contrib.spip.net/SPIP-Bonux' class="spip_in" hreflang="fr">plugin bonux</a>, <a href="https://plugins.spip.net/saisies.html" class="spip_out" rel="external">plugin saisies</a>, disponibles sur la zone. <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/geographie" class="spip_out" rel="external">Le plugin géographie</a> est nécessaire si on veut placer des bannières “geolocalisées”. Il n'est plus obligatoire depuis la révision 33692.</p> <p>2 tables sont ajoutées dans la base : spip_bannieres et spip_bannieres_suivi. Le plugin utilise la gestion des documents de spip en y ajoutant un nouvel objets (banniere).</p> <h2 class="h2" id='Mise-a-jour-a-partir-du-plugin-bannieres_2-0-de-FdM'>Mise à jour à partir du plugin bannieres_2.0 de FdM :<a class='sommaire-back sommaire-back-9' href='#s-Mise-a-jour-a-partir-du-plugin-bannieres_2-0-de-FdM' title='Back to the table of contents'></a></h2> <p>Ce plugin met à jour la table spip_bannières et ajoute la nouvelle spip_bannieres_suivi. Les bannières qui se trouvent dans le dossier IMG anciennement nommées ban_xx.ext sont renommées en banniereonxx.ext, permettant ainsi un fonctionnement immédiat du plugin.</p> <p>Les nouvelles bannières utiliseront le système de chargement de documents de spip. Vous pourrez alors supprimer vos bannières situées directement à la racine du dossier IMG (par FTP). Les nouvelles seront stockées dans les sous dossiers en fonction de leur extension (voir système de documents de spip). L'ancien champ alt et ext ne sont plus utiles. Si le champ alt (texte alternatif) contient quelque chose, vous pourrez le supprimer. Une fois vidé, ce champ n'apparaitra plus, vous devrez alors utiliser le champ “titre” associé au document.</p> <h2 class="h2" id='Support-des-campagnes-google-analytics'>Support des campagnes google analytics<a class='sommaire-back sommaire-back-9' href='#s-Support-des-campagnes-google-analytics' title='Back to the table of contents'></a></h2> <p>Depuis la version 0.29, il est possible d'activer un mode expérimental qui ajoute aux URLs destinations, les paramètres de suivi de <a href="http://support.google.com/analytics/bin/answer.py?hl=fr&answer=1033863" class="spip_out" rel="external">campagnes personnalisées de google analytics</a></p> <p>Pour activer ce mode, ajouter dans votre fichier <strong>config/mes_options.php</strong></p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>define('_BANNIERE_TRACKING_GOOGLE', true);</code></pre></div> <p>Les URLs seront du type:</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>http://www.site.tld/?utm_medium=banner&utm_source=dragon%20rouge&utm_campaign=hiver2012</code></pre></div> <p>Avec:</p> <ul class="spip" role="list"><li> <i>utm_medium</i>: pour l'instant toujours banner</li><li> <i>utm_source</i>: le nom de votre site Spip</li><li> <i>utm_campaign</i>: le nom de votre campagne</li></ul><h2 class="h2" id='Utilisation-Webmaster-la-balise-BANNIERE'>Utilisation Webmaster: la balise #BANNIERE<a class='sommaire-back sommaire-back-9' href='#s-Utilisation-Webmaster-la-balise-BANNIERE' title='Back to the table of contents'></a></h2> <p>Il suffit simplement de placer la balise <code class='spip_code spip_code_inline' dir='ltr'>#BANNIERE</code> à l'endroit souhaité dans le squelette. Si vous voulez afficher plusieurs balises différentes dans la page, vous devrez passer l'info dans les paramètres: <code class='spip_code spip_code_inline' dir='ltr'>#BANNIERE{position}</code>, position étant un numéro de 1 à 9 et géré dans l'espace privé.</p> <p>Vous pouvez aussi passer un paramètre de localisation de la façon suivante : <code class='spip_code spip_code_inline' dir='ltr'>#BANNIERE{position, code_postal, numero_pays}</code>. Ce fonctionnement est basé sur le plugin géographie qui contient les codes postaux, les départements et régions de France, ainsi qu'une liste de pays. numero_pays doit correspondre au numéro du pays de la table spip_geo_pays.</p> <p>Une noisette avec un cache de 0 est fournie dans le plugin. Cela peut-être utile pour les campagnes de courtes durée ou pour l'affichage aléatoire. Pour l'utiliser il faut remplacer la balise par <code class='spip_code spip_code_inline' dir='ltr'><INCLURE {fond=inc_banniere}{position=valeur}{code_postal=valeur}{numero_pays=valeur}></code>.</p> <h2 class="h2" id='Utilisation-Redacteur-le-modele'>Utilisation Rédacteur: le modèle <banniere><a class='sommaire-back sommaire-back-9' href='#s-Utilisation-Redacteur-le-modele' title='Back to the table of contents'></a></h2> <p>Depuis la version 0.26, il est possible d'intégrer la bannière dans le texte d'un article en utilisant le modèle <code class='spip_code spip_code_inline' dir='ltr'><banniereXX></code> où XX est le numéro de position de 1 à 9.</p> <h2 class="h2" id='Administration'>Administration<a class='sommaire-back sommaire-back-9' href='#s-Administration' title='Back to the table of contents'></a></h2> <p>Vous pouvez gérer vos campagnes (ou bannières) depuis l'espace privé. Une liste des campagnes est visible. Vous pouvez trier les colonnes pour faciliter vos recherches. Cette liste vous informe si une campagne est active ou pas et si l'image ou document est présent (c'est l'objet principal :) !).</p> <p>Pour créer une nouvelle campagne, et si le plugin géographie est présent, il faut choisir son type de diffusion: internationale (pour un affichage par défaut, c'est cette option qu'il faut choisir), nationale, régionale, départementale ou locale.</p> <p>La recherche se fera bien sûr en partant du local. Si plusieurs campagnes sont configurées avec la même diffusion, un choix aléatoire sera fait par le système.</p> <p>Les clics sur les bannières de type image sont comptabilisées.</p> <h2 class="h2" id='Gestion-du-Flash'>Gestion du Flash<a class='sommaire-back sommaire-back-9' href='#s-Gestion-du-Flash' title='Back to the table of contents'></a></h2> <p>Pour les campagnes Flash, en général le lien est défini dans le fichier swf, <br class='autobr' /> par défaut le plugin ne comptera pas les clics de votre campagne sur ce fichier.</p> <p>Si vous souhaitez utiliser le compteur de clic et les données des campagnes, il faut programmer votre fichier flash de la façon suivante<br class='autobr' /> Le plugin insère votre flash en transmettant les données de la campagne via le paramètre FlashVars</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code> <param name='movie' value='IMG/swf/pub.swf' /> <param name='quality' value='high' /> <param name='menu' value='false' /> <param name='wmode' value='transparent' /> <param name='FlashVars' value='url_site=http%3A%2F%2F127.0.0.1&action=visit_url&banniere=5&url=http%3A%2F%2Fwww.wikivin.org' /> </object></code></pre></div> <p>FlashVars transmet les variables: url_site, action, banniere, url que vous pouvez ensuite exploiter dans votre flash</p> <p>Par exemple en actionscript 3, voici le code d'un bouton qui utilise les variables précédentes</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>but_callback.addEventListener(MouseEvent.CLICK,actionButCallback); function actionButCallback(evt:MouseEvent){ var paramObj:Object = LoaderInfo(this.root.loaderInfo).parameters; var url_site = paramObj["url_site"]; var action = paramObj["action"]; var url = paramObj["url"]; var banniere = paramObj["banniere"]; debug.text = "url:" + url; var urlRequest=new URLRequest(url_site+"/spip.php?action="+action+"&banniere="+banniere+"&url="+url); navigateToURL(urlRequest,"_self"); }</code></pre></div> <p>Voici un exemple de bannière flash (avec son code source) mettant en oeuvre les deux types de boutons: <a href="http://www.erational.org/IMG/zip/banniere_flash.zip" class="spip_out" rel="external">télécharger un exemple de bannière flash</a></p> <h2 class="h2" id='Evolutions'>Evolutions...<a class='sommaire-back sommaire-back-9' href='#s-Evolutions' title='Back to the table of contents'></a></h2> <p>Quelques améliorations possibles à étudier ou à faire...</p> <ul class="spip" role="list"><li> Utilisation de CFG pour : <ul class="spip" role="list"><li> <del>Utiliser ou pas les bannières localisées (dépendance plugin géographie)</del></li><li> Configurer l'utilisation ou pas du suivi des clics (table ou fichier log ou rien)</li></ul></li><li> <del>Utiliser les modèles de spip</del></li><li> Utiliser le filtre image_reduire</li><li> Suivi des clics sur les objets multimedia</li><li> <del>Statistiques de clics ou export des données</del></li><li> <del>Revoir les icones et le logo</del></li></ul></div> </article> <article> <h1>Base CSS 1 Pétronille</h1> <p>tetue — 2010-11-15T08:12:00Z</p> <div class='rss_chapo'><p>Début de framework CSS pour SPIP : Pétronille fournit une base de travail pour l'intégration, sous la forme d'un jeu de feuilles de style dynamiques et paramétrables, proposant les pré-réglages fondamentaux.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-9" id="nav6a60d14a486261.18497546"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Preambule"></a><a href="#Preambule" class="spip_ancre">Préambule</a></li><li> <a id="s-Comment-utiliser-Petronille"></a><a href="#Comment-utiliser-Petronille" class="spip_ancre">Comment utiliser Pétronille ?</a></li><li> <a id="s-Nomenclature-et-ordre-d-appel-des-fichiers"></a><a href="#Nomenclature-et-ordre-d-appel-des-fichiers" class="spip_ancre">Nomenclature et ordre d'appel des fichiers</a></li><li> <a id="s-Previsualisation"></a><a href="#Previsualisation" class="spip_ancre">Prévisualisation : <code class='spip_code spip_code_inline' dir='ltr'>?page=demo/typo</code></a></li><li> <a id="s-Pre-reglages-de-Petronille"></a><a href="#Pre-reglages-de-Petronille" class="spip_ancre">Pré-réglages de Pétronille</a></li><li> <a id="s-Classes-predefinies"></a><a href="#Classes-predefinies" class="spip_ancre">Classes prédéfinies</a></li><li> <a id="s-Personnalisations-possibles"></a><a href="#Personnalisations-possibles" class="spip_ancre">Personnalisations possibles</a></li><li> <a id="s-In-compatibilites-particulieres"></a><a href="#In-compatibilites-particulieres" class="spip_ancre">(In-)compatibilités particulières</a></li><li> <a id="s-Prochaines-evolutions"></a><a href="#Prochaines-evolutions" class="spip_ancre">Prochaines évolutions</a></li></ul></div><h2 class="h2" id='Preambule'>Préambule<a class='sommaire-back sommaire-back-9' href='#s-Preambule' title='Back to the table of contents'></a></h2> <p>Pétronille n'est pas un clicodrome sympa qui looke un site sans avoir besoin de coder, au contraire : c'est une <strong>base de travail</strong> pour l'intégration (<a href="https://en.wikipedia.org/wiki/framework" class="spip_glossaire" rel="external">framework</a>).</p> <p>Pétronille n'est pas compliquée, mais réclame quand même, comme n'importe quel frameworks CSS, un bon niveau en CSS, notamment une maîtrise de la cascade (ce qui est assez facile avec un outil comme Firebug).</p> <p>Ceci n'est qu'une première version, qui permet de découvrir Pétronille, malgré quelques défauts, pour l'instant non résolus : fichiers de demo pas parfaitement fiables et fichiers CSS trop gourmands en ressources serveur.</p> <p>Pétronille est conçue pour fonctionner avec tout type de site SPIP. Il est cependant déconseillé de l'activer sur un site déjà stylé : cela sera soit sans effet, soit contrariant. Pétronille vous mâche le travail : elle est donc pleinement utile employée en début de projet. Si elle vous embête, désactivez-la et recopiez seulement les bouts de code qui vous sont utiles dans votre propre feuille de style. Vous y reviendrez peut-être plus tard. Ou pas.</p> <h2 class="h2" id='Comment-utiliser-Petronille'>Comment utiliser Pétronille ?<a class='sommaire-back sommaire-back-9' href='#s-Comment-utiliser-Petronille' title='Back to the table of contents'></a></h2><ol class="spip" role="list"><li> Pétronille s'installe comme n'importe quel plugin SPIP</li><li> Activer Pétronille, qui insère automatiquement ses 5 feuilles de style</li><li> Paramétrer Pétronille (facultatif) directement depuis l'espace privé</li><li> Ajouter ensuite vos propres styles, en déposant vos feuilles CSS dans votre dossier « <code class='spip_code spip_code_inline' dir='ltr'>squelettes/css</code> »</li><li> Pour finir, n'oubliez pas d'activer, dans SPIP, la compression des fichiers CSS.</li></ol><h2 class="h2" id='Nomenclature-et-ordre-d-appel-des-fichiers'>Nomenclature et ordre d'appel des fichiers<a class='sommaire-back sommaire-back-9' href='#s-Nomenclature-et-ordre-d-appel-des-fichiers' title='Back to the table of contents'></a></h2> <p>Aussitôt activée, Pétronille insère les fichiers présents qui portent ces noms (d'après la nomenclature de la <a href="http://romy.tetue.net/methode-daisy" class="spip_out" rel="external">méthode Daisy</a>), <strong>en première position</strong> (avant <code class='spip_code spip_code_inline' dir='ltr'>#INSERT_HEAD</code> et <code class='spip_code spip_code_inline' dir='ltr'>#INSERT_HEAD_CSS</code>) et <strong>dans l'ordre suivant</strong> :</p> <ol class="spip" role="list"><li> <strong><code class='spip_code spip_code_inline' dir='ltr'>reset.css</code></strong> : correction des styles par défaut (mise à zéro multinavigateurs)</li><li> <strong><code class='spip_code spip_code_inline' dir='ltr'>?page=typo.css</code></strong> : base typographique, y compris raccourcis SPIP natifs</li><li> <strong><code class='spip_code spip_code_inline' dir='ltr'>form.css</code></strong> : base pour les formulaires (remplace l'historique <code class='spip_code spip_code_inline' dir='ltr'>spip_formulaires.css</code>, très succinctement)</li><li> <strong><code class='spip_code spip_code_inline' dir='ltr'>spip.css</code></strong> : styles associés au code généré par SPIP (remplace l'historique <code class='spip_code spip_code_inline' dir='ltr'>spip_style.css</code>)</li><li> <strong><code class='spip_code spip_code_inline' dir='ltr'>?page=base.css</code></strong> : quelques classes facilitant la composition</li><li> <code class='spip_code spip_code_inline' dir='ltr'>grid.css</code></li><li> <code class='spip_code spip_code_inline' dir='ltr'>layout.css</code></li></ol> <p>Les feuilles <code class='spip_code spip_code_inline' dir='ltr'>reset.css</code>, <code class='spip_code spip_code_inline' dir='ltr'>form.css</code> et <code class='spip_code spip_code_inline' dir='ltr'>spip.css</code> sont insérées par Pétronille. Vous pouvez les remplacer, en plaçant un fichier du même nom dans votre répertoire <code class='spip_code spip_code_inline' dir='ltr'>squelettes/css</code>.</p> <p>Les feuilles <code class='spip_code spip_code_inline' dir='ltr'>?page=typo.css</code> et <code class='spip_code spip_code_inline' dir='ltr'>?page=base.css</code> sont fabriquées puis insérées par Pétronille. Ce sont des « feuilles de styles calculées », paramétrables depuis l'espace privé. Il est techniquement possible, bien que déconseillé, de les remplacer : en plaçant un squelette nommé respectivement <code class='spip_code spip_code_inline' dir='ltr'>typo.css.html</code> ou <code class='spip_code spip_code_inline' dir='ltr'>base.css.html</code> à la racine de votre répertoire <code class='spip_code spip_code_inline' dir='ltr'>squelettes</code>.</p> <p>Les autres feuilles ne sont insérées que si elles existent, c'est-à-dire si vous placez des fichiers du même nom dans votre répertoire <code class='spip_code spip_code_inline' dir='ltr'>squelettes/css</code>.</p> <p>Vous compléterez en ajoutant vos propres styles dans les feuilles nommées librement, selon vos habitudes : <code class='spip_code spip_code_inline' dir='ltr'>screen.css</code> et <code class='spip_code spip_code_inline' dir='ltr'>print.css</code>, <code class='spip_code spip_code_inline' dir='ltr'>perso.css</code>, <code class='spip_code spip_code_inline' dir='ltr'>habillage.css</code> ou tout simplement <code class='spip_code spip_code_inline' dir='ltr'>style.css</code>.</p> <h2 class="h2" id='Previsualisation'>Prévisualisation : <code class='spip_code spip_code_inline' dir='ltr'>?page=demo/typo</code><a class='sommaire-back sommaire-back-9' href='#s-Previsualisation' title='Back to the table of contents'></a></h2> <p>Pour vous aider à styler votre site, Pétronille met un fichier de demo à disposition, pour voir ce que vous faites. Affichez la page de test <code class='spip_code spip_code_inline' dir='ltr'>?page=demo/typo</code> ou mieux, insérez le modèle <code class='spip_code spip_code_inline' dir='ltr'><charte|typo></code> dans un de vos articles, afin de voir cette charte typo en contexte.</p> <p>Attention : cette page de test n'est pas dynamique. Elle affiche, de façon statique, des extraits de code généré par SPIP : cela n'est pas un échantillonnage représentatif des raccourcis SPIP de votre configuration ! Ce n'est qu'un exemple, pour vous inviter à créer votre propre <strong>charte typo</strong>, dynamique, avec des vrais raccourcis SPIP saisis dans les champs d'un article (<a href="http://romy.tetue.net/charte-typo" class="spip_out" rel="external">voir cet exemple</a>). Notez qu'une telle charte typo est incluse dans cette <a href='https://contrib.spip.net/Base-de-demarrage-rubrique' class="spip_in" hreflang="fr">base de démarrage</a>.</p> <p><ins>Attention : pour voir ce que fait Pétronille, <strong>désactivez toute autre feuille de styles</strong>, même <code class='spip_code spip_code_inline' dir='ltr'>habillage.css</code> de la <acronym title="distribution">dist</acronym>. Puis ré-activez-les une à une, pour voir lesquelles vous sont encore utiles. Dans tous les cas, n'utilisez pas <code class='spip_code spip_code_inline' dir='ltr'>spip_style.css</code> !</ins></p> <h2 class="h2" id='Pre-reglages-de-Petronille'>Pré-réglages de Pétronille<a class='sommaire-back sommaire-back-9' href='#s-Pre-reglages-de-Petronille' title='Back to the table of contents'></a></h2> <p>Cette première version de Pétronille est configurable depuis l'espace privé (si l'un des plugins de config, CFG ou Bonux, est installé). Il est possible de régler quelques valeurs fondamentales, qui concernent essentiellement la typo, comme la famille de polices et la taille par défaut des textes, l'interlignage, les couleurs de texte et de fond, etc.</p> <div class='spip_document_8823 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="29" data-legende-lenx="" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-8823 '><strong>Configuration de Pétronille </strong></div> </figcaption></figure> </div> <p>Cette configuration est facultative : les valeurs par défaut de Pétronille permettent de commencer immédiatement. Vous pouvez donc travailler directement dans votre propre feuille de style et surcharger au cas par cas les valeurs qui ne sont pas satisfaisantes.</p> <p>Il n'est pas possible de récupérer ces variables pour les ré-utiliser dans vos feuilles de styles — sauf à faire des feuilles de style calculées, ce qui n'est pas recommandé. Ces valeurs ne sont pas enregistrées en base : il faudra refaire la config à chaque migration.</p> <p><strong>Ne prenez pas trop l'habitude de ce panneau de config</strong>, qui peut être amené à disparaître dans une prochaine version : il n'est sensé servir qu'en phase de développement, où il facilite les essais, pour affiner les choix, ce qui est très appréciable. Il ne devrait pas servir ensuite et il n'est pas conseillé d'en modifier les valeurs ultérieurement : ce serait soit sans effet, soit contrariant.</p> <h2 class="h2" id='Classes-predefinies'>Classes prédéfinies<a class='sommaire-back sommaire-back-9' href='#s-Classes-predefinies' title='Back to the table of contents'></a></h2> <p>Pour faciliter la mise en page en évitant de recoder les mêmes choses à chaque nouveau site, comme tout bon framework CSS, Pétronille met à disposition quelques classes prédéfinies, très modestes : <code class='spip_code spip_code_inline' dir='ltr'>.small</code>, <code class='spip_code spip_code_inline' dir='ltr'>.p</code>, <code class='spip_code spip_code_inline' dir='ltr'>.box</code>, <code class='spip_code spip_code_inline' dir='ltr'>.first</code>, <code class='spip_code spip_code_inline' dir='ltr'>.last</code>, <code class='spip_code spip_code_inline' dir='ltr'>.center</code>, <code class='spip_code spip_code_inline' dir='ltr'>.none</code>, <code class='spip_code spip_code_inline' dir='ltr'>.clear</code> et <code class='spip_code spip_code_inline' dir='ltr'>.clearfix</code>). Pour en savoir plus, consultez l'article dédié : « <a href='https://contrib.spip.net/Styles-disponibles-avec-la-base-CSS-Petronille' class="spip_in" hreflang="fr">Styles disponibles avec cette base CSS</a> ».</p> <p>Celles-ci viennent compléter les classes générées par SPIP, que Pétronille n'oublie pas de pré-styler, comme : <code class='spip_code spip_code_inline' dir='ltr'>.spip_logos</code>, <code class='spip_code spip_code_inline' dir='ltr'>.spip_documents</code>, <code class='spip_code spip_code_inline' dir='ltr'>ul.spip</code>, <code class='spip_code spip_code_inline' dir='ltr'>div.spip</code>, <code class='spip_code spip_code_inline' dir='ltr'>blockquote.spip</code>, etc. Voir l'article dédié : « <a href='https://contrib.spip.net/Styles-generes-par-SPIP' class="spip_in" hreflang="fr">Styles générés par SPIP</a> ».</p> <h2 class="h2" id='Personnalisations-possibles'>Personnalisations possibles<a class='sommaire-back sommaire-back-9' href='#s-Personnalisations-possibles' title='Back to the table of contents'></a></h2> <p>Les feuilles de style de Pétronille utilisent quelques images, assez moches, qu'il est facile de remplacer en déposant un fichier du même nom dans votre répertoire « <code class='spip_code spip_code_inline' dir='ltr'>squelettes/css/img</code> », sans oublier de recalculer les feuilles de style, (ou d'annuler via CSS) :</p> <ul class="spip" role="list"><li> <code class='spip_code spip_code_inline' dir='ltr'>puce-li.gif</code> met une puce aux listes (<code class='spip_code spip_code_inline' dir='ltr'>ul.spip</code>)</li><li> <code class='spip_code spip_code_inline' dir='ltr'>puce-dt.gif</code> met une puce aux items des listes de définition (<code class='spip_code spip_code_inline' dir='ltr'>dl.spip dt</code>)</li><li> <code class='spip_code spip_code_inline' dir='ltr'>quote.gif</code> affiche un guillemet aux citations (<code class='spip_code spip_code_inline' dir='ltr'>blockquote</code>)</li></ul><h2 class="h2" id='In-compatibilites-particulieres'>(In-)compatibilités particulières<a class='sommaire-back sommaire-back-9' href='#s-In-compatibilites-particulieres' title='Back to the table of contents'></a></h2> <p>Pour que les pages de demo fonctionnent avec les squelettes de type Z : déposer un fichier <code class='spip_code spip_code_inline' dir='ltr'>inc-head.html</code> à la racine de votre dossier « squelettes », contenant cette seule ligne : <code class='spip_code spip_code_inline' dir='ltr'><INCLURE{fond=inclure/head}></code>.</p> <p>Le résultat est sans garantie, mais il est techniquement possible d'utiliser Pétronille avec des thèmes graphiques prédéfinis (Z ou autre). Elle peut être avantageusement complétée par d'autres frameworks CSS, notamment pour les formulaires ou la grille de composition.</p> <p>Plugins recommandés, parce qu'ils facilitent l'utilisation de Pétronille : <a href='https://contrib.spip.net/Navigation-du-prive' class="spip_in" hreflang="fr">Bandeau</a> et <a href="http://romy.tetue.net/tetue_trousse" class="spip_out" rel="external">La trousse à têtue</a>. Plugin qui complète bien Pétronille : <a href='https://contrib.spip.net/varicelle' class="spip_in" hreflang="fr">Varicelle</a>.</p> <h2 class="h2" id='Prochaines-evolutions'>Prochaines évolutions<a class='sommaire-back sommaire-back-9' href='#s-Prochaines-evolutions' title='Back to the table of contents'></a></h2> <p>Cette version est explicitement numérotée comme étant la première car Pétronille est amenée à évoluer, pour deux raisons : les fichiers de démo et l'usage de feuilles de style calculées sont très insatisfaisants.</p> <p>Les « <dfn>feuilles de style calculées</dfn> » sont des squelettes SPIP qui génèrent des feuilles de style, de façon dynamique, ce qui permet le paramétrage de certaines valeurs. Mais notez bien qu'elles ont l'inconvénient majeur de générer des hits supplémentaires au risque de plomber la perfo côté serveur. Il faudra donc trouver comment remplacer cette technique.</p> <p>Le fichier de démo actuel non dynamique, n'est pas totalement fiable. Ce n'est qu'un gabarit HTML statique, alors qu'il faudrait afficher du texte saisi, avec ses raccourcis SPIP, dans les différents champs d'un article SPIP, de façon à tester le code réellement généré par SPIP. Mais comment partager ça ?</p> <p>Pétronille est un petit framework CSS, en devenir, qui s'enrichira au fil du temps.</p></div> <div class='rss_ps'><p>Pour en savoir plus : sur les <a href="http://css.developpez.com/tutoriels/framework-css/" class="spip_out" title="Frameworks CSS + Reset CSS : design from scratch" rel="external">frameworks CSS</a> ou sur la <a href="http://romy.tetue.net/methode-daisy" class="spip_out" title="Méthode Daisy : les CSS feuille à feuille" rel="external">méthode Daisy</a>.</p></div> </article> <article> <h1>Base CSS 2</h1> <p>tetue — 2011-05-30T07:12:00Z</p> <div class='rss_chapo'><p>Framework CSS dynamique et paramétrable : reset de Meyer, base typographique Blueprint optimisée pour SPIP, etc.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d14a4ca924.38890848"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Note-de-version"></a><a href="#Note-de-version" class="spip_ancre">Note de version</a></li><li> <a id="s-Mise-en-service"></a><a href="#Mise-en-service" class="spip_ancre">Mise en service</a></li><li> <a id="s-Demo-et-kit-d-integration"></a><a href="#Demo-et-kit-d-integration" class="spip_ancre">Démo et kit d'intégration</a></li><li> <a id="s-Comment-utiliser-une-grille-CSS-dans-SPIP"></a><a href="#Comment-utiliser-une-grille-CSS-dans-SPIP" class="spip_ancre">Comment utiliser une grille CSS dans SPIP ?</a></li></ul></div><p>Ce petit framework CSS pour SPIP 2 fournit une base de travail pour l'intégration, sous la forme d'un jeu de feuilles de style dynamiques et paramétrables, proposant les pré-réglages fondamentaux, notamment typographiques.</p> <h2 class="h2" id='Note-de-version'>Note de version<a class='sommaire-back sommaire-back-4' href='#s-Note-de-version' title='Back to the table of contents'></a></h2> <p>Dans la continuité de la précédente, cette seconde version propose :</p> <ul class="spip" role="list"><li> une <strong>base typographique</strong> complète et harmonieuse, encore plus proche de <a href="http://www.blueprintcss.org" class="spip_out" hreflang="en" rel="external">Blueprint</a>,</li><li> sans plus aucune image (plus de puce sur les listes, ni de guillemets sur les citations), ni autre fioriture,</li><li> avec un meilleur support d'<abbr title="Internet Explorer">IE</abbr>, sans hack,</li><li> prise en charge de l'impression (sans feuille dédiée),</li><li> et adopte le <a href="http://meyerweb.com/eric/tools/css/reset/" class="spip_out" hreflang="en" rel="external"><strong>reset 2</strong> d'Eric Meyer</a></li><li> et certaines bonnes pratiques du <a href="http://fr.html5boilerplate.com/" class="spip_out" rel="external"><strong>HTML5 Boilerplate</strong></a>.</li></ul> <p>Bref, que du bon !</p> <p>Attention : ce plugin distribue un framework CSS. Il n'y a pas lieu de le mettre à jour après l'avoir installé sur votre site ! La compatibilité avec <a href='https://contrib.spip.net/Petronille-1' class="spip_in" hreflang="fr">Pétronille 1</a> n'est pas garantie, en particulier au delà de la <a href="http://zone.spip.org/trac/spip-zone/browser/_plugins_/petronille?rev=45096" class="spip_out" rel="external">révision 45096</a>.</p> <h2 class="h2" id='Mise-en-service'>Mise en service<a class='sommaire-back sommaire-back-4' href='#s-Mise-en-service' title='Back to the table of contents'></a></h2><div class='spip_document_9516 spip_document spip_documents spip_document_file spip_documents_right spip_document_right spip_document_avec_legende' data-legende-len="39" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href="https://files.spip.net/spip-zone/basecss.zip" class=" spip_doc_lien" title='Zip - 39.8 KiB' type="application/zip"></a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-9516 '><strong>Base CSS (2.3.8) </strong></div> <div class='spip_doc_descriptif crayon document-descriptif-9516 '>Base CSS pour SPIP 2 </div> </figcaption></figure> </div><ol class="spip" role="list"><li> Ce plugin s'installe et s'active comme n'importe quel autre</li><li> Si vous partez de la dist de SPIP, pensez à désactiver toute autre feuille de style, en particulier <code class='spip_code spip_code_inline' dir='ltr'>spip_style.css</code>, sans quoi il risque d'être sans effet</li><li> Un panneau de config permet de régler la taille de typo, l'interlignage, la police, les couleurs, etc.</li><li> Videz les caches (SPIP et navigateur)</li><li> Prévisualisez à cette page <code class='spip_code spip_code_inline' dir='ltr'>?page=demo/typo</code></li><li> Construisez ensuite votre habillage sur cette base, dans votre propre feuille de style, style.css, comme d'habitude</li></ol><h2 class="h2" id='Demo-et-kit-d-integration'>Démo et kit d'intégration<a class='sommaire-back sommaire-back-4' href='#s-Demo-et-kit-d-integration' title='Back to the table of contents'></a></h2><div class='spip_document_9737 spip_document spip_documents spip_document_file spip_documents_right spip_document_right spip_document_avec_legende' data-legende-len="74" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/zip/basecss-demo.zip' class=" spip_doc_lien" title='Zip - 352.8 KiB' type="application/zip"></a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-9737 '><strong>Demo statique </strong></div> <div class='spip_doc_descriptif crayon document-descriptif-9737 '>Kit statique (HTML/CSS/JS) de démarrage pour l'intégrateur </div> </figcaption></figure> </div> <p>Une démo statique est disponible à part. C'est une extraction figée des feuilles de styles générées par ce plugin, avec des gabarits HTML exemplaires et commentés, utilisables hors SPIP. Elle peut donc servir de <strong>kit de démarrage pour l'intégrateur</strong>.<br class='manualbr' />Voir aussi la doc dédiée de cette rubrique : « <a href='https://contrib.spip.net/Arborescence-de-l-integration' class="spip_in" hreflang="fr">Arborescence de l'intégration</a> », « <a href='https://contrib.spip.net/Ordre-d-appel-des-feuilles-de-style' class="spip_in" hreflang="fr">Ordre d'appel des feuilles de style</a> », etc.</p> <p>Dans SPIP, prévisualisez en affichant les pages : <br />- <code class='spip_code spip_code_inline' dir='ltr'>?page=demo/typo</code> <br />- <code class='spip_code spip_code_inline' dir='ltr'>?page=demo/form</code></p> <p>Vous pouvez aussi installer la <a href='https://contrib.spip.net/Base-de-demarrage' class="spip_in" hreflang="fr">base de démarrage</a> (sur un SPIP vide), qui met quelques intéressantes pages de test à disposition, dont une « charte typo » qui présente un échantillon de chacun des enrichissements typographiques disponibles nativement dans SPIP (<a href="http://romy.tetue.net/11" class="spip_out" rel="external">voir exemple de charte typo</a>) et des alignements d'images (<a href="http://romy.tetue.net/15" class="spip_out" rel="external">voir exemple d'alignements d'images</a>).</p> <h2 class="h2" id='Comment-utiliser-une-grille-CSS-dans-SPIP'>Comment utiliser une grille CSS dans SPIP ?<a class='sommaire-back sommaire-back-4' href='#s-Comment-utiliser-une-grille-CSS-dans-SPIP' title='Back to the table of contents'></a></h2> <p>Pourquoi n'y a-t-il pas de grille dans ce framework ? Parce qu'il existe déjà bien des grilles CSS, parce que vous avez sans doute vos habitudes et que ce petit framework veut limiter les contraintes et vous laisser libres de choisir ce qui vous arrange.</p> <p>Vous pouvez compléter cette base avec un autre framework CSS et plus particulièrement par la grille de votre choix. Il suffit pour cela de déposez les feuilles de style voulues dans dossier « squelettes », en les renommant selon la <a href='https://contrib.spip.net/Ordre-d-appel-des-feuilles-de-style' class="spip_in" hreflang="fr">nomenclature Daisy</a> : grid.css, layout.css... Elles seront alors automatiquement appelées dans les squelettes.</p></div> </article> <article> <h1>Belles puces</h1> <p>tetue — 2010-01-16T11:58:00Z</p> <div class='rss_chapo'><p>De vraies listes à puces avec «<code class='spip_code spip_code_inline' dir='ltr'>-</code>», comme «<code class='spip_code spip_code_inline' dir='ltr'>-*</code>» !</p></div> <div class='rss_texte'><p>Très spontanément utilisé pour énumérer, le raccourci tiret « <code class='spip_code spip_code_inline' dir='ltr'>-</code> » produit une liste (<code class='spip_code spip_code_inline' dir='ltr'>ul/li</code>) avec ce plugin, conformément à ce qu'indique l'aide en ligne de SPIP, en non plus une puce graphique, ce qui corrige le <a href="http://core.spip.org/issues/1817" class="spip_out" rel="external">ticket #1817</a>.</p> <p>Aussitôt activé, ce plugin traite le raccourci SPIP « <code class='spip_code spip_code_inline' dir='ltr'>-</code> » comme « <code class='spip_code spip_code_inline' dir='ltr'>-*</code> » et génère donc de vraies listes (<code class='spip_code spip_code_inline' dir='ltr'><ul class="spip"> <li></code>) dans les deux cas.</p></div> <div class='rss_ps'><p><a href="http://zone.spip.org/trac/spip-zone/browser/_plugins_/bellespuces" class="spip_url spip_out auto" rel="nofollow external">http://zone.spip.org/trac/spip-zone/browser/_plugins_/bellespuces</a></p></div> </article> <article> <h1>Biblio Check</h1> <p>erational, Joseph — 2013-01-31T08:03:26Z</p> <div class='rss_chapo'><p>Ce plugin, à utiliser conjointement avec les plugins <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a> et <a href='https://contrib.spip.net/Tickets-suivi-de-bugs' class="spip_in" hreflang="fr">Tickets</a>, fournit une interface de vérification en ligne de références en ligne, où il est possible d'indiquer les corrections à effectuer et de proposer des références à ajouter.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-6" id="nav6a60d14a543410.57300025"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Introduction"></a><a href="#Introduction" class="spip_ancre">Introduction</a></li><li> <a id="s-Pre-requis-et-installation"></a><a href="#Pre-requis-et-installation" class="spip_ancre">Pré-requis et installation</a></li><li> <a id="s-Configuration-du-plugin"></a><a href="#Configuration-du-plugin" class="spip_ancre">Configuration du plugin</a></li><li> <a id="s-Mise-en-place-des-squelettes"></a><a href="#Mise-en-place-des-squelettes" class="spip_ancre">Mise en place des squelettes</a></li><li> <a id="s-Verification-des-references"></a><a href="#Verification-des-references" class="spip_ancre">Vérification des références</a></li><li> <a id="s-Gestion-des-tickets"></a><a href="#Gestion-des-tickets" class="spip_ancre">Gestion des tickets</a></li></ul></div><h2 class="h2" id='Introduction'>Introduction<a class='sommaire-back sommaire-back-6' href='#s-Introduction' title='Back to the table of contents'></a></h2> <p>Ce plugin est né de la reprise et du découpage du plugin <a href='https://contrib.spip.net/Bibliographie-AERES-1603' class="spip_in" hreflang="fr">Bibliographie AERES</a> en deux. Il en reprend en effet, et de manière plus générique, la fonctionnalité de vérification d'une liste de références bibiographiques.</p> <p>L'usage typique de ce plugin sera par exemple celui d'une unité de recherche devant gérer la liste des publications de ses membres. Le plugin pourrait aussi servir à la gestion de toute base bibliographique en ligne.</p> <p>Le plugin Biblio Check permet de :</p> <ul class="spip" role="list"><li> gérer les publications de l'unité de recherche via le logiciel Zotero afin de bénéficier des fonctionnalités d'import/export de ce dernier<span class="spip_note_ref"> [<a href="#nb34-1" class="spip_note" rel="appendix" title="Il est recommandé d'utiliser une librairie partagée dédiée à l'unité et dont (…)" id="nh34-1">1</a>]</span> ;</li><li> proposer une interface web aux membres de l'unité pour consulter leur publications déjà renseignées dans la base de données et d'indiquer les éventuelles corrections à effectuer ainsi que de saisir les références manquantes ;</li><li> gérer les demandes d'ajout/correction sous forme de tickets.</li></ul> <p>Dans la mesure où <i>Biblio Check</i> repose sur le plugin <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a>, le travail de vérification/complétion des références permet également d'alimenter le site web de l'unité en ajoutant par exemple les dernières publications de chaque chercheur sur leur page individuelle (voir la documentation de <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a> pour plus d'informations).</p> <h2 class="h2" id='Pre-requis-et-installation'>Pré-requis et installation<a class='sommaire-back sommaire-back-6' href='#s-Pre-requis-et-installation' title='Back to the table of contents'></a></h2> <p><strong>Dépendances :</strong></p> <ul class="spip" role="list"><li> SPIP 3.0<span class="spip_note_ref"> [<a href="#nb34-2" class="spip_note" rel="appendix" title="Sous SPIP 2.1, le plugin n'est disponible indépendamment mais est intégré (…)" id="nh34-2">2</a>]</span></li><li> les plugins <i>medias</i> et <i>forum</i> fournit en standard avec SPIP 3</li><li> plugin <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a></li><li> plugin <a href='https://contrib.spip.net/Tickets-suivi-de-bugs' class="spip_in" hreflang="fr">Tickets</a><span class="spip_note_ref"> [<a href="#nb34-3" class="spip_note" rel="appendix" title="NB en cas de mise à jour depuis la version 1 de Bibliographie AERES : cette (…)" id="nh34-3">3</a>]</span></li></ul> <p><strong>Recommandé :</strong></p> <ul class="spip" role="list"><li> <a href='https://contrib.spip.net/Le-Squelette-Zpip' class="spip_in" hreflang="fr">Zpip v1</a></li></ul><h2 class="h2" id='Configuration-du-plugin'>Configuration du plugin<a class='sommaire-back sommaire-back-6' href='#s-Configuration-du-plugin' title='Back to the table of contents'></a></h2> <p>Le formulaire de configuration de <i>Biblio Check</i> se situe sur la page de configuration de <i>ZotSpip</i>, accessible via le menu <i>Configuration > ZotSpip</i>.</p> <p>En premier lieu, vous devez configurer <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a> et synchroniser la librairie Zotero de l'unité. Vérifiez que la clé API utilisée pour ZotSpip dispose des droits en écriture.</p> <p>Puis vous pouvez préciser :</p> <ul class="spip" role="list"><li> un email de contact pour les visiteurs du site s'ils ont des questions sur le fonctionnement de l'outil ;</li><li> les personnes ayant le droit de poster des demandes de corrections et/ou d'ajout.</li></ul> <p>Pour permettre à vos utilisateurs de joindre un document à leurs ajouts/corrections de référence (par exemple, un export BibTeK EndNote ou Zotero), pensez à configurer le plugin tickets de manière adéquate. Nous vous recommandons les extensions de fichier suivantes : <i>txt, ris, bib, rdf, xml, doc, docx, odt, ppt, pptx, odp, pdf, html, jpg, png, gif</i>.</p> <p>Vous pouvez également modifier la configuration des forum pour autoriser l'ajout de documents aux commentaires.</p> <h2 class="h2" id='Mise-en-place-des-squelettes'>Mise en place des squelettes<a class='sommaire-back sommaire-back-6' href='#s-Mise-en-place-des-squelettes' title='Back to the table of contents'></a></h2> <p>La partie publique du plugin repose sur une seule page : <code class='spip_code spip_code_inline' dir='ltr'>bibliocheck</code>.</p> <p><strong>Si vous utilisez un squelette <a href='https://contrib.spip.net/Le-Squelette-Zpip' class="spip_in" hreflang="fr">Zpip</a> version 1</strong>, vous n'avez rien à faire, cette page est directement fonctionnelle.</p> <p><strong>Si vous utilisez un autre squelette</strong>, vous devez créer un fichier <code class='spip_code spip_code_inline' dir='ltr'>bibliocheck.html</code> à la racine de votre site, en fonction de la structure HTML de votre squelette, et y inclure les fichier <code class='spip_code spip_code_inline' dir='ltr'>contenu/page-bibliocheck.html</code> et <code class='spip_code spip_code_inline' dir='ltr'>navigation/page-bibliocheck.html</code> du plugin. Pensez également à ajouter dans le <code class='spip_code spip_code_inline' dir='ltr'><head>...</head></code> de la page la meta suivante : <code class='html spip_code spip_code_inline' dir='ltr'><meta name="robots" content="noindex, nofollow" /></code>.</p> <h2 class="h2" id='Verification-des-references'>Vérification des références<a class='sommaire-back sommaire-back-6' href='#s-Verification-des-references' title='Back to the table of contents'></a></h2> <p>Nous avons fait le choix d'un système simple : les pages permettant de vérifier les références et de proposer des corrections / ajouts sont directement accessibles à l'adresse <code class='spip_code spip_code_inline' dir='ltr'>http://mon.site.net/spip.php?page=bibliocheck</code>. Selon votre configuration, les personnes devront éventuellement s'identifier par login/mot de passe.</p> <p>Il n'y a pas de modification directe de la base bibliographique : chaque demande de correction ou d'ajout provoque la création d'un tickets, la correction ou l'ajout devant ensuite être effectué par une personne habilitée.</p> <p>La liste des références affichées peut etre triée de différentes manières et filtrée selon plusieurs critères, à partir du formulaure idoine.</p> <p>Pour chaque référence, une série de vérifications sont effectuées (le nombre de page est-il renseigné ? les auteurs du livre, pour un chapitre, sont-ils précisées ? etc.) et un message d'avertissement est affiché le cas échéant.</p> <p>Pour chaque référence, le détail des champs est visible en cliquant sur <i>Afficher/masquer les détails</i>.</p> <div class='spip_document_10725 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="36" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_saisie_modif.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10725 '><strong>Saisie d'une demande de correction</strong></div> </figcaption></figure> </div> <p>Un formulaire permet d'indiquer les corrections éventuelles à apporter à une référence. Il est possible de joindre un fichier<span class="spip_note_ref"> [<a href="#nb34-4" class="spip_note" rel="appendix" title="Si la configuration le permet." id="nh34-4">4</a>]</span> à la demande de correction et/ou de préciser un lien.</p> <div class='spip_document_10726 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="21" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_correction_demandee.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10726 '><strong>Correction demandée</strong></div> </figcaption></figure> </div> <p>Chaque demande de correction provoque la création d'un ticket. La demande reste visible sur la page de vérification tant que le ticket n'a pas été fermé ou résolu. Il est possible d'ajouter des commentaires aux demandes ouvertes.</p> <p>La demande d'ajout provoque la création d'un ticket et reste visible tant que ce dernier n'est pas fermé ou résolu. L'ensemble de la saisie est visible et il est possible d'ajouter des commentaires à la demande d'ajout.</p> <div class='spip_document_10733 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="34" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_ajout_demande_avec_fichier.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10733 '><strong>Ajout demandé avec fichier joint</strong></div> </figcaption></figure> </div> <p>Il est également possible de joindre un fichier, utile pour les auteurs utilisant un logiciel de gestion bibliographique : ils peuvent directement fournir un export de leur base personnelle.</p> <h2 class="h2" id='Gestion-des-tickets'>Gestion des tickets<a class='sommaire-back sommaire-back-6' href='#s-Gestion-des-tickets' title='Back to the table of contents'></a></h2> <p>Les demandes d'ajout ou de correction correspondent à des tickets, visibles dans l'espace privé via le menu <i>Publication > Tickets, suivi de bugs</i>. Les tickets créés à partir de Biblio Check se voient attribuer un type particulier : <i>Biblio</i>.</p> <p>L'interface du plugin <a href='https://contrib.spip.net/Tickets-suivi-de-bugs' class="spip_in" hreflang="fr">Tickets</a> a été légèrement modifiée pour afficher des informations additionnelles spécifiques à la référence concernée.</p> <p>Pour une demande de correction, la version actuellement en base est affichée avec ses détails. Pour corriger la référence, on peut :</p> <ul class="spip" role="list"><li> effectuer la correction dans le logiciel Zotero sur son ordinateur ;</li><li> ou bien cliquer sur le lien <i>Modifier en ligne sur zotero.org</i> qui emmène directement sur la page d'édition de cette référence sur le serveur Zotero (voir capture ci-dessous).</li></ul><div class='spip_document_10737 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="57" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_modifier_sur_zotero.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10737 '><strong>Modification d'une référence directement sur zotero.org</strong></div> </figcaption></figure> </div> <p>Une fois l'import effectué, l'affichage devient équivalent à celui d'une demande de modification avec un lien <i>Modifier en ligne</i>.</p> <p>Dans le cas d'une demande d'ajout avec fichier joint, vous devrez télécharger le fichier sur votre ordinateur puis l'importer dans Zotero (et le cas échéant le corriger).</p> <p>Une fois une correction/ajout effectué(e) ou refusé(e), pensez à clore le ticket.</p></div> <hr /> <div class='rss_notes'><div id="nb34-1"> <p><span class="spip_note_ref">[<a href="#nh34-1" class="spip_note" title="Footnotes 34-1" rev="appendix">1</a>] </span>Il est recommandé d'utiliser une librairie partagée dédiée à l'unité et dont seules les personnes habilitées aurait accès en écriture.</p> </div><div id="nb34-2"> <p><span class="spip_note_ref">[<a href="#nh34-2" class="spip_note" title="Footnotes 34-2" rev="appendix">2</a>] </span>Sous SPIP 2.1, le plugin n'est disponible indépendamment mais est intégré dans <a href='https://contrib.spip.net/Bibliographie-AERES-1-0' class="spip_in" hreflang="fr">Bibliographie AERES 1.0</a>.</p> </div><div id="nb34-3"> <p><span class="spip_note_ref">[<a href="#nh34-3" class="spip_note" title="Footnotes 34-3" rev="appendix">3</a>] </span>NB en cas de mise à jour depuis la version 1 de Bibliographie AERES : cette dernière utilisait <a href='https://contrib.spip.net/Tickets-Kiss' class="spip_in" hreflang="fr">Tickets KISS</a> tandis que BiblIo Check utilise <a href='https://contrib.spip.net/Tickets-suivi-de-bugs' class="spip_in" hreflang="fr">Tickets</a>. Bien qu'il ne s'agisse pas du même plugin, le passage de l'un à l'autre ne devrait pas être problématique, ces derniers partageant la même table SQL.</p> </div><div id="nb34-4"> <p><span class="spip_note_ref">[<a href="#nh34-4" class="spip_note" title="Footnotes 34-4" rev="appendix">4</a>] </span>Si la configuration le permet.</p> </div></div> </article> <article> <h1>Bibliographie AERES 1.0</h1> <p>Joseph — 2012-05-31T13:36:38Z</p> <div class='rss_chapo'><p>Ce plugin fournit une interface pour faciliter la réalisation d'une bibliographie au format <a href="http://www.aeres-evaluation.fr/" class="spip_out" rel="external">AERES</a>. Les auteurs peuvent indiquer en ligne des corrections à effectuer ou bien indiquer des références à ajouter.</p> <p>Cet article est une archive. <br class='autobr' /> <a href='https://contrib.spip.net/Bibliographie-HCERES-anciennement-AERES' class="spip_in" hreflang="fr">Consulter la documentation récente du plugin AERES</a></p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-12" id="nav6a60d14a5d4aa5.35678322"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Avertissement"></a><a href="#Avertissement" class="spip_ancre">Avertissement</a></li><li> <a id="s-Introduction"></a><a href="#Introduction" class="spip_ancre">Introduction</a></li><li> <a id="s-Pre-requis-et-installation"></a><a href="#Pre-requis-et-installation" class="spip_ancre">Pré-requis et installation</a></li><li> <a id="s-La-classification-AERES"></a><a href="#La-classification-AERES" class="spip_ancre">La classification AERES</a></li><li> <a id="s-Correspondances-Zotero-AERES-et-choix-effectues"></a><a href="#Correspondances-Zotero-AERES-et-choix-effectues" class="spip_ancre">Correspondances Zotero - AERES et choix effectués</a></li><li> <a id="s-Configuration-du-plugin"></a><a href="#Configuration-du-plugin" class="spip_ancre">Configuration du plugin</a></li><li> <a id="s-Mise-en-place-des-squelettes"></a><a href="#Mise-en-place-des-squelettes" class="spip_ancre">Mise en place des squelettes</a></li><li> <a id="s-Verification-des-references"></a><a href="#Verification-des-references" class="spip_ancre">Vérification des références</a></li><li> <a id="s-Gestion-des-tickets"></a><a href="#Gestion-des-tickets" class="spip_ancre">Gestion des tickets</a></li><li> <a id="s-Style-CSL"></a><a href="#Style-CSL" class="spip_ancre">Style CSL</a></li><li> <a id="s-Afficher-la-bibliographie-generale-de-l-unite"></a><a href="#Afficher-la-bibliographie-generale-de-l-unite" class="spip_ancre">Afficher la bibliographie générale de l'unité</a></li><li> <a id="s-Recommandations"></a><a href="#Recommandations" class="spip_ancre">Recommandations</a></li></ul></div><h2 class="h2" id='Avertissement'>Avertissement<a class='sommaire-back sommaire-back-12' href='#s-Avertissement' title='Back to the table of contents'></a></h2> <p>Ce plugin n'a ni pour objet ni pour effet de promouvoir l'AERES et ses méthodes, qui font l'objet d'un vif débat dans le monde de l'enseignement supérieur et de la recherche. Au contraire, en ayant recours à des outils libres et des standards ouverts, il vise à faciliter le travail administratif des unités de recherche soumises à la contrainte de générer une liste de publications selon une nomenclature qui leur est imposée.</p> <h2 class="h2" id='Introduction'>Introduction<a class='sommaire-back sommaire-back-12' href='#s-Introduction' title='Back to the table of contents'></a></h2> <p>Ce plugin est destiné aux unités de recherche française amenées à préparer la liste de leurs publications dans le cadre de leur évaluation quinquennale par l'<a href="http://www.aeres-evaluation.fr/" class="spip_out" rel="external">Agence d'Évaluation de la Recherche et de l'Enseignement Supérieur</a> (AERES).</p> <p>Le plugin <i>Bibliographie AERES</i> permet de :</p> <ul class="spip" role="list"><li> gérer les publications de l'unité via le logiciel Zotero afin de bénéficier des fonctionnalités d'import/export de ce dernier<span class="spip_note_ref"> [<a href="#nb35-1" class="spip_note" rel="appendix" title="Il est recommandé d'utiliser une librairie partagée dédiée à l'unité et dont (…)" id="nh35-1">1</a>]</span> ;</li><li> proposer une interface web aux membres de l'unité pour consulter leur publications déjà renseignées dans la base de données et d'indiquer les éventuelles corrections à effectuer ainsi que de saisir les références manquantes ;</li><li> gérer les demandes d'ajout/correction sous forme de tickets ;</li><li> produire une liste des publications selon la classification de l'AERES.</li></ul> <p>Dans la mesure où le plugin <i>Bibliographie AERES</i> repose sur le plugin <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a>, le travail effectué pour l'évaluation AERES permet également d'alimenter le site web de l'unité en ajoutant par exemple les dernières publications de chaque chercheur sur leur page individuelle (voir la documentation de <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a> pour plus d'informations).</p> <h2 class="h2" id='Pre-requis-et-installation'>Pré-requis et installation<a class='sommaire-back sommaire-back-12' href='#s-Pre-requis-et-installation' title='Back to the table of contents'></a></h2> <p><strong>Dépendances :</strong></p> <ul class="spip" role="list"><li> SPIP 2.1<span class="spip_note_ref"> [<a href="#nb35-2" class="spip_note" rel="appendix" title="Une version du plugin pour SPIP 3 sera développé ultérieurement." id="nh35-2">2</a>]</span></li><li> plugin <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a></li><li> plugin <a href='https://contrib.spip.net/Tickets-Kiss' class="spip_in" hreflang="fr">Tickets KISS</a></li><li> plugin <a href='https://contrib.spip.net/Mediatheque' class="spip_in" hreflang="fr">Mediathèque</a></li></ul> <p><strong>Recommandé :</strong></p> <ul class="spip" role="list"><li> <a href='https://contrib.spip.net/Le-Squelette-Zpip' class="spip_in" hreflang="fr">Zpip</a></li></ul><h2 class="h2" id='La-classification-AERES'>La classification AERES<a class='sommaire-back sommaire-back-12' href='#s-La-classification-AERES' title='Back to the table of contents'></a></h2> <p>Selon les <a href="http://www.aeres-evaluation.fr/content/download/17287/269282/file/S2-1-1-UR-ResultatsAutoEvaluation.pdf" class="spip_out" rel="external">consignes de l'AERES pour la rédaction de l'auto-évaluation de l'Unité</a>, les publications de l'unité devront être présentées selon la codification des publications et des productions suivantes :</p> <blockquote class="spip"> <p><strong>Annexe 1 : Codification des publications et des productions</strong></p> <p>L'ordre proposé ci-dessous n'est pas hiérarchique car la valeur des supports de publication varie selon les disciplines. Le directeur de l'unité de recherche renseignera donc les rubriques en sélectionnant celles qui sont pertinentes pour son champ disciplinaire.</p> <ul class="spip" role="list"><li> ACL : Articles dans des revues internationales ou nationales avec comité de lecture répertoriées par l'AERES ou dans les bases de données internationales (ISI Web of Knowledge, Pub Med…).</li><li> ACLN : Articles dans des revues avec comité de lecture non répertoriées par l'AERES ou dans des bases de données internationales.</li><li> ASCL : Articles dans des revues sans comité de lecture.</li><li> BRE : Brevets (indiquer les licences éventuelles).</li><li> C-INV : Conférences données à l'invitation du comité d'organisation dans un congrès national ou international.</li><li> C-ACTI : Communications avec actes dans un congrès international.</li><li> C-ACTN : Communications avec actes dans un congrès national.</li><li> C-COM : Communications orales sans actes dans un congrès international ou national.</li><li> C-AFF : Communications par affiche dans un congrès international ou national.</li><li> DO : Directions d'ouvrages ou de revues.</li><li> OR : Outils de recherche, corpus de recherche, cohortes.</li><li> OS : Ouvrages scientifiques (y compris les éditions critiques et les traductions scientifiques)<span class="spip_note_ref"> [<a href="#nb35-3" class="spip_note" rel="appendix" title="À l'intérieur de cette catégorie, il convient de distinguer dans des (…)" id="nh35-3">3</a>]</span>.</li><li> PV : Publications de vulgarisation<span class="spip_note_ref"> [<a href="#nb35-4" class="spip_note" rel="appendix" title="À l'intérieur de cette catégorie, il convient de distinguer dans des (…)" id="nh35-4">4</a>]</span>.</li><li> PAT : Productions artistiques théorisées (compositions musicales, cinématographiques, expositions, installations…).</li><li> PT : Publications de transfert<span class="spip_note_ref"> [<a href="#nb35-5" class="spip_note" rel="appendix" title="À l'intérieur de cette catégorie, il convient de distinguer dans des (…)" id="nh35-5">5</a>]</span>.</li><li> AP : Autres productions : bases de données, logiciels enregistrés, rapports de fouilles, guides techniques, catalogues d'exposition, rapports intermédiaires de grands projets internationaux, etc.</li></ul> <p>On précisera impérativement la pagination des articles et chapitres d'ouvrages.</p> </blockquote> <p>Il apparaît dès lors que :</p> <ul class="spip" role="list"><li> la classification AERES peut varier d'une unité à une autre ;</li><li> il n'y a pas de correspondance directe entre cette classification et les types de références utilisés par les logiciels de gestion bibliographique courant (Zotero, BibTeX, EndNote...) ;</li><li> certaines catégories demeurent floues, en particulier les publications de vulgarisation et les publications de transfert ;</li><li> certaines catégories ont des sous-catégories (ouvrages et chapitres d'ouvrages non différenciés dans la catégorie OS par exemple) ;</li><li> d'autres sont étonnamment détaillées (en particulier les communications avec actes).</li></ul><h2 class="h2" id='Correspondances-Zotero-AERES-et-choix-effectues'>Correspondances Zotero - AERES et choix effectués<a class='sommaire-back sommaire-back-12' href='#s-Correspondances-Zotero-AERES-et-choix-effectues' title='Back to the table of contents'></a></h2> <p>Un certains nombre de choix ont été effectués pour faire correspondre la typologie des références Zotero et la classification AERES, de même que la classification AERES utilisée dans ce plugin diffère légèrement de celle présentée ci-dessus. Certains choix ont été implémenté en tant qu'option configurable.</p> <p>Les options disponibles sont susceptibles d'évoluer en fonction des besoins exprimés par les unités de recherche voulant utiliser ce plugin.</p> <p>Afin de classer les références Zotero selon la classification AERES, nous avons donc opéré les choix suivants :</p> <ol class="spip" role="list"><li> Les catégories ACL et ACLN ont été fusionnées ensemble dans la mesure où il n'existe pas à l'heure actuelle un référentiel unique et facilement utilisable pour déterminer si une revue fait partie de la catégorie ACL ou ACLN. Dès lors, la distinction entre ACL et ACLN ne peut être effectuée aisément et selon une règle précise.</li><li> Les <i>articles de revue</i><span class="spip_note_ref"> [<a href="#nb35-6" class="spip_note" rel="appendix" title="Type de référence sous Zotero." id="nh35-6">6</a>]</span> sont classés en ACL (articles dans des revues scientifiques à comité de lecture) à l'exception des articles sans auteur mais comportant uniquement des éditeurs considérés comme des directions de revue (voir ci-après).</li><li> Les <i>articles de magazine</i> sont classés en ASCL (articles dans des revues sans comité de lecture).</li><li> Les <i>brevets</i> sont classés dans la catégorie BRE.</li><li> Les catégories C-INV, C-ACTI et C-ACTN ont été fusionnées en une seule catégorie C-ACT (communication avec publication dans des actes).</li><li> La catégorie OS a été divisée en deux catégories : OS (Ouvrages scientifiques) qui sera limité aux ouvrages complets et CH (Chapitres d'ouvrages).</li><li> Certaines unités présentent les publications avec actes dans la même catégorie que les chapitres d'ouvrage. Une option dans la configuration du plugin permet de préciser si les communications avec actes doivent être classées sous C-ACT ou si elles doivent être fusionnées avec les chapitres d'ouvrage (CH).</li><li> Les <i>articles de colloque</i> pour lesquels le champs <i>Titre des actes</i> est renseigné seront donc considérés comme des communications avec actes et classés sous C-ACT ou CH (en fonction de la configuration du plugin).</li><li> Les <i>articles de colloque</i> sans <i>Titre des actes</i> seront donc considérés soit comme des communications orales (C-COM) soit comme des communications affichées (C-AFF). Afin de pouvoir distinguer entre les deux, il est impératif de renseigner le champs <i>Éditeur</i><span class="spip_note_ref"> [<a href="#nb35-7" class="spip_note" rel="appendix" title="Ce dernier étant inutilisé s'il ne s'agit pas d'une communication avec actes." id="nh35-7">7</a>]</span> en y saisissant soit <code class='spip_code spip_code_inline' dir='ltr'>communication orale</code> soit <code class='spip_code spip_code_inline' dir='ltr'>poster</code> (en minuscules, le numéro de communication pouvant optionnellement être indiqué ensuite, exemple : <code class='spip_code spip_code_inline' dir='ltr'>poster n°123456</code>).</li><li> Les directions d'ouvrages ou de revues seront identifiés à partir du rôle des différents contributeurs. Il s'agira donc soit d'un <i>livre</i>, soit d'un <i>article de revue</i>, n'ayant aucun <i>auteur</i> mais ayant au moins un <i>éditeur</i><span class="spip_note_ref"> [<a href="#nb35-8" class="spip_note" rel="appendix" title="Il importe de ne pas confondre les éditeurs scientifiques au sens anglais (…)" id="nh35-8">8</a>]</span>.</li><li> Les <i>livres</i> comportant au moins un auteur seront classés sous OS (ouvrages scientifiques).</li><li> Les <i>chapitres de livre</i> seront classés sous CH.</li><li> Les <i>films</i>, <i>illustrations</i>, <i>enregistrements audio</i> et <i>enregistrements vidéo</i> seront classés sous PAT (Productions artistiques théorisées).</li><li> Deux catégories additionnelles ont été crées : TH pour les thèses de doctorat et HDR pour les habilitations à diriger des recherche.</li><li> Les <i>thèses</i> dont le champs <i>Type</i> commence par <code class='spip_code spip_code_inline' dir='ltr'>thèse</code> seront classées sous TH (on peut éventuellement préciser la thèse, par exemple <code class='spip_code spip_code_inline' dir='ltr'>thèse en sociologie</code>).</li><li> Les <i>thèses</i> dont le champs <i>Type</i> commence par <code class='spip_code spip_code_inline' dir='ltr'>habilitation à diriger des recherches</code> (en minuscles, attention aux accents et aux fautes de frappe) seront classées sous HDR.</li><li> Les autres <i>thèses</i> ne seront pas pris en compte.</li><li> Les <i>articles d'encyclopédie</i>, <i>articles de journal</i> (presse), <i>cartes</i>, <i>documents</i>, <i>entrées de dictionnaire</i>, <i>manuscrits</i>, <i>programmes informatiques</i>, <i>pages web</i> et les <i>rapports</i> seront classés dans AP (autres publications).</li><li> Les autres types de références Zotero ne sont pas pris en compte.</li></ol> <p><strong>Si votre unité de recherche nécessite d'autres catégories, veuillez contacter l'<a href='https://contrib.spip.net/Joseph' class="spip_in">auteur</a> (joseph point larmarange chez ird point fr).</strong></p> <h2 class="h2" id='Configuration-du-plugin'>Configuration du plugin<a class='sommaire-back sommaire-back-12' href='#s-Configuration-du-plugin' title='Back to the table of contents'></a></h2> <p>Le formulaire de configuration du plugin <i>Bibliographie AERES</i> se situe sur la page de configuration de <i>ZotSpip</i>, accessible via le menu <i>Configuration > ZotSpip</i>.</p> <p>En premier lieu, vous devez configurer <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a> et synchroniser la librairie Zotero de l'unité. Vérifiez que la clé API utilisée pour ZotSpip dispose des droits en écriture.</p> <p>Puis vous pouvez préciser :</p> <ul class="spip" role="list"><li> la période couverte par l'évaluation ;</li><li> le style CSL à utiliser (nous recommandons le style <i>Chicago adapted for AERES</i>, voir plus loin) ;</li><li> un email de contact pour les membres de votre unité, s'ils ont des questions sur le fonctionnement de l'outil ;</li><li> les types de documents acceptés pouvant être joint à une demande / correction ;</li><li> la liste des auteurs à prendre en compte pour la bibliographie générale de l'unité<span class="spip_note_ref"> [<a href="#nb35-9" class="spip_note" rel="appendix" title="Cette liste ne propose que les auteurs ayant au moins une publication dans (…)" id="nh35-9">9</a>]</span>.</li></ul><h2 class="h2" id='Mise-en-place-des-squelettes'>Mise en place des squelettes<a class='sommaire-back sommaire-back-12' href='#s-Mise-en-place-des-squelettes' title='Back to the table of contents'></a></h2> <p>La partie publique du plugin repose sur 4 pages :</p> <ul class="spip" role="list"><li> biblioaeres,</li><li> biblioaeres_verif,</li><li> biblioaeres_voir et</li><li> biblioaeres_unite.</li></ul> <p><strong>Si vous utilisez un squelette <a href='https://contrib.spip.net/Le-Squelette-Zpip' class="spip_in" hreflang="fr">Zpip</a></strong>, vous n'avez rien à faire, ces quatres pages sont directement fonctionnelles.</p> <p><strong>Si vous utilisez un autre squelette</strong>, vous devez créer ces quatre fichiers à la racine de votre site, en fonction de la structure HTML de votre squelette, et y inclure les fichiers homonymes situés dans le répertoire <code class='spip_code spip_code_inline' dir='ltr'>contenu</code> du plugin. Pensez également à ajouter dans le <code class='spip_code spip_code_inline' dir='ltr'><head>...</head></code> de la page la meta suivante : <code class='html spip_code spip_code_inline' dir='ltr'><meta name="robots" content="noindex, nofollow" /></code>.</p> <h2 class="h2" id='Verification-des-references'>Vérification des références<a class='sommaire-back sommaire-back-12' href='#s-Verification-des-references' title='Back to the table of contents'></a></h2> <p>Nous avons fait le choix d'un système simple : les pages permettant de vérifier les références et de proposer des corrections / ajouts sont directement accessibles à l'adresse <code class='spip_code spip_code_inline' dir='ltr'>http://mon.site.net/spip.php?page=biblioaeres</code> sans nécessité une identification de la part des membres de l'unité. Cependant, ces pages ne sont pas indexées dans les moteurs de recherche et il n'y a pas de modification directe de la base bibliographique : chaque demande de correction ou d'ajout provoque la création d'un tickets, la correction ou l'ajout devant ensuite être effectué par une personne habilitée.</p> <div class='spip_document_10721 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="34" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_page_biblioaeres.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10721 '><strong>Capture de la page ‘biblioaeres'</strong></div> </figcaption></figure> </div> <p>Une fois arrivé sur la page ‘biblioaeres', un membre de l'unité a simplement à sélectionner son nom puis à cliquer sur <i>Vérifier/Afficher</i>.</p> <p>La page de vérification présente la liste des publications de cet auteur selon la classification AERES. Pour chaque référence, une série de vérifications sont effectuées (le nombre de page est-il renseigné ? les auteurs du livre, pour un chapitre, sont-ils précisées ? etc.) et un message d'avertissement est affiché le cas échéant. Cette page liste également les communications et les thèses indéterminées, ainsi que les références sans année de publication.</p> <div class='spip_document_10727 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="40" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_communications_indeterminees.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10727 '><strong>Liste des communications indéterminées</strong></div> </figcaption></figure> </div> <p>Pour chaque référence, le détail des champs est visible en cliquant sur <i>Afficher/masquer les détails</i>.</p> <div class='spip_document_10725 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="36" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_saisie_modif.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10725 '><strong>Saisie d'une demande de correction</strong></div> </figcaption></figure> </div> <p>Un formulaire permet d'indiquer les corrections éventuelles à apporter à une référence. Il est possible de joindre un fichier à la demande de correction et/ou de préciser un lien.</p> <div class='spip_document_10726 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="21" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_correction_demandee.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10726 '><strong>Correction demandée</strong></div> </figcaption></figure> </div> <p>Chaque demande de correction provoque la création d'un ticket. La demande reste visible sur la page de vérification tant que le ticket n'a pas été fermé ou résolu. Il est possible d'ajouter des commentaires aux demandes ouvertes.</p> <p>En bas de page, un formulaire permet d'indiquer les références manquantes à ajouter.</p> <div class='spip_document_10731 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="33" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_saisie_nouvelle_ref.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10731 '><strong>Saisie d'une nouvelle référence</strong></div> </figcaption></figure> </div> <p>Il est possible d'indiquer simplement un DOI ou un ISBN (qui permettront un import automatique avec la baguette magique sous Zotero), le lien vers la page web correspondant à cette publication dans les grands catalogues internationaux ou bien de saisir directement les détails de cette référence. Le formulaire propose tous les champs disponibles sous Zotero<span class="spip_note_ref"> [<a href="#nb35-10" class="spip_note" rel="appendix" title="Le format de la base Zotero étant obtenu directement depuis l'API de Zotero, (…)" id="nh35-10">10</a>]</span>. Le formulaire s'adapte automatiquement en fonction du type de référence sélectionné.</p> <div class='spip_document_10732 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="15" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_ajout_demande.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10732 '><strong>Ajout demandé</strong></div> </figcaption></figure> </div> <p>La demande d'ajout provoque la création d'un ticket et reste visible tant que ce dernier n'est pas fermé ou résolu. L'ensemble de la saisie est visible et il est possible d'ajouter des commentaires à la demande d'ajout.</p> <div class='spip_document_10733 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="34" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_ajout_demande_avec_fichier.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10733 '><strong>Ajout demandé avec fichier joint</strong></div> </figcaption></figure> </div> <p>Il est également possible de joindre un fichier, utile pour les auteurs utilisant un logiciel de gestion bibliographique : ils peuvent directement fournir un export de leur base personnelle.</p> <h2 class="h2" id='Gestion-des-tickets'>Gestion des tickets<a class='sommaire-back sommaire-back-12' href='#s-Gestion-des-tickets' title='Back to the table of contents'></a></h2> <p>Les demandes d'ajout ou de correction correspondent à des tickets, visibles dans l'espace privé via le menu <i>Publication > Tickets, suivi de bugs</i>. L'interface du plugin <a href='https://contrib.spip.net/Tickets-Kiss' class="spip_in" hreflang="fr">Tickets KISS</a> a été légèrement modifiée pour afficher des informations additionnelles spécifiques à Bibliographie AERES. Ainsi, par exemple, le formulaire de synchronisation de ZotSpip ou encore le tableau de correspondances Zotero / AERES sont en permanence affichés sur les pages de gestion des tickets.</p> <div class='spip_document_10734 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="36" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_ticket_modification.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10734 '><strong>Ticket d'une demande de correction</strong></div> </figcaption></figure> </div> <p>Pour une demande de correction, la version actuellement en base est affichée avec ses détails. Pour corriger la référence, on peut :</p> <ul class="spip" role="list"><li> effectuer la correction dans le logiciel Zotero sur son ordinateur ;</li><li> ou bien cliquer sur le lien <i>Modifier en ligne sur zotero.org</i> qui emmène directement sur la page d'édition de cette référence sur le serveur Zotero (voir capture ci-dessous).</li></ul><div class='spip_document_10737 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="57" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_modifier_sur_zotero.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10737 '><strong>Modification d'une référence directement sur zotero.org</strong></div> </figcaption></figure> </div> <p>En cas de demande d'ajout avec saisie complète de la référence, le ticket présente l'ensemble des champs saisis par l'utilisateur.</p> <div class='spip_document_10735 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="50" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_ticket_ajout_avec_saisie_complete.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10735 '><strong>Ticket d'ajout de référence avec saisie complète</strong></div> </figcaption></figure> </div> <p>Le bouton <i>Importer dans Zotéro</i> provoque un import automatique de la saisie dans la base Zotero. Une fois l'import effectué, l'affichage devient équivalent à celui d'une demande de modification avec un lien <i>Modifier en ligne</i>.</p> <div class='spip_document_10736 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="49" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_aeres_ticket_ajout_doc_joint.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10736 '><strong>Ticket d'ajout de référence avec document joint</strong></div> </figcaption></figure> </div> <p>Dans le cas d'une demande d'ajout avec fichier joint, vous devrez télécharger le fichier sur votre ordinateur puis l'importer dans Zotero (et le cas échéant le corriger).</p> <p>Une fois une correction/ajout effectué(e) ou refusé(e), pensez à fermer le ticket.</p> <h2 class="h2" id='Style-CSL'>Style CSL<a class='sommaire-back sommaire-back-12' href='#s-Style-CSL' title='Back to the table of contents'></a></h2> <p>Le plugin fournit un style CSL de mise en forme intitulé <i>Chicago adapted for AERES</i> et spécialement développé pour la présentation au format AERES. En autres, ce style :</p> <ul class="spip" role="list"><li> affiche la liste complète des auteurs avec leur prénom, les nom de familles étant affichés en petites capitales pour les distinguer des prénoms ;</li><li> gère la présentation adéquate du nombre de pages selon qu'il s'agisse d'un article ou d'une direction de revues ;</li><li> gère un affichage correct des articles de colloques selon qu'ils aient été publiés ou non ;</li><li> indique la pagination, y compris pour les ouvrages (dont le nombre total de pages est rarement affiché dans les styles anglo-saxons) ;</li><li> utilise les chaines de langues CSL (le style s'adapte donc à la langue de la page) ;</li><li> tient compte des auteurs et/ou des éditeurs du livre.</li></ul> <p>Vous pouvez bien entendu utiliser tout autre style CSL à votre convenance.</p> <h2 class="h2" id='Afficher-la-bibliographie-generale-de-l-unite'>Afficher la bibliographie générale de l'unité<a class='sommaire-back sommaire-back-12' href='#s-Afficher-la-bibliographie-generale-de-l-unite' title='Back to the table of contents'></a></h2> <p>La page ‘biblioaeres_unite' affiche la bibliographie générale de l'unité, limitée à la liste des membres définie sur la page de configuration, les noms de ces derniers étant soulignés afin de facilement les identifier.</p> <p>Le texte de cette page peut facilement être copier/coller dans votre traitement de texte pour incorporation dans le rapport de l'unité.</p> <h2 class="h2" id='Recommandations'>Recommandations<a class='sommaire-back sommaire-back-12' href='#s-Recommandations' title='Back to the table of contents'></a></h2> <p>Zotero est très permissif concernant la saisie des dates. Cependant, le processeur CSL citeproc.php utilisé par ZotSpip n'est pas aussi doué pour détecter correctement la date à partir d'un format brut. Il est donc recommandé de saisir les dates sous la forme AAAA-MM-JJ, AAAA-MM ou AAAA.</p> <p>Il est préférable d'harmoniser la présentation des auteurs sous la forme <i>Nom, Prénom</i>. Il arrive souvent néanmoins que les auteurs soient parfois saisis uniquement avec leurs initiales, ou bien une fois avec accent et une fois sans les accents, ou encore que des fautes de frappe aient eu lieu. ZotSpip peut afficher la liste des auteurs et permet également de fusionner deux auteurs, ce qui permet de corriger les doublons. Le même outil existe aussi pour les mots-clés. C'est accessible via le menu <i>Édition > Références Zotero</i>, les liens <i>Liste des contributeurs</i> et <i>Liste des mots-clés</i> étant accessibles dans la colonne de gauche.</p></div> <hr /> <div class='rss_notes'><div id="nb35-1"> <p><span class="spip_note_ref">[<a href="#nh35-1" class="spip_note" title="Footnotes 35-1" rev="appendix">1</a>] </span>Il est recommandé d'utiliser une librairie partagée dédiée à l'unité et dont seules les personnes habilitées aurait accès en écriture.</p> </div><div id="nb35-2"> <p><span class="spip_note_ref">[<a href="#nh35-2" class="spip_note" title="Footnotes 35-2" rev="appendix">2</a>] </span>Une version du plugin pour SPIP 3 sera développé ultérieurement.</p> </div><div id="nb35-3"> <p><span class="spip_note_ref">[<a href="#nh35-3" class="spip_note" title="Footnotes 35-3" rev="appendix">3</a>] </span>À l'intérieur de cette catégorie, il convient de distinguer dans des rubriques séparées les ouvrages ou les chapitres d'ouvrages.</p> </div><div id="nb35-4"> <p><span class="spip_note_ref">[<a href="#nh35-4" class="spip_note" title="Footnotes 35-4" rev="appendix">4</a>] </span>À l'intérieur de cette catégorie, il convient de distinguer dans des rubriques séparées les ouvrages, les chapitres d'ouvrages et les articles.</p> </div><div id="nb35-5"> <p><span class="spip_note_ref">[<a href="#nh35-5" class="spip_note" title="Footnotes 35-5" rev="appendix">5</a>] </span>À l'intérieur de cette catégorie, il convient de distinguer dans des rubriques séparées les ouvrages, les chapitres d'ouvrages et les articles.</p> </div><div id="nb35-6"> <p><span class="spip_note_ref">[<a href="#nh35-6" class="spip_note" title="Footnotes 35-6" rev="appendix">6</a>] </span>Type de référence sous Zotero.</p> </div><div id="nb35-7"> <p><span class="spip_note_ref">[<a href="#nh35-7" class="spip_note" title="Footnotes 35-7" rev="appendix">7</a>] </span>Ce dernier étant inutilisé s'il ne s'agit pas d'une communication avec actes.</p> </div><div id="nb35-8"> <p><span class="spip_note_ref">[<a href="#nh35-8" class="spip_note" title="Footnotes 35-8" rev="appendix">8</a>] </span>Il importe de ne pas confondre les éditeurs scientifiques au sens anglais d'<i>editor</i> avec l'éditeur de l'ouvrage au sens anglais de <i>publisher</i> qui correspond à la maison d'édition.</p> </div><div id="nb35-9"> <p><span class="spip_note_ref">[<a href="#nh35-9" class="spip_note" title="Footnotes 35-9" rev="appendix">9</a>] </span>Cette liste ne propose que les auteurs ayant au moins une publication dans la librairie Zotero. Si vous êtes au début d'une démarche de collecte des publications des membres de l'unité, nous vous conseillons que les références de ces derniers soient saisies avant de mettre à jour la liste des membres.</p> </div><div id="nb35-10"> <p><span class="spip_note_ref">[<a href="#nh35-10" class="spip_note" title="Footnotes 35-10" rev="appendix">10</a>] </span>Le format de la base Zotero étant obtenu directement depuis l'API de Zotero, le plugin prendra en compte automatiquement les éventuelles évolutions de ce schéma à l'avenir.</p> </div></div> </article> <article> <h1>Bibliographie HCERES (anciennement AERES)</h1> <p>erational, Joseph — 2013-01-31T08:04:46Z</p> <div class='rss_chapo'><p>Ce plugin fournit une interface pour faciliter la réalisation d'une bibliographie dans un format adapté aux évaluations des unités de recherche par le HCERES ( Haut Conseil de l'évaluation de la recherche et de l'enseignement supérieur), qui a succédé à l'AERES.</p> <p>Les auteurs peuvent indiquer en ligne des corrections à effectuer ou bien indiquer des références à ajouter.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-12" id="nav6a60d14a620dd7.93311180"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Avertissement"></a><a href="#Avertissement" class="spip_ancre">Avertissement</a></li><li> <a id="s-Introduction"></a><a href="#Introduction" class="spip_ancre">Introduction</a></li><li> <a id="s-Pre-requis-et-installation"></a><a href="#Pre-requis-et-installation" class="spip_ancre">Pré-requis et installation</a></li><li> <a id="s-La-classification-HCERES"></a><a href="#La-classification-HCERES" class="spip_ancre">La classification HCERES</a></li><li> <a id="s-Correspondances-Zotero-HCERES-et-choix-effectues"></a><a href="#Correspondances-Zotero-HCERES-et-choix-effectues" class="spip_ancre">Correspondances Zotero - HCERES et choix effectués</a></li><li> <a id="s-Configuration-du-plugin"></a><a href="#Configuration-du-plugin" class="spip_ancre">Configuration du plugin</a></li><li> <a id="s-Mise-en-place-des-squelettes"></a><a href="#Mise-en-place-des-squelettes" class="spip_ancre">Mise en place des squelettes</a></li><li> <a id="s-Verification-des-references"></a><a href="#Verification-des-references" class="spip_ancre">Vérification des références</a></li><li> <a id="s-Style-CSL"></a><a href="#Style-CSL" class="spip_ancre">Style CSL</a></li><li> <a id="s-Afficher-la-bibliographie-generale-de-l-unite"></a><a href="#Afficher-la-bibliographie-generale-de-l-unite" class="spip_ancre">Afficher la bibliographie générale de l'unité</a></li><li> <a id="s-Statistiques-par-auteurs"></a><a href="#Statistiques-par-auteurs" class="spip_ancre">Statistiques par auteurs</a></li><li> <a id="s-Recommandations"></a><a href="#Recommandations" class="spip_ancre">Recommandations</a></li></ul></div><h2 class="h2" id='Avertissement'>Avertissement<a class='sommaire-back sommaire-back-12' href='#s-Avertissement' title='Back to the table of contents'></a></h2> <p>Ce plugin n'a ni pour objet ni pour effet de promouvoir le HCERES et ses méthodes, qui font l'objet d'un vif débat dans le monde de l'enseignement supérieur et de la recherche. Au contraire, en ayant recours à des outils libres et des standards ouverts, il vise à faciliter le travail administratif des unités de recherche soumises à la contrainte de générer une liste de publications selon une nomenclature qui leur est imposée.</p> <h2 class="h2" id='Introduction'>Introduction<a class='sommaire-back sommaire-back-12' href='#s-Introduction' title='Back to the table of contents'></a></h2> <p>Ce plugin est destiné aux unités de recherche française amenées à préparer la liste de leurs publications dans le cadre de leur évaluation quinquennale par le <a href="https://www.hceres.fr" class="spip_out" rel="external">HCERES</a>.</p> <p>Le plugin <i>Bibliographie HCERES</i> permet de :</p> <ul class="spip" role="list"><li> gérer les publications de l'unité via le logiciel Zotero afin de bénéficier des fonctionnalités d'import/export de ce dernier<span class="spip_note_ref"> [<a href="#nb36-1" class="spip_note" rel="appendix" title="Il est recommandé d'utiliser une librairie partagée dédiée à l'unité et dont (…)" id="nh36-1">1</a>]</span> ;</li><li> proposer une interface web aux membres de l'unité pour consulter leur publications déjà renseignées dans la base de données et d'indiquer les éventuelles corrections à effectuer ainsi que de saisir les références manquantes ;</li><li> gérer les demandes d'ajout/correction sous forme de tickets ;</li><li> produire une liste des publications selon la classification du HCERES.</li></ul> <p>Dans la mesure où le plugin <i>Bibliographie HCERES</i> repose sur le plugin <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a>, le travail effectué pour l'évaluation HCERES permet également d'alimenter le site web de l'unité en ajoutant par exemple les dernières publications de chaque chercheur sur leur page individuelle (voir la documentation de <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a> pour plus d'informations).</p> <h2 class="h2" id='Pre-requis-et-installation'>Pré-requis et installation<a class='sommaire-back sommaire-back-12' href='#s-Pre-requis-et-installation' title='Back to the table of contents'></a></h2> <p><strong>Dépendances :</strong></p> <ul class="spip" role="list"><li> SPIP 3</li><li> plugin <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a></li><li> plugin <a href='https://contrib.spip.net/Biblio-Check' class="spip_in" hreflang="fr">Biblio Check</a></li></ul> <p><strong>Passage de la v1 à la v2</strong></p> <p>Le plugin Bibliographie AERES v1 a été découpé en deux plugins, les fonctionnalités de vérification des références et de création de tickets dédiés ont été déportées dans le plugin <a href='https://contrib.spip.net/Biblio-Check' class="spip_in" hreflang="fr">Biblio Check</a> maintenant requis pour le fonctionnement de Bibliographie HCERES.</p> <p>Les personnes nécessitant uniquement cette fonctionnalité de vérification sans avoir les contraintes de la classification HCERES peuvent donc se contenter de <a href='https://contrib.spip.net/Biblio-Check' class="spip_in" hreflang="fr">Biblio Check</a>.</p> <p><a href='https://contrib.spip.net/Biblio-Check' class="spip_in" hreflang="fr">Biblio Check</a> étant nécessité par Bibliographie HCERES, les fonctionnalités de ce dernier plugin restent les mêmes. À noter toutefois que dorénavant, la création s'effectue avec le plugin <a href='https://contrib.spip.net/Tickets-suivi-de-bugs' class="spip_in" hreflang="fr">Tickets</a> et non avec <a href='https://contrib.spip.net/Tickets-Kiss' class="spip_in" hreflang="fr">Tickets KISS</a>.</p> <h2 class="h2" id='La-classification-HCERES'>La classification HCERES<a class='sommaire-back sommaire-back-12' href='#s-La-classification-HCERES' title='Back to the table of contents'></a></h2> <p>Selon les consignes de l'ancienne AERES pour la rédaction de l'auto-évaluation de l'Unité, les publications de l'unité devront être présentées selon la codification des publications et des productions suivantes :</p> <blockquote class="spip"> <p><strong>Annexe 1 : Codification des publications et des productions</strong></p> <p>L'ordre proposé ci-dessous n'est pas hiérarchique car la valeur des supports de publication varie selon les disciplines. Le directeur de l'unité de recherche renseignera donc les rubriques en sélectionnant celles qui sont pertinentes pour son champ disciplinaire.</p> <ul class="spip" role="list"><li> ACL : Articles dans des revues internationales ou nationales avec comité de lecture répertoriées par l'AERES ou dans les bases de données internationales (ISI Web of Knowledge, Pub Med…).</li><li> ACLN : Articles dans des revues avec comité de lecture non répertoriées par l'AERES ou dans des bases de données internationales.</li><li> ASCL : Articles dans des revues sans comité de lecture.</li><li> BRE : Brevets (indiquer les licences éventuelles).</li><li> C-INV : Conférences données à l'invitation du comité d'organisation dans un congrès national ou international.</li><li> C-ACTI : Communications avec actes dans un congrès international.</li><li> C-ACTN : Communications avec actes dans un congrès national.</li><li> C-COM : Communications orales sans actes dans un congrès international ou national.</li><li> C-AFF : Communications par affiche dans un congrès international ou national.</li><li> DO : Directions d'ouvrages ou de revues.</li><li> OR : Outils de recherche, corpus de recherche, cohortes.</li><li> OS : Ouvrages scientifiques (y compris les éditions critiques et les traductions scientifiques)<span class="spip_note_ref"> [<a href="#nb36-2" class="spip_note" rel="appendix" title="À l'intérieur de cette catégorie, il convient de distinguer dans des (…)" id="nh36-2">2</a>]</span>.</li><li> PV : Publications de vulgarisation<span class="spip_note_ref"> [<a href="#nb36-3" class="spip_note" rel="appendix" title="À l'intérieur de cette catégorie, il convient de distinguer dans des (…)" id="nh36-3">3</a>]</span>.</li><li> PAT : Productions artistiques théorisées (compositions musicales, cinématographiques, expositions, installations…).</li><li> PT : Publications de transfert<span class="spip_note_ref"> [<a href="#nb36-4" class="spip_note" rel="appendix" title="À l'intérieur de cette catégorie, il convient de distinguer dans des (…)" id="nh36-4">4</a>]</span>.</li><li> AP : Autres productions : bases de données, logiciels enregistrés, rapports de fouilles, guides techniques, catalogues d'exposition, rapports intermédiaires de grands projets internationaux, etc.</li></ul> <p>On précisera impérativement la pagination des articles et chapitres d'ouvrages.</p> </blockquote> <p>Il apparaît dès lors que :</p> <ul class="spip" role="list"><li> la classification HCERES peut varier d'une unité à une autre ;</li><li> il n'y a pas de correspondance directe entre cette classification et les types de références utilisés par les logiciels de gestion bibliographique courant (Zotero, BibTeX, EndNote...) ;</li><li> certaines catégories demeurent floues, en particulier les publications de vulgarisation et les publications de transfert ;</li><li> certaines catégories ont des sous-catégories (ouvrages et chapitres d'ouvrages non différenciés dans la catégorie OS par exemple) ;</li><li> d'autres sont étonnamment détaillées (en particulier les communications avec actes).</li></ul><h2 class="h2" id='Correspondances-Zotero-HCERES-et-choix-effectues'>Correspondances Zotero - HCERES et choix effectués<a class='sommaire-back sommaire-back-12' href='#s-Correspondances-Zotero-HCERES-et-choix-effectues' title='Back to the table of contents'></a></h2> <p>Un certains nombre de choix ont été effectués pour faire correspondre la typologie des références Zotero et la classification HCERES, de même que la classification HCERES utilisée dans ce plugin diffère légèrement de celle présentée ci-dessus. Certains choix ont été implémenté en tant qu'option configurable.</p> <p>Les options disponibles sont susceptibles d'évoluer en fonction des besoins exprimés par les unités de recherche voulant utiliser ce plugin.</p> <p>Afin de classer les références Zotero selon la classification HCERES, nous avons donc opéré les choix suivants :</p> <ol class="spip" role="list"><li> Les catégories ACL et ACLN ont été fusionnées ensemble dans la mesure où il n'existe pas à l'heure actuelle un référentiel unique et facilement utilisable pour déterminer si une revue fait partie de la catégorie ACL ou ACLN. Dès lors, la distinction entre ACL et ACLN ne peut être effectuée aisément et selon une règle précise.</li><li> Les <i>articles de revue</i><span class="spip_note_ref"> [<a href="#nb36-5" class="spip_note" rel="appendix" title="Type de référence sous Zotero." id="nh36-5">5</a>]</span> sont classés en ACL (articles dans des revues scientifiques à comité de lecture) à l'exception des articles sans auteur mais comportant uniquement des éditeurs considérés comme des directions de revue (voir ci-après).</li><li> Les <i>articles de magazine</i> sont classés en ASCL (articles dans des revues sans comité de lecture).</li><li> Les <i>brevets</i> sont classés dans la catégorie BRE.</li><li> Les catégories C-INV, C-ACTI et C-ACTN ont été fusionnées en une seule catégorie C-ACT (communication avec publication dans des actes).</li><li> La catégorie OS a été divisée en deux catégories : OS (Ouvrages scientifiques) qui sera limité aux ouvrages complets et CH (Chapitres d'ouvrages).</li><li> Certaines unités présentent les publications avec actes dans la même catégorie que les chapitres d'ouvrage. Une option dans la configuration du plugin permet de préciser si les communications avec actes doivent être classées sous C-ACT ou si elles doivent être fusionnées avec les chapitres d'ouvrage (CH).</li><li> Les <i>articles de colloque</i> pour lesquels le champs <i>Titre des actes</i> est renseigné seront donc considérés comme des communications avec actes et classés sous C-ACT ou CH (en fonction de la configuration du plugin).</li><li> Les <i>articles de colloque</i> sans <i>Titre des actes</i> seront donc considérés soit comme des communications orales (C-COM) soit comme des communications affichées (C-AFF). Afin de pouvoir distinguer entre les deux, il est impératif de renseigner le champs <i>Éditeur</i><span class="spip_note_ref"> [<a href="#nb36-6" class="spip_note" rel="appendix" title="Ce dernier étant inutilisé s'il ne s'agit pas d'une communication avec actes." id="nh36-6">6</a>]</span> en y saisissant soit <code class='spip_code spip_code_inline' dir='ltr'>communication orale</code> soit <code class='spip_code spip_code_inline' dir='ltr'>poster</code> (en minuscules, le numéro de communication pouvant optionnellement être indiqué ensuite, exemple : <code class='spip_code spip_code_inline' dir='ltr'>poster n°123456</code>).</li><li> Les directions d'ouvrages ou de revues seront identifiés à partir du rôle des différents contributeurs. Il s'agira donc soit d'un <i>livre</i>, soit d'un <i>article de revue</i>, n'ayant aucun <i>auteur</i> mais ayant au moins un <i>éditeur</i><span class="spip_note_ref"> [<a href="#nb36-7" class="spip_note" rel="appendix" title="Il importe de ne pas confondre les éditeurs scientifiques au sens anglais (…)" id="nh36-7">7</a>]</span>.</li><li> Les <i>livres</i> comportant au moins un auteur seront classés sous OS (ouvrages scientifiques).</li><li> Les <i>chapitres de livre</i> seront classés sous CH.</li><li> Les <i>films</i>, <i>illustrations</i>, <i>enregistrements audio</i> et <i>enregistrements vidéo</i> seront classés sous PAT (Productions artistiques théorisées).</li><li> Deux catégories additionnelles ont été crées : TH pour les thèses de doctorat et HDR pour les habilitations à diriger des recherche.</li><li> Les <i>thèses</i> dont le champs <i>Type</i> commence par <code class='spip_code spip_code_inline' dir='ltr'>thèse</code> seront classées sous TH (on peut éventuellement préciser la thèse, par exemple <code class='spip_code spip_code_inline' dir='ltr'>thèse en sociologie</code>).</li><li> Les <i>thèses</i> dont le champs <i>Type</i> commence par <code class='spip_code spip_code_inline' dir='ltr'>habilitation à diriger des recherches</code> (en minuscles, attention aux accents et aux fautes de frappe) seront classées sous HDR.</li><li> Les autres <i>thèses</i> ne seront pas pris en compte.</li><li> Les <i>articles d'encyclopédie</i>, <i>articles de journal</i> (presse), <i>cartes</i>, <i>documents</i>, <i>entrées de dictionnaire</i>, <i>manuscrits</i>, <i>programmes informatiques</i>, <i>pages web</i> et les <i>rapports</i> seront classés dans AP (autres publications).</li><li> Les autres types de références Zotero ne sont pas pris en compte.</li></ol> <p><strong>Si votre unité de recherche nécessite d'autres catégories, veuillez contacter l'<a href='https://contrib.spip.net/Joseph' class="spip_in">auteur</a> (joseph point larmarange chez ird point fr).</strong></p> <h2 class="h2" id='Configuration-du-plugin'>Configuration du plugin<a class='sommaire-back sommaire-back-12' href='#s-Configuration-du-plugin' title='Back to the table of contents'></a></h2> <p>Le formulaire de configuration du plugin <i>Bibliographie HCERES</i> se situe sur la page de configuration de <i>ZotSpip</i>, accessible via le menu <i>Configuration > ZotSpip</i>.</p> <p>En premier lieu, vous devez configurer <a href='https://contrib.spip.net/Le-plugin-ZotSpip' class="spip_in" hreflang="fr">ZotSpip</a> et synchroniser la librairie Zotero de l'unité. Vérifiez que la clé API utilisée pour ZotSpip dispose des droits en écriture.</p> <p>Puis vous pouvez préciser :</p> <ul class="spip" role="list"><li> la période couverte par l'évaluation ;</li><li> le style CSL à utiliser (nous recommandons le style <i>Chicago adapted for HCERES</i>, voir plus loin) ;</li><li> le titre à utiliser pour la page présentant la bibliographie générale de l'unité ;</li><li> la liste des auteurs à prendre en compte pour la bibliographie générale de l'unité<span class="spip_note_ref"> [<a href="#nb36-8" class="spip_note" rel="appendix" title="Cette liste ne propose que les auteurs ayant au moins une publication dans (…)" id="nh36-8">8</a>]</span> ;</li><li> les personnes pouvant déposer des demande de corrections/ajouts de références<span class="spip_note_ref"> [<a href="#nb36-9" class="spip_note" rel="appendix" title="Cette configuration est indépendante de celle équivalente dans Biblio Check. (…)" id="nh36-9">9</a>]</span> ;</li><li> celles pouvant consulter la bibliographie générale de l'unité;</li><li> celles ayant accès aux statistiques par auteur.</li></ul><h2 class="h2" id='Mise-en-place-des-squelettes'>Mise en place des squelettes<a class='sommaire-back sommaire-back-12' href='#s-Mise-en-place-des-squelettes' title='Back to the table of contents'></a></h2> <p>La partie publique du plugin repose sur 4 pages :</p> <ul class="spip" role="list"><li> <strong>biblioaeres</strong></li><li> <strong>biblioaeres_verif</strong></li><li> <strong>biblioaeres_voir</strong></li><li> <strong>biblioaeres_unite</strong></li></ul> <p><strong>Si vous utilisez un squelette <a href='https://contrib.spip.net/Le-Squelette-Zpip' class="spip_in" hreflang="fr">Zpip v1</a></strong>, vous n'avez rien à faire, ces quatres pages sont directement fonctionnelles.</p> <p><strong>Si vous utilisez un autre squelette</strong>, vous devez créer ces quatre fichiers à la racine de votre site, en fonction de la structure HTML de votre squelette, et y inclure les fichiers homonymes situés dans le répertoire <code class='spip_code spip_code_inline' dir='ltr'>contenu</code> du plugin. Pensez également à ajouter dans le <code class='spip_code spip_code_inline' dir='ltr'><head>...</head></code> de la page la meta suivante : <code class='html spip_code spip_code_inline' dir='ltr'><meta name="robots" content="noindex, nofollow" /></code>.</p> <p>Par exemple, pour créer la page <strong>biblioaeres_verif.html</strong>, on utilisera le code suivant</p> <div class="precode"><pre data-language="spip" class='spip_code spip_code_block language-spip' dir='ltr' style='text-align:left;'><code>.. <head> <INCLURE{fond=head/page-biblioaeres_verif, env}> ... </head> <body> <INCLURE{fond=contenu/page-biblioaeres_verif, env}> ... </body> ...</code></pre></div><h2 class="h2" id='Verification-des-references'>Vérification des références<a class='sommaire-back sommaire-back-12' href='#s-Verification-des-references' title='Back to the table of contents'></a></h2><div class='spip_document_10721 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="34" data-legende-lenx="x" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/png/capture_page_biblioaeres.png' class="spip_in spip_doc_lien"> </a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-10721 '><strong>Capture de la page ‘biblioaeres'</strong></div> </figcaption></figure> </div> <p>Une fois arrivé sur la page ‘biblioaeres', un membre de l'unité a simplement à sélectionner son nom puis à cliquer sur <i>Vérifier/Afficher</i>.</p> <p>La page de vérification présente la liste des publications de cet auteur selon la classification HCERES. Pour chaque référence, une série de vérifications sont effectuées (le nombre de page est-il renseigné ? les auteurs du livre, pour un chapitre, sont-ils précisées ? etc.) et un message d'avertissement est affiché le cas échéant. Cette page liste également les communications et les thèses indéterminées, ainsi que les références sans année de publication.</p> <p>La saisie d'une demande de correction ou d'ajout est similaire à celle de la version 1 du plugin (voir <a href='https://contrib.spip.net/Bibliographie-AERES-1-0' class="spip_in" hreflang="fr">Bibliographie AERES 1.0</a>) et reprends à l'identique le fonctionnement de <a href='https://contrib.spip.net/Biblio-Check' class="spip_in" hreflang="fr">Biblio Check</a>.</p> <h2 class="h2" id='Style-CSL'>Style CSL<a class='sommaire-back sommaire-back-12' href='#s-Style-CSL' title='Back to the table of contents'></a></h2> <p>Le plugin fournit un style CSL de mise en forme intitulé <i>Chicago adapted for HCERES</i> et spécialement développé pour la présentation au format HCERES. En autres, ce style :</p> <ul class="spip" role="list"><li> affiche la liste complète des auteurs avec leur prénom, les nom de familles étant affichés en petites capitales pour les distinguer des prénoms ;</li><li> gère la présentation adéquate du nombre de pages selon qu'il s'agisse d'un article ou d'une direction de revues ;</li><li> gère un affichage correct des articles de colloques selon qu'ils aient été publiés ou non ;</li><li> indique la pagination, y compris pour les ouvrages (dont le nombre total de pages est rarement affiché dans les styles anglo-saxons) ;</li><li> utilise les chaines de langues CSL (le style s'adapte donc à la langue de la page) ;</li><li> tient compte des auteurs et/ou des éditeurs du livre.</li></ul> <p>Vous pouvez bien entendu utiliser tout autre style CSL à votre convenance.</p> <h2 class="h2" id='Afficher-la-bibliographie-generale-de-l-unite'>Afficher la bibliographie générale de l'unité<a class='sommaire-back sommaire-back-12' href='#s-Afficher-la-bibliographie-generale-de-l-unite' title='Back to the table of contents'></a></h2> <p>La page ‘biblioaeres_unite' affiche la bibliographie générale de l'unité, limitée à la liste des membres définie sur la page de configuration, les noms de ces derniers étant soulignés afin de facilement les identifier.</p> <p>Le texte de cette page peut facilement être copier/coller dans votre traitement de texte pour incorporation dans le rapport de l'unité.</p> <h2 class="h2" id='Statistiques-par-auteurs'>Statistiques par auteurs<a class='sommaire-back sommaire-back-12' href='#s-Statistiques-par-auteurs' title='Back to the table of contents'></a></h2> <p>Vous pouvez demander à afficher, sur la page de la bibliographie générale de l'unité, quelques statistiques de publication (nombre d'ACL, DO, OS et CH) pour chaque membres de l'unité. Ces dernières sont requises lors de la constitution du dossier d'évaluation HCERES. <strong>Nous vous recommandons fortement de ne pas rendre la consultation de ces statistiques publique et de la limiter aux administrateurs du site.</strong></p> <h2 class="h2" id='Recommandations'>Recommandations<a class='sommaire-back sommaire-back-12' href='#s-Recommandations' title='Back to the table of contents'></a></h2> <p>Zotero est très permissif concernant la saisie des dates. Cependant, le processeur CSL citeproc.php utilisé par ZotSpip n'est pas aussi doué pour détecter correctement la date à partir d'un format brut. Il est donc recommandé de saisir les dates sous la forme AAAA-MM-JJ, AAAA-MM ou AAAA.</p> <p>Il est préférable d'harmoniser la présentation des auteurs sous la forme <i>Nom, Prénom</i>. Il arrive souvent néanmoins que les auteurs soient parfois saisis uniquement avec leurs initiales, ou bien une fois avec accent et une fois sans les accents, ou encore que des fautes de frappe aient eu lieu. ZotSpip peut afficher la liste des auteurs et permet également de fusionner deux auteurs, ce qui permet de corriger les doublons. Le même outil existe aussi pour les mots-clés. C'est accessible via le menu <i>Édition > Références Zotero</i>, les liens <i>Liste des contributeurs</i> et <i>Liste des mots-clés</i> étant accessibles dans la colonne de gauche.</p></div> <hr /> <div class='rss_notes'><div id="nb36-1"> <p><span class="spip_note_ref">[<a href="#nh36-1" class="spip_note" title="Footnotes 36-1" rev="appendix">1</a>] </span>Il est recommandé d'utiliser une librairie partagée dédiée à l'unité et dont seules les personnes habilitées aurait accès en écriture.</p> </div><div id="nb36-2"> <p><span class="spip_note_ref">[<a href="#nh36-2" class="spip_note" title="Footnotes 36-2" rev="appendix">2</a>] </span>À l'intérieur de cette catégorie, il convient de distinguer dans des rubriques séparées les ouvrages ou les chapitres d'ouvrages.</p> </div><div id="nb36-3"> <p><span class="spip_note_ref">[<a href="#nh36-3" class="spip_note" title="Footnotes 36-3" rev="appendix">3</a>] </span>À l'intérieur de cette catégorie, il convient de distinguer dans des rubriques séparées les ouvrages, les chapitres d'ouvrages et les articles.</p> </div><div id="nb36-4"> <p><span class="spip_note_ref">[<a href="#nh36-4" class="spip_note" title="Footnotes 36-4" rev="appendix">4</a>] </span>À l'intérieur de cette catégorie, il convient de distinguer dans des rubriques séparées les ouvrages, les chapitres d'ouvrages et les articles.</p> </div><div id="nb36-5"> <p><span class="spip_note_ref">[<a href="#nh36-5" class="spip_note" title="Footnotes 36-5" rev="appendix">5</a>] </span>Type de référence sous Zotero.</p> </div><div id="nb36-6"> <p><span class="spip_note_ref">[<a href="#nh36-6" class="spip_note" title="Footnotes 36-6" rev="appendix">6</a>] </span>Ce dernier étant inutilisé s'il ne s'agit pas d'une communication avec actes.</p> </div><div id="nb36-7"> <p><span class="spip_note_ref">[<a href="#nh36-7" class="spip_note" title="Footnotes 36-7" rev="appendix">7</a>] </span>Il importe de ne pas confondre les éditeurs scientifiques au sens anglais d'<i>editor</i> avec l'éditeur de l'ouvrage au sens anglais de <i>publisher</i> qui correspond à la maison d'édition.</p> </div><div id="nb36-8"> <p><span class="spip_note_ref">[<a href="#nh36-8" class="spip_note" title="Footnotes 36-8" rev="appendix">8</a>] </span>Cette liste ne propose que les auteurs ayant au moins une publication dans la librairie Zotero. Si vous êtes au début d'une démarche de collecte des publications des membres de l'unité, nous vous conseillons que les références de ces derniers soient saisies avant de mettre à jour la liste des membres.</p> </div><div id="nb36-9"> <p><span class="spip_note_ref">[<a href="#nh36-9" class="spip_note" title="Footnotes 36-9" rev="appendix">9</a>] </span>Cette configuration est indépendante de celle équivalente dans Biblio Check. Vous pouvez donc désactiver la vérification via Biblio Check tout en l'autorisant via Bibliographie HCERES</p> </div></div> </article> <article> <h1>bigfoot</h1> <p>b_b — 2015-06-16T09:20:23Z</p> <div class='rss_chapo'><p>Un plugin qui facilite l'utilisation des notes de bas de page en les affichant dans des infobulles à l'aide d'un peu de javascript.</p></div> <div class='rss_texte'><p>Le constat de l'auteur du script :</p> <blockquote class="spip"> <p>Les notes de bas de page sur le web sont une plaie. Tu dois d'abord essayer de cliquer sur un tout petit nombre qui te renvoie quelque part vers le bas de la page, tu lis la note que tu cherchais, puis tu cliques de nouveau sur un petit nombre pour remonter là où tu étais dans la page.</p> </blockquote> <p>La solution proposée par bigfoot :</p> <ul class="spip" role="list"><li> le bloc des notes en bas de page est masqué ;</li><li> les liens vers les notes de bas de page sont remplacés par des boutons afin de les rendre plus facile à cliquer ;</li><li> au clic, le contenu de la note apparaît dans une infobulle directement à côté du bouton, ce qui évite le défilement vers le bas de la page ;</li><li> l'infobulle est redimensionnée et positionnée automatiquement pour assurer une lecture confortable de son contenu (même sur petit écran).</li></ul> <p>De plus, les notes de bas de page sont bien visibles lors de l'impression.</p> <p>Voici un aperçu du rendu d'une note ouverte dans une infobulle :</p> <div class='spip_document_12951 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="103" data-legende-lenx="xx" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-12951 '><strong>Copie d'écran montrant l'apparence d'une bulle d'aide affichant une note de base de page avec bigfoot </strong></div> </figcaption></figure> </div> <p>Le plugin agit automatiquement sur les notes des pages de votre site, aucune configuration ou adaptation n'est nécessaire. Simple et efficace :)</p></div> </article> <article> <h1>Boite à outils pour articles - version plugin</h1> <p>christophe vallois — 2007-12-08T23:26:46Z</p> <div class='rss_chapo'><p>Permet un accès rapide dans les articles, sous forme de boutons, aux fonctions de divers plugins.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-9" id="nav6a60d14a6e3ad9.74835123"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Origine"></a><a href="#Origine" class="spip_ancre">Origine</a></li><li> <a id="s-Description"></a><a href="#Description" class="spip_ancre">Description</a></li><li> <a id="s-Installation"></a><a href="#Installation" class="spip_ancre">Installation</a></li><li> <a id="s-Configuration"></a><a href="#Configuration" class="spip_ancre">Configuration</a></li><li> <a id="s-Personnalisation"></a><a href="#Personnalisation" class="spip_ancre">Personnalisation</a></li><li> <a id="s-Source"></a><a href="#Source" class="spip_ancre">Source</a></li><li> <a id="s-Telechargement"></a><a href="#Telechargement" class="spip_ancre">Téléchargement</a></li><li> <a id="s-Evolution"></a><a href="#Evolution" class="spip_ancre">Évolution</a></li><li> <a id="s-TODO"></a><a href="#TODO" class="spip_ancre">TODO</a></li></ul></div><h2 class="h2" id='Origine'>Origine<a class='sommaire-back sommaire-back-9' href='#s-Origine' title='Back to the table of contents'></a></h2> <p>Aficionados de spip depuis un certain temps, j'ai toujours voulu insérer une version imprimable de l'article dans le squelette. Puis est venu l'idée de pouvoir envoyer l'article à un ami. Tout ça se faisait avec beaucoup de bidouillage sous 1.8, puis est arrivée la version 1.9 et son cortège de plugins qui a décuplé et simplifié les possibilités d'interactivité de SPIP.</p> <p>Après avoir utilisé les plugins article PDF et Envoyer à un ami, j'en ai voulu encore plus et m'inspirant de quelques sites comme <a href="https://www.agoravox.fr/" class="spip_out" rel="external">agoravox</a> :</p> <div class='spip_document_5201 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>ou <a href="http://www.liberation.fr/" class="spip_out" rel="external">libération</a> :</p> <div class='spip_document_5189 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>J'ai écrit <a href='https://contrib.spip.net/Boite-a-outils-pour-article,2231' class="spip_in" hreflang="fr">une petite noisette</a> pour insérer plus facilement cette série d'outils dans les articles. Et poussant la logique encore plus loin voici l'évolution de cette noisette sous forme de plugin, plus facile à installer et à configurer.</p> <h2 class="h2" id='Description'>Description<a class='sommaire-back sommaire-back-9' href='#s-Description' title='Back to the table of contents'></a></h2> <p>Ce plugin vous permet d'insérer dans tous vos articles une boite regroupant divers outils sous forme de bouton pour :</p> <p>- </p> <div class='spip_document_5194 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Avoir une version imprimable de l'article sans la mise en forme du site</p> <p>- </p> <div class='spip_document_5184 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Syndiquer la rubrique de l'article</p> <p>- </p> <div class='spip_document_5191 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Ajouter un commentaire à l'article : raccourci vers le forum attaché à l'article :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code> [<a href="(#PARAMETRES_FORUM|url_reponse_forum)">Réagir à l'article</a>]</code></pre></div> <p>- Compteur du nombre de réactions à l'article :</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_compteur_forum(FORUMS){id_article}></BOUCLE_compteur_forum> #TOTAL_BOUCLE réactions <//B_compteur_forum></code></pre></div> <p>- </p> <div class='spip_document_5190 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Lien vers les articles du même auteur</p> <div class="precode"><pre class='spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_auteur_article(AUTEURS){id_article}> <a href="#URL_AUTEUR"> Du même auteur </a> </BOUCLE_auteur_article></code></pre></div> <p><strong>Ce plugin sert également de conteneur à d'autres plugins afin d'ajouter d'autres fonctions :</strong></p> <p>- </p> <div class='spip_document_5185 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Régler la taille du texte de l'article avec le <a href='https://contrib.spip.net/Texte-agrandi-ou-pleine-page' class="spip_in" hreflang="fr">plugin bouton texte</a></p> <p>- </p> <div class='spip_document_5181 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Format pdf de l'article avec le <a href='https://contrib.spip.net/Article-PDF-2226' class="spip_in" hreflang="fr">plugin article-pdf</a> qui génère dans une nouvelle page l'article au format pdf. Vous pouvez alors l'enregistrer ou l'imprimer comme tout fichier pdf</p> <p>- </p> <div class='spip_document_5193 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Envoyer par mail une page à un ami avec le <a href='https://contrib.spip.net/Plugin-envoyer-a-un-ami' class="spip_in" hreflang="fr">plugin envoyer à un ami</a>. Ce plugin ouvre un formulaire d'envoi qui permet d'envoyer un courriel avec un lien vers la page concernée. <i>Attention plugin non fonctionnel sous SPIP 1.9.2</i></p> <p>- </p> <div class='spip_document_5202 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Attribuer une note à l'article avec <a href='https://contrib.spip.net/Notation-d-articles-SPIP' class="spip_in" hreflang="fr">le plugin notation</a></p> <h2 class="h2" id='Installation'>Installation<a class='sommaire-back sommaire-back-9' href='#s-Installation' title='Back to the table of contents'></a></h2> <p>Récupérer le zip du plugin sur l'espace de téléchargement de la Zone : <a href="http://files.spip.org/spip-zone/" class="spip_url spip_out" rel="external">http://files.spip.org/spip-zone/</a><span class="spip_note_ref"> [<a href="#nb37-1" class="spip_note" rel="appendix" title="En cas de problème sur ce lien de téléchargement voir les sites miroirs" id="nh37-1">1</a>]</span>. L'installation se déroule ensuite comme pour tous les autres plugins, cf. <a href="https://www.spip.net/fr_article3396.html" class="spip_url spip_out" rel="external">https://www.spip.net/fr_article3396.html</a>.</p> <p>Pour profiter de toutes les fonctions n'oubliez pas d'installer et d'activer les plugins complémentaires (voir les sources plus bas). Le plugin boite à outils prend en charge ces plugins complémentaires, vous n'avez pas besoin d'ajouter les balises spécifiques de chaque plugins vous même.</p> <p>Il ne vous reste plus qu'a insérer dans votre squelette article.html à l'endroit désiré le code suivant : <br />- version en boite <code class='spip_code spip_code_inline' dir='ltr'><INCLURE{fond=inc-boite-outils}{id_article}></code> <br />- version en barre <code class='spip_code spip_code_inline' dir='ltr'><INCLURE{fond=inc-barre-outils}{id_article}></code></p> <div class='spip_document_5176 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Configuration'>Configuration<a class='sommaire-back sommaire-back-9' href='#s-Configuration' title='Back to the table of contents'></a></h2> <p>Attention le plugin cfg est obligatoire pour pouvoir configurer le plugin.</p> <p>Le plugin posséde une interface de configuration <a href='https://contrib.spip.net/Config-CFG' class="spip_in" hreflang="fr">réalisée grâce à cfg</a> qui vous permet, pour le moment, de configurer les éléments à afficher dans le plugin.</p> <p>Pour accéder à l'interface de configuration, direction la page de gestion des plugins, vous dépliez l'onglet du plugin et vous obtenez un lien vers la configuration</p> <div class='spip_document_5179 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div> <p>Il ne vous reste plus qu'a cocher les éléments que vous souhaitez voir apparaitre dans votre article.</p> <div class='spip_document_5177 spip_document spip_documents spip_document_image spip_documents_center spip_document_center'> <figure class="spip_doc_inner"> </figure> </div><h2 class="h2" id='Personnalisation'>Personnalisation<a class='sommaire-back sommaire-back-9' href='#s-Personnalisation' title='Back to the table of contents'></a></h2> <p>En développement pour être intégrée au plugin.</p> <div class='spip_document_4483 spip_document spip_documents spip_document_image spip_documents_right spip_document_right'> <figure class="spip_doc_inner"> </figure> </div> <p>Vous pouvez néanmoins personnaliser les icones de la boite à outils en mettant les votres à la place de ceux présents dans le répertoire <code class='spip_code spip_code_inline' dir='ltr'>outils_article/img_pack</code>.<br class='autobr' /> Ce répertoire contient également des icônes alternatives pour les plugins complémentaires (voir la doc des différents plugins pour les personnaliser)</p> <p>Les icônes sont issues de <a href="http://jimmac.musichall.cz/i.php" class="spip_out" rel="external">Jakub 'Jimmac' Steiner</a></p> <p>Vous pouvez également changer l'intitulé des boutons en modifiant le ficher <code class='spip_code spip_code_inline' dir='ltr'>outils_article/lang/outilsarticle_fr.php</code></p> <h2 class="h2" id='Source'>Source<a class='sommaire-back sommaire-back-9' href='#s-Source' title='Back to the table of contents'></a></h2> <p>Source d'inspiration et plugins complémentaires :</p> <ul class="spip" role="list"><li> pour la version imprimable <ul class="spip" role="list"><li> <a href='https://contrib.spip.net/Plugin-version-imprimable' class="spip_in" hreflang="fr">Plugin version imprimable</a></li><li> <a href='https://contrib.spip.net/Comment-avoir-une-version-imprimable-d-un-article' class="spip_in" hreflang="fr">Comment avoir une version imprimable d'un article<small class="fine d-inline"> </small>?</a></li></ul></li><li> <a href='https://contrib.spip.net/Article-PDF-2226' class="spip_in" hreflang="fr">Article PDF</a></li><li> <a href='https://contrib.spip.net/Plugin-envoyer-a-un-ami' class="spip_in" hreflang="fr">Plugin envoyer à un ami</a></li><li> <a href='https://contrib.spip.net/Texte-agrandi-ou-pleine-page' class="spip_in" hreflang="fr">Texte agrandi ou pleine page</a></li><li> <a href='https://contrib.spip.net/Notation-d-articles-SPIP' class="spip_in" hreflang="fr">Notation d'articles SPIP</a></li></ul><h2 class="h2" id='Telechargement'>Téléchargement<a class='sommaire-back sommaire-back-9' href='#s-Telechargement' title='Back to the table of contents'></a></h2><ul class="spip" role="list"><li> <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/_test_/outils_article/" class="spip_out" rel="external">voir le code<br class='autobr' /> dans la zone</a></li><li> <a href="https://files.spip.net/spip-zone/" class="spip_out" rel="external">télécharger le zip</a> (version en développement</li><li> MAJ(11/05/08) <div class='spip_document_5613 spip_document spip_documents spip_document_file spip_document_avec_legende' data-legende-len="21" data-legende-lenx="" > <figure class="spip_doc_inner"> <a href='https://contrib.spip.net/IMG/zip/boite_a_outils_article.zip' class=" spip_doc_lien" title='Zip - 61.9 KiB' type="application/zip"></a> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-5613 '><strong>boite à outils v0.3 </strong></div> </figcaption></figure> </div> <p>version 0.3 dernière version stable pour 1.9.2 (compatible spip2) la version sur la zone étant désormais le version de développement</p> </li></ul><h2 class="h2" id='Evolution'>Évolution<a class='sommaire-back sommaire-back-9' href='#s-Evolution' title='Back to the table of contents'></a></h2> <p><strong>version 0.3.0</strong> <br />- affichage au singulier et au pluriel de la boucle compteur : ajout de fichier mes_options.php <br />- ajout d'un bouton de syndication du forum de l'article (avec le squelette backend-forum de <a href="https://forum.spip.net" class="spip_out" rel="external">forum.spip.net</a>) 13/12/07</p> <h2 class="h2" id='TODO'>TODO<a class='sommaire-back sommaire-back-9' href='#s-TODO' title='Back to the table of contents'></a></h2><ul class="spip" role="list"><li> internationalisation <ul class="spip" role="list"><li> finir traduction espagnole (noisette) ok v0.2</li><li> traduction anglaise</li></ul></li><li> système d'habillages pour pouvoir choisir ses icônes dans la partie privée</li><li> choix du texte de l'intitulé avec cfg</li><li> transformation de la noisette en balise (#BOITE_OUTILS)</li><li> passage en feuille de style des squelettes</li><li> ajouter un lien pour syndiquer les commentaires de l'article ok v0.3</li><li> version pour les brèves</li></ul></div> <hr /> <div class='rss_notes'><div id="nb37-1"> <p><span class="spip_note_ref">[<a href="#nh37-1" class="spip_note" title="Footnotes 37-1" rev="appendix">1</a>] </span>En cas de problème sur ce lien de téléchargement voir <a href='https://contrib.spip.net/Telechargements' class="spip_in" hreflang="fr">les sites miroirs</a></p> </div></div> </article> <article> <h1>Bonux for SPIP 3.*</h1> <p>JLuc, Loiseau2nuit — 2015-01-28T12:17:00Z</p> <div class='rss_chapo'><p>A great number of the features brought by the first version of SPIP Bonux have since then been fully incorporated into SPIP3. Some still haven't yet, and those are brought by this new plugin's version <i>Bonux for SPIP3</i>.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-4" id="nav6a60d14a7281f2.19172064"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Tags-criteria-amp-loops"></a><a href="#Tags-criteria-amp-loops" class="spip_ancre">Tags, criteria & loops</a></li><li> <a id="s-PHP-functions"></a><a href="#PHP-functions" class="spip_ancre">PHP functions</a></li><li> <a id="s-array_column-function"></a><a href="#array_column-function" class="spip_ancre">array_column function</a></li><li> <a id="s-Renamed"></a><a href="#Renamed" class="spip_ancre">Renamed</a></li></ul></div><p>This post lists all tags, criterias & functions, that are defined by SPIP Bonux, for we can keep them in mind, but the documentation of those elements won't appear on (see also other <a href='https://contrib.spip.net/spip-bonux-en' class="spip_in">documentation posts to SPIP Bonux</a> or even the <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/spip-bonux-3" class="spip_out" rel="external">source code</a>).</p> <p>Note: to avoid conflicts, some of these functionalities are defined by Bonux only if they have NOT been already defined elsewhere.</p> <h2 class="h2" id='Tags-criteria-amp-loops'>Tags, criteria & loops<a class='sommaire-back sommaire-back-4' href='#s-Tags-criteria-amp-loops' title='Back to the table of contents'></a></h2> <p><strong>Tags</strong></p> <ul class="spip" role="list"><li> <code class='spip spip_code spip_code_inline' dir='ltr'>#SET_PUSH</code> stacks an element in an array, instantiated with <code class='spip spip_code spip_code_inline' dir='ltr'>#SET{my_array,#ARRAY}</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>#SET_MERGE</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>#COMPTEUR</code> (Counter)</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>#SOMME</code> (Sum)</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>#COMPTE</code> (Account)</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>#MOYENNE</code> (Average)</li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>#MINIMUM</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>#MAXIMUM</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>#STATS</code></li></ul> <p>The tags <code class='spip_code spip_code_inline' dir='ltr'>#COMPTEUR</code>, <code class='spip_code spip_code_inline' dir='ltr'>#COMPTE</code>, <code class='spip_code spip_code_inline' dir='ltr'>#SOMME</code>, <code class='spip_code spip_code_inline' dir='ltr'>#MOYENNE</code>, <code class='spip_code spip_code_inline' dir='ltr'>#MINIMUM</code>, <code class='spip_code spip_code_inline' dir='ltr'>#MAXIMUM</code> and <code class='spip_code spip_code_inline' dir='ltr'>#STATS</code> require using a criterion that specifies the field, which the Tag is calculated on.</p> <p>Those criterions does not calculate any joint or relational database, contrary to the <code class='spip_code spip_code_inline' dir='ltr'>{compteur table}</code> criterion which does.</p> <p><strong>Examples of usage : </strong></p> <p>- #SET_PUSH : <code class='spip spip_code spip_code_inline' dir='ltr'>#SET_PUSH{my_array,my_value}</code></p> <p><strong>Statistics criteria</strong></p> <ul class="spip" role="list"><li> <code class='spip spip_code spip_code_inline' dir='ltr'>{compteur}</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>{compteur_left}</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>{somme}</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>{compte}</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>{moyenne}</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>{minimum}</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>{maximum}</code></li><li> <code class='spip spip_code spip_code_inline' dir='ltr'>{stats}</code></li></ul> <p><strong>Examples of usage : </strong></p> <p>- Let's say an extra field 'distance' was added to the ARTICLES objects (posts). The following loop will then calculate the sum (<code class='spip_code spip_code_inline' dir='ltr'>#SOMME</code>) of the distances set in every article posted into section id n°1 (<code class='spip_code spip_code_inline' dir='ltr'>id_rubrique=1</code>)</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_a(ARTICLES){id_rubrique=1}{somme distance}></BOUCLE_a> #SOMME{distance} </B_a></code></pre></div> <p>- In the plugin <a href="https://plugins.spip.net/abonnement.html?lang=en" class="spip_out" rel="external">'abonnement'</a> for example, the '<a href="https://zone.spip.net/trac/spip-zone/browser/_plugins_/abonnement/branches/v0/prive/exec/abonnements_stats.html" class="spip_out" rel="external">abonnements_stats</a> ' file gives several examples of those criteria.</p> <p>For example:</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_nombre(AUTEURS_ELARGIS_ABONNEMENTS){id_abonnement}{statut_paiement=ok}{somme montant}{compte montant}{fusion id_abonnement}> <td>#COMPTE{montant}</td> <td>[(#SOMME{montant}|number_format{2, ',', ' '}|replace{' ',' '})]</td> </BOUCLE_nombre></code></pre></div> <p><strong>Other criterion</strong></p> <p><code class='spip spip_code spip_code_inline' dir='ltr'>{fusion_supprimer}</code> : this criterion deletes from the SQL query the <code class='spip_code spip_code_inline' dir='ltr'>GROUP BY</code> condition which is already implied, a this compilation step. That might be useful to get rid of a potential interfering <code class='spip_code spip_code_inline' dir='ltr'>GROUP BY</code>, eventually added by default by SPIP's compiler while joining tables. It then becomes possible to add a criterion for the desired merge (see <a href="https://core.spip.net/issues/3209" class="spip_out" hreflang="fr" rel="external">issue #3209</a>).</p> <p>In the following loop, we have to add <code class='spip spip_code spip_code_inline' dir='ltr'>{fusion_supprimer}</code> in order to get the merge on dates, because the compiler automatically adds a <code class='spip_code spip_code_inline' dir='ltr'>GOUP BY id_article</code> to join the <i>ARTICLES</i> table (posts) to the <i>MOTS</i> table (keywords) :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_year_featured(ARTICLES){id_mot=27}{fusion_supprimer}{fusion YEAR(date)}> [(#DATE|annee)]<br /> </BOUCLE_year_featured></code></pre></div><h2 class="h2" id='PHP-functions'>PHP functions<a class='sommaire-back sommaire-back-4' href='#s-PHP-functions' title='Back to the table of contents'></a></h2> <p>Bonux also defines a whole set of functions, that can be used as filters or by other plugins.</p> <div class="precode"><pre class='php spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>/** Get fields date_$suffixe and heure_$suffixe in the environment, check for their relevancy and re-format them */ function verifier_corriger_date_saisie($suffixe,$horaire,&$erreurs); /** Returns the charset of a line, to be imported */ function importer_csv_importcharset($texte); /** Removes accents from keys, to avoid problems ... */ function importer_csv_nettoie_key($key); /** Reads a CSV file & returns an array if $head is true, the first line is used as a header to generate an array*/ function inc_importer_csv_dist($file, $head = false, $delim = ",", $enclos = '"', $len = 10000) ; /** Exports a field to a CSV export */ function exporter_csv_champ($champ) ; /** Exports a full line, CSV formated, with specified delimiter */ function exporter_csv_ligne($ligne, $delim = ',', $importer_charset = null) ; /** export as CSV. $resource is an array or any open readable SQL resource */ function inc_exporter_csv_dist($titre, $resource, $delim=',', $entetes = null,$envoyer = true); /** generates an IMG tag from a file name */ function tag_img($img,$alt="",$class=""); /** generates a temporary key with 12h validation for the current URL */ function previsu_cle_temporaire($date=null); /** checks if a 12h temporary key is valid */ function previsu_verifier_cle_temporaire($cle); function _T_ou_typo($valeur, $mode_typo='toujours') ; function spip_array_insert($arr1, $cle, $arr2, $avant=false); function array_replace_recursive($array, $array1); function recurse($array, $array1); /** Truncates a string to the desired length, without harming HTML markup and, with options : end text if cut, cut to exact length or, respecting words... */ function text_truncate($text, $length = 100, $options = array()) /** return an array, containing every value in any column of any bi-dimensional table (possibly along values of another column, as an index) */ function array_column($input = null, $columnKey = null, $indexKey = null);</code></pre></div> <p><strong>filtre text_truncate</strong><br class='autobr' /> <code class='php spip_code spip_code_inline' dir='ltr'>function text_truncate($text, $length = 100, $options = array()); </code></p> <p>The options array can contain several couples of key/value: <br />- 'ending' => string added at the end of the text, if it has to be cut. Basically, it'll be '...' or 'read more'. <br />- 'exact' => a boolean defining if it's to be cut at the exact provided length, even if it's in the middle of a word or, just before that last word. <br />- 'html' => a boolean defining if text contains any HTML tags that are not to be cut incorrectly.</p> <h2 class="h2" id='array_column-function'>array_column function<a class='sommaire-back sommaire-back-4' href='#s-array_column-function' title='Back to the table of contents'></a></h2> <p>Loads the PHP 5.5 function <a href="http://php.net/manual/fr/function.array-column.php" class="spip_out" rel="external">array_column</a> for older versions.</p> <p>Read more : <a href='https://contrib.spip.net/Array_column-pour-SPIP' class="spip_in" hreflang="fr">Array_column pour SPIP</a></p> <h2 class="h2" id='Renamed'>Renamed<a class='sommaire-back sommaire-back-4' href='#s-Renamed' title='Back to the table of contents'></a></h2> <p>- <code class='spip_code spip_code_inline' dir='ltr'>|aoustrong</code> filter is gone : it became <code class='spip_code spip_code_inline' dir='ltr'>|lien_ou_expose</code> and was incorporated to SPIP.</p></div> <div class='rss_ps'><p><strong>Refer to </strong> <a href="https://zone.spip.org/trac/spip-zone/changeset/28174" class="spip_out" rel="external">the documentation of the commit</a>.</p></div> </article> <article> <h1>Bonux pour SPIP3</h1> <p>JLuc — 2015-01-28T09:48:09Z</p> <div class='rss_chapo'><p>Nombre des fonctionnalités apportées par SPIP Bonux ont été intégrées dans SPIP3, mais il en reste quelques unes qui ne l'ont pas été, et qui constituent le nouveau plugin Bonux pour SPIP3.</p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-5" id="nav6a60d14a752315.76990734"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Balises-et-criteres-de-boucles"></a><a href="#Balises-et-criteres-de-boucles" class="spip_ancre">Balises et critères de boucles</a></li><li> <a id="s-Fonctions-php"></a><a href="#Fonctions-php" class="spip_ancre">Fonctions php</a></li><li> <a id="s-fonction-array_column"></a><a href="#fonction-array_column" class="spip_ancre">fonction array_column</a></li><li> <a id="s-Renommes"></a><a href="#Renommes" class="spip_ancre">Renommés</a></li><li> <a id="s-Relecture-temporaire"></a><a href="#Relecture-temporaire" class="spip_ancre">Relecture temporaire</a></li></ul></div><p>Cet article a pour but de lister les balises, critères et fonctions définies dans SPIP Bonux, afin qu'on ne les oublie pas, mais la documentation de ces éléments ne figure pas ici (voir pour cela les autres articles de <a href='https://contrib.spip.net/SPIP-Bonux-1146' class="spip_in" hreflang="fr">documentation de Spip Bonux</a>, ou le <a href="https://zone.spip.org/trac/spip-zone/browser/_plugins_/spip-bonux-2" class="spip_out" rel="external">code source</a>).</p> <p>Rq : Pour éviter les conflits, certaines de ces fonctionnalités ne sont définies par Bonux que si elles ne sont pas déjà définies par ailleurs.</p> <h2 class="h2" id='Balises-et-criteres-de-boucles'>Balises et critères de boucles<a class='sommaire-back sommaire-back-5' href='#s-Balises-et-criteres-de-boucles' title='Back to the table of contents'></a></h2> <p><strong>Balises</strong></p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>#SET_PUSH Empile un élément dans un tableau déclaré par #SET{tableau,#ARRAY} #SET_MERGE #COMPTEUR #SOMME #COMPTE #MOYENNE #MINIMUM #MAXIMUM #STATS</code></pre></div> <p>Les balises #COMPTEUR, #COMPTE, #SOMME, #MOYENNE, #MINIMUM, #MAXIMUM, #STATS requièrent l'usage d'un critère qui spécifie le champ sur lequel porte le calcul de la balise.</p> <p>Contrairement au critère <code class='spip_code spip_code_inline' dir='ltr'>{compteur table}</code>, ces critères ne calculent pas de jointures.</p> <p><strong>Exemples d'usage : </strong></p> <p>- #SET_PUSH :<br class='autobr' /> <code class='spip spip_code spip_code_inline' dir='ltr'>#SET_PUSH{tableau,valeur}</code></p> <p><strong>Critères statistiques</strong></p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code>{compteur} {compteur_left} {somme} {compte} {moyenne} {minimum} {maximum} {stats}</code></pre></div> <p><strong>Exemples d'usage</strong></p> <p>- Supposons qu'un champ 'distance' ait été ajouté aux objets ARTICLE.<br class='autobr' /> La boucle suivante calcule la somme des distances des articles de la rubrique 1 :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_a(ARTICLES){id_rubrique=1}{somme distance}></BOUCLE_a> #SOMME{distance} </B_a></code></pre></div> <p>- Dans le plugin <a href="http://plugins.spip.net/abonnement.html" class="spip_out" rel="external">'abonnement'</a> le fichier '<a href="http://zone.spip.org/trac/spip-zone/browser/_plugins_/abonnement/branches/v0/prive/exec/abonnements_stats.html" class="spip_out" rel="external">abonnements_stats</a>' donne plusieurs exemples d'utilisation de ces critères.</p> <p>Par exemple :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_nombre(AUTEURS_ELARGIS_ABONNEMENTS){id_abonnement}{statut_paiement=ok}{somme montant}{compte montant}{fusion id_abonnement}> <td>#COMPTE{montant}</td> <td>[(#SOMME{montant}|number_format{2, ',', ' '}|replace{' ',' '})]</td> </BOUCLE_nombre></code></pre></div> <p><strong>Autre critère : fusion_supprimer</strong></p> <p><code class='spip spip_code spip_code_inline' dir='ltr'>{fusion_supprimer}</code> : ce critère supprime de la requête sql la condition <code class='spip_code spip_code_inline' dir='ltr'>GROUP BY</code> qui y est présente à cette étape de la compilation. Ce peut être utile pour s'affranchir d'un <code class='spip_code spip_code_inline' dir='ltr'>GROUP BY</code> ajouté par défaut par le compilateur SPIP lors d'une jointure et qui interfère. Il est ensuite possible d'y ajouter le critère d'une fusion désirée (cf <a href="https://core.spip.net/issues/3209" class="spip_out" rel="external">#3209</a>)</p> <p>Dans la boucle suivante il est nécessaire d'ajouter <code class='spip spip_code spip_code_inline' dir='ltr'>{fusion_supprimer}</code> pour obtenir la fusion sur les dates, car le compilateur ajoute ajoute automatiquement un <code class='spip_code spip_code_inline' dir='ltr'>GOUP BY id_article</code> pour la jointure de la table ARTICLES avec la table MOTS :</p> <div class="precode"><pre class='spip spip_code spip_code_block' dir='ltr' style='text-align:left;'><code><BOUCLE_facette_annee(ARTICLES){id_mot=27}{fusion_supprimer}{fusion YEAR(date)}> [(#DATE|annee)]<br /> </BOUCLE_facette_annee></code></pre></div> <p><strong>Depuis SPIP 4</strong>, ce critère n'est plus fourni par le plugin SPIP_Bonux mais par le noyau de SPIP. Voir <a href="https://www.spip.net/6626" class="spip_url spip_out auto" rel="nofollow external">https://www.spip.net/6626</a></p> <h2 class="h2" id='Fonctions-php'>Fonctions php<a class='sommaire-back sommaire-back-5' href='#s-Fonctions-php' title='Back to the table of contents'></a></h2> <p>Bonux définit aussi tout un ensemble de fonctions qui peuvent servir comme filtre, ou pour d'autres plugins.</p> <div class="precode"><pre data-language="php" class='spip_code spip_code_block language-php' dir='ltr' style='text-align:left;'><code>/** Récupérer les champs date_$suffixe et heure_$suffixe dans l'environnement, vérifier leur cohérence et les reformater */ function verifier_corriger_date_saisie($suffixe,$horaire,&$erreurs); /** Renvoie le charset d'une ligne à importer */ function importer_csv_importcharset($texte); /** Enlève les accents des clés sinon ca pose des problemes ... */ function importer_csv_nettoie_key($key); /** Lit un fichier csv et retourne un tableau si $head est true, la premiere ligne est utilisee en header pour générer un tableau associatif*/ function inc_importer_csv_dist($file, $head = false, $delim = ",", $enclos = '"', $len = 10000) ; /** Exporter un champ pour un export CSV */ function exporter_csv_champ($champ) ; /** Exporter une ligne complète au format CSV, avec délimiteur spécifié */ function exporter_csv_ligne($ligne, $delim = ',', $importer_charset = null) ; /** exporter au format CSV. $ressource est un array ou une ressource sql ouverte en lecture */ function inc_exporter_csv_dist($titre, $resource, $delim=',', $entetes = null,$envoyer = true); /** generer une balise img a partir d'un nom de fichier */ function tag_img($img,$alt="",$class=""); /** générer une clé temporaire valable 12h pour l'url courante */ function previsu_cle_temporaire($date=null); /** vérifier qu'une clé temporaire valable 12h est bien valable */ function previsu_verifier_cle_temporaire($cle); function _T_ou_typo($valeur, $mode_typo='toujours') ; function spip_array_insert($arr1, $cle, $arr2, $avant=false); function array_replace_recursive($array, $array1); function recurse($array, $array1); /** Coupe une chaine à la longueur demandée, sans abîmer les tags HTML , et avec options : texte de fin si coupé, coupe à la longueur exacte ou en respectant les mots... */ function text_truncate($text, $length = 100, $options = array()) /** retourner un tableau constitué de toutes les valeurs d'une colonne d'un tableau bi-dimensionnel (avec éventuellement les valeurs d'une autre colonne comme index) */ function array_column($input = null, $columnKey = null, $indexKey = null); </code></pre></div> <p><strong>filtre text_truncate</strong><br class='autobr' /> <code class='php spip_code spip_code_inline' dir='ltr'>function text_truncate($text, $length = 100, $options = array()); </code><br class='autobr' /> Le tableau d'options peut contenir plusieurs couples clé-valeur : <br />- 'ending' => la chaine ajoutée à la fin du texte s'il est coupé. Typiquement, c'est '...' ou 'lire la suite'. <br />- 'exact' => un booléen indiquant si la coupe se fait à la longueur indiquée exacte, même si c'est au milieu d'un mot, ou si la coupe se fait juste avant ce dernier mot. <br />- 'html' => un booléen indiquant si le texte contient des tags HTML qu'il faut veiller à ne pas couper incorrectement.</p> <h2 class="h2" id='fonction-array_column'>fonction array_column<a class='sommaire-back sommaire-back-5' href='#s-fonction-array_column' title='Back to the table of contents'></a></h2> <p>Charge la fonction <a href="http://php.net/manual/fr/function.array-column.php" class="spip_out" rel="external">array_column</a> de PHP 5.5 pour les versions inférieures.</p> <p>Lire le détail sur : <a href='https://contrib.spip.net/Array_column-pour-SPIP' class="spip_in" hreflang="fr">Array_column pour SPIP</a></p> <h2 class="h2" id='Renommes'>Renommés<a class='sommaire-back sommaire-back-5' href='#s-Renommes' title='Back to the table of contents'></a></h2> <p>- le filtre <code class='spip_code spip_code_inline' dir='ltr'>|aoustrong</code> a disparu : il est devenu <code class='spip_code spip_code_inline' dir='ltr'>|lien_ou_expose</code> et a été intégré dans SPIP : voir <a href="https://www.spip.net/4004" class="spip_url spip_out auto" rel="nofollow external">https://www.spip.net/4004</a></p> <h2 class="h2" id='Relecture-temporaire'>Relecture temporaire<a class='sommaire-back sommaire-back-5' href='#s-Relecture-temporaire' title='Back to the table of contents'></a></h2> <p>Le plugin active la possibilité de faire une “Relecture temporaire”, en ajoutant un bouton dans la barre d'administration dans la partie publique..<br class='autobr' /> Ce bouton fournit une adresse publique temporaire qui peut être partagée et permet la relecture de l'article sans à avoir à se connecter à SPIP. Cette adresse n'est valable que quelques heures.</p> <p>Voir aussi la contante <a href="https://www.spip.net/fr_article5673.html" class="spip_out" rel="external">_PREVIEW_TOKEN</a> gérée par le noyau de SPIP.</p></div> <div class='rss_ps'><p><strong>Voir</strong> <a href="https://zone.spip.org/trac/spip-zone/changeset/28174" class="spip_out" rel="external">la doc fournie lors du commit</a>.</p></div> </article> <article> <h1>BootStrap v2 for SPIP</h1> <p>rjadot — 2015-10-09T06:30:00Z</p> <div class='rss_chapo'><p>Documentation origin <a href="http://spipr.nursit.com/bootstrap" class="spip_url spip_out" hreflang="fr" rel="external">http://spipr.nursit.com/bootstrap</a></p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-13" id="nav6a60d14a782754.57750983"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Presentation"></a><a href="#Presentation" class="spip_ancre">Presentation</a></li><li> <a id="s-BootStrap-for-SPIP"></a><a href="#BootStrap-for-SPIP" class="spip_ancre">BootStrap for SPIP</a></li><li> <a id="s-Adaptation-to-the-SPIP-markup"></a><a href="#Adaptation-to-the-SPIP-markup" class="spip_ancre">Adaptation to the SPIP markup</a></li><li> <a id="s-Typography"></a><a href="#Typography" class="spip_ancre">Typography</a></li><li> <a id="s-grid"></a><a href="#grid" class="spip_ancre">grid</a></li><li> <a id="s-LESS"></a><a href="#LESS" class="spip_ancre">LESS</a></li><li> <a id="s-BootStrap-in-SPIPr"></a><a href="#BootStrap-in-SPIPr" class="spip_ancre">BootStrap in SPIPr</a></li><li> <a id="s-Demo-page"></a><a href="#Demo-page" class="spip_ancre">Demo page</a></li><li> <a id="s-Organization-of-files"></a><a href="#Organization-of-files" class="spip_ancre">Organization of files</a></li><li> <a id="s-LESS-sheets-overloads"></a><a href="#LESS-sheets-overloads" class="spip_ancre">LESS sheets overloads</a></li><li> <a id="s-Using-the-overloads"></a><a href="#Using-the-overloads" class="spip_ancre">Using the overloads</a></li><li> <a id="s-Images-in-LESS-sheets"></a><a href="#Images-in-LESS-sheets" class="spip_ancre">Images in LESS sheets</a></li><li> <a id="s-Resources"></a><a href="#Resources" class="spip_ancre">Resources</a></li></ul></div><h2 id='Presentation'>Presentation<a class='sommaire-back sommaire-back-13' href='#s-Presentation' title='Back to the table of contents'></a></h2> <p><a href="https://github.com/twbs/bootstrap" class="spip_out" hreflang="en" rel="external">BootStrap</a> is a framework which facilitates and accelerates the front-end development. It includes</p> <ul class="spip" role="list"><li> A very complete CSS base (in LESS format) configured from variables files;</li><li> a set of conventions of HTML structure and classes naming;</li><li> simple Javascripts libraries for the most common functions.</li></ul> <p>BootStrap has a <a href="http://getbootstrap.com/2.3.2/" class="spip_out" hreflang="en" rel="external">detailed documentation</a> which facilitates its handling.</p> <h2 id='BootStrap-for-SPIP'>BootStrap for SPIP<a class='sommaire-back sommaire-back-13' href='#s-BootStrap-for-SPIP' title='Back to the table of contents'></a></h2> <p>A plugin <a href="http://plugins.spip.net/bootstrap" class="spip_out" rel="external">BootStrap</a> for SPIP facilitates the integration of <strong>BootStrap v2</strong>. The plugin includes all the CSS of BootStrap (v2.3.2) and adds to them a layer of adaptation to SPIP.</p> <h2 class="h2" id='Adaptation-to-the-SPIP-markup'>Adaptation to the SPIP markup<a class='sommaire-back sommaire-back-13' href='#s-Adaptation-to-the-SPIP-markup' title='Back to the table of contents'></a></h2> <p>The plugin integrates the CSS of BootStrap without modification, but adds to it an adaptation layer to the HTML generated by SPIP. So, the SPIP forms which use a HTML markup different from the one proposed by BootStrap benefit all the same from the styles of BootStrap. If you add your own forms, you can use as well the markup of BootStrap or the one of the SPIP, according to your habits.</p> <p>Tables generated by SPIP from the editorial contents also inherit the styles of BootStrap.</p> <p>Furthermore, the plugin adapts the the pagination markup of SPIP so that it benefits from styles of BootStrap.</p> <h2 class="h2" id='Typography'>Typography<a class='sommaire-back sommaire-back-13' href='#s-Typography' title='Back to the table of contents'></a></h2> <p>The typography natively proposed by SPIP in its default template is better than that the BootStrap one. It's also more accessible as it's implemented in <code class='spip_code spip_code_inline' dir='ltr'>em</code> and not <code class='spip_code spip_code_inline' dir='ltr'>px</code>.<br class='autobr' /> The BootStrap for SPIP plugin thus takes back typography of SPIP for these reasons.</p> <h2 class="h2" id='grid'>grid<a class='sommaire-back sommaire-back-13' href='#s-grid' title='Back to the table of contents'></a></h2><div class='spip_document_13111 spip_document spip_documents spip_document_image spip_documents_right spip_document_right'> <figure class="spip_doc_inner"> </figure> </div> <p>The plugin BootStrap for SPIP also the integrates <a href="http://hashgrid.com/" class="spip_out" hreflang="en" rel="external">#grid</a> display tool. It allows the webmasters to display the currently used grid. It's configured to settle by default on the 3 BootStrap grids (according to the screen width) and you can use it thus directly.</p> <h2 class="h2" id='LESS'> LESS<a class='sommaire-back sommaire-back-13' href='#s-LESS' title='Back to the table of contents'></a></h2><div class='spip_document_13112 spip_document spip_documents spip_document_image spip_documents_right spip_document_right'> <figure class="spip_doc_inner"> </figure> </div> <p>To allow to work directly in style sheets in LESS format without passing by a stage of manual compilation, the plugin BootStrap requires the plugin <a href="http://plugins.spip.net/lesscss" class="spip_out" rel="external">LessCSS</a> for SPIP' which automatically compiles LESS sheets in CSS on the fly.</p> <h2 id='BootStrap-in-SPIPr'>BootStrap in SPIPr<a class='sommaire-back sommaire-back-13' href='#s-BootStrap-in-SPIPr' title='Back to the table of contents'></a></h2> <p>All the BootStrap styles are included in the pages of the SPIPr template, it is thus possible to use the whole markup proposed in the BootStrap documentation and to benefit from its styles and scaffolding.<br class='autobr' /> In the case of forms, it is possible also to use the <a href="http://www.spip.net/fr_article3791.html" class="spip_out" hreflang="en" rel="external">tagging convention</a> proposed in SPIP, which is entirely managed by the adaptation of BootStrap to SPIP.</p> <p>On the other hand, most of the <a href="http://twitter.github.com/bootstrap/javascript.html" class="spip_out" hreflang="en" rel="external">Javascripts of BootStrap</a> are not integrated by default and you will thus have to add them in your templates to use the corresponding features of BootStrap.</p> <h2 id='Demo-page'>Demo page<a class='sommaire-back sommaire-back-13' href='#s-Demo-page' title='Back to the table of contents'></a></h2> <p>The plugin BootStrap for SPIP integrates several demo pages <code class='spip_code spip_code_inline' dir='ltr'>demo/</code> directory.</p> <p>The main demo page is visible at the <code class='spip_code spip_code_inline' dir='ltr'>spip.php?page=demo/bootstrap</code><span class="spip_note_ref"> [<a href="#nb38-1" class="spip_note" rel="appendix" title="You must have the webmaster statute to see this page" id="nh38-1">1</a>]</span>. This page displays all the elements of interface managed by BootStrap, as well as a typographic charter which allows to verify the display of all the usual typographic enrichments.</p> <div class='spip_document_13113 spip_document spip_documents spip_document_image spip_documents_center spip_document_center spip_document_avec_legende' data-legende-len="21" data-legende-lenx="" > <figure class="spip_doc_inner"> <figcaption class='spip_doc_legende'> <div class='spip_doc_titre crayon document-titre-13113 '><strong>BootStrap demo page </strong></div> </figcaption></figure> </div><h2 id='Organization-of-files'>Organization of files<a class='sommaire-back sommaire-back-13' href='#s-Organization-of-files' title='Back to the table of contents'></a></h2> <p>The plugin BootStrap for SPIP is organized in two under files(cases) bootstrap / and bootstrap2spip/:</p> <p>bootstrap/ et bootstrap2spip/ :</p> <ul class="spip" role="list"><li> bootstrap/ <ul class="spip" role="list"><li> <strong>bootstrap</strong>/ <ul class="spip" role="list"><li> <strong>css</strong>/ <ul class="spip" role="list"><li> BootStrap LESS files</li></ul></li><li> <strong>img</strong>/ <ul class="spip" role="list"><li> BootStrap glyphicons images</li></ul></li><li> <strong>js</strong>/ <ul class="spip" role="list"><li> BootStrap javascripts files</li></ul></li></ul></li><li> <strong>bootstrap2spip</strong>/ Overloads the Bootstrap files <ul class="spip" role="list"><li> <strong>css</strong>/ <ul class="spip" role="list"><li> </li><li> <strong>boot-theme.less</strong> empty file available for customization</li><li> <strong>bootswatch.less</strong> empty file available for customization</li><li> <strong>spip.css</strong> Some styles for the code generated by SPIP</li><li> <strong>spip.list.less</strong> styles of the lists module</li><li> <strong>spip.comment.less</strong> styles of comments</li></ul></li><li> <strong>formulaires</strong>/ <ul class="spip" role="list"><li> <strong>charter.html</strong> SPIP demo form</li><li> <strong>recherche.html</strong> SPIP search form adapted to BootStrap</li></ul></li><li> <strong>js</strong>/ <ul class="spip" role="list"><li> <strong>hashgrid.js</strong> #grid</li><li> <strong>html5.js</strong> HTML5 support for old browsers</li></ul></li><li> <strong>modeles</strong>/ <ul class="spip" role="list"><li> SPIP pagination templates adapted to BootStrap</code></li></ul></li></ul></li></ul></li></ul><h2 id='LESS-sheets-overloads'>LESS sheets overloads<a class='sommaire-back sommaire-back-13' href='#s-LESS-sheets-overloads' title='Back to the table of contents'></a></h2> <p>The <i>bootstrap2spip/</i> directory contains LESS style sheets which overload those of BootStrap. Let us see a concrete example with the sheet <i>alerts.less</i>:</p> <div class="precode"><pre data-language="css" class='spip_code spip_code_block language-css' dir='ltr' style='text-align:left;'><code>/* importer la feuille d'origine de BootStrap */ @import "bootstrap/css/alerts.less"; /* Ajout des classes info, success, warning, error utilisées dans SPIP */ .info {.alert; .alert-info;} .success {.alert; .alert-success;} .warning {.alert;} .error {.alert;.alert-error}</code></pre></div> <p>Here we see that the overloads for SPIP completely uses the native BootStrap file by simply adding to it some definitions which inherit from BootStrap. It is the case of most of the overloading files in <i>bootstrap2spip/</i> with the exception of the typography completely taken back by SPIP.</p> <h2 class="h2" id='Using-the-overloads'>Using the overloads<a class='sommaire-back sommaire-back-13' href='#s-Using-the-overloads' title='Back to the table of contents'></a></h2> <p>During the compilation of the LESS files, the plugin <a href="http://plugins.spip.net/lesscss" class="spip_out" rel="external">LessCSS</a> interprets each <code class='spip_code spip_code_inline' dir='ltr'>@import</code> directive by searching the file in the SPIP path, including plugins and <i>squelettes/</i> direcory.</p> <p>So, if you write <code class='spip_code spip_code_inline' dir='ltr'>@import "css/alerts.less"</code>, SPIP is going to look for the file <i>css/alerts.less</i> in <i>squelettes/</i> then in all the directories declared by the plugins.<br class='autobr' /> In the BootStrap plugin, the search will be made at first in the <i>bootstrap2spip/</i> diretory to see if a specific overload for SPIP exists, then in <i>bootstrap/</i> to take the native BootStrap files otherwise.</p> <p>You can thus customize finely the overloads of BootStrap in the following way:</p> <p>For example:</p> <ul class="spip" role="list"><li> You can cancel the adaptation to SPIP for the file css / alerts.css by putting the contents following in skeletons / css / alerts.css: <div class="precode"><pre data-language="css" class='spip_code spip_code_block language-css' dir='ltr' style='text-align:left;'><code>/* importer la feuille d'origine de BootStrap */ @import "bootstrap/css/alerts.less";</code></pre></div></li><li> vous pouvez compléter l'adaptation à SPIP avec vos propres compléments. Pour le fichier css/alerts.css, en mettant le contenu suivant dans squelettes/css/alerts.css : <div class="precode"><pre data-language="css" class='spip_code spip_code_block language-css' dir='ltr' style='text-align:left;'><code>/* importer la feuille adaptée à SPIP */ @import "bootstrap2spip/css/alerts.less"; /* mes ajouts */ ...</code></pre></div></li></ul> <p>In a general way, you should avoid overloading BootStrap LESS files to benefit from updates of these files during the update of the plugin.</p> <p>For your site customization, it's better to use 2 files <i>css/boot-theme.less</i> and <i>css/bootswatch.less</i> which were added and are empty by default. They allow to add customizations of BootStrap CSS, which will be compiled with the set of BootStrap files (which allows to use all the BootStrap mixins).</p> <h2 id='Images-in-LESS-sheets'>Images in LESS sheets<a class='sommaire-back sommaire-back-13' href='#s-Images-in-LESS-sheets' title='Back to the table of contents'></a></h2> <p>A point to which it is necessary to pay attention with LESS is about the relative ways towards the decoration images: the functioning is different from what we can be used in CSS sheets.</p> <p>In a CSS sheet, if you use the code <code class='spip_code spip_code_inline' dir='ltr'>url(../img/deco.png)</code> the relative way <i>/img/deco.png</i> is interpreted with regard to the location of the CSS file.</p> <p>In a LESS sheet, with the same code, the relative way is interpreted with regard to the location of the main compiled LESS file. It makes an important difference when the directive <code class='spip_code spip_code_inline' dir='ltr'>@import</code> is used.<br class='autobr' /> Indeed, in this case it is always the location of the main file, the one who makes <code class='spip_code spip_code_inline' dir='ltr'>@import</code>, which is taken in reference, and not the location of included files, even if it is the which references the image.</p> <p>In the case of BootStrap, it means that it is the location of the file <i>bootstrap.less</i> that is taken into account. So, to use an image in a customized BootStrap LESS file, it is advisable to give a relative way with regard to the file <i>bootstrap.less</i>.</p> <p>The solution consists then in copying the file <i>bootstrap.less</i> in your <i>squelettes/</i>, folder next to your customized file, without forgetting to also copy there the <i>img/</i> folder with glyphicons. It is rather impractical, and in a general way it is avoidable by adding the images of decoration in a LESS file which is not included by bootstrap.less but directly by the SPIPr template.</p> <h2 id='Resources'>Resources<a class='sommaire-back sommaire-back-13' href='#s-Resources' title='Back to the table of contents'></a></h2> <p>An indicative and not exhaustive list of tools usable as a supplement to BootStrap to generate themes, build mockup<span class="spip_note_ref"> [<a href="#nb38-2" class="spip_note" rel="appendix" title="take care about the BootStrap version which are supported by these tools: if (…)" id="nh38-2">2</a>]</span></p> <ul class="spip" role="list"><li> <a href="http://bootswatch.com/" class="spip_url spip_out auto" rel="nofollow external">http://bootswatch.com/</a></li><li> <a href="https://wrapbootstrap.com/themes" class="spip_url spip_out auto" rel="nofollow external">https://wrapbootstrap.com/themes</a></li><li> <a href="http://jetstrap.com/" class="spip_url spip_out auto" rel="nofollow external">http://jetstrap.com/</a> un outil de Mockup en ligne pour BootStrap</li><li> <a href="http://stylebootstrap.info/" class="spip_url spip_out auto" rel="nofollow external">http://stylebootstrap.info/</a></li><li> <a href="http://www.boottheme.com/" class="spip_url spip_out auto" rel="nofollow external">http://www.boottheme.com/</a></li><li> <a href="http://bootswatchr.com/" class="spip_url spip_out auto" rel="nofollow external">http://bootswatchr.com/</a></li><li> <a href="http://www.lavishbootstrap.com/" class="spip_url spip_out auto" rel="nofollow external">http://www.lavishbootstrap.com/</a></li></ul></div> <hr /> <div class='rss_notes'><div id="nb38-1"> <p><span class="spip_note_ref">[<a href="#nh38-1" class="spip_note" title="Footnotes 38-1" rev="appendix">1</a>] </span>You must have the webmaster statute to see this page</p> </div><div id="nb38-2"> <p><span class="spip_note_ref">[<a href="#nh38-2" class="spip_note" title="Footnotes 38-2" rev="appendix">2</a>] </span>take care about the BootStrap version which are supported by these tools: if it is an older version that the one used by SPIPr, some variables may be lacking in the generated sheets</p> </div></div> </article> <article> <h1>BootStrap v2 pour SPIP</h1> <p>Cerdic, Stéphane Santon — 2015-03-18T09:00:00Z</p> <div class='rss_chapo'><p>Documentation source <a href="http://spipr.nursit.com/bootstrap" class="spip_url spip_out auto" rel="nofollow external">http://spipr.nursit.com/bootstrap</a></p></div> <div class='rss_texte'><div class="well nav-sommaire nav-sommaire-14" id="nav6a60d14a7b3318.75382801"> <h2>Table of contents</h2><ul class="spip" role="list"><li> <a id="s-Presentation"></a><a href="#Presentation" class="spip_ancre"><span>Présentation</span></a></li><li> <a id="s-BootStrap-pour-SPIP"></a><a href="#BootStrap-pour-SPIP" class="spip_ancre"><span>BootStrap pour <span class="caps">SPIP</span></span></a> <ul class="spip" role="list"><li> <a id="s-Adaptation-au-markup-de-SPIP"></a><a href="#Adaptation-au-markup-de-SPIP" class="spip_ancre">Adaptation au markup de <span class="caps">SPIP</span></a></li><li> <a id="s-Typographie"></a><a href="#Typographie" class="spip_ancre">Typographie</a></li><li> <a id="s-grid"></a> <a href="#grid" class="spip_ancre"> <p>#grid</p> <dl class='spip_document_19 spip_documents spip_documents_right' style='float:right;'> <dt></dt> </dl></a> </li><li> <a id="s-LESS"></a> <a href="#LESS" class="spip_ancre"> <p><span class="caps">LESS</span></p> <dl class='spip_document_17 spip_documents spip_documents_right' style='float:right;'> <dt></dt> </dl></a> </li></ul></li><li> <a id="s-BootStrap-dans-SPIPr"></a><a href="#BootStrap-dans-SPIPr" class="spip_ancre"><span>BootStrap dans SPIPr</span></a></li><li> <a id="s-Page-de-demonstration"></a><a href="#Page-de-demonstration" class="spip_ancre"><span>Page de démonstration</span></a></li><li> <a id="s-Organisation-des-fichiers"></a><a href="#Organisation-des-fichiers" class="spip_ancre"><span>Organisation des fichiers</span></a></li><li> <a id="s-Surcharges-des-feuilles-LESS"></a><a href="#Surcharges-des-feuilles-LESS" class="spip_ancre"><span>Surcharges des feuilles <span class="caps">LESS</span></span></a> <ul class="spip" role="list"><li> <a id="s-Utiliser-la-surcharge"></a><a href="#Utiliser-la-surcharge" class="spip_ancre">Utiliser la surcharge</a></li></ul></li><li> <a id="s-Images-dans-les-feuilles-LESS"></a><a href="#Images-dans-les-feuilles-LESS" class="spip_ancre"><span>Images dans les feuilles <span class="caps">LESS</span></span></a></li><li> <a id="s-Ressources"></a><a href="#Ressources" class="spip_ancre"><span>Ressources</span></a></li><li> <a id="s-Notes"></a><a href="#Notes" class="spip_ancre">Notes</a></li></ul></div><section class="rubrique rubrique2"> <article class="article article2" id="presentation"> <header class="article-header"> <h2 id='Presentation'><span>Présentation</span><a class='sommaire-back sommaire-back-14' href='#s-Presentation' title='Back to the table of contents'></a></h2> </header> <div class="main article-main"> <div class="crayon article-texte-2 texte surlignable"><dl class='spip_document_29 spip_documents spip_documents_right' style='float:right;'> <dt></dt> </dl> <p><a href="https://github.com/twbs/bootstrap" class='spip_out' rel='external'>BootStrap</a> est un framework qui facilite et accélère le développement Front-End. Il inclue</p> <ul class="spip"><li> une base <span class="caps">CSS</span> très complète (au format <span class="caps">LESS</span>) configurée à partir d'un fichier de variables</li><li> un ensemble de conventions de structure <span class="caps">HTML</span> et de nommage de classes</li><li> des librairies javascripts simples pour les fonctions les plus courantes</li></ul> <p>BootStrap dispose d'une <a href="http://getbootstrap.com/2.3.2/" class='spip_out' rel='external'>documentation détaillée</a> qui facilite sa prise en main.</p></div> </div> </article> <article class="article article3" id="bootstrappourspanclasscapsspipspan"> <header class="article-header"> <h2 id='BootStrap-pour-SPIP'><span>BootStrap pour <span class="caps">SPIP</span></span><a class='sommaire-back sommaire-back-14' href='#s-BootStrap-pour-SPIP' title='Back to the table of contents'></a></h2> </header> <div class="main article-main"> <div class="crayon article-texte-3 texte surlignable"><p>Un plugin <a href="http://plugins.spip.net/bootstrap" class='spip_out' rel='external'>BootStrap</a> pour <span class="caps">SPIP</span> facilite l'intégration de <strong>BootStrap v2</strong>. Le plugin intègre toutes les <span class="caps">CSS</span> de BootStrap (v2.3.2) et y ajoute une couche d'adaptation à <span class="caps">SPIP</span>.</p> <h3 class="spip" id='Adaptation-au-markup-de-SPIP'>Adaptation au markup de <span class="caps">SPIP</span><a class='sommaire-back sommaire-back-14' href='#s-Adaptation-au-markup-de-SPIP' title='Back to the table of contents'></a></h3> <p>Le plugin intègre les <span class="caps">CSS</span> de BootStrap sans modification, mais y ajoute une couche d'adaptation au <span class="caps">HTML</span> générée par <span class="caps">SPIP</span>. Ainsi, les formulaires de <span class="caps">SPIP</span> qui utilisent un markup <span class="caps">HTML</span> différent de celui proposé par BootStrap bénéficient tout de même des styles de BootStrap. Si vous ajoutez vos propres formulaires, vous pouvez aussi bien utiliser le markup de BootStrap ou celui de <span class="caps">SPIP</span>, selon vos habitudes.</p> <p>Les tableaux générés par <span class="caps">SPIP</span> à partir du contenu éditorial héritent aussi des styles de BootStrap.</p> <p>De plus le plugin adapte le markup de la pagination de <span class="caps">SPIP</span> pour qu'elle bénéficie des styles de BootStrap.</p> <h3 class="spip" id='Typographie'>Typographie<a class='sommaire-back sommaire-back-14' href='#s-Typographie' title='Back to the table of contents'></a></h3> <p>La typographie proposée nativement par <span class="caps">SPIP</span> dans son squelette par défaut est de meilleure facture que celle de BootStrap. Elle est également plus accessible car implémentée en <code class='spip_code' dir='ltr'>em</code> et non en <code class='spip_code' dir='ltr'>px</code>.<br class='autobr' /> Le plugin BootStrap pour <span class="caps">SPIP</span> reprend donc la partie typographie de <span class="caps">SPIP</span> pour ces raisons.</p> <h3 class="spip" id='grid'>#grid<dl class='spip_document_19 spip_documents spip_documents_right' style='float:right;'> <dt></dt> </dl><a class='sommaire-back sommaire-back-14' href='#s-grid' title='Back to the table of contents'></a></h3> <p>Le plugin BootStrap pour <span class="caps">SPIP</span> intègre également l'outil de visualisation de la grille <a href="http://hashgrid.com/" class='spip_out' rel='external'>#grid</a>. Il permet aux webmestres d'afficher la grille utilisée. Il est configuré pour se caler par défaut sur les 3 grilles de BootStrap (en fonction de la largeur de l'écran) et vous pouvez donc directement l'utiliser.</p> <h3 class="spip" id='LESS'><span class="caps">LESS</span><dl class='spip_document_17 spip_documents spip_documents_right' style='float:right;'> <dt></dt> </dl><a class='sommaire-back sommaire-back-14' href='#s-LESS' title='Back to the table of contents'></a></h3> <p>Pour permettre de travailler directement dans les feuilles de styles au format <span class="caps">LESS</span> sans passer par une étape de compilation manuelle, le plugin BootStrap nécessite le plugin <a href="http://plugins.spip.net/lesscss" class='spip_out' rel='external'>LessCSS</a> pour <span class="caps">SPIP</span> qui se charge de compiler automatiquement à la volée les feuilles <span class="caps">LESS</span> au format <span class="caps">CSS</span>.</p></div> </div> </article> <article class="article article27" id="bootstrapdansspipr"> <header class="article-header"> <h2 id='BootStrap-dans-SPIPr'><span>BootStrap dans SPIPr</span><a class='sommaire-back sommaire-back-14' href='#s-BootStrap-dans-SPIPr' title='Back to the table of contents'></a></h2> </header> <div class="main article-main"> <div class="crayon article-texte-27 texte surlignable"><p>Tous les styles de BootStrap sont inclus dans les pages du squelette SPIPr, et il est donc possible d'utiliser l'ensemble du markup proposé dans la documentation de BootStrap et de bénéficier des styles et affichages prévus. <br class='autobr' /> Dans le cas des formulaires, il est possible aussi d'utiliser la <a href="http://www.spip.net/fr_article3791.html" class='spip_out' rel='external'>convention de balisage</a> proposée dans <span class="caps">SPIP</span>, qui est intégralement prise en charge par l'adaptation de BootStrap à <span class="caps">SPIP</span>.</p> <p>En revanche, la plupart des <a href="http://twitter.github.com/bootstrap/javascript.html" class='spip_out' rel='external'>javascripts de BootStrap</a> ne sont pas intégrés par défaut et vous devrez donc les ajouter dans vos squelettes pour utiliser les fonctionnalités correspondantes de BootStrap.</p></div> </div> </article> <article class="article article23" id="pagededemonstration"> <header class="article-header"> <h2 id='Page-de-demonstration'><span>Page de démonstration</span><a class='sommaire-back sommaire-back-14' href='#s-Page-de-demonstration' title='Back to the table of contents'></a></h2> </header> <div class="main article-main"> <div class="crayon article-texte-23 texte surlignable"><p>Le plugin BootStrap pour <span class="caps">SPIP</span> intègre plusieurs pages de démonstration dans le dossier <tt>demo/</tt>.</p> <p>La page principale de démonstration est visible à l'adresse <code class='spip_code' dir='ltr'>spip.php?page=demo/bootstrap</code><span class="spip_note_ref"> [<a href='#nb1' class='spip_note' rel='footnote' title='il faut avoir le statut de webmestre pour voir cette page' id='nh1'>1</a>]</span>. Cette page reprend tous les éléments d'interface pris en charge par BootStrap, ainsi qu'une charte typographique qui permet de vérifier l'affichage de tous les enrichissements typographiques usuels.</p> <dl class='spip_document_58 spip_documents spip_documents_center'> <dt><a href="http://spipr.nursit.com/?page=demo1" class="spip_out" title='PNG - 68.2 ko'></a></dt> <dt class='crayon document-titre-58 spip_doc_titre' style='width:350px;'><strong>Page de démonstration du plugin BootStrap</strong></dt> </dl></div> </div> </article> <article class="article article24" id="organisationdesfichiers"> <header class="article-header"> <h2 id='Organisation-des-fichiers'><span>Organisation des fichiers</span><a class='sommaire-back sommaire-back-14' href='#s-Organisation-des-fichiers' title='Back to the table of contents'></a></h2> </header> <div class="main article-main"> <div class="crayon article-texte-24 texte surlignable"><p>Le plugin BootStrap pour <span class="caps">SPIP</span> est organisé en deux sous dossiers <tt>bootstrap/</tt> et <tt>bootstrap2spip/</tt> :</p> <pre> <i class="icon-folder-open"></i> bootstrap/ <i class="icon-folder-open"></i> <strong>bootstrap/</strong> <i class="icon-folder-open"></i> <strong>css/</strong> <i class="icon-file"></i> <i>fichiers <span class="caps">LESS</span> de BootStrap</i> <i class="icon-folder-open"></i> <strong>img/</strong> <i class="icon-file"></i> <i>images glyphicons de BootStrap</i> <i class="icon-folder-open"></i> <strong>js/</strong> <i class="icon-file"></i> <i>fichiers javascripts de BootStrap</i> <i class="icon-folder-open"></i> <strong>bootstrap2spip/</strong> <i class="icon-folder-open"></i> <strong>css/</strong> <i class="icon-file"></i> <i>surcharges des fichiers <span class="caps">LESS</span> de BootStrap</i> <i class="icon-file"></i> <strong>boot-theme.less</strong> <i>feuille vide dispo pour la personnalisation</i> <i class="icon-file"></i> <strong>bootswatch.less</strong> <i>feuille vide dispo pour la personnalisation</i> <i class="icon-file"></i> <strong>spip.css</strong> <i>quelques styles spécifiques au code généré par <span class="caps">SPIP</span></i> <i class="icon-file"></i> <strong>spip.list.less</strong> <i>styles du module de liste</i> <i class="icon-file"></i> <strong>spip.comment.less</strong> <i>styles des commentaires</i> <i class="icon-folder-open"></i> <strong>formulaires/</strong> <i class="icon-file"></i> <strong>charter.html</strong> <i>formulaire <span class="caps">SPIP</span> de démonstration</i> <i class="icon-file"></i> <strong>recherche.html</strong> <i>formulaire de recherche <span class="caps">SPIP</span> adapté à BootStrap</i> <i class="icon-folder-open"></i> <strong>js/</strong> <i class="icon-file"></i> <strong>hashgrid.js</strong> <i>#grid</i> <i class="icon-file"></i> <strong>html5.js</strong> <i>support de <span class="caps">HTML5</span> pour les vieux navigateurs</i> <i class="icon-folder-open"></i> <strong>modeles/</strong> <i class="icon-file"></i> <i>modèles de pagination <span class="caps">SPIP</span> adaptés à BootStrap</i> </pre></div> </div> </article> <article class="article article25" id="surchargesdesfeuillesspanclasscapslessspan"> <header class="article-header"> <h2 id='Surcharges-des-feuilles-LESS'><span>Surcharges des feuilles <span class="caps">LESS</span></span><a class='sommaire-back sommaire-back-14' href='#s-Surcharges-des-feuilles-LESS' title='Back to the table of contents'></a></h2> </header> <div class="main article-main"> <div class="crayon article-texte-25 texte surlignable"><p>Le dossier <tt>bootstrap2spip/</tt> contient des feuilles de style <span class="caps">LESS</span> qui surchargent celles de BootStrap. Voyons un exemple concret avec la feuille <tt>alerts.less</tt> :</p> <textarea readonly='readonly' cols='40' rows='8' class='spip_cadre' dir='ltr'>/* importer la feuille d'origine de BootStrap */ @import "bootstrap/css/alerts.less"; /* Ajout des classes info, success, warning, error utilisées dans SPIP */ .info {.alert; .alert-info;} .success {.alert; .alert-success;} .warning {.alert;} .error {.alert;.alert-error}

Ici on voit que la surcharge pour SPIP utilise complètement le fichier natif de BootStrap en lui ajoutant simplement quelques définitions qui héritent de BootStrap. C'est le cas de la plupart des surcharges du dossier bootstrap2spip/ à l'exception de la typographie complètement reprise de SPIP.

 Utiliser la surcharge
 Lors de la compilation des fichiers LESS, le plugin LessCSS interprète chaque directive @import en recherchant le fichier demandé dans le chemin de SPIP, incluant les plugins et le dossier squelettes/.
 Ainsi, si vous écrivez @import "css/alerts.less", SPIP va rechercher le fichier css/alerts.less dans squelettes/ puis dans tous les dossiers déclarés par les plugins. 
 Dans le plugin BootStrap, la recherche se fera d'abord dans le dossier bootstrap2spip/ pour voir si une surcharge spécifique à SPIP existe, puis dans bootstrap/ pour prendre le fichier natif de BootStrap sinon.
 Vous pouvez donc personnaliser finement les surcharges de BootStrap de la façon suivante :
 Par exemple
  vous pouvez annuler l'adaptation à SPIP pour le fichier css/alerts.css en mettant le contenu suivant dans squelettes/css/alerts.css : /* importer la feuille d'origine de BootStrap */ @import "bootstrap/css/alerts.less";
 vous pouvez compléter l'adaptation à SPIP avec vos propres compléments. Pour le fichier css/alerts.css, en mettant le contenu suivant dans squelettes/css/alerts.css : /* importer la feuille adaptée à SPIP */ @import "bootstrap2spip/css/alerts.less"; /* mes ajouts */ ...
 De manière générale, il faut éviter de surcharger des fichiers LESS de BootStrap pour bénéficier des mises à jour de ces fichiers lors de la mise à jour du plugin.
 Pour la personnalisation de son site, il est préférable d'utiliser les 2 fichiers css/boot-theme.less et css/bootswatch.less qui ont été ajoutés et sont par défaut vides. Ils permettent d'ajouter des personnalisations CSS de BootStrap, qui seront compilées avec l'ensemble des feuilles de BootStrap (ce qui permet d'utiliser tous les mixins de BootStrap).

   Images dans les feuilles LESS
 
  Un point auquel il faut faire attention avec les feuilles LESS concerne les chemins relatifs vers les images de décoration : le fonctionnement est différent de ce qu'on peut avoir l'habitude dans les feuilles CSS.
 Dans une feuille CSS, si on utilie le code url(../img/deco.png) le chemin relatif ../img/deco.png s'interprète par rapport à l'emplacement du fichier CSS.
 Dans une feuille LESS, avec le même code, le chemin relatif s'interprète par rapport à l'emplacement du fichier LESS principal compilé. Cela fait une différence importante lorsque la directive @import est utilisée. 
 En effet, dans ce cas c'est toujours l'emplacement du fichier principal, celui qui fait les @import, qui est pris en référence, et non l'emplacement du fichiers inclus, même si c'est lui qui référence l'image.
 Dans le cas de BootStrap, cela veut dire que c'est l'emplacement du fichier bootstrap.less qui est pris en compte. Ainsi, pour utiliser une image dans un fichier LESS personalisé de BootStrap, il convient de donner un chemin relatif par rapport au fichier bootstrap.less.
 La solution consiste alors à copier le fichier bootstrap.less dans votre dossier squelettes/, à côté de votre fichier personnalisé, sans oublier d'y copier aussi le dossier img/ avec les glyphicons. C'est assez peu pratique, et de manière générale c'est évitable en ajoutant les images de décoration dans un fichier LESS qui n'est pas inclus par bootstrap.less mais directement par le squelette SPIPr.
 
 
   Ressources
 
  Une liste indicative et non exhaustive d'outils utilisables en complément de BootStrap pour générer des thèmes, construire des mockup etc... [2]
  http://bootswatch.com/
 https://wrapbootstrap.com/themes
 http://jetstrap.com/ un outil de Mockup en ligne pour BootStrap
 http://stylebootstrap.info/
 http://www.boottheme.com/
 http://bootswatchr.com/
 http://www.lavishbootstrap.com/
 
 
  Notes
 [1] il faut avoir le statut de webmestre pour voir cette page
 
 [2] Attention à la version de BootStrap que les outils supportent : lorsque c'est une version plus ancienne que celle utilisée par SPIPr, certaines variables peuvent manquer dans les feuilles générées
 
  


Bouquinerie V2
Peetdu — 2017-10-06T07:00:00Z

		Voici la version pour SPIP 3.x du plugin Bouquinerie.

Cette nouvelle version permet de gérer des livres et le ou les auteurs associés.

Elle n'est pas compatible avec la précédente version.
Cet article est une présentation générale et un guide pour développeur.

Il est accompagné par le guide le d'utilisateur
		
Table of contents
 Présentation
 Installation et dépendances
 La boucle LIVRES
 La boucle LIVRES_AUTEURS
 Les critères communs à toutes les boucles
 Les plugins complémentaires
Présentation
Des livres et leurs auteurs
Ce plugin se veut être le plus petit dénominateur commun pour une gestion de livres et de leurs auteurs.
Il devrait pouvoir être utile aux cas suivants :
 Maison d'édition de livre;
 Librairie;
 Bibliothèque;
 Boutique en ligne de vente de livre;
 etc.
Installation et dépendances
Le plugin s'installe classiquement.
Pour information, il nécessite les plugins suivants…
 Saisies pour formulaires
 Rôles (typer les liaisons)
 API de vérification
… qui seront appelés automatiquement lors de l'installation.
La boucle LIVRES

Critères
- {id_livre} sélectionne le livre dont l'identifiant est id_livre.

- {id_rubrique} sélectionne tous les livres contenues dans la rubrique en cours

- {lang} sélectionne les livres de la langue demandée dans l'adresse de la page.

- {recherche} sélectionne les livres correspondant aux mots indiqués dans l'interface de recherche (moteur de recherche incorporé à SPIP). Voir la page consacrée au moteur de recherche.
Balises
#TITRE affiche le titre

#SOUSTITRE affiche le soustitre

#EDITEUR affiche le(s) nom(s) de(s) éditeur(s) [1]
#COLLECTION

#VOLUME

#EDITION

#TRADUCTION
#TEXTE affiche le texte de présentation du livre

#SOMMAIRE affiche le sommaire du livre

#EXTRAIT affiche un extrait du livre

#INFOS_SUP affiche des informations supplémentaires sur le livre
#ISBN affiche l'ISBN

Il est possible d'afficher le code barre associé
#ISBN
#PAGES affiche le nombre de page du livre

#RELIURE affiche le type de reliure (par ex. : Brochée, collée, etc.)

#LARGEUR

#HAUTEUR

#POIDS

#PRIX
#DATE_PARUTION affiche la date de parution

#DATE_NOUVELLE_EDITION affiche la date de nouvelle édition
Les balises calculées

#URL_LIVRErenvoi l'URL de la page Livre

#LOGO_LIVRE affiche la couverture du livre
La boucle LIVRES_AUTEURS

Critères

- {id_livres_auteur} sélectionne l'auteur dont l'identifiant est id_livres_auteur

- {id_livre} sélectionne les auteurs du livre dont l'identifiant est id_livre

- {role=xxxx} sélectionne les auteurs dont le rôle est xxx
exemple : trouver les illustrateurs d'un livre


Balises

#NOM affiche le nom de l'auteur

#PRENOM affiche le prénom de l'auteur

#BIO affiche la biographie

#LIEN_TITRE affiche le nom du lien

#LIEN_URL affiche l'URL du lien
#LOGO_LIVRES_AUTEUR affiche la photo de l'auteur
Les balises calculées

#URL_LIVRE_AUTEUR renvoi l'URL de la page de l'auteur d'un livre

#LOGO_LIVRE_AUTEURaffiche la photo de l'auteur
Les critères communs à toutes les boucles
Voir l'article éponyme
Les plugins complémentaires
Thèmes CLIL

La CLIL est la Commission de Liaison Interprofessionnelle du Livre.

Ce plugin ajoute dans le formulaire Livre un sélecteur de thème CLIL permettant par exemple une gestion de catégorie de livre (par thèmes donc).
Todo : Les thèmes de la CLIL répondent à la norme norme ONIX 3.0 (un format d'échange de métadonnées) Il devrait permettre d'améliorer le référencement de vos livres sur les différents sites de ventes.
Statistiques des objets

Permet d'avoir des stats spécifiques pour les livres et auteurs
Champs Extras 3  

Pour ajouter des nouveaux champs à la fiche Livre ou à la fiche Auteur de livre
LIM : alléger l'espace privé  

Pour alléger l'espace privée, vous pouvez paramétrer dans quelles rubriques exactement vous voulez voir apparaître le bouton “Créer un livre”.
		
		
[1] Voir aussi le guide de l'utilisateur à ce propos



Boussole
Eric Lupinacci — 2011-01-09T16:26:39Z

		Les bonnes adresses de la galaxie SPIP ou d'ailleurs !
Installez ce plugin sur votre site et vous aurez accès, dans vos squelettes, à l'ensemble des sites de la Galaxie SPIP en utilisant les modèles ou noisettes proposés.
Pour les bricoleurs, vous pouvez aussi utiliser ce plugin pour afficher votre propre liste de sites et concevoir vos propres affichages.
		
Table of contents
 Avertissements
 Objectifs
 Exemples d'utilisation
 Installation
 Pré-requis
 Modèle de données
 Initialisation du plugin
 L'interface privée
 L'interface publique
 Traductions et icônes
 Créer sa propre boussole
Avertissements
Le plugin Boussole a évolué récemment pour passer en version 4 dans le but de simplifier son code et son utilisation sur les sites client ou serveur. Pour migrer vers cette version et en comprendre les évolutions veuillez lire l'article Boussole v4.
Le présent article a donc été modifié pour être lisible quelque soit la version du plugin. Si une explication n'est valable que pour une version donnée cela est clairement précisé. Sinon, par défaut, l'explication est valable pour toutes les versions.
Objectifs
Le plugin Boussole a comme buts :
 de constituer la liste “officielle” des sites SPIP en proposant une charte réutilisable,
 de proposer une liste de modèles prédéfinis pour insérer la boussole en fonction du besoin et de couvrir par là même l'ensemble des affichages utilisés dans la galaxie SPIP (voir l'article Charte de la boussole SPIP),
 d'être utilisé, a minima, dans tous les sites de la galaxie -et plus si affinité,
 et donc de constituer un repère commun pour tous les utilisateurs de SPIP.
En outre, il est possible de créer sa propre boussole personnalisée de la galaxie SPIP ou de tout autre univers.
Exemples d'utilisation
En outre, la plupart des sites de la galaxie SPIP ont été mis à jour avec la Boussole. Les noms, adresses, icônes et libellés de ces sites sont maintenant identiques et donc plus facilement repérables.
La planche ci-dessous illustre les différents affichages de la Boussole dans la galaxie.

 
 Exemples d'utilisation sur les sites SPIP
 
Installation
Comme tout plugin, il suffit de suivre les procédures manuelles ou automatiques standard : veuillez vous reporter à cette documentation : SPIP-1-9-Les-Plugins.
Pré-requis
Boussole ne nécessite aucun autre plugin pour fonctionner en v2. A partir de la version v4, le plugin Boussole nécessite le plugin Cache Factory.
Modèle de données
Le modèle de données de Boussole distingue trois notions principales :
 la Boussole, qui n'est autre qu'une liste de sites. Une boussole est identifiée par un alias unique qui prend la valeur «spip» pour la galaxie SPIP. Elle est décrite dans un fichier XML.
 le Groupe, qui est un sous-ensemble thématique des sites d'une boussole. Le groupe est identifié par un alias unique au sein d'une boussole.
 le Site, identifié par un alias unique au sein d'une boussole. Un site de boussole peut être mis en relation avec un site référencé de SPIP.
Versions 0 et 1:
Le modèle de données est matérialisé par une unique table spip_boussoles. La table est mise à jour à partir de la lecture du fichier XML de la boussole. La DTD de ce fichier est matérialisée par le fichier boussole.dtd à la racine du plugin.
Version 2 et ultérieures:
Le modèle de données est toujours matérialisé par la table spip_boussoles qui n'a pas évoluée. Par contre, une nouvelle table spip_boussoles_extras a été ajoutée pour accueillir les traductions des noms, slogans et descriptions des objets manipulés par le plugin (boussole, site, groupe). Ces tables sont mises à jour par requête au serveur hébergeant la boussole souhaitée.
Initialisation du plugin
Étant donné que Boussole est principalement destiné à la galaxie SPIP, lors de son activation, la boussole SPIP est automatiquement chargée en base de données et donc disponible à l'utilisation.
L'interface privée
Elle propose - via le menu Squelettes (ou Configuration en SPIP 2 sans le plugin Bandeau) - une interface réservée aux webmestres et composée :
 d'une page principale autorisant l'ajout, la mise à jour ou la suppression d'une boussole

 
 Page de gestion des boussoles
 
 une page d'édition d'une boussole donnée permettant d'en configurer l'affichage : visibilité et classement des groupes et des sites

  
 Page de configuration d'une boussole
 

En outre, une tâche CRON tourne toutes les 24h pour mettre à jour automatiquement la boussole SPIP ou les autres boussoles (uniquement pour la version 2).
Enfin, si un site référencé fait partie d'une boussole, sa page d'édition en fera mention et affichera un lien vers cette boussole.

 
 Référence à la boussole pour un site
 
L'interface publique
Des modèles
Elle est essentiellement constituée d'une liste de modèles prédéfinis consultables dans la page de démo demo/boussole.html :
 boussole_liste_simple.html - une liste ul/li avec le titre de la boussole en h2 optionnel
 boussole_liste_par_groupe.html - une liste ul/li par groupe avec titre du groupe en h3 et titre de la boussole en h2, optionnels
 boussole_liste_avec_logo.html - une liste ul/li avec le titre de la boussole en h2 optionnel. Chaque bloc de site affiche le logo, le nom et une explication, slogan ou descriptif
 boussole_panorama.html - une galerie d'icônes seuls avec le titre de la boussole en h2 optionnel
 boussole_panorama_sepia.html - idem que le modèle précédent avec des logos sépia qui s'éclairent au survol
 boussole_liste_actualite.html - une liste ul/li des articles syndiqués des sites référencés de la boussole.
 boussole_contenu_z.html - une page Z avec le titre de la boussole en h1 et les titres des groupes en h3. Chaque site est un paragraphe
 boussole_tableau.html - tableau complet de toutes les informations de la boussole. Ce modèle est utile essentiellement comme débusqueur
 boussole_topnav.html - un menu de type topnav pour présenter la boussole sous forme d'une navigation principale.
Les sites sont généralement présentés sous forme de lien avec le slogan en bulle d'info. Le fichier html de chaque modèle comporte en commentaire une description détaillée des paramètres du modèle.
Une page Z compatible avec le noiZetier
Boussole propose aussi une page Z, boussole.html, utilisable avec ou sans le NoiZetier. Si elle est utilisée avec le NoiZetier, il est nécessaire de configurer la noisette Boussole - Contenu principal, de l'insérer explicitement dans la page et d'y ajouter un fil d'ariane éventuellement avec la noisette Boussole - Fil d'ariane - voir ci-dessous.
L'appel de cette page se fait en passant le paramètre «boussole» désignant l'alias de la boussole à afficher - spip.php?page=boussole&boussole=spip.
Cette page a été supprimée à partir de la version v4.
Des noisettes compatibles avec le noiZetier
En outre, le plugin propose des noisettes compatibles avec le NoiZetier et qui permet d'introduire facilement dans les squelettes compatibles (Aveline, SPIPClear Z...) les modèles précédemment décrits. Les noisettes disponibles sont :
 Boussole, permettant d'utiliser et de configurer les modèles standard, à savoir :
 boussole_liste_simple.html
 boussole_liste_par_groupe.html
 boussole_liste_avec_logo.html
 boussole_panorama.html
 boussole_panorama_sepia.html
 Boussole - Actualités, permettant de configurer le modèle :
 boussole_liste_actualite.html
 Boussole - Contenu principal, destinée principalement à la page Z boussole et permettant de configurer le modèle :
 boussole_contenu_z.html
 Boussole - Fil d'ariane, destinée principalement à la page Z boussole
Traductions et icônes
Ce chapitre à été déplacé et enrichi dans l'article Boussole v2, usages avancés.
Créer sa propre boussole
Ce chapitre à été déplacé et enrichi dans l'article Boussole v2, usages avancés.


Boussole v2, nouveau fonctionnement client-serveur
Eric Lupinacci — 2013-03-16T09:45:17Z

		L'objectif de cette nouvelle version v2 du plugin est de simplifier les mises à jour d'une boussole pour les sites utilisateur en ne les obligeant plus à upgrader leur plugin Boussole comme c'est le cas avec les versions v0 et v1.
L'article Evolution v2 du plugin Boussole décrit plus précisément les problèmes posés par la v1 et les nouvelles exigences qui ont conduit à l'élaboration de cette v2.
		
Table of contents
 Migration du plugin en version 2
 Un gestionnaire et des boussoles
 Fonctionnement serveur
 Fonctionnement client
Migration du plugin en version 2
 Si vous avez déjà le plugin Boussole en version 0 pour SPIP 2 ou 1 pour SPIP 3 vous êtes concernés par ce chapitre. 
Pour migrer Boussole en version 2, désactiver tout d'abord la version 0 ou 1 déjà installée. Surtout ne désinstallez pas le plugin sinon vous perdrez d'emblée les boussoles que vous avez ajoutées et configurées.
Ensuite installez la version 2 et activez-la. Le processus d'installation procèdera à la migration du schéma de la base de données (structure des tables) et des informations de la «boussole SPIP» uniquement. En effet, les autres boussoles ne peuvent être migrées car on ne connait pas leur serveur a contrario de la «boussole SPIP» qui est d'ores et déjà servie par le site boussole.spip.net.
En conclusion, si vous n'utilisez que la «boussole SPIP» le processus de migration est immédiat. Les modèles n'ayant pas été modifiés, les affichages seront conservés. 

Si par contre vous avez d'autres boussoles il faudra les ajouter et les configurer à nouveau.
Si vous souhaitez en savoir plus sur la nouvelle version, vous pouvez lire la suite de cet article. Sinon, pour utiliser les fonctions client (affichage, configuration...) veuillez toujours lire l'article de référence Boussole qui reste d'actualité.
Un gestionnaire et des boussoles
L'objectif principal de cette refonte du plugin Boussole était de simplifier la mise à jour des modifications de la «boussole SPIP» sur les sites utilisateurs, en particulier ne pas avoir à upgrader le plugin lui-même.
Une première réponse a été de scinder le plugin Boussole v1 en deux plugins distincts :
 le plugin Boussole v2 proprement dit, dont la fonction client se limite à gérer les boussoles, leur ajout, leur suppression, leur mise à jour et leur affichage, et la fonction serveur à envoyer sur demande les informations sur une boussole. C'est un gestionnaire de boussoles qui fonctionne aujourd'hui en mode client et serveur comme expliqué plus loin dans l'article.
 la «Boussole SPIP», incluse aujourd'hui dans un plugin dédié et contenant les informations littérales, les logos et le fichier XML de description.
Ainsi, pour un site souhaitant afficher la «Boussole SPIP» —ou tout autre boussole— il suffit d'installer le plugin «gestionnaire» Boussole v2.
Par contre, le plugin «Boussole SPIP» n'est utile que pour le serveur hébergeant cette boussole, à savoir, aujourd'hui https://boussole.spip.net/. L'intérêt d'un plugin pour cette boussole réside dans la facilité d'installation, de mise à jour et surtout la traduction via le site trad.spip.net.
Fonctionnement serveur
À partir du moment où la «Boussole SPIP» —et toute autre boussole— n'est plus incluse dans le plugin Boussole v2, il devient indispensable de proposer un service fournissant ces données à tous les sites utilisateurs.
C'est ainsi que le plugin Boussole v2 intègre aujourd'hui une fonction serveur qui permet de mettre à disposition des sites clients les informations d'une boussole (sites, groupes, traductions) ainsi que ses logos. 

Le mode serveur n'est pas actif par défaut car il est assez rare qu'on en ait besoin.
Pour en savoir plus sur ce mode et sur la façon de créer un serveur veuillez lire l'article Boussole v2, usages avancés.
Fonctionnement client
La fonction client de Boussole v2 n'a pas été modifiée dans son utilisation basique. Les affichages par les modèles ont été strictement conservés à l'instar du formulaire de configuration. Du point de vue utilisation l'expérience est inchangée.
Néanmoins, la mise à jour des boussoles a été adaptée pour coller au nouveau mode client-serveur. En outre, les informations littérales (nom, slogan et description) sont maintenant chargées en base de données ce qui a nécessité un upgrade du schéma.
L'actualisation des boussoles est toujours faite une fois par jour, automatiquement.


Bouton Changement de langue pour le Porte-Plume
Joseph, RealET — 2011-01-30T15:34:00Z

		Ajoute un bouton dans le porte-plume pour indiquer un changement de langue dans votre texte.
		

Table of contents
 Indiquer un changement de langue dans un texte
 Utiliser l'extension Changement de langue pour le Porte-Plume

Indiquer un changement de langue dans un texte
Lorsque l'on rédige un texte, bien qu'il soit dans une langue donné, il peut comporter des éléments dans une autre langue.
Il importe dès lors de signaliser ce changement de langue pour diverses raisons :
 les règles typographiques de cette langue ne sont pas les mêmes que celle de la langue principale de votre article ;
 la direction (de la gauche vers la droite ou de la droite vers la gauche) peut-être différente (le navigateur doit alors en être informé pour afficher correctement le texte) ;
 cette information est utilisée par les navigateurs vocaux pour adapter correctement la prononciation d'un mot en fonction de sa langue;
 cette information peut être utilisé par le navigateur pour des traitement additionnels, par exemple pour proposer une traduction au survol du mot.
Pour plus d'informations, voit notamment cette page du site OpenWeb
Ce changement de langue peut être indiqué en utilisant les raccourcis existants de SPIP et en particulier les blocs .
Pour indiquer un changement de langue, il suffit d'utiliser un bloc multilingue ne contenant qu'une seule langue, à savoir la langue du texte à afficher. Par exemple dans un article en français on pourra écrire :
Il faut se méfier des termes anglais [en]{fecondity} et [en]{fertility} qui correspondent respectivement en français à {fertilité} et {fécondité}.
ce qui produira le code HTML suivant :
Il faut se méfier des termes anglais fecondity et fertility qui correspondent respectivement en français à fertilité et fécondité.
On voit ainsi que les deux termes anglais sont dès lors entouré d'un  comme il se doit.
Par ailleurs, en procédant ainsi, SPIP appliquera le traitement typographique adéquat (en français, par exemple, on doit placer un espace insécable avant un point d'interrogation ou d'exclamation alors que ce n'est pas le cas en anglais). On peut illustrer ce point avec l'exemple suivant :
Une phrase en français avec un point d'exclamation final! [en]A English sentence with an exclamation point!
donnera (constater l'espace devant le point d'exclamation seulement pour le français) :

Une phrase en français avec un point d'exclamation final! A English sentence with an exclamation point!
Utiliser l'extension Changement de langue pour le Porte-Plume
Une fois ce plugin activé, un nouveau bouton

 

 sera affiché dans le porte-plume.
Sélectionnez le texte qui est dans une autre langue et cliquez sur le bouton. Une fenêtre vous demandera le code de langue du texte (pour les différents code de langue, voir la norme ISO 639).
Le texte sera entouré par [code] et  où code sera le code de langue saisi (fr pour le français, en pour l'anglais, es pour l'espagnol, etc.).
De plus, dans l'espace d'administration, le texte en multi verra son fond coloré différemment et la langue indiquée explicitement après le texte, en exposant [1].

 
 Indication visuelle du changement de langue dans l'espace d'admin
 

		
		
[1] À l'exception d'Internet Explorer pour les versions avant la 8...



Bouton «Proposer à la publication»
ARNO* — 2009-09-28T13:15:00Z
Dans la version 2 de SPIP, le gros bouton «Proposer à la publication», qui indiquait (lourdement) aux rédacteurs qu'ils pouvaient/devaient proposer leurs articles, a été remplacé par un accès plus discret dans la colonne de gauche. 

Pour certains sites contributifs, ce changement d'ergonomie perturbe les rédacteurs. Ce plugin réintroduit ce bouton. 

Pour ceux qui n'ont pas connu les versions antérieures de SPIP, son principe est simple: lorsqu'un rédacteur affiche la page d'un de ses (…)



-
Bouton «Proposer à la publication»

/ 
GNU / General Public Licence, 
Plugins, 
On SPIP-Zone


Boutons Contacts & Rendez-vous
Eric Lupinacci, Thrax — 2022-03-11T11:19:39Z

		Un plugin pour faciliter l'ajout d'un rendez-vous à un agenda ou d'une carte de visite à un carnet de contacts. Les rendez-vous sont fournis au format ICS ou Google Agenda et les cartes de visite au format vCard.
		
Table of contents
 Objet
 Installation
 Fonctionnement
 Les modèles
 Ajout de la vCard dans la boite d'infos d'un auteur
 Utilisation des plugins Contacts et Organisations et Coordonnées
 Ajout du rdv iCal dans la boite d'infos d'un évènement d'Agenda
 Principes de développement
Objet
Ce plugin facilite l'interaction entre le site et les internautes en permettant de mettre à disposition un contact ou un rendez-vous afin de les intégrer dans ses carnets d'adresses ou dans ses calendriers personnels.
Installation
Le plugin s'installe comme n'importe quel plugin SPIP.
Fonctionnement
Le plugin met à disposition différents outils :
 des modèles qui affichent un lien de téléchargement ou de remplissage d'un rendez-vous ou de la carte de visite;
 un traitement automatique pour insérer la vCard d'un auteur dans sa boite d'infos.
 un traitement automatique pour insérer le rendez-vous iCal d'un évènement du plugin Agenda dans sa boite d'infos.
 Les modèles
Les modèles vous permettent de faire apparaitre dans vos textes des boutons de téléchargement.

icône par défaut nom du modèle effet



 


bouton_rdv
permet de télécharger le fichier .ics correspondant au rendez-vous défini.


 


bouton_rdv_google
permet d'ouvrir un formulaire Google pour saisir un rendez-vous qui sera ajouter l'agenda de son choix (API Google)


 


bouton_vcard
permet de télécharger le fichier .vcf correspondant à la vCard définie


 


bouton_vcard_auteur
permet de télécharger le fichier .vcf correspondant à la vCard de l'auteur spip choisi


 


bouton_rdv_evenement
permet de télécharger le fichier .ics correspondant au rendez-vous de l'évènement du plugin Agenda choisi


Les exemples qui suivent permettent d'identifier l'ensemble des paramètres utilisables dans les modèles, donc le périmètre strictement utilisé par le plugin pour les vCard et les rendez-vous. A cet égard, le plugin n'autorise aujourd'hui que les mails, adresses et numéros de téléphone dont le type est personnel (home) et professionnel (work).
Les paramètres label et icone ne sont pas liés au rendez-vous ou à la carte de visite mais permettent de choisir le libellé ou l'icone affiché. Ces paramètres ne sont pas obligatoires, le plugin pouvant afficher un icone et un label par défaut.
 Ajout de la vCard dans la boite d'infos d'un auteur
Pour un auteur affichant sa propre fiche, le plugin insère le lien de téléchargement de sa vCard dans la boite d'infos. Il n'est donc pas possible pour un auteur donné de télécharger dans le privé la vCard d'un autre auteur (RGPD).
Cependant, rien n'empêche un auteur donné de publier sa propre carte de visite en utilisant les modèles précités dans une page de son site.
 Utilisation des plugins Contacts et Organisations et Coordonnées 
Les plugins Contacts & Organisations et Coordonnées sont compatibles avec le plugin Boutons Contacts & Rendez-vous. En effet, si un auteur est configuré comme un contact, les données du contact sont utilisées en priorité pour créer la vCard. 
De même pour Coordonnées, les mails, téléphones et adresses postales de type personnel et professionnel sont utilisées en priorité pour compléter la vCard de l'auteur concerné.
Ces plugins ne sont opérationnels que pour la vCard liée à un auteur. Ils fonctionnent avec le modèle bouton_vcard_auteur et le lien automatique vCard de la page auteur uniquement.
 Ajout du rdv iCal dans la boite d'infos d'un évènement d'Agenda
Pour un évènement du plugin Agedna affichant sa propre fiche, le plugin insère le lien de téléchargement de son iCal dans la boite d'infos si l'autorisation voir est accordée.
 Principes de développement
Le plugin aurait pu utiliser des librairies en javascript ou des class PHP pour gérer les normes ICS, vCard ou GoogleAgenda, mais l'idée est de rester simple et léger en ne proposant que les options principales de ces normes.


Cache Cool
Cerdic — 2009-10-31T19:02:31Z

		 Le plugin cache cool accélère le service des pages en différant le calcul du cache lorsque c'est possible pour éviter à l'internaute d'attendre après.
Il sert donc le cache “froid”, et le réchauffe en cuisine pour la prochaine fois qu'il sera demandé.
		
Table of contents
 Installation
 Comment ça marche
 Est-ce que ça marche ?
 Est-ce-que ça marche vraiment ?
 Gains attendus
Installation
Le plugin s'installe classiquement. Il est disponible par git, à l'adresse https://git.spip.net/spip-contrib-extensions/cache_cool.git, ou en zip à télécharger.

Il n'entraine aucune modification de la base de données.
En revanche, le plugin nécessite au minimum la version SPIP 2.0.11, ou, mieux, une version 2.1.x.
Le plugin nécessite également le plugin Job Queue pour la mise en file d'attente du calcul des page en cache.
Comment ça marche
Le plugin s'insère dans le processus de calcul des pages a mettre à jour au moyen de la fonction public_produire_page.
Si c'est un calcul normal pour une mise en cache, il regarde alors si une version du squelette est déjà disponible et peux être envoyée à l'internaute. Dans ce cas, et si le visiteur n'est pas connecté, il lui envoie la vieille version du cache, et ajoute à la queue un calcul du squelette pour mettre à jour le cache. [1]
Est-ce que ça marche ?
Pour vérifier si le plugin marche, vous pouvez surveiller la queue des jobs en attentes sur ecrire/?exec=job_queue. Vous devez voir passer des calcul de squelette comme par exemple Calcul du cache inclure/rubriques [inclure_page] 
Est-ce-que ça marche vraiment ?
Pour que le plugin soit efficace, il faut que votre site reçoive un traffic suffisament important pour que les caches en attente soient calculés rapidement.
Sur un site à faible traffic, le visiteur verra toujours une vieille page qui sera mise à jour uniquement après son passage. La version à jour ne profitera à personne.
Du point de vue du visiteur, le temps de réaction du site est sensiblement accéléré. Mais il faut que cela ne se paie pas par une information constamment périmée !
Gains attendus
Dans toutes les configurations, le plugin permet un gain sensible et visible sur le temps de service des pages par le serveur. Car l'assemblage d'une page est beaucoup plus rarement ralentie par le calcul d'un morceau de squelette.
		
		
[1] Précision lors du développement : Quand un squelette utilise des globales non officielles pour changer son état et ce qu'il affiche (soit parce qu'elles sont référencées dans le squelette, dans du PHP du squelette ou dans un filtre), il convient de les déclarer dans une constante PHP _CACHE_COOL_GLOBALS_TO_SAVE pour permettre a cache_cool de les sauvegarder/restaurer a chaque calcul de cache asynchrone.



Cache Factory
Eric Lupinacci — 2019-03-10T17:13:35Z

		Cache Factory propose une API fonctionnelle PHP permettant de configurer, d'écrire, de lire et de supprimer des caches et une interface utilisateur dans l'espace privé limitée à un formulaire de vidage des caches. C'est un outil de développement pour plugins.
Dans sa version actuelle Cache Factory ne gère que des caches fichier.
		
Table of contents
 Concepts
 API fonctionnelle PHP
 L'interface utilisateur de vidage des caches
 Fonctionnement de Cache factory
 Mise en œuvre dans un plugin utilisateur
 Résumé pour le développement d'un plugin utilisateur
 Evolutions
Concepts
 Les caches
Les caches sont des espaces secondaires de stockage de données dont le but est de fournir un accès plus rapide que le stockage principal de ces mêmes données. Un mécanisme de mise à jour des caches doit être mis en œuvre afin de suivre les modifications du stockage principal : les caches ont en général une durée de vie limitée dans le temps.
Un cache est soit un fichier soit un espace mémoire. Dans cette version du plugin Cache Factory les caches sont toujours des fichiers.
 Identification complète d'un fichier cache
Le plugin Cache Factory fournit une API qui permet de simplifier la manipulation (écriture, lecture, suppression, test d'existence…) de fichiers cache pour un plugin utilisateur. Un fichier est identifié de façon unique par un chemin sur le disque. Le chemin des caches de Cache Factory est toujours formaté selon la grammaire ABNF (approximative) suivante :
 =  []    =   "/"  = (_DIR_CACHE / _DIR_VAR / _DIR_TMP/ _DIR_ETC) ; const. SPIP  = ["cache-"] ; suivant la racine  = ALPHA *(ALPHA / DIGIT / "_")  = 1*(ALPHA / DIGIT / "-" / "_") "/"  = [ ]   =  *( )  = 1*(ALPHA / DIGIT / "-" / "_") ; sauf le séparateur  = 1*(ALPHA / DIGIT / "-" / "_") ; sauf le séparateur  = ("-" / "_")  = "." 1*(ALPHA / DIGIT) ALPHA = %x41-5A / %x61-7A ; A-Z / a-z DIGIT = %x30-39 ; 0-9
L'interprétation de la grammaire formelle permet d'édicter les règles suivantes :
 un fichier cache est toujours localisé dans un répertoire propre au plugin utilisateur () qui est un sous-dossier des répertoires standards dans lesquels SPIP a déjà l'habitude de stocker ses propres caches (_DIR_CACHE, _DIR_VAR, _DIR_TMP et _DIR_ETC);
 l'identification du cache à l'intérieur du répertoire du plugin utilisateur est donné par un sous-dossier facultatif et un nom qui est composé d'une série ordonnée de composants sémantiques prédéfinis et pouvant commencer par un préfixe fixe;
 un composant du nom d'un fichier cache ne peut pas contenir le caractère séparateur utilisé.
Par exemple, les caches de N-Core sont stockés dans un dossier tmp/cache/ncore/ et se nomment /-.php. Cela donne pour le cache Ajax du noiZetier : tmp/cache/ncore/noizetier/type_noisette-ajax.php. Le tiret est utilisé comme séparateur car le composant  peut contenir le caractère souligné.
 Identification relative d'un cache
Pour simplifier l'identification d'un cache pour les plugins utilisateur, Cache Factory ne demande pas à chaque appel d'une API tous les éléments d'identification décrits au paragraphe précédent. La racine, le séparateur et l'extension sont des éléments invariables du chemin du fichier cache d'un plugin utilisateur donné et sont stockés dans une configuration générale.
Ainsi, connaissant le plugin utilisateur - ce qui est le cas dans chaque fonction d'API - l'identification relative d'un cache est un tableau associatif fournissant le sous-dossier - si utilisé et si différent du type de cache - et les composants, chaque composant portant une sémantique spécifique. Dans l'exemple du paragraphe précédent tiré du plugin N-Core, l'identifiant relatif coïncide avec le tableau suivant :



sous_dossier
Reçoit le préfixe du plugin utilisateur de N-Core
"noizetier"

objet
Identifie l'objet de N-Core concerné par le cache
"type_noisette"

fonction
Identifie le type de cache pour l'objet concerné, en l'occurrence dans notre cas, les indicateurs Ajax des types de noisette.
"ajax"


Un plugin utilisateur doit manipuler de façon préférentielle l'identifiant relatif et rarement son chemin complet.
 Les attributs des caches
Les caches fichier possèdent dans la version actuelle du plugin trois attributs : l'un indique si le cache est sécurisé (au sens de l'API SPIP), l'autre précise si le contenu est sérialisé et le dernier donne la durée de conservation du cache. Ces attributs sont stockés dans la configuration générale.
Depuis la version 0.4.2 il est possible de préciser si le contenu lu dans le cache doit être décodé avant d'être fourni. L'encodage lui reste à la charge du plugin utilisateur.
 Type de cache et configuration
Le modèle de configuration des caches et la structure en composants sémantiques pour le nommage autorisent beaucoup de flexibilité pour regrouper les caches d'un plugin sous une configuration unique. Néanmoins, si un plugin utilisateur a besoin de caches JSON et PHP, ou de caches avec et sans péremption le plus efficace est de définir différentes configuration de caches.
Pour distinguer chaque configuration et associer une configuration donnée à un cache, Cache Factory définit le concept de type de cache. Un type de cache possède un identifiant unique au sein d'un plugin utilisateur composée d'une chaine alphanumérique.
C'est le couple (plugin utilisateur, type de cache) qui permet d'identifier de manière unique la configuration à appliquer à un cache. Cela a donc une incidence immédiate sur l'API de Cache Factory. Cette notion est la grande nouveauté de la branche v1 et elle introduit une incompatibilité avec la branche v0 dans laquelle la connaissance seule du plugin utilisateur permettait d'identifier la configuration à appliquer (unique pour un plugin utilisateur).
Si le sous-dossier est utilisé par le type de cache, par défaut, l'identifiant du type de cache sera affecté au sous-dossier si l'utilisateur ne le fournit pas dans l'identifiant relatif du cache. Cette évolution fonctionnelle est disponible à partir de la version 1.2.0.
API fonctionnelle PHP
La gestion des caches consiste principalement à définir le nom des caches à partir de la configuration générale pour un plugin utilisateur et de l'identification relative, et de gérer les écritures et lectures de façon à simplifier au maximum les appels et traitements de l'appelant. Aucune donnée n'est enregistrée par cache, seule la configuration générale est stockée en meta.

API : inc/ezcache_cache.php


Fonctions liées aux caches

cache_ecrire
Ecrit un contenu donné dans un cache spécifié par son identifiant relatif ou par son chemin complet.

cache_est_valide
Teste l'existence d'un cache sur le disque spécifié par son identifiant relatif ou par son chemin complet et, si il existe, teste si la date d'expiration du fichier n'est pas dépassée. Si le fichier existe et n'est pas périmé, la fonction renvoie le chemin complet, sinon elle renvoie une chaine vide.

cache_lire
Lit le cache spécifié par son identifiant relatif ou son chemin complet et renvoie le contenu sous forme de tableau ou de chaine suivant l'attribut de sérialisation ou de décodage. En cas d'erreur, la fonction renvoie false.

cache_nommer
Renvoie le chemin complet du cache sans tester son existence. Cette fonction est une encapsulation du service cache_cache_composer(). Son utilisation par un plugin appelant doit rester limitée.

cache_repertorier
Retourne la description des caches d'un plugin utilisateur filtrée sur un ensemble de critères. La description de base fournie par Cache Factory contient les éléments de l'identifiant relatif mais peut-être remplacée ou complétée par le plugin appelant au travers de services propres. Les filtres concernent uniquement les éléments de l'identifiant relatif.

cache_supprimer
Supprime le cache spécifié par son identifiant relatif ou par son chemin complet.

cache_vider
Supprime, pour un plugin utilisateur donné, les caches désignés par leur chemin complet.

Fonctions liées à la configuration

configuration_cache_lire
Lit la configuration générale des caches d'un plugin utilisateur ou de tous les plugins utilisateur ayant enregistrés une configuration.

configuration_cache_effacer
Efface la configuration générale des caches d'un plugin utilisateur ou de tous les plugins utilisateur ayant enregistrés une configuration.

L'interface utilisateur de vidage des caches
L'interface utilisateur de vidage des caches est composée d'une page dans l'espace privé, cache_vider, et d'un formulaire listant les caches d'un plugin utilisateur donné, #FORMULAIRE_CACHE_VIDER.
La page cache_vider affiche les formulaires de vidage de chaque plugin utilisateur les uns sous les autres comme illustré ci-après.
Le formulaire de vidage possède un paramètre obligatoire, l'identifiant du plugin utilisateur. Le prototype est le suivant : #FORMULAIRE_CACHE_VIDER{plugin[, options]}.
Chaque formulaire est personnalisable par plugin utilisateur en surchargeant le service de chargement des paramètres du formulaire et le sous-squelette d'affichage de la liste caches. Cette personnalisation est discutée au chapitre suivant.

  

Fonctionnement de Cache factory
 La dissociation API – Services
Le fonctionnement global du plugin Cache Factory s'appuie sur une architecture API - services. Par conception, Cache Factory dissocie la fonction d'API, des services propres à un plugin utilisateur qui en personnalisent la gestion.
Dans le code de ses API, Cache Factory appelle donc des fonctions de service qui :
 si la fonction de service homonyme existe dans le plugin utilisateur, va l'appeler et l'utiliser ;
 sinon, va dérouler la fonction de service de Cache Factory.
 L'aiguillage des services
Par conception et pour des raisons de lisibilité du code, les fonctions d'API de Cache Factory appellent systématiquement les fonctions de service de Cache Factory. Ce sont les fonctions de service de Cache Factory qui réalisent l'aiguillage vers le service souhaité ce qui leur permet aussi d'effectuer des traitements génériques et donc de limiter encore plus la complexité pour les plugins utilisateur.

  

 Les services
Les fonctions d'API de Cache Factory font donc appel à des services dont la liste exacte est fournie ci-après. Le nom des fonctions est amputé du préfixe du plugin appelant. Ces fonctions de service ne doivent pas être appelées par le plugin appelant qui doit utiliser exclusivement les fonctions d'API. Le plugin appelant peut définir ses propres services qui seront appelés par ceux de Cache Factory, mais en aucun cas les utiliser dans son code

Services personnalisables


Services de configuration

cache_configurer^(*)
Renvoie la configuration générale des caches d'un plugin utilisateur sous la forme d'un tableau associatif dont les index sont standardisés.

Services de gestion des identifiants de cache

cache_verifier
Vérifie le contenu de l'identifiant relatif du cache. Par défaut, Cache Factory complète l'identifiant avec le préfixe et le sous-dossier si nécessaire et vérifie que les composants obligatoires du nom sont bien présents.

cache_composer
Construit le chemin complet du fichier cache à partir du tableau de l'identifiant relatif du cache.

cache_decomposer
Décompose le chemin complet du fichier cache en éléments constitutifs. Par défaut, le tableau obtenu coïncide avec l'identifiant relatif du cache. La fonction utilise la configuration générale pour connaitre la structure du chemin du fichier.

cache_completer
Complète la description canonique d'un cache issue du service cache_decomposer(). Le plugin Cache Factory complète la description canonique avec le nom sans extension et l'extension du fichier.

Services de gestion du contenu d'un cache

cache_decoder
Effectue le décodage du contenu brut du cache (chaine) en fonction de l'extension du fichier cache. La fonction propose des traitements standard pour le JSON, YAML, et XML. Tout plugin utilisateur peut proposer sa fonction spécifique pour le format $format en codant le service cache_decoder_${format}.

Il n'existe pas de service d'encodage inverse. C'est au plugin utilisateur d'encoder son contenu avant l'écriture du cache.

cache_valider
Détermine si le cache est encore valide ou pas. Par défaut, Cache Factory vérifie l'existence du fichier cache et sa péremption pour déterminer la validité. Ces tests peuvent être compléter par le plugin utilisateur.

Services de gestion du formulaire de vidage

cache_formulaire_charger
Effectue le chargement du formulaire de vidage des caches pour un plugin utilisateur donné. Par défaut, le plugin Cache Factory propose une version simplifiée du formulaire où tous les fichiers caches sont listés par ordre alphabétique sans possibilité de regroupement.


Les services notés (*) doivent toujours être définies par le plugin utilisateur, les autres sont optionnels.
Cache Factory propose l'ensemble des services dans son fichier ezcache/ezcache.php ce qui permet de minimiser les développements pour la plupart des plugins utilisateur. A minima, un plugin utilisateur peut se contenter de décrire uniquement sa configuration générale si il n'a aucune spécificité par rapport aux services natifs de Cache Factory.
Par exemple, le plugin Rainette définit la configuration générale de ses caches et personnalise le chargement du formulaire de vidage des caches en codant dans le fichier ezcache/rainette.php les fonctions rainette_cache_configurer() et rainette_cache_formulaire_charger().
 Le pipeline post_cache
Suite à l'écriture d'une cache - fonction cache_ecrire() – ou à sa suppression – fonctions cache_supprimer() et cache_vider() – Cache Factory fait appel à un pipeline nommé post_cache. Ce pipeline permet de lancer un traitement éventuel pour conclure l'opération d'écriture ou de suppression en cours. De fait, le pipeline fournit quelques informations regroupées dans l'index ‘args' du flux, l'index 'data' n'existe pas.



plugin
Le préfixe du plugin utilisateur de Cache Factory. Permet à un plugin utilisateur P1 d'éviter de lancer ses traitements initiés par un plugin P2.

fonction
Identifie la fonction générique faisant appel au pipeline. Prend les valeurs ‘ecrire' ou ‘supprimer'.

fichier_cache
Chemin complet du fichier cache.

cache
Tableau canonique identifiant du cache.

configuration
Tableau de configuration des caches du plugin utilisateur.

Mise en œuvre dans un plugin utilisateur
 Déclarer la configuration générale
Cache Factory a besoin de connaitre la configuration générale des caches d'un plugin utilisateur pour fonctionner. Le plugin utilisateur doit obligatoirement déclarer sa configuration par l'intermédiaire du service cache_configurer().
Le tableau associatif de la configuration à fournir par un plugin utilisateur a une structure prédéfinie qui est décrite ci-après. Le plugin utilisateur peut fournir tout ou partie de cette configuration sachant que les index non fournis seront complétés par Cache Factory avec une valeur par défaut.
Par exemple, le plugin N-Core déclare la configuration suivante :
$configuration = array( 'racine' => '_DIR_CACHE', 'sous_dossier' => true, 'nom_obligatoire' => array('objet', 'fonction'), 'nom_facultatif' => array(), 'extension' => '.php', 'securisation' => true, 'serialisation' => true, 'encodage' => false, 'separateur' => '-', 'conservation' => 0 );
Le tableau suivant récapitule l'ensemble des paramètres de configuration et leur valeur par défaut.

Paramètres de configuration


Paramètres fournis par le plugin utilisateur

racine
Emplacement de base dans lequel sera créé le répertoire de stockage des caches du plugin utilisateur.. Les valeurs possibles sont les chaines  "_DIR_CACHE", "_DIR_VAR", "_DIR_TMP" et "_DIR_ETC".
"_DIR_CACHE"

sous_dossier
Indique si le cache est inclus dans un sous-dossier du répertoire de stockage du plugin. A partir de la version 1.2.0, si true, par défaut, Cache Factory utilise le type de cache comme nom de sous-dossier ce qui permet de ne pas le fournir dans l'identifiant du cache. Néanmoins, il est toujours possible d'écraser la valeur par défaut en le fournissant dans l'identifiant relatif du cache.
false

nom_obligatoire
Tableau des composants obligatoires et ordonnés du nom d'un cache. Le nom des composants sert d'index quand il s'agit de fournir le tableau identifiant un cache.
array("nom")

nom_facultatif
Tableau des composants facultatifs et ordonnés du nom d'un cache. Les composants facultatifs suivent toujours les composants obligatoires.
array()

separateur
Caractère de séparation de chaque composant obligatoire ou facultatif du nom. Prend les valeurs "_", "-" ou "" si le nom est constitué d'un seul composant. Ce caractère ne doit pas être utilisé dans les composants du nom.
""

extension
Extension du fichier cache. Si le fichier cache est sécurisé l'extension est toujours forcée à ".php".
".txt"

securisation
Indique si le fichier doit être sécurisé ou pas.
false

serialisation
Indique si le contenu à stocker est un tableau à sérialiser ou pas.
true

encodage
Indique si le contenu lu est à décoder ou pas avant fourniture à l'appelant. Le type de décodage est déterminé par l'extension du fichier cache. Cette option est incompatible avec la sérialisation.
false

conservation
Durée de conservation du cache exprimée en secondes. La valeur 0 est utilisée pour indiquer que le cache est permanent.
0

Paramètres calculées par Cache Factory

dossier_plugin
Répertoire de stockage du plugin calculé à partir de la racine et du préfixe du plugin. Si la racine prend la valeur "_DIR_VAR" alors le répertoire du plugin est un sous-dossier de nom "cache-${plugin}/". Sinon, le sous-dossier porte le nom du préfixe du plugin.
"${plugin}/"

nom
Tableau regroupant dans l'ordre les noms obligatoires puis les noms facultatifs.
array("nom")


Cache Factory utilise une meta nommée cache pour stocker l'ensemble des configurations des plugins utilisateur.
 Personnaliser le formulaire de vidage des caches
Cache Factory permet de personnaliser la présentation des caches d'un plugin utilisateur dans le formulaire de vidage de ces mêmes caches.
En effet, par défaut, Cache Factory affiche une liste unique de tous les caches du plugin utilisateur avec le sous-dossier, si il existe, et le nom du cache sans son extension. Les caches sont classés alphabétiquement. Cette présentation par défaut suffit au plugin N-Core mais pas à Rainette qui préfère présenter ses caches regroupés par service.
Pour permettre à Rainette et à d'autres plugins de personnaliser l'affichage, la portion du squelette qui réalise l'affichage de la liste est codée dans une inclusion. Par défaut, l'inclusion fournie par Cache Factory se nomme formulaires/inc-ezcache_cache_vider.html. Un plugin qui souhaite « remplacer » cette inclusion doit créer sa propre inclusion nommée formulaires/inc-${plugin}_cache_vider.html. Si elle existe elle sera appelée en lieu et place de celle par défaut.
En général, pour produire un affichage différent que l'affichage par défaut, un plugin regroupe ses caches selon certains critères et/ou rajoute des données sur chaque cache. Il est souvent nécessaire de modifier le tableau de chargement du formulaire pour qu'il coïncide avec l'objectif d'affichage.
Pour ce faire, Cache Factory propose le service cache_formulaire_charger(). Par exemple, le plugin Rainette modifie le chargement du formulaire avec le code contenu dans la fonction rainette_cache_formulaire_charger().
 Personnaliser les identifications et les descriptions d'un cache
Cache Factory possède des mécanismes par défaut pour composer le nom d'un fichier cache et le décomposer en composants unitaires. Ces mécanismes sont simples et non contextuels.
Pour constituer le nom d'un fichier cache le service natif cache_composer() lit les composants attendus (obligatoires et facultatifs) et les concatène en utilisant le séparateur configuré. Pour retrouver les composants à partir du nom du fichier cache, le service natif cache_decomposer() fait l'inverse en scindant le nom en composants. Les composants sont interprétés dans l'ordre donné par le paramètre de configuration nom sans aucune vérification sémantique.
Ces mécanismes sont en général suffisants pour la plupart des plugins. Néanmoins, pour un plugin utilisateur qui souhaiterait personnaliser la composition ou la décomposition du nom du fichier cache, Cache Factory lui offre la possibilité de fournir ses propres services en codant les fonctions ${plugin}_cache_composer() et ${plugin}_cache_decomposer() qui seront utilisées en lieu et place des services natifs.
Cache Factory propose également de compléter la description d'un cache renvoyée par l'API cache_repertorier(). La base de cette description est constituée du tableau fourni par le service cache_decomposer() auquel Cache Factory rajoute les index “nom_cache” et “extension_cache” au travers de son service natif cache_completer().
De même, ce mécanisme est souvent suffisant mais un plugin comme Taxonomie a besoin de rajouter le nom scientifique du taxon concerné par un cache pour l'affichage dans le formulaire. Il code donc son propre service taxonomie_cache_completer() pour rajouter cette information à la description retournée par cache_repertorier().
 La validation d'un cache
Cache Factory propose des critères par défaut pour vérifier si un cache est valide ou pas. Ces critères sont l'existence du fichier cache et sa péremption (durée du cache échue comparée à sa configuration).
Néanmoins, en créant une fonction de service ${plugin}_cache_valider(), un plugin utilisateur peut rajouter la vérification de critères propres. La fonction renvoie le résultat de la vérification sous la forme d'un booléen.
Ce service peut être utile quand la durée de conservation n'est pas un critère pertinent et que l'on veut invalider un cache sur un évènement du système (mise à jour en base de données, etc).
 Utiliser le pipeline post_cache
L'utilisation du pipeline post_cache est assez rare car le plugin Cache Factory fournit par défaut déjà de nombreuses possibilités de personnalisation, en particulier concernant l'identifiant du cache. Néanmoins, certains cas sont difficilement résolubles avec les fonctions de gestion de l'identifiant car un ou plusieurs composants sont eux-mêmes calculés : il devient alors impossible de trouver une fonction réversible pour composer et décomposer le nom.
Le plugin REST Factory est confronté à ce problème : les filtres ou les ressources peuvent contenir des caractères inappropriés pour la constitution d'un nom de fichier. Pour éviter ce problème sans utiliser d'improbable conversion, ce composant nommé ‘complement' est calculé en cryptant sa source avec un md5. Il est donc impossible de décrypter le contenu de ce complément si on veut afficher les informations sous-jacentes dans le formulaire de vidage des caches.
C'est pourquoi REST Factory utilise un index des caches créés où il stocke les éléments source ayant permis d'élaborer le nom. Il utilise cet index lors de l'affichage du formulaire de vidage des caches pour afficher les filtres ou la ressource de façon claire.
Résumé pour le développement d'un plugin utilisateur
Pour un plugin utilisateur, la mise en œuvre de Cache Factory peut se limiter à:
 créer à la racine du plugin un fichier ezcache/${plugin}.php;
 fournir un tableau de configuration générale en codant la fonction ${plugin}_cache_configurer();
 et utiliser les API proposées décrites de façon exhaustive sur le site de documentation du code des plugins à l'adresse suivante: https://code.plugins.spip.net/ezcache/.
Un exemple classique d'utilisation des API est donné ci-dessous (plugin Spiper Ipsum) :
// Constituer l'identifiant relatif du cache include_spip('inc/cache'); $cache = array( 'sous_dossier' => $service, 'date' => $date, 'langage' => $code_langue ); // Mise à jour du cache avec les nouvelles données si: // - le fichier cache n'existe pas // - la période de validité du cache est échue // - le rechargement a été forcé if ((!$fichier_cache = cache_est_valide('spiperipsum', $cache)) or (defined('_SPIPERIPSUM_FORCER_CHARGEMENT') ? _SPIPERIPSUM_FORCER_CHARGEMENT : false)) { // Utilisation de la fonction de chargement du service. $charger = "${service}_charger"; $tableau = $charger($code_langue, $date); // Mise à jour du cache cache_ecrire('spiperipsum', $cache, $tableau); } else { // Lecture des données du fichier cache valide $tableau = cache_lire('spiperipsum', $fichier_cache); }
Certains plugins voudront également personnaliser l'affichage du formulaire de vidage en codant leur version du service cache_formulaire_charger() et de l'inclusion formulaires/inc-${plugin}_cache_vider.html.
Ces deux personnalisations sont en général largement suffisantes pour 90% des plugins utilisateur.
Evolutions
Le plugin est dans sa phase de déploiement. Les plugins Taxonomie, Rainette, Spiper Ipsum et N-Core ont déjà adopté Cache Factory et ainsi simplifié le code de gestion de leurs fichiers cache. L'utilisation par d'autres plugins permettra surement d'envisager des améliorations à apporter à l'API actuelle.
Version 0.4.2 : le plugin REST Factory vient d'adopter aussi ce plugin et a nécessité l'ajout de l'option de décodage.
Version 0.5.0 : ajout du pipeline post_cache.
Version 0.6.0 : renommage du préfixe et par conséquence de certains fichiers et dossiers. C'est une modification majeure qui demande une adaptation des plugins utilisateurs.
Version 0.8.2 : ajout de la constante _DIR_ETC comme répertoire d'accueil possible pour les caches.
Version 0.8.5 : ajout du service cache_valider() qui permet à un plugin utilisateur de rajouter des vérifications pour déterminer la validité d'un cache.
Version 1.0.0 : ajout du type de cache et abandon de la branche v0.
Version 1.2.0 : le sous-dossier, si utilisé, est rempli par défaut avec le type de cache ce qui permet de ne plus passer ce paramètre dans l'identifiant relatif du cache.
N'hésitez donc à partager vos retours.


Calendrier Mini 2.0
Cerdic, James — 2012-05-19T14:18:58Z

		Ce plugin ajoute la balise #CALENDRIER_MINI qui insère un petit widget de navigation par mois dans les dates des évènements.

 


		
Table of contents
 Fonctionnement du mini calendrier
 Insertion du mini calendrier
 Liste des évènements
 Collecte automatique de id_article, id_rubrique et id_mot
 Personnalisation de l'apparence
Fonctionnement du mini calendrier
Le mini calendrier présente un mois à la fois. Les jours du mois comportant des évènements sont surlignés. Un clic sur l'un de ces jours permet de naviguer vers une page qui présentera les évènements de ce jour.
Le mini calendrier comporte deux liens de navigation pour passer au mois précédent ou au mois suivant, ainsi que deux champs de sélection pour aller directement à n'importe quel autre mois ou année.

 


La navigation d'un mois à un autre se fait immédiatement, sans rechargement de la page. La liste des évènements pour le mois en cours est rechargée en tâche de fond et mise à jour sur le mini calendrier (chargement asynchrone au format JSON).
Les évènements affichés par le mini calendrier peuvent être de n'importe quelle nature (publication des articles du site, commentaires, objets évènements du plugin agenda).
A partir de la version 2.3.0, la liste des événements d'une journée est affichée au survol (tooltip).
Accessibilité et alternative

Le mini calendrier insère également une alternative qui permet aux utilisateurs sans javascript ainsi qu'aux robots d'indexation de disposer des liens vers chaque jour (pour peu qu'il contienne un évènement) du mois en cours ainsi que vers le mois précédent ou le mois suivant.
Insertion du mini calendrier
Le mini-calendrier est inséré simplement dans vos squelettes au moyen de la balise #CALENDRIER_MINI
Cette version 2.0 du plugin reprend la syntaxe des versions précédentes du plugin «Calendrier mini» : #CALENDRIER_MINI{url, url_json} où
 url désigne l'URL de la page sur laquelle envoyer le visiteur lorsqu'il clique sur un jour (#SELF par défaut)
 url_json désigne l'URL appelée pour charger la liste en JSON des évènements entre deux dates (#URL_PAGE{calendrier_mini.json} par défaut).
Dans cette syntaxe courte, la variable date utilisée est nommée archives et la date courante est automatiquement capturée d'après #ENV{archives}.

Un exemple d'utilisation est :
#CALENDRIER_MINI{#SELF, #URL_PAGE{mes_evenements.json}}
Le plugin supporte également la syntaxe longue utilisée dans le plugin «Agenda» :

#CALENDRIER_MINI{date, var_date, url, url_json}

où
 date est la valeur courante de la date ; le mini calendrier se positionnera sur le mois correspondant ;
 var_date est le nom de la variable date qui sera passée en argument à la page appelée quand le visiteur clique sur un jour ;
 url désigne l'URL de la page sur laquelle envoyer le visiteur lorsqu'il clique sur un jour (#SELF par défaut) ;
 url_json désigne l'URL appelée pour charger la liste en JSON des évènements entre deux dates (#URL_PAGE{calendrier_mini.json} par défaut).
Un exemple d'utilisation de cette syntaxe est :
#CALENDRIER_MINI{#ENV{date}, date, #SELF, #URL_PAGE{evenements_mini.json}}
Exemple: afficher les évènements créés dans le plugin «Agenda»
[(#CALENDRIER_MINI{#ENV{date}, date, #URL_PAGE{jour}, #URL_PAGE{calendrier_mini_event.json}})]
Dans cet exemple :
 on utilise le squelette «calendrier_mini_event.json.html» fourni par le plugin «Agenda» pour récupérer les évènements créés dans l'agenda ;
 la page d'affichage des évènements lorsque l'on clique sur une date (avec au moins un évènement!) utilise le squelette «jour.html», lui aussi fourni dans le plugin «Agenda» ;
 le squelette «jour.html» utilisant le paramètre d'environnement date pour boucler dans les évènements, on prend soin de passer date en 2ème paramètre de la balise.
Liste des évènements
Les évènements affichés dans le mini-calendrier sont fournis au format JSON par un squelette qui est appelé à chaque changement de mois du mini calendrier.
Par défaut c'est calendrier_mini.json.html qui génère la liste des articles publiés entre start et end fournis tous deux au format «timestamp» (nombre de secondes depuis 1970) dans l'URL.
Pour modifier la liste des évènements affichés dans le mini calendrier, il suffit de modifier le squelette calendrier_mini.json.html (ou de le copier sous un autre nom en passant ensuite la valeur correspondante pour l'argument url_json).
Le title de chaque événement envoyé par le squelette sert à afficher le tooltip au survol de chaque date. Vous pouvez le personnaliser en le préfixant de l'heure de début par exemple, quand cela est pertinent.
Collecte automatique de id_article, id_rubrique et id_mot 
Quand elle est utilisée avec la syntaxe sans l'url de la page JSON, la balise #CALENDRIER_MINI collecte automatiquement (comme elle le faisait auparavant) les #ID_ARTICLE, #ID_RUBRIQUE et #ID_MOT du contexte où elle est appelée. Les valeurs de id_article, id_rubrique et id_mot sont alors passées à l'url de la page JSON par défaut.
Dès que vous précisez en dernier argument de #CALENDRIER_MINI l'url de la page JSON qui fournit les événements, il vous appartient d'y préciser les id_article, id_rubrique ou id_mot que vous souhaitez prendre en compte, car ceux-ci ne sont plus transmis automatiquement.

Ce fonctionnement vous permet ainsi de désactiver la transmission automatique au besoin.
Personnalisation de l'apparence
L'apparence du mini-calendrier est prise en charge par la feuille de style css/minical.css. La feuille de style est minimale afin que le mini-calendrier hérite au maximum de l'apparence de votre site. Cette feuille de style peut être personnalisée dans votre dossier squelettes/.

Voici un autre exemple d'insertion du mini-calendrier sans modification de la feuille de style :

 


Pour des raisons de performance, la feuille de style est insérée inline dans le HTML de la page qui contient le mini calendrier. Si elle référence des images, celles-ci doivent donc être référencées avec leur URL absolue.
Les boutons pour passer vers les mois précédents ou suivants utilisent l'image css/img/month_prev_next-32x16.png qui peut être personalisée dans votre dossier squelettes/.
Le pied du mini-calendrier qui contient le bouton aujourd'hui peut-être masqué simplement en CSS.
En dernier recours, si c'est vraiment nécessaire pour la personnalisation, vous pouvez aussi modifier le squelette formulaires/calendrier_mini.html. Toutefois ceci est déconseillé car hypothèque la compatibilité de votre squelette avec les évolutions futures du plugin.


Champs Extras (Interface)
Matthieu Marcillaud — 2012-01-16T15:26:32Z

		Ce plugin permet de créer et/ou de gérer des champs supplémentaires dans les objets éditoriaux de SPIP depuis l'espace privé de SPIP. Il s'appuie sur le plugin Champs Extras, dont il n'est qu'une simple interface graphique.
		
Table of contents
 Screencast
 Introduction : séparation de l'API et de l'interface graphique
 Présentation de l'interface
 Créer un nouveau champ via l'interface
Screencast
Vous n'aimez pas lire ? Écoutez pendant 20mn !
Cette capture présente Champs Extras 3 avec son interface graphique [1]. Elle est présente sur medias.spip.net où vous pourrez voir la vidéo en plus grand format.


      

 
Introduction : séparation de l'API et de l'interface graphique
Il existe deux plugins distincts :
 le premier, «Champs Extras» (lire «Champs Extras — introduction») donne accès aux fonctions de création, de gestion et d'affichage des champs. Il est ne constitue qu'un outil de développement. Il nécessite le plugin «Saisies». Un exemple (Titre Court sur les rubriques) dans le dossier extensions montre comment créer un plugin offrant des champs prédéfinis.
 le second, «Champs Extras (Interface)» profite des points d'entrées et des fonctions du plugin «Core» pour proposer une interface graphique de gestion et de création de ces champs supplémentaires. Ce plugin nécessite quand à lui évidemment «Champs Extras (API)» et «Saisies», mais également «Le plugin YAML» et «Vérifier». C'est ce plugin qui est documenté ici.
Présentation de l'interface
Lorsque le plugin d'interface est activé, le menu de configuration permet d'aller sur la page de configuration des Champs Extras (?exec=champs_extras).
Cette page présente :
 la liste des objets sur lesquels on peut insérer des champs extras, indiquant pour chaque objet le nombre de champs extras présents,
 puis, si c'est le cas, un cadre se trouve dessous indiquant pour certains objets que certaines colonnes SQL ne sont gérées ni par SPIP ni par un plugin, et que Champs Extra peut éventuellement les gérer.

  
 Liste des objets éditoriaux exploitables
 

On le remarque sur l'image, ici seul l'objet Articles a 1 Champs Extra. De plus, dans le second cadre, on voit que le champ «openid» peut être géré. Ce champ provient du plugin «OpenId» qui avait du être installé mais n'est actuellement pas actif sur le site. Comme il n'avait pas été désinstallé (mais seulement désactivé), le champ est resté dans la table SQL des auteurs.
Créer un nouveau champ via l'interface

Seuls les webmestres du site ont accès à ce panneau de configuration.
Pour ajouter un élément dans un des objets, il faut cliquer sur le nom de l'objet souhaité.

Nous allons créer un champ dans la table des articles, nous cliquons donc sur leur nom.
Cela nous amène sur une autre page (du même fonctionnement donc que le plugin Formidable), qui présente :
 les Champs Extras présents sur l'objet (que l'on peut déplacer, modifier, dupliquer ou supprimer),
 puis la liste des types de champs que l'on peut ajouter.

  
 Présentation du formulaire d'édition d'un objet
 

Il suffit de cliquer un des types de champs pour ajouter cet élément dans la liste des champs présents. Cet élément se placera automatiquement en fin de liste. Nous ajoutons ici des cases à cocher.
On peut le voir sur l'image suivante, un message indique alors que le formulaire est modifié par rapport à son état normal. On a trois possibilités offertes :
 Continuer nos modifications, autant qu'on en souhaite,
 Annuler toutes nos modifications en «Réinitialisant le formulaire»
 Valider nos modifications en «Enregistrant le formulaire» en bas de page.

 
 Des champs de type Cases ajoutés aux articles
 

Nous allons déplacer les cases ajoutées en premier, pour cela, on survole les «cases à cocher», clique en gardant enfoncé notre bouton l'icône de déplacement (la première, des flèches bleues), et on monte la souris vers le haut, au dessus du premier champ. Un cadre jaune apparaît à l'endroit ou se placera le champ déplacé. On peut alors relâcher le bouton de la souris. Si la manœuvre vous paraît périlleuse, n'ayez crainte : cette façon de faire n'est qu'un raccourcis. On peut également définir l'emplacement du champs extra en le modifiant.
C'est d'ailleurs modifier le Champ Extras des cases que nous allons faire maintenant. Pour cela, on clique la seconde icône. Un formulaire détaillé apparaît alors :

  
 Édition de cases à cocher
 

On peut observer que les options sont nombreuses et divisées en onglets pour plus de clarté. Décrivons sommairement ce que sont ces onglets :
 Description : concerne essentiellement les textes qui seront affichés ainsi que le nom technique du champ (le nom de la colonne SQL)
 Utilisation : concerne des options sur le type de code HTML généré
 Affichage : permet de compléter les descriptions du champ, par exemple par un message d'avertissement
 Validation : indique le type de vérification à effectuer sur le contenu saisi
 Restriction : permet de limiter l'affichage des champs à certaines personnes ou parties du site.
 Technique : représente la liste des options liées à SPIP, à la base de données. Il permet également de modifier de type de saisie (pour passer de cases à radio par exemple).
À noter que les éléments affichés dans chaque onglet peuvent différer d'un type de saisie à une autre. Un champ «Ligne de texte» n'affiche pas les mêmes possibilités de configuration qu'un champ «Cases à cocher».
On comprend vite ainsi que lorsqu'on crée un nouveau champs extra, la première chose à faire est de changer les informations présentes dans l'onglet «Description» et en particulier son nom technique, le «nom du champ». Effectivement, cela nous évitera d'appeler le champ #CHECKBOX_1 dans un squelette, qui ne reflète pas une information sémantique, mais technique. On peut par exemple modifier le champ en le nommant «hobbies» (ce qui permettra d'utiliser #HOBBIES), et modifier son libellé et valeurs. Cela donnerait ensuite, après validation du formulaire de configuration de la case à cocher, la prévisualisation suivante :

 
 Cases à cocher modifiées
 

Pour valider nos changements, il faut alors enregistrer le formulaire de champs extras. Ceci fait, on peut ensuite se rendre sur un article, nous être satisfait de voir nos deux champs présents, à la fois sur le formulaire d'édition et sur la vue du texte. Voici dans le formulaire des articles ce que cela donne :

 
 Deux champs en plus sur les articles
 

		
		
[1] Cette interface a évolué depuis la prise de cette vidéo ; cependant le fonctionnement est relativement identique



Change Statut
kent1, Yffic — 2011-04-11T08:11:43Z

		Ce plugin rajoute des boutons dans le bandeau de l'interface privé qui permettent de changer temporairement et d'un clic son statut de webmestre en administrateur ou rédacteur. Puis de revenir à la situation originale.
		
Table of contents
 Installation
 Fonctionnement
Installation
Comme tous les autres plugins, cf. https://www.spip.net/fr_article3396.html
En SPIP 2, le plugin nécessite le plugin Bandeau.
Fonctionnement
Une fois le plugin activé, les boutons de changement de statut sont en permanence affichés pour les webmestres du site. Ils peuvent donc tester l'interface privée sans avoir besoin de créer de compte supplémentaire...

 
 Interface Webmestre
 

 
 Interface rédacteur
 

 
 Si la page courante n'est plus accessible pour le nouveau statut
 



Chart.js
erational — 2014-10-01T12:32:15Z

		Permet de créer des jolis graphiques dans SPIP.

Souple et léger, il inclut 6 types de graphes customisables pour les rédacteurs et concepteurs de squelettes.
		
Table of contents
 Présentation
 Installation
 Utiliser le modèle 
 Syntaxe complète du modèle 
 Usage avancé: utilisation dans des boucles SPIP
Présentation
Ce plugin permet d'insérer des graphes dans SPIP. Il inclut 6 types (courbe, barre, camembert, radar, doughtnut) ainsi qu'une solution pour les vieilles versions d'Internet Explorer.
Ce plugin utilise la bibliothèque javascript http://www.chartjs.org/ crée par Nick Downie.
Basé sur HTML5

Chart.js utilise le javascript et repose sur le tag HTML5 canvas. Il est compatible avec tous les navigateurs modernes et offre un support polyfills pour IE7/8.
Il est aussi responsive par défaut.
Simple et flexible

Chart.js ne dépend pas d'une autre librairie et il est assez léger une fois compressé.

  

Installation
Le plugin est répertorié dans le dépôt proposé par défaut : « SPIP-Zone - Plugins ». Aussi, il est installable depuis la page Gestion des plugins, onglet Ajouter des plugins si vous avez activé ce dépôt. Pour le retrouver dans la liste des plugins, il vous suffit de rechercher “chartjs”.
En cas de besoin, référez-vous à l'article dédié à ce sujet sur spip.net.
Une fois installé, vous pouvez consulter la page de démonstration spip.php?page=demo/demo_chartjs
Utiliser le modèle 
Le plugin introduit un nouveau modèle pour insérer les graphes dans vos articles.


Exemple: Modèle pour un camembert

Attention la syntaxe est précise, il faut être vigilant lors de la saisie des données.
 Chaque graphe doit comporter les attributs obligatoires id (unique), type 

et data ou datasets
 Pour les types Pie, Doughnut et PolarArea s'utilisent avec l'attribut data (tableau à 1 dimension)
 Pour les types Bar, Line et Radar s'utilisent avec l'attribut datasets (tableau à plusieurs dimensions). On utilise le mot réservé next pour séparer un jeu de données.
 Les chiffres à virgules sont à indiquer en notation anglaise (avec un point): 

3.14 et non 3,14
Syntaxe complète du modèle 
Le nom des paramètres et leurs valeurs sont en anglais.
Paramètres obligatoires

Paramètres Exemple Explications


type
pie
Type de graphique, choisir entre
 pie
doughnut
radar
polararea
bar
line

id
camembert23
identifiant du graphique, il doit être unique et ne pas comporter de caractères spéciaux

data
30,50,100
Données pour les graphes du type pie, doughnut et polarArea

datasets
30,50,100 next 20,90,75
Données pour les graphes du type bar, line et radar
Pour séparer un ensemble de données, on utilise le mot séparateur next


Paramètres facultatifs

Paramètres Exemple Explications


labels
Jan,Fev,Mars
Légende

canvaswidth
500
Largeur du graphe.
Exprimé en px

canvasheight
500
Hauteur du graphe.
Exprimé en px

width
45%
Largeur du conteneur du graphe.
Valeurs possibles
auto ou une valeur en unités em, px, %

height
auto
Hauteur du conteneur du graphe.
Valeurs possibles
auto ou une valeur en unités em, px, %

align
right
Alignement du graphe:
left
center
right

class
no-print
Ajouter une classe supplémentaire au conteneur du graphe

colors
#E0E4CC,#F38630
Jeu de couleurs personnalisé

fillopacity
0.7
Opacité du remplissage pour les graphes de type line, bar et polararea

pointstrokecolor
#FFFFFF
Couleur du point les graphes de type line et polararea

animation
true
Activer ou non l'animation du graphe

scaleFontSize
12
Taille de police en px

scaleFontColor
#666
Change l'échelle de couleur de police

scaleOverride
false
Si true, le script tente d'appliquer l'échelle. Requiert les paramètres suivants

scaleSteps
null
requiert scaleOverride=true,
Nombre de pas de l'échelle

scaleStepWidth
null
requiert scaleOverride=true,
Valeur du pas de l'échelle

scaleStartValue
null
requiert scaleOverride=true,
Valeur de départ de l'échelle

scaleLabelUnit
€
Uniquement pour les graphes de type line et bars, pour afficher l'unité à la suite de chaque label

Usage avancé: utilisation dans des boucles SPIP
Il est aussi possible d'utiliser le plugin dans vos boucles SPIP pour créer des graphes avec des données dynamiques.
Dans ce cas on utilisera la balise #MODELE{chart} avec les paramètres requis.
Exemple: afficher le cours du yen des 30 derniers jours.
#SET{data,''} #SET{labels,''}  #SET{labels, #GET{labels}|concat{",",#VALEUR{attributes/time}|affdate{d/m/y}}} [ (#VALEUR{attributes/currency}|=={JPY}|oui) #SET{data,#GET{data}|concat{",",#VALEUR{attributes/rate}} ]  #SET{data,#GET{data}|substr{1}} #SET{labels,#GET{labels}|substr{1}} [(#MODELE{chart}{id=coursduyen,type=line,width=auto,height=auto,canvaswidth=850,canvasheight=350,datasets=#GET{data},labels=#GET{labels}})]
Affichera

  


		Merci aussi aux concepteurs du plugin Wordpress dont nous avons utilisé une partie de la syntaxe.


Chatbox
g0uZ — 2014-11-04T13:14:17Z

		Ce plugin permet de mettre en place facilement une “chatbox” permettant à un visiteur authentifié de SPIP de laisser un message.
		
Table of contents
 Principe
 Installation
 Comment ça marche ?
 Mise en œuvre
 Exemple d'utilisation
 Édition dans l'espace privé
 Exemple d'utilisation
Principe
Une chatbox est une sorte de mini chat, avec deux différences majeures :
 Les messages sont persistants (un nouveau venu peut voir votre message d'il y a 1h)
 Il n'y a pas de liste des personnes connectées
Installation
Le plugin s'installe de manière classique.
Comment ça marche ?
Le plugin gère 1 table :
 CHATBOX_MESSAGES : qui contient les messages enregistrés par visiteur, avec les champs suivant:
 #ID_CHATBOX_MESSAGE : l'identifiant du message
 #ID_AUTEUR : identifiant de l'auteur du message
 #MESSAGE : le message
 #DATE : la date d'enregistrement
 #LANG : la langue du message
 #STATUT : statut de publication du message
Vous pouvez afficher le contenu de cette table via les BOUCLEs de SPIP.
Mise en œuvre
Les éléments SPIP suivant sont disponibles pour mettre en œuvre votre “chatbox” sur votre site :
 un formulaire CVT #FORMULAIRE_CHATBOX permettant d'enregistrer un message
 un exemple de modèle permettant d'afficher la liste des messages enregistrés
Exemple d'utilisation
Afficher le formulaire permettant l'enregistrement d'un message :
[(#SESSION{id_auteur}|oui) <:chatbox:chatbox:>
 [(#FORMULAIRE_CHATBOX)]
]
NotaBene :

Ce formulaire peut être inclus dans une noisette utilisant le critère {ajax}.

Cette noisette peut être chargée avec la médiabox SPIP.
Afficher la liste des 5 derniers messages enregistrés :
[(#CACHE{0})]
 [(#ANCRE_PAGINATION)]    [(#ID_AUTEUR|afficher_avatar{'',50})]  [(#ID_AUTEUR|colore_user{#LANG})]
 [(#DATE|affdate)] <:a:> [(#DATE|affdate{"H:i"})]  
 
 [(#MESSAGE|PtoBR|liens_ouvrants|lignes_longues{30})]
 
   [(#PAGINATION{precedent_suivant})]
Édition dans l'espace privé
Lors de l'activation du plugin, une nouvelle entrée “chatbox messages” est créée dans le menu “Édition”. Elle permet notamment d'afficher la liste des messages enregistrés, gérer leur contenu et leur statut de publication.
Exemple d'utilisation
Un exemple d'utilisation est disponible à cette adresse (la chatbox est disponible dans le menu situé à droite) :

http://www.root-me.org/fr/Challenges/


Choix de couleur
Maïeul — 2013-08-28T19:00:04Z
“Choix de couleur” est une extension du plugin saisies, proposant un nouveau type de saisie : choisir entre plusieurs couleurs prédéfinies.
		
Table of contents
 Installation
 Fonctionnalité
 Utilisation de #SAISIE
 Utilisation avec Formidable
Installation
Le plugin nécessite évidement le plugin Saisies et s'installe comme n'importe quel plugin.



 Choix parmi des couleurs (0.7.3)
 

Fonctionnalité
La nouvelle saisie propose un choix de couleur sous forme de boutons radio, comprenant :

- un carré de la couleur.

- un nom associé à la couleur.

 
 Exemple de choix de couleur
 
Utilisation de #SAISIE
Dans le tableau de l'article “Référence des saisies” la saisie “choix de couleurs” est une saisie de type “radio”.
Un peut donc insérer une balise #SAISIE ayant toutes les options d'une saisie de type “radio”. Par exemple :
#SAISIE{choix_couleur, mon_choix_couleur, label=Choisissez votre couleur, datas=#ARRAY{ Clef1,Label1, Clef2,Label2, ClefN,LabelN}}
Les clefs du tableau sont des codes couleur. Exprimé :

- soit sous la forme de code couleur HTML/CSS sans le dièse qui précède. Exemple : f2f2f2.

- sous sous la forme d'un nombre, précédé de lambda. Ce nombre correspond à la longueur d'onde dans le vide de la couleur, exprimé en nanomètres. Par exemple : lambda550. Cette longueur est ensuite convertie en code couleur HTML/CSS [1].
Utilisation avec Formidable
Si vous utilisez Formidable, vous disposez d'une nouvelle entrée “Choix parmi des couleurs”.
Dans la configuration du champ, dans “Liste des choix possibles”, vous pouvez insérer vos choix sous la forme :
Cle1|Label1 Cle2|Label2 CleN|LabelN
Le formatage des clefs est expliqué ci-dessus.

 
 Utilisation d'une entré “Choix de couleur” avec Formidable
 

		
		
[1] Consultez le code source du plugin pour voir l'algorithme de conversion.



Chosen
kent1, Matthieu Marcillaud — 2013-09-14T14:17:06Z

		Chosen est une librairie Javascript permettant de rendre plus simples d'usage les éléments select et notamment ceux permettant de sélectionner plusieurs valeurs dans un formulaire.
À partir de SPIP4 ce plugin n'est plus maintenu et il est conseillé d'utiliser Select2 à la place.
		
Table of contents
 Configuration du plugin
 Dans vos squelettes ou autre développements
 Exemple d'utilisation
Ce plugin permet de modifier l'apparence et l'usage d'éléments select de formulaires en fonction de sa configuration.
Configuration du plugin
Sa configuration est relativement simple, il est simplement demandé de l'activer ou non dans l'espace public et de remplir l'input correspondant au sélecteur CSS sur lequel l'appliquer.
Dans l'image ci-dessous (issu de trad.spip.net), on l'applique sur les sélecteurs de langues ayant pour “id” “langues_choisies” et “langues_preferees”.

 


Si vous souhaitez l'applique à tout élément select de formulaires, il suffit d'indiquer select. Pour les select multiple, on indiquera select[multiple].
Dans vos squelettes ou autre développements
Si vous ne souhaitez pas utiliser la configuration du sélecteur CSS, tout élément select ayant la class CSS .chosen sera automatiquement modifié.
Exemple d'utilisation
Ce plugin est activé sur le site “Traduire SPIP” notamment sur sa page “Bilan” afin de modifier la liste des langues affichées.

 




ciag : plugin « Groupes d'auteurs »
Equipement — 2011-11-30T22:45:41Z

		Ce plugin facilite l'affectation des auteurs aux rubriques, via des groupes d'auteurs. Il offre également des vues globales des affectations de rubriques aux auteurs.
		
Table of contents
 Les objectifs de ce plugin
 Pourquoi un plugin supplémentaire sur ce sujet ?
 Compatibilité
 Installation
 Utilisation
 Illustration en image
 Pour en savoir plus
 Dernière version du plugin
Les objectifs de ce plugin
Le premier objectif est de faciliter l'affectation des auteurs aux rubriques, via des groupes d'auteurs. 

Le second objectif est d'offrir des listes qui offrent des vues globales des affectations de rubriques aux auteurs.
Pourquoi un plugin supplémentaire sur ce sujet ?
Il existe déjà un plugin intitulé « Gestion de Groupes d'auteurs 2 », toutefois ce plugin ne permet pas d'affecter des rubriques à des groupes d'auteurs.
Compatibilité
- La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.

- Il est compatible avec les plugins “ciar : accès restreints issus de Giseh” et “cirr : rédacteur restreint”.
Installation
Le plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html .
Utilisation
Le détail des fonctionnalités de ce plugin figure dans la documentation ci-jointe.
Ce plugin permet d'affecter des rubriques à des auteurs :
	Les groupes d'auteurs servent à rassembler des auteurs afin de leur attribuer des rubriques communes. Par exemple, au lieu d'affecter directement une rubrique à un auteur, puis à un autre auteur, …, on crée un groupe d'auteurs, on lui affecte les auteurs et la rubrique en question.
	Un groupe d'auteurs peut être affecté à plusieurs rubriques.
	Un groupe d'auteurs contient plusieurs auteurs (il n'y a aucun intérêt à créer un groupe pour un seul auteur).
	Un auteur peut appartenir à plusieurs groupes d'auteurs.
	Une rubrique peut être affectée à plusieurs groupes d'auteurs.
	L'affectation directe d'une rubrique à un auteur reste possible.

Par cohérence avec le fonctionnement de SPIP, l'affectation des rubriques à un groupe d'auteurs bénéfice d'un mécanisme d'héritage dynamique (si une rubrique est affectée à un groupe d'auteurs, ses sous-rubriques actuelles et à venir, le seront automatiquement par héritage).
Par ailleurs, un groupe d'auteurs ne sera modifiable que par les gestionnaires de ce groupe.
Illustration en image
Page de l'ensemble des groupes d'auteurs :

 


Page d'un groupe d'auteurs :

 


Liste des auteurs et de leurs rubriques :

 

Pour en savoir plus
SPIP utilise sa table de relation entre auteurs et rubriques dans au moins 11 fichiers PHP, qu'il faut éviter de surcharger. Aussi, ce plugin répercute automatiquement l'affectation des groupes d'auteurs aux auteurs ou aux rubriques, dans l'affectation des auteurs aux rubriques.

- Lorsqu'un groupe d'auteurs se voit affecter (ou retirer) une rubrique, cette rubrique est automatiquement affectée (ou retirée) à chaque auteur du groupe (avec un mécanisme évitant de saturer Mysql).

- Lorsqu'un groupe d'auteurs se voit affecter (ou retirer) un auteur, cet auteur est automatiquement affecté (ou retiré) aux rubriques de ce groupe d'auteurs.

- Si on désactive le plugin « Groupes d'auteurs », le fonctionnement du site reste inchangé, car les affectation des rubriques aux auteurs demeurent. 
- A noter que ceci évite d'impacter les performances en fonctionnement courant du site.
Il existe des cas particuliers. Par exemple, lorsqu'un groupe d'auteurs se voit retirer un auteur, il convient de retirer automatiquement à cet auteur, les rubriques affectées à ce groupe d'auteurs, sauf si l'auteur est lié à la rubrique via un autre groupe. Etc.
Dernière version du plugin
La version du 25/04/2012 apporte une compatibilité avec une volumétrie d'auteurs élevée.
La version du 02/05/2012 corrige une incompatibilité introduite par la version 3.0.0-rc de SPIP.
La version du 29/10/2012 ajoute un mécanisme qui vérifie qu'il reste au moins un administrateur du site, lorsqu'on ajoute des auteurs à un groupe d'auteurs.
La version du 27/03/2018 apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version du 2.4 apporte la compatibilité avec SPIP 4.0
La version 2.5 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
La version 2.6 apporte la compatibilité avec SPIP 4.2.
La version 2.7 apporte la compatibilité avec PHP 8.2.


ciar : plugin « Accès restreints issus de Giseh»
Equipement — 2011-11-28T14:30:00Z

		Cette version ajoute une gestion par groupe d'auteurs, ainsi que la compatibilité avec SPIP 3. Pour mémoire, le plugin “ciar” offre des accès restreints reprenant les fonctionnalités de ceux de Giseh. Le plugin est utilisable sans utiliser les autres plugins Giseh.
		
Table of contents
 Les objectifs de ce plugin
 Pourquoi un plugin supplémentaire sur ce sujet ?
 Compatibilité
 Installation
 Utilisation
 Illustration en image
 Version successives du plugin
Les objectifs de ce plugin
Offrir la possibilité de restreindre l'accès à une rubrique, sur le site public et dans l'espace privé de SPIP, à certains utilisateurs, afin d'obtenir des espaces collaboratifs. Par exemple, selon ses droits, une personne pourra accéder (après s'être authentifiée) à l'espace collaboratif A mais pas à l'espace collaboratif B.
Pouvoir surcharger le statut d'un auteur dans un espace collaboratif. On peut par exemple décider de donner à un administrateur restreint uniquement un rôle de rédacteur dans un espace collaboratif.
Permettre de restreindre, sur le site public uniquement, l'accès à une rubrique aux personnes authentifiées. Cet objectif est différent du premier et il n'oblige pas à affecter des droits aux utilisateurs.
Offrir le choix entre 4 niveaux de protection des pièces jointes (sauf si le paramétrage par fichier est utilisé) .
Pourquoi un plugin supplémentaire sur ce sujet ?
Il existe déjà un plugin « Accès restreints 3 », toutefois il ne répond pas à certains besoins spécifiques auxquels le présent plugin (qui constitue le portage sous SPIP 2 d'une fonctionnalité introduite en 2006 dans Giseh) doit répondre :

- il ne permet pas de surcharger le statut d'un auteur dans une rubrique protégée ;

- si on veut qu'un auteur gère une rubrique protégée, il est nécessaire d'une part d'affecter, dans le plugin, cet administrateur restreint à une zone contenant la rubrique protégée, et d'autre part, d'affecter, dans la gestion des auteurs de SPIP, la rubrique protégée à cet auteur. Sans cette seconde manipulation, l'auteur ne pourra pas gérer cette rubrique.

- soit le plugin n'offre aucune protection des pièces jointes, soit il offre un filtrage de l'accès aux images et documents pénalisant en termes de performances.

- etc.
Compatibilité
- Le plugin est utilisable sans utiliser les squelettes Giseh.

- La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.

- Il est compatible avec les plugins “cirv : rédacteur valideur” et “cirr : rédacteur restreint”.

- Il nécessite le plugin “ciautoriser : Pipeline pour autoriser” qui surcharge les fonctions d'autorisation. Aussi, ce dernier est incompatible avec les plugins qui surchargent les fonctions d'autorisation.
A noter que le plugin “ciautoriser : Pipeline pour autoriser” est utilisable par plusieurs plugins. Pour en savoir plus cliquer ici.
Le plugin “ciautoriser : Pipeline pour autoriser” figure dans le même fichier ZIP que le plugin “ciar : accès restreints issus de Giseh”.
Installation

- Le plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html .

- Il est nécessaire d'installer le plugin “ciautoriser” (qui figure également dans le fichier ZIP ci-joint).

- Il est facultatif d'installer le plugin “ciag” (qui gère les groupes d'auteurs et qui figure également dans le fichier ZIP ci-joint).
Utilisation
L'utilisation est décrite dans le document “Description du plugin acces restreint issus de Giseh” joint au présent article.

L'utilisation des groupes d'auteurs est décrite dans le document “Description du plugin groupes d'auteurs”, joint au présent article.
Illustration en image
Possibilité de restreindre, à certains utilisateurs authentifiés, l'accès à certaines rubriques sur le site public et dans l'espace privé :

 


Avec la possibilité de modifier le statut de l'auteur pour l'une de ces rubriques (on peut par exemple décider de donner à un administrateur restreint uniquement un rôle de rédacteur sur une rubrique protégée) :

 


Le plugin offre le choix entre 4 niveaux de protection des pièces jointes (sauf si le paramétrage par fichier est utilisé) :

 

 
Si le plugin “ciag : Groupes d'auteurs” est activé, on peut créer des groupes d'auteurs :

 


On peut leur affecter des auteurs et des espaces collaboratifs :

 


Dans la page de gestion d'un espace collaboratif, ses membres figurent avec, le cas échéant, l'indication du groupe d'auteurs qui les rend membres de cet espace :

 


En cliquant le bouton « Groupes d'auteurs », on peut modifier les listes des groupes d'auteurs affectés à cet espace collaboratif :

 

Version successives du plugin
La version 1.1 du 13/01/2011 corrige deux points.
La version 1.2 du 14/01/2011 offre le choix entre 4 niveaux de protection des pièces jointes (sauf si le paramétrage par fichier est utilisé) :

- aucune protection

- protection simple (ajout d'une clé dans le nom du fichier)

- filtre d'accès (sans protection simple)

- filtre d'accès (avec protection simple)
La version du 02/11/2011 corrige plusieurs points.
La version du 28/11/2011 ajoute une gestion par groupe d'auteurs, ainsi que la compatibilité avec SPIP 3. Pour disposer de la gestion par groupes d'auteurs, il est nécessaire d'activer le plugin ciag qui figure également dans le fichier ZIP ci-joint.
La version du 16/01/2012 permet désormais d'accéder au sous menu « suivre / gérer les forums ». Elle apporte également la compatibilité avec les pièces jointes dans les forums.
La version du 16/04/2012 corrige un problème de compatibilité avec SPIP 3.
La version du 25/04/2012 apporte une compatibilité avec une volumétrie d'auteurs élevée.
La version du 02/05/2012 corrige une incompatibilité introduite par la version 3.0.0-rc de SPIP.
La version du 07/01/2013 ajoute des mécanismes de prévention supplémentaires.
La version du 13/01/2014 prend en compte d'une constante à placer dans le fichier mes_options.php (ou un autre fichier d'options) :

define('_CIAR_DOC_PAS_ATTACHE', 'oui');

Si cette constante a pour valeur ‘oui', alors les pièces jointes ne seront pas retournées en ‘attachment'.
La version du 03/06/2014 intègre la version 1.21 du plugin ciautoriser.
La version du 17/09/2015 apporte une légère évolution fonctionnelle des accès restreints.
La version 2.8.0 du 08/04/2016 prend en compte une incompatibilité avec SPIP 3.0 signalée par deux internautes.
La version du 27/03/2018 apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 3.1 apporte la compatibilité avec SPIP 4.0
La version 3.2 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
La version 3.3 apporte la compatibilité avec SPIP 4.2
La version 3.4 apporte la compatibilité avec PHP 8.2


ciarchive : statut archivé pour les articles
Equipement — 2013-06-05T10:00:00Z

		Ce plugin ajoute un statut supplémentaire pour les articles, le statut « archivé ».
		
Table of contents
 Les objectifs de ce plugin
 Pourquoi un plugin supplémentaire sur ce sujet ?
 Compatibilité
 Installation
 Fonctionnalités
 Dernière version du plugin
Les objectifs de ce plugin
L'objectif de ce plugin est de disposer d'un statut supplémentaire pour les articles, le statut « archivé ».
Pourquoi un plugin supplémentaire sur ce sujet ?
L'objectif est similaire au plugin “Archive”, toutefois contrairement à ce dernier :

- il ajoute un statut “archivé” à la liste des statuts actuellement proposés pour les articles (et non pas une option “archivé”).

- l'approche technique est radicalement différente.

- il ne crée pas de champ ou de table suppléméntaire.

- il est compatible avec SPIP 3 et avec SPIP 4.1.

- je n'ai pas noté d'incompatibilité avec d'autres plugins.

- etc.
Compatibilité
- Le plugin est compatible avec SPIP 3.2, 4.0, 4.1, 4.2.

- Il est compatible avec PHP 7.4, 8.0, 8.1, 8.2.
Installation
Le plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html .
Fonctionnalités
Lorsque que l'on affecte le statut « archivé » à un article, il n'apparaît plus sur le site public ainsi que dans l'espace privé de SPIP.

 


A noter que seul le statut de l'article change. L'article reste lié à sa rubrique d'origine, même s'il n'apparaît plus dans cette rubrique.
Dans l'espace privé de SPIP, on peut retrouver un article qui a le statut « archivé », via le menu Edition > Archives, et modifier cet article (y compris son statut).

 


 


On peut également, consulter les articles archivés d'une rubrique particulière.
Le moteur de recherche de l'espace privé permet également de retrouver un article archivé.
Le détail des fonctionnalités de ce plugin figure dans la documentation  ci-jointe.
Remarques :
 Sur le site public, le critère statut=archive permet d'afficher les articles archivé (c'est le fonctionnement standard de SPIP qui s'applique).
 Une rubrique (sans sous rubrique) dont tous les articles sont archivés n'aura pas le statut publié (c'est le fonctionnement standard de SPIP qui s'applique).
Dernière version du plugin
La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 1.4 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
La version 1.4.1 supprime la compatibilité avec la version 2 de SPIP et est compatible avec SPIP 4.2.
La version 1.5 apporte la compatibilité avec PHP 8.2.


cibc : bannière d'avertissement pour les cookies
Equipement — 2014-10-28T07:33:25Z

		L'objectif de ce plugin est d'informer l'utilisateur et de recueillir son consentement (ou son refus) sur l'utilisation par le site de cookies de mesure d'audience.
ATTENTION : Ce plugin ne sera plus maintenu.
Ce plugin est sorti le 28 octobre 2014, il y a bientôt 11 ans. Lors de sa phase d'élaboration, la librairie tarteaucitron n'était pas encore disponible (le premier commit de cette librairie date du 14/09/2014). Cette dernière semble être utilisée par plus de 110 000 sites web selon le site builtwith. Aussi, il est temps pour le plugin CIBC de tirer sa révérence.
		
Table of contents
 Les objectifs de ce plugin
 Compatibilité
 Pourquoi un plugin supplémentaire sur ce sujet ?
 Fonctionnalités
 Un choix entre 10 feuilles de style
 Le contenu de la bannière est configurable
 Le comportement de la bannière est configurable
 Exemple d'adaptation de squelette si on utilise Google Analytics
 En cas de problème
 Dernière version du plugin
Les objectifs de ce plugin
Le premier objectif de ce plugin est d'informer l'utilisateur et de recueillir son consentement (ou son refus) sur l'utilisation par le site de cookies de mesure d'audience (par exemple Google Analytics, Xiti, etc.).
Pour en savoir plus : délibération de la CNIL n° 2013-378 et des contrôles à partir du mois d'octobre.
ATTENTION : CIBC concerne uniquement les cookies de mesure d'audience.

Remarque : Pour gérer les différentes fonctionnalités déposant des cookies (vidéos de youtube, vidéos de Dailymotion, publicités, boutons sociaux, autres modules insérés sur les pages de votre site) il est possible d'utiliser une solution de gestion de tag. Pour en savoir plus : solutions de gestion de tag.
Le second objectif de ce plugin est d'offrir des solutions pour désactiver, le cas échéant, les cookies en question.
Le troisième objectif de ce plugin est d'offrir une bannière totalement configurable en termes de comportement, de contenu et d'apparence, avec en particulier le choix entre plusieurs feuilles de style (et la possibilité d'ajouter des feuilles de style).
Le quatrième objectif est d'offrir une compatibilité avec :
 les différentes versions de SPIP
 le responsive web design
 les sites qui n'utilisent pas la balise #INSERT_HEAD sur le site public
 le multilinguisme
Compatibilité
CIBC version 1.9 est compatible avec SPIP 3.2, 4.0, 4.1, 4.2.

CIBC version 1.9 est compatible avec PHP 7.4, 8.0, 8.1, 8.2.
Pourquoi un plugin supplémentaire sur ce sujet ?
Les principales différences avec les autres plugins sur ce sujet sont les suivantes :
 Le mode de désactivation des cookies est configurable.
 Le comportement de la bannière est configurable.
 Le plugin offre le choix entre 10 feuilles de style (et la possibilité d'en ajouter).
 Le plugin est compatible avec SPIP 2.1 (sans devoir ajouter d'autres plugins), avec SPIP 3.0 et avec SPIP 3.2.
 Etc.
Remarque : le plugin CIBC a été élaboré avant la publication des autres plugins sur ce sujet.
Fonctionnalités
Les fonctionnalités sont détaillées dans la document PDF ci-joint.
Un choix entre 10 feuilles de style
Le plugin offre le choix entre 10 feuilles de style, via une liste déroulante dans la page de configuration du plugin (et il est possible d'ajouter des feuilles de style).
En bas fond noir (ou bien en haut) :

  


En bas fond clair (ou bien en haut) :

  


En bas au centre :

  


En bas à droite :

  


En bas fond bleu (ou bien en haut) :

  


En bas fond blanc (ou bien en haut) :

  


Remarque : si la largeur de l'écran est réduite (par exemple à environ 300 pixels), la bannière s'adapte automatiquement.
Le contenu de la bannière est configurable
On peut renseigner le texte, avec les mêmes possibilités de mise en forme que le texte d'un article. Le texte peut contenir de liens, etc. Le texte peut utiliser les blocs multilingues de SPIP.
On peut afficher ou non, les boutons suivants :

- En savoir plus

- Accepter

- Refuser
L'adresse de la page qui devra s'afficher lorsque l'on cliquera sur le bouton “En savoir plus” est configurable.
Par exemple, on peut choisir de n'afficher aucun bouton et de mettre un lien dans le texte :

  

Le comportement de la bannière est configurable
On peut choisir le comportement de la bannière :
 La poursuite de la navigation vaut acceptation.
 Ou bien la poursuite de la navigation ne vaut pas acceptation.
 Ou bien la bannière disparaît après 10 secondes et la poursuite de la navigation vaut acceptation.
On peut choisir le mode de désactivation des cookies :
 La page “En savoir plus” ou “Refuser” indique comment désactiver les cookies.
 Désactiver la pose de cookies dans l'attente de l'acceptation (1).
 Désactiver la pose de cookies lors du refus (1).
(1) Nécessite une adaptation légère de certains squelettes, qui est décrite à l'annexe 4.4 de la documentation.
Le plugin permet de choisir la durée (en jours) du cookie qui enregistre le refus ou l'acceptation du visiteur (au plus 395 jours soit 13 mois).
Le plugin permet de choisir si on souhaite ou non afficher l'avertissement pour les cookies aux auteurs authentifiés.

 


 

Exemple d'adaptation de squelette si on utilise Google Analytics
Dans le ou les squelettes qui contiennent le code javascript de Google Analytics (seul un extrait du code figure) :

Il convient de conditionner ce script javascript avec le test suivant :
if (typeof cibcOptOut != 'function' || cibcOptOut()!="oui"){ … le script tiers … }
C'est-à-dire pour Google Analytics (seul un extrait du code figure) :

Attention : 

a) Dans le cas où le code javascript de Google Analytics figure entre les balises  et , il convient d'ajouter, avant le code javascript de Google Analytics, la ligne suivante :

[(#PLUGIN{cibc}|oui) #CIBC_AVERTISSEMENT ]

En effet, il faut que le code de Google Analytics figure après celui du plugin CIBC.

Si le plugin “Google Analytics” est utilisé, la ligne précitée doit figurer avant #INSERT_HEAD.
b) Dans le cas où l'on adapte les squelettes (cf. exemple ci-dessus), il est inutile de mettre des liens de désactivation dans la page « En savoir plus ».
En cas de problème
a) Vérifier la configuration du plugin (cf. documentation)
b) Adapter certains squelettes du site (cf. annexe 4.4 de la documentation).

Exemples :

cibc : bannière d'avertissement pour les cookies

cibc : bannière d'avertissement pour les cookies
c) S'assurer que le site charge une seule fois la librairie jquery

Exemples :

cibc : bannière d'avertissement pour les cookies

cibc : bannière d'avertissement pour les cookies
d) Si le style de la bannière ne convient pas, recopier dans le dossier “squelettes”, du site, le fichier de style (sélectionné dans la configuration du plugin) cibc/_css/cibc...css et modifier cette copie.
Dernière version du plugin
Version 1.1 du plugin :

Ajout de la fonctionnalité suivante, qui concerne uniquement le cas où l'on a sélectionné le mode de désactivation des cookies “La page 'En savoir plus' ou 'Refuser' indique comment désactiver les cookies” et que l'on met des liens de désactivation dans l'article « En savoir plus » :

Si le texte de l'article « En savoir plus » contient 
 alors même si l'URL de l'article « En savoir plus » évolue, le plugin pourra quand même l'identifier grâce au div précité.
La version du 08/12/14 de la documentation ajoute des exemples de configurations (au chapitre 3.7) et un tableau des avantages et inconvénients des différents modes de désactivation des cookies (au chapitre 3.5).
La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 1.6 apporte la compatibilité avec SPIP 4.0.
La version 1.7 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1.
La version 1.8 apporte la compatibilité avec SPIP 4.2.
La version 1.9 apporte la compatibilité avec PHP 8.2.


cibloc : mettre en forme le texte d'articles avec des blocs
Equipement — 2019-07-08T09:34:00Z

		La VERSION 2 du plugin CIBLOC est configurable depuis l'espace privé de SPIP. Le plugin CIBLOC permet de mettre en forme le texte d'articles avec des blocs, des colonnes, des icônes et des boutons.
		
Table of contents
 Compatibilité
 IMPORTANT
 Les objectifs de ce plugin
 Exemples de blocs et/colonnes proposés par le plugin CIBLOC
 Vidéo de démonstration
 Installation
 Migration de la version 1 à la version 2
 Utilisation sous SPIP 3.0 ou SPIP 3.1
 Comment insérer un bloc et/ou des colonnes ?
 Liste des blocs
 Liste des multi colonnes
 Liste des ensembles de blocs et/ou multi colonnes
 Liste des ensembles qui sont presque des pages
 Comment insérer une icône ?
 Comment insérer un bouton ?
 Un plugin configurable
 Versions successives du plugin CIBLOC
Compatibilité
La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.
IMPORTANT
Si la version 1 de CIBLOC est déjà installée, il est indispensable de lire le paragraphe ‘Migration de la version 1 à la version 2'.

Si le site est sous SPIP 3.0 ou SPIP 3.1, il convient de lire le paragraphe ‘Utilisation sous SPIP 3.0 ou SPIP 3.1'
Les objectifs de ce plugin
Le plugin CIBLOC offre des blocs, des colonnes, des icônes et des boutons :
 17 blocs
 8 multi colonnes
 12 ensembles de blocs et/ou colonnes prêts à l'emploi
 186 icônes
 14 boutons
Les listes des blocs, colonnes, ensembles, icônes et boutons sont configurables depuis l'espace privé de SPIP.
Les blocs et les colonnes sont “responsives”.
Les fonctionnalités sont détaillées dans le document de description du plugin CIBLOC ci-joint au format PDF.
Exemples de blocs et/colonnes proposés par le plugin CIBLOC

 

Vidéo de démonstration
Cliquer ci-dessous pour afficher cette vidéo :

vidéo
Installation
Il nécessite d'installer le plugin CISTYLE (qui figure également dans la colonne de droite de la présente page, dans la section "Autres téléchargements).
Remarque : Si le site utilise le plugin CISF, il est nécessaire d'utiliser au moins la version 4 de CISF.
Migration de la version 1 à la version 2
La version 1 de CIBLOC utilisait des fichiers XML de configuration. La version 2 du plugin CIBLOC ne les utilise pas. En effet, la version 2 est configurable depuis l'espace privé de SPIP.

Par ailleurs la version 2 de CIBLOC nécessite d'installer immédiatement le plugin CISTYLE.

Remarques :
 Dans le cas où le site utilise déjà CIBLOC version 1 dans le dossier /plugins/ , après avoir copié CIBLOC version 2 et CISTYLE dans le dossier /plugins/, il est nécessaire d'activer immédiatement le plugin CISTYLE.

A noter que la page [Configuration] / [Gestion des plugins] affichera le message suivant : “Impossible d'activer le plugin ../plugins/cibloc Nécessite le plugin CISTYLE en version ≥ 1.0.0.”. Il suffit d'activer CISTYLE et SPIP activera alors CIBLOC version 2.
 Dans le cas où le site utilise déjà CIBLOC version 1 dans le dossier /plugins-dist/ , après avoir copié CIBLOC version 2 et CISTYLE dans le dossier /plugins-dist/, il est nécessaire de déclencher l'activation de ces plugins, par exemple en affichant la page [Configuration] / [Gestion des plugins].
Utilisation sous SPIP 3.0 ou SPIP 3.1
L'utilisation de CIBLOC sous SPIP 3.0 et sous SPIP 3.1 présente plusieurs problèmes qui sont détaillés en annexe de la documentation. Ces problèmes ne se produisent pas sous SPIP 3.2.
Comment insérer un bloc et/ou des colonnes ?
a) Aller dans la page qui permet de modifier le texte de l'article.

b) Cliquer à l'endroit du texte où l'on veut insérer le bloc.

c) Cliquer sur le nouveau bouton « Choisir un bloc ».

 


d) Une liste s'affiche. Faire défiler verticalement la liste pour voir les blocs proposés.

e) Cliquer sur le bloc souhaité.

 


f) Afficher l'article sur le site public (en prévisualisation s'il n'est pas publié).

 


g) Modifier le texte de l'article afin de remplacer le texte fictif du bloc par votre texte.

 

Liste des blocs

 



  



  



 



 

Liste des multi colonnes

 



 

Liste des ensembles de blocs et/ou multi colonnes
Ces ensembles de blocs sont des combinaisons prêtes à l'emploi de blocs et/ou de colonnes. Il suffit de cliquer sur l'un des ensembles pour l'insérer dans le texte de l'article.

 



 



 



 

Liste des ensembles qui sont presque des pages
Les ensembles suivants constituent presque des pages prêtes à l'emploi.Il suffit de cliquer sur l'une des combinaisons pour l'insérer dans le texte de l'article.Une fois insérée, il est bien sûr possible de supprimer une partie de la combinaison, d'ajouter d'autres blocs, etc.

  

Comment insérer une icône ?
a) Aller dans la page qui permet de modifier le texte de l'article.

b) Cliquer à l'endroit du texte où l'on veut insérer l'icône.

c) Cliquer sur le nouveau bouton « Choisir une icône ».

 


d) Dans la liste qui s'affiche, cliquer sur une icône pour l'insérer dans le texte

Cette liste comprend une sélection de 186 icônes (FontAwesome) triées par signification ou forme.

 


Il est possible de choisir l'échelle de l'icône, son alignement et sa couleur.

Exemple d'icône ainsi générée :


Comment insérer un bouton ?
a) Aller dans la page qui permet de modifier le texte de l'article.

b) Cliquer à l'endroit du texte où l'on veut insérer le bouton.

c) Cliquer sur le nouveau bouton « Insérer un bouton ».

 


d) Renseigner le titre et l'adresse du lien puis sélectionner l'alignement et la couleur.

 

Un plugin configurable
La version 2 du plugin est configurable depuis l'espace privé de SPIP.
Depuis l'espace privé de SPIP, on peut :
 Configurer les blocs, les multi colonnes, les ensembles de blocs
 Configurer les boutons, les couleurs des icônes, la liste des icônes, les points divers
 Créer un nouveau bloc
 Créer un nouvel ensemble de blocs
 Choisir une palette de couleurs
 Configurer le style d'affichage de la liste des blocs
 Exporter ou importer la configuration
La configuration est facultative. En effet, les blocs disposent d'une configuration par défaut, etc.

Seul un administrateur du site peut configurer le plugin.

Pour le configurer, il convient de se placer dans l'espace privé de SPIP et de cliquer sur le menu [Configuration] / [Configurer les blocs, etc.]
La page ci-dessous s'affiche :

 


Exemple de choix d'une palette de couleurs :

 


Exemple de configuration d'une palette personnalisée :

 


Exemple de configuration d'un bloc :

 


Pour en savoir plus, consulter le document de description du plugin CIBLOC ci-joint au format PDF.
Versions successives du plugin CIBLOC
 Version 1.* : Version initiale.
 Version 2 : 
- Est nettement plus facile à configurer. En effet, elle est configurable depuis l'espace privé de SPIP et elle permet d'exporter, d'importer ou d'imposer une configuration. 
- Facilite l'ajout d'un bouton.

- Ajoute des blocs en couleurs.

- Offre au rédacteur le choix entre plusieurs couleurs pour les icônes.

- Permet à l'administrateur du site de créer des ensembles de blocs (même si la configuration est imposée), ce qui peut également être utilisé pour des textes types d'article.

- Permet d'aligner le texte à gauche, au centre, à droite.

- Prend en compte le cas où la variable de SPIP ‘debut_intertitre' a été personnalisée.

- Apporte la compatibilité avec le plugin “Crayons” (sous SPIP 3.1 et SPIP 3.2).
 Version 2.1 : Prend en compte le cas particulier des sites qui utilisent sjcycle ou Bootstrap ou FontAwesome.
 Version du 02/11/2020 : CISTYLE (livré avec CIBLOC) passe en version 1.1.
 Version 2.2 : Apporte la compatibilité avec PHP 7.2, 7.3, 7.4 et avec SPIP 4.0.
 Version 2.3 : Apporte la compatibilité avec PHP 8.0 et 8.1 et avec SPIP 4.1
 Version 2.3.1 : Contourne des incompatibilités avec l'ancien PHP 5.4.
 Version 2.4 : Apporte la compatibilité avec SPIP 4.2.
 Version 2.5 : Apporte la compatibilité avec PHP 8.2.


ciimport : plugin “importation des auteurs et des mots-clés”
Equipement — 2011-02-09T10:22:00Z

		Le plugin « ciimport » permet d'importer une liste d'auteurs ou une liste de mots-clés, depuis un fichier au format CSV, afin d'éviter de les saisir manuellement.
		
Table of contents
 Les fonctionnalités de ce plugin
 Compatibilité
 Installation
 Utilisation pour importer des auteurs
 Dernière version du plugin
Les fonctionnalités de ce plugin
Le plugin « ciimport » permet d'importer une liste d'auteurs ou une liste de mots-clés, depuis un fichier au format CSV, afin d'éviter de les saisir manuellement.
Compatibilité
CIIMPORT version 3.3 est compatible avec SPIP 3.2, 4.0, 4.1, 4.2.

CIIMPORT version 3.3 est compatible avec PHP 7.4, 8.0, 8.1, 8.2.
Il ne surcharge aucune fonction.
Installation
Le plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html
Utilisation pour importer des auteurs
L'utilisation du plugin est décrite de manière détaillée dans la documentation jointe au présent article.
Dernière version du plugin
Version du 25/04/2012 : si le plugin de gestion par groupe d'auteurs est activé, la fonctionnalité d'importation d'une liste d'auteurs affichera la possibilité (facultative) de choisir le groupe d'auteurs qui sera affecté à tous les auteurs importés.
Version du 15/06/2012 : ajoute de la compatibilité avec SPIP 3.
Version du 21/02/2013 : ajoute l'export de listes d'auteurs.
Version du 28/06/2013 : ajoute l'export des mots-clés et de l'export des contributions d'un forum.
Version du 27/03/2018 : apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
Version du 22/01/2019 : apporte la possibilité d'exporter une liste d'articles.
Version du 22/06/2021 : apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
Version du 15/06/2022 : apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1.
Version 3.2 : apporte la compatibilité avec SPIP 4.2.
Version 3.3 : apporte la compatibilité avec PHP 8.2.


cilien : Liste des liens
Equipement — 2014-07-22T07:37:54Z

		L'objectif est de disposer de la liste des liens insérés dans le contenu éditorial et de pouvoir utiliser cette liste avec un outil de vérification des liens rompus de son choix.
Le plugin permet également de déconcentrer, aux administrateurs restreints, la vérification des liens situés dans l'arborescence de leurs rubriques.
		
Table of contents
 Les objectifs de ce plugin
 Compatibilité
 Pourquoi un plugin supplémentaire sur ce sujet ?
 Fonctionnalités
 Utilisation
 Versions successives
Les objectifs de ce plugin
L'objectif est de disposer de la liste des liens insérés dans le contenu éditorial et de pouvoir utiliser cette liste avec un outil de vérification des liens rompus.
Compatibilité
CILIEN version 2.5 est compatible avec SPIP 3.2, 4.0, 4.1, 4.2.

CILIEN version 2.5 est compatible avec PHP 7.4, 8.0, 8.1, 8.2.
Pourquoi un plugin supplémentaire sur ce sujet ?
Les principales différences entre le plugin “cilien” et le plugin “Test URL” sont les suivantes :
 Comme certains hébergeurs ne permettent pas à SPIP d'appeler des URL externes, le plugin cilien laisse la phase de test des liens aux outils de vérification des liens rompus (par exemple un addon pour Firefox).
 Le plugin cilien permet de déconcentrer, aux administrateurs restreints, la vérification des liens situés dans l'arborescence de leurs rubriques.
 Le plugin cilien est stable (il n'est pas en phase de test).
 Le plugin cilien recense également les liens de redirection des articles virtuels.
 Le plugin cilien recense aussi des liens tels que [titre du lien->spip.php?page=article&id_article=8] et [titre du lien->IMG/odt/document.odt].
 Le plugin cilien stocke dans un table, de manière incrémentale, les liens recensés. Ceci diminue les temps de traitement et permet d'être compatible avec des sites de forte volumétrie. Le plugin cilien a été testé sur un site contenant près de 50 000 liens insérés dans le contenu éditorial.
 Etc.
Remarque : le plugin cilien a été conçu et réalisé avant la publication du plugin “Test URL”.
Fonctionnalités
Le plugin recense les liens renseignés manuellement par les auteurs dans :
 Les articles (sur tous les champs susceptibles de contenir du texte),
 Les rubriques (sur tous les champs susceptibles de contenir du texte),
 Les sites référencés (sur le champ url du site).
Le lien de redirection d'un article virtuel est pris en compte par le plugin.
Le plugin ne recense pas les liens internes générés par SPIP. En effet, SPIP les génère uniquement si l'objet existe.
Comme les forums ne sont pas modifiables, le plugin ne mémorise pas leurs liens.
Ce plugin a été testé sur un site contenant près de 50 000 liens insérés dans le contenu éditorial.
Utilisation
L'utilisation du plugin est détaillée dans la documentation ci-jointe.
Versions successives
La version du 16/06/2016 ajoute les fonctionnalités suivantes :
 Remplacer un lien ou un domaine
 Recensement automatique de liens
 Vider le recensement des liens
La version du 27/03/2018 apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 2.3 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
La version 2.4 apporte la compatibilité avec SPIP 4.2.
La version 2.5 apporte la compatibilité avec PHP 8.2.


cimobile : plugin « détection et aiguillage des téléphones mobiles »
Equipement — 2011-09-20T13:12:32Z

		Le plugin « cimobile » détecte les téléphones mobiles et les aiguille vers le jeu de squelettes correspondant.
		
Table of contents
 Compatibilité
 Installation
 Utilisation
Pour détecter un mobile, il prend en compte le « User-Agent », un cookie, un paramètre d'URL, une URL spécifique pour mobile. Il n'utilise pas de script javascript. Il ne nécessite pas de modifier les squelettes du site classique.
Il offre simultanément plusieurs versions d'une même page, à partir de squelettes différents et en tenant compte des mécanismes de cache.
Il n'est pas intrusif vis-à-vis des fichiers de squelettes. En particulier, il évite de recourir à des préfixes dans le nom des squelettes (par exemple « iphone_article »). En effet, l'utilisation de préfixe présente plusieurs limites :

- elle est intrusive vis-à-vis des squelettes, puisqu'il est nécessaire d'utiliser des URL spécifiques tenant compte des préfixes (« iphone_ », « bberry_ », etc.). 
- les articles redirection ne fonctionneront pas lorsqu'on utilise la version mobile. Ils s'afficheront sans effectuer de redirection. En effet, SPIP déclenche une éventuelle redirection uniquement si la page demandée est une page « article ».

- les liens internes dans le texte d'un article (exemple : [lien->art44]) seront traduits par SPIP en liens vers la page du site classique.

- etc.
Le plugin « cimobile » ne fournit pas de squelettes spécifiques pour mobiles. La version 3 du plugin « iTwX », qui offre des squelettes spécifiques pour mobiles, est compatible avec Cimobile.
Compatibilité
Le plugin est compatible avec SPIP 2.0, SPIP 2.1 et SPIP 3.0svn.

Il est compatible avec PHP 5 (y compris PHP 5.3).

Il ne surcharge aucune fonction.
Installation
Le plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html
Comme le plugin « cimobile » ne fournit pas de squelettes spécifiques pour mobiles. Il est nécessaire d'installer aussi le plugin « iTwX » :

- la version 2 de « iTwX », adaptée pour « cimobile », est disponible à cette adresse. ATTENTION : elle n'est plus maintenue car elle a été remplacée par la version 3.

- la version 3 de « iTwX » est compatible nativement avec Cimobile. Elle est disponible à cette adresse.
Utilisation
L'utilisation du plugin est décrite de manière détaillée dans la documentation jointe au présent article.


cims : plugin “publication multi sites avec filtrage par rubrique”
Equipement — 2010-11-04T10:09:00Z

		Le plugin « cims » permet une publication multi sites avec filtrage par rubrique. Attention, il s'installe d'une manière particulière, il nécessite un fichier de paramétrage et il présente certaines incompatibilités.
		
Table of contents
 Fonctionnalités
 Compatibilité
 Installation
 Utilisation
 Aspect technique
L'objectif est d'éviter des saisies en double dans les cas suivants :

- un site intranet dont une partie des informations seulement doit être accessible en extranet ;

- un site intranet et un site internet d'un même organisme avec des d'informations communes, mais également des informations propres à chaque site ;

- etc.
En particulier, ce plugin peut permettre d'avoir un graphisme différent selon l'adresse utilisée pour consulter le site (sous réserve de mettre les squelettes et les feuilles de style dans des plugins).
Fonctionnalités
Ce plugin suppose que le site SPIP dispose de plusieurs adresses, par exemple une adresse intranet et une adresse internet.
Selon l'adresse utilisée pour consulter le site :

- seules certaines rubriques apparaîtront ;

- les plugins activés pourront être différents ;

- les paramètres de configuration de SPIP pourront être différents.
En mettant les squelettes et les feuilles de style dans des plugins, cela permet d'avoir un graphisme différent selon l'adresse utilisée pour consulter le site.
L'administrateur du site peut choisir sur quelles adresses une rubrique sera publiée.
Lorsqu'un administrateur restreint crée une rubrique, elle sera publiée sur l'adresse en cours.
Lors de l'activation du plugin, un paramètre permet d'affecter automatiquement à chaque rubrique l'adresse du site par défaut que l'on indique dans le fichier de paramétrage.
Compatibilité
CIMS version 2.8 est compatible avec SPIP 3.2, 4.0, 4.1, 4.2. 

CIMS version 2.8 est compatible avec PHP 7.4, 8.0, 8.1, 8.2.
Il surcharge le fichier inc/meta.php.
Il n'est pas compatible avec l'utilisation d'une base externe sous SPIP.
Il ne fonctionnera pas avec la procédure de mutualisation de code
Installation
Le plugin « cims » s'installe d'une manière particulière, qui est décrite dans le document de description joint au présent article. En particulier, il nécessite un fichier de paramétrage. Il est impératif de respecter cette procédure d'installation.
Utilisation
L'utilisation est décrite dans le document de description joint au présent article.
Aspect technique
Chaque site d'un multi sites doit pouvoir activer les plugins le concernant et doit avoir ses propres paramètres de configuration de SPIP.
Or SPIP 2 mémorise la liste des plugins activés, et les paramètres de configuration de SPIP, dans la base de données (table spip_meta) ainsi que dans des fichiers de cache.
Aussi, la solution consiste à disposer d'une table « spip_meta » et d'un répertoire « tmp » par site d'un multi sites.
Le plugin crée automatiquement, le cas échéant, la table spip_meta... du site en cours et la renseigne. Le nom de cette table propre à chaque site sera “spip_cims_meta” suivi du code du site tel qu'il est défini dans le fichier de paramétrage.
Il crée automatiquement, au sein du répertoire « tmp », un répertoire propre à chaque site dont le nom sera « tmp » suivi du code du site tel qu'il est défini dans le fichier de paramétrage.
Pour en savoir plus, consulter le document “Etude d'architecture du plugin de publication multi sites.pdf”.
Le schéma général de la solution est le suivant :

  


La version du 27/03/2018 apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 2.6 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
La version 2.7 apporte la compatibilité avec SPIP 4.2.
La version 2.8 apporte la compatibilité avec PHP 8.2.


cinotif : Notification sur abonnement
Equipement — 2016-01-07T07:30:00Z

		Ce plugin permet de s'abonner pour être averti, par messagerie, lorsque certains événements surviennent sur le site ou sur une partie du site.
		
Table of contents
 Les objectifs de ce plugin
 Pourquoi un plugin supplémentaire sur ce sujet ?
 Compatibilité
 Installation
 Fonctionnalités
 Exemples d'utilisation
 Illustration en image
 Version 2 du plugin
Les objectifs de ce plugin
L'objectif est qu'une personne puisse s'abonner pour être avertie, par messagerie, lorsque certains événements surviennent sur le site ou sur une partie du site.
Pourquoi un plugin supplémentaire sur ce sujet ?
SPIP offre un suivi de l'activité éditoriale, mais pas sur abonnement. Certains plugins étendent ces possibilités de notification, mais pas sur abonnement. Par ailleurs, des plugins offrent la possibilité de s'abonner à des lettres d'actualité, mais pas à des notifications.
Compatibilité
- La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.

- Il est compatible en particulier avec les plugins suivants : “CIAR : accès restreints” version 1.52 ou supérieure, “CISQUEL : squelettes de base” version 1.9 ou supérieure, “CISF : saisie facile” toutes versions, “CIMS : publication multi sites avec filtrage par rubrique” toutes versions.

- Il n'est pas compatible en particulier avec les plugins “Notifications” et “Accès Restreint 3”.
Installation
Il convient de s'assurer préalablement que l'hébergeur permet à SPIP d'envoyer des messages électroniques. 
Attention : si le plugin CIAR est activé, il est indispensable que sa version soit 1.52 ou supérieure, sinon le plugin de notification sur abonnement ne fonctionnera pas.
Le plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html .
Si le plugin « CISQUEL : squelettes de base », version 1.9 ou supérieure, est activé, il n'y a rien d'autre à faire.
Dans le cas contraire, il convient d'ajouter, au squelette de la page d'accueil, des rubriques et des articles, un lien pour s'abonner et un lien pour se désabonner avec les URL suivantes définies au chapitre « 4.2 Installation » de la documentation ci-jointe.
Fonctionnalités
Le détail des fonctionnalités de ce plugin figure dans la documentation ci-jointe.
L'objectif est qu'une personne puisse s'abonner pour être avertie, par messagerie, lorsque certains événements surviennent sur le site ou sur une partie du site.
On peut s'abonner à l'ensemble du site ou seulement à certaines branches du site ou seulement à certains articles (ou forum) du site.
Les événements auxquels on peut s'abonner :

- publication d'un article dans les actualités (si le plugin cisquel est utilisé).

- publication d'un article.

- proposition d'un article.

- modification du texte d'un article publié.

- ajout d'un document à un article publié.

- ajout d'un commentaire dans un forum (ou un article) publié.
La liste des événements peut être restreinte par l'administrateur du site. Par ailleurs, il est nécessaire d'être authentifié pour pouvoir s'abonner à l'événement « proposition d'un article ».
Si on s'est authentifié sur le site, il n'est pas nécessaire de renseigner l'adresse électronique.
On peut se désabonner du site. Chaque message de notification contient un lien pour se désabonner.
Cette possibilité de notifications automatiques sur abonnement est complémentaire au suivi de l'activité éditoriale de SPIP (qui n'est pas sur abonnement et qui est assez limité). Ce dernier reste opérationnel et un mécanisme évite les envois de notification en double.
Les notifications sur abonnement n'entrent pas en concurrence avec les lettres d'actualités, car elles répondent à un besoin différent (l'envoi d'un texte récapitulant les dernières actualités).
Les notifications sur abonnement sont proches des flux RSS. Ces deux moyens de communication sont d'ailleurs complémentaires. En effet, certaines personnes préfèrent recevoir un message électronique, alors que d'autres préfèrent s'abonner à un flux RSS.
Exemples d'utilisation
Si on souhaite suivre tous les échanges d'un forum publié sur le site public, on peut s'abonner à l'ajout de commentaire dans ce forum (ou cet article). Il est également possible de s'abonner à tous les commentaires postés sur le site.
Dans le cas d'un site d'un organisme, qui traite de thèmes différents, on peut souhaiter être informé chaque fois qu'un article est publié dans une certaine branche du site. Dans ce cas on s'abonne à la publication d'article dans cette branche uniquement.
Dans le cas d'un site consacré à un métier ou à un projet, on peut vouloir être informé à chaque publication d'article sur l'ensemble du site.
Un administrateur restreint peut s'abonner aux propositions d'articles des branches qu'il administre, afin de pouvoir examiner ces articles proposés et, le cas échéant, les publier. En effet, SPIP peut signaler par message électronique qu'un article est proposé dans le site, mais il ne peut pas cibler des destinataires en fonction de la rubrique dans laquelle l'article est proposé.
Chaque membre d'un espace collaboratif peut vouloir être averti lorsqu'une modification est apportée aux articles publiés dans cet espace collaboratif.
Dans le cas d'un article WIKI publié sur le site public, on peut souhaiter être informé chaque fois que cet article est modifié et chaque fois qu'un document est ajouté à cet article.
Recommandation : Si le site est consulté par plus de 20 000 visiteurs uniques par mois, il est préférable d'offrir une « newsletter » et de réserver les notifications sur abonnement aux auteurs du site.
Illustration en image
Formulaire d'abonnement (son contenu varie en fonction de la configuration du plugin, il varie si l'on est authentifié ou non, il varie si l'on est sur la page d'accueil ou une rubrique ou un article) :

 


En fonction des utilisations envisagées (cf. exemples d'utilisation), l'administrateur du site peut restreindre les événements proposés à l'abonnement (une aide en ligne est offerte sur ce sujet). Ces choix de configuration sont pris en compte dans les formulaires d'abonnement ainsi que lors de l'envoi des notifications. Il est également possible de limiter l'abonnement aux personnes authentifiées, de ne pas accepter de nouveaux abonnements.

 


L'administrateur du site peut consulter la liste des abonnés, la liste des abonnements ainsi que le suivi de l'envoi des notifications. Par ailleurs, un administrateur restreint peut consulter la liste des abonnés à chacune de ses rubriques.

 

Version 2 du plugin
La version 2 des notifications sur abonnement offre le choix entre 3 formulaires d'abonnement aux possibilités très différentes.

Par ailleurs, elle offre, de manière facultative, une interface avec le gestionnaire de liste de diffusion “SYMPA” (Système de Multi-Postage Automatique)
Pour plus de détails, consulter la documentation ci-jointe.
La version du 06/04/2018 apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 3.0 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
La version 3.1 apporte la compatibilité avec SPIP 4.2.
La version 3.2 apporte de nouvelles possibilités de paramétrage (cf. le fichier exemples_parametrage.txt situé à la racine du plugin).
La version 3.3 apporte la compatibilité avec PHP 8.2.


CIOIDC : OpenID Connect
Equipement — 2024-09-19T07:24:00Z

		Pour s'authentifier avec OpenID Connect.
		
Table of contents
 Les objectifs de ce plugin
 Pourquoi OpenID Connect (OIDC) et pas OpenID ?
 La librairie utilisée par ce plugin
 Les fonctionnalités ajoutées par ce plugin
 Documentation
 Installation
 Compatibilité
 Paramétrage par constantes
 Pipelines offerts
 Existe-t-il un serveur de test ?
Les objectifs de ce plugin
L'objectif est d'utiliser le login et le mot de passe stocké dans un serveur d'authentification OpenID Connect (OIDC) au lieu de ceux qui sont stockés dans SPIP.
Cela évite à l'utilisateur de gérer ses mots de passe dans plusieurs sites (ou applications) et cela lui évite de s'authentifier à nouveau lorsqu'il passe d'un site à un autre.
Par ailleurs, OpenID Connect permet d'obtenir des informations sur l'utilisateur (par exemple : le prénom et le nom).
Enfin, le protocole OpenID Connect (OIDC) sécurise les échanges entre le client OIDC et le serveur OIDC.
Pourquoi OpenID Connect (OIDC) et pas OpenID ?
Les protocoles OpenID 1.0 et OpenID 2.0 ont été abandonnés (« deprecated ») et il est proposé d'utiliser OpenID Connect (OIDC) à la place.
OpenID Connect est de plus en plus utilisé. Plus de 3600 entreprises utilisent ce protocole selon le site theirstack.
La librairie utilisée par ce plugin
Ce plugin utilise la librairie Jumbojett/OpenID-Connect-PHP. Elle est livrée avec le plugin afin d'éviter de devoir l'installer.
Les fonctionnalités ajoutées par ce plugin
On peut configurer ce plugin pour offrir une authentification OIDC ou bien une authentification hybride (SPIP ou un serveur OIDC).
Il est possible d'offrir à l'utilisateur le choix entre plusieurs serveurs OIDC, en configurant des serveurs OIDC additionnels.
Il affiche automatiquement le bouton AgentConnect lorsque l'adresse du serveur d'authentification est une adresse de AgentConnect. Idem pour FranceConnect et ProConnect.
Par configuration on peut choisir de comparer l'identifiant renvoyé par le serveur OIDC au contenu du champ de SPIP contenant l'email des auteurs, ou bien à celui contenant le login des auteurs.
L'authentification sur le site public redirige ensuite vers la page en cours, idem lors de la déconnexion.
On peut configurer le plugin CIOIDC pour que, si l'authentification sur le serveur OIDC a réussi mais que l'auteur n'existe pas dans SPIP, l'auteur soit créé automatiquement (avec le statut “rédacteur” ou bien “visiteur”).
Il offre un pipeline pour effectuer d'autres actions dans le cas précité.
Les auteurs dont le statut est “à la poubelle” ne sont jamais pris en compte.
Il ajoute un pipeline pour effectuer d'autres actions avec les informations sur l'utilisateur (par exemple : identifiant, prénom et nom).
Il permet d'activer une sécurité anti hack, pour empêcher certaines manipulation d'identifiant dans SPIP.
Il permet d'activer une sécurité anti BOT.
Un paramétrage par fichier est possible. Il est prioritaire sur la configuration du plugin dans l'espace privé.
Si le plugin CICAS est actif, le fonctionnement du plugin CIOIDC est suspendu.
Documentation
Pour en savoir plus, consulter la documentation ci-jointe (fichier au format PDF).
Installation
L'installation est décrite dans le fichier suivant, qui figure à la racine du plugin : cioidc/README.md
Compatibilité
La compatibilité avec les versions de SPIP et de PHP est décrite dans le fichier suivant, qui figure à la racine du plugin : cioidc/README.md
Paramétrage par constantes
Il convient de consulter le fichier suivant, qui figure à la racine du plugin : cioidc/_config_cioidc.txt
Pipelines offerts
Il convient de consulter le fichier suivant, qui figure à la racine du plugin : cioidc/README.md
Existe-t-il un serveur de test ?
Il existe un serveur de test (oidctest.wsweet.org). Pour tester, suivre la procédure ci-dessous :
a) Configurer le plugin de la manière suivante :
Mode d'authentification : OpenID Connect ou SPIP
Nom du serveur d'authentification [Obligatoire] : oidc Test

URL du serveur OpenID Connect [Obligatoire] : https://oidctest.wsweet.org/

Nom du client [Obligatoire] : private

Secret du client [Obligatoire] : tardis

Identifiant de l'utilisateur dans SPIP [Obligatoire] : email

Identifiant de l'utilisateur dans le serveur OpenID Connect [Obligatoire] : email

Scopes additionnels : email

Le serveur OpenID Connect accepte-t-il le point d'interrogation dans la l'adresse de redirection ? : oui

Utiliser un serveur proxy : oui (si nécessaire) ou non (si pas nécessaire)
b) Créer un auteur dans SPIP avec l'email : dwho@badwolf.org
c) S'authentifier avec “oidc Test” :

Se déconnecter du site SPIP. 

Se connecter sur le site SPIP en cliquant sur “Se connecter”.

Cliquer sur le bouton “oidc Test”.

Une page avec le logo “oidc Test” s'affiche.

Renseigner le login : dwho

Renseigner le password : dwho

On doit alors être connecté sur le site SPIP.
A noter que oidctest.wsweet.org ne vérifie pas l'adresse de redirection vers le client. 

Attention : avec OpenID Connect, il est généralement nécessaire de renseigner, dans le serveur OpenID Connect, l'adresse de redirection vers le client.


ciparam : plugin « Configurateur de squelettes »
Equipement — 2010-11-29T08:28:00Z

		Ce plugin offre un mécanisme de sélection de forme de rubrique ou d'article, un mécanisme de variantes de chartes graphiques, la possibilité de choisir l'ordre de tri des articles dans les rubriques, un mécanisme de paramétrage de la page d'accueil, des paramètres additionnels pour configurer les squelettes.
		
Table of contents
 Les objectifs de ce plugin
 Pourquoi un plugin supplémentaire ?
 Compatibilité
 Installation
 Utilisation
 Illustration en images
 Dernière version des plugins
Les objectifs de ce plugin
L'objectif de ce plugin « ciparam : configurateur de squelettes » est d'offrir :

- un mécanisme de sélection de forme de rubrique ou d'article ;

- la possibilité de choisir l'ordre de tri des articles dans les rubriques ;

- un mécanisme de paramétrage de la page d'accueil, etc.

- des paramètres additionnels pour configurer les squelettes ;

- un mécanisme de variantes de chartes graphiques.
On peut utiliser uniquement une partie des fonctionnalités du plugin. Par exemple, on peut se limiter au mécanisme de sélection de forme de rubrique ou d'article.
Le plugin « ciparam » est indépendant et il peut être utilisé avec d'autres squelettes que ceux de Giseh.
Le plugin cisquel « squelettes de base » est livré avec, à titre d'illustration, ainsi que des variantes de charte graphique.
Pourquoi un plugin supplémentaire ?
Ce plugin constitue le portage sous SPIP 2 de fonctionnalités qui existent depuis plusieurs années dans Giseh.
Parmi ces fonctionnalités, une variante de charte graphique doit pouvoir :

- ajouter des squelettes ;

- disposer de sa propre feuille de style et des images corrélatives ;

- ajouter ou enlever des raccourcis de paramétrage de la page d'accueil ;

- ajouter des libellés dans les squelettes ;

- ajouter des fichiers javascript (par exemple pour une variante de menu) ;

- le cas échéant, ajouter ou retirer des formes d'article ou de rubrique ;

- le cas échéant, ajouter des fonctions spécifiques (par exemple pour le calcul optimisé de la variante de menu).
Ces fonctionnalités vont au-delà des besoins auxquels répondent les thèmes pour le plugin « ZPIP » et au delà des besoins auxquels répond le plugin « Composition ». Par ailleurs, ces derniers n'offrent pas de mécanisme de paramétrage de la page d'accueil, de paramètres additionnels pour configurer les squelettes, de choix de l'ordre de tri des articles dans les rubriques.
Compatibilité

- La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.

- Le plugin ne surcharge aucune fonction et utilise uniquement des pipelines. Il ne présente donc pas d'incompatibilité particulière.
Installation
Le plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html
Utilisation
Consulter le document de description du plugin qui est joint au présent article.
Illustration en images
Choix de la forme d'une rubrique, choix de l'ordre de tri des articles dans la rubrique, raccourcis sur la page d'accueil :

 


Visualiser la liste des formes :

 


Des paramètres additionnels pour configurer les squelettes

  

Dernière version des plugins
La version du 09/07/2012 apporte les nouveautés suivantes :
 Ajout d'un formulaire de contact
 Ajout de flux RSS supplémentaires dans les forums et dans les articles avec commentaires
 Ajout d'une liseuse de PDF
 Meilleure accessibilité du bouton « OK ».
 Possibilité de compatibilité XHTML 1.0 (via un paramètre à ajouter dans le fichier mes_options.php)
 Etc.
ATTENTION : ces nouveautés du 09/07/2012 modifient les squelettes et ajoutent des lignes à la fin de la feuille de style :
 Ceux qui ont modifié la feuille de style doivent ajouter à la fin les nouvelles lignes (à partir de /*— boutons ok —*/).
 Ceux qui ont modifié des squelettes doivent consulter le document Evolution de cisquel_ciform_ciparam.pdf ci-joint.
La version du 03/12/2012 corrige quelques problèmes mineurs.
La version du 09/12/2013 apporte la compatibilité avec SPIP 3 .
La version du 27/03/2018 apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 3.6 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
La version 3.7 apporte la compatibilité avec SPIP 4.2.
La version 3.8 apporte la compatibilité avec PHP 8.2.


cipr : plugin « Prévisualisation étendue »
Equipement — 2010-09-22T09:19:00Z

		Ce plugin “cipr : Prévisualisation étendue” permet de naviguer sur le site en prévisualisation, entre articles et rubriques, sur la page d'accueil, etc.
		
Table of contents
 Compatibilité
 Installation
 Paramétrage
 Illustration
Ce plugin de prévisualisation étendue permet de :

- naviguer en prévisualisation entre articles et rubriques, sur la page d'accueil, etc.

- prévisualiser une rubrique avec ses articles publiés et ses articles non publiés ;

- prévisualiser les articles qui ont le statut « en cours de rédaction » (SPIP permet de prévisualiser uniquement les articles qui ont le statut « proposé à l'évaluation »). A noter que si l'auteur est restreint à certaines rubriques, il ne pourra pas prévisualiser les articles « en cours de rédaction » des autres rubriques ;

- diminuer le temps de traitement des pages en prévisualisation et réduire le nombre de requêtes SQL nécessaires.
Techniquement, ce plugin utilise un cookie (pour propager le mode prévisualisation), un marqueur de cache et une fonction dans la clause where des requêtes. Cette approche permet de laisser la page dans le cache de premier niveau de SPIP, et d'éviter ainsi de recompiler le squelette à chaque fois.
Ce plugin peut s'utiliser avec n'importe quel squelette.
Compatibilité
CIPR version 2.5 est compatible avec SPIP 3.2, 4.0, 4.1, 4.2.

CIPR version 2.5 est compatible avec PHP 7.4, 8.0, 8.1, 8.2.
Il ne surcharge aucune fonction et utilise uniquement des pipelines. Il ne présente donc pas d'incompatibilité particulière vis-à-vis d'autres plugins.
Installation
Le plugin « Prévisualisation étendue » s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html
Lors de la désinstallation du plugin, il convient de vider le cache de SPIP. Un message l'indiquera en cas d'oubli.
Paramétrage
Le plugin ne nécessite pas de paramétrage.
Toutefois, dans la configuration de SPIP, il convient de s'assurer que la prévisualisation est autorisée aux administrateurs voire aux rédacteurs.
Illustration
Pour entrer dans le mode « prévisualisation », il suffit de cliquer sur le bouton [Prévisualiser] dans la page de saisie d'un article.
On obtient par exemple l'écran suivant en prévisualisant l'article puis en cliquant sur sa rubrique :

  


On peut alors cliquer sur la page d'accueil tout en restant en mode prévisualisation.
Pour sortir du mode prévisualisation :
- soit on entre dans l'espace privé ;
- soit on ferme le navigateur ;
- soit on clique sur la croix rouge à droite du logo de prévisualisation :

 


La version du 27/03/2018 apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 2.4 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
La version 2.5 apporte la compatibilité avec PHP 8.2.


cirr : plugin “rédacteur restreint”
Equipement — 2010-10-29T09:12:00Z

		Ce plugin “cirr : rédacteur restreint” permet d'affecter des rubriques aux rédacteurs et modifie les droits afin qu'un rédacteur restreint (ou un administrateur restreint) voit dans l'espace privé uniquement les rubriques qui lui sont affectées (et leur descendance).
		
Table of contents
 Compatibilité
 Installation
 Paramétrage
 Utilisation
 Version successives du plugin
Il s'agit d'étendre aux rédacteurs la notion d'administrateurs restreints et de simplifier la vie du rédacteur en lui proposant uniquement les rubriques auxquelles il a été affecté.
Compatibilité
La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.
Il nécessite le plugin “ciautoriser : Pipeline pour autoriser” qui surcharge les fonctions d'autorisation. Aussi, ce dernier est incompatible avec les plugins qui surchargent les fonctions d'autorisation.
A noter que le plugin “ciautoriser : Pipeline pour autoriser” est utilisable par plusieurs plugins. Pour en savoir plus : http://article.gmane.org/gmane.comp.web.spip.devel/59132
Il surcharge les fichiers inc/plonger.php et inc/presenter_enfants.php de SPIP, afin que tenir compte du cas où le rédacteur est affecté à une rubrique qui n'est pas un secteur.
Installation
Ce plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html
Il nécessite le plugin “ciautoriser : Pipeline pour autoriser”, qui figure à cette adresse : 3646.
Paramétrage
Le plugin ne nécessite pas de paramétrage.
Utilisation
Dans l'espace privé de SPIP, sélectionner un auteur qui a le statut de rédacteur et lui affecter des rubriques de la même manière que pour un administrateur restreint.

 


Cet auteur voit désormais dans l'espace privé uniquement les rubriques qui lui sont affectées (et leur descendance).

 


A noter que le plugin cirr désactive volontairement le menu déroulant de l'espace privé. En effet, SPIP ne filtre pas le contenu du menu déroulant avec les fonctions “autoriser”, car il met le résultat en cache (commun à tout le monde).
Par ailleurs, le sous menu “Tout le site” sera partiel dans le cas où le rédacteur est affecté à une rubrique qui n'est pas un secteur (pour contourner ce problème, il serait nécessaire de surcharger le fichier exec/article_tous ... dont le contenu est différent entre SPIP 2.0 et SPIP 2.1) .
Version successives du plugin

- La version du 14/06/2012 apporte la compatibilité avec SPIP 3.
- La version 1.11 du 03/12/2012 contourne le problème constaté sur les sites qui ont moins de 20 rubriques, avec un administrateur restreint à une seule rubrique (qui est une sous rubrique).
- La version 2.0.0 du 18/12/2014 apporte davantage de confort sous SPIP 3.
- La version 2.4.0 du 27/03/2018 apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
- La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
- La version 2.7 apporte la compatibilité avec PHP 8.0, 8.1 et avec SPIP 4.1.
- La version 2.8 apporte la compatibilité avec le plugin Plan. Elle nécessite au minimum SPIP version 3. Elle est compatible avec SPIP 4.2.
- La version 2.9 apporte la compatibilité avec PHP 8.2.


cirv : plugin “rédacteur valideur”
Equipement — 2010-10-29T09:13:00Z

		Le plugin “cirv : rédacteur valideur” offre la possibilité d'autoriser certains rédacteurs à publier leurs propres articles.
		
Table of contents
 Compatibilité
 Installation
 Paramétrage
 Utilisation
 Version successives du plugin
Compatibilité
Le plugin est compatible avec SPIP 3.2, 4.0, 4.1, 4.2.
Il est compatible avec PHP 7.4, 8.0, 8.1, 8.2.
Il nécessite le plugin “ciautoriser : Pipeline pour autoriser” qui surcharge les fonctions d'autorisation. Aussi, ce dernier est incompatible avec les plugins qui surchargent les fonctions d'autorisation.
A noter que le plugin “ciautoriser : Pipeline pour autoriser” est utilisable par plusieurs plugins. Pour en savoir plus : http://article.gmane.org/gmane.comp.web.spip.devel/59132
Installation
Ce plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html
Il nécessite le plugin “ciautoriser : Pipeline pour autoriser”, qui figure à cette adresse : 3646.
Paramétrage
Le plugin ne nécessite pas de paramétrage.
Utilisation
Dans l'espace privé de SPIP, sélectionner un auteur qui a le statut de rédacteur. L'écran suivant s'affiche :

 


Cocher la case “Ce rédacteur peut publier ses propres articles”, puis cliquer sur le bouton [Valider].
Cet auteur peut désormais publier ses propres articles. Dans ses propres articles, il dispose du bloc de statut, à gauche de l'article, avec la ligne “publié en ligne”, etc. :

 

Version successives du plugin
La version du 14/06/2012 ajoute la compatibilité avec SPIP 3.2.
La version du 29/10/2012 ajoute une option supplémentaire pour les rédacteurs : “Ce rédacteur peut publier (dans ses rubriques uniquement) ses propres articles et les articles (avec le statut proposé) que leurs auteurs ne peuvent pas publier”.
La version 2.0.0 du 27/02/2014 ajoute le fichier paquet.xml.
La version 2.1.0 du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 2.2.0 du 25/06/2021 apporte la compatibilité avec SPIP 4.0 bêta.
La version 2.3 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
La version 2.4 apporte la compatibilité avec SPIP 4.2.
La version 2.5 apporte la compatibilité avec PHP 8.2.


cisec : détecte et bannit les scanners de vulnérabilités
Equipement — 2016-04-13T13:37:00Z

		
Table of contents
 Versions successives du plugin CISEC
Les scanners de vulnérabilité de site web sont des logiciels qui analysent les pages d'un site web (“crawling”), puis effectuent des requêtes HTTP en ajoutant des codes malicieux dans l'URL (ainsi que dans les variables POST, etc.) et analysent le contenu de la page obtenue pour détecter si le code malicieux a été filtré ou non.
L'utilisation de scanners est intéressante dans le cadre de l'audit de sécurité d'un site (à noter que l'usage non autorisé d'un de ces logiciels sur un site est susceptible de relever de l'article 323 du code pénal).
En revanche, ces scanners de vulnérabilité sont dangereux  lorsque ce sont des pirates qui les utilisent.
Par ailleurs, certains scanners sollicitent fortement le serveur (exemple : 2 millions de requêtes en 15 heures de scan). Enfin, les variations d'URL, effectuées par les scanners de vulnérabilité, remplissent inutilement le cache de SPIP (exemple : 59 900 fichiers ajoutés dans le cache de second niveau SPIP au bout d'une heure de scan).
Les objectifs de ce plugin sont les suivants :
 Ne pas donner les véritables pages au scanner de vulnérabilité, afin de l'empêcher de conduire ses recherches de vulnérabilité.
 Réduire le temps de traitement des pages demandées par le scanner de vulnérabilité (une fois détecté).
 Diminuer l'impact, sur le cache de SPIP, des variations d'URL envoyées par le scanner de vulnérabilité.
Le bannissement est temporaire, afin de limiter l'impact d'éventuels faux positifs. Une réponse compréhensible avec un décompte de temps est affichée en cas de bannissement.
Différentes mesures effectuées, montrent que les gains obtenus avec le plugin CISEC, lors d'un scan de vulnérabilité, sont conséquents (cf. documentation ci-jointe).
Le périmètre porte sur le site public uniquement. Le périmètre ne porte pas sur les attaques de type spam (un plugin pour SPIP existe déjà sur ce sujet), ni sur les attaques de type déni de service ou déni de service distribué.
Pour plus de détails, se reporter à la documentation ci-jointe.
Versions successives du plugin CISEC
Version 1.2
 Ajout de la raison du bannissement dans le courriel, qui est automatiquement envoyé, ainsi que dans le fichier de log “cisec_detail.log”.
 Si la constante _CISEC_EMAIL est définie dans un fichier d'options, avec comme valeur une adresse email avec une syntaxe valide, le courriel sera envoyé à cette adresse email (et non pas à l'adresse du webmestre qui figure dans le menu configuration de SPIP).

Exemple : define('_CISEC_EMAIL','assistance@test.fr');
 Possibilité d'augmenter les seuils (mais pas de les diminuer) via deux constantes dans un fichier d'options :

- Au moins N POST d'une même adresse IP pendant une seconde.

- Au moins M POST d'une même adresse IP pendant 10 secondes. 

Exemple :

define('_CISEC_MAX_POST_EN_1_S',5); 

define('_CISEC_MAX_POST_EN_10_S',15);
Version 1.3

Ajout d'une règle qui rejette les tentatives d'injection qui utilisent dans l'URL une double occurrence de page=recherche
Version 1.5

Apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1.
Version 1.6

Apporte la compatibilité avec SPIP 4.2.


cisf : plugin “saisie facile” pour SPIP
Equipement — 2015-05-27T05:00:00Z

		Cette nouvelle version est compatible avec SPIP 4.2 (tout en restant compatible avec SPIP 3.2). Ce plugin “saisie facile” permet de créer ou de modifier facilement un article directement depuis le site public.
		
Table of contents
 Compatibilité
 Installation
 Paramétrage
 Illustration
 Versions successives du plugin CISF
Ce plugin :
- Diminue le nombre de clics nécessaires pour créer un article simple ;

- Evite certaines complexités de SPIP ( 2 pages pour créer un article, …) ;

- Simplifie l'insertion d'un document ou d'une image dans le texte de l'article ;

- Est compatible avec les écrans de faible largeur.
En termes d'ergonomie, saisir sur le site public constitue l'approche la plus simple. En effet, la navigation s'effectue uniquement sur le site public.
La saisie de l'article s'effectue dans une page simple avec un ensemble de liens pour les « options avancées ». Cela offre une approche très simple pour celui qui n'a pas besoin des options avancées. Par ailleurs, en pratique, on utilise un faible nombre d'options avancées pour un seul et même article.
Compatibilité
La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.
Il surcharge uniquement le formulaire des boutons d'administration sur le site public (administration.html).
Le plugin est compatible avec le plugin “porte plume” et le plugin “BigUp”.
Installation
Le plugin « saisie facile » s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html
Paramétrage
Le plugin ne nécessite pas de paramétrage.
Illustration
Une copie d'écran :

  
 Copie d'écran de CISF version 5
 
Versions successives du plugin CISF

- La version 1.5 contourne le problème de redirection, qui apparaît sur les sites qui ont plusieurs adresses, avec la version 2.1.6 (et supérieure) de SPIP.

- La version 1.51 apporte la compatibilité avec le plugin “Champs extras 2”. 
- La version 1.52 apporte la compatibilité avec le plugin “Titre de logo”. 
- La version du 03/10/2011 corrige plusieurs points.

- La version du 07/01/2013 modifie la date d'un document lors du remplacement (alors que SPIP ne la modifie pas).

- La version du 07/11/2014 apporte la compatibilité avec le plugin Eluminures.

- La version du 10/06/2015 apporte la compatibilité avec SPIP 3.0 et SPIP 3.1 (tout en restant compatible avec SPIP 2.1).

- La version du 22/10/2015 apporte de légères évolutions pour l'accessibilité.

- La version du 05/10/2016 prend en compte une nouveauté, de la version 3.0.24 de SPIP, qui empêchait de téléverser un fichier ZIP dans CISF. 
- La version du 27/01/2017 corrige plusieurs points.

- La version du 27/03/2018 apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.

- La version 3.0.0 du 03/07/2018 apporte la compatibilité avec le plugin CIBLOC.

- La version 4.0.0 du 05/07/2019 apporte la compatibilité avec le plugin CIBLOC version 2.

- La version 4.2.0 du 02/11/2020 apporte la compatibilité avec le plugin CIWIDGET version 2.

- La version du 22/06/2021 apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.

- La version 4.5 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1.

- La version 4.5.1 permet de renseigner, sous SPIP 4, le champ “Alternative textuelle (alt)” pour une image. 
- La version 4.5.2 permet de renseigner les champs “surtitre”, “soustitre”, “nom_site”, “url_site” (s'ils sont activés dans la configuration de SPIP).

- La version 4.5.2 ajoute une constante ('_CISF_PORTE_PLUME_TEXTE_UNIQUEMENT'), qui permet d'afficher le porte plume dans CISF uniquement pour le champ “Texte” (lorsqu'elle est déclarée avec la valeur 'oui' dans un fichier d'options).

- La version 5.0.0 apporte une nouvelle apparence (alignée sur l'apparence de l'espace privé de SPIP 4), la compatibilité avec le plugin BigUp et la compatibilité avec SPIP 4.2. Pour plus de détails, se reporter au fichier nouveautes_CISF_version_5.pdf joint au présent article.

- La version 5.1.0 apporte la compatibilité avec PHP 8.2, ainsi que la possibilité de renseigner un titre, un descriptif, …, pour le logo (à partir de SPIP 4.2). 
- La version 5.1.1 corrige un problème d'affichage sous SPIP 3.2.


cisquel : plugin de squelettes sur 3 colonnes pour Giseh
Equipement — 2010-11-26T10:21:00Z

		
Table of contents
 L'objectif de ce plugin
 Compatibilité
 Installation
 Utilisation
 Fonctionnalités disponibles
 Illustration en images
 Version du 11/07/14
 Version du 22/12/2016
 Version du 06/04/2018
 Version du 22/06/2021
 Version 4.0 du 15/06/2022
 Version 4.1
 Version 4.2
L'objectif de ce plugin
L'objectif est de disposer d'un site entièrement paramétrable.
Compatibilité
La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.

Il est compatible avec les autres plugins Giseh disponibles à l'adresse suivante : Plugins Giseh
Installation
Consulter l‘annexe du document de description du plugin joint au présent article.
Utilisation
Consulter le document de description du plugin qui est joint au présent article.
Fonctionnalités disponibles 
- 10 formes d'articles (sélection dans une liste déroulante)

- 23 formes de rubriques (sélection dans une liste déroulante)

- choix entre plusieurs types de colonnes de gauche pour les rubriques (affichage des rubriques sœurs ou bien affichage des sites référencés dans la rubrique ou bien même colonne de gauche que la page d'accueil …)

- choix de l'ordre de tri des articles dans une rubrique (par numéro de titre, par ordre alphabétique, par date de publication décroissante, par date de publication croissante)

- choix entre plusieurs types de colonnes de gauche pour les articles (affichage des articles frères ou bien affichage des articles ayant un mot clé identique à l'un des mots clés associés à l'article en cours ou bien même colonne de gauche que la page d'accueil …)

- la page d'accueil est intégralement paramétrable (texte de bienvenue, contenu des colonnes de gauche et de droite, choix des articles qui doivent figurer en actualités, mots-clés pour les moteurs de recherche, …)

- choix du nombre maximal d'actualités qui doivent figurer en page d'accueil

- gestion automatique de l'historique des actualités (avec affichage par année et par mois)

- menu déroulant horizontal alimenté automatiquement (le nombre de niveaux est paramétrable, le premier niveau respecte les règles d'accessibilité, on peut ne pas faire apparaître certaines rubriques dans le menu).

- multilinguisme

- téléchargement de l'image du bandeau haut du site

- le contenu du pied de page est paramétrable

- recherche portant sur les articles, sur les documents et sur les forums

- possibilité de laisser des commentaires à la suite des articles, possibilité de forums

- simulation de multirubricage pour faire apparaître un même article dans plusieurs rubriques

- chemin d'accès à la page consultée

- plan du site

- possibilité de liste des articles par mois

- possibilité de marquage Xiti

- possibilité d'intégrer des vidéos au format « FLV »

- possibilité de mettre en place une pétition

- une galerie de photos

- des forums

- etc.
Pour plus de détails, consulter le document de description du plugin qui est joint au présent article.
Illustration en images
Exemple de page d'accueil (son contenu est paramétrable) :

  


Paramétrage d'une rubrique :

 


Paramétrage du site :

  


Liste des formes :

 

Version du 11/07/14
Les modifications apportées par la version du 11/07/14 sont détaillées dans le fichier liste_modifications_cisquel_140708.pdf joint au présent article.
Version du 22/12/2016
La version MAJEURE du 22/12/2016 apporte les évolutions suivantes :
 Prise en compte d'un audit d'accessibilité (sur le site public)
 Deux nouveaux menus de navigation accessibles et responsives (un menu déroulant et un méga menu)
 Lien d'accès direct (pour la navigation au clavier)
 Evolution des boutons d'administration (sur le site public)
 Evolution de la case rechercher par défaut
 Passage à HTML 5 (du site public)
 Etc.

ATTENTION : 
- Les squelettes de CISQUEL évoluent quasiment tous. 
- Les styles ajoutés à la feuille de style (pour l'accessibilité, les nouveaux menus, etc.) figurent à la fin du fichier cisquel/css/style_site.css, à partir du commentaire “Ajout accessibilité”.
Version du 06/04/2018
 Compatibilité avec SPIP 3.2
 Compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
Version du 22/06/2021
 Compatibilité avec PHP 7.2, 7.3 et 7.4.
Version 4.0 du 15/06/2022
 Compatibilité avec SPIP 4.1
 Compatibilité avec PHP 8.0 et 8.1
Version 4.1
 Compatibilité avec SPIP 4.2
Version 4.2
 Compatibilité avec PHP 8.2


Citations bien balisées
Beurt, tetue — 2009-05-27T20:44:37Z

		Ce plugin modifie le traitement du raccourci typographique «» de SPIP afin de pouvoir produire des citations courtes (moins d'une ligne) plus conformes au HTML.
		
Table of contents
 Installation du plugin
 Citations courtes, longues ??
 Le traitement effectué par le plugin
 Des exemples
Ce tout petit plugin est une contribution très simple qui a été inspirée par un billet de tetue publié sur son blog, « Des citations bien balisées », lequel décrypte les spécifications W3C sur le sujet.
Son objectif est de permettre à SPIP de faire la différence entre les citations courtes et longues et d'appliquer le balisage HTML adéquat.
Installation du plugin
Vous trouverez la dernière version du paquet du plugin dans la zone ou ci-dessous :



 Citations bien balisées (0.1.6)
 Zip du plugin placé sur SPIP-Zone (mis à jour régulièrement)
 

Dézippez (décompressez) cette archive, puis suivez les instructions traditionnelles pour installer un plugin: Installer un plugin
N'oubliez pas de l'activer...
Citations courtes, longues ??
SPIP permet de faire des citations (originellement pour les forums) grâce au raccourci typographique  comme nous l'indique la documentation pour les rédacteurs.
Quand on écrit «ceci est une citation courte», SPIP affiche:

ceci est une citation courte

Ce qui correspond au code HTML suivant: 
ceci est une citation courte
.
La citation est placée à la ligne, hors du texte, ce qui ne convient pas toujours. En HTML il existe une autre façon de citer que d'utiliser 
 (qui place la citation dans un paragraphe) qui est l'utilisation de .
Le traitement effectué par le plugin
Ce plugin analyse les citations avant que SPIP ne traduise les raccourcis typographiques en HTML. Si la citation tient sur une seule ligne (sans aucun retour à la ligne), il la placera entre des  sinon, il laissera SPIP placer des 

Le plugin est fourni avec une feuille de style (CSS) minimaliste qui entoure les citations courtes () par des guillemets typographiques (« et ») et rend la fonte oblique.
Des exemples
Voici quelques exemples de ce qui fait ce plugin.
Une citation courte dans un texte. Voici ce que nous écrivons dans SPIP:
De Proust on connaît évidemment la phrase Longtemps, je me suis couché de bonne heure… qui est la première de son œuvre.

Fonctionnement du plugin avec une citation courte
 sans le plugin avec le plugin


affichage
De Proust on connait évidement la phrase 
Longtemps, je me suis couché de bonne heure…
 qui est la première de son œuvre.

De Proust on connait évidement la phrase Longtemps, je me suis couché de bonne heure… qui est la première de son œuvre.

Code HTML
De Proust on connait évidement la phrase 
Longtemps, je me suis couché de bonne heure…
 qui est la première de son œuvre.
De Proust on connait évidement la phrase Longtemps, je me suis couché de bonne heure… qui est la première de son œuvre.


Une citation de plusieurs lignes:
Voici un Haiku très connu:

dans le vieil étang,
_ Une grenouille saute,
_ un ploc de l'eau.

de Matsuo Bashō
 [1]

Fonctionnement du plugin avec une citation longue
 sans le plugin avec le plugin


affichage
Voici un Haiku très connu:


dans le vieil étang,
Une grenouille saute,
un ploc de l'eau.




de Matsuo Bashō


Code HTML
Voici un Haiku très connu :


dans le vieil étang,

Une grenouille saute,

un ploc de l'eau.


de Matsuo Bashō


		
		
[1] les _  permettent dans le cas de poésies de revenir à la ligne sans paragrapher. Leur usage est déconseillé, il vaut mieux leur préférer le raccourci typographique . Dans le cadre de cet exemple, le raccourci  n'était pas opportun.



Cite : des modèles pour les références bibliographiques
Joseph — 2011-01-21T20:15:34Z

		Le plugin Cite fournit des modèles permettant de citer proprement des références bibliographiques dans vos articles tout en offrant un export dans des formats bibliographiques courants.
		
Table of contents
 Les modèles disponibles
 Précisions sur la saisie des paramètres
 Aide à la saisie avec Insérer Modèles
 Récupérer les références avec un logiciel de gestion de références bibliographiques
 Styles CSL et EndNote
 Besoin de gérer une base complète de références bibliographiques
Le plugin Cite fournit des modèles permettant de citer des références bibliographiques dans vos articles (sur un principe similaire aux Citation templates de Wikipedia).
Non seulement les références seront mises en forme de manière harmonisée sur votre site, mais les modèles offriront également l'export des références dans les formats les plus courant (BibTeX et RIS) et ajouteront des liens vers des résolveurs de DOI ou d'ISBN.
Les modèles disponibles
Le plugin fournit six modèles différents, correspondant à six types de références. Voici comment les appeler dans un article :
{{Livre}}  {{Chapitre de Livre}}  {{Article scientifique}}  {{Rapport}}  {{Thèse}}  {{Page web}} 
ce qui produira :

Livre
 
Auteur1 P1, Auteur2 P2, Groupes d'auteurs (2008). Titre, collection « Collection », Volume 2, détail de l'édition, Presse SPIP, Ville, 564 p., doi: doi123/456, ISBN: 2-266-11156-6 (http://www.toto.com), RIS, BibTeX. 
 Chapitre de Livre
 
Auteur1 P1, Auteur2 P2, Groupes d'auteurs (2008). “Titre du chapitre”, in Éditeur1 P1, Éditeur 2 P2 (édité par), Titre du Livre, collection « Collection », Volume 2, détail de l'édition, Presse SPIP, Ville, p. 125-146, doi: doi123/456, ISBN: 2-266-11156-6 (http://www.toto.com), RIS, BibTeX. 
 Article scientifique
 
Auteur1 P1, Auteur2 P2, Groupes d'auteurs (2008). “Titre de l'article”, Revue, 34(5), p. 125-146, doi: doi123/456, ISSN: 0395-2037 (http://www.toto.com), RIS, BibTeX. 
 Rapport
 
Auteur1 P1, Auteur2 P2, Groupes d'auteurs (2008). Titre du rapport,type de rapport, numéro numéro du rapport, Institution publiant le rapport, Ville, 125-146 p. (httpp://www.toto.com), RIS, BibTeX.
 Thèse
 
Auteur1 P1, Auteur2 P2, Groupes d'auteurs (2008). Titre de la thèse,type de thèse, Université, Ville, 125-146 p. (http://www.toto.com), RIS, BibTeX.
 Page web
 
Auteur1 P1, Auteur2 P2, Groupes d'auteurs (2010). “Titre de la page web”, Nom du site web (http://www.toto.com/page.html), page consultée le 24 décembre 2010, RIS, BibTeX.


Précisions sur la saisie des paramètres
Auteurs
Les auteurs doivent être renseignés sous la forme Nom, Prénom (notez la virgule de séparation). Lorsqu'il y a plusieurs auteurs, ils doivent être séparés par un point-virgule.
Nombre de pages
Pour les ouvrages, rapports et thèses, saisir le nombre total de pages. Ne pas rajouter les mots pages ou p. qui seront ajoutés directement par les modèles.
Pour les articles et les chapitres d'ouvrage, indiquez la page de début et la page de fin séparées par un tiret. Exemple : 25-56
Chapitres d'ouvrage
title sera utilisé pour spécifier le titre du chapitre, le titré général du livre étant renseigné avec booktitle.
authors désigne les auteurs du chapitre. Les personnes ayant dirigés l'ouvrage (parfois appelées éditeurs scientifiques) sont renseignées avec editors (avec la même syntaxe que pour les auteurs).
Date de consultation (pour les pages web)
La date de consultation d'une page web est indiquée avec le paramètre accessdate sous la forme ANNÉE/MOIS/JOUR. L'écriture ANNÉE-MOIS-JOUR est également acceptée.
Aide à la saisie avec Insérer Modèles
Afin de faciliter la saisie des références et de ne pas avoir à se souvenir de l'ensemble des paramètres des modèles, l'installation du plugin Insérer Modèles est fortement recommandée.
Vous disposerez alors dans le porte-plume et dans la colonne de droite d'un formulaire de saisie pour les références. Quelques captures d'écran :

 


 


 


Pour plus d'informations, voir la documentation du plugin.
Récupérer les références avec un logiciel de gestion de références bibliographiques
Chaque modèle fournit deux liens permettant de télécharger la référence dans les formats BibTeX et RIS.
Ces deux formats sont reconnus par la majorité des logiciel de gestion de références bibliographiques, en particulier EndNote (le plus connus des logiciels commerciaux [1]) ainsi que Zotero [2] et Mendeley parmi les logiciels libres, ainsi que par l'ensemble des logiciels basés sur BibTeX.
Pour un comparatif des différents logiciels existants et des formats qu'ils prennent en compte, voir Wikipedia.
Astuce : si vous utilisez l'excellent Zotero, qui se présente sous la forme d'une extension pour Firefox, vous pouvez le paramétrer pour qu'il intercepte et importe directement les fichiers RIS téléchargés avec Firefox (dans les Préférences, onglet Général)
Styles CSL et EndNote
Allons encore plus loin pour faciliter l'insertion des références dans SPIP. Si vous utilisez un logiciel de gestion de références bibliographiques, il serait encore mieux de pouvoir les exporter directement sous la forme de modèles SPIP. Il ne vous resterait plus qu'à opérer un copier/coller dans votre article.
Tout est prévu ! Dans le fichier ZIP du plugin vous trouverez deux styles bibliographiques, l'un au format ENS pour EndNote, et le second au format CSL utilisé notamment par Zotero et Mendeley .
Pour Zotero, le plus simple pour installer ce style est de cliquer sur ce lien (depuis Firefox).
Astuces : avec Zotero, pensez à activer la fonctionnalité Quick Copy pour votre site SPIP préféré. Vous pourrez alors ajouter une référence à votre article par un simple raccourci clavier, voire même par glisser / déposer.
Besoin de gérer une base complète de références bibliographiques
Si vous avez besoin de fonctionnalités plus avancées et, notamment, de gérer une base de données de références bibliographiques, il vous est possible d'installer en parallèle de votre SPIP le logiciel libre refbase fonctionnant en PHP/MySQL. Le plugin refbase pour SPIP vous permettra de pouvoir insérer dans vos textes des références ou des listes de références issues de votre base refbase, à l'aide du modèle .
Pour plus d'informations, se référer à la documentation du plugin refbase.
		
		
[1] Bahhhhh (avis personnel de l'auteur)

[2] Ahhhhh



citrace : garder une trace de certaines actions
Equipement — 2013-07-26T11:48:30Z

		L'objectif est de garder une trace, pendant une période déterminée, de qui a effectué quelle action sur le contenu du site et quand.
		
Table of contents
 Les objectifs de ce plugin
 Compatibilité
 Installation
 Fonctionnalités
 Versions successives du plugin
Les objectifs de ce plugin
L'objectif est de garder une trace, pendant une période déterminée, de qui a effectué quelle action sur le contenu du site et quand.
Compatibilité
La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.
Installation
Le plugin s'installe comme tous les plugins, cf. http://www.spip.net/fr_article3396.html.
Fonctionnalités
Le détail des fonctionnalités de ce plugin figure dans la documentation ci-jointe.
Versions successives du plugin
Version du 08/04/2016 : L'administrateur du site peut désormais savoir qui a publié / dépublié / déplacé / supprimé un élément (article, rubrique, auteur), et quand. Pour plus de détails, se reporter aux chapitres 1 et 2 de la documentation ci-jointe.
Version du 27/03/2018 : apporte la compatibilité avec SPIP 3.2 et la compatibilité (sous SPIP 3.2) avec PHP 7.0 et 7.1.
Version du 22/06/2021 : apporte la compatibilité avec PHP 7.2, 7.3 et 7.4.
La version 2.6 du 15/06/2022 apporte la compatibilité avec PHP 8.0 et 8.1, ainsi que la compatibilité avec SPIP 4.1
Version 2.7 : apporte la compatibilité avec SPIP 4.2.
Version 2.8 : apporte la compatibilité avec PHP 8.2.


CIWIDGET
Equipement — 2021-06-09T13:30:00Z

		La version 3.6 de CIWIDGET offre 27 widgets : pour publier des graphiques (colonnes, lignes, radar, etc.), pour publier des tableaux, etc.
		
Table of contents
 Compatibilité
 Les objectifs de ce plugin
 Vidéo de démonstration de CIWIDGET version 1
 Vidéo de démonstration du widget pour publier des graphiques
 Installation
 Comment ajouter un widget ?
 Quels sont les apports du widget vidéo ?
 Configuration générale des widgets
Compatibilité
La compatibilité avec les versions de SPIP figure dans la colonne de droite de la présente page.
Les objectifs de ce plugin
L'objectif est de pouvoir afficher facilement, dans le texte d'un article d'un site SPIP, des contenus autres que du texte, des images et des pièces jointes.
Dans ce cadre, le plugin CIWIDGET offre (dans la version 3.6) les 27 widgets suivants :
 Widget audio
 Widget bloc
 Widget bloc simple
 Widget bloc alerte
 Widget carte choroplèthe
 Widget carte simple (uniquement si le plugin GIS est actif)
 Widget chiffre
 Widget citation
 Widget galerie d'image
 Widget graphique (colonnes, barres, secteurs, radar, etc.)
 Widget iframe
 Widget infographie
 Widget Linkedin
 Widget portrait
 Widget RSS (articles d'un autre site par syndication)
 Widget site référencé
 Widget slideshare
 Widget Superset
 Widget tableau
 Widget tweet
 Widget fil d'information de Twitter
 Widget vidéo
 Widget vidéo distante
 Widget vidéo de Dailymotion
 Widget vidéo de Terra
 Widget vidéo de Youtube
 Widget streaming HLS

  


Les prochaines versions du plugin CIWIDGET comprendront davantage de widgets.
Les widgets sont compatibles avec des écrans de faible largeur (responsive).
Les fonctionnalités sont détaillées dans le document Description du plugin CIWIDGET ci-joint au format PDF.
Par exemple, le widget Graphique offre 10 types de graphique : colonnes, colonnes avec une courbe de tendance, colonnes empilées, colonnes empilées avec une courbe de tendance, barres, barres empilées, secteurs, anneau, lignes, radar.

 

Vidéo de démonstration de CIWIDGET version 1
Cliquer ci-dessous pour afficher cette vidéo :

vidéo
Vidéo de démonstration du widget pour publier des graphiques
Cliquer ci-dessous pour afficher cette vidéo :

vidéo
Installation
Il est nécessaire d'installer également les plugins : 
- CIAUTORISER 
- CISTYLE (qui figure également dans la colonne de droite de la présente page, dans la section "Autres téléchargements).
Remarque : Si le site utilise le plugin CISF, il est nécessaire d'utiliser au moins la version 4.1 de CISF. S'il utilise le plugin CIAR, ce dernier doit être au minimum en version 2.9. S'il utilise le plugin CISQUEL, ce dernier doit être au minimum en version 3.7.
Comment ajouter un widget ?
Dans l'espace privé, dans la page de l'article, cliquer sur le nouveau bouton « Ajouter un widget » (en bas à droite).

 


La page suivante s'affiche. Cliquer sur le widget souhaité (par exemple : un Tweet issu de Twitter)

  


La page suivante s'affiche. Renseigner les informations obligatoires ...

 


... ou cliquer d'abord sur le lien “Afficher/masquer les explications”

 


Après avoir cliqué sur le bouton [Enregistrer], le widget apparaît dans la liste des widgets attachés à l'article (en dessous de la liste des documents).

 


Il est possible de modifier ou de supprimer un widget (comme pour les documents).
Pour insérer le widget dans le texte de l'article, il convient de procéder comme pour les documents.

 


Une fois le raccourci  inséré dans le texte de l'article, on peut prévisualiser l'article (ou le publier).

 

Quels sont les apports du widget vidéo ?
Par rapport à l'insertion classique d'une vidéo dans SPIP (que l'on peut continuer à utiliser), le widget vidéo :
 Indique, par sa présence, la possibilité de téléverser des vidéos.
 Permet de limiter les formats autorisés.
 Permet d'imposer un débit vidéo maximal avec audio.
 Informe l'utilisateur sur le poids maximal, les formats autorisés et, le cas échéant, le débit maximal autorisé.
 Permet de saisir une “Transcription textuelle” (stockée dans le descriptif), qui s'affichera sur le site public lorsque l'on cliquera sur le bouton “Voir la version texte”.
 Offre deux options supplémentaires : tourne en boucle, démarre automatiquement.
Remarque : le plugin offre un lecteur vidéo accessible et compatible avec des écrans de faible largeur (responsive). La configuration générale offre trois choix d'apparence, c'est-à-dire 3 skins, pour le lecteur vidéo (cf. document de description du plugin ci-joint).
Configuration générale des widgets
La configuration générale consiste à modifier les valeurs par défaut des widgets.
La configuration générale est facultative. En effet, les widgets disposent de valeurs par défaut.

Seul un administrateur du site peut configurer.
Dans le cas où la configuration est imposée au site (cf. document de description du plugin ci-joint), il est possible de voir la configuration, sans pouvoir la modifier.
Pour configurer, il convient de se placer dans l'espace privé de SPIP et de cliquer sur le menu Configuration / Configurer les widgets .
La configuration générale permet d'activer la prise en compte du RGPD pour les widgets concernés (cf. document de description du plugin ci-joint).


CKeditor 3.x et 4.x
Frédéric Bonnaud — 2009-10-04T16:54:48Z

		CKeditor est l'évolution de l'éditeur WYSIWYG : FCKeditor, avec ce plugin vous pourrez utiliser cet éditeur à la place de l'éditeur de spip tout en laissant le choix à vos auteurs de l'éditeur qu'ils préfèrent utiliser.
Attention : cet éditeur WYSIWYG risque de détruire la belle charte graphique de votre site, ainsi qu'empêcher la mise à jour simplifiée de celle-ci. Avec ce plugin, le déplacement de votre site nécessitera l'édition manuelle de chaque article contenant des liens internes si vous déplacez votre site dans un autre répertoire.
Ceci devient totalement faux si vous préservez la typographie spip
		
Table of contents
 Introduction
 Description
 Mise à jour de la lib
 Installation
 Configuration
 Incompatibilités
 Contribution avec Git
Introduction
Le plugin est intégré complètement à SPIP.

  


Si vous avez opté pour laisser le choix aux auteurs (c'est l'option par défaut). Il suffit de cliquer sur le lien adapté pour passer de l'éditeur spip à CKeditor.
Description
Que fait le plugin ?
Ce plugin remplace l'éditeur par défaut de spip (en particulier le porte-plume disparaît) dans les articles, les brêves et les rubriques par CKEditor un éditeur WYSIWYG.
Avec cet éditeur, vous pouvez :
 continuer d'utiliser le mécanisme de spip pour insérer des images, des documents à/dans un article, une rubrique ...
 insérer simplement des liens vers les objets standards de spip (mais aussi ceux non encore prévu en modifiant assez simplement le code du plugin : ajout d'un fichier, ajout d'un lien dans un autre) via un dialogue de CKEditor.
 utiliser les balises spip non gérée par CKEditor comme vous le feriez depuis l'éditeur de spip.
 utiliser des polices en utilisant le mécanisme CSS3 (@font-face), soit en utilisant le webfonts directory de google, ou en téléchargeant la police ainsi que la feuille de style CSS3 tel que générée par Font Squirrel par exemple dans le répertoire : IMG/FontKits//.
 le plugin essaie, dans la mesure du possible de sauvegarder vos mises en page en utilisant les raccourcis typographiques de spip (le gras, l'italique, les liens, les ancres, les insertion d'images, de documents, les listes, ... ) mais beaucoup de choses sont sauvegardées au format html (les tableaux, les enrichissement sophistiqué : couleurs, polices etc ...).
 (nouveau) utilisez CKEditor avec n'importe quel champ (pour peu que vous connaissiez un sélecteur jQuery permettant d'y accéder)
 (nouveau) utiliser CKEditor aussi bien en partie privée que publique
 (nouveau) utilisez les modèles SPIP de manière 'visuelle'
 (nouveau) utilisez des modèles d'articles que vous définirez
 (nouveau) préservez la typographie spip
 plein d'autres choses ...
La dernière version est :
 sur la zone !
 compatible spip 3.0 (expérimental)
Mise à jour de la lib
Le plugin Ckeditor utilise le dossier lib/ de SPIP.
Mais rien dans SPIP ne gère la mise à jour des lib :(
En conséquence, pour mettre à jour la lib :
 La lib CKEditor se télécharge au format zip ici
 et le dossier ckeditor qu'elle contient est à mettre dans lib/ à la racine de SPIP à la place de l'ancien
Remarque, vous pouvez personnaliser les greffons de CKEditor.
Installation
Dans tous les cas, il faut qu'un répertoire lib existe à la racine de votre installation Spip pour que Spip puisse y copier la librairie CKeditor. Et il faut que Spip puisse écrire dans ce répertoire : c'est un pré-requis obligatoire.
Ensuite, vous pouvez installer le plugin de deux manières différentes :
Par FTP
Téléchargez le plugin :



 ckeditor-spip3-plugin

 (0.17.1)
 

Vous pouvez préférez la version de développement qui se trouve là
Décompresser l'archive où vous voulez, copier le répertoire entier dans le sous répertoire plugins de votre installation spip.
En mode auto
Créez un répertoire auto dans le sous répertoire plugins de votre installation spip. Taper/Copier l'url du plugins

 


Validez.

Spip télécharge l'archive et vous montre ce qu'il y a dedans.

 


Validez.
Via SVP
Vu que le plugin est maintenant sur la zone : il peut être installé via SVP (à vérifier)
Activation du plugin
Utilissez le gestionnaire de plugins Spip pour activer le plugin.
Ouvrez le répertoire plugins/auto et activez CKeditor pour Spip

 


Validez.

Spip n'est pas content :

  


Normal, il faut encore télécharger CKeditor lui-même. Cliquer sur le bouton Télécharger.

Après le téléchargement qui prend un certain temps (près de 5Mo ...), Spip vous montre le contenu de l'archive qu'il vient de télécharger :

 


Procéder à l'installation :

 


Normalement à ce stade, le plugin est installé. Il arrive, je ne sais pas pourquoi que spip ne copie pas le contenu de CKeditor au bon endroit, dans lib/ckeditor. Chez moi, il laisse l'archive décompressée dans tmp/cache/chargeur/ckeditor. En l'effaçant complètement et en recommençant, ça a marché. Je pense que le bug vient de spip. Mais je n'en suis pas sûr.
Modules complémentaires
Pour profiter pleinement de toutes les fonctionnalités du plugin, il faut installer aussi :
 le plugin Itérateurs
 la librairie html2spip
 la librairie KCFinder dans /lib
Configuration
Puis on utilise l'interface CFG pour configurer le plugin. Ce n'est pas obligatoire mais les choix par défaut risquent de ne pas vous plaire.
Les documentations suivantes sont, sur certains points obsolètes
Vous pouvez consulter les articles :
 CKeditor : Configuration de base
 CKeditor : Configuration des styles
 CKeditor : Téléchargement d'images/documents
 Préserver la typo SPIP avec CKeditor
 CKeditor : Configuration avancée
Incompatibilités
Ce plugin est incompatible avec le plugin Multilang.
Contribution avec Git
ckeditor-spip-plugin est sur le Git de SPIP !
		Avertissement !
L'utilisation de ce type d'éditeur WYSIWYG permet difficilement de maintenir une charte graphique cohérente. Prévenez vos rédacteurs de limiter le recours aux enrichissements trop exotiques, ou mieux : limitez l'utilisation dans ce plugin l'accès aux seules fonctions de l'éditeur que vous souhaitez leur offrir.


CleverMail
Nicolas Hoizey, RealET, scaron — 2010-01-20T19:05:25Z

		CleverMail est un plugin permettant d'envoyer des lettres d'informations à des abonnés depuis SPIP. Issu au départ d'un développement libre complètement indépendant de SPIP, il a connu une première version pour SPIP 1.9 avant d'être complètement réécris pour SPIP 2.0.
		
Table of contents
 Avertissement
 Fonctionnalités
 Mise en place du plugin
 Présentation de l'interface dans l'espace privé
 Mécanisme de création et envoi des messages
 Intégration au site public
 Support
Avertissement
Ce plugin est avantageusement remplacé par Newsletters et les 2 autres plugins qui l'accompagnent.
Et Mailsubscribers récupérera vos abonnés automatiquement.
Il n'y a aucune garantie que CleverMail soit encore maintenu dans l'avenir (en particulier pour SPIP 5).
Fonctionnalités
 Gestion de multiples lettres, avec possibilité de les rassembler par catégories
 Gestion des inscriptions en ligne et désinscriptions, les abonnés étant distincts des utilisateurs de SPIP
 Possibilité de restreindre la liste des lettres proposées dans le formulaire d'abonnement
 Abonnement au choix de l'utilisateur en version texte brut ou multipart simultané HTML + texte brut [1]
 Possibilité de forcer la version dans le formulaire d'abonnement
 Récupération des contenus HTML et texte brut à partir de deux squelettes ou deux URL, donc utilisation de squelettes SPIP dédiés voire même de contenus externes au site
 Automatisation des envois avec une fréquence quotidienne, hebdomadaire (multiples jours de la semaine possibles) ou mensuelle
 Automatisation des inscriptions depuis un fichier distant
Mise en place du plugin
Télécharger le paquet ci-joint et placer son contenu dans votre dossier plugins/.
Avant d'activer CleverMail dans l'interface de gestion des plugins, vous devrez installer les plugins Facteur et SPIP Bonux.
Présentation de l'interface dans l'espace privé
Une fois le plugin activé, le sous menu CleverMail est crée dans le menu Edition.

 


Le menu de CleverMail permet de :
 Lister les lettres existantes
 Créer une nouvelle lettre
 Lister les abonnés
 Ajouter des abonnés
 Paramétrer le plugin
Tableau de bord
Le tableau de bord général de CleverMail affiche la liste des newsletters et leurs caractéristiques principales :

 


Différentes actions sont disponibles
 Modifier : Permet de modifier une lettre
 Supprimer : Une lettre peut être supprimer seulement si aucun abonné n'y est inscrit.
 Nouveau Message
Création / Modification d'un lettre d'information

  


Une lettre se compose de la façon suivante :
 Nom : Le nom de la lettre est important car c'est par leurs noms que les lettres sont triées et classées par catégorie. “01. Ma Catégorie/02. Ma Lettre”



“01.”
Ordre de la catégorie (peut commencer à 00. )

“Ma Catégorie”
Nom de la catégorie (= Nom du type de publication)

“/”
séparateur sans espace entre le nom de la catégorie et le nom de la lettre

“02.”
Numéro d'ordre de la lettre (peut commencer à 00. )

“Ma Lettre”
Nom de la lettre

 Description : Explication back office de la lettre, par défaut ce champ n'apparait pas en front office .
 Modération :
 Ouverte : tout le monde peut s'inscrire sans confirmation
 E-mail : tout le monde peut s'inscrire après confirmation par e-mail
 Fermée : personne ne peut s'inscrire, utile pour tester avant ouverture, ou fermer temporairement
 E-mail du modérateur : (Champ obligatoire) Le modérateur reçoit un mail dès qu'un utilisateur confirme sont inscription à une lettre. Plusieurs adresses peuvent être saisies en les séparant par des virgules.
 Préfixe : Préfixe les sujets des messages avec le nom de la lettre d'information (ex : [Rapport annuel] Confirmation de votre inscription). Pour le formulaire multiple, en cas d'inscription à plusieurs lettres en même temps, ce champ n'est pas pris en compte.
 Sujet et description d'une inscription : Message d'inscription qui sera envoyé par mail à l'utilisateur en cas de modération par E-mail. En cas d'abonnement multiple le message envoyé pour toutes les lettres est celui paramétré dans la section «paramétrage»
 Sujet et description d'une désinscription : Message de désinscription qui sera envoyé par mail à l'utilisateur.
 Version HTML : Nom du squelette [2] ou URL de la page permettant d'obtenir le contenu de la lettre en version HTML.
 Version texte brut : Nom du squelette [3] ou URL de la page permettant d'obtenir le contenu de la lettre en version texte brut.
 Automatisation des envois : Les envois des lettres d'information peuvent être fait manuellement ou être automatisés
 Envois quotidiens : Les dernières publications [4] seront envoyées tous les jours à partir de l'heure précisée dans le champ “Heure de création du message”. Les publications publiées après cette heure seront envoyées le lendemain.
 Envois hebdomadaires : Les dernières publications seront envoyées toutes les semaines le jour et à l'heure précisés dans les champs “Jour(s) de la semaine” et “Heure de création du message”.
 Envois mensuels : Les dernières publications seront envoyées tous les mois au jour et à l'heure précisés dans les champs “Jour du mois” et “Heure de création du message”.
 Mode d'abonnement : mode d'abonnement à la liste par défaut si aucun mode d'abonnement n'est précisé ou forcé à l'inscription.
Tableau de bord des abonnés
Le tableau de bord des abonnés affiche la liste des abonnés aux newsletters. Il y a une ligne par couple abonné/newletter.
La liste des abonnés peut être filtrée sur une partie de l'adresse e-mail (@example.com par exemple) et/ou sur le nom de la newsletter.
L'administrateur a la possibilité de modifier le mode d'inscription d'un abonné ou de le désinscrire d'une lettre. Dans ce cas l'abonné ne recevra pas de mail de désinscription.

 


Un lien “Vider les abonnements en attente depuis plus d'un mois” permet de supprimer de la base de données les demandes d'inscriptions en attente de validation depuis plus d'un mois.
Cette fonction nettoie également les adresses de type @example.com qui seraient par erreur [5] restées dans la table des abonnés aux newsletters.
Ajout d'abonnés
Des abonnés peuvent être ajoutés dans l'interface privé à partir d'un fichier CSV ou directement en saisissant les adresses e-mail dans le formulaire.
Dans le fichier ou dans la zone de saisie, mettre une adresse e-mail par ligne, ou séparer les adresses par des virgules ou points virgules.

 


Paramétrage
La section paramétrage contient les paramètres communs à toutes les lettres.

 


Les paramètres génériques sont les suivants :
 E-mail administrateur : par défaut mail du webmestre de SPIP
 E-mail expéditeur (from et reply-to) : par défaut mail du webmaster de SPIP
 E-mail return path : par défaut mail du webmaster de SPIP
 Nombre de messages par envoi : par défaut «50». A chaque traitement de la tache planifiée 50 messages seront envoyés.
 Sujet et description d'une inscription multiple : Message d'inscription qui sera envoyé par mail à l'utilisateur en cas d'inscription a plusieurs lettres en même temps.
Mécanisme de création et envoi des messages
Envoi automatique
Les messages automatiques sont envoyés via une tache planifiée. Chaque jour, la tache planifiée regarde s'il y a eu de nouvelles publications depuis le dernier envoi et si la date du prochain envoi est atteinte.
Exemple d'une lettre envoyée tous les 15 du mois :
 Janvier : Nouvelle publication le 10 => 15 du mois => envoi
 Février : pas de nouvelle publication => 15 du mois => pas d'envoi => nouvelle publication le 17 => envoi => nouvelle publication le 20 => pas d'envoi
 Mars : pas de nouvelle publication => 15 du mois => envoi de la publication du 20 février
Envoi manuel
Les messages peuvent également être envoyés manuellement depuis le tableau de bord des lettres d'information.
Pour créer un nouveau message, cliquer sur le lien “nouveau message” d'une lettre.

 


Le lien “1 message” permet d'accéder au tableau de bord des messages d'une lettre.

 


Ce tableau de bord permet de voir les messages par état : nouveau message, message en cours d'envoi et message envoyé.
Différentes actions sont disponibles sur les messages (selon leur état) :
 Aperçu HTML : Visualisation de la lettre au format HTML, avant remplacement des balises de personnalisation
 Aperçu texte : Visualisation de la lettre au format texte, avant remplacement des balises de personnalisation
 Modifier : Modification du message qui sera envoyé

 

 Supprimer : Suppression du message
 Envoyer : Envoi du message, le message est déposé dans une file d'attente que le Facteur va dépiler au fur et à mesure de l'exécution du génie de SPIP. Le message en attente n'est plus modifiable ni supprimable.
Intégration au site public
La balise #FORMULAIRE_CLEVERMAIL permet d'afficher le formulaire par défaut des listes non filtrées par catégorie.

 


Il est possible de restreindre le formulaire d'abonnement à une newsletter en précisant l'id de la lettre: 

#FORMULAIRE_CLEVERMAIL{1}
Il est aussi possible de restreindre le formulaire d'abonnement à un unique mode en précisant texte ou html : 

#FORMULAIRE_CLEVERMAIL{0,html}
Il est enfin possible d'utiliser un formulaire avec des cases à cocher plutôt qu'une liste en passant box en troisième paramètre [6] : 

#FORMULAIRE_CLEVERMAIL{0,html,box}
La balise #FORMULAIRE_CLEVERMAIL_MULTIPLE permet d'afficher le formulaire d'abonnement multiple filtrées par catégorie.

 

Support
En cas de bug ou problème particulier, merci de vérifier sur le Trac de la zone si un ticket existe déjà, et si nécessaire de créer un nouveau ticket avec le « component » “plugins/clevermail” et faire un commentaire ici-même pour signaler ce ticket.
Si vous avez des idées pour améliorer le plugin, même chemin, créez un nouveau ticket avec le « component » “plugins/clevermail” !
Si vous aimez ce plugin, et l'utilisez sur un site public, n'hésitez pas à le signaler sur sa fiche !
		
		
[1] Attention, Lotus Notes n'aime pas...

[2] CleverMail en propose un par défaut

[3] CleverMail en propose aussi un par défaut

[4] C'est à dire depuis l'envoi précédant.

[5] Un bug depuis corrigé pouvait conduire à cette erreur

[6] Le code impose pour l'instant de préciser les deux premiers paramètres, ce sera amélioré ultérieurement...



Coche Mots
Joseph — 2013-03-12T08:11:00Z

		Ajoute une icône au formulaire d'ajout de mots-clés affichant une liste de cases à cocher de tous les mots-clés d'un groupe.
		
Table of contents
 Objectif
 Fonctionnement
D'après une idée originale de Sébastien, voir Choix des mots clés dans une fenêtre.
Objectif
Lorsque l'on doit associer plusieurs mots-clés à un objet, il peut-être plus utile de disposer d'une liste de tous les mots-clés existant et de cocher simplement ceux s'appliquant à l'objet en question.
Cela s'avère également utile lorsque la liste des mots-clés disponibles est longue et que SPIP remplace alors une liste de choix par un champs de recherche. Si l'on utilise un thésaurus précis, on ne se souvient pas toujours de l'ensemble des mots-clés disponibles et il est alors pertinent de pouvoir consulter la liste complète.
Fonctionnement
Une fois installé, le formulaire d'ajout de mots-clés est légèrement modifié : l'icône de Coche Mots est ajoutée à la droite de chaque groupe de mots-clé, seulement s'il est possible d'associer plusieurs mots-clés du même groupe [1].


 


Le fonctionnement du formulaire d'ajout de mots-clés n'est pas modifié et peut donc être utilisé de la manière habituelle.
Alternativement, il est est possible de cliquer sur l'icône de Coche Mots pour faire apparaître une liste de cases à cocher avec les mots-clés du groupe concerné (voir capture ci-dessous).


 


Les mots-clés du groupe déjà associés à cet objet sont déjà cochés. Il vous suffit de modifier la sélection de mots-clés et de valider. Le formulaire Coche Mot permets donc à la fois d'associer et de dissocier des mots-clés, le tout en une seule opération.
		
		
[1] Pour les groupes de mots-clés à choix unique, il n'y a donc pas d'icône additionnelle.



Codes postaux
GuillaumeW — 2014-06-06T09:33:00Z

		Ajouter facilement tous les codes postaux français à votre base de donnée.
		En quelques clics, vous pouvez, grâce à ce plugin, récupérer et intégrer à la votre base de donnée, les codes postaux français contenu dans la base GeoNames (sous licence Creative Commons By) [1].
		
Table of contents
 Installation téléchargement et intégration des données
 Dans les squelettes
Installation téléchargement et intégration des données
Installation du plugin
Pour installer le plugin codes_postaux, ce n'est pas différent des autres plugins. Pour ceux qui n'ont jamais installé de plugins SPIP, référez-vous à cet article http://www.spip.net/fr_article3396.html
Une fois installé, il est toujours bon d'aller jeter un coup d'œil au panneau de configuration CFG du plugin [2].
Téléchargement des données
Le plugin ne comprenant pas les données, il faut les télécharger sur le site Geonames. 

Pour vous simplifier la tâche, le plugin comprends un module pour charger les données nécessaires directement à partir de l'espace privé de votre site SPIP.

Il suffit d'aller sur la page importation, vous trouverez le formulaire téléchargement des données.

Ces données sont téléchargées et dézippées dans le dossier ./tmp.
Intégration des données
Une fois, le fichier, vous pouvez procéder à l'intégration des données dans les tables de votre base.

Un formulaire simple vous permet de faire cette opération, il se trouve en toute logique sur la page “Importer les codes postaux”.

- La case à cocher “Vider la table avant l'importation” pour éventuellement effacer tout le contenu de la table à importer
Filtrer les données importées
Exemple : Vous ne souhaitez importer dans votre base que les villes du département Nord

Il vous suffit de renseigner le champs filtre avec la formule 

code_departement=59
Voici l'ensemble des clés pris en compte (elles correspondent aux colonnes du fichier geonames) :

- pays 
- code 
- titre

- region

- code_region

- departement

- code_departement

- arrondissement

- code_arrondissement
Si le plugin COG est installé, il vous sera proposer, par l'intermédiaire de la case à cocher “Relier les codes postaux aux communes” , de créer les liaisons entre les communes et les codes postaux.
Dans les squelettes
La boucle CODES_POSTAUX
Exemple pour la boucle communes
#PAGINATION
     <:code_postal:code:>  <:code_postal:titre:>  
 
  #CODE  #TITRE  
  


Dans les formulaires
Un type de saisie vient s'ajouter : code_postal

Il permet d'ajouter une saisie autocompletée des codes postaux et si vous souhaitez un remplissage automatique d'un éventuel champs ville, une démonstration est disponible sur la page (URL_SITE_SPIP)?page=demo/form_code_postal
		
		
[1] Ce plugin n'est pas redondant avec le plugin géographie. Le plugin géographie inclue les données (base de données des ville et code postaux). Ces données sont incomplètes : une ville peut compter plusieurs codes postaux. La structuration des tables dans le plugin géographie ne permet pas de prendre en compte cette réalité. Voila pourquoi ce choix d'avoir développer un autre plugin.

[2] Icone de clé-outil dans le panneau de “Gestion des plugins”..



COG : Toutes les communes, départements, régions ... françaises
GuillaumeW — 2013-01-29T21:42:41Z

		Ajouter facilement les codes officiels géographiques tel que défini et fourni par l'INSEE( Institut national de la statistique et des études économiques). Voir : http://www.insee.fr/fr/methodes/.


Nota SPIP-Contrib : Cette spécificité “justifie” l'existence de ce plugin qui fut développé il y a quelques temps déjà, indépendamment du développement du plugin Géographie. Faites votre choix.

		
Table of contents
 Installation téléchargement et intégration des données
 Des boucles et critères supplémentaires
 Le coin des développeurs
Vous pouvez grâce à ce plugin, récupérer en quelques clics, la liste des communes ou des départements et l'intégrer à votre base de données. 

Mais ce ne sont pas les seule les délimitations administratives disponibles, il y a : 
- Les communes

- Les cantons

- Les arrondissements

- Les départements

- Les régions

- ...
Installation téléchargement et intégration des données
Installation du plugin

Pour installer le plugin COG, ce n'est pas différents des autres plugins. Pour ce qui n'ont jamais installer de plugin SPIP, référez vous à cet article https://www.spip.net/fr_article3396.html
Une fois installé, il est toujours bon d'aller jeter un coup d'œil au panneau de configuration CFG de COG.
Téléchargement des données
Le plugin ne comprenant pas les données, il faut les télécharger sur le site de l'INSEE. 

Pour vous simplifier la tâche, le plugin comprends un formulaire pour charger les données nécessaires directement à la partir de l'espace privé de votre site SPIP.

Il vous faut aller sur la page importation, vous trouverez le formulaire téléchargement des données du site INSEE. Choisissez la délimitations administratives qui vous intéressent et cliquer sur “télécharger”
Attention : Au préalable au téléchargement, il vous faut vérifier que votre répertoire de stockage des données défini dans la configuration est autorisé en écriture.
Intégration des données
Une fois, le ou les fichiers, vous pouvez procéder à l'intégration des ces données dans les tables de votre base de donnée.

Un formulaire simple vous permet de faire cet opération, il se trouve en toute logique sur la page “importation des données”.

4 champs sont renseignés, 
- La liste déroulante des délimitations administratives à importer 
- La case à cocher “” pour éventuellement effacer tout le contenu de la table à importer

- La case à cocher “” pour mettre à jour les informations d'un code déjà existant dans la base.

- un champ 'Filtrer les données' qui permet de restreindre les données importées
Filtrer les données importées
Exemple : Vous ne souhaitez importer dans votre base que les villes du département Nord

Il vous suffit de renseigner le champs filtre avec la formule 

departement=59
Visualiser les données dans l'espace privé.
Vous voulez visualiser les données présentes dans votre base de données. 

Si vous êtes avec une SPIP v2.1, il vous faut installer le plugin Tabledata
Une fois tabledata installé vous pourrez ajouter,modifier et supprimer et alors voir apparaite comme par enchantement des raccourcis dans la liste des tables présentes.
Des boucles et critères supplémentaires
De nombreuses boucles sont donc ajoutée
La boucle COMMUNES
Exemple pour la boucle communes

D'autres exemples sont disponible dans le
 Nombre total de commune : #GRAND_TOTAL      <:cog:code_insee:>  <:cog:ville_nom_article:>  <:cog:nom_article:>  <:cog:nom:>  <:cog:nom_majuscule:>  <:cog:region:>  <:cog:departement:>  <:cog:arrondissement:>  <:cog:canton:>  <:cog:decoupage_cantons:>  <:cog:chef_lieu:>  
 
  #DEPARTEMENT#CODE  La ville de #NOM  #ARTICLE #NOM  #NOM  #ARTICLE  #ARTICLE_MAJUSCULE #NOM_MAJUSCULE  #REGION  #DEPARTEMENT  #ARRONDISSEMENT  #CANTON  #DECOUPAGE_CANTONS  [(#CHEF_LIEU|=={1}|oui) est le chef lieu]  
  
 
  Encore aucune commune n'a été importé dans la base.
 
Le coin des développeurs
Hack
Exploitation des liaisons communale dans le moteur de recherche
Vous êtes en SPIP 2.0 ou SPIP 2.1, vous avez attacher à de nombreux articles de votre site à des villes, vous souhaitez que lorsque qu'un internaute taper dans le moteur de recherche le nom d'une ville, il se retrouve avec la liste de tout les article attaché à cette ville. Ce n'est pas très compliqué, il faut jute faire un petit hack

Tout d'abord, il vous faut ajouter un pipeline au plug COG

Dans le fichier plugin.xml, ajouter :
  rechercher_liste_des_jointures cog_pipeline.php 
Ensuite dans le fichier cog_pipeline.php, ajouter la fonction :
	function cog_rechercher_liste_des_jointures($tables) { $tables['article']['cog_commune']['nom'] = 2; return $tables; }
Pour finir, si vous utilisez le plugins Fulltext, ajouter les deux fonctions présentent dans le fichier inc/cog_recherche_to_array.php dans le fichier cog_fonctions.php

sinon

renommer le fichier inc/cog_rechercher.php en inc/rechercher.php, vous activer de cette manière la surcharge du fichier rechercher.php présent dans ecrire/inc


COG-GPS : Ajoutez une position à vos communes
GuillaumeW — 2013-01-29T21:46:25Z

		
Table of contents
 Installatation téléchargement et intégration des données
Ce plugin est une extension du plugin COG, il permet d'ajouter les coodornnées GPS aux communes présente dans la table cog_communes.
Installatation téléchargement et intégration des données
Installation du plugins

Pour installer le plugin COG_gps, ce n'est pas différents des autres plugins. Pour ce qui n'ont jamais installer de plugins SPIP, référez vous à cet article https://www.spip.net/fr_article3396.html
Téléchargement des données
Le plugin ne comprenant pas les données, il faut les télécharger à partir du site geonames. 

Pour vous simplifier la tâche, le plugin comprends un formulaire pour charger les données nécessaires directement à la partir de l'espace privé de votre site SPIP.

Il vous faut aller sur la page importation, pour télécharger les données.
Attention : Au préalable au téléchargement, il vous faut vérifier que votre répertoire de stockage des données défini dans la configuration du plugin COG.
Intégration des données
Une fois le fichier téléchargé, vous pouvez procéder à l'intégration des données dans la table de votre base de donnée.


Coloration Code
bricebou, Matthieu Marcillaud — 2008-12-22T22:10:36Z

		Basé sur le moteur JavaScript highlight.js qui prend en charge près de 200 langages et propose près de 250 thèmes, ce plugin permet de coloriser du code source pour différents langages (dont HTML, PHP, SPIP...).
		
Table of contents
 Usage
 Configuration
 Développement
 Développer la syntaxe SPIP
Le plugin Coloration Code pour SPIP 4.2+ bascule d'un traitement côté serveur avec GeSHi à la librairie JavaScript highlight.js qui prend en charge près de 200 langages et propose près de 250 thèmes.
Usage
SPIP 4.2 introduit le raccourci triple backtips (```) pour délimiter des extraits de code. Il suffit de préciser le langage correspondant à votre extrait de code pour que celui-ci soit intégré au markup généré ; ainsi pour du HTML :
  ... 


Coloration Code se sert ainsi par exemple de l'attribut data-language généré par SPIP.
Configuration
Coloration Code fonctionne “out of the box” grâce à sa méthode de chargement dynamique, activée par défaut ; celle-ci permet de charger automatiquement toutes les syntaxes repérées au sein d'une page.
Cette méthode, si elle a l'avantage de permettre de suite de voir si le plugin fonctionne, reste problématique : en effet, les scripts des grammaires ainsi téléchargés ne passent pas au travers des mécanismes de concaténation, minification et surtout de cache de SPIP.
Il peut donc être plus intéressant d'utiliser la méthode statique qui nécessite de sélectionner les grammaires qui seront alors chargées sur toutes les pages de votre site mais qui passeront par les outils décrits ci-dessus.
Développement
L'ensemble des scripts de langage et des thèmes de highlight.js présents dans le répertoire assets/highlightjs/ de ce plugin sont une copie des fichiers générés par la compilation des sources de la librairie.
Une fois ce dépôt cloné, il faut récupérer la librairie highlight.js, déclarée en submodule de GIT :
$ cd lib/highlight.js
$ git submodule init
$ git submodule update

Une fois les sources de highlight.js récupérées, il faut installer les dépendances nécessaires à leur compilation :
$ npm install

Puis on lance la commande
$ node tools/build.js -t cdn

Les fichiers compilés et minifiés sont alors disponible dans le répertoire lib/highlight.js/build/.
Développer la syntaxe SPIP
L'écriture d'un langage pour highlight.js permettant de colorer la syntaxe des squelettes de SPIP est en cours ; le code en est disponible sur la forge de développement (https://git.spip.net/spip-contrib-outils/highlightjs-spip) et elle est intégrée comme submodule GIT de ce plugin.
Pour récupérer le code source :
$ cd lib/highlightjs-spip
$ git submodule init
$ git submodule update

Il convient alors de faire un lien symbolique de ce répertoire lib/highlightjs-spip vers lib/highlight.js/extra :
$ ln -s $PWD/lib/highlightjs-spip $PWD/lib/highlight.js/extra

Pour lancer la compilation des langages en mode développement, il faut utiliser la commande suivante depuis le répertoire de la lib, lib/highlight.js :
npm run-script build-browser spip

On peut alors utiliser l'outil fourni par highlight.js (lib/highlight.js/tools/developer.html) pour développer notre grammaire.
Ensuite, il convient de tester le langage :
$ npm run-script build_and_test



Coloration Syntaxique
jo — 2025-02-17T11:06:54Z

		Du code en couleur pour plus de 500 langages de programmation avec PrismJS
		
Table of contents
 Pourquoi un nouveau plugin ?
 Fonctionnalités
 Compatibilité et prérequis du plugin SPIP
 Utilisation
 Code en ligne
 Bloc de code
 Coloration syntaxique
 Exemples
 Coloration syntaxique spécifique à SPIP
 Nouveau raccourci SPIP : 
 Paramètres
 Exemples d'utilisations
 2 nouveaux squelettes SPIP pour afficher des portions de code informatique
 inclure/coloration_syntaxique
 inclure/exemple_de_code
 3 nouveaux pipelines SPIP
 2 pipelines pour vos CSS et Javascript
 1 pipeline pour personnaliser l'affichage du code source d'un exemple de code

  

Pourquoi un nouveau plugin ?
L'objectif du plugin est d'ajouter très simplement la possibilité de partager des portions de codes informatique au sein de vos contenus éditoriaux (articles, rubriques, etc...).
Le plugin coloration_code permet lui aussi de coloriser vos portions de code mais il utilise la librairie HighlightJS alors que ce plugin utilise PrismJS. Vous avez donc maintenant le choix en fonction de vos besoins si vous préférez HighlightJS ou PrismJS.
Le but de ce plugin est de rester très minimaliste, selon le principe « KISS, Keep It Simple, Stupid ».
Il ne dépend d'aucun autre plugin et charge les css/javascript de coloration syntaxique uniquement si il y a des balises  dans la page pour optimiser et alléger le rendu des pages.

Fonctionnalités
 Le plugin ajoute la coloration syntaxique à tous les langages de programmation supportés par la librairie PrismJS. Il inclut aussi la prise en charge des langages spip (pour la typographie SPIP) et spip-squelette (pour les squelettes SPIP) pour faciliter le partage au sein de la communauté SPIP 😊.
 Une unification de l'utilisation des raccourcis typographiques , , et  est faite

pour afficher le même résultat quelque soit le raccourci utilisé.
 Le raccourci  est quant à lui échappé et sécurisé sans traitement des balises  qu'il peut contenir.
 Le raccourci typographique backtick simple markdown (ex. `ligne de code...`) est maintenant traité lors de l'appel de la fonction typo(), permettant ainsi d'ajouter du code sur une ligne au fil du texte dans vos titres, sous-titres et autres champs apparentés.
 Le plugin facilite le copier-coller des blocs de code. En survolant un bloc de code, un bouton « Copier » s'affiche et au clic le contenu est copié dans le presse-papier.
 Le plugin corrige aussi un bug du core SPIP qui affiche parfois en base64 des parties d'une portion de code (par exemple : test).
 Unification de la coloration syntaxique avec le squelette inclure/coloration_syntaxique.html pour pouvoir être utilisé directement depuis un squelette ou un raccourci typographique.
 Chargement des css/javascript de coloration syntaxique uniquement si il y a des balises  dans la page pour optimiser et alléger le rendu des pages.
 Un nouveau raccourci typographique SPIP  pour présenter proprement un exemple de code html ou spip.
Compatibilité et prérequis du plugin SPIP

Le plugin est compatible avec :
 SPIP 4.2+
 PHP 8.1+
Utilisation
Le plugin utilise le plugin porte_plume pour ajouter des boutons à la barre d'édition de code informatique.
 Code en ligne
`...votre portion de code...` 
Le raccourci «backtick» simple, comme en Markdown [1], est utilisé pour afficher du code informatique au fil du texte. Cette portion de code informatique se trouve au sein d'un texte et reprend les caractéristiques typographiques de celui-ci tout en étant encadré.
 Bloc de code
Pour afficher des portions de code informatique de plusieurs lignes, le triple «backtick» doit être utilisé (comme en Markdown [1]). Cela permet de bien restituer les indentations au début de chaque ligne.
 Coloration syntaxique
Consultez la liste des langages de programmation supportés pour connaitre la référence d'un langage de programmation.
Il est possible de préciser un langage de programmation pour activer une coloration syntaxique du code. Pour cela, ajouter la référence du langage concerné juste après les 3 premiers «backtick». Par exemple pour du code HTML, commencez votre portion de code avec la référence : html.
 Exemples
 CSS
Le code suivant :
```css .container { width: 900px; } .container div { display: inline-block; width: 300px; } ``` 
Affichera :

 

 HTML
Le code suivant :
```html  Lorem Elsass ipsum bredele [...]
 Lorem Elsass ipsum bredele [...]
 Lorem Elsass ipsum bredele [...]
 
 ``` 
Affichera :

 

 Coloration syntaxique spécifique à SPIP
Pour faciliter le partage de portion de code SPIP et SQUELETTE, le plugin inclut la prise en charge des langages spip (pour la typographie SPIP) et spip-squelette (pour les squelettes SPIP).
Le code suivant :
```spip {{{ Un intertitre }}} Du texte avec {de l'italique} et {{du gras}} ou un {{ {mélange des deux} }}. Un retour à la ligne avec [un lien externe->https://www.spip.net], [un lien interne->art2] et un lien interne avec un titre automatique [->rubrique2]. -* Une liste -* Une liste -** Sous élément de liste -# Une liste ordonnée -# Une liste ordonnée -## Sous élément de liste ordonnée Un séparateur ---- ``` 
Affichera :

  


Le code suivant :
```spip-squelette   [(#DATE|annee|!={#VAL{Y}|date}|oui)[(#DATE|annee)]] - [(#DATE|annee) ]#NOM_SITE_SPIP 
<:plan_site:>[ (#SESSION{id_auteur}|non) | <:lien_connecter:>][ (#AUTORISER{ecrire})| <:espace_prive:>][ (#SESSION{id_auteur}|oui) | <:icone_deconnecter:>] | <:contact:> | " class="last">RSS 2.0 
 [" class="generator spip_out">(#CHEMIN{spip.svg}|balise_svg{'',SPIP})] 
 ``` 
Affichera :

  

Nouveau raccourci SPIP : 

  


Une fois activé, le plugin permet l'utilisation du raccourci ... dans vos contenus éditoriaux. Ce raccourci permet de présenter proprement un exemple de code html ou spip qui affichera successivement le rendu puis le code source de l'exemple.
 Paramètres
Comme pour les modèles SPIP des paramètres sont disponibles :
 langage (spip par défaut)
 titre (Exemple de code : $langage$ par défaut)
 Exemples d'utilisations
Avec les paramètres par défaut :
 Du texte avec {de l'italique} et {{du gras}} ou un {{ {mélange des deux} }}.  
Avec un titre personnalisé :
 Du texte avec {de l'italique} et {{du gras}} ou un {{ {mélange des deux} }}.  
Avec du code HTML :
  Lorem Elsass ipsum bredele [...]
 Lorem Elsass ipsum bredele [...]
 Lorem Elsass ipsum bredele [...]
 
  
2 nouveaux squelettes SPIP pour afficher des portions de code informatique
Vous trouverez une explication plus détaillée des paramètres d'inclusions directement dans le code source de chaque squelette.
 inclure/coloration_syntaxique
#SET{code,#CHEMIN{demo/coloration_syntaxique_code.html}|spip_file_get_contents}  
 inclure/exemple_de_code
#SET{code,#CHEMIN{demo/coloration_syntaxique_exemple_de_code.spip}|spip_file_get_contents}  
3 nouveaux pipelines SPIP
 2 pipelines pour vos CSS et Javascript
Pour alléger le chargement des pages, le plugin déclenche dynamiquement le chargement des CSS/Javascript nécessaire à 

la coloration syntaxique uniquement si une portion de code est présente dans la page.
Pour ajouter vos propres CSS/Javascript vous pouvez utiliser les pipelines suivant en indiquant le chemin du fichier CSS/Javascript

à charger dynamiquement :
 coloration_syntaxique_css
 coloration_syntaxique_javascript
/** * @pipeline coloration_syntaxique_css * * @param array $flux * * @return $flux **/ function nomdevotreplugin_coloration_syntaxique_css($flux) { // exemple pour 2 feuilles de styles CSS chargées dynamiquement : // 1. Feuille de style CSS sous forme de squelette `css/coloration_syntaxique_nomdevotreplugin_squelette.css.html` $flux['css/coloration_syntaxique_nomdevotreplugin_squelette.css'] = produire_fond_statique('css/coloration_syntaxique_nomdevotreplugin_squelette.css'); // 2. Feuille de style CSS simple `css/coloration_syntaxique_nomdevotreplugin.css` $flux['css/coloration_syntaxique_nomdevotreplugin.css'] = timestamp(find_in_path('css/coloration_syntaxique_nomdevotreplugin.css')); return $flux; } 
 1 pipeline pour personnaliser l'affichage du code source d'un exemple de code
Lors de l'affichage d'un exemple_de_code, vous pouvez utiliser le pipeline exemple_de_code_source.
/** * @pipeline exemple_de_code_source * * @param array $flux => [ * 'args' => [ * 'code' => {string}, // code source de l'exemple * 'langage', => {string}, // langage de l'exemple (spip|html) * 'titre', => {string}, // titre de l'exemple * 'nombre_de_lignes', => {int}, // nombre de lignes du code source de l'exemple * ], * 'data' => {string}, // rendu HTML de l'affichage du code source de l'exemple * ] * * @return $flux **/ function nomdevotreplugin_exemple_de_code_source($flux) { // ne pas afficher le code source de l'exemple sur l'espace privé if ( test_espace_prive() ) { return ''; } else { $exemple = ''; $exemple .= 'Titre : '.$flux['args']['titre'].'
'; $exemple .= 'Langage : '.$flux['args']['langage'].'
'; $exemple .= 'Nombre de lignes : '.$flux['args']['nombre_de_lignes'].'
'; $exemple .= '
'; $flux['data'] .= $exemple; } return $flux; } 

		
		
[1] Markdown : langage de balisage léger créé en 2004 par John Gruber, avec l'aide d'Aaron Swartz.



Comarquage Service public Flux v2
Laurent Vergerolle, Pascal W — 2010-12-09T09:29:20Z

		Le co-marquage s'adresse aux services de l'état et administrations locales, il permet aux sites web locaux de rediffuser les contenus et les services offerts par le portail de l'administration française, Service-public.fr.
Ce plugin est une adaptation du plugin conçu par Cedric MORIN. En effet, depuis septembre 2010, une nouvelle organisation des fichiers XML, appelée « Flux v2 » a été mise en place, et la version précédente du plugin n'était plus fonctionnelle avec ce nouveau flux.
Site officiel : co-marquage avec service-public.fr
		
Table of contents
 A propos du comarquage
 Installation
 Mise en oeuvre
 Auteur


Attention : 

Cette version est en phase de développement donc sans garantie et donc à ne pas employer sur un site de production sans tests ni compétences.
A propos du comarquage
Le co-marquage s'adresse aux services de l'état et administrations locales, il permet aux sites web locaux de rediffuser les contenus et les services offerts par le portail de l'administration française, Service-public.fr, en le complétant par des informations locales : coordonnées d'organismes, téléservices locaux, etc.

L'utilisation du co-marquage est soumis à convention préalable avec la DILA (Direction de l'information légale et administrative).
Installation
L'installation se déroule comme pour tous les autres plugins, cf. http://www.spip.net/fr_article3396.html

Ce plugin nécessite la présence de libxslt sur votre serveur, utilisable en ligne de commande par 'xsltproc', et que la commande php 'exec' ne soit pas inhibée.

Pour la version pour SPIP 2, le plugin CFG est nécessaire.
Mise en oeuvre
Installer le plugin.
Paramétrer le code INSEE de la collectivité dans la page de configuration du plugin.
Le flux s'insère dans un article au moyen du tag :

Vous pouvez préciser une page précise en définissant les attributs xml et xsl de l'url :

Par exemple pour appeler la page principale de la rubrique 'Comment faire si' utilisez ce code : 

Pour appeler la page principale de la rubrique 'Associations', insérer ce code : 

La partie concernant les Entreprises n'est pas opérationnelle dans cette version (feuille XSL non développées)
Auteur
- Plug-in initial conçu pour le flux V1 : Cedric MORIN

- Fichier XSL pour le flux V2 fournis par la Ville de Pont-Audemer

- Adaptation du plugin au flux v2 : Vernalis Interactive

- Portage vers SPIP 3.0 : IPEOS I-Solutions


Commandes
RastaPopoulos, tcharlss — 2014-05-16T07:34:26Z

		Le plugin «commandes» permet de gérer des commandes.
		
Table of contents
 Principe
 Installation et dépendances
 Fonctionnement
 Boucles et balises
 Gestion dans l'espace privé
 Notifications
 Fonctions utiles
Attention Le plugin ne s'occupe pas de la gestion des paniers, ni des paiements, ni des factures. Pour l'aspect «boutique», voir le post-scriptum.
Ce plugin a été élaboré grâce aux contributions de Matthieu Marcillaud, Rastapopoulos, Yffic, touti, Cyril, et du rédacteur de cet article.
Principe
Le plugin agit sur 2 fronts :

→ d'une part il permet aux utilisateurs de gérer les commandes depuis l'espace privé.

→ d'autre part, il fournit les outils permettants et aux développeurs et aux autres plugins de créer et manipuler des commandes.
Installation et dépendances
Le plugin est repertorié dans le dépôt proposé par défaut : «SPIP-Zone - Plugins». Aussi, il est installable depuis la page Gestion des plugins, onglet Ajouter des plugins si vous avez activé ce dépôt.
2 dépendances seront installées automatiquement :
 Saisies
 API prix : permet de calculer les prix HT et TTC des commandes et de leurs détails.
D'autres plugins sont plus ou moins optionnels, là c'est à vous de voir :
 Notifications avancées : à installer si on veut bénéficier de l'envoi de notifications par email.
 Facteur : sans lui, les notifications seront au format texte au lieu d'un joli HTML.
 Coordonnées : fortement recommandé afin de pouvoir gérer les adresses liées aux commandes (livraison et facturation).
 Contacts et organisations : peut vous servir à gérer les auteurs/clients des commandes.
Fonctionnement
A l'installation, 2 tables sont créées :
 La table principale spip_commandes sert à enregistrer les données de base des commandes : l'auteur/client, le numéro de référence, le statut et les dates.
 La table auxiliaire spip_commandes_details sert à enregistrer les «détails» correspondants aux commandes, c'est à dire tous les éléments à partir desquels on va pouvoir calculer le prix total d'une commande : objets et services commandés, frais annexes, ristournes etc.
En théorie, à chaque commande enregistrée dans la table spip_commandes doit correspondre une ou plusieurs lignes de détails dans la table spip_commandes_details.
La table spip_commandes :

Une commande est un objet éditorial, au même titre que les articles, brèves et cie. Elles ont un auteur (le client), différents statuts et 3 types de dates : date de création, date de paiement & date d'envoi.

La date de création correspond au champ «date», elle est définie à la création de la commande, et n'est pas censée être altérée par la suite.

Le changement d'un statut peut déclencher l'envoi de notifications par email, et la mise à jour de la date s'y rapportant :

→ passer le statut à “payée” met à jour la date de paiement.

→ passer le statut à “envoyée” met à jour la date d'envoi.

composition de la table spip_commandes


id_commande
Identifiant unique de la commande

reference
Numéro de référence (il ne s'agit pas d'une clé unique).

id_auteur
Identifiant de l'auteur/client

statut
encours, attente, partiel, paye, envoye, retour_partiel, retour, erreur

date
Date de création

date_paiement
Date de paiement

date_envoi
Date d'envoi

maj
Date de la dernière mise à jour


La table spip_commandes_details :

Pour le contenu des commandes, on parle de «détails» : chaque commande est constituée d'une ou plusieurs lignes de détails.

Un détail est tout élément qui participe au prix d'une commande.

On peut distinguer 2 types de détails :
 Les détails correspondants directement aux objets ou aux services commandés.
 Les détails «annexes» : il peut s'agir des frais de port, des frais de dossier, des ristournes etc.
Une ligne de détail comprend à minima les champs descriptif et prix_unitaire_ht, le cas échéant complétés par les champs taxe et quantite.

Dans le cas où l'objet commandé est un objet éditorial SPIP, des champs objet et id_objet permettent de l'identifier.

composition de la table spip_commandes_details


id_commandes_detail
Identifiant unique du détail (attention au «s» à commandes)

id_commande
Identifiant de la commande concernée

descriptif
Texte décrivant le détail. S'il s'agit d'un objet éditorial, il peut s'agir de son titre, descriptif ou autre.

quantite
Quantité

prix_unitaire_ht
Prix Hors Taxe

taxe
Taxe (TVA)

statut
Statut

objet
Type d'objet s'il s'agit d'un objet éditorial

id_objet
Identifiant de l'objet s'il s'agit d'un objet éditorial

maj
Date de la dernière mise à jour


Exemple des enregistrements en base pour une commande et ses détails
Prenons une commande de 2 objets avec TVA à 20%, comportant des frais de port et une ristourne. Dans la base de donnée, ça nous donne ceci :
1 ligne dans la table spip_commandes



id_commande
reference
id_auteur
statut
date
date_paiement
date_envoi
maj

1
xxxxxx
1
encours
2014-05-14 09:00:00
0000-00-00 00:00:00
0000-00-00 00:00:00
2014-05-14 09:00:00


4 lignes dans la table spip_commandes_details



id_commandes
_detail

id_commande
descriptif
quantite
prix
_unitaire_ht

taxe
statut
objet
id_objet
maj

1
1
Gibolin 2000
2
8
0.2

produit
1
2014-05-14 09:00:00

2
1
Ripolin 5000
1
12
0.2

produit
2
2014-05-14 09:00:00

3
1
Frais de port
0
4
0



2014-05-14 09:00:00

4
1
Ristourne
0
-2
0



2014-05-14 09:00:00

Boucles et balises
Balises #PRIX et #PRIX_HT
Grâce au plugin API prix, les balises #PRIX et #PRIX_HT permettent d'obtenir automagiquement les prix TTC et HT d'une commande ou d'un de ses détails.
Dans une boucle COMMANDES :
 #PRIX = somme des prix TTC des détails.
 #PRIX_HT = somme des prix HT des détails.
Dans une boucle COMMANDES_DETAILS :
 #PRIX = #QUANTITE * (#PRIX_UNITAIRE_HT + (#TAXE * #PRIX_UNITAIRE_HT))
 #PRIX_HT = #QUANTITE * #PRIX_UNITAIRE_HT.
Boucles
Exemple minimal de boucle affichant pour chaque commande un résumé de ses détails et son prix total TTC:
 Commande N°#ID_COMMANDE
  [(#QUANTITE) *]#DESCRIPTIF = #PRIX
 
 Prix total TTC : #PRIX 
Gestion dans l'espace privé
Configuration

La page de configuration est accessible depuis le menu Configuration > Commandes 

On peut y gérer les 3 points suivants :
 La durée d'expiration des commandes ayant le statut «en cours». On considère que les commandes restant «en cours» pendant plus d'un certain temps sont des commandes abandonnées : il est inutile de les conserver dans la base.
 l'activation et le fonctionnement des notifications (cf. plus bas).
 L'affichage en page d'accueil de la liste des commandes «actives» (cf. plus bas).
Liste des commandes

Une page Commandes est accessible depuis le menu Edition.

L'encart à gauche sert à filtrer les commandes en fonction de leurs états, de leurs dates de création, et des auteurs/clients.

Au niveau de la liste, les commandes ayant le statut «envoyé» sont surlignées en vert, afin de repérer facilement les commandes terminées.


 
 Page de gestion des commandes
 

Fiche d'une commande

La fiche d'une commande est composé de 3 parties :
 Le contenu de la commande : il s'agit d'un tableau listant les détails de la commande.
 Les adresses : si le plugin Coordonnées est installé, sont affichées les adresses associées à la commande, ou à défaut celles associées à l'auteur de la commande.
 L'auteur/client de la commande : si le plugin Contacts et Organisations est installé, on affiche les infos du contact, sinon des infos sur le client.
A noter : Pour les adresses, il n'est pas nécessaire d'activer l'ajout de coordonnées aux commandes dans les options du plugin Coordonnées.


 
 Fiche d'une commande
 

Commandes «actives»

Il est possible d'afficher en page d'accueil la liste des commandes «actives». il s'agit des commandes nécessitant une prise en charge. Pour se faire, il faut activer l'option dans la configuration du plugin, et choisir les statuts correspondants.


 
 Commandes “actives” en page d'accueil
 


Notifications
Mise en place

On peut activer 'envoi d'emails de notification au vendeur et au client lorsque les commandes acquièrent certains statuts.

Le plugin «Notifications avancées» doît être installé. Le plugin Facteur est également fortement recommandé afin d'envoyer les messages au format HTML.

Rendez vous ensuite sur le formulaire de configuration du plugin pour activer et configurer les notifications.
Personnalisation des emails

Par défaut, les messages envoyés sont spartiates :


 
 Email par défaut envoyé au client
 

Leurs squelettes sont présents dans le répertoire /notifications du plugin.

Pour chaque type de notification (vendeur & client), il y a 3 variantes :
 commande_xxx_html.html au format HTML.
 commande_xxx.html au format texte brut.
 commande_xxx_court.html au format court, type microblog ou SMS.
Par commodité, ces 6 squelettes incluent tous le même squelette mutualisé, avec différents paramètres pour moduler l'affichage : contenu_commande_mail.html.

Il suffit de surcharger ce squelette pour le personnaliser selon vos besoins.
Si vous avez besoin de 2 squelettes vraiment différents pour les emails vendeur et client, vous pouvez au choix :
 Faire ça au niveau du squelette contenu_commande_mail.html en jouant sur le paramètre #ENV{qui} :
[(#ENV{qui}|=={client}|oui)][(#ENV{qui}|=={vendeur}|oui)]
 Ou bien surcharger directement les 6 squelettes clients et vendeurs.
Fonctions utiles
Voici une liste non exhaustive de certaines fonctions, celles qui pourront vous être utiles lors de l'intégration du plugin dans votre projet. Pour les détails (paramètres etc.) et la liste complète, voir le site https://code.spip.net/commandes/.

commandes_fonctions.php


commandes_lister_statuts

Cette fonction retourne les différents statuts des commandes. On peut s'en servir comme filtre dans les squelettes pour obtenir la chaîne de langue d'un statut : [(#STATUT|commandes_lister_statut)]


inc/commandes.php


creer_commande_encours

Crée une commande avec le statut «en cours» pour le visiteur actuel. La commande créée est «vide» : la fonction ne se charge pas de créer les détails. C'est le rôle des plugins tiers (Commandes de paniers par ex.).
A noter : on considère qu'il ne peut y avoir qu'une commande «en cours» par session et par auteur. Si une telle commande est déjà présente dans la session, elle va être supprimée de la base et de la session avant la création de la nouvelle.
 
Exemple :

$creer_commande = charger_fonction('creer_commande_encours', 'inc/'); $id_commande = $creer_commande;

commandes_supprimer

Permet de supprimer «proprement» une ou plusieurs commandes, en s'occupant également des données associées. Pour chaque commande à supprimer, la fonction effectue les actions suivantes :

- suppression de la commande

- suppression de ses détails

- dissociation de ses adresses liées, et éventuellement suppression si elles se retrouvent orphelines.
 
Exemple :

$ids_commandes = array(1,2,3); $supprimer_commandes = charger_fonction('commandes_supprimer', 'inc/'); $supprimer_commandes($ids_commandes);

traiter_notifications_commande

Envoie les notifications par email d'une commande, si les conditions sont réunies. Cette fonction est appelée lors de la création d'une commande, puis à chaque changement de statut.


inc/commandes_reference.php


inc_commandes_reference_dist

Cette fonction retourne une référence unique utilisée pour remplir le champ éponyme lors de la création d'une commande. Il s'agit du temps écoulé depuis le 1er janvier 1970, en secondes.

Elle est destinée à être surchargée pour l'adapter à vos besoins.


action/xxx.php


supprimer_commande

Supprime «proprement» une commande. Fait appel à la fonction commandes_effacer, avec les mêmes effets donc.
 
Exemple :

#URL_ACTION_AUTEUR{supprimer_commande,#ID_COMMANDE,#SELF}

instituer_commande

Change le statut d'une commandes
 
Exemple :

#URL_ACTION_AUTEUR{instituer_commande,#ID_COMMANDE-envoye,#SELF}


		Pour aller plus loin : «Commandes» au sein du framework e-commerce
Ce plugin fait partie d'un framework dédié au e-commerce, il s'interface notamment avec les plugins suivants :
 Paniers
 Abonnements + Commandes d'abonnements
 Bank
Il n'y a pas encore de documentation qui traite du framework dans son ensemble, on notera cependant les 2 plugins suivants :
 Tuto commerce» : tutoriel des briques minimales à mettre en place pour une boutique en ligne.
 Zcommerce : charger les plugins nécessaires à la création d'une boutique en ligne
Pour un aperçu général de tous les outils destinés au e-commerce, voir l'article Inventaire des outils SPIP pour du e-commerce


Comments 1 pour SPIP 1.9
tetue — 2009-12-04T17:24:00Z

		Commentaires de type blog, avec gravatar, permalien et formulaire simplifié.
		
Table of contents
 Formulaire de commentaires
 Liste des commentaires
Il suffit d'activer le plugin pour qu'il remplace le traditionnel #FORMULAIRE_FORUM par un formulaire de commentaires simplifié avec affichage des réponses en liste.
Formulaire de commentaires
Le formulaire de commentaires est une version simplifiée du traditionnel #FORMULAIRE_FORUM de SPIP. Il présente 4 champs maximum : nom, courriel, site perso et message.


 
 Exemple de formulaire de commentaires
 
Liste des commentaires
 La noisette  affiche les commentaires en liste (thread).
 Chaque commentaire est constitué du message (sans titre), daté, avec ancre, nom et trombine de l'auteur (logo d'auteur ou gravatar , cf.: Des gravatars avec SPIP).
 L'URL est désormais associée à l'auteur du commentaire (et non plus au message comme traditionnellement dans SPIP).
 Le modèle #MODELE{comment}, qui affiche un commentaire seul, permet au webmestre de construire à sa guise aussi bien une liste de commentaires qu'un forum de discussion.
 Le modèle #MODELE{comments-nb} affiche le nombre de commentaire, en réponse à un article, par exemple.
		Cette version du plugin développée sur la Zone n'est plus maintenue car une version plus récente est disponible : « Comments 2 pour SPIP 2 ».


Comments 2 pour SPIP 2
tetue — 2010-04-08T08:24:00Z

		Commentaires de type blog, avec formulaire simplifié, microformats et nomenclature homogène.
		Commentaires de type blog avec formulaire simplifié : plugin prêt à l'emploi et paramétrable. Personnalisation facilité par sa nomenclature homogène.
		
Table of contents
 Mise en service des commentaires
 Quelques caractéristiques
 Habillage graphique des commentaires
 Plugins recommandés en complément
 Exemples
 Évolutions souhaitables (todolist)
Mise en service des commentaires
Il suffit d'activer ce plugin pour qu'il remplace aussitôt le traditionnel #FORMULAIRE_FORUM de SPIP par un formulaire de commentaires simplifié, et l'habituel  des squelettes par défaut de SPIP, par une liste de commentaires.
Autre possibilité : insérez  [1] dans votre squelette article.html pour afficher d'un coup les commentaires suivis du formulaire de réponse, avec les flux d'abonnement.
Vous pouvez modifier quelques paramètres via le panneau de configuration dédié : affichage en liste à plat ou en enfilade (thread), apparence du lien permanent, etc.

 


Pour tout autre personnalisation, il faut intervenir dans les squelettes. Voir alors « Inclusions du plugin Comments ».
Quelques caractéristiques
 Ce plugin est la version suivante de « Comments 1 pour SPIP 1.9 » qui n'est donc plus maintenue.
 L'affichage des gravatars n'est plus effectué par cette version, puisque délégué au plugin dédié « Gravatar ».
 Cette version propose deux flux de syndication (RSS et Atom) d'abonnement aux commentaires (presque aussi bien que dans SpipClear).
 Chaque commentaire est microformaté (selon hReview).
 Le formulaire de commentaire est le traditionnel #FORMULAIRE_FORUM de SPIP, légèrement simplifié (sans titre de message ni titre de lien [2] ) : il en propose donc toutes les fonctionnalités habituelles, paramétrables via les panneaux de config dédiés de SPIP.
 À partir de SPIP 2.1, les URLs des messages sont constituées d'ancres de type « comment324 » et non plus « forum324 ». Les anciennes URLs restent bien évidemment fonctionnelles.
 À partir de SPIP 2.1, ce plugin affiche des boutons d'admin (visibles des seuls admins connectés) sous chaque commentaire, qui permettent de modérer directement dans le fil de la discussion.
Habillage graphique des commentaires
Pour ne pas gêner la personnalisation graphique, les commentaires ne sont pas stylés par défaut, mais dotés de nombreux sélecteurs CSS à la nomenclature cohérente et homogène. Tous sont préfixés de « comments » généralement au pluriel. Par exemple :
.comments { ... } .comments .comments-list { ... } .comments .comments-list .comment-li { ... } .comment { ... } .comment .comment-meta { ... } .comment .comment-meta a.permalink { ... } .comment img.avatar { ... } .comments .comment-form { ... }
Si elle est présente (dans le répertoire css de votre dossier squelettes), ce plugin insère automatiquement la feuille de style comments.css.
Plugins recommandés en complément
 Gravatar : pour afficher la trombinette des auteurs en vis-à-vis de leurs commentaires, y compris en prévisualisation.
 Notifications : pour pouvoir être automatiquement notifié par courriel des nouveaux commentaires.
 NoSPAM : pour limiter les SPAMs, comme son nom l'indique, sans emmerder les internautes par un captcha.
Exemples
En attendant vos magnifiques captures d'écran, découvrez ce plugin en service sur ces sites : en liste simple (avec ou sans ancre) sur cuisine-libre.org et romy.tetue.net, en thread sur zzz.rezo.net et ici sur spip-contrib, en thread paginé, avec possibilité de répondre directement dans le fil de discussion.

 
 Exemple de commentaires sur Cuisine-libre.org
 
Évolutions souhaitables (todolist)
Ce plugin est développé publiquement sur la zone et espère évoluer, notamment en proposant quelques paramétrages supplémentaires comme le choix des champs obligatoires (pseudo, courriel), en distinguant les messages postés par les auteurs de l'article et surtout en donnant la possibilité aux internautes de s'abonner par courriel à chaque fil de discussion, au cas par cas... Voir : « Plugin Comments : notes de développement ».
		
		
[1] Dès que l'on inclut un #FORMULAIRE_... mieux vaut faire un  plutôt qu'un #INCLURE{...}.

[2] Le lien est proposé uniquement aux visiteurs non identifiés et leur permet d'indiquer l'URL de leur site web. #URL_SITE ajoute un lien cliquable sur le nom de l'auteur du message.



Comments 3 pour SPIP 3
Cerdic, tetue — 2012-09-08T10:47:46Z

		Commentaires de type blog, avec formulaire simplifié, microformats et nomenclature homogène.
		Commentaires de type blog, avec formulaire simplifié, microformats et nomenclature homogène. 

Le fonctionnement reste dans la continuité de la version précédente Comments 2 pour SPIP 2 avec quelques améliorations.
		
Table of contents
 Mise en service des commentaires
 Quelques caractéristiques
 Habillage graphique des commentaires
 Plugins recommandés en complément
 Évolutions souhaitables (todolist)
Mise en service des commentaires
Il suffit d'activer ce plugin pour qu'il remplace aussitôt le traditionnel #FORMULAIRE_FORUM de SPIP par un formulaire de commentaires simplifié, et l'habituel  des squelettes par défaut de SPIP, par une liste de commentaires.
Autre possibilité : insérez  [1] dans votre squelette article.html pour afficher d'un coup les commentaires suivis du formulaire de réponse, avec les flux d'abonnement.
Vous pouvez modifier quelques paramètres via le panneau de configuration dédié :
 affichage en liste à plat, en enfilade (thread), ou en enfilade à un seul niveau
 apparence du lien permanent
 longueur minimum et maximum des messages
 choix de rendre ou non la saisie d'un email obligatoire

 


Pour tout autre personnalisation, il faut intervenir dans les squelettes. Voir alors « Inclusions du plugin Comments ».
Quelques caractéristiques
 L'affichage des gravatars est délégué au plugin dédié « Gravatar ».
 Cette version propose deux flux de syndication (RSS et Atom) d'abonnement aux commentaires (presque aussi bien que dans SpipClear).
 Chaque commentaire est microformaté (selon hReview).
 Le formulaire de commentaire est le traditionnel #FORMULAIRE_FORUM de SPIP, légèrement simplifié (sans titre de message ni titre de lien [2]) : il en propose donc toutes les fonctionnalités habituelles, paramétrables via les panneaux de config dédiés de SPIP.
 Si vous utilisez le plugin Notifications le formulaire propose de s'abonner ou non à la discussion par courriel, via une case à cocher.
 Les URLs des messages sont constituées d'ancres de type « comment324 » et non plus « forum324 ». Les anciennes URLs restent bien évidemment fonctionnelles.
 Le plugin affiche des boutons d'administration sous chaque commentaire (visibles des seuls admins connectés et autorisés), qui permettent de modérer directement dans le fil de la discussion.
Habillage graphique des commentaires
Pour ne pas gêner la personnalisation graphique, les commentaires ne sont pas stylés par défaut, mais dotés de nombreux sélecteurs CSS à la nomenclature cohérente et homogène. Tous sont préfixés de « comments » généralement au pluriel. Par exemple :
.comments { ... } .comments .comments-list { ... } .comments .comments-list .comment-li { ... } .comment { ... } .comment .comment-meta { ... } .comment .comment-meta a.permalink { ... } .comment img.avatar { ... } .comments .comment-form { ... }
Si elle est présente (dans le répertoire css de votre dossier squelettes), ce plugin insère automatiquement la feuille de style comments.css.
Plugins recommandés en complément
 Gravatar : pour afficher la trombinette des auteurs en vis-à-vis de leurs commentaires, y compris en prévisualisation.
 Notifications : pour pouvoir être automatiquement notifié par courriel des nouveaux commentaires.
 NoSPAM : pour limiter les SPAMs, comme son nom l'indique, sans emmerder les internautes par un captcha.
Évolutions souhaitables (todolist)
Ce plugin est développé publiquement sur la zone et espère encore évoluer... Voir : « Plugin Comments : notes de développement ».
		
		
[1] Dès que l'on inclut un #FORMULAIRE_... mieux vaut faire un  plutôt qu'un #INCLURE{...}.

[2] Le lien est proposé uniquement aux visiteurs non identifiés et leur permet d'indiquer l'URL de leur site web. #URL_SITE ajoute un lien cliquable sur le nom de l'auteur du message.



Compositions 1
Cerdic, tetue — 2009-05-10T09:35:00Z

		Ce plugin vous permet de définir plusieurs variantes de compositions pour chaque type objet SPIP (article, rubrique, etc.) et de les appliquer simplement, au cas par cas, depuis l'espace privé.
		
Table of contents
 Objectif
 Fonctionnement du plugin
 Configuration
 Définir des compositions
 Utilisation avec les squelettes de type Z comme Zpip
 Utilisation personnalisée dans les squelettes
 Interface

 

Objectif
Ce plugin a pour but de fournir un mécanisme et une interface pour faire varier le type de composition de chaque objet en fonction des besoins.
Par exemple, vous pouvez avoir besoin de composer certains articles sous une forme d'article de journal, et certains autres comme des albums photos.
Ou vous pouvez vouloir composer certaines rubriques comme des blogs, et d'autres de façon plus classique...
Pour faire varier la composition des objets d'un même type, SPIP met nativement quelques solutions à la disposition des webmestres :
 les squelettes suffixés par le numéro de rubrique (rubrique-23.html) permettent souvent de s'en tirer, mais présentent de gros défauts : la maintenance squelettes organisés sur ce mode devient vite très lourde, et aucune interface ne permet de changer la composition d'un objet parmi celles existantes une fois qu'elle a été fixée par le webmestre avec un squelette particulier.
 les mots clés “techniques” utilisés dans les squelettes pour choisir indirectement le type de composition fonctionnent également. Toutefois, l'ergonomie est peu adaptée à cet usage, et si jamais le site utilise aussi des mots clés pour la navigation les administrateurs sont vites perdus.
Le plugin apporte donc une nouvelle fonctionnalité à SPIP.
Fonctionnement du plugin
Le plugin propose un formalisme de définition des compositions et une interface générée automatiquement qui permet aux administrateurs du site de choisir parmi les compositions disponibles.
Par défaut, le squelette qui définit la composition est alors automatiquement sélectionné par SPIP.
Configuration
Le plugin ne nécessite pas CFG, mais si celui-ci est installé vous pourrez modifier certaines options de fonctionnement. Dans le cas contraire, les réglages par défaut seront appliqués.

 


Dossier des compositions
Ce réglage vous permet de choisir le sous-dossier qui contiendra les différentes compositions. Par défaut le nom de dossier compositions/ est utilisé. C'est-à-dire que les compositions seront recherchées dans squelettes/compositions/, puis dans les sous dossiers compositions/ des plugins, etc.
Compositions des rubriques
Le plugin permet de sélectionner pour chaque rubrique un article d'accueil qui pourra être utilisé par le webmestre pour présenter la rubrique.
#ID_ARTICLE_ACCUEIL désigne l'id_article de l'article sélectionné en accueil.
Cette fonctionnalité peut être désactivée pour ne pas charger l'interface.
Sélection des squelettes
Par défaut, le squelette de la composition est sélectionné automatiquement par SPIP. Mais ce mécanisme est désactivable pour des besoins précis.
Définir des compositions
Une composition est constituée par une paire de fichiers : un squelette et un fichier XML qui l'accompagne et porte le même nom. Leur nom est composé du type de l'objet (article, rubrique ou autre) suivi du nom de la composition séparée par un tiret. Par exemple : article-edito.html et article-edito.xml ou encore rubrique-chronologique.html et rubrique-chronologique.xml.
Les compositions doivent être rangées dans un sous-répertoire de votre dossier squelettes, appelé compositions/ (le nom de ce sous-répertoire est configurable).
Il est possible de définir une composition par défaut pour chaque type d'objet, en la nommant simplement article, rubrique, etc. sans la suffixer.
Pour définir une composition de type portfolio d'un article on va par exemple :
 créer un squelette compositions/article-portfolio.html,
 créer à côté un fichier compositions/article-portfolio.xml.
Le squelette sera constitué classiquement de boucles et balises pour réaliser l'affichage de l'article selon le mode de composition qui vous convient. Le fichier XML pourra contenir la description de cette composition :
 Article Portfolio Composition adaptée aux galeries d'images images/article-portfolio.png

Lorsqu'aucune composition n'est définie pour un type d'objet donné, aucune interface n'apparait dans l'espace privé.
Mais lorsque vous avez défini au moins une composition, une interface apparaît et permet aux administrateurs de choisir sur chaque objet la composition qui lui convient parmi celles qui sont définies.
Utilisation avec les squelettes de type Z comme Zpip
Utilisé avec un squelette Z comme le squelette Zpip, et à partir de la version 1.0 du plugin, le fonctionnement par défaut des compositions s'applique au cœur de page (le contenu). Le dossier par défaut pour mettre les compositions est alors contenu/.
Une composition contenu/article-portfolio.html sera alors utilisée à la place de contenu/article.html, le reste de la page étant alors inchangé. Pour plus d'information sur la construction des pages dans le squelette Zpip, voir sa documentation.
ll n'y a donc aucun réglage à faire pour utiliser le plugin Compositions avec Zpip : il suffit de déclarer des compositions dans un dossier contenu/ (dans le dossier squelettes/ par exemple) pour pouvoir les utiliser pour faire varier la présentation du contenu des objets de SPIP.
Utilisation personnalisée dans les squelettes
En dehors des squelettes Z, le fonctionnement du plugin par défaut est de sélectionner automatiquement un squelette, dans son intégralité. Ce mode de fonctionnement oblige donc à définir le squelette en entier pour chaque composition.
Pour une utilisation différente du plugin dans le cadre d'un squelette personnel, et pour utiliser les compositions pour faire varier une partie de la page uniquement, le mécanisme automatique peut être désactivé.
Dans ce cas, la balise #COMPOSITION peut être utilisée dans les squelettes pour inclure la bonne variante de composition dans la partie de la page que le webmestre souhaite faire varier.
Le plugin laisse donc la liberté au webmestre d'utiliser le mécanisme de compositions en fonction de son besoin propre.
#COMPOSITION
Si par exemple, vous souhaitez que le coeur des pages articles change en fonction de la composition choisie (mais les colonnes latérales, l'en-tête et le pied de page seront inchangés), vous remplacerez la partie concernée de article.html par

Cette inclusion doit se trouver dans une boucle article dans ce cas.
#ID_ARTICLE_ACCUEIL
Pour les rubriques, il est possible également d'utilise un article d'accueil.

Si l'option est activée, l'article d'accueil sélectionné depuis l'interface peut simplement être retrouvé avec la balise #ID_ARTICLE_ACCUEIL.
Par exemple



Interface
Lorsque des compositions ont été mises en place par le webmestre, un formulaire de sélection apparait automatiquement dans l'espace privé sur chaque objet de ce type.
Si vous êtes webmestre, vous pouvez verrouiller les compositions que vous ne souhaitez pas laisser modifiables. Seuls les webmestres pourront alors les modifier.

 


Sur les articles le bloc compositions indique que l'article est sélectionné en accueil

 


ou permet de le sélectionner pour l'accueil de la rubrique.

ecrire/?exec=compositions
La page exec=compositions permet de lister toutes les compositions disponibles pour chaque type d'objet SPIP, ainsi que tous les objets utilisant chaque composition.
Des icones pour vos compositions
Le plugin intègre dans le sous dossier images/ plusieurs icones simples que vous pouvez utiliser et décliner pour identifier vos compositions. N'hésitez pas à proposer vos variantes pour enrichir le plugin !

 

 
 

 
 

 
 

 
 

 
 


		Ce plugin nécessite SPIP Bonux


Compositions 2 et supérieur
Cerdic, Joseph, ludogre — 2011-03-25T13:11:57Z

		Ce plugin vous permet de définir plusieurs variantes de squelettes (nommées compositions) pour un même type d'objet SPIP. Dans l'espace privé, il est alors possible de choisir, dans un menu déroulant, la composition qu'on veut attribuer à chaque article (ou rubrique, auteur, etc.).
		
Table of contents
 Note de version
 Objectif
 Configuration
 Définir des compositions
 Définir des compositions héritées
 Verrouiller les compositions
 Interface
 Utilisation avec les squelettes de type Z comme Zpip
 Utilisation avec Zcore
 Utilisation avec le noiZetier
 Utilisation personnalisée dans les squelettes
 Des icones pour vos compositions
Note de version
Depuis la version 2 du plugin Compositions, il est possible de définir des héritages par branche.
La fonctionnalité Article d'accueil a été extraite dans un plugin dédié.
Compositions nécessite le plugin Bonux.
Objectif
Ce plugin a pour but de fournir un mécanisme et une interface pour faire varier le type de composition de chaque objet en fonction des besoins.
Par exemple, vous pouvez avoir besoin de composer certains articles sous une forme d'article de journal, et certains autres comme des albums photos.
Ou vous pouvez vouloir composer certaines rubriques comme des blogs, et d'autres de façon plus classique...
Configuration
Le plugin ne nécessite pas CFG, mais si celui-ci est installé vous pourrez modifier certaines options de fonctionnement. Dans le cas contraire, les réglages par défaut seront appliqués.
Sous SPIP 3, le formulaire de configuration est directement accessible, sans CFG, via le menu Configuration > Compositions.

 


Utiliser les compositions sur les objets
Sous SPIP 3 uniquement, vous pouvez définir les objets pouvant recevoir des compositions.
Dossier des compositions
Ce réglage vous permet de choisir le sous-dossier qui contiendra les différentes compositions. Par défaut le nom de dossier compositions/ est utilisé, contenu/ si vous utilisez Zpip, content si vous utiliser Zcore. C'est-à-dire que les compositions seront recherchées dans squelettes/compositions/, puis dans les sous dossiers compositions/ des plugins, etc.
Sélection des squelettes
Par défaut, le squelette de la composition est sélectionné automatiquement par SPIP. Mais ce mécanisme est désactivable pour des besoins précis.
Masquer le formulaire
Vous pouvez masquer le formulaire de Compositions aux utilisateurs n'ayant pas les droits de modifier la composition d'un objet donné afin d'alléger l'interface.
Tout verrouiller
Compositions possède un mécanisme permettant à la personne qui gère le site avec le statut webmaster de verrouiller une composition et/ou les compositions d'une branche. En activant cette option, toutes les compositions seront verrouillées et uniquement la ou le webmaster pourra les modifier.
Définir des compositions
Une composition est constituée par une paire de fichiers : un squelette et un fichier XML qui l'accompagne et porte le même nom. Leur nom est composé du type de l'objet (article, rubrique ou autre) suivi du nom de la composition séparée par un tiret. Par exemple : article-edito.html et article-edito.xml ou encore rubrique-chronologique.html et rubrique-chronologique.xml.
Les compositions doivent être rangées dans un sous-répertoire de votre dossier squelettes, appelé compositions/ (le nom de ce sous-répertoire est configurable).
Il est possible de définir une composition par défaut pour chaque type d'objet, en la nommant simplement article, rubrique, etc. sans la suffixer.
Pour définir une composition de type portfolio d'un article on va par exemple :
 créer un squelette compositions/article-portfolio.html,
 créer à côté un fichier compositions/article-portfolio.xml.
Le squelette sera constitué classiquement de boucles et balises pour réaliser l'affichage de l'article selon le mode de composition qui vous convient. Le fichier XML pourra contenir la description de cette composition :
 Article Portfolio Composition adaptée aux galeries d'images images/article-portfolio.png 
Lorsqu'aucune composition n'est définie pour un type d'objet donné, aucune interface n'apparait dans l'espace privé.
Mais lorsque vous avez défini au moins une composition, une interface apparaît et permet aux administrateurs de choisir sur chaque objet la composition qui lui convient parmi celles qui sont définies.


Définir des compositions héritées
Dans le fichier XML d'une composition de rubrique, vous pouvez définir une composition qui s'appliquera par défaut aux objets de la branche (articles, sous-rubriques, brèves...). Il vous suffit d'ajouter dans le XML de la composition une tag de la forme . Par exemple, vous pouvez faire une composition rubrique-agenda avec le XML suivant :
 Rubrique Agenda Composition pour les rubriques gérant un agenda images/objet-liste-contenus-dates.png   
Les articles de cette rubrique et de ses sous-rubriques hériteront alors de la composition article-agenda.html. Attention : il doit s'agir d'une composition valable et doit donc disposer d'une description dans un fichier article-agenda.xml.
La composition héritée par un objet n'est pas forcément homonyme de la composition de la rubrique. Vous pouvez donc avoir une composition rubrique-machin avec . Dans le cas présent, truc fait référence au suffixe de article-truc.html. Le tag  de article-truc.xml reste libre de recevoir le texte de votre choix.
Par ailleurs, il vous est toujours possible de modifier au cas par cas la composition d'un objet donné. Si l'objet hérite d'une composition, l'interface vous proposera donc de lui appliquer la composition héritée ou bien de lui appliquer une autre composition de votre choix.
La composition par défaut d'un objet n'ayant pas de nom (puisqu'il s'agit du squelette correspondant au nom de l'objet sans suffixe), on pourra l'indiquer dans le tag  à l'aide d'un tiret (composition="-").
Si les rubriques parentes d'un objet définissent plusieurs compositions héritées, c'est la composition définit par la rubrique la plus proche qui s'appliquera.
Prenons un exemple concret. Supposons un secteur A ayant trois sous-rubriques A1, A2 et A3. La composition appliquée au secteur A attribue aux articles de ce secteur la composition truc (). Par ailleurs, on a appliqué à la sous-rubrique A3 une composition attribuant aux articles de sa branche la composition par défaut (). Les articles des rubriques A, A1 et A2 seront alors affichés avec le squelette article-truc.html alors que ce sera article.html qui sera utilisé pour les articles de la rubrique A3 [1].
Verrouiller les compositions
Par défaut, les individus ayant le droit de modifier le contenu d'un objet ont le droit de modifier sa composition. Cependant, si vous êtes webmaster, vous pouvez verrouiller une composition. Cette dernière ne sera alors plus modifiable que par un webmaster.
Si vous êtes dans une rubrique, vous pouvez verrouiller la composition de tous les objets de cette branche (sous-rubriques, articles, brèves, sites, etc.).
Enfin, dans la configuration de Compositions, vous pouvez également verrouiller toutes les compositions.
Interface
Lorsque des compositions ont été mises en place par le webmestre, un formulaire de sélection apparait automatiquement dans l'espace privé sur chaque objet de ce type.
L'interface peut différer selon vos réglages afin de n'afficher que les options s'appliquant à votre situation.

 

Utilisation avec les squelettes de type Z comme Zpip
Utilisé avec un squelette Z comme le squelette Zpip (version 1.7.10 minimum), le fonctionnement par défaut des compositions s'applique au cœur de page (le contenu). Le dossier par défaut pour mettre les compositions est alors contenu/ pour zpip et content/ pour zcore..
Une composition contenu/article-portfolio.html sera alors utilisée à la place de contenu/article.html, le reste de la page étant alors inchangé. Pour plus d'information sur la construction des pages dans le squelette Zpip, voir sa documentation.
N.B. : pour que la composition bloc/article-portfolio.html soit prise en compte, il doit obligatoirement y avoir un squelette bloc/article.html dans le même dossier.
ll n'y a donc aucun réglage à faire pour utiliser le plugin Compositions avec Zpip : il suffit de déclarer des compositions dans un dossier contenu/ (dans le dossier squelettes/ par exemple) pour pouvoir les utiliser pour faire varier la présentation du contenu des objets de SPIP.
Utilisation avec Zcore
Si vous créez vos propres jeux de squelettes avec Zcore, n'oubliez pas de passer la composition dans votre fichier objet.html de base. Exemple avec article.html.
  
Utilisation avec le noiZetier
Si vous utilisez Compositions avec le plugin noiZetier, vous pouvez créer des compositions directement dans l'interface de SPIP. Une fois créées, il vous reste seulement à modifier les noisettes de votre composition pour disposer d'un affichage alternatif pour vos objets.
Pour plus d'informations, voir Les compositions du noiZetier.
Utilisation personnalisée dans les squelettes
En dehors des squelettes Z, le fonctionnement du plugin par défaut est de sélectionner automatiquement un squelette, dans son intégralité. Ce mode de fonctionnement oblige donc à définir le squelette en entier pour chaque composition.
Pour une utilisation différente du plugin dans le cadre d'un squelette personnel, et pour utiliser les compositions pour faire varier une partie de la page uniquement, le mécanisme automatique peut être désactivé.
Dans ce cas, la balise #COMPOSITION peut être utilisée dans les squelettes pour inclure la bonne variante de composition dans la partie de la page que le webmestre souhaite faire varier.
La balise #COMPOSITION tient compte des héritages éventuels s'appliquant à un objet. Il est donc impératif de s'appuyer sur cette dernière et non sur la valeur du champ composition des tables SQL pour connaître la composition s'appliquant à un objet. Elle doit être appelée au sein d'une boucle.
Le plugin laisse donc la liberté au webmestre d'utiliser le mécanisme de compositions en fonction de son besoin propre.
Si par exemple, vous souhaitez que le cœur des pages articles change en fonction de la composition choisie (mais les colonnes latérales, l'en-tête et le pied de page seront inchangés), vous remplacerez la partie concernée de article.html par .
Cette inclusion doit se trouver dans une boucle article dans ce cas.
Des icones pour vos compositions
Le plugin intègre dans le sous dossier images/ plusieurs icones simples que vous pouvez utiliser et décliner pour identifier vos compositions. N'hésitez pas à proposer vos variantes pour enrichir le plugin !

Image Code à utiliser



 


images/objet-simple.png


 


images/objet-liste-contenus.png


 


images/objet-liste-contenus-dates.png


 


images/composition-cours.png


 


images/composition-tableau.png


 


images/composition-test.png


		
		
[1] Sauf bien sûr si une composition a été attribuée spécifiquement et au cas par cas pour certains de ces articles.



Conversion des brèves en articles
didrome, JLuc — 2011-05-19T14:06:00Z

		Avec l'évolution de SPIP, les brèves deviennent un objet historique, dont le maintien s'avère parfois inadapté. Il peut donc se révéler utile de convertir les brèves en articles, c'est ce que fait ce plugin.
		
Table of contents
 La conversion des brèves en articles
 Mise à jour des liens internes du site
 Suivi des liens externes au site
 Installation / Désinstallation
 Paramétrage et utilisation du plugin
La conversion des brèves en articles
Ce plugin sert à convertir les brèves de votre site spip en articles. Les nouveaux articles créés sont insérées dans une rubrique, et un auteur pré-existant leur est optionnellement affecté.
La conversion des brèves en articles traite les points suivants :
 le contenu de la brève devient le contenu de l'article
 tous les forums associés à la brève deviennent forums de l'article
 le logo de la brève devient logo de l'article
 les mots clés associés à la brève sont associés à l'article
 la date de création de la brève est conservée comme date de création de l'article créé ainsi que date de publication et date de modification
 le titre du secteur de la brève convertie est copié dans le surtitre de l'article (ce qui permet éventuellement de gérer à nouveau une pseudo arborescence de secteurs).
 le statut de publication de la brève devient statut de l'article
Les brèves converties ne sont pas détruites, afin de conserver une trace de ces brèves, mais rien ne vous empêche ensuite de vider définitivement la table spip-breve.

Selon la configuration choisie, leur statut soit n'est pas modifié, soit est transformé en 'proposé' ou 'refusé'.
Mise à jour des liens internes du site
Après avoir fait la migration des brèves en articles, il est intéressant voir nécessaire de modifier les liens de votre site qui pointaient vers les brèves, désormais obsolètes.
Le plugin permet de parcourir les différents objets du site, et de transformer un lien vers une brève, en lien vers l'article correspondant de cette brève.
Les objets parcourus par cette mise à jour sont :
 articles
 rubriques
 auteurs
 forum
 syndic
Tout le contenu éditorial de ces objets est testé (titre, sous et sur, chapo, texte, descriptif ...). Les brèves elles-mêmes ne sont pas modifiées.
La recherche du lien se fait avec l'expression régulière suivante :

/\[([^]]*)-\>br[ev]{0,3}([0-9 ]+)\]/
Donc si une brève a été convertie en article, tout lien ->brXXX ou ->breXXX ou ->brevXXX ou ->breveXXX sera transformé en lien ->articleXXX
Pour cela, le plugin mémorise dans la table spip_breves_articles les correspondances entre un id_breve et l'id_article associé. Le nom de cette table peut être est redéfini dans le fichier options.php du plugin.
Suivi des liens externes au site
Le plugin fournit également un squelette exemple breve_redirection.html qui redirige les liens externes qui pointent encore vers les pages de breves de votre site vers leur remplaçant sous forme d'articles. Pour ce faire, ce squelette utilise la table spip_breves_articles remplie lors de la conversion.
Pour l'activer, il est nécessaire de le recopier avec le nom breve.html dans votre dossier squelette, une fois toutes les brèves converties.
Une fois ceci fait, ce nouveau squelette breve assure la redirection 301 des appels vers les anciennes breves vers les articles , c'est à dire sans perte de référencement.
Installation / Désinstallation
Ce plugin s'installe simplement .
La désinstallation supprime la table de correspondance entre les brèves et les articles créés.


Attention : pour l'instant, ce plugin a besoin du plugin bandeau pour fonctionner
Paramétrage et utilisation du plugin
La page pour accéder aux fonctions du plugin se trouve dans la partie privée, dans le menu Maintenances, puis “Breves vers Article”.

 


Il y a 2 modes de conversion :
 pour tester, on indique le n° d'une seule brève
 conversion de toutes les brèves du site
Les options accessibles sont :
 la rubrique dans laquelle les articles crées seront insérés : obligatoire
 l'auteur associé aux articles créés : facultatif
 activer la modification des liens internes du site vers les articles issus de la conversion des brèves. Cette opération peut se faire en même temps que la conversion des brèves, ou bien plus tard. Les 2 opérations sont indépendantes, mais la conversion doit bien entendu se faire avant la modification des liens.
		L'icone est de Oliver Scholtz, distribuée sous plusieurs licences GPL, CC sa nc, LGPL and many more (copiable and for non commercial use).


CookieBar
erational — 2014-09-15T07:00:00Z

		Affiche une barre d'avertissement sur l'usage des cookies.
		
Table of contents
 Avertissement
 Introduction
 Installation
 Paramétrages
 Désactiver les cookies sur Google Analytics et les autres trackers
 Personnalisations
 Alternatives
Avertissement 
 Comme le plugin jQuery original n'est plus maintenu Le plugin SPIP cookiebar n'est plus maintenu.
Pour le remplacer, vous pouvez utiliser Tarteaucitron
Introduction
Par défaut, SPIP est respectueux de la vie privée de ses visiteurs et ne pose pas de cookies de traçages ou publicitaires.
Ce plugin est donc utile uniquement si votre site utilise des scripts de statistiques intrusifs (comme google analytics, xiti, ...) ou des widgets sociaux (bouton google+, facebook, twitter, ...).
Le plugin permet d'afficher une barre d'avertissement sur votre site sur l'utilisation des cookies pour suivre les recommandations légales de la commission européenne et de la CNIL. Pour en savoir plus: http://www.cnil.fr/vos-obligations/...

  


Ce plugin est le portage du plugin jQuery CookieBar.
Documentation complète du plugin: http://www.primebox.co.uk/projects/...
Installation
Le plugin est répertorié dans le dépôt proposé par défaut : « SPIP-Zone - Plugins ». Aussi, il est installable depuis la page Gestion des plugins, onglet Ajouter des plugins si vous avez activé ce dépôt. Pour le retrouver dans la liste des plugins, il vous suffit de rechercher “cookiebar”.
En cas de besoin, référez-vous à l'article dédié à ce sujet sur spip.net.
Paramétrages
Une fois le plugin installé, vous pouvez le configurer les boutons et les textes que vous voulez afficher dans la barre :
 Bouton accepter les cookies
 Bouton refuser les cookies
 Bouton vers votre article décrivant votre politique en matière de confidentialité.
Vous pouvez aussi choisir la position de la barre (en haut, en haut fixé ou en bas).
Désactiver les cookies sur Google Analytics et les autres trackers
Si l'utilisateur a choisi de désactiver les cookies (si vous avez activé l'option), vous devez vérifier que les scripts tel que Google Analytics soient plus désactivé.
Cela peut être fait simplement en encadrant votre code javascript par la condition suivante
if(jQuery.cookieBar('cookies')){ // votre code Google Analytics ou un autre code de suivi }
En PHP, on pourra lire cette préférence dans le cookie nommé “cb-enabled” avec les valeurs possibles: “declined” ou “accepted”.
Personnalisations
Si vous voulez modifier l'aspect de la barre, vous pouvez de surcharger les styles CSS existants.
Alternatives
Si vous souhaitez d'autres barres, voici d'autres projets:
 tarte au citron
 CookieChoices
 cibc : bannière d'avertissement pour les cookies
 http://www.heise.de/extras/socialsh...


CookieChoices
erational — 2014-09-26T06:58:27Z

		Affiche un avertissement à l'usage des cookies en utilisant le script cookiechoices fourni par google
		
Table of contents
 Introduction
 Installation
 Paramétrages
 Personnaliser les styles de la barre
 Désactiver les cookies sur Google Analytics et les autres trackers
 Alternatives
Introduction
Par défaut, SPIP est respectueux de la vie privée de ses visiteurs et ne pose pas de cookies de traçages ou publicitaires.
Ce plugin est donc utile uniquement si votre site utilise des scripts de statistiques intrusifs (comme google analytics, xiti, ...) ou des widgets sociaux (bouton google+, facebook, twitter, ...).
Le plugin permet d'afficher une barre d'avertissement sur votre site sur l'utilisation des cookies pour suivre les recommandations légales de la commission européenne et de la CNIL. Pour en savoir plus: http://www.cnil.fr/vos-obligations/...

  


Ce plugin est le portage du script cookiechoices proposé par Google et conforme aux exigences européennes.
Installation
Le plugin est répertorié dans le dépôt proposé par défaut : « SPIP-Zone - Plugins ». Aussi, il est installable depuis la page Gestion des plugins, onglet Ajouter des plugins si vous avez activé ce dépôt. Pour le retrouver dans la liste des plugins, il vous suffit de rechercher “cookiechoices”.
En cas de besoin, référez-vous à l'article dédié à ce sujet sur spip.net.
Paramétrages
Une fois le plugin installé, vous pouvez le configurer les boutons et les textes que vous voulez afficher dans la barre :
Vous pouvez aussi choisir la position de la barre (en haut ou en “popin”).
Personnaliser les styles de la barre
La barre de cookies peut être personnalisée graphiquement avec ajoutant des instructions dans votre feuille de style CSS.

Son identifiant est  #cookieChoiceInfo
Désactiver les cookies sur Google Analytics et les autres trackers
Le plugin ne fait qu'afficher les avertissements sur l'usage des cookies. Ensuite c'est à vous de modifier les appels de vos trackers en fonction des préférences de l'usager.
Par exemple voici le code javascript à ajouter pour désactiver Google analytics tant que l'usage n'a pas accepté les cookies.
// Remplacez la valeur UA-XXXXXX-Y par l'identifiant analytics de votre site. gaProperty = 'UA-XXXXXX-Y' // Désactive le tracking si le cookie d'acception des conditions n'est pas présent var disableStr = 'ga-disable-' + gaProperty; if (document.cookie.indexOf('displayCookieConsent=y') < 0) { window[disableStr] = true; } 
En PHP, on pourra lire cette préférence dans le cookie nommé “displayCookieConsent” avec la valeur: “y” (accepté).
Alternatives
Si vous souhaitez d'autres barres, voici d'autres projets:
 le plugin tarte au citron
 le plugin CookieBar
 le plugin cibc : bannière d'avertissement pour les cookies
 http://www.heise.de/extras/socialsh...


Copier Coller Image
mossad — 2023-05-29T10:37:00Z

		Voulez-vous copier une image et l'insérer facilement dans SPIP?
		
Table of contents
 Utilité et fonctionnalités du plugin
 Source de l'image
 Champ d'édition d'article, de rubrique, de brève ou de forum
 Configuration
Utilité et fonctionnalités du plugin
Ce plugin permet de copier des images dans un champ d'édition textuel d'un objet éditorial.
 Source de l'image
Il peut s'agir d'un copié d'un fichier image sur l'ordinateur. Les logicielles de capture d'écran permettent également de faire un Ctr+C. En somme, c'est l'image conservée dans le presse-papier que l'on pourra coller dans les champs d'éditions.
Champ d'édition d'article, de rubrique, de brève ou de forum
En insérant le curseur dans le champ et en faisant un Ctr+V, l'image est associée à l'objet éditorial et enregistré dans SPIP. Ensuite, le curseur écrit  dans cette exemple :

  

Configuration
La configuration permet de changer ce que le curseur écrit. C'est à dire le modèle en doc ou img, ainsi que l'alignement left, center ou right.

  




Corbeille
Cerdic — 2008-11-01T23:51:59Z

		Un plugin pour retrouver les éléments supprimés dans la corbeille.
		
Table of contents
 A quoi ça sert
 Pour télécharger et installer
 Pour s'en servir
 Pour que la corbeille gére vos objets éditoriaux
 1/ créer un squelette prive/listes/corbeille_patates.html
 2/ déclarer le pipeline dans paquet.xml
 3/ définir l'objet à supprimer dans le pipeline
 4/ définir les chaines de langue
A quoi ça sert
Ce plugin permet de déroger au comportement standard de SPIP qui efface automatiquement certains objets de la base de donnée (articles, breves... à la poubelle), avec un délai d'un jour ou deux.
Avec ce plugin, plus aucun objet n'est supprimé automatiquement. La poubelle garde tous les articles ou autres objets que vous y avez mis, et vous pouvez toujours revenir en arrière.
Pour télécharger et installer
Téléchargez l'archive à la fin de l'article, et installez la dans le dossier plugins/ de votre site SPIP, comme pour tous les autres plugins
Pour s'en servir
Un sous-menu “Corbeille” est ajouté dans le menu Configuration [1] de votre Site.

 


Il vous permet de voir le contenu de la corbeille, type par type, et de supprimer éventuellement les objets dont vous n'avez vraiment plus besoin.

 


Sur chaque élément à la corbeille, un lien “voir” vous permet d'aller éditer l'élément pour le ressortir éventuellement de la corbeille.
Vous pouvez aussi sélectionner les éléments à supprimer définitivement en cochant la case devant, et cliquer sur le bouton 'Effacer la selection'.
Vous pouvez également effacer tous les éléments d'un type dans la corbeille.
Dans les deux cas le plugin va forcer l'effaçage immédiat de ces objets SPIP de la base de donnée. Les relations entre les objets SPIP seront aussi effacés (tel que les associations auteurs-articles)
Contrairement aux versions antérieures de SPIP, aucune opération complémentaire manuelle n'est nécessaire.
Pour que la corbeille gére vos objets éditoriaux
Il fau bien sûr remplacer “patate” par le nom de votre objet, et “prefixe” par le préfixe de votre plugin dans le code qui suit.
 1/ créer un squelette prive/listes/corbeille_patates.html
  [(#GRAND_TOTAL|singulier_ou_pluriel{patate:corbeille_patates_un,patate:corbeille_patates_tous})
] [(#PAGINATION)
]    <:corbeille:selectionner:>  [##ID_PATATE - (#TITRE|sinon{<:info_sans_titre:>})]
 [(#DATE|affdate)][ (#DATE|heures)]:[(#DATE|minutes)] <:corbeille:voir_detail:>
 
  
 [(#PAGINATION{prive})
] 
 
2/ déclarer le pipeline dans paquet.xml
 3/ définir l'objet à supprimer dans le pipeline
 /** * Pipeline de la corbeille, permet de définir les objets à supprimer * * @param array $param Tableau d'objets * * @return array Tableau d'objets complété */ function prefixe_corbeille_table_infos($param){ $param['patates'] = array( 'statut' => 'poubelle', 'table'=> 'spip_patates', 'tableliee'=> array('spip_patates_liens', '...'), ); return $param; }
NB : définir dans 'tableliee' les éventuelles tables qui contiennent des liens avec l'objet (spip_auteurs_liens, ...)
4/ définir les chaines de langue
Dans lang/patate_fr.php :
 'corbeille_patates_un' => 'Une patate dans la corbeille', 'corbeille_patates_tous' => '@nb@ patates dans la corbeille',
		
		
[1] Dans le menu Maintenance en SPIP 3.



Correction des liens internes
Maïeul, nicod_ — 2013-10-27T17:00:00Z

		SPIP possède des raccourcis spécifiques pour faire des liens internes au site. Par exemple pour pointer vers l'article 25, on utilise le raccourci [texte->25].
Il peut arriver que les rédacteurs et rédactices du site utilisent directement l'URL de la page publique lorsqu'ils créent des liens dans leurs articles.
Le plugin “correction des liens internes” permet de corriger automatiquement ces liens au moment de la rédaction du contenu.
		
Table of contents
 Pourquoi utiliser les raccourcis de SPIP pour formater les liens internes ?
 Comment fonctionne le plugin
 Prise en compte d'autres domaines
 Plugin Multi-domaines
Pourquoi utiliser les raccourcis de SPIP pour formater les liens internes ?
L'usage des raccourcis SPIP pour formater les liens internes permet :

- de styler différemment les liens internes des liens externes.

- de ne pas dépendre de l'URL du site.

- de ne pas dépendre de l'URL des objets.

- de permettre d'exporter facilement vers d'autres support que du Web [1].
Comment fonctionne le plugin
Le plugin s'installe comme n'importe quel plugin.
Lors de la validation d'un formulaire de rédaction d'un objet (article, rubrique etc.), le plugin vérifie les liens internes. Tout lien commençant par l'URL du site (par exemple http://www.example.com) sera analysé pour vérifier qu'il ne s'agit pas d'un objet SPIP. L'analyse se base sur la configuration du type d'URL. Autrement dit si un rédacteur copie-colle l'URL de la page publique d'un article, le plugin va le repérer.
Il va alors transformer automatiquement le lien, en mettant le raccourci SPIP correspondant :

- [texte->xxx] s'il s'agit de l'article xxx.

- [texte->autxxx] s'il s'agit de l'auteur xxx.

- [texte->rubxxx] s'il s'agit de la rubrique xxx.

- [texte->objetxxx] s'il s'agit de l'objet xxx.
Le plugin a été testé avec tous les types d'URL de SPIP, y compris les URLS arborescentes. N'hésitez pas cependant à faire part de tous cas problématiques.
Prise en compte d'autres domaines
Par défaut, le plugin reconnait toutes les urls sur le domaine où est installé le site [2].
Si votre site est accessible avec et sans www, en http et en https, si vous avez des alias (noms de domaines équivalents) [3], ces variantes d'urls ne seront pas reconnues.
Dans ce cas, vous pouvez définir avec une constante une liste de domaines supplémentaires considérés comme locaux.

Par exemple, dans config/mes_options.php :
define('CORRECTION_LIENS_INTERNES_AUTRES_DOMAINES', 'http://domaine.tld, https://www.domaine.tld, http://www.domaine2.tld/'); 
 Plugin Multi-domaines
Si le plugin multi-domaines est activé, le plugin le reconnait automatiquement et tous les domaines déclarés dans la configuration multi-domaines sont considérés comme des domaines locaux, les liens absolus comprenant ces domaines sont transformés en raccourcis SPIP.
		
		
[1] Par exemple du LaTeX pour produire un livre.

[2] détection basée sur la fonction url_de_base()

[3] en général, ce n'est pas une bonne idée, les variantes devraient être redirigées sur le domaine principal

		Le logo est de Dmitry Mirolyubov sous Licence Creative Commons, Paternité


Correction typographique des guillemets
Vincent Ramos — 2007-01-28T18:14:08Z

		Ce plugin remplace les paires de guillemets droits (ou « chiures de mouches »), c'est-à-dire ‹"›, par les guillemets typographiques («», “”, etc.), lesquels dépendent de la langue dans laquelle on rédige.
		Ce plugin remplace les paires de guillemets droits (ou « chiures de mouches »), c'est-à-dire ‹"›, par les guillemets typographiques («», “”, etc.), lesquels dépendent de la langue dans laquelle on rédige.
Cette fonctionnalité est également reprise dans le plugin Ortho-typographie plus complet que l'on préfèrera utiliser.
		
Table of contents
 Présentation
 Fonctionnement
 Limitations
Présentation
Tous les claviers ne permettent pas de taper directement les guillemets : en effet, la touche <"> [1] n'insère pas un guillemet mais un symbole utilisé en informatique ; ce symbole, dans les textes en langues naturelles [2], doit être remplacé par les guillemets typographiques voulus par la langue dans laquelle on rédige. Ainsi, en français de France, les guillemets sont représentés par <«> pour l'ouvrant et <»> pour le fermant et en anglais par <“> et <”>.
En aucun cas <"> ne devrait, dans une bonne typographie, être employé : son principal défaut (outre sa forme droite) est en effet qu'il ne permet pas de distinguer le début et la fin d'une citation. Or, l'œil, déjà peu habitué à la lecture verticale qu'imposent les écrans, se repère mal lorsque les citations dépassent les quelques mots. Le confort de lecture est ainsi gêné.
L'absence des guillemets sur certains claviers informatiques [3] a cependant conduit de nombreux rédacteurs à ignorer ces règles autant typographiques que visuelles. De plus, rares sont les rédacteurs actuels à posséder des connaissances typographiques.
SPIP, pour pallier cette absence, propose un bouton permettant de mettre des mots sélectionnés entre guillemets. Ce bouton n'est cependant pas accessible pour tous les champs de saisie (ainsi, il n'y a pas de barre d'insertion de caractères spéciaux pour les rubriques) et de nombreux rédacteurs, par méconnaissance de la typographie ou par « paresse », ne s'en servent pas. D'autre part, s'il existe des raccourcis claviers pour entrer les guillemets à la main (dépendant du système d'exploitation utilisé), il est parfois fastidieux de les utiliser [4].
Ce plugin permet donc de remplacer automatiquement les guillemets droits par les guillemets corrects, et ce de manière transparente pour le rédacteur, de la même manière que les apostrophes droites <'> sont remplacées par les apostrophes courbes <'> ou que les espaces insécables sont introduites automatiquement devant les ponctuations hautes (). Il va de soi que le texte entre les balises  et  n'est pas touché.

Fonctionnement
Le fichier le plus important est typo_guillemets_fonctions.php. Il contient une fonction qui :
 Vérifie la langue dans laquelle effectuer le remplacement ;
 Échappe dans un premier temps les guillemets à ne pas toucher (ceux à l'intérieur de balises HTML) ;
 Remplace les paires de guillemets restantes par la version voulue selon les règles typographiques de la langue de composition (et supprime éventuellement l'espace après le guillemet ouvrant et celle avant le fermant : " mot ") ;
 Restitue les guillemets échappés.
Le plugin n'agit qu'à partir du pipeline post_typo : le texte original n'est donc pas touché. Seul l'affichage l'est.
Voici quelques exemples, selon la langue concernée :
 “français” → « français » ;
 “hongrois” → „hongrois” ;
 “anglais” → “anglais” ;
 “danois” → »danois« ;
 “bulgare” → „bulgare“.
De plus, depuis la version 1.2 ce plugin guillemette correctement la balise HTML , en CSS, sur les navigateurs modernes, selon la langue de composition et en tenant compte des imbrications (cf.: fichier typo_guillemets.css).
Limitations
Pour l'instant, ce plugin ne gère pas le remplacement les guillemets de second rang, c'est-à-dire ceux qu'on emploie dans un texte déjà guillemeté. Ainsi, en typographie française :


« Il dit : “Bonjour” »
« Il dit : “Bonjour” d'une voix chevrotante »

ou, d'après la marche typographique de l'Imprimerie nationale :


« Il dit : « Bonjour » [5]
« Il dit « Bonjour » d'une voix chevrotante ».

Dans tous les cas, des guillemets droits enchâssés seront mal rendus. Par exemple, "Il dit : "Bonjour" d'une voix chevrotante." sera rendu par :


« Il dit : »Bonjour« d'une voix chevrotante. »

Par contre, depuis la version 1.2, l'emploi de la balise HTML  dédiée aux citations en ligne sera correctement guillemetée par ce plugin, en respect de la langue de composition. Par exemple, Il dit : Bonjour d'une voix chevrotante et Ursula lui répond enjouée : Guten Tag! sera rendu par :


« Il dit : “Bonjour” d'une voix chevrotante » et Ursula lui répond enjouée : >Guten Tag!< »

De plus, depuis la version 1.1, Les liens automatiques [->1] vers des articles dont le titre contient des «guillemets français» passent en guillemets “de second niveau”.

		
		
[1] Ou « chiures de mouche » en jargon typographique. Cf. cette page.

[2] Français, anglais, catalan, basque, etc.

[3] Héritée du temps des machines à écrire, où, par économie de place, une seule touche avait été consacrée aux deux formes du guillemet.

[4] Quand ce n'est tout bonnement pas impossible de le faire : sous MS Windows et Firefox, entrer les caractères étendus au moyen d'ALT suivi du code voulu conduit le navigateur, en raison de l'existence de touches d'accès rapides propres à SPIP, à quitter la page en cours.

[5] Le guillemet fermant de premier rang est absorbé par le fermant de second rang, les deux ayant la même forme : « Il dit : « Bonjour » » n'est donc pas admis.



Couleur d'Objet
chankalan — 2014-11-18T09:36:00Z

		Le plugin Couleur d'Objet permet d'associer une couleur à n'importe quel objet éditorial de SPIP.
		
Table of contents
 Utilisation
 Usage des filtres de couleurs
 Autres paramètres
 Bloquer le changement de couleur
 Palette
Utilisation
Une fois activé comme les autres plugins, la page de configuration propose de choisir sur quel objet vous désirez activer le choix de couleur.
Lorsque ce choix est fait, la page d'un objet sélectionné offre un formulaire pour choisir une couleur (un code hexadécimal) ou la supprimer.

La valeur enregistrée peut être utilisée ensuite dans les squelettes ou une feuille de style dynamique avec la balise #COULEUR au sein d'une boucle.
Exemple dans un squelettes :
  #TITRE  


Exemple dans une feuille de style dynamique :

1 - Premièrement déclarer dans la balise head de la page mot :

2 - Deuxièmement modifier le squelette de la page mot :
  [(#LOGO_MOT|image_reduire)]#TITRE
 


3 - Troisièmement créer le fichier squelettes/couleurs.css.html contenant :
[(#REM)

`id_commande`	Identifiant unique de la commande
`reference`	Numéro de référence (il ne s'agit pas d'une clé unique).
`id_auteur`	Identifiant de l'auteur/client
`statut`	`encours`, `attente`, `partiel`, `paye`, `envoye`, `retour_partiel`, `retour`, `erreur`
`date`	Date de création
`date_paiement`	Date de paiement
`date_envoi`	Date d'envoi
`maj`	Date de la dernière mise à jour

icône par défaut	nom du modèle	effet
	bouton_rdv	permet de télécharger le fichier .ics correspondant au rendez-vous défini.
	bouton_rdv_google	permet d'ouvrir un formulaire Google pour saisir un rendez-vous qui sera ajouter l'agenda de son choix (API Google)
	bouton_vcard	permet de télécharger le fichier .vcf correspondant à la vCard définie
	bouton_vcard_auteur	permet de télécharger le fichier .vcf correspondant à la vCard de l'auteur spip choisi
	bouton_rdv_evenement	permet de télécharger le fichier .ics correspondant au rendez-vous de l'évènement du plugin Agenda choisi

sous_dossier	Reçoit le préfixe du plugin utilisateur de N-Core	`"noizetier"`
objet	Identifie l'objet de N-Core concerné par le cache	`"type_noisette"`
fonction	Identifie le type de cache pour l'objet concerné, en l'occurrence dans notre cas, les indicateurs Ajax des types de noisette.	`"ajax"`

API : inc/ezcache_cache.php
Fonctions liées aux caches
cache_ecrire	Ecrit un contenu donné dans un cache spécifié par son identifiant relatif ou par son chemin complet.
cache_est_valide	Teste l'existence d'un cache sur le disque spécifié par son identifiant relatif ou par son chemin complet et, si il existe, teste si la date d'expiration du fichier n'est pas dépassée. Si le fichier existe et n'est pas périmé, la fonction renvoie le chemin complet, sinon elle renvoie une chaine vide.
cache_lire	Lit le cache spécifié par son identifiant relatif ou son chemin complet et renvoie le contenu sous forme de tableau ou de chaine suivant l'attribut de sérialisation ou de décodage. En cas d'erreur, la fonction renvoie false.
cache_nommer	Renvoie le chemin complet du cache sans tester son existence. Cette fonction est une encapsulation du service cache_cache_composer(). Son utilisation par un plugin appelant doit rester limitée.
cache_repertorier	Retourne la description des caches d'un plugin utilisateur filtrée sur un ensemble de critères. La description de base fournie par Cache Factory contient les éléments de l'identifiant relatif mais peut-être remplacée ou complétée par le plugin appelant au travers de services propres. Les filtres concernent uniquement les éléments de l'identifiant relatif.
cache_supprimer	Supprime le cache spécifié par son identifiant relatif ou par son chemin complet.
cache_vider	Supprime, pour un plugin utilisateur donné, les caches désignés par leur chemin complet.
Fonctions liées à la configuration
configuration_cache_lire	Lit la configuration générale des caches d'un plugin utilisateur ou de tous les plugins utilisateur ayant enregistrés une configuration.
configuration_cache_effacer	Efface la configuration générale des caches d'un plugin utilisateur ou de tous les plugins utilisateur ayant enregistrés une configuration.

Services personnalisables
Services de configuration
cache_configurer^(*)	Renvoie la configuration générale des caches d'un plugin utilisateur sous la forme d'un tableau associatif dont les index sont standardisés.
Services de gestion des identifiants de cache
cache_verifier	Vérifie le contenu de l'identifiant relatif du cache. Par défaut, Cache Factory complète l'identifiant avec le préfixe et le sous-dossier si nécessaire et vérifie que les composants obligatoires du nom sont bien présents.
cache_composer	Construit le chemin complet du fichier cache à partir du tableau de l'identifiant relatif du cache.
cache_decomposer	Décompose le chemin complet du fichier cache en éléments constitutifs. Par défaut, le tableau obtenu coïncide avec l'identifiant relatif du cache. La fonction utilise la configuration générale pour connaitre la structure du chemin du fichier.
cache_completer	Complète la description canonique d'un cache issue du service `cache_decomposer()`. Le plugin Cache Factory complète la description canonique avec le nom sans extension et l'extension du fichier.
Services de gestion du contenu d'un cache
cache_decoder	Effectue le décodage du contenu brut du cache (chaine) en fonction de l'extension du fichier cache. La fonction propose des traitements standard pour le JSON, YAML, et XML. Tout plugin utilisateur peut proposer sa fonction spécifique pour le format $format en codant le service `cache_decoder_${format}`. Il n'existe pas de service d'encodage inverse. C'est au plugin utilisateur d'encoder son contenu avant l'écriture du cache.
cache_valider	Détermine si le cache est encore valide ou pas. Par défaut, Cache Factory vérifie l'existence du fichier cache et sa péremption pour déterminer la validité. Ces tests peuvent être compléter par le plugin utilisateur.
Services de gestion du formulaire de vidage
cache_formulaire_charger	Effectue le chargement du formulaire de vidage des caches pour un plugin utilisateur donné. Par défaut, le plugin Cache Factory propose une version simplifiée du formulaire où tous les fichiers caches sont listés par ordre alphabétique sans possibilité de regroupement.

plugin	Le préfixe du plugin utilisateur de Cache Factory. Permet à un plugin utilisateur P1 d'éviter de lancer ses traitements initiés par un plugin P2.
fonction	Identifie la fonction générique faisant appel au pipeline. Prend les valeurs ‘ecrire' ou ‘supprimer'.
fichier_cache	Chemin complet du fichier cache.
cache	Tableau canonique identifiant du cache.
configuration	Tableau de configuration des caches du plugin utilisateur.

Paramètres de configuration
Paramètres fournis par le plugin utilisateur
racine	Emplacement de base dans lequel sera créé le répertoire de stockage des caches du plugin utilisateur.. Les valeurs possibles sont les chaines `"_DIR_CACHE"`, `"_DIR_VAR"`, `"_DIR_TMP"` et `"_DIR_ETC"`.	`"_DIR_CACHE"`
sous_dossier	Indique si le cache est inclus dans un sous-dossier du répertoire de stockage du plugin. A partir de la version 1.2.0, si `true`, par défaut, Cache Factory utilise le type de cache comme nom de sous-dossier ce qui permet de ne pas le fournir dans l'identifiant du cache. Néanmoins, il est toujours possible d'écraser la valeur par défaut en le fournissant dans l'identifiant relatif du cache.	`false`
nom_obligatoire	Tableau des composants obligatoires et ordonnés du nom d'un cache. Le nom des composants sert d'index quand il s'agit de fournir le tableau identifiant un cache.	`array("nom")`
nom_facultatif	Tableau des composants facultatifs et ordonnés du nom d'un cache. Les composants facultatifs suivent toujours les composants obligatoires.	`array()`
separateur	Caractère de séparation de chaque composant obligatoire ou facultatif du nom. Prend les valeurs `"_"`, `"-"` ou `""` si le nom est constitué d'un seul composant. Ce caractère ne doit pas être utilisé dans les composants du nom.	`""`
extension	Extension du fichier cache. Si le fichier cache est sécurisé l'extension est toujours forcée à `".php"`.	`".txt"`
securisation	Indique si le fichier doit être sécurisé ou pas.	`false`
serialisation	Indique si le contenu à stocker est un tableau à sérialiser ou pas.	`true`
encodage	Indique si le contenu lu est à décoder ou pas avant fourniture à l'appelant. Le type de décodage est déterminé par l'extension du fichier cache. Cette option est incompatible avec la sérialisation.	`false`
conservation	Durée de conservation du cache exprimée en secondes. La valeur 0 est utilisée pour indiquer que le cache est permanent.	`0`
Paramètres calculées par Cache Factory
dossier_plugin	Répertoire de stockage du plugin calculé à partir de la racine et du préfixe du plugin. Si la racine prend la valeur `"_DIR_VAR"` alors le répertoire du plugin est un sous-dossier de nom `"cache-${plugin}/"`. Sinon, le sous-dossier porte le nom du préfixe du plugin.	`"${plugin}/"`
nom	Tableau regroupant dans l'ordre les noms obligatoires puis les noms facultatifs.	`array("nom")`

Paramètres	Exemple	Explications
type	pie	Type de graphique, choisir entre pie doughnut radar polararea bar line
id	camembert23	identifiant du graphique, il doit être unique et ne pas comporter de caractères spéciaux
data	30,50,100	Données pour les graphes du type pie, doughnut et polarArea
datasets	30,50,100 next 20,90,75	Données pour les graphes du type bar, line et radar Pour séparer un ensemble de données, on utilise le mot séparateur next

Paramètres	Exemple	Explications
labels	Jan,Fev,Mars	Légende
canvaswidth	500	Largeur du graphe. Exprimé en px
canvasheight	500	Hauteur du graphe. Exprimé en px
width	45%	Largeur du conteneur du graphe. Valeurs possibles auto ou une valeur en unités em, px, %
height	auto	Hauteur du conteneur du graphe. Valeurs possibles auto ou une valeur en unités em, px, %
align	right	Alignement du graphe: left center right
class	no-print	Ajouter une classe supplémentaire au conteneur du graphe
colors	#E0E4CC,#F38630	Jeu de couleurs personnalisé
fillopacity	0.7	Opacité du remplissage pour les graphes de type line, bar et polararea
pointstrokecolor	#FFFFFF	Couleur du point les graphes de type line et polararea
animation	true	Activer ou non l'animation du graphe
scaleFontSize	12	Taille de police en px
scaleFontColor	#666	Change l'échelle de couleur de police
scaleOverride	false	Si true, le script tente d'appliquer l'échelle. Requiert les paramètres suivants
scaleSteps	null	requiert scaleOverride=true, Nombre de pas de l'échelle
scaleStepWidth	null	requiert scaleOverride=true, Valeur du pas de l'échelle
scaleStartValue	null	requiert scaleOverride=true, Valeur de départ de l'échelle
scaleLabelUnit	€	Uniquement pour les graphes de type line et bars, pour afficher l'unité à la suite de chaque label

	sans le plugin	avec le plugin
affichage	De Proust on connait évidement la phrase Longtemps, je me suis couché de bonne heure… qui est la première de son œuvre.	De Proust on connait évidement la phrase Longtemps, je me suis couché de bonne heure… qui est la première de son œuvre.
Code HTML	`De Proust on connait évidement la phrase Longtemps, je me suis couché de bonne heure… qui est la première de son œuvre.`	`De Proust on connait évidement la phrase Longtemps, je me suis couché de bonne heure… qui est la première de son œuvre.`

	sans le plugin	avec le plugin
affichage	Voici un Haiku très connu: dans le vieil étang, Une grenouille saute, un ploc de l'eau. de Matsuo Bashō
Code HTML	`Voici un Haiku très connu : dans le vieil étang, Une grenouille saute, un ploc de l'eau. de Matsuo Bashō`

“01.”	Ordre de la catégorie (peut commencer à 00. )
“Ma Catégorie”	Nom de la catégorie (= Nom du type de publication)
“/”	séparateur sans espace entre le nom de la catégorie et le nom de la lettre
“02.”	Numéro d'ordre de la lettre (peut commencer à 00. )
“Ma Lettre”	Nom de la lettre

`id_commandes_detail`	Identifiant unique du détail (attention au «s» à commandes)
`id_commande`	Identifiant de la commande concernée
`descriptif`	Texte décrivant le détail. S'il s'agit d'un objet éditorial, il peut s'agir de son titre, descriptif ou autre.
`quantite`	Quantité
`prix_unitaire_ht`	Prix Hors Taxe
`taxe`	Taxe (TVA)
`statut`	Statut
`objet`	Type d'objet s'il s'agit d'un objet éditorial
`id_objet`	Identifiant de l'objet s'il s'agit d'un objet éditorial
`maj`	Date de la dernière mise à jour

id_commande	reference	id_auteur	statut	date	date_paiement	date_envoi	maj
1	xxxxxx	1	encours	2014-05-14 09:00:00	0000-00-00 00:00:00	0000-00-00 00:00:00	2014-05-14 09:00:00

id_commandes _detail	id_commande	descriptif	quantite	prix _unitaire_ht	taxe	statut	objet	id_objet	maj
1	1	Gibolin 2000	2	8	0.2		produit	1	2014-05-14 09:00:00
2	1	Ripolin 5000	1	12	0.2		produit	2	2014-05-14 09:00:00
3	1	Frais de port	0	4	0				2014-05-14 09:00:00
4	1	Ristourne	0	-2	0				2014-05-14 09:00:00

SPIP-Contrib

Réservations multiples

Table of contents

Dépendances

Introduction

Configuration

Formulaire public

Promotions

#POPUP : une popup propre pour SPIP

Table of contents

Installation

Utilisation de la balise

Utilisation dans les articles

Squelette par défaut

Configuration

Squelette(s) personnalisé(s)

Documentation technique

Accessibilité

Lame pour le Couteau Suisse

Évolutions à venir (ou à faire ...)

'Menus' - a menu builder/manager plugin for SPIP

Table of contents

How to install 'Menus' plugin

How to create a new menu ?

Entry types

Simple hypertext link

SPIP objects

Dynamic sections/articles tree

How to edit an entry ?

How to use menus in your website ?

How to export menus to another SPIP website ?

Overwriting menus/.html file types

Définitions et FAQ, version 3

Table of contents

Installation et compatibilité ascendante

Utilisation de base

Utilisation avancée

Intégration au Porte-plume

Configuration

Exemple

Édition directe 3

Table of contents

Principe

Installation

Configuration

Pour Développeur

Des jeux dans vos articles !

Utiliser la surcharge

Bouquinerie V2

Table of contents

Présentation

Installation et dépendances

La boucle LIVRES

La boucle LIVRES_AUTEURS

Les critères communs à toutes les boucles

Les plugins complémentaires

Boussole

Table of contents

Avertissements

Objectifs

Exemples d'utilisation

Installation

Pré-requis

Modèle de données

Initialisation du plugin

L'interface privée

L'interface publique

Traductions et icônes

Créer sa propre boussole

Boussole v2, nouveau fonctionnement client-serveur

Table of contents

Migration du plugin en version 2

Un gestionnaire et des boussoles

Fonctionnement serveur

Fonctionnement client

Bouton Changement de langue pour le Porte-Plume

Table of contents

Indiquer un changement de langue dans un texte

Utiliser l'extension Changement de langue pour le Porte-Plume

Bouton «Proposer à la publication»

Overwriting `menus/.html` file types

Utiliser le pipeline `post_cache`