=== REC Event Creator ===
Tags: calendar, event, events, organizer, schedule

Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 8.2
License: AGPLv3 or later
License URI: https://www.gnu.org/licenses/agpl-3.0.html

Propose simplified events for your radar.squat.net group directly from a WordPress site.

== Description ==

This is intended to be a simplified interface for non-technical users to propose [radar.squat.net](https://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.

== Frequently Asked Questions ==

= Why can't I upload an image for my event? =

The API of radar has some limitations.
Currently it is not possible to upload images (see [issue #27](https://codeberg.org/rec-event-creator/rec-event-creator/issues/27)).
This should be fixed with the next version of the API.

= Why is it taking so long? =

The squat.net servers are hosting a lot of stuff and sometimes suffer from heavy load and/or external attacks. Some updates on that can be found on the [blog](https://radar.squat.net/en/blog).

= How can I display the events on my WordPress page? =

There are several options to display events on your page. You can find an overview in the [radar manual](https://radar.squat.net/en/show-radar-events-your-website).

== External Services ==

This plugin uses the [radar API](https://radar.squat.net/en/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](https://radar.squat.net/en/api).

== Development ==

If you want to contribute to this project, the repository is located on [codeberg.org](https://codeberg.org/rec-event-creator/rec-event-creator).

= Stack =

This project uses [composer](https://getcomposer.org/) for dependency management and [Nette Forms](https://doc.nette.org/en/forms) to handle form validation/submission logic, it uses [Twig](https://twig.symfony.com/) 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](https://docs.docker.com/engine/install/) 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](https://translate.codeberg.org/projects/rec-event-creator/rec-event-creator/). Contributions are very welcome.

== Screenshots ==

1. The form to create an event proposal.
2. The configuration page for the admin.

== Changelog ==

= 1.0 =
* First release
