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,
Serait t’il possible d’afficher aussi le commentaire du jour dans un article en utilisant
la commande
<spiperipsum|lecture=XXXXXX>
avec XXXX qui pourrait être « commentaire ».
Je vous remercie.
Voilà Emylia92,
Le commentaire du jour a été rajouté.
Tu peux l’utiliser ainsi dans un article :
La page Z Evangile a aussi été mise à jour.
Bonjour,
Est-t’il possible d’afficher aussi la fête du jour ?
Merci pour ce travail qui nous rend service.
Non pas pour l’instant.
Néanmoins, c’est possible avec l’API proposée par le service web. Je regarderais cette semaine si je peux le faire rapidement.
Alors mes premiers essais pour récupérer la fête ne sont pas concluants. La structure du plugin est bien prête néanmoins mais le HTML est vide même les jours où une fête est bien présente. Donc je crains que ce soit une souci du service lui-même.
Répondre à ce message
Bonjour,
depuis hier, j’aire marqué que le code me renvoyait fr au lieu du texte.
Y a t il eu un changement ?
J’utilise <spiperipsum|jour=aujourdhui|lecture=evangile>
Merci,
Louis
Désolé,
Le plugin ayant été désactivé, il ne fonctionnait plus (logique !)
Merci
Répondre à ce message
Bonjour,
De retour sur le forum pour signaler un incident : apparemment le plugin a fait planter mon site. J’ai vraiment dû faire quelque chose de travers. Il a fallu que je le désinstalle pour qu’il reparte.
Est-ce que c’est déjà arrivé à d’autres utilisateurs ? MErci.
Hirisben,
Pourrais-tu me donner plus de précision sur le sujet car c’est impossible de te répondre. Sur mes sites rien ne plante mais peut-être as tu un cas spécifique.
Donc peux-tu me donner exactement :
- le code du modèle tel que tu l’utilises dans ton article, c’est-à-dire : <spiperipsum|...>
- la langue de ton site
Merci d’avance.
Bonjour Eric,
Merci de me répondre.
N’ayant besoin que du Saint du jour mon code est le suivant :
#SPIPERIPSUM{fr, aujourdhui, saint}
avec les accolades avant fr et après saint mais ça n’apparaît pas dans le message.
La langue de mon site : le français.
La version de SPIP : la dernière en date de la famille 2.1.
Dans un premier temps tout fonctionnait à merveille. Dans un deuxième temps, le plugin a cessé d’afficher le Saint du jour et tu m’avais déjà aidé sur ce même forum. Après désinstallation et réinstallation, c’était revenu avec toutefois un petit « bug » d’affichage sur les accents (certainement une histoire d’encodage de caractères).
Hier j’ai fait une sauvegarde de ma base et c’est après que tout a planté. Le site ne s’affichait plus du tout, une page blanche, et au bout de quelques minutes une erreur ’Internal server error". J’ai désactivé puis réactivé les plugins un à un et c’est comme ça que j’ai vu que le problème venait de SPIPER IPSUM. (ou de la façon dont je l’utilise).
Merci beaucoup en tout cas de ton retour, c’est précieux de pouvoir échanger.
Répondre à ce message
Bonjour à tous,
J’aimerai pouvoir utiliser ce plugin pour mettre les textes du rite maronite et je ne sais pas si cela est possible. Sur Le site Evangile au quotidien cette version existe.Quelqu’un peut il me dire si je peux le faire.
Merci,
Louis
Bonjour,
Je viens de vérifier. En fait, pour l’instant je décode le langage de l’interface et je traduit cela dans le code de langue du service qui propose pour le calendrier romain classique. :
- « AM » : for american-us language and Roman calendar Ordinary form
- « AR » : for arabic language and Roman calendar Ordinary form
- « DE » : for german language and Roman calendar Ordinary form
- « FR » : for french language and Roman calendar Ordinary form
- « GR » : for greek (hellenic) language and Roman calendar Ordinary form
- « IT » : for italian language and Roman calendar Ordinary form
- « MG » : for malagasy language and Roman calendar Ordinary form
- « NL » : for dutch language and Roman calendar Ordinary form
- « PL » : for polish language and Roman calendar Ordinary form
- « PT » : for portuges language and Roman calendar Ordinary form
- « SP » : for spanish language and Roman calendar Ordinary form
Par exemple, si le site est en catalan, mexicain ou asturien... je renvoie les textes SP du service. Mais c’est exact que le service propose aussi « MAA » : for arabic language and maronite calendar et je suppose que c’est ce que tu souhaites.
Donc immédiatement c’est pas possible mais je pourrais rajouter un paramètre dans les modèle pour forcer ce code. Je note l’évolution.
Merci Eric,
C’est effectivement ce que je souhaite. Pour l’instant je me contente des textes du rite romain en arabe en attendant l’autre version.
Je ferais un petit up de ce thread pour te prévenir quand ce sera disponible. Dans l’intervalle n’hésite pas à me dire si déjà l’arabe fournit des textes corrects car je sais que certaines langues posent des problèmes d’extraction.
Salut Eric,
Les textes que j’ai pu lire jusqu’à aujourd’hui sont bons !
Répondre à ce message
Bonjour,
J’ai installé Spiperipsum sur ma page d’accueil il y a un mois pour afficher uniquement le saint du jour : tout fonctionnait parfaitement. Et puis brutalement lundi : plus rien... aussi bien en ligne qu’en local. Pourtant je n’ai touché à rien.
J’ai inclus la balise de la façon suivante sans faire appel au modèle car il ne me convient pas tel quel, et je n’ai pas réussi à le customiser. :
#SPIPERIPSUM {fr, aujourdhui, saint}
J’ai testé avec le modèle et là ça fonctionne à nouveau mais je ne peux pas m’en servir en l’état. Pouvez vous m’indiquer dans quel fichier je dois aller pour adapter le modèle à ma CSS SVP ? Un coup de main serait vraiment le bien venu si une bonne âme veut bien se pencher sur mon problème... Merci !
Hirisben,
Quelle est ta version de spiperipsum utilisée ? As-tu une url pour voir ce que cela donne ?
Dans la dernière version de spiperipsum le modèle a été amélioré avec des classes pour chaque élément inclus ce qui permet de les styler à loisir.
Bonjour Eric,
Merci de ta réponse. J’utilise la version 1.4.0.
Voici l’adresse : http://www.assomption-lubeck.com .
J’avais inclus l’appel SPIPERIPSUM dans une div avec un fond (colonne de droite), il reste un petit bout qui dépasse, c’est tout... J’ai déjà vérifié que ça ne venait pas de la CSS en retirant la div.
Je me demande ce qui a bien pu se passer, cela marchait impec....
Je n’ai pas précisé que je suis sous SPIP 2.1. Voilà, merci beaucoup en tout cas !
Hirisben,
Ca marchait avec la version 1.4.0 ou c’est depuis que tu as cette version que ça fonctionne plus ? Sinon il y a peut-être un bug que j’ai loupé en testant. J’essayerais de voir ça cette semaine.
Non, ça a toujours été la 1.4.0... Merci de ton aide.
Bonjour Eric,
J’ai désinstallé le plugin, réinstallé et restauré une sauvegarde de ma page sommaire et ça re-fonctionne ! Le problème ne venait donc pas du plugin mais de ma page ou de mon installation... Je n’ai pas identifié l’origine (tout me semble rigoureusement identique à la version précédente...). Merci encore de ton aide, et pardon, j’aurais dû commencer par faire cette manip avant de poster.
Répondre à ce message
est-ce le plugin est compatible avec sarks-spip ?
Après chargement dans plugins/auto/, il ne veut pas apparaitre dans les plugins disponibles !!
merci et bravo pour ce plugin que j’utilise par ailleurs sous ahunstic
Bonjour,
Oui il est compatible avec n’importe lequel des squelettes SPIP car il utilise des modèles SPIP. Il est aussi possible de l’utiliser via des pages Z pour les squelettes qui supporte ce concept.
Ton problème vient plutôt de la version de SPIP. Quelle version de SPIP utilises-tu ?
Répondre à ce message
SPIPERIPSUM est utilisé sur le site http://toulouse.dominicains.com depuis plus d’un an pour le saint du jour, les textes du jour et ceux relatifs aux homélies archivées sur le site. Depuis 2 jours, seul le saint du jour est affiché correctement. ( Le commentaire n’est pas utilisé sur le site).
Version SPIP : 2.1.15
Version SPIPERIPSUM : 1. 3. 0 (la mise à jour du plugin n’a rien changé au pb).
Les symptômes :
La 1re lecture n’affiche que le titre et le verset. Aucun texte.
Le titre et le verset du psaume s’affichent bien mais le texte est limité à une ligne (pas la 1re).
Ni titre ni verset pour l’évangile, le texte se limite à une ligne (pas la 1re).
URL où le bug est visible : http://toulouse.dominicains.com/?page=evangile
http://www.levangileauquotidien.org/ semble ne plus fonctionner correctement...
EAQ interrogé me dit d’utiliser feed.evangelizo.org/reader.php ; ce n’est pas le cas dans le plugin SPIPERIPSUM qui ne l’utilise que pour le commentaire et le saint du jour.
Que dois-je faire ? Y-a-t-il un siperipsum_utils.php qui résolve ce pb ?
Répondre à ce message
Bonjour,
Je télécharge quotidiennement l’évangile sur mon site spip en utilisant
ce pluggins. Or Free vient de bloquer le port 80.
Pour demander de mettre le serveur source de l’information en whitelist, quelle adresse
dois-je communiquer à Free.
Je vous remercie vivement pour votre reponse.
Répondre à ce message
Merci beaucoup Eric, bien d’avoir mis à jour le plugin afin de pouvoir afficher aussi le commentaire.
Le résultat est ici :
http://apelsjasceaux.free.fr/spip.php?article170
Répondre à ce message
Ma demande précédente est mal passée.
En fait je demande s’il est possible d’avoir le commentaire associé à la seconde lecture.
avec une commande du style
< spiperipsum|jour=aujourdhui|lecture=commentaire >
Merci.
Bonjour,
Oui j’ai regardé le flux c’est possible les informations sont disponibles.
Ca demande juste à être codé ;-)
Je ferais cela dès que j’ai une minute.
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 : |