SPIPer Ipsum, l’évangile au quotidien

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).

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

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).