=== Kaartjie Tickets ===
Contributors: kaartjie
Tags: tickets, events, calendar, ticket sales, booking
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show the event calendar and ticket sales of Kaartjie.nl on your own website, in the style of your theme.

== Description ==

Kaartjie.nl (a Dutch ticketing platform) lets you sell tickets for your events. This plugin puts your calendar and ticket sales on your own WordPress site, so visitors buy their tickets without it feeling like another website. The calendar takes over the font and text color of your theme.

* Block "Kaartjie agenda" for the block editor
* Shortcode `[kaartjie]` for pages, posts and page builders
* Widget "Kaartjie agenda" for sidebars and footers
* Optional: a floating "Tickets" button on every page, or a menu item that opens the calendar (a link to #tickets)

Colors, corners, language and calendar or list view are set under "Website" in your Kaartjie dashboard; changes appear on your site within a few minutes.

You need a free Kaartjie account (https://www.kaartjie.nl). The plugin interface is in Dutch.

= Shortcode =

`[kaartjie]` shows the calendar of the name you entered in the settings. Optional attributes: `organizer`, `mode` (inline, button, popup), `view` (auto, calendar, list), `lang` (nl, en, de, fr, es), `accent` (color), `radius` (0, 8, 16, pill), `label`, `position` (left, right).

= External service =

This plugin loads a script (js/shop.js) and the event data from https://www.kaartjie.nl in the visitor's browser, and orders are handled by Kaartjie (payment through Mollie). The visitor's browser therefore connects to Kaartjie (including the IP address). The plugin itself sends no data from your server. Privacy policy: https://www.kaartjie.nl/privacy. Terms of service: https://www.kaartjie.nl/algemene-voorwaarden.

= Security =

* The plugin runs no database queries, makes no connections from your server and writes no files. Only one setting (your Kaartjie name and the choice for a floating button) is stored in your WordPress database.
* All input (settings, shortcode attributes, blocks and widgets) is checked against a fixed list of allowed values and all output is escaped. The settings are only available to administrators (manage_options) and protected with a nonce.
* The script that shows the calendar is maintained by Kaartjie and runs in your visitor's page. You therefore trust Kaartjie with the content of that script, as with any embedded service (payment widgets, maps, video). Kaartjie serves it over HTTPS only (HSTS) and makes browsers check for a new version every five minutes, so a fix is rolled out quickly.
* Found a vulnerability? Email hallo@kaartjie.nl.

== Installation ==

1. Upload the folder `kaartjie-tickets` to `/wp-content/plugins/` or install the zip file via Plugins > Add New > Upload Plugin.
2. Activate the plugin.
3. Go to Settings > Kaartjie Tickets and enter your Kaartjie name (the part after kaartjie.nl/).
4. Add the block "Kaartjie agenda" to a page, or use the shortcode `[kaartjie]`.
5. In your Kaartjie dashboard, under Website, enter the address of your website so visitors return to your own site after paying.

== Frequently Asked Questions ==

= The calendar stays empty. =
Check your Kaartjie name under Settings > Kaartjie Tickets, and whether you have upcoming events that are allowed to appear on your website (a setting per event).

= My page shows a WordPress error about scripts. =
Some security or cache plugins block scripts from other domains. Allow https://www.kaartjie.nl.

== Changelog ==

= 1.0.1 =
* Documentation and code style cleanup (WordPress coding standards, Plugin Check); the script now carries the plugin version in its address.

= 1.0.0 =
* First version: block, shortcode, widget and optional floating button or #tickets links.
