Linux 软件免费装
Banner图

OpenAgenda

开发者 openagenda
vincentdubroeucq
更新时间 2024年12月9日 16:47
PHP版本: 7.4.1 及以上
WordPress版本: 6.6.2
版权: GPLv2 or later
版权网址: 版权信息

标签

calendar event events agenda openagenda

下载

2.0.0 2.11.0 2.12.0 2.13.0 2.2.1 2.3.0 2.7.0 2.9.0 0.2.0 2.2.0 1.0.0 1.0.1 2.1.2 1.1.0 2.1.3 2.1.4 2.1.5 2.5.0 2.1.0 2.1.1 2.4.1 2.4.0 2.4.2 2.6.0 2.6.1 2.8.0 0.1.0 2.10.0

详情介绍:

Basic usage 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. Settings 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. The settings are divided into two tabs: General and Integrations. General settings The General settings page provides the following settings : Integrations settings The Integrations tab allows you to fine tune settings for various third party services the plugin uses. OpenStreetmap integration settings : CloudImage integration settings : Permalinks settings In the Permalinks settings, you can change the prefix for your calendar pages. You cannot leave this blank as your URLs will conflict with WordPress' default pages and posts. In the Settings > Reading section, you can set a calendar page as your front page. Note that it will still use the default calendar template provided by the plugin and the default front page template provided by your theme. Customizer settings In the Customizer, a new panel is available to house various display settings. For now only a main color setting is available. If you add Openagenda Filter widgets via the customizer, the preview will not display them immediately. That's simply because filters are initialized on page load and the customizer preview is not always fully refreshed when a setting is changed. Simply publish your settings and refresh the page, or open your agenda page in another tab. Your filter should work just fine. Filter widget and shortcodes To allow users to easily find relevant events, the plugin also provides a convenient filter widget. Place the widget in your sidebar or other widgetized area, pick a filter and tweak any additionnal settings in the widgets admin. To integrate filters directly in your content instead of widget areas, the plugin also provide shortcodes. Every shortcode listed here (except for [openagenda]) corresponds to a filter option in the widget. Additionaly, shortcodes and widget filters have the same parameters, and every shortcode attribute corresponds to a widget filter setting. [openagenda] Displays the calendar. You do not need to use this shortcode explicitely, as it is automatically injected in the content of your "calendars" posts. However, if you need to insert static content after your list of events, you can do so by inserting this shortcode, then your static content afterwards. [openagenda_filter_active] Displays the active filters. It takes no parameters. [openagenda_filter_choice] Displays a list of choices, depending on the field chosen. It takes the following parameters : You can find the list of available additional fields in the Forms section of your agenda settings on openagenda.com (ex: https://openagenda.com/[your-agenda]/admin/schema) [openagenda_filter_calendar] Displays a calendar. It takes no parameters. [openagenda_filter_map] Displays an interactive map to locate and search events. It takes the following parameters : [openagenda_preview] Displays a preview of any calendar. It takes the following parameters : [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 : Customization Templates for the list of events and individual events can be customized in your child theme. If you're not already using a child theme, it is recommended to create one. https://developer.wordpress.org/themes/advanced-topics/child-themes/ Just create a folder named openagenda/ in your child theme, then copy and paste the template you wish to override from the plugin's templates/ folder. Here is a list of templates you can find 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. 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 require an account at https://openagenda.com, and an API key. 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 OpenStreetMap's terms of use, acceptable use policy and privacy policy The plugin provides optional integration with CloudImage. The integration requires to create an account at https://cloudimage.io and accept and agree their terms of use. Icons used in the UI are Genericons, licenced under the GPL 2.0.

屏幕截图:

  • The simple settings page allow you to enter in your API key and tweak various settings.
  • Just create a new calendar post, and provide the OpenAgenda calendar UID in the *Calendar settings* metabox.
  • Find your Calendar UID on the openagenda.com site, just under the sidebar.
  • You can use convenient filter widgets to add filtering functionnality to your calendars.
  • In the *Customizer*, a new panel is available to house various display settings.
  • Enjoy !

常见问题:

Where is the settings page ?

The settings page is located under the Calendar main menu entry, just alongside your content. It is not polluting the main Settings menu entry, or adding any top-level entry.

Where can I find API key and calendar UIDs ?

All data related to your personal account and API keys can be found on your profile page at https://openagenda.com/settings. All data related to calendars can be found on the calendar itself on https://openagenda.com. Just look for the calendar you wish to display, and find the UID in the sidebar, under the filter widgets.

Can I display any calendar ? Even if it's not mine ?

Yes ! No problem ! Just create a new Calendar post, provide its UID and it will work.

Where can I find developer documentation ?

You can find more thorough documentation on https://developers.openagenda.com/extension-wordpress/ (in French) or on the Github repository at https://github.com/OpenAgenda/wordpress

更新日志:

2.13.0 2.12.0 2.11.0 2.10.0 2.9.0 2.8.0 2.7.0 2.6.1 2.6.0 2.5.0 2.4.2 2.4.1 2.4.0 2.3.0 2.2.1 2.2.0 2.1.5 2.1.4 2.1.3 2.1.2 2.1.1 2.1.0 2.0.0 1.1.1 1.1.0 1.0.1 1.0.0 0.2 0.1