PHPackages                             acato/openagenda-base - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. acato/openagenda-base

ActiveWordpress-plugin

acato/openagenda-base
=====================

Adds OpenAgenda to your WordPress website.

1.2.4(2mo ago)10[2 issues](https://github.com/OpenWebconcept/plugin-openagenda-base/issues)PHP

Since Mar 4Pushed 2mo ago4 watchersCompare

[ Source](https://github.com/OpenWebconcept/plugin-openagenda-base)[ Packagist](https://packagist.org/packages/acato/openagenda-base)[ RSS](/packages/acato-openagenda-base/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (42)Used By (0)

OpenAgenda Plugin
=================

[](#openagenda-plugin)

This plugin adds Events and Locations to WordPress which can be retrieved via the OpenAgenda REST API.

Requirements
------------

[](#requirements)

### OpenAgenda

[](#openagenda)

In order to make the OpenAgenda Plugin work, you will need to have a WordPress installation with at least the following installed (and activated):

- [WordPress](https://wordpress.org/)
- [CMB2](https://wordpress.org/plugins/cmb2/)

On this WordPress installation you will have to enable pretty permalinks (Settings > Permalinks > Select any of the options that is not plain).

There are two possible setups for the OpenAgenda, this can be:

1. On the WordPress installation of an existing website.
2. On a completely new WordPress installation.

In all scenarios the OpenAgenda needs to have the following installed (and activated):

- [WordPress](https://wordpress.org/)
- [CMB2](https://wordpress.org/plugins/cmb2/)
- [OpenAgenda Base](https://github.com/OpenWebconcept/plugin-openagenda-base)

With this installed you can use the OpenAgenda Base plugin in your WordPress website.

If you chose for option 2 (new WordPress installation), you will probably need to install a WordPress theme. Since the OpenAgenda plugin is a REST API, it can be used in any WordPress theme.

Installation
------------

[](#installation)

### Manual installation

[](#manual-installation)

1. Upload the `openagenda-base` folder to the `/wp-content/plugins/` directory.
2. Activate the OpenAgenda Base Plugin through the 'Plugins' menu in WordPress.

### Composer installation

[](#composer-installation)

1. `composer source git@github.com:OpenWebconcept/plugin-openagenda-base.git`
2. `composer require acato/openagenda-base`
3. `cd /wp-content/plugins/openagenda-base`
4. `composer install`
5. Activate the OpenAgenda Base Plugin through the 'Plugins' menu in WordPress.

Development
-----------

[](#development)

### Coding Standards

[](#coding-standards)

Please remember, we use the WordPress PHP Coding Standards for this plugin! () To check if your changes are compatible with these standards:

- `cd /wp-content/plugins/openagenda-base`
- `composer install` (this step is only needed once after installing the plugin)
- `./vendor/bin/phpcs --standard=phpcs.xml.dist .`
- See the output if you have made any errors.
    - Errors marked with `[x]` can be fixed automatically by phpcbf, to do so run: `./vendor/bin/phpcbf --standard=phpcs.xml.dist .`

N.B. the `composer install` command will also install a git hook, preventing you from committing code that isn't compatible with the coding standards.

### Translations

[](#translations)

```
wp i18n make-pot . languages/openagenda-base.pot --exclude="node_modules/,vendor/" --domain="openagenda-base"

```

```
cd languages && wp i18n make-json openagenda-base-nl_NL.po --no-purge

```

### Event and Location Custom Post Types

[](#event-and-location-custom-post-types)

This plugin adds two custom post types to WordPress:

- Event
- Location

### REST API Endpoints

[](#rest-api-endpoints)

This plugin adds the following REST API GET-endpoints:

- `/wp-json/owc/openagenda/v1`
- `/wp-json/owc/openagenda/v1/items`
- `/wp-json/owc/openagenda/v1/items/id/{id}`
- `/wp-json/owc/openagenda/v1/fields`
- `/wp-json/owc/openagenda/v1/locations`
- `/wp-json/owc/openagenda/v1/locations/id/{id}`

This plugin adds the following REST API POST-endpoint:

- `/wp-json/owc/openagenda/v1/items`

The POST-endpoint is used to create new items in the OpenAgenda. The endpoint is protected by Basic Authentication with Application Passwords. The user needs to have the capability `edit_posts` to be able to use this endpoint.

In the plugin settings located at `Settings > OpenAgenda Settings` you can set the user that is allocated to items created with this POST-endpoint.

Further documentation about using the REST API can be found in the [OpenAgenda API documentation](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/OpenWebconcept/plugin-openagenda-base/main/openapi/openapi.yaml&nocors).

### Event dates

[](#event-dates)

In the event post type you can set the date(s) for an event with the following date types:

- Specific date or date range
- Configurable recurring date pattern

In both cases after saving the event, the date(s) within the range of the pattern will be generated for the first year and saved as post meta for the event. All generated dates are included in the REST API response.

### Cron jobs

[](#cron-jobs)

This plugin uses two cron jobs:

- `openagenda_cron_event_weekly`: a cron job to generate the recurring dates for the events. The cron job runs once a week on Sunday.
- `openagenda_add_cron_schedule`: a cron job to set the expiration date of an event, based on generated dates of the first cron job. On the expiration date the event will be set to draft. This cron job runs every 15 minutes.

Make sure that the WordPress cron is running on your server. If you have disabled the cron via `define('DISABLE_WP_CRON', true);` in the wp-config.php then make sure you trigger the cron jobs with a server cron job. If you are not sure, you can use the plugin [WP Crontrol](https://wordpress.org/plugins/wp-crontrol/) to check if the cron jobs are running.

### Event Taxonomies

[](#event-taxonomies)

For the event post type you can create your own taxonomies, located at `Events > Create Taxonomies`. These taxonomies are included in the REST API response. When a taxonomy has terms attached to it, the taxonomy can't be deleted.

### Integration with plugins

[](#integration-with-plugins)

This plugin is compatible with the following open source projects:

- [CMB2](https://wordpress.org/plugins/cmb2/)
- [Image Background Focus Position](https://www.wordpress-focalpoint.com/)

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance63

Regular maintenance activity

Popularity2

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~27 days

Recently: every ~77 days

Total

27

Last Release

85d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/29a7a5e8edb1a0cd4de5b52557f5eff0d42c27187542cc7b2c331e84e56315c3?d=identicon)[acato](/maintainers/acato)

---

Top Contributors

[![eyalacato](https://avatars.githubusercontent.com/u/156068891?v=4)](https://github.com/eyalacato "eyalacato (92 commits)")[![richardkorthuis](https://avatars.githubusercontent.com/u/73702842?v=4)](https://github.com/richardkorthuis "richardkorthuis (32 commits)")[![ictbeheer](https://avatars.githubusercontent.com/u/14947039?v=4)](https://github.com/ictbeheer "ictbeheer (5 commits)")

---

Tags

agenda

### Embed Badge

![Health badge](/badges/acato-openagenda-base/health.svg)

```
[![Health](https://phpackages.com/badges/acato-openagenda-base/health.svg)](https://phpackages.com/packages/acato-openagenda-base)
```

###  Alternatives

[elgg/elgg

Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications.

1.7k15.7k5](/packages/elgg-elgg)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[johnbillion/user-switching

Instant switching between user accounts in WordPress and WooCommerce.

19768.3k2](/packages/johnbillion-user-switching)[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[rainlab/user-plugin

User plugin for October CMS

11954.3k13](/packages/rainlab-user-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)