Extensions pour la plateforme Extranet de l EPG/EERV Marc Vuilleumier Stückelberg (marc@vuilleumier.ch), 31.1.2015 MOTIVATION Ces quelques extensions ont été réalisées juste après la mise en ligne du site Extranet, pour compléter les fonctionalités sur quelques points qui paraissaient importants à l EPG, mais que WnG ne pouvait pas réaliser sans coût et/ou délais supplémentaires. L objectif de toutes ces extensions est la valorisation complète de la fonction Agenda, développée par WnG dans le cadre du projet Extranet. MÉTHODE Pour ne pas risquer la moindre interférence avec les développements de WnG, ces extensions ont été réalisées sur un site tiers. La plupart sont intégrées sur les pages désirées de l Extranet à l aide du mécanisme préconisé par WnG pour l intégration d extensions tierces telles que les cartes Google Maps, les vidéos YouTube, etc : l utilisation du shortcode [iframe]. La logique des extensions est codée en JavaScript, et ne risque aucunement d impacter le reste de la page puisqu elle est vérouillée dans son iframe. Les extensions extraient les données à visualiser de l Agenda EPG/EERV au moyen de la fonction de recherche d événement fournie par WnG, au même titre que le ferait n importe quel visiteur du site qui utilise la page de recherche d événement. Le code Javascript met ensuite ces données en forme «au vol» pour les afficher automatiquement selon la représentation désirée. LISTE DES EXTENSIONS RÉALISÉES À CE JOUR 1. Page de recherche dans l agenda (pour le site Saint-Gervais, ticket #35) 2. Widget Agenda pour le site Saint-Gervais (ticket #35) 3. Tri amélioré de l extrait pour la Vie Protestante (ticket #43) 4. Liste des cultes améliorée pour la Tribune de Genève 5. Table des cultes par région pour la Vie Protestante 6. Tabelles régionales et paroissiales pour les sites des régions et des paroisses 7. Calendrier d activités pour les sites des régions et des paroisses 8. Listes d événements par thèmes pour les sites web Les extensions liées à la Tribune et à la Vie Protestante ne sont utiles qu à l EPG, mais les autres ont été conçues pour fonctionner aussi bien pour l EERV que pour l EPG.
1. PAGE DE RECHERCHE DANS L AGENDA (POUR LE SITE SAINT-GERVAIS, TICKET #35) Le template Wordpress existant du site de Saint-Gervais a été repris tel quel par WnG sur mandat de l EPG. Les fonctions de recherche dans l agenda ne fonctionnent pas sur ce template, qui n a pas été créé par WnG. WnG exigeant un budget supplémentaire en régie pour les faire fonctionner (voir ticket #35), l EPG a choisi de réaliser une page de recheche par ses propres moyens. Le shortcode pour cette page de recherche est le suivant : [iframe id="http://epg-dev.ch/cal-search.php" align="center" maxwidth="680" aspect_ratio="2:5"] Note : Si désiré, cette extension peut être utilisée sur n importe quel site de paroisse, région ou Lieu Phare de l EPG ou l EERV.
2. WIDGET AGENDA POUR LE SITE SAINT-GERVAIS (TICKET #35) Le widget Agenda ne fonctionne pas sur le template de Saint-Gervais, qui n a pas été créé par WnG. WnG exigeant un budget supplémentaire en régie pour le faire fonctionner (voir ticket #35), l EPG a choisi de faire un widget similaire par ses propres moyens. Pour utiliser ce widget, il faut utiliser un simple widget «Visual Editor» et y mettre le shortcode suivant : [iframe id="http://epg-dev.ch/cal-agenda.php?periode=31" align="center" maxwidth="193" aspect_ratio="2:3"] Le paramètre optionnel «periode=31» précise le nombre de jours à venir que l on veut prendre en compte dans le widget.
3. TRI AMÉLIORÉ DE L EXTRAIT POUR LA VIE PROTESTANTE (TICKET #43) Suite à un problème de compréhension dans l échange des spécifications pour l export destiné à la publication de la Vie Protestante, le résultat produit par WnG ne remplit pas les besoins pour la VP. Le journal a en effet besoin d un groupement par région/services/lieu phares et d un ordre particulier des événements pour chaque rubrique. WnG n ayant pas voulu entrer en matière pour effectuer le tri demandé dans le cadre du projet, l EPG a dû le réaliser par ses propres moyens Cette extension est implémentée sous forme d un simple code JavaScript qui doit être lancé une fois le résultat de la procédure d export Vie Protestante de WnG affiché. Le code Javascript parcourt les éléments sur la page, les réordonne selon les critères de la Vie Protestante et effectue les corrections typographiques. Dans l idéal, il faudrait que WnG ajoute sur la page d export VP un bouton permettant de lancer ce code de tri (ticket #146): il ne s agit que de deux lignes de code HTML a ajouter dans la page, ce qui devrait être faisable en quelques minutes par WnG. <script type="text/javascript" src="http://epg-dev.ch/tri-vp.js"></script> <input type="button" onclick="vpsort()" value="trier par région" /> Cette extension n a aucun effet avant que l utilisateur presse sur le bouton de tri. Elle ne risque donc pas de causer le moindre problème à la plateforme dévelopée par WnG.
4. LISTE DES CULTES AMÉLIORÉE POUR LA TRIBUNE DE GENÈVE L export pour la Tribune de Genève réalisé par WnG est conforme aux spécifications. Néanmoins, à l usage, l EPG s est rendu compte que plusieurs adaptations étaient nécessaires pour permettre de l envoyer directement pour publication, et ainsi éviter un travail d édition fastidieux et coûteux. Comme WnG n entendait pas effectuer de nouvelles modifications aux exports journaux dans le cadre de ce projet, nous avons réalisé notre propre procédure d export : http://epg.ch/cultes-pour-tribune/ Il existe aussi un deuxième formattage quasiment identique, mais avec un saut de ligne entre chaque lieu : http://epg.ch/cultes-pour-web/ Les différence du résultat par rapport à la procédure fournie par WnG sont les suivantes : Remplacement du champs «description» (trop détaillé) par le champ «remarque», comme utilisé par l EERV (aussi demandé à WnG, ticket #147) Suppression des termes «Paroisse de» en entête de chaque culte Suppression des termes «Temple de», «Centre paroissial de» des noms de lieux Suppression du nom de lieu lorsqu il est identique au nom de la paroisse Regroupement/séparation avec sous-titres pour : Samedi, Samedi Soir, Dimanche, Dimanche soir et Cultes en Semaine (sauf pour Noël, lundi de Pâques, Ascension,... qui sont listés comme des dimanches) Création de renvois automatiques pour les cultes régionaux (chaque paroisse devant être listée), sauf si la paroisse organise aussi un événement au même moment Pour l aumônerie des HUG, le lieu géographique remplace le nom de la paroisse Quelques exception d affichage sur les noms de paroisse : Paroisse des 5 communes, Paroisse suisse-allemande, Céligny-Terre Sainte Exception par rapport au tri alphabétique par paroisse : Paroisse suisse-allemande qui doit être listée tout à la fin Quelques corrections typographique automatiques : majuscules en début des noms propres lorsqu elles manquent, dénomination Sainte-Cène.
5. TABLE DES CULTES PAR RÉGION POUR LA VIE PROTESTANTE L agenda de la Vie Protestante inclut une table des cultes par région et par date. La préparation de cette table était jusqu à présent une opération manuelle particulièrement coûteuse en temps. Toutes les données sur les cultes ayant déjà été extraites pour la réalisation de l export pour la Tribune de Genève, nous avons pu faire une extension qui calcule automatiquement une table des cultes pour tous les services/régions et pour une période donnée. La table signale même les renvois entre les paroisses lors des cultes régionaux si ils ont bien été saisis au niveau du site régional : http://epg.ch/cultes-pour-vp/ La petite flèche dans le coin supérieur gauche de la table permet de transposer automatiquement la table (lignes/colonnes) pour reprendre la convention utilisée par la VP pour les régions :
6. TABELLES RÉGIONALES ET PAROISSIALES POUR LES SITES DES RÉGIONS ET DES PAROISSES Les paroisses et les régions éditent fréquemment leur propre tabelle des cultes à l intention des paroissiens. Puisque nous avons le code permettant de générer les tabelles régionales pour la Vie Protestante, nous en avons aussi fait une version qui pourra être mise à disposition des sites web des régions. Le shortcode pour intégrer la tabelle régionale à une page existante est le suivant : [iframe id="http://epg-dev.ch/cal-region.php?periode=60" aspect_ratio="1:1" maxwidth="1000px"] Le paramètre optionnel «periode=60» précise le nombre de jours à venir que l on veut prendre en compte dans la tabelle. La tabelle est identique à celle de la VP, mais chaque culte peut être clické pour obtenir les détails du culte : Pour les paroisses qui désirent offrir une liste plus épurée avec seulement les cultes de la paroisse (et non des autres régions, sauf rassemblement régional), le shortcode suivant peut être utilisé : [iframe id="http://epg-dev.ch/cal-table.php?periode=60&type=cultes" aspect_ratio="1:1" maxwidth="1000px"]
7. CALENDRIER D ACTIVITÉS POUR LES SITES DES RÉGIONS ET DES PAROISSES Le widget Agenda proposé par WnG est utile pour voir les événements immédiatement à venir, mais il n offre pas pas une bonne vue d ensemble «en un coup d oeil» des événements agendés dans les prochaines semaines. Pour combler ce manque, nous avons réalisé une représentation de type calendrier mensuel qui peut être utilisée par exemple comme un widget de double-largeur sur la page d accueil des paroisses (zone Home : bas gauche), ou sur n importe quelle autre page. Le shortcode pour afficher le calendrier est le suivant (il peut être entré dans un widget Visual Editor si désiré): [iframe id="http://epg-dev.ch/cal-month.php" aspect_ratio="1:2" maxwidth="570px"] Lorsqu on clique sur un événement, les détails s affichent automatiquement dans une fenêtre qui apparaît sur le calendrier.
8. LISTES D ÉVÉNEMENTS PAR THÈMES POUR LES SITES WEB Pour encourager les visiteurs à participer aux activités des Eglises, il est important de donner les informations de dates directement sur les pages où ces activités sont décrites. Or WnG n a pas fournit de shortcode permettant de lister automatiquement des activités selon des critères de recherche prédéfinis sur une page. Nous avons donc réalisé cette fonction nous-même. Par exemple, le shortcode suivant peut être ajouté à une page pour afficher la liste de toutes les prochaines activités d Eveil planifiées: [iframe id="http://epg-dev.ch/cal-list.php?periode=310&type=enfance&titre=eveil" aspect_ratio="1:1" maxwidth="1000px"] Les critères reconnus par l outil sont les suivants : periode=nb_jours type=catégorie(s) titre=mot_clé paroisse=nom_paroisse region=nom_region Les critères doivent être séparés par le code & comme dans l exemple cidessus. Si aucun nom de paroisse/région n est spécifié, c est le site d inclusion qui est utilisé pour filtrer par paroisse, région ou service. Il est possible de spécifier plusieurs catégories, à l aide du signe + pour exiger les deux catégories ou du signe, pour permettre l une des deux catégories. Par exemple, type=culte+famille,enfance montrera tous les événements qui sont - soit des cultes familles - soit de la catégorie enfance