Extension WordPress Saint-Augustin Paroisse

Des outils et un savoir-faire pour votre communication numérique

Cette extension WordPress ajoutée à votre site internet de paroisse, secteur ou UP vous offre des shortcodes¹ pour que vous puissiez afficher sur votre site:

1. les informations liturgiques
2. les horaires de célébrations de theodia
3. les publications d’une page Facebook
4. les photos/vidéos d’un compte Instagram
5. des boutons vers les réseaux sociaux
6. l’inscription à une newsletter (Sendinblue)
7. un calendrier d’événements locaux
8. un numéro découverte et informations de votre magazine paroissial
9. le login d’accès à l’espace réservés aux abonnés de votre magazine paroissial
10. article-s ou média-s de votre site internet ou de la plateforme presse.saint-augustin.ch
11. affichage d’un pdf

Visitez le site de démo paroisse.saint-augustin.ch !

Consultez également le magazine des nouveautés de L’Essentiel pour 2021 ici !

Voir les instructions d’installation et les différentes versions

¹Un shortcode est un texte raccourci qui peut être placé sur un article, une page ou dans un widget de votre site WordPress. A l’affichage du site web, ce shortcode sera remplacé.

1. Informations liturgiques

Quel site internet de paroisse ne souhaite pas afficher le saint du jour ou le libellé liturgique du dimanche ainsi que les références bibliques de la messe du jour? Mais comment faire sans devoir modifier chaque jour l’information. Ce petit shortcode placé sur votre site internet vous permet de les afficher sans recherche.

Toutes ces données sont mises à jour par Saint-Augustin dans un calendrier Google (voir offre de calendrier liturgique). Pour les saints un lien vers nominis sur la page du saint en question est généré automatiquement et pour les lectures bibliques, un lien vers aelf.org.

Syntaxe:

[liturgy
	format="simple|detailed|complete"
	display-day="yes|no"
	display-readings="yes|no"
	alignment="left|center|right"]

où
	format: (optionnel, "simple" par défaut) du simple affichage du nom du saint ("simple")
		jusqu'à la biographie du saint ("complete")
		en passant par une information complémentaire ("detailed")
	display-day: (optionnel, "yes" par défaut) en indiquant "no" le saint du jour
		ou libellé liturgique du dimanche ne s'affiche pas
	display-readings: (optionnel, "yes" par défaut) en indiquant "no"
		les lectures du jour ne sont pas affichées
	alignment: (optionnel, "center" par défaut), aligné à droite ("right")
		ou à gauche ("left")

Exemples:

2. Horaires theodia

Les horaires de messes (ou autres célébrations) qui se trouvent sur theodia.org sont aisément intégrables sur des sites internet via le menu d’intégration qui produit du code html.
Ici, nous vous proposons une version simplifiée d’intégration pour WordPress sous forme de shortcodes.
Selon vos besoins, nous pouvons vous proposer un support pour la mise à jour de vos données theodia.

Syntaxe:

[theodia
	calendars="numeros_calendriers"
	number="nombre_celebrations"
	display-languages="yes|no"
	display-rites="yes|no"
	height="hauteur"]

où
	calendars: liste des numéros de calendriers, chaque lieu de culte peut avoir plusieurs calendriers,
		un par langue et par rite, pour lesquels les célébrations doivent être affichées,
		le numéro peut être récupéré dans le code d'intégration du calendrier theodia (voir image ci-dessous)
	number: (optionnel, 10 par défaut) nombre de célébrations à afficher
	display-languages: (optionnel, "no" par défaut) en indiquant "yes" les langues des célébrations s'afficheront
	display-rites: (optionnel, "no" par défaut) en indiquant "yes" les rites des célébrations s'afficheront
	height: (optionnel, "100%" par défaut) hauteur de l'affichage, par exemple "600px"

Exemples:

3. Publications d’une page Facebook

Pour l’affichage de vos publications Facebook, nous vous proposons d’utiliser l’excellente extension Smash Balloon Facebook Custom Feed.

4. Publications d’un compte Instagram

Pour l’affichage de vos publications Instagram, nous vous proposons d’utiliser l’excellente extension Smash Balloon Instagram Feed. Seul problème actuel de cette extension, elle ne permet pas de se connecter simultanément à un compte de type Business et un compte de type Personal.

5. Boutons vers les réseaux sociaux

Pour l’affichage de boutons vers les réseaux sociaux: Facebook, Instagram, Whatsapp, Linkedin, etc. pour inviter à partager ou suivre, nous vous proposons d’utiliser l’extension Ultimate Social Media Icons. Ou celle que vous souhaitez.

Si vous souhaitez les afficher au sommet des articles, il suffit de cocher l’option et de saisir le shortcode de l’extension dans les paramètres de Saint-Augustin.

4. Inscription newsletter

Syntaxe:

[newsletter-subscription-form
	title="titre"
	display-title="yes|no"
	title-level="niveau_titre"
	description="description_propos_newsletter"
	button="libelle_bouton"
	button-size="small|medium|large"
	button-width="25percent|half|75percent|full"
	button-text-color="color_for_text"
	button-color="color_for_button"
	button-class="CSS_classes_for_button"
	width="width_of_subscription_form"
	magazin-newsletter="yes|no"]
	list-ids="no_liste_contacts_sendinblue"

où
	title: (optionnel, "S’inscrire à la newsletter" par défaut) Titre de l'invitation
	display-title: (optionnel, "no" par défaut) en indiquant "yes" le titre de l'invitation s'affiche
	title-level: (optionnel, 4 par défaut) Niveau de titre, 1 pour h1, 2 pour h2, etc.
	description: (optionnel, "Recevez un aperçu de votre magazine paroissial par email" par défaut) propos de la newsletter
	button: (optionnel, "Je m'inscris" par défaut) libellé du bouton d'inscription
	button-size: (optionnel, "small" par défaut) taille du bouton
	button-width: (optionnel, "full" par défaut) largeur du bouton
	button-text-color (optionnel, "white" par défaut) couleur du texte sur le bouton, code hexadécimal #000000 ou constante couleur "black"
	button-color: (optionnel, "grey" par défaut) couleur du bouton
	button-class: (optionnel, "button... en fonction de button-size et button-width" par défaut) classes CSS du bouton si vous souhaitez avoir un rendu similaire à celui des autres boutons de votre site (reprenez ici le texte du paramètre class de votre bouton, visible en cliquant avec le bouton droit de la souris sur l'un de vos boutons et en sélectionnant "Inspecter")
	width: (optionnel, "100%" par défaut) largeur du bouton, pourcentage "50%" ou valeur en pixel "300px"
	magazin-newsletter: (optionnel, "no" par défaut) en indiquant "yes" c'est le formulaire d'inscription à la newsletter du magazine qui s'affiche
	list-ids: (optionnel pour la newsletter du magazine, obligatoire sinon, peut être aussi indiqué dans les paramètres de l'extension) numéro de la liste de contacts Sendinblue dans laquelle l'inscription doit être ajoutée

Exemples:

6. Calendrier d’événements locaux

Syntaxe:

[calendar
	calendar-id="google_calendar_id"
	number="nombre_evenements_a_afficher"
	title="titre_agenda"
	display-title="yes|no"
	title-level="niveau_titre"
	display-content="image,description,attachment"]

où
	calendar-id: id du calendrier Google qui se trouve dans les paramètres,
		Exemple: ct75sluq8hcasdfwer5236kc@group.calendar.google.com
	number: (optionnel, 12 par défaut) nombre d'événements à afficher
	title: (optionnel, "Agenda" par défaut)
	display-title: (optionnel, "no" par défaut) en indiquant "yes" affiche le titre du calendrier
	title-level: (optionnel, 4 par défaut) Niveau de titre, 1 pour h1, 2 pour h2, etc.
	display-content: (optionnel, "description" par défaut) spécifie ce qui est à afficher 
		en plus de la date et du titre, options séparées par des virgules:
		"image" pour le premier fichier image joint,
		"description" pour le champ description de l'événement,
		"attachment" pour les éventuelles pièces jointes (pdf)

Exemples:

7. Infos du magazine paroissial

Syntaxe:

[magazin-infos
	plateform="lessentiel|pfarreiblatt"
	magazin="nom_magazine
	title="titre_liste_medias"
	display-title="yes|no"
	title-level="niveau_titre"
	button-epaper="libelle_bouton_decouverte"
	button-subscribe="libelle_bouton_abonnement"
	button-size="small|medium|large"
	button-width="25percent|half|75percent|full"
	button-text-color="color_for_text"
	button-color="color_for_button"
	button-class="CSS_classes_for_button"
	width="width_of_informations"
	display-content="epaper, subscription, editorial-contacts, social-networks"]

où
	plateform: (optionnel, "lessentiel" par défaut) permet de spécifier la plateform,
		celle des journaux français "L'Essentiel, votre magazine paroissial" ou
		celle des journaux germanophones "Pfarrblatt"
	magazin: nom générique pour le magazine (à demander à Saint-Augustin)
	title: (optionnel, "Espace abonné" par défaut) si un article est indiqué,
		il s'affiche dans le niveau de titre indiqué sous title-level
	display-title: (optionnel, "no" par défaut) en indiquant "yes" affiche le titre de l'article ou de la catégorie
	title-level: (optionnel, 4 par défaut) Niveau de titre, 1 pour h1, 2 pour h2, etc.
	button-epaper: (optionnel, "Découvrir" par défaut) libellé du bouton pour découvrir le magazine
	button-subscribe: (optionnel, "S'abonner" par défaut) libellé du bouton pour s'abonner au magazine
	button-size: (optionnel, "small" par défaut) taille des boutons
	button-width: (optionnel, "full" par défaut) largeur des boutons
	button-text-color (optionnel, "white" par défaut) couleur du texte sur les boutons, code hexadécimal #000000 ou constante couleur "black"
	button-color: (optionnel, "grey" par défaut) couleur des boutons
	button-class: (optionnel, "button... en fonction de button-size et button-width" par défaut) classes CSS des boutons si vous souhaitez avoir un rendu similaire à celui des autres boutons de votre site (reprenez ici le texte du paramètre class de votre bouton, visible en cliquant avec le bouton droit de la souris sur l'un de vos boutons et en sélectionnant "Inspecter")
	width: (optionnel, "100%" par défaut) largeur des boutons, pourcentage "50%" ou valeur en pixel "300px"
	display-content: (optionnel, "epaper,subscription,editorial-contacts" par défaut)
		liste des éléments à afficher séparés par des virgules:
		"epaper": image, lien et bouton vers un numéro découverte au format e-paper,
		"subscription": bouton vers formulaire d'abonnement,
		"editorial-contacts": contacts rédactionnels,
		"social-networks": réseaux sociaux et sites internet

Exemples:

8. Login d’accès au magazine numérique

Syntaxe:

[saintaugustin-login
	plateform="lessentiel|pfarreiblatt"
	magazin="nom_magazine"
	title="titre_liste_medias"
	display-title="yes|no"
	title-level="niveau_titre"
	button="libelle_bouton"]
	button="libelle_bouton"
	button-size="small|medium|large"
	button-width="25percent|half|75percent|full"
	button-text-color="color_for_text"
	button-color="color_for_button"
	button-class="CSS_classes_for_button"
	width="width_of_login_form"
où
	plateform: (optionnel, "lessentiel" par défaut) permet de spécifier la plateform,
		celle des journaux français "L'Essentiel, votre magazine paroissial" ou
		celle des journaux germanophones "Pfarrblatt"
	magazin: nom générique pour le magazine (à demander à Saint-Augustin)
	title: (optionnel, "Espace abonné" par défaut) si un article est indiqué,
		il s'affiche dans le niveau de titre indiqué sous title-level
	display-title: (optionnel, "no" par défaut) en indiquant "yes" affiche le titre de l'article ou de la catégorie 
	title-level: (optionnel, 4 par défaut) Niveau de titre, 1 pour h1, 2 pour h2, etc.
	button: (optionnel, "Connexion (abonné)" par défaut) libellé du bouton
	button-size: (optionnel, "small" par défaut) taille du bouton
	button-width: (optionnel, "full" par défaut) largeur du bouton
	button-text-color (optionnel, "white" par défaut) couleur du texte sur le bouton, code hexadécimal #000000 ou constante couleur "black"
	button-color: (optionnel, "grey" par défaut) couleur du bouton
	button-class: (optionnel, "button... en fonction de button-size et button-width" par défaut) classes CSS du bouton si vous souhaitez avoir un rendu similaire à celui des autres boutons de votre site (reprenez ici le texte du paramètre class de votre bouton, visible en cliquant avec le bouton droit de la souris sur l'un de vos boutons et en sélectionnant "Inspecter")
	width: (optionnel, "100%" par défaut) largeur du bouton, pourcentage "50%" ou valeur en pixel "300px"

Exemples:

9. Affichage d’articles ou médias

Ce shortcode permet l’affichage d’articles ou de médias provenant soit de votre site wordpress soit d’un site externe comme celui de presse.saint-augustin.ch. Pour un flux externe, il est nécessaire que ce dernier vous autorise, faites-en la demande auprès du webmaster.

Différents formats sont possibles: sliders, listes de liens, listes d’images-résumés, images-liens vers des articles, etc.

Exemple: l’affichage de liens vers les dernières feuilles dominicales (médias pdfs), en choisissant les bons critères, plus besoin de modifier la page ou article, il suffit de charger le pdf dans les médias.

Syntaxe:

[posts
	url="url_website_externe"
	post-type="post|media"
	id="no_article_a_afficher"
	name="nom_article_a_afficher"
	categories="categories_articles"
	tags="etiquettes_articles"
	search="mots_clefs"
	relation="or|and"
	number="nombre_articles"
	offset="decaler_nombre_articles"
	title="titre_flux_article"
	display-title="yes|no"
	title-level="niveau_titre"
	display-content="title,image,extract|full,category,date"
	display-style="vertical|horizontal|blog|list-links|onmouseover|slider"
	nb-seconds="nb_secondes_par_slide"]

où
	url: (optionnel) url du site externe d'où proviennent les articles et médias à afficher,
		Exemple: https://presse.saint-augustin.ch,
		si non renseigné, les articles et médias proviennent de votre propre site internet
	post-type: (optionnel, "post" par défaut) indique le type de documents à afficher: "post" pour des articles,
		"media" pour des médias (images ou pdfs)
	id: (optionnel) id de l'article à afficher si un seul article
	name: (optionnel) nom (titre) de l'article à afficher si un seul article (à introduire sans accents)
	categories: (optionnel) liste des catégories (slugs) d'articles à afficher, séparés par des virgules
	tags: (optionnel) liste des étiquettes (tags) d'articles à afficher, séparées par des virgules
	search: (optionnel) liste de mots clefs à rechercher dans tous les champs des articles et médias
	relation: (optionnel, "or" par défaut) en précisant "and", seul les articles
		possédant au moins une des étiquettes mentionnées
		et se trouvant dans au moins une des catégories mentionnées seront affichés
	number: (optionnel, 12 par défaut) nombre d'articles à afficher
	offset: nombre d'articles à décaler, si positif..., si négatif...
	title: (optionnel) titre de l'article ou liste d'articles à afficher
	display-title: (optionnel, "no" par défaut) en indiquant "yes" affiche le titre de l'inscription à la newsletter
	title-level: (optionnel, 4 par défaut) Niveau de titre, 1 pour h1, 2 pour h2, etc.
	display-content: (optionnel, "title,image,extract,date" par défaut) spécifie ce qui est à afficher,
		options séparées par des virgules,
		"extract" ou "full" selon que seuls les résumés doivent être affichés ou les articles entiers,
		"image" pour l'image de une,
		"category" pour la catégorie principale de chaque article
		"date" pour la date des articles et médias
	display-style: (optionnel, "horizontal" par défaut) styles d'affichage:
		"horizontal", "vertical", "blog",
		"list-links", "onmouseover" ou "slider"
	nb-seconds: (optionnel, 5 par défaut) nombre de secondes d'affichage des slides
		si l'option slider a été choisie

Exemples:

10. Affichage d’un PDF

Deux possibilités pour l’affichage d’un pdf, soit dans un format standard, à l’intérieur d’une iframe, soit avec un aspect feuilletage de journaux… cet effet n’est pas encore disponible.

Syntaxe:

[document-viewer
	file="url_du_pdf"
	width="largeur"
	height="hauteur"]

où
	file: url complète ou relative du média ("/wp-content/upload/....magazine.pdf"), 
	width: (optionnel, 100% par défaut) largeur de l'affichage du pdf,
		soit en pourcentage (60%), soit en pixels (450px)
	height: (optionnel, 650 par défaut) hauteur en nombre de pixels, exemple "400"

Exemples:

Installer l’extension

1. Après signature d’un contrat avec Saint-Augustin, vous recevrez le fichier d’installation ainsi qu’un accès aux futures mises à jour de l’extension.
2. Ajouter l’extension dans le backoffice de WordPress (en principe vous y accéder en utilisant l’adresse de votre site internet suivie de /wp-admin) dans le menu Extensions/Plugins) et l’activer.
3. Consultez cette documentation pour ajouter ces outils à votre site internet. Cette documentation est accessible depuis la liste des extensions WordPress.
4. Les options par défaut peuvent être modifiées dans les réglages de l’extension via le menu « Saint-Augustin » ajouté à votre Tableau de bord WordPress lors de l’activation de l’extension. Ces paramètres serviront de base aux différents affichages.
5. Pour éviter que des programmeurs malhonnêtes utilisent ce plugin pour des requêtes illicites, il est nécessaire d’enregistrer votre site internet avec un recaptcha.
   Deux possibilités: 1. Via une extension WordPress, telle que Advanced Google reCAPTCHA » que vous installez ou 2. Via notre extension, cochez pour cela l’option dans les paramètres Saint-Augustin après avoir créé une clé: Marche à suivre pour le faire ici.

Définition d’un recaptcha

Pour définir les recaptcha de votre site internet, il est nécessaire d’enregistrer votre domaine (par exemple paroisse.ch) et récupérer la clé du site (pas la clef secrète). Choisissez v2 invisible ou v3.
Pour cela, dirigez-vous sur la console d’administration Google Recaptcha google.com/recaptcha/admin et connectez-vous avec votre compte Google.
Une fois dans votre console, vous aurez le menu ci-dessous:

Versions

1.1.0 En préparation

Un nouveau module payant proposera une interface pour vérifier la disponibilité de salles et faire une demande de réservation.

1.0.5

Correction affichage boutons de différentes tailles.

1.0.4

Correction affichage blog.

Affichage des urls de-s site-s internet sous l’image du magazine.

1.0.3

Inclusion/exclusion des articles des catégories-enfants dans le shortcode [posts].

Le shortcode posts offre un mode d’affichage supplémentaire pour l’affichage du pdf dans son contenu ([posts display-style="pdf-iframe"]).

Possibiilté d’exclure certains articles des sliders (dans le cas de photos de mauvaises qualité par exemple): créer pour cela une catégorie « Ne pas afficher dans le slider » par exemple et avec l’identifiant « no-slider » (à respecter absolûment) et attribuer cette catégorie à ces articles.

Suppression du shortcode Facebook.

Ajout des paramètres de hauteur et de nombre de célébrations pour le shortcode [theodia] dans les paramètres de l’extension.

Un click sur les boutons pour s’abonner ou découvrir le magazine s’ouvent maintenant dans une nouvelle fenêtre ou onglet.

1.0.0 Première version

[packages-server-updates]