Openagenda

Description

Affichez des agendas depuis https://openagenda.com sur votre site.

Usage courant

This WordPress plugin allows you to embed any calendar hosted on https://openagenda.com on your WordPress site.

Upon activation, the plugin creates a new post type named Calendars. Just create a new calendar, provide the UID of the calendar you wish to display in the calendar settings box, and that’s it !

You can leave the content area for this calendar empty, as it will be populated automatically with your events !

Your events are automatically inserted after your content. If you wish to control where your events will be listed, just use the shortcode [openagenda] in your content.

Réglages

General settings can be found under the Calendar > Settings entry in the admin menu.

All data related to your API key or calendars can be found on https://openagenda.com.

Les réglages sont divisés en deux onglets : Général et Intégrations.

Réglages généraux

La page des réglages généraux propose les réglages suivants :

• Open Agenda API key : Your user API key. Providing your account API key is required for the plugin to work properly. It can be found in your account on https://openagenda.com
• Allow for embedded content : If your events contain embedded content, tick this box to allow the corresponding HTML tags.
• Load default stylesheets : The plugin provides very basic styling and depends heavily on your theme’s styles. Disable this to rely 100% on your theme styles.
• Cache duration : For performance reasons, basic requests to Openagenda are temporarily kept in cache. This settings controls the time to keep them cached, in seconds.
• Delete all calendar content on uninstall ? : controls whether you want to delete all your content on uninstall.
• Delete all options on uninstall ? : controls whether you want to delete all your calendar settings on uninstall.

Réglages des intégrations

Les onglets Integrations vous permettent d’affiner les réglages des différents services tiers utilisés par l’extension.

Réglages de l’intégration OpenStreetmap :

• Default map tiles link : This is the map tile used for the various maps displayed by the plugin.
• Default map tiles attribution link : this is the default attribution link placed on OpenStreetMaps.

Réglages de l’intégration CloudImage :

• Clé CloudImage API  : si vous souhaitez utiliser CloudImage pour servir vos images, saisissez ici la clé del’API.

Réglages des permaliens

Dans les réglages de Permaliens, vous pouvez modifier le préfixe des pages de votre calendrier. Vous ne pouvez pas laisser ce champ vide, car vos URL entreront en conflit avec les pages et les articles par défaut de WordPress.

Réglages de personnalisation

Dans l’outil de personnalisation, un nouveau panneu est disponible pour accueillir divers réglages d’affichage. Pour l’instant, seul un réglage de la couleur principale est disponible.

Widget de filtre et codes courts

Pour permettre aux internautes de trouver facilement des évènements pertinents, l’extension fournit également un widget de filtre pratique. Placez le widget dans votre colonne latérale ou dans toute zone dédiée aux widgets, choisissez un filtre puis modifiez les réglages supplémentaires dans l’écran des widgets.

Pour intégrer les filtres directement dans votre contenu plutôt que dans les zones de widgets, l’extension fournit également des codes courts.

Chaque code court listé ici (excepté pour [openagenda] correspond à une option de filtre dans le widget.

De plus, les codes courts et les filtres de widgets ont les mêmes paramètres, et chaque attribut de code court correspond à un paramètre de filtre de widget.

[openagenda]

Affiche le calendrier. Vous n’avez pas besoin d’utiliser ce code court explicitement, car il est automatiquement injecté dans le contenu de vos articles « calendriers ».

Cependant, si vous avez besoin d’insérer du contenu statique après votre liste d’évènements, vous pouvez le faire en insérant ce code court puis votre contenu statique après.

[openagenda_filter_active]

Affiche les filtres actifs. Aucun paramètre.

[openagenda_filter_choice]

Affiche une liste de choix, selon le champ choisi. Les paramètres suivants sont acceptés :

• field : le slug du champ choisi que vous souhaitez afficher (par exemple : « villes », « mots-clés », « départements », « favoris », etc.).
• additional_field : tout champ personnalis que vous avez configuré dans votre administration OpenAgenda. Fonctionne uniquement quand « Champ additionnel » est le champ choisi.
• page_size : nombre d’options à afficher avant le bouton « Plus d’options ».

Vous pouvez trouver la liste des champs additionnels disponibles dans la section Formulaires des réglages de votre agenda sur openagenda.com (ex : https://openagenda.com/[your-agenda]/admin/schema)

[openagenda_filter_calendar]

Affiche un calendrier. Aucun paramètre.

[openagenda_filter_map]

Affiche une carte interactive pour localiser et rechercher les évènements. Les paramètres suivants sont acceptés :

• map_tiles_link : Map tiles link to use. Defaults to https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
• map_auto : Whether to automatically update map on scroll.

[openagenda_filter_preview]

Affiche les évènements suivants. Les paramètres suivants sont acceptés :

• uid : UID of the calendar you wish to preview.
• size : nombre d’évènements à afficher.
• filters  : chaîne de requête représentant les filtres à appliquer à la requête.

[openagenda_filter_relative]

Allows to filters past or upcoming events. It takes no parameters.

[openagenda_filter_search]

Displays a search field. It takes the following parameters :

• placeholder : text field placeholder.

Personnalisation

Templates for the list of events and individual events can be customized in your theme.

Just create a folder named openagenda/ in your theme, then copy and paste the template you wish to override located in the plugin’s templates/ folder.

The plugin provide convenient template tags for you to display event data in the inc/template-tags.php file. Feel free to define your own in your theme.

The plugin also provides many hooks to allow you to customize the html output or other various data. The hooks documentation is in writing for now !

Usage of third party services and copyright information

This plugin displays data hosted and provided by https://openagenda.com. By using this plugin, you accept and agree with OpenAgenda’s terms and conditions and privacy policy. Please make sure to read them before using this plugin. Also, using this plugin does NOT require an account at https://openagenda.com, though it is recommended to have one.

By default, maps displayed by this plugin use data from https://openstreetmap.org/ and uses the leaflet JS library. By using this plugin, you accept and agree with OpenStreeMap’s terms of use, acceptable use policy and privacy policy

L’extension propose l’intégration facultative de CloudImage. L’intégration requiert de créer un compte sur https://cloudimage.io et d’accepter et signer leurs conditions d’utilisations.

Les icônes utilisées dans l’interface proviennent de Genericons, sous licence GPL 2.0.