| 开发者 | klangagenda |
|---|---|
| 更新时间 | 2026年11月21日 00:36 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
ansicht, count, sparte, beschreibung, datum, datum_pos, details, bild, spalten, farbe or the on-page toolbar.[klangagenda variante="startseite"].[klangagenda ansicht="liste|agenda|karten|kacheln|monat|woche|naechstes|zeitleiste|kompakt"], options datum="badge|block", datum_pos="links|rechts", details="ja|nein", bild="ja|nein", spalten="2|3" (tiles) and farbe="#2B3A55". Shortcode attributes override the on-page toolbar, which overrides the backend setting. The month view loads the current month on the server (links stay crawlable) and pages with a small script; without JavaScript use ?klanca_monat=2027-04. The week view pages with plain links (?klanca_woche=2027-04-12).
Shows the upcoming events. When logged in as an administrator, a bar
"Ansicht einstellen" appears above the list: show/hide concerts,
rehearsal weekends and other events, number of events, date range, and
hide date badge, label, ticket button, "Save event", "Subscribe
calendar", "More events" and the klangagenda.de note. Individual events
can be hidden per view. Settings are stored per placement (page + order
or a fixed id="..." attribute).
"(+)"/"(-)" markers (e.g. from Konzertmeister sync) are automatically
stripped from event titles.
The attribute count sets the number of events, e.g.
[klangagenda count="5"]. If omitted, the default count from the
plugin settings is used.
Older shortcodes from previous versions (klangagenda_konzerte,
_probenwochenende, _ohne_proben, _sonstige, _no_recurring) keep
working but are no longer documented.
Concerts in your region: [klangagenda_stadt]
[klangagenda_stadt stadt="Tübingen"] shows upcoming concerts of a city
from KlangAgenda as a simple list with plain links to the event pages on
klangagenda.de. No connection and no KlangAgenda account are needed.
Examples: [klangagenda_stadt plz="72070" umkreis="25" anzahl="5"],
[klangagenda_stadt ensemble="studentenorchester-tuebingen" art="alle"].
Attributes: stadt, plz + umkreis (km, 1-200), ensemble, art
(konzerte or alle), anzahl (1-50), titel (heading), bild="ja"
(small event image), leer (text if there are no events),
neues_fenster="ja" and link_alle="ja" (adds a link "All concerts in ...
on KlangAgenda" below the list; off by default - we would be happy if you
switch it on).
The list is rendered on the server as plain HTML (no JavaScript, no
structured data, no event descriptions). Results are cached for one hour per
filter; if KlangAgenda cannot be reached, the last successful result is shown.
External services
The shortcode [klangagenda_stadt] requests public event data from
KlangAgenda (https://klangagenda.de/api/v1/public/events). Data sent: only
the filter values of the shortcode (city, postcode, radius, ensemble, type,
number) and, in the User-Agent header, the plugin version and the address of
your website. Requests happen when a page with the shortcode is displayed,
at most once per hour per filter. No visitor data is sent. Service by
KlangAgenda.de: Privacy policy -
Imprint.
The shortcode [klangagenda_fest] without a connection requests https://klangagenda.de/api/v1/public/fest (only when a page with the shortcode is displayed, at most every 15 minutes per festival, every 5 minutes while it is running). Data sent: the shortcode parameter (festival or ensemble) and, in the User-Agent header, the plugin version and your website address. With a connection, the programme arrives with the regular synchronisation - no additional requests.
The optional connection to the Klangagenda Hub (backend, tab "Verbindung")
sends your events and organisation details to klangagenda.de only after you
connect your site and agree in the backend.
Festival programme: [klangagenda_fest]
Shows the programme of your festival (time slots, guest bands, stages) that you maintain once on KlangAgenda. With a connection to KlangAgenda, [klangagenda_fest] without attributes shows your next (or currently running) own festival; in the event list [klangagenda] festivals get an expandable "Programme" line (switch it off in the administrator bar). Without a connection: [klangagenda_fest termin="sommerfest-musterdorf-2027"] or [klangagenda_fest ensemble="musikverein-musterdorf"].
Attributes: termin, ensemble, titel, kopf (date, venue, admission; default yes), logos (yes), buehne (auto, ja, nein), tag (e.g. 2027-07-18), jetzt (line "Jetzt auf der Bühne" during the festival, yes), link_fest (link "Alle Infos auf KlangAgenda"; off by default - we would be happy if you switch it on), leer.
All days are in the HTML (readable without JavaScript); a small script adds day tabs and the "now on stage" line. Only confirmed programme items are shown; no fees or internal notes.
Fixed date window per post (ab / bis)
Normally the shortcodes automatically show the next upcoming events
from now on. For the typical workflow (one post per concert
tour/period; once it's over the post moves into the archive and a new
post with the next dates is created), there are optional attributes
ab (from) and bis (until) (format YYYY-MM-DD):
[klangagenda ab="2026-09-01" bis="2026-09-14"]
This makes this specific post permanently show exactly the events in
this time window – even once they're in the past. ab and bis can
also be used individually.
"Load more" button
[klangagenda] automatically shows a "Mehr Termine" (load more) button
below the list whenever more events are available beyond the currently
shown count. Clicking it loads more events via AJAX (no page reload). It
can be hidden in the administrator bar or via [klangagenda button="nein"].
"orchestriert von klangagenda.de"
Below each event list (or below the "load more" button, if present),
a subtle, light-gray, centered note "orchestriert von klangagenda.de"
linking to https://klangagenda.de can be shown. It is switched off by
default and only appears after a site administrator actively ticks the
checkbox in the backend under "Klangagenda Kalender"; when it is off,
the line is removed from the HTML completely.
Recurring events (RRULE)
RRULE processing covers the common patterns (daily/weekly/monthly/
yearly, interval, count, end date, weekdays). Recurring events without
an end date are pre-calculated up to the configured time horizon
(default 12 months), and continued automatically on the next sync.
Ticket button
The button appears when the title contains "konzert" and the
description contains an http(s) link. Only the first link found is
used.
[klangagenda]) into a page or
post.No, the plugin is free and provided by KlangAgenda.de.
Any calendar that offers a public iCal/ICS subscription link: Google Calendar, Apple Calendar (iCloud), Microsoft 365 / Outlook Calendar, and Konzertmeister. Both https:// and webcal:// links are accepted directly.
Automatically every 30 minutes via WP-Cron, plus immediately after saving the settings or via the "Jetzt synchronisieren" button.
ansicht="naechstes"), "Timeline" (zeitleiste), "Compact" (kompakt) and "Week" (woche). They take colour, genre, number of events and the buttons from your settings; selectable in the backend, in the shortcode builder and in the on-page toolbar.[klangagenda variante="startseite"]. Attributes in the shortcode override the variant.[klangagenda_stadt] now shows the KlangAgenda (Agenda) view by default, using your colours (or farbe="#..."). The previous list is still available with ansicht="liste".[klangagenda_stadt ansicht="agenda"] takes description, month headings and follow bell from the general settings unless set per shortcode.ansicht="agenda") - cards like the KlangAgenda home list: date block, title, ensemble, time and place, room; multi-day events appear once with start-end in the date block ("Day 2/4" while running); labels for cancelled, postponed and members-only; optional "Follow" bell; month headings. Also for [klangagenda_stadt ansicht="agenda"]. Uses the new API fields (time_label, date_block, room, status, organizer_color) as soon as KlangAgenda delivers them, otherwise calculates from start/end.[klangagenda_mitmachen] - "Join us" button linking to your ensemble's sign-up page on KlangAgenda, or (form="yes") the sign-up form embedded directly. Fields come from KlangAgenda; entries are passed on without being stored in WordPress. Shows nothing if the function is switched off in the hub. Attributes: ensemble, form, text.sparte="..." / kinder="1" on all shortcodes and in the on-page toolbar. Optional schema.org markup for search engines.programm="no".[klangagenda_stadt] searches within 50 km by default when stadt or plz is given (umkreis="0" = exactly that city); one-time notice for existing pages.farbe="#...".ansicht, datum, datum_pos, details, bild, spalten, farbe; the on-page toolbar has a new section "Ansicht".klangagenda-calendar/v1/monat for paging through months in the month view.programm with days, stages, programm_edit_url). Link "Programm bei KlangAgenda bearbeiten" opens the event directly on KlangAgenda; the programme is also applied to festivals that exist as your own calendar/plugin events.[klangagenda] festivals get an expandable "Programme" line (detail view: own section; switchable in the administrator bar), "Save event" includes the programme. New shortcode [klangagenda_fest] for a festival page, also without a connection via the public interface.[klangagenda_stadt] now always aligns its entries to the left; centered themes no longer mix centered and left-aligned lines.reduced.[klangagenda_stadt] shows upcoming concerts of a city or region from KlangAgenda as a plain, server-rendered list with links to the event pages (no connection or account needed; cached for one hour, last result kept on errors). Optional link "All concerts ... on KlangAgenda" via link_alle="ja" (off by default). Added the "External services" disclosure and an uninstall routine for the cache.[klangagenda]. Logged-in administrators get a bar above the list to show/hide concerts, rehearsal weekends and other events, set the number of events, and hide the ticket button, "Save event" button, "Subscribe calendar", "More events" button and the klangagenda.de note, plus rehearsals and recurring events. Settings are stored per placement (page + order, or a fixed id="..." attribute).klangagenda_konzerte, _probenwochenende, _ohne_proben, _sonstige, _no_recurring) keep working but are deprecated.class_override).[klangagenda_ohne_proben] now always keeps events with "Wochenende" in the title (e.g. rehearsal weekends) visible; all other titles containing "Probe" (e.g. "Stimmprobe") stay hidden.[klangagenda_ohne_proben] shows all events except rehearsals (title contains "Probe"); rehearsal weekends stay visible.abonnieren="nein" (hides the "Subscribe calendar" button) and hinweis="nein" (hides the "orchestriert von klangagenda.de" note) per shortcode. The global settings still apply.[klangagenda_probenwochenende] and the combined list with concerts.
This also covers synced calendar events that have no category.[klangagenda_konzerte probenwochenende="ja"] (or
[klangagenda_probenwochenende konzerte="ja"]). The combined list uses the
normal card layout.DTSTART;TZID=Europe/Berlin:20260108T193000) is converted to the website's
WordPress time zone, UTC values (Z) likewise, and values without a
time zone count as local time. Previously the TZID was ignored, which
showed wrong times whenever the calendar's time zone differed from the
website's.ics_ IDs) - the Hub reads the link itself. This avoids duplicates and
unnecessary transfers; only "Eigene Termine" are sent in that case.invalid_grant) and shows a dedicated notice in the backend asking to
reconnect - without deleting any local settings or events.[klangagenda_konzerte], eligible for the "Tickets kaufen" button),
regardless of what the title says.[klangagenda_konzerte] only): an all-day event (e.g. an internal
schedule imported from Konzertmeister) could end up as the detached intro
description shown once above the whole list, instead of within its own
event card. All-day events are now excluded from that intro selection and
instead show their description normally under location/date in their own
card, like on the other shortcodes.[google_agenda] / [google_agenda_no_recurring]
/ [google_agenda_konzerte] shortcode aliases introduced in 2.0.0;
please switch any existing pages to [klangagenda] /
[klangagenda_no_recurring] / [klangagenda_konzerte].klanca_ /
KLANCA_ prefix; settings from the predecessor plugin are migrated
automatically on activation.wp_enqueue_style() /
wp_enqueue_script() instead of inline <style>/<script> tags.plugins_loaded to
wp_enqueue_scripts to avoid a WordPress notice ("headers already
sent") when saving other forms.ab/bis) per post.