REC Event Creator

外掛說明

This is intended to be a simplified interface for non-technical users to propose radar.squat.net events using a specified group.
As admin, you can configure a location and select a list of options for tags.
The form can be displayed anywhere on your WordPress page by simply including the shortcode [recevcr-event-creator].
Events created with the form will be listed as proposals in your radar dashboard where you can moderate them.

External Services

This plugin uses the radar API to create events. The event data is submitted directly to the API, and no data is stored on the server.
To be able to display a list of possible event locations and tags, the plugin makes requests to the radar API.

Development

If you want to contribute to this project, the repository is located on codeberg.org.

Stack

This project uses composer for dependency management and Nette Forms to handle form validation/submission logic, it uses Twig to make the form rendering more straightforward.

Setup

1. There is a container setup including WordPress, MariaDB and phpMyAdmin for local development and testing. Simply install docker and run docker compose up. The containers will start up and give you access to the local instance.
2. On first boot you need to configure the WordPress installation when opening the url. If you messed something up and want a fresh start, simply remove the volume that contains the wordpress installation.
3. For the plugin to work, you need to install the necessary php libraries. Execute docker compose exec -w /var/www/html/wp-content/plugins/rec-event-creator wordpress composer install while the docker setup is running.
4. The plugin code is mounted via volumes in the plugin directory of the WordPress installation. So it can be activated in the admin interface and every change in the repository code is directly available in the docker container.
5. Configure and use the plugin as described in the usage section.

Translation

Translations are done on translate.codeberg.org. Contributions are very welcome.