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é
2 discussions
Bonjour
pour le site https://paroisse-benet.fr/ sur une mutualisation spip 4.1.5 + php 8.1
nous allons utilisé le plugin , toutefois la page de démo me donne une erreur .
https://test-paroissebenet.spipfactory.fr/spip.php?page=demo/spiperipsum
est ce normal ou y a t’il des contraintes ?
Filtre , service=#ENV non défini sites/test-paroissebenet.spipfactory.fr/plugins/auto/spiperipsum/demo/spiperipsum.html
Bonjour,
https://git.spip.net/spip-contrib-extensions/spiperipsum/pulls/1 résout ce bug et apporte la compatibilité SPIP 4.2 + PHP 8.2
merci
Mais en SPIPer Ipsum 2.3.0 on a toujours
sans doute attendre que la pr soit intégré au plugins
toutefois tous ls exemples de la page s’affiche, c’est l’essentiel non ?
Répondre à ce message
Bonjour,
Je teste avec SPIP 4.1.2 Git + PHP 8.1.6 + SPIPer Ipsum 2.3.0.
Ceci :
Seule la première balise renvoit quelque chose (« Mercredi 8 juin 2022, le mercredi de la 10e semaine du temps ordinaire »).
Alors que le même code avec SPIP 3.2 en PHP 7.4 et SPIPer Ipsum 2.3.0e donne bien les 2 résultats :
Je ne pige pas trop. Il me semblait que l’appel du saint ne fonctionnait plus depuis 2018 car au lieu de renvoyer le texte le service renvoyait un code surement traduit par le client en JS ?
Donc j’avais dit qu’il fallait juste afficher le nom et le lien vers la page.
Moi non plus, je pige pas trop, je constate juste que les exemples de pgiron affichent bien le saint du jour :
Depuis, j’ai passé les sites en SPIP 4.1.5 + PHP 7.4
J’ai modifié le fichier paquet.xml du plugin pour autoriser l’activation en SPIP 4.1.
Et ça marche !
Je n’ai pas retesté avec PHP 8.1
Passage en PHP 8.1, ça marche toujours
J’ai fait une PR pour SPIP 4.2 + PHP 8.2 : https://git.spip.net/spip-contrib-extensions/spiperipsum/pulls/1
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 : |