SPIP-Contrib

Portfolio simple

ydikoi — 2010-02-07T22:41:08Z

Un portfolio tout simple : vous mettez les images dans une rubrique, et hop !

Présentation

Porfolio simple est la déclinaison la plus simpliste d'un portfolio d'artiste : il suffit d'attacher les images à une rubrique.

Il n'y a donc que deux pages : celle du portfolio, et une page "contact".

Site d'exemple : Un œil sur …

Pré-requis

Portfolio simple utilise les deux plugins suivants :
- Plugin Menu
- et soit Fancybox soit thickbox

Installation

Téléchargez l'archive jointe, activez la, ainsi que les deux plugins pré-requis.

Configurez le menu principal du site :
- Installez le plugin Menus
- Créez un menu (Editions > Menus du site > Créer un nouveau menu) en lui donnant l'identifiant "barrenav"
- Créez les entrées du menu :

"Ajouter une entrée > Accueil"
"Article, rubrique ou autre objet SPIP" >
"Type de l'objet" > auteur
"Numéro" > 1 (a priori, il n'y a que vous comme auteur, sinon le numéro de l'auteur)

- Dans le menu "Configuration", dans le bloc "Documents joints", cochez "Autoriser les documents dans les rubriques" et validez

- Créez une rubrique

Utilisation

Déposez les photos directement dans la rubrique.


Page principale du portfolio


Visualisation d'une photo


page de contact

Personnalisation

Vous pouvez rentrer une description du site, qui apparaîtra sous la ligne de séparation horizontale ;
Vous pouvez rentrer une courte biographie, qui apparaîtra dans la page contact.
Vous pouvez créer plusieurs thèmes, en déposant les photos dans autant de rubriques distinctes ; il ne reste plus qu'à définir les entrées correspondantes dans le plugin menus

Le plugin FreepapeR 2 v0.8.4

franckGre — 2010-02-07T18:44:02Z

Un outil pour visualiser en ligne les fichiers PDF, entièrement installé sur son propre serveur, pour des documents toujours disponibles et jamais altérés...
FreepapeR fonctionne aussi en intranet.


Un des skins de FreepapeR 2

Si un plugin d'une version antérieure est déjà installé, alors supprimer tout d'abord entièrement le répertoire plugins/freepaper avant d'installer la nouvelle version

I- Installation

Se référer au document PDF en pièce jointe, ou au site Le dedans du bocal
Une fois le plugin installé, on dispose d'un Modele modelefppII et de deux balises #FPP2STD et #FPP2SWF pour afficher dans la page les fichiers PDF ou SWF.

II- Les nouveautés de la version 0.8.4

Le lecteur fonctionne maintenant dans la machine virtuelle AVM2 apparue avec le lecteur flash 9. Cependant, il reste en mesure d'afficher les documents swf générés en AVM1 (avant flash 9).
Le document est placé dans un Panneau disposant d'ascenseurs s'il devient trop grand pour tenir dans la vue. On peut déplacer le document avec la roulette de la souris.
Les touches « Début », « Fin », « Page précédente », « Page suivante », « Flèche bas », « Flèche haut », « Flèche gauche » et « Flèche droite » permettent de se déplacer dans le document (suivant le type d'affichage), sauf en mode plein écran (clavier non géré).
Le lecteur dispose maintenant de 3 modes d'affichage : « Page simple » (comme auparavant), « Liste de pages » et « Pile ».

III- Les nouveautés de la version 0.8.3

La version 0.8.3 fonctionne avec toutes les versions de SPIP supérieures à 1.9 (donc y compris pour les versions SPIP à partir de 2.0.9).
Remplacement du champ de sélection de la page à afficher par un composant disposant aussi d'un curseur que l'on peut déplacer à la souris, permettant ainsi la navigation dans le document même en mode plein écran (le clavier est désactivé dans les objets swf en mode plein écran).
Ajout des éléments « Première page », « Page précédente », « Page suivante » et « Dernière page » dans le menu contextuel situé sur le document affiché (clic droit de la souris).

IV- Les nouveautés de la version 0.8.2

La version 0.8.2 apporte comme seule nouveauté la compatibilité avec les versions de SPIP supérieures à 2.0.9. Pour une utilisation avec les versions antérieures de SPIP, utiliser le plugin FreepapeR v 0.8.1.

V- Les nouveautés de la version 0.8.1

Détection du système du serveur. Il n'y a plus besoin d' intervenir sur la valeur de la variable « $this->pdftoolsPath » du fichier « php/pdf2swf.php »
Ajout du paramètre wmode pour l'insertion du lecteur FreepapeR.
Une valeur « opaque » ou « transparent » permet de le replacer dans le système de couche du DOM (ce qui l'autorise à être affiché en dessous d'autres élément HTML). La valeur par défaut « window » place le lecteur au sommet de la pile d'affichage (aucun élément de la page ne peut être affiché au dessus). Les modes « opaque » et « transparent » doivent cependant être utilisés avec prudence, car ils peuvent provoquer des dysfonctionnements.
Le plugin est maintenant compatible avec le système d'installation automatique (répertoire plugins/auto) disponible depuis la version SPIP 2.0.

VI- Les nouveautés de la version 0.8.0

Lors du glissé du document, il n'est plus possible de faire glisser la page hors des limites du lecteur
Utilisation de la molette de la souris pour faire défiler la page
Modification du mode plein écran : affichage sur la totalité de l'écran (et non dans le navigateur).

VII- Les nouveautés de la version 0.7.0

Ouverture du document selon un des 4 modes suivants :
- ajusté à la page, ajusté à la hauteur du lecteur, ajusté à la largeur du lecteur, valeur de zoom (%)
Ajout d'une fenêtre d'informations sur le document
Lors d'un changement de page, le haut de la page est re-positionné juste sous la barre de commande
Personnalisation possible par fichier XML :
- de la couleur du fond du lecteur
- de la couleur du contour du lecteur
- de l'épaisseur du contour du lecteur
- des 3 images qui composent la barre de commande
- de la position de l'axe d'alignement vertical des éléments de la barre de commande
- des 5 boutons (3 images possibles pour chaque) de la barre de commande
- du mode d'ouverture document

VIII- Les nouveautés de la version 0.6.0

La fonction Zoom a été améliorée : le zoom est maintenant effectué par rapport au point situé au centre de la visionneuse
Ajout de la fonctionnalité de visualisation « pleine page » (la visionneuse occupe tout l 'espace disponible dans le navigateur)

IX- pdf2swf pour les serveurs 1&1

Ce binaire fonctionne pour les hébergements du fournisseur d'accès 1&1 :


pdf2swf v 0.9.0 pour les serveurs 1&1

Le plugin SPIP FreepapeR est mis à disposition selon les termes de la licence Creative Commons Paternité-Partage des Conditions Initiales à l'Identique 2.0 France.

Bordures ombrées

damazone — 2010-02-05T22:39:37Z

Cet article décrit la méthode à suivre pour modifier les bordures ombrées.

Le squelette egt utilise des images de fond pour afficher les bordures ombrées :
- haut.png
- milieu.png
- bas.png

Pour mettre ces bordures en accord avec le fond que l'on aura choisi, les fichiers graphiques (avec calques) ci-joints vous permettront de faire ce changement facilement.

Fichiers sources pour adapter les bordures ombrées
Pour Gimp	Pour Photoshop
haut.xcf	haut.psd
milieu.xcf	milieu.psd
bas.xcf	bas.psd
Cadre complet.xcf	cadre complet.psd

Pour changer la couleur de fond, il suffira d'ouvrir ces fichiers, avec The Gimp (logiciel libre) par exemple, et de modifier la couleur du calque 'arrière plan'.

Puis, il faut faire un export des images au format png dans le dossier images du plugin egt.

Dans la feuille de style css/habillage.css,

/* bordures ombragées du cadre principal */
 #ombretop { width: 1030px; background-image: url(../images/haut.png); background-repeat:no-repeat; background-position:0px 0px; padding: 27px 0px 7px 0px; margin: -10px 0px 0px -40px; /*background: #FFF;*/ }
 #page { background-image: url(../images/milieu.png); background-repeat:repeat-y; }
 #ombrepied { width: 1030px; background-image: url(../images/bas.png); background-repeat:no-repeat; padding: 25px 0px 7px 0px; margin: 0px 0px -20px -40px; /*background: #FFF;*/ }

Plugin Porte-plume partout

Pascal-JPM, RealET — 2010-02-05T00:11:17Z

"Porte-plume Partout" est une extension du Porte-Plume.

Le plugin « Porte-plume Partout » ajoute la barre d'outil "Porte-Plume" à l'interface de SPIP 2.0+ à la plupart des champs de saisie. Cette extension facilite la rédaction au sein des différents champs de saisie de l'espace privé.

Il rajoute la barre d'outil aux champs : CHAPO, DESCRIPTIF et PS et ceci dans toutes les parties privées de SPIP, sauf dans la zone de gestion des document téléchargés.

Téléchargement du plugin

L'archive du plugin se récupère ici : Porte Plume Partout (zip)

Cette extension d'outil a été programmé grâce aux capacités d'extensibilité et modularité du plugin de "Porte-plume" et surtout grâce au soutien de Matthieu Marcillaud, que je remercie pour le temps qu'il m'a accordé.

Possibilité de configuration supplémentaire

Lorsque vous aurez installé ce plugin, par défaut, les trois champs CHAPO, DESCRIPTIF et PS (ainsi que TEXTE) auront intégrés la barre d'outil. La Bio des auteurs aussi. Et Le descriptif du site dans la configuration de SPIP.

Il est possible de désactiver ces champs un par un en installant les plugins :

CFG
Saisie pour CFG

Cerise sur le gâteau, à partir de la version 2.1 de SPIP (actuellement en beta), la hauteur du champ texte peux aussi être configurée.

Bonne utilisation

Squelettes SPIP Reset !

RealET — 2010-02-05T00:05:53Z

Un squelette pour ne rien publier ! Il ne fait rien, mais il le fait à fond !

Objectif

Voici un squelette dont le but est d'éviter que du contenu puisse percoler via les squelettes de la dist.

En effet, lorsque l'on crée un site sous SPIP, il est rarissime de surcharger tous les squelettes de la dist. Du coup, des informations qu'on ne souhaitait pas forcément voir sur Internet se trouvent pourtant diffusée via les squelettes de la dist.

Un exemple : le squelette auteur.html diffuse 2 informations :

Le nom de l'auteur
la liste des articles de cet auteur

Or, on peut avoir voulu, pour une raison où une autre, ne pas rendre publics tous les articles du site. Et cette page auteur provoque donc une faille dans ce bel édifice...

Méthode

Le squelette surcharge donc tous les fichiers de squelettes de la dist (sauf celui de robots et de favicon).

Les pages classiques redirigent vers la page 404
Les flux RSS sont vidés de leur contenu
La page 404 affiche un message à l'attention des hackeurs du dimanche et un logo de SPIP

Usage

Télécharger le plugin SPIP Reset et le mettre dans le dossier plugins/ de SPIP
Activer le plugin : le site est vide
Faire son propre dossier squelettes/ et y mettre un squelette : ce dernier est prioritaire par rapport à celui du plugin
Avec un squelette sous forme de plugin, il faut rajouter dans le plugin.xml une ligne utilise :

Plugin le fil de marianne

Kaiser, Teddy Payet — 2010-02-01T16:09:48Z

Le squelette "le fil de marianne" dédié à la syndication d'articles (flux RSS) pour SPIP, a été porté en plugin. (voir article précédent : Squelette le fil de marianne.)

Vous pouvez voir la démo en ligne :
In Deesign
http://marianne.teddypayet.com/

Amélioration par rapport au squelette initial :

- Les erreurs ont été corrigé dans cette version.
- Version spip 2.06 minimum necéssaire.

Les nouveautés :

- Intégration des plugins : Plugin pour bannières 2 (Gestion de bandeaux publicitaires), Notation d'éléments SPIP ;
- Squelette d'archives pour retrouver les articles publiés à une date ;
- Ajout d'un squelette spécifique pour afficher un article syndiqué.

Téléchargement

- Squelette disponible sur le site In Deesign (pied de page).
- ou accessible sur http://www.spip-contrib.net/spip.ph....

Installation :

Le squelette est à installer dans le répertoire "plugins". Suivre la démarche habituelle

I. Les publicités :

Fonctions de base
Si vous n'avez pas installé et activé le plugin "Plugin pour bannières 2", une image apparaît à la place réservée à la publicité.
Fonctions avancées
Lorsque le plugin Plugin pour bannières 2 est actif, les emplacements publicitaires sont remplacés par les bannières que vous avez configuré dans l'espace privée.
- La publicité dans le bandeau d'entete fait 468 x 60 px et est en position n°1 #BANNIERE{1}
- La publicité dans le menu de droite fait 300 x 250 px et est en position n°2 #BANNIERE{2}
Merci de vous référer à la documentation de ce plugin pour de plus amples informations.

II. Les notations :

Fonctions de base
Si vous n'avez pas installé et activé le plugin "Notation d'éléments SPIP", un système de notation par défaut est visible grâce à Outbrain. Le système de votes se fait par l'intermédiaire d'un javascript.
Fonctions avancées
Lorsque le plugin Notation d'éléments SPIP est actif, le formulaire de ce plugin prend la relève grâce à la balise #FORMULAIRE_NOTATION

Je travaille actuellement sur un autre squelette Music Best sur lequel il existera une version optimisée pour iphone et qui sera disponible prochainement...

N'hésitez pas à me faire part de vos suggestions...

Le formulaire de contact évolue

Pierre_31, RastaPopoulos — 2010-02-01T13:46:11Z

Il s'agit de présenter une évolution du plugin « Formulaire de contact avancé ».

Les fonctionnalités ajoutées à la version 0.61 concernent la construction de la liste des destinataires et la traçabilité.

La liste des destinataires


Page de configuration du formulaire de contact

Comme pour les versions antérieures vous pouvez configurer une liste de destinataires (appelons-là liste configurée). Il est possible de transmettre une autre liste au formulaire lors de son appel (nommons-la liste transmise).

Pour établir et transmettre une liste de destinataires il faut utiliser l'une des syntaxes suivantes :

dans le code d'un squelette on utilisera un tableau. La liste transmise ici groupe les auteurs 1 et 15 #FORMULAIRE_CONTACT{#ARRAY{0,1,2,15}}
dans le texte d'un article on peut faire appel au formulaire comme si on invoquait un modèle

Cette version propose en plus trois types de comportement vis à vis de ces listes :

on ne tient pas compte de la liste transmise (règles 1, 4 et 7)
on concatène la liste transmise avec la liste configurée pour former une nouvelle liste dédoublonnée (règles 3, 6 et 9)
on utilise uniquement la liste transmise, lorsqu'elle existe, sans ce soucier de la liste configurée (règles 2, 5 et 8).

Traçabilité

Lorsqu'un site dispose de plusieurs formulaires de contact il peut-être utile de savoir depuis qu'elle page le formulaire a été posté. La version 0.61 offre cette possibilité en calculant un lien configurable vers la page du formulaire.

Pour en bénéficier, il est nécessaire de trasmettre un second argument au formulaire de contact en respectant la syntaxe objet-id_objet, par exemple pour fournir cet argument lors d'un appel au formulaire de contact dans le texte de l'article 12 on écrira le dernier argument |trace=article-12.

Dans le cas d'une utilisation dans un squelette on écrira #FORMULAIRE_CONTACT{#ARRAY{0,3,2,8},article-#ID_ARTICLE} ou #FORMULAIRE_CONTACT{'',article-#ID_ARTICLE} selon le cas.

Exemple de mise en œuvre

L'organisation "Yapluca" [1] exerce trois activités : "A1", "A2" et "A3". Bien sûr, il y a un chef "C1".
"Yapluca" organise fréquemment des "sessions de shroumf" qui évidement n'ont aucun lien avec "A1" ou "A2" ou "A3" et "C1" est trop occupé par ailleurs mais souhaite recevoir tous les messages pour archivage. Il souhaite également être le seul à recevoir les messages issus du formulaire général de contact.

Sur "yapluca .com" chaque page dispose d'un lien vers une page de contact qui doit être expédié à "C1". Les activités "A1", "A2" et "A3" sont présentées dans des articles indépendants qui embarquent chacun leur formulaire de contact devant être expédié aux responsables d'activités. Les célèbres "sessions de shroumf" font l'objet d'annonces éditoriales à périodicité variable et dont le responsable chargé de la communication varie. En revanche, toutes les sessions doivent pouvoir bénéficier d'un formulaire de contact qui sera expédié au responsable de la session.

Pour ce site on créera un compte auteur pour chaque responsable et on placera "C1" comme seul destinataire dans la liste configuré. On optera pour la règle n° 3 (Mettre tous ces auteurs en destinataires du courriel et leur ajouter le groupe d'auteurs éventuellement transmit au formulaire).

La page de contact général est un squelette-article. On appelle le formulaire de contact avec #FORMULAIRE_CONTACT{'',article-#ID_ARTICLE}

Dans le texte de l'article de présentation de l'activité "C1" on invoquera puisque il s'agit de l'article 55, que le responsable de l'activité "A1" porte l'identifiant 10 et que depuis peu un sous-chef vient d'être nommé avec l'identifiant 21..... Screu gneu gneu, on reproduira le même type d'appel pour les activités "A2" et "A3".

Les annonces concernant les célèbres "sessions de shroumf" utilisent des brèves. On pourra apprendre à chacun des rédacteurs à faire ce type d'appel transparent puisqu'il s'agit de la breve n° 10 et que son responsable est l'auteur 18.

Non c'est pas fini ! Nous venons d'apprendre que le responsable du site veut lui aussi recevoir tous les messages pour une période de trois mois afin de s'assurer du bon fonctionnement du système. Quelle action minimale entreprendre pour l'insérer dans ce dispositif ? Quel appel devons-nous composer pour la prochaine "sessions de shroumf" sachant que exceptionnellement c'est "C1" qui en sera le responsable ?

Au plaisir de vous lire...

[1] Toute ressemblance avec une organisation existante ou qui aurait existée ne peut-être que fortuite.

Les jeux multiples

Patrice Vanneufville — 2010-01-31T12:21:16Z

Le plugin "Jeux" permet d'insérer dans vos articles des jeux ou des exercices de toute sorte. Afin de réunir la correction et les scores de plusieurs jeux à la fois, voici un petit mode d'emploi pour vous permettre de le réaliser facilement.

Introduction

Cet article concerne l'utilisation du plugin "Jeux" qui permet d'insérer dans vos articles différents jeux. Ici, Il est traité tout particulièrement de l'insertion dans vos articles de jeux multiples dont la correction est traitée en une fois et les scores sont ajoutés entre eux. il est donc désormais possible d'agréger plusieurs jeux différents en un seul.

Vous pouvez trouver et télécharger ce plugin à cette adresse : Des jeux dans vos articles !

Dépendances

Pour un usage optimal, il vous faut une version de SPIP supérieure ou égale à 2.0.0. Les versions antérieures de SPIP ne sont plus suivies par les auteurs du plugin.

Pour ce type de jeu, une recommandation :

Le jeu doit être, non pas inclus directement dans l'article, de la manière décrite dans la documentation principale, mais être créé en tant qu'objet SPIP [1], et intégré au corps de l'article via un modèle. Lisez cet article pour plus d'information.

* Insérer un jeu multiple *

- module : jeux/multi_jeux.php
- séparateurs obligatoires : [jeu]
- séparateurs optionnels (à placer AVANT le premier [jeu]) : [texte], [titre], [config], [score]
- paramètres de configuration par défaut :

bouton_corriger=oui // bouton 'Corriger' ? bouton_recommencer=oui // bouton 'Recommencer' ? bouton_reinitialiser=non // bouton 'Réinitialiser' ? scores_intermediaires=oui // scores intermédiaires ?

La structure :

Tout ce qu'il faut pour le jeu multiple [jeu] Tout ce qu'il faut pour le 1er jeu [jeu] Tout ce qu'il faut pour le 2e jeu [jeu] Tout ce qu'il faut pour le 3e jeu Etc.

Notez bien que les séparateurs optionnels concernant le jeu multiple ([texte], [titre], [config] et [score]) doivent placés au début du contenu. Placés à la fin, ils seront naturellement absorbés par le dernier jeu.

Un exemple :

[titre] Voici deux exercices [config] scores_intermediaires=non [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 ! [jeu] [titre] Exemple de QCM/QRM [qcm] Q Que veut dire "phlox" ? P1 Violet - Pourpre P2 Dressé P3 Nom du botaniste néerlandais qui classifié la famille.|N'importe quoi... P4.1 Flamme|Plus précisément "rouge flamme, en grec" P5 Rigide, ne se casse pas. R4 [qrm] Q Ces mots désignent une couleur jaune : P1.1 citrinus|évidemment ! P2 caeruleus|c'est "bleu de mer" P3.1 stramineus|jaune paille P4 variegata|cela signifie "panaché" P5 nigella|c'est le diminutif de "niger" (noir) R1 R3 (la réponse 3 est la bonne !) [jeu] [titre] Exemple de closure [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

La correction

Lorsque l'utilisateur clique sur le bouton "Corriger"', la correction de tous les jeux d'un groupe de jeux se fait en même temps, et les solutions sont données en fonction de la configuration de chaque jeu.

Les scores

Rappel : un score de jeu est composé de :
- un premier nombre entier représentant le total des points obtenus par le joueur (champ 'spip_jeux_resultats' de la table spip_jeux_resultats).
- un second nombre entier représentant le nombre total des points du jeu (champ 'total' de la table spip_jeux_resultats).
- un descriptif plus détaillé pouvant informer sur le déroulement du jeu et les différentes réponses données par le joueur (champ 'resultat_long' de la table spip_jeux_resultats).

Exemple sur un QCM :

resultat_court	resultat_long	total
6	Q1:R4:2, Q2:R1:0, Q3:R1:1, Q3:R3:2, T4:terre:1	8

Dans le cas un jeu multiple, le résultat stocké en base est :
- la somme totale des points obtenus par le joueur
- la somme totale des totaux de points
- la concaténation des informations détaillées de chaque jeu

Exemple sur le double jeu proposé ci-dessus :

resultat_court	resultat_long	total
2	Q1:R1:0, Q2:R1:1 T1:réponses:1, T2:trou / vide / blanc:0	5

[1] ce que j'appelle objet SPIP est par exemple une rubrique, un article ... bref un truc ayant un contenu et sur lequel on peut faire des boucles

Les galeries de photos avec SoyezCreateurs

Augier Guillaume, RealET — 2010-01-28T19:18:13Z

Dans cet articles nous allons vous apprendre à faire des galeries de photos.

Les galeries de photos sont très utiles présenter les photos d'un événement.

Préalable de configuration SPIP/Serveur

Pour fonctionner correctement, les galeries de SoyezCreateurs nécessitent que le serveur dispose de GD2 et que dans la configuration de SPIP, GD2 et la génération automatique des vignettes aient été activés.

Faire une galerie sur un article

Pour faire une galerie il vous suffit une fois votre article créé :

cliquer sur joindre un document
choisir les photos que vous voulez [1].


Téléchargement des photos: La liste de téléchargement des photos pour la médiathèque.

Une liste doit apparaître à la suite de votre article :


Liste des illustrations: La listes des illustrations rattachées à l'article juste après le téléchargement.

modifier chaque photo pour lui ajouter un titre et un descriptif


Formulaire de modification: Le formulaire de modification d'une photo ou on peut y renseigner le titre et la description.

cliquer pour chaque photo sur "déposer dans le portfolio"

Vous devez voir cela apparaître :


Portfolio: Le portfolio rattaché à un article.

Modification d'une photo

On souhaite remplacer une photo sans perdre son titre, sa description et à quels articles elle est rattachée.

Pour cela dans l'espace privé, une fois sur la photo en question vous :

cliquer sur modifier pour accéder au formulaire
cliquer sur [changer] pour choisir la nouvelle photo à télécharger


Changement de photo: Un changement de photo qui vous évite de tout retaper comme le titre ou la description.

Une fois que c'est fait vous verrez la nouvelle photo prendre la place de l'ancienne.

Rattacher la même photo à plusieurs articles

Vous pouvez aussi ajouter la même photo sur plusieurs articles. Une fois sur le formulaire de modification d'une photo il vous suffit de cliquer sur [Ajouter] et de choisir le nouvel article ou la rubrique.


Ajout d'une liaison sur un nouvel article: Le choix de l'article ou la rubrique pour que la photo apparaissent à deux endroits dans le site.

Sur le site public

Votre galerie se situera à la fin de votre article, vous verrez un bandeau de miniature et si vous cliquez sur une la photo apparaitra en plus gros.


Galerie sur le site public: Voila la galerie sur le site public.

[1] à noter que vous pouvez mettre plusieurs photos en même temps elles seront téléchargées les unes après les autres

Pour une gestion plus simple de vos documents nous vous conseillons la médiathèque.

Le plugin médiathèque était actif pour les captures d'écrans. Médiathèque nécessite SPIP-Bonux.

Squelette Spipexhibit

erational — 2010-01-27T14:20:15Z

Objectifs

Le squelette Spipexhibit reprend le look d'Indexhibit, logiciel populaire pour réaliser le site internet de portfolio d'artistes ou de galeries d'art.

La présentation graphique est minimale et sobre. Spipexhibit est destinée aux personnes souhaitant réaliser un site très simple et épuré sous SPIP.

Installation

La procédure habituelle pour installer un squelette à savoir :

Télécharger l'archive .zip
Créer un répertoire ./squelettes/ et y déposer vos fichiers
Ne pas oublier d'aller le menu configuration et de vérifier que l'ajout de documents est activé sur les articles.

Le squelette est compatible avec les plugins :

Crayons si vous voulez éditer votre site depuis l'espace public
Thickbox si vous voulez des diaporamas interactifs

Capture d'écran

Page courante

Page avec un portfolio

Mode d'emploi

zone	description	informations
1	logo du site	à renseigner dans le menu configuration de votre site
2	description du site	à renseigner dans le menu configuration de votre site
3	menu de navigation	liste toutes les rubriques à la racine du site
4	contenu des articles

Les rubriques sont listées par ordre de numéro (10. Actualités, 20. Expositions ...)
Les articles sont listés par ordre de date (le plus récent en premier)
La page d'accueil liste le premier article de votre site. (Astuce Si vous désirez cacher cet article, laissez cet article en statut "Proposé à la publication.)

A faire

Pour l'instant on ne propose d'un seul type de portfolio (celui de base ou thickbox si vous avez activé le plugin), il pourrait être interessant de retrouver le fonctionnalité d'indexhibit de choisir son mode de présentation (avec le plugin Compositions ?)

Le squelette est sur la zone, n'hésitez pas à le modifier et le faire évoluer.

Utilisation des sigles avec SoyezCreateurs

Augier Guillaume, RealET — 2010-01-26T21:09:05Z

Dans cet article nous allons vous apprendre à vous servir des sigles dans Soyez Créateurs.

Dans le but d'améliorer l'accessibilité d'un site web, il est nécessaire que chaque sigle ou acronyme utilisé dans une page soit défini.

Le plugin sigles et acronymes (nécessitant Forms & Table) permet de mettre en œuvre facilement cette directive de l'accessibilité.

Définition

Un sigle est une suite de lettres initiales constituant l'abréviation de plusieurs termes formant mot fréquemment employée. On en distingue 2 types :

acronyme se prononce comme un mot (exemple : ASSEDIC)
abbr se prononce lettre à lettre (ANPE)

Faire un sigle

Le principe est relativement simple : il vous suffit d'aller dans édition/sigles et de choisir créer un nouveau sigle.

Vous devez arriver sur ce formulaire :

Il ne vous reste plus qu'a le remplir :

vous mettez dans le premier champs votre sigle
vous choisissez si c'est un acronyme ou une abréviation
vous mettez la signification de votre sigle
enfin vous choisissez la langue de votre sigle pour savoir si il viens du français ou de l'anglais [1]

Un exemple :

Un peu de typographie

Un sigle s'écrit généralement en majuscule. C'est même à cela que l'on reconnaît facilement que c'est un sigle.

Du coup, le plugin acronyme comporte un squelette public permettant de lister tous les mots écrits tout en majuscule dans les textes des articles : spip.php?page=acronymes_voir.

Conséquence : il est souhaitable que seuls les sigles et acronymes soient écrits en majuscules [2] ! Cela en permettra une recherche aisée.

Sur le site public

Sur le site public on verra que le sigle est souligné avec en bulle d'aide au survol sa signification.

[1] par défaut

[2] pour les noms propres il existe les petites capitales — avec le plugin enluminures typographiques — qui s'utilisent avec la balise

Le multilinguisme dans Soyez Créateurs

Augier Guillaume, RealET — 2010-01-25T20:59:54Z

Dans cet article nous allons apprendre à nous servir du multilinguisme dans Soyez Créateurs.

Configuration du multilinguisme

Tout d'abord il vous faut configurer le multilinguisme. Pour cela il vous suffit d'aller dans configuration/gestion des langues/ et de cliquer sur multilinguisme.

Activer le menu de langue sur les articles ? oui
Activer le menu de langue sur les rubriques ? non
Gérer les liens de traduction ? oui

Ensuite il ne vous reste plus qu'à sélectionner la/les langues de votre choix et de cocher sur les puces et de valider tout vos changements.


Le tableau de choix des langues

Traduction des articles

Pour traduire les articles il vous suffit d'aller sur l'article souhaité (celui qu'on veut traduire). De choisir : écrire une nouvelle traduction, et de choisir la langue :

et voilà ce qui se passe :

Le but est de vous inspirer du texte de l'article dans ça langue d'origine (ici en français) et de le traduire au mieux [1].

Une fois votre article fini enregistrez-le. Pensez à changer la langue [2] car votre article est une traduction donc mettez le comme tel.

Important : si vous voulez supprimer une langue de traduction car elle ne vous est plus utile, assurez-vous d'avoir supprimé tous les articles qui sont dans cette langue car une fois que vous avez rédigé au moins un article dans une langue vous ne pouvez pas la supprimer en la décochant dans le tableau de sélection des langues.

Quand tout cela est fait votre traduction doit être rattachée à votre article comme cela :

Utilisation de la balise multi

Seuls les articles bénéficient d'un mécanisme de traduction à part entière. Pour le reste du contenu géré par SPIP, nous utiliserons donc la balise multi :

rubriques
événements
documents
images
auteurs

Syntaxe :

[fr]Texte d'origine [en] Traduction

Comme ici :


Utilisation de la balise multi: Une utilisation de la balise multi pour traduire une rubrique

Il faut noter que pour trouver l'abréviation de la langue il vous suffit de regarder à coté du nom lors de votre choix de langue [3].

Il faut savoir que quand un utilisateur passe dans la langue de son choix le squelette est traduit donc il faut penser à tout traduire (rubriques, etc.). Car sinon vous verrez apparaître sur le site des rubriques et articles en français car le squelette n'ayant trouvé aucune traduction à remis les objets d'origine donc en français.


Le site dans une autre langue: Le site en anglais avec une rubrique traduit et du contenu (rubriques) en français.

À noter que pour changer la langue du site le choix des langues est en haut à droite du bandeau du site [4].

[1] sans perdre de sens

[2] On peut se passer de l'étape de changer la langue de l'article traduit si on avait préalablement au clic sur Traduire cet article, déjà passé l'interface d'administration dans la langue cible

[3] dans le tableau qui se trouve dans configuration/gestion des langues/multilinguisme

[4] par défaut

Cartouche d'éphéméride de SoyezCreateurs

RealET — 2010-01-25T20:47:09Z

Le cartouche d'éphéméride permet d'afficher 3 informations

La date du jour
Le saint du jour
La météo du lieu et du jour [1]

Affichage de l'éphéméride

L'affichage de l'éphéméride s'active dans la configuration de SoyezCreateurs [2].


Configuration de l'éphéméride: Le code de la ville n'est utile que si Rainette est installée

Affichage du Saint du jour

Référencer le site Nominis :
Saint du jour
- Adresse du site : http://nominis.cef.fr/
- Flux RSS avec le Saint du jour : http://nominis.cef.fr/rss/nominis.php

Attribuer à ce site le mot clef "SaintDuJour" disponible dans le groupe _Specialisation_Sites
Publié le site syndiqué

Pour éviter que le contenu de la syndication ne soit navigable dans le site, placer ce site dans une sous rubrique du Fourre-tout (à créer au besoin).

Remarque : on n'est pas obligé d'afficher le Saint du jour à cet endroit : conceptuellement, on affiche le dernier élément syndiqué des sites ayant le mot clef "SaintDuJour". On pourrait donc très bien imaginer afficher :

les horaires de Shabbat
le cours de la bourse
une citation
les dépêches AFP
...

Affichage de la météo

Installer/Activer le plugin Rainette
Configurer dans SoyezCreateurs le code de la ville la plus proche du lieu.

Configuration de l'éphéméride

Le code de la ville n'est utile que si Rainette est installée

Résultat


Affichage de l'éphéméride dans le menu principal du site

L'éphéméride s'affiche en haut de la 2e zone automatique du menu principal du site.

[1] Nécessite le plugin rainette pour fonctionner

[2] nécessite d'être webmestre du site pour y avoir accès

Configuration avancée de la page contact avec le plugin GIS avec SoyezCreateurs

RealET — 2010-01-25T20:45:46Z

Intégration d'une carte Google Maps dans la page de contact avec des marqueurs personnalisés.

Première étape : configuration de GIS

Nous allons centrer GIS par défaut sur le centre de la carte que nous voulons afficher.


Choisir le centre par défaut des cartes avec la config de Google Maps API

Deuxième étape : se faire une carte personnalisée dans Google Maps

Aller dans Google Maps
S'identifier avec son compte gmail
Cliquer sur Mes cartes
Créer sa carte
l'exporter au format .kml (voir avec Google Earth)


Carte Google Maps personnalisée: Notez l'usage de points, de trajets et de surfaces.

Troisième étape : intégration dans la page contact

Par défaut, la page contact de SoyezCreateurs est un article de redirection vers l'auteur 1.

Il va donc nous falloir :

joindre à l'article de contact le .kml de la 2e étape
insérer la carte dans la Bio de l'auteur

Selon la documentation de GIS, il suffit d'insérer :

où :

carte_gis1 est le nom du modèle
id_article est l'identifiant de l'article qui contient le .kml
zoom le zoom désiré
type le mode d'affichage de la carte
control le mode d'affichage des contrôles de la carte

Ce peut être une bonne idée de mettre aussi un lien vers la carte personnalisée.

Remarque : nul besoin de mettre un point dans l'article en question : le .kml suffit pour afficher la carte via l'appel du modèle indiquant l'ide_article idoine.

Exemple en ligne :

Spip-bible : la méthode du modèle

Maïeul — 2010-01-25T17:21:35Z

Vous pouvez utiliser le modèle . Mais cette méthode est déconseillée : préférez le système du presse-papier biblique.

Il faut écrire

Où xxx est la référence à citer. Elle doit s'écrire sous la forme suivante : abreviation_livrechapitredebut,versetdebut-chapitre_fin,verset_fin. Exemple :
- Cite la Genèse du chapitre 1 au verset 2 jusqu'au chapitre 2 au verset 1 inclu.
- Cite les versets 1 & 2 du chapitre 1 de la Genèse.
- Cite le chapitre 1 de la Genèse.
- Cite le verset 1 du chapitre 1 de la Genèse.
- Cite les chapitres 1 à 3 de la Genèse.

Réglages avancés du modèle

Vous pouvez passer plusieurs paramètres au modèle :
- « numeros ». Valeurs possibles : « oui » ou « non ». Si oui, affiche les numéros de chapitre et de verset dans le cours du texte.
- « ref ». Valeurs possibles : « oui » ou « non ». Si oui, affiche la référence en dessous de la citation.
- « retour ». Valeurs possibles : « oui » ou « non » . Si oui insère un saut de ligne entre les chapitres.
- « traduction » pour choisir la traduction. Voir cet article.

Exemple : affiche

1 ¹Au commencement, Dieu créa le ciel et la terre. ²Or la terre était vide et vague, les ténèbres couvraient l'abîme, un vent de Dieu tournoyait sur les eaux. ³Dieu dit : Que la lumière soit et la lumière fut. ⁴Dieu vit que la lumière était bonne, et Dieu sépara la lumière et les ténèbres. ⁵Dieu appela la lumière jour et les ténèbres nuit . Il y eut un soir et il y eut un matin : premier jour. ⁶Dieu dit : Qu'il y ait un firmament au milieu des eaux et qu'il sépare les eaux d'avec les eaux et il en fut ainsi. ⁷Dieu fit le firmament, qui sépara les eaux qui sont sous le firmament d'avec les eaux qui sont au-dessus du firmament, ⁸et Dieu appela le firmament ciel . Il y eut un soir et il y eut un matin : deuxième jour. ⁹Dieu dit : Que les eaux qui sont sous le ciel s'amassent en une seule masse et qu'apparaisse le continent et il en fut ainsi. ¹⁰Dieu appela le continent terre et la masse des eaux mers, et Dieu vit que cela était bon.

Gn 1, 1-10 (Bible de Jérusalem)

En l'absence de ces paramètres, ce sont les réglages définis dans la page de configuration du plugin qui prévalent.

Spip-bible : la méthode du presse-papier

Maïeul — 2010-01-25T17:21:29Z

La version 1.8 de SPIP-Bible propose un nouveau "presse-papier biblique".

Le presse-papier biblique avait été créé dans la version 1.6 de SPIP-Bible.

Rappelons le principe : un formulaire apparait à côté des formulaires d'éditions. On y saisit la référence biblique, on valide, on obtient en retour le texte, qu'on copie-colle dans le corps de l'article/la rubrique etc.

Par rapport à la méthode d'appel au modèle, ceci à l'avantage :
- de moins fatiguer le serveur
- de garantir la présence du texte à long terme
- de permettre d'ajouter des ornements typographiques.

Le nouveau presse-papier apporte des grandes améliorations. Il est plus simple d'utilisation. En revanche, il nécéssite d'avoir SPIP-BONUX [1].

Voici l'aspect du formulaire :

Dans le champs « passage », saisir la référence du passage, par exemple « Gn1 ». La référence est suivant les abréviations des livres données ici. Rappelons la syntaxe :
- Gn1 => Donne le premier chapitre de la Genèse.
- Gn1,1 => Donne le premier verset du premier chapitre de la Genèse.
- Gn1-2 => Donne les deux premiers chapitres de la Genèse.
- Gn1,2-2,1 Donne la Genèse, chapitre 1 verset 2 jusqu'à chapitre 2 verset 1.

Choisissez la traduction [2]. Dites si vous souhaitez ou non : afficher les numéros de chapitre/verset ; faire des retours à la ligne ; mettre les références [3].

Si vous vous trompez dans la références, le formulaire vous le signale, mais garde vos autres réglages !

Sinon, vous voyez apparaitre dans un champs le texte choisi. Faites alors votre copier-coller.

Configuration avancé du presse-papier

En vous rendant sur la page de configuration du presse-papier (disponible si CFG est activé), vous pouvez choisir :
- les traductions qui apparaissent dans le menu déroulant
- si les rédacteurs ont le choix ou pas [4] :

d'afficher les numéros
de mettre ou non des retours à la ligne
d'afficher ou non les réferences
de choisir une version dans une autre langue que la langue de l'article/la rubrique. : Si l'article n'a pas été encore enregistré en BDD, le formulaire prendra la variable $spip_lang, soit la langue de l'interface privé.
de pouvoir choisir une version dans une langue originale (morte). Les deux derniers paramètres sont indépendants.

Proposer le formulaire du presse-papier sur le site public

Il est possible de proposer le formulaire du presse-papier sur le site public en mettant dans les squelette :

#FORMULAIRE_BIBLE_REFERENCE

avec éventuellement en paramètre une langue.

Vous pouvez aussi mettre dans un article :

[1] Si vraiment vous ne vous voulez pas avoir SPIP-BONUX, vous pouvez utiliser l'ancienne version du presse-papier. Mais je ne le conseille pas. Voir la documentation en archive.

[2] par défaut, le menu choisit la traduction configurée dans les préférences du plugin, voir la documentation générale, en fonction de la langue de l'article ou de la rubrique, ou du site.

[3] La encore, les réglages par défaut sont ceux du plugin.

[4] S'il n'ont pas le choix, le formulaire sur la page d'édition est modifié en conséquent.

SPIP-Bible

Maïeul — 2010-01-25T17:20:00Z

Permet de citer rapidement des extraits de la Bible en utilisant un modèle dans le texte d'un article.

Le plugin Spip-Bible permet de citer rapidement des extraits de la Bible dans le texte d'un article.

Les citations se font entre balises , en récupérant un texte sur un site distant.

Auteur et Licence

Le plugin a été créé par Maïeul Rouquette. Il est sous licence GPL.

Pré-requis

Le plugin nécessite le plugin CFG. De plus votre site doit être connecté à Internet (vous ne pouvez pas faire de test en local sur un ordinateur non connecté à Internet).

Le plugin a été testé sous SPIP SVN et SPIP 1.9.2d. A priori, il doit fonctionner à partir de SPIP 1.9.1.

Mais avoir la version 2 de SPIP et SPIP-BONUX lui ajoute des fonctionnalités (cf. infra).

Installation

Téléchargez le plugin. Installez le suivant la procédure habituelle.


Spip-Bible

Utilisation

Il existe deux manières d'utiliser le plugin :
- avec le "presse-papier biblique" : c'est la meilleure méthode à utiliser. Mais elle nécéssite la version 1.8 du plugin, SPIP 2.0 et le plugin SPIP-BONUX
- avec le modèle .

La méthode avec le modèle nécessite plus de calcul serveur, ne permet pas d'ajouter de la typographie au texte, ne garantit pas la présence éternelle du texte [1].

En revanche :
- c'est la méthode historique, raison pour laquelle elle est reste documentée.
- les versions de Spip avant la 2.0 ne peuvent utiliser que celle là
- comme c'est un modèle, dans l'édition du texte, il prend moins de place.

Dans les deux cas, il faut savoir écrire la réference biblique. La syntaxe est la suivante : abreviation_livrechapitredebut,versetdebut-chapitre_fin,verset_fin.

Ainsi :
- Gn1 => Donne le premier chapitre de la Genèse.
- Gn1,1 => Donne le premier verset du premier chapitre de la Genèse.
- Gn1-2 => Donne les deux premiers chapitres de la Genèse.
- Gn1,2-2,1 => Donne la Genèse, chapitre 1 verset 2 jusqu'à chapitre 2 verset 1.

La abréviations des livres dépendent de la langue de traduction. De même pour le séparateur entre le numéro de chapitre et celui de verset. Je renvoie ici pour la liste. Si vous appelez une version ancienne (langue morte), il faut utiliser les abréviations de la langue de l'article/la rubrique.

Remarque : le premier des Prophètes postérieurs est appelé Esaïe chez les Protestants et Isaïe chez les catholiques, en Français

Depuis la version 1.5.3 (svn 27074), vous pouvez taper "Es" ou "Is", le plugin traduira automatiquement dans la bonne confession.

Remarque 2 Pour les livres d'un seul chapitre (Abdias, Philémon, 2&3 Jean, Jude), il faut écrire Ab1-2 pour avoir les verset 1 et 2.

Configurer le plugin

Pour configuer ces réglages, allez dans « Configuration » -> « Cfg » -> « Configurer le plugin Spip-Bible ».

Sur cette page, vous pouvez configurer :
- les versions par défaut pour chaque langue.
- s'il y a ou non par défaut un retour à la ligne entre chaque verset.
- s'il y a ou non par défaut les numéros de chapitre/verset dans le corps du texte.
- s'il y a ou non par défaut la références en fin de texte.

Il existe aussi une configuration pour le presse-papier biblique. Elle est documentée dans l'article sur le presse-papier.

Dans la version 1.5 du plugin il est possible d'imposer une police pour les passages en hébreu. En effet Windows gère assez mal sinon l'hébreu. Malheureusement seul Safari et peut-être Firefox 3.1 gère la propriété css gèrent la propriété @font-face.

Balises disponibles

La version 1.4 du plugin introduit un certain nombres de balises utilisables. Voir la documentation.

À faire

- Encore et toujours ajouter des versions notamment dans les langues qui n'en possèdent pas.

Notes techniques : importer de nouvelle traduction

La documentation est déplacée dans un article spécifique

Remerciements

à Booz pour m'avoir donner le tuyau sur recuperer_page() et à Fil pour celui sur importer_charset() ... et a tout ceux qui de prés ou de loins m'ont aidé.

[1] Si les fournisseurs du texte décident par exemple de les retirer de leur site

MultiViewer - Premiers Pas -

Christophe Boutin — 2010-01-25T17:02:23Z

Pour installer facilement Multiviewer.

Cette article vient en réponse à ceux qui éprouvent quelques difficultés pour installer pour la première fois le plugin. (voir un plugin)

Voici une procédure pour une mise en œuvre simple :

Installer le plugin Multiviewer sur votre site.

Par exemple en copiant le lien suivant ‘http://www.spip-contrib.net/IMG/zip/multiviewer_v1-0-3.zip' dans la zone de texte ‘Adresse du plugin ou de la liste‘

Activer le plugin, en cochant la case à côté de son nom.

Veillez à ce que la balise #INSERT_HEAD soit présente dans l'entête de votre squelette (entre les balises HTML et )

A partir de la page du plugin, télécharger le fichier d'exemple de portfolio INC-DOCUMENTS.HMTL et le placer dans le dossier des squelettes.

Dans votre squelette (article) insérer la balise suivante :
1. [(#REM) Gestion du portfolio et des documents
2. Le critere {env} permet de passer d'autres arguments de la page
3. par exemple l'id_document choisi pour un affichage complet
4. [(#INCLURE{fond=inc-documents}{id_article}{env})]
Télécharger

Pour changer de viewer, éditer le fichier inc-documents.html à la ligne :
1. [(#MULTIVIEWER{ALL,art#ID_ARTICLE,typegalerie=simpleviewer})]

et changer le nom du viewer juste après “typegalerie=”

Télécharger le tout sur votre site

En cas de souci :

Si le message : « MultiViewer nécessite JavaScript et le lecteur Flash. » s'affiche, il y a de forte chance que le script javascript n'est pas été ajouté dans l'entête.

Vérifier cela, il faut que la ligne suivante soit présente dans le code source de votre page lorsqu'elle est publiée par SPIP :

<script src="plugins/auto/multiviewer_v1.0.3/javascript/swfobject.js" type="text/javascript">script>

Si ce code est bien absent, la cause principale est l'absence de la balise #INSERT_HEAD dans l'entête du squelette.

Solution : Ajouter la ou vérifier quelle est à la bonne place. (entre les balises HTML et )

J'espère que ce petit article sera utile et vous fera gagner du temps.

Motus

cratso_, Matthieu Marcillaud — 2010-01-24T13:13:03Z

Ce plugin a pour idée simple que certains groupes de mots-clés ne sont utiles que sur certaines rubriques de SPIP.

Le contexte

« Motus » permet de restreindre l'utilisation de certains groupes de mots clés à des rubriques choisies préalablement. En effet, une rubrique n'a peut-être pas dans certains cas à proposer pour ses articles les mêmes groupes de mots-clés qu'une autre... Pour les rédacteurs, il est moins perturbant de ne proposer d'attacher que les groupes intéressant leurs articles.

Prenons deux rubriques et deux groupes en exemple. Une rubrique qui s'appelle « Télévisions » utilise des mots-clés du groupe « Formats » tel que « 4/3 », « 16/9 », « 16/10 », ... Une autre rubrique « Revues » peut utiliser un groupe « Parution » possédant des mots comme « Mensuel », « Hebdomadaire », « Quotidien »,... Il est fort probable dans ce cas que la rubrique « Télévisions » n'utilisera pas le groupe « Parution », et inversement pour la rubrique « Revues », il est peu probable que le groupe « Format » l'intéresse.

Ce plugin cache la possibilité de lier certains groupes à certaines rubriques (et leurs enfants et objets). Il ajoute, dans l'édition d'un groupe de mot un sélecteur pour choisir ces restrictions.

Pré-requis

Motus nécessite l'installation des plugins suivants pour fonctionner :

Champs extra 2 (core) version 0.7
Saisies version 1.6.6
Spip bonux version 1.8.6

Installation

Le plugin s'installe classiquement en mettant le contenu du paquet ZIP dans votre dossier plugins/ et en l'activant ensuite dans l'interface de gestion des plugins.

Restreindre un groupe à une rubrique

Vous pouvez restreindre un groupe a une rubrique soit via le formulaire d'ajout rapide en saisissant rubxxx ou rubriquexxx ou le x correspond a l'id (numéro) de la rubrique en question. ou via le sélecteur. cf captures :

Notes

Une fois que vous avez associé un groupe de mots-clés à une rubrique, ce dernier est associé automatiquement à ses sous rubriques (si elle en a).

Formulaire de participation à un événement

Jean Baptiste Pressac — 2010-01-23T13:35:37Z

Cet article tente de rassembler des informations au sujet de l'affichage d'un formulaire de participation aux événements gérés par le plugin Agenda développé par Cédric Morin.

La version 2 du plugin Agenda permet d'afficher dans l'espace public des formulaires de participation aux événements. Cette fonctionnalité est incomplète, mais utilisable.

Voici à quoi ressemble le formulaire sur une page de l'espace public en utilisant les squelettes par défaut de SPIP :


Capture d'écran d'un formulaire de participation à un événement

Les utilisateurs [1] ont la possibilité de répondre j'y serai, j'y serai peut-êre ou je n'y vais pas.

Il est possible de limiter le nombre de places disponibles. Dans ce cas, quand l'événement est complet, les utilisateurs en sont tenus informés par un message et le formulaire n'est plus affiché, sauf pour les utilisateurs connectés ayant déjà répondu j'y serai de manière à leur permettre de se désinscrire et de libérer éventuellement une place.

Si l'utilisateur revient au cours de sa visite sur la page du formulaire, sa réponse reste affichée.

Le plugin ne permet pas encore l'affichage des réponses dans l'espace privé, mais elles peuvent être consultées dans la table spip_evenements_participants en base de données.

Par ailleurs, l'inscription est valable sur toute la durée de l'événement, y compris si l'événement se produit avec des répétitions.

Affichage du formulaire

Le formulaire s'affiche dans un squelette grâce à la balise #FORMULAIRE_PARTICIPER_EVENEMENT{#ID_EVENEMENT} [2] à condition qu'elle soit incluse dans une boucle de type EVENEMENTS. Par exemple, dans le squelette article.html, vous pouvez rajouter la boucle suivante pour afficher les événement liés à l'article et les formulaires de participation associés :


 #TITRE

 #FORMULAIRE_PARTICIPER_EVENEMENT{#ID_EVENEMENT}

Notez que la boucle ne doit pas se trouver dans un INCLURE statique, faute de quoi le formulaire ne sera pas rafraîchi à chaque consultation de la page par l'utilisateur. Autrement dit, si au lieu de placer la boucle directement dans article.html, vous souhaitez la placer dans un squelette nommé formulaire-evenement.html, n'utilisez pas [(#INCLURE{fond=formulaire-evenement})] pour appeller ce squelette depuis article.html, mais [3].

Par ailleurs, la balise #FORMULAIRE_PARTICIPER_EVENEMENT étant un formulaire CVT (charger, vérifier, traiter), vous pouvez bénéficier du chargement du formulaire en AJAX en encapsulant la balise dans une div de classe ajax.



#FORMULAIRE_PARTICIPER_EVENEMENT

L'insertion de la balise #FORMULAIRE_PARTICIPER_EVENEMENT{#ID_EVENEMENT} dans vos squelettes ne suffit pas. Pour que le formulaire s'affiche, vous devez cocher la case « inscription en ligne » du formulaire de saisie de l'événement. Vous avez également la possibilité de saisir un nombre de places si celui-ci est limité.


Formulaire de saisie d'un événement avec une inscription en ligne

Sauvegarde des réponses dans la base de données

Les réponses sont stockées en base de données dans la table spip_evenements_participants, créée à l'installation du plugin. Elle comporte les champs suivants :

id_evenement
id_auteur
date
reponse


La table spip_evenements_participants dans phpMyAdmin

Le champ reponse peut prendre les valeurs suivantes :

'oui' (si la réponse est "j'y serai")
'non' (si la réponse est "je n'y vais pas")
' ?' (si la réponse est "j'y serai peut-être")

La seule façon d'identifier l'auteur d'une réponse est donc id_auteur. Il vaut donc mieux inciter les utilisateurs n'ayant pas de compte de rédacteur ou d'administrateur à créer un compte sur votre site et à se connecter avant de répondre. Cette connexion préalable est d'autant plus nécessaire que dans le cas où un utilisateur ne serait pas connecté, sa réponse serait enregistrée sous l'id_auteur zéro et sa réponse perdue par l'enregistrement de la réponse du prochain utilisateur non connecté.

Pour vérifier si l'utilisateur est connecté, vous pouvez essayer de modifier formulaires_participer_evenement_verifier_dist, en rajoutant après $reponse = _request('reponse'); le test suivant :

if ($GLOBALS['visiteur_session']['id_auteur'] == 0)

$erreurs['reponse'] = "Pour signaler votre participation a l'evenement vous devez etre connecte sur le site. Si vous n'avez pas encore de compte, veuillez en creer un.";

et en remplaçant if (!($reponse=_request('reponse')) suivant par elseif (!($reponse=_request('reponse')).

Si vous hésitez à autoriser des inconnus à se connecter à votre site, notez que SPIP vous donne la possibilité de créer des auteurs nommés « visiteurs », n'ayant pas accès à l'espace privé. Ce type d'auteur est généralement utilisé pour permettre à des utilisateurs de poster des messages dans des forums après abonnement. Pour autoriser l'inscription des visiteurs, allez dans Configuration > Interactivité > Visiteurs puis cochez la case Accepter l'inscription de visiteurs du site public.

Les balises #FORMULAIRE_INSCRIPTION et #LOGIN_PUBLIC vous permettront d'afficher le formulaire d'inscription et le formulaire permettant à vos utilisateurs de s'identifier tout en restant sur le site public [4]. Vous pouvez afficher la liste des visiteurs dans Auteurs puis en cliquant sur Afficher les visiteurs.

Affichage des inscriptions

Le formulaire d'inscription étant une fonctionnalité en cours de développement du plugin Agenda, il n'est pas encore possible de visualiser les inscriptions dans l'espace privé. Vous pouvez toutefois visualiser le contenu de la table spip_evenements_participants avec un outil comme phpMyAdmin si votre hébergeur l'a mis à votre disposition.

Par contre, il est possible d'afficher dans l'espace public la liste des auteurs inscrits à un événement en rajoutant dans le squelette article.html une boucle du type :



 

#NOM

La boucle utilise deux fonctionnalités de SPIP :

la possibilité d'interroger une table de la base de donnée pour laquelle aucun alias n'a été déclaré (ce qui est le cas actuellement pour la table spip_evenements_participants). Par exemple, l'alias de la table spip_articles est ARTICLES (en majuscules), ce qui permet d'écrire au lieu de .
les jointures : la table spip_evenements_participants ne contient pas le nom des auteurs qui se trouve dans la table spip_auteurs, c'est pourquoi la boucle fait appel à ces deux tables pour créer une jointure [5].

Etude du code du formulaire

Pour revenir à la balise #FORMULAIRE_PARTICIPER_EVENEMENT, celle-ci est un formulaire CVT (charger, vérifier, traiter). Vous trouverez donc dans le dossier formulaires à la racine du plugin, le squelette participer_evenement.html et le script participer_evenement.php contenant les fonctions :

formulaires_participer_evenement_charger_dist($id_evenement)
formulaires_participer_evenement_verifier_dist($id_evenement)
formulaires_participer_evenement_traiter_dist($id_evenement)

La fonction formulaires_participer_evenement_charger_dist est exécutée avant l'affichage du formulaire pour vérifier si l'événement passé en paramètre par #FORMULAIRE_PARTICIPER_EVENEMENT{#ID_EVENEMENT} existe réellement et qu'une inscription en ligne est bien prévue pour cet événement (la case « Inscription en ligne » est bien cochée dans le formulaire de saisie de l'événement). Si ce n'est pas le cas, le formulaire n'est pas affiché. Sinon, la fonction vérifie si un nombre de places a été défini et le cas échéant, calcule si l'événement est complet ou non. Les réponses 'oui' ont un poids de 1 et les réponses 'peut-être' un poids de 0,5. La somme des réponses 'peut-être' est arrondie à l'entier supérieur. Par exemple, si deux personnes ont répondu 'oui' et trois personnes 'peut-être', on considère que (2 x 1) + arrondi(3 x 0,5) = 4 places ont été réservées. Si l'événement est complet, le message "evenement complet" est affiché et le formulaire ne s'affiche que si l'utilisateur (identifié par $GLOBALS['visiteur_session']['id_auteur']) a déjà répondu 'oui' de manière à lui permettre de se désinscrire et de libérer éventuellement une place.

Si le formulaire est affiché et que l'utilisateur clique sur le bouton d'envoi, la fonction formulaires_participer_evenement_verifier_dist prend le relais pour vérifier que l'utilisateur a bien coché une des propositions, faute de quoi le message "Indiquez votre choix" est affiché. Si l'événement est complet et que l'utilisateur qui avait préalablement répondu 'non' ou 'peut-être' change sa réponse pour 'oui', on affiche le message 'Plus de places'.

Si aucun message d'erreur n'est affiché, les réponses sont traitées par formulaires_participer_evenement_traiter_dist qui met à jour ou insère dans la base de donnée la réponse de l'utilisateur puis affiche un message de confirmation de prise en compte de la réponse.

[1] Nous préférons à « visiteur » le terme d'« utilisateur » pour désigner une personne qui consulte votre site. En effet, dans le jargon de SPIP, un visiteur est un auteur qui peut avoir des droits pour participer à des forums, par exemple, mais qui ne peux pas accéder à l'espace privé et modifier le contenu du site.

[2] Attention, il est important d'utiliser la balise #ID_EVENEMENT et non pas le critère {id_evenement}, faute de quoi le code ne sera pas valide.

[3] Pour connaitre les différences entre les INCLURE statiques et dynamiques, consultez d'autres squelettes.

[4] Pour en savoir plus sur les formulaires, consultez l'article éponyme sur le site officiel.

[5] Pour en savoir plus sur les jointures, voir programmer.spip.org.