Description
Le plugin propose d’afficher, d’une part, les lectures de l’évangile pour un jour et une langue donnés, et, d’autre part, le saint d’un jour et un résumé de sa vie dans une langue donnée.
L’affichage des textes se fait principalement au travers de modèles, ce qui permet l’inclusion dans un squelette ou dans un article.
Des pages « Evangile du jour » et « Saint du jour » sont aussi disponibles pour les squelettes Z, voir l’article SPIPer Ipsum et les squelettes Z pour plus de détails.
Il est aussi possible de récupérer toutes les informations stockées en cache pour un jour donné via une balise.
Installation
Se référer à l’installation d’un plugin sur spip.net. L’ensemble des sources est installé dans plugins/. Rien n’est créé en base de données.
Le plugin est déposé sur la zone et peut être téléchargé en zip ou en SVN.
Désinstallation
Désactiver le plugin dans la page d’administration de l’espace privé. Ensuite supprimer le dossier du plugin SPIPer Ipsum dans plugins/.
Pour enlever toutes traces du plugin il est possible de supprimer aussi le cache du plugin à l’emplacement tmp/cache/spiperipsum/
.
Configuration
Aucune configuration n’est nécessaire pour ce plugin.
Principes d’utilisation
Une page de démo demo/spiperipsum.html
est fournie avec le plugin et illustre quelques uns des cas d’utilisation décrits ci-après. La page doit être appelée par l’url http://monsite/spip.php?page=demo/spiperipsum
en mode administrateur.
Le modèle spiperipsum
Le plugin propose le modèle spiperipsum à inclure dans les squelettes ou les articles. Il permet d’afficher l’ensemble des textes que ce soit une lecture de l’évangile ou la vie d’un saint.
L’intégration de ce modèle dans un squelette se fait, par exemple, de la manière suivante :
[(#MODELE{spiperipsum, langue=en, jour=aujourdhui, lecture=premiere})]
[(#MODELE{spiperipsum, langue=#ENV{langue, #LANG}, jour=#ENV{jour}, lecture=saint, mode=page})]
et dans le texte d’un article :
<spiperipsum|jour=2009-12-26|lecture=premiere>
<spiperipsum|lecture=psaume>
<spiperipsum|jour=aujourdhui|lecture=commentaire>
<spiperipsum|langue=es>
<spiperipsum|lecture=saint>
<spiperipsum|lecture=date_titre>
La balise #SPIPERIPSUM
Le plugin propose également une balise pour récupérer une à une chaque informations collectées pour un jour et une langue donnée. Ces informations sont stockées dans un cache organisé par jour et langue.
L’intégration du modèle ou de la balise dans un squelette se fait, par exemple, de la manière suivante :
#SPIPERIPSUM{fr, aujourdhui, saint, url}
#SPIPERIPSUM{en, 2009-12-24, saint, titre}
#SPIPERIPSUM{en, 2009-12-24, psaume, verset}
#SPIPERIPSUM{fr, aujourdhui, date, titre}
Cette balise a peu d’intérêt sauf pour construire la noisette ci-après.
La noisette inclure/saint_lien.html
Le plugin propose également une noisette avec le nom du saint du jour et un lien vers le résumé de sa vie directement affiché sur le site du serveur. Cette noisette peut-être incluse dans un squelette, en particulier dans un bandeau ou une colonne extra.
Le code de cette noisette est le suivant :
[<a[ href="(#SPIPERIPSUM{#ENV{langue}, #ENV{jour}, saint, url})"]>
(#SPIPERIPSUM{#ENV{langue}, #ENV{jour}, saint, titre}|trim)
</a>]
Référence d’utilisation
Affichage des lectures de l’évangile avec le modèle spiperipsum
SPIPer Ipsum propose en premier lieu d’afficher les lectures de l’évangile, en utilisant le modèle spiperipsum. Les informations affichées par défaut sont en général les suivantes :
— le titre,
— la référence du verset ou l’auteur et la source pour le commentaire,
— le texte proprement dit.
Le modèle permet aussi depuis la version 1.5.1 d’afficher la date de l’évangile de 3 façons différentes :
- affichage classique de la date ISO (lecture=date_iso),
- affichage de la date liturgique (lecture=date_liturgique),
- les deux sous une forme de titre séparé par un caractère paramétrable (lecture=date_titre).
1. | langue | facultatif, désigne le code de langue SPIP | par défaut, la langue principale du site ou du contexte |
2. | jour | facultatif, détermine la date de l’évangile, sous la forme aaaa-mm-jj ou avec le mot-clé aujourdhui pour le jour courant | par défaut, le jour courant est choisi |
3. | lecture | facultatif, identifie le texte de l’évangile souhaité et peut prendre les valeurs premiere, seconde, psaume , evangile et commentaire. Les valeurs date_iso, date_liturgique et date_titre permettent d’afficher la date de l’évangile | par défaut, la lecture evangile est choisie |
4. | mode | facultatif, définie le mode d’appel du modèle, article ou page, et permet d’afficher les titres en h3 pour l’article et h2 pour la page | par défaut, le mode article est choisi |
Affichage de la vie d’un saint avec le modèle spiperipsum
SPIPer Ipsum propose aussi d’afficher le saint d’un jour et un résumé de sa vie, en utilisant le modèle spiperipsum. Les informations affichées par défaut sont les suivantes :
— le nom du saint,
— le texte de sa vie.
L’utilisation du modèle spiperipsum diffère de l’évangile sur un seul point, le paramètre lecture qui doit prendre la valeur saint.
Utilisation détaillée de la balise #SPIPERIPSUM
1. | langue | désigne le code de langue SPIP |
2. | jour | détermine la date de l’évangile, sous la forme aaaa-mm-jj ou avec le mot-clé aujourdhui pour le jour courant |
3. | lecture | identifie le texte souhaité et peut prendre les valeurs premiere, seconde, psaume, evangile, commentaire et saint. Pour les dates la valeur de la lecture doit être date |
4. | info | désigne l’information souhaitée. Pour une lecture de l’évangile à l’exception du commentaire les informations disponibles sont titre, verset et texte. Pour le commentaire, les informations disponibles sont titre, auteur, source et texte. Pour le saint, les informations disponibles sont titre, texte et url. Pour la date, les informations disponibles sont titre, iso et liturgique |
Personnalisation
Bien que les informations soient assez simples, il est toujours possible de personnaliser les affichages proposés en ajoutant de nouveaux modèles au plugin.
Mises à jour
- 23 mai 2015 : Mise à jour 1.6.4, avec les modifications suivantes :
- Adaptation du code à la version v2 du service evangelizo.
- 22 Août 2013 : Mise à jour 1.5.1, avec les modifications suivantes :
- Ajout dans le modèle
<spiperipsum>
de la possibilité d’afficher les dates iso ou liturgique ou les deux.
- 20 Mai 2013 : Mise à jour 1.4.1, avec les modifications suivantes :
- mise au point du saint du jour qui n’était plus correctement affiché. Il est donc fortement conseillé de passer à cette version.
- 21 Octobre 2012 : Mise à jour 1.4.0, avec les modifications suivantes :
- ajout de classe autour de chaque item des modèle afin de pouvoir les styler ; cependant le plugin ne propose aucun style par défaut.
- refactoring des traitements des lectures et du commentaire afin d’améliorer sa généricité et son extensibilité.
- amélioration de la détection des langues et de leur support
- amélioration de l’extraction des crédit et copyright.
- 7 Juin 2011 : Mise à jour 1.3.0, avec les modifications suivantes :
- Spiper Ipsum devient compatible SPIP 3,
- les pages Z du plugin sont maintenant utilisables sous Zpip-dist avec SPIP 2 et Z-Dist avec SPIP 3,
- plugin.xml est revu en prévision de la migration sous paquet.xml (ajout du slogan).
Discussions par date d’activité
31 discussions
Bonjour
J’ai lu cet article avec intérêt et j’ai téléchargé le plugin mais je n’y connais pas grand chose et je n’arrive à rien. Le plugin étant activé… rien ne se passe ! Faut-il inclure les premières lignes de code que vous proposez dans un fichier squelette ? Si oui, lequel ? Ou autre chose ? Merci de détailler un peu plus, s’il vous plaît.
Bonjour Morette,
Je pense que je ne peux guère être plus explicite que dans cet article. Il serait bon que tu lises l’article de SPIP.net utiliser les modèles et ensuite tout deviendra plus clair à mon avis.
Ceci étant, il y a deux méthodes essentielles pour insérer simplement l’évangile ou le saint du jour :
<imgxx|center>
dans le texte.#MODELE
. Si tu utilises le squelette ZPIP, il existe des pages prêtes à l’emploi pour l’évangile et le saint du jour qui sont décrites dans l’article SPIPer Ipsum et les squelettes Z.Voilà, en espérant t’avoir débloqué...
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |