=== 4planning Sync ===
Contributors: 4planning
Requires at least: 6.0
Tested up to: 6.5
Stable tag: 1.5.6
License: GPLv2 or later

Synchroniseert openbare nieuwsberichten, evenementen en sponsoren vanuit 4planning naar WordPress.

== Installatie ==
1. Upload de ZIP via Plugins > Nieuwe plugin > Plugin uploaden.
2. Activeer de plugin.
3. Ga naar 4planning Sync.
4. Vul het APP-ID / omgeving ID in dat ook voor nieuws en evenementen wordt gebruikt.
5. Klik op Alles synchroniseren.

De plugin synchroniseert daarna automatisch eenmaal per dag. Handmatig synchroniseren blijft mogelijk via 4planning Sync.

== Nieuws shortcodes ==
[4planning_news_loop]
Toont een responsive nieuwsloop met afbeelding, publicatiedatum, titel, korte samenvatting en een link naar het volledige nieuwsbericht. De nieuwste berichten worden als eerste weergegeven.

Optionele kenmerken:
[4planning_news_loop limit="6" columns="3"]

De bestaande shortcode [4planning_news] gebruikt dezelfde weergave.

[4planning_news_detail]
Toont een complete responsive nieuwsdetailpagina met foto, titel, publicatiedatum, samenvatting en volledige inhoud.

Gebruik op basis van het externe nieuws-ID:
[4planning_news_detail id="123"]

Gebruik op basis van het WordPress bericht-ID:
[4planning_news_detail post_id="456"]

== Evenementen shortcodes ==
[4planning_events_loop]
Toont een responsive evenementenloop met afbeelding, titel, datum en tijd. De loop wordt gesorteerd op startdatum en toont standaard maximaal 200 evenementen. Een evenement verdwijnt zodra de einddatum en eindtijd voorbij zijn.

Optionele kenmerken:
[4planning_events_loop limit="200" columns="3"]

De bestaande shortcode [4planning_events] gebruikt dezelfde weergave.

[4planning_event_detail]
Toont een complete responsive evenementpagina met afbeelding, titel, datum, starttijd, eindtijd, locatie en omschrijving.

De call-to-action wordt automatisch bepaald:
* Openbare tickets beschikbaar: knop Tickets bestellen.
* Geen openbare tickets, maar openbaar aanmelden is mogelijk: knop Aanmelden.
* Geen tickets en geen openbare inschrijving: geen knop.

Gebruik op basis van het externe event-ID:
[4planning_event_detail id="123"]

Gebruik op basis van het WordPress bericht-ID:
[4planning_event_detail post_id="456"]

== Sponsoren shortcodes ==
[4planning_sponsors_page]
Toont een complete sponsorpagina. Sponsoren worden automatisch gegroepeerd op basis van de sponsorpakketten van het ingestelde APP-ID / omgeving ID. Pakketnamen worden als duidelijke kop weergegeven, bijvoorbeeld Goud sponsoren. De pakketvolgorde uit 4planning wordt gebruikt wanneer die beschikbaar is. Anders sorteert de plugin intern op pakketbedrag en vervolgens op pakketnaam. Sponsorbedragen worden nooit op de website getoond. Het hoogste pakket staat bovenaan en krijgt grotere sponsorblokken dan de lagere pakketten.

Optionele kenmerken:
[4planning_sponsors_page intro="Dank aan onze sponsoren" show_package_titles="yes" top_columns="3" middle_columns="4" small_columns="5" new_tab="yes"]

[4planning_sponsors_carousel]
Toont alle beschikbare sponsorlogo's in een automatisch doorlopende carousel. De carousel bevat uitsluitend de logo's, zonder achtergrond, rand, schaduw of afgeronde hoeken. Op desktop zijn standaard acht logo's tegelijk zichtbaar. Op tablet en mobiel wordt het aantal zichtbare logo's automatisch aangepast.

Optionele kenmerken:
[4planning_sponsors_carousel visible="8" speed="42" gap="18" new_tab="yes"]

[4planning_sponsors_loop]
Toont een eenvoudig responsive sponsoroverzicht met logo en sponsornaam. Wanneer een websiteadres aanwezig is, wordt het sponsorblok klikbaar.

Optionele kenmerken:
[4planning_sponsors_loop limit="12" columns="4" show_name="yes" show_package="no" new_tab="yes"]

Alternatieve shortcode:
[4planning_sponsors]

== Datum- en tijdnotatie ==
Datums worden weergegeven als dag-maand-jaar, bijvoorbeeld 22-07-2026.
Tijden worden weergegeven als uur:minuten, bijvoorbeeld 19:30.

== Responsive weergave ==
De nieuws- en evenementenloops tonen standaard drie kolommen op desktop, twee op tablet en één op mobiel. Sponsoren tonen standaard vier kolommen en schalen automatisch terug op kleinere schermen.

== Belangrijk ==
Nieuws, evenementen en sponsoren worden beheerd via 4planning. Nieuwe items aanmaken of aanpassen in WordPress is geblokkeerd.

== Changelog ==
= 1.5.6 =
* De evenementenloop toont standaard maximaal 200 evenementen in plaats van 6.
* De limiet van de evenementenloop is begrensd op maximaal 200 items.
* Na iedere succesvolle evenementen-API-check worden lokale evenementen die niet meer in de API staan naar de WordPress-prullenbak verplaatst.
* Bij een API- of JSON-fout worden bestaande evenementen niet verwijderd.

= 1.5.5 =
* De knop Tickets bestellen in [4planning_event_detail] wordt uitsluitend getoond wanneer heeft_publieke_tickets true is.
* De ticketknop gebruikt de ticket_url uit de evenementen-API.
* Openbare tickets houden voorrang op openbare inschrijving.

= 1.5.4 =
* Evenement-CTA leest ticket- en inschrijfstatus nu ook uit de opgeslagen ruwe API-response.
* CTA-vlaggen worden bij synchronisatie expliciet als 1 of 0 opgeslagen.
* Compatibiliteitsfallback via cta_type wanneer het nieuwe ticketveld volledig ontbreekt.

= 1.5.3 =
* De knop Tickets bestellen gebruikt bij openbare tickets altijd de vaste 4planning-link op basis van het event-ID.
* De ticketknop is niet langer afhankelijk van ticket_url of detail_url uit de API.

= 1.5.2 =
* De algemene titel Onze sponsoren is verwijderd uit de sponsorpagina.
* Sponsornamen worden niet meer onder de logo's op de sponsorpagina getoond.
* Evenementknoppen volgen nu strikt de API: heeft_publieke_tickets=true toont Tickets bestellen; anders toont inschrijving_open=true Aanmelden; in alle andere gevallen wordt geen knop getoond.

= 1.5.1 =
* Sponsorbedragen kunnen niet meer via een shortcode zichtbaar worden gemaakt en blijven uitsluitend intern beschikbaar voor sortering.
* JSON-pakketnamen zoals {"naam":"Goud","kleur":null,"rang":0} worden correct gelezen.
* Pakketkoppen worden aangevuld tot bijvoorbeeld Goud sponsoren.
* De rang uit het pakketobject wordt gebruikt voor de pakketvolgorde wanneer geen apart volgordeveld aanwezig is.
* De sponsorcarousel toont alleen logo's en heeft geen achtergrond, rand, schaduw of afgeronde hoeken.
* Sponsoren zonder logo worden niet als lege placeholder in de carousel opgenomen.

= 1.5.0 =
* Nieuwe sponsorpagina-shortcode [4planning_sponsors_page].
* Sponsoren worden automatisch per pakket gegroepeerd op basis van het ingestelde omgeving ID.
* Hogere sponsorpakketten worden bovenaan en groter weergegeven.
* Ondersteuning voor platte sponsorresponses, geneste pakketten en losse pakket-/sponsorlijsten.
* Nieuwe doorlopende logo-carousel [4planning_sponsors_carousel] met standaard acht zichtbare logo's.
* De link Documentatie is verwijderd uit het WordPress pluginoverzicht.

= 1.4.0 =
* Nieuwe sponsor-API toegevoegd met hetzelfde APP-ID / omgeving ID als nieuws en evenementen.
* Nieuwe shortcodes [4planning_sponsors_loop] en [4planning_sponsors].
* Sponsoroverzicht toegevoegd aan het WordPress-beheer.
* Evenementdetail ondersteunt de nieuwe API-velden voor openbare tickets en openbare inschrijving.
* De evenementknop toont automatisch Tickets bestellen, Aanmelden of geen knop.
* Plugin-auteur gewijzigd naar 4planning met link naar 4planning.nl.
* Link Documentatie toegevoegd aan het pluginoverzicht (verwijderd in versie 1.5.0).

= 1.3.2 =
* Afbeeldingen in de nieuws- en evenementenloops worden vanuit het midden uitgesneden.

= 1.3.1 =
* Afbeeldingen op nieuws- en evenementdetailtemplates worden volledig weergegeven zonder uitsnede of afgeronde hoeken.
