Description
Kleingartenverein24 connects a WordPress site with the Kleingartenverein24 API. Garden clubs can display available or not yet leased garden plots, upcoming work assignments, and upcoming meetings from their tenant account on their public website.
Learn more: Kleingartenverein24 website.
The first feature is a shortcode for available garden plots:
[shortaktien_garten]
Further shortcodes:
[shortaktien_arbeitseinsaetze]
[shortaktien_versammlungen]
The plugin adds a WordPress admin menu named “Kleingartenverein24” where site administrators can configure the API URL, save a tenant-bound API key, and test the connection.
License
This plugin, all included libraries, and all included assets are GPL-licensed or available under a GPL-compatible license.
External service
This plugin connects to the Kleingartenverein24 API at https://kleingartenverein24.de.
API requests are made only after an administrator configures an API key in the plugin settings or runs the connection test. The plugin sends the configured API key as a Bearer token:
Authorization: Bearer kgv_live_...
The API is used to authenticate the tenant and retrieve tenant garden plot, work assignment, and meeting data. A separate X-Tenant-Slug header is not required for tenant-bound API keys.
Service website: Kleingartenverein24
Installation
- Upload the plugin folder to
/wp-content/plugins/kleingartenverein24/. - Activate the plugin through the WordPress “Plugins” screen.
- Open the new “Kleingartenverein24” admin menu.
- Enter the API URL. The default is
https://kleingartenverein24.de. - Enter the tenant-bound API key from Kleingartenverein24.
- Save the settings.
- Run “Authentifizierung testen”.
- Add
[shortaktien_garten],[shortaktien_arbeitseinsaetze], or[shortaktien_versammlungen]to a page, post, or shortcode-compatible block.
FAQ
-
Where do I get the API key?
-
Create or renew the API key in the Kleingartenverein24 settings. The full key is shown only directly after creation or renewal, so copy it immediately.
-
Do I need a tenant slug?
-
No. Tenant-bound API keys are resolved by the API. The plugin only sends the Bearer token.
-
Which shortcode displays available garden plots?
-
Use:
[shortaktien_garten]You can limit the number of cards:
[shortaktien_garten limit="6"] -
Which shortcode displays upcoming work assignments?
-
Use:
[shortaktien_arbeitseinsaetze]You can limit the number of entries:
[shortaktien_arbeitseinsaetze limit="3"] -
Which shortcode displays upcoming meetings?
-
Use:
[shortaktien_versammlungen]You can limit the number of entries:
[shortaktien_versammlungen limit="2"] -
What happens if the API key is invalid?
-
The admin connection test and the frontend shortcode show an error message. API access can also be blocked by the subscription or trial status of the tenant account.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Kleingartenverein24” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Kleingartenverein24” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.3
- Added a unique ShortAktien prefix to all plugin declarations, stored data, hooks, error codes, assets, and shortcodes.
1.0.2
- Renamed the plugin to Kleingartenverein24 and requested the matching WordPress.org slug.
1.0.1
- Updated the plugin version metadata for the WordPress.org resubmission.
1.0.0
- Initial plugin version.
- Added Kleingartenverein24 admin settings page.
- Added tenant-bound Bearer token support.
- Added authentication test against
/api/tenant/session. - Added
[shortaktien_garten]shortcode for available garden plots. - Added
[shortaktien_arbeitseinsaetze]shortcode for upcoming work assignments. - Added
[shortaktien_versammlungen]shortcode for upcoming meetings. - Added responsive frontend card styling.