內容簡介
Klangagenda Calendar 外掛可將各大日曆（如 Google Calendar、Apple Calendar、Microsoft 365）以議程列表形式顯示，方便用戶查看即將舉行的活動。此外掛免費提供，並可協助用戶在地區內推廣音樂會。
【主要功能】
• 支援多種日曆顯示格式
• 提供簡單的短碼使用方式
• 自動處理重複事件（RRULE）
• 顯示「載入更多」按鈕以獲取更多活動
• 可選擇顯示票務按鈕
外掛標籤
開發者團隊
原文外掛簡介
Displays a calendar (Google Calendar, Apple Calendar/iCloud, Microsoft 365 /
Outlook Calendar, or Konzertmeister – via iCal/ICS link) as an agenda list,
in the style of “date box on the left, title/date/time/location/description
on the right”. No click behavior (no modal, no redirect) – text remains
normally selectable/copyable.
Provided free of charge by KlangAgenda.de – on
Klangagenda.de you can promote your concerts free of charge across your
region, book rehearsal and concert venues, and offer your own space to
others to make better use of it.
All settings (including a detailed step-by-step guide for each calendar
provider) are available in the WordPress backend under the dedicated
top-level menu “Klangagenda Kalender” (with its own calendar icon).
Shortcodes
[klangagenda]
Shows all upcoming events (including recurring ones, e.g. weekly
rehearsals).
[klangagenda_no_recurring]
Shows upcoming events WITHOUT recurring events (e.g. only
concerts/special events, no weekly rehearsals).
[klangagenda_konzerte]
Shows only events whose title contains the word “Konzert” (German for
“concert”, case-insensitive), e.g. “Winterkonzert”, “Sommerkonzert”,
“Adventskonzert”. By default shows neither a date badge nor a
description per event – instead, the description of the first (next)
event is shown once at the top of the whole list.
By default, this shortcode shows no “Buy tickets” button per event.
The attribute ticket_button="ja" turns this on. beschreibung="nein"
hides the intro description at the top, and badge="ja" shows the date
badge per event:
[klangagenda_konzerte ticket_button="ja" badge="ja" beschreibung="nein"]
“(+)”/”(-)” markers (e.g. from Konzertmeister sync) are automatically
stripped from event titles in all shortcodes.
All shortcodes accept an optional count attribute, e.g.
[klangagenda count=”5″]. If omitted, the default count from the
plugin settings is used.
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_konzerte 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] and [klangagenda_no_recurring] automatically show 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). The button does not appear on the
[klangagenda_konzerte] shortcode and can additionally be hidden
explicitly 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.
