Program Planner DOCS & HILFE

CSV-Schnittstelle & Backup

Ein ganzes Programm aus Excel oder Google Sheets übernehmen – und jederzeit wieder als Sicherung exportieren. Ab etwa dreißig Programmpunkten sparen Sie mit einer Tabelle mehr Zeit, als der Umweg kostet. Sie finden alles unter Veranstaltungen → Import / Export.

Die Seite „Import / Export“: links Import mit Muster-Vorlage und Ziel-Veranstaltung, rechts die beiden Export-Varianten; darunter der eigene Bereich für Sprecher.

Die Seite hat drei Bereiche: Veranstaltungen, Sprecher (eigene Datei, siehe Sprecher importieren) und – nur für Administratoren – Einstellungen sichern & wiederherstellen.

Der Ablauf in fünf Schritten

  1. 1
    Muster-Vorlage laden

    „Muster-Vorlage laden (.csv)“ liefert alle Spalten und zwei Beispielzeilen – eine Haupt- und eine Unterveranstaltung.

  2. 2
    Ausfüllen

    Ihre Programmdaten in die Spalten eintragen. Spalten, die Sie nicht brauchen, dürfen Sie löschen – fehlende Spalten und leere Zellen lassen vorhandene Angaben unangetastet.

  3. 3
    Als CSV UTF-8 speichern

    In Excel ausdrücklich „CSV UTF-8 (durch Komma getrennt)“ wählen. Die Variante „CSV (Trennzeichen-getrennt)“ zerstört die Umlaute. Eine .xlsx-Datei wird nicht angenommen.

  4. 4
    Hochladen

    Datei wählen, bei Bedarf eine Ziel-Veranstaltung, „Import starten“. Am Ende meldet das Plugin, wie viele Einträge angelegt und wie viele aktualisiert wurden.

  5. 5
    Im Dashboard prüfen

    Der Datenqualitäts-Check zeigt sofort, ob Zeiten, Orte oder Bilder fehlen.

Was die Datei erfüllen muss

RegelBedeutung
KopfzeileDie erste Zeile enthält die Spaltennamen. Zugeordnet wird nur über den Namen, Groß- und Kleinschreibung und Reihenfolge spielen keine Rolle. Fehlt die Spalte title, bricht der Import mit einer Fehlermeldung ab, statt nach Position zu raten.
TrennzeichenKomma, Semikolon oder Tabulator – erkennt der Import selbst.
ZeichensatzUTF-8. Jeder Export des Plugins ist bereits UTF-8 mit Kennung, damit Excel die Umlaute richtig anzeigt.
SicherheitNur echte .csv-Dateien. Enthält die Datei Programmcode, Skripte oder HTML-Seiten, wird sie abgelehnt.

Wie das Plugin Doppelte vermeidet

  1. 1
    Über die event_id

    Steht in event_id ein Wert, wird der Programmpunkt mit genau dieser ID aktualisiert.

  2. 2
    Über den Titel

    Ohne passende ID sucht das Plugin einen Programmpunkt mit exakt gleichem Titel – veröffentlicht, geplant, privat oder als Entwurf. Ist event_id in der Datei leer, wird er aktualisiert und behält seine ID. Steht dort eine andere ID, als der Programmpunkt trägt, gilt er nicht als Treffer.

  3. 3
    Sonst neu

    Findet sich nichts, entsteht ein neuer Eintrag – mit der ID aus der Datei oder, ist die Zelle leer, mit der nächsten freien ID. Das Plugin setzt Ihren Nummernkreis fort: Gibt es WMK2026-074, folgt WMK2026-075; ohne Vorbild beginnt es bei EVT-001.

Sprechende IDs vergeben

Mit eigenen IDs wie TAG1-001 können Sie dieselbe Datei beliebig oft hochladen und aktualisieren immer dieselben Einträge, statt das Programm zu verdoppeln.

Die Ziel-Veranstaltung

Wählen Sie über dem Datei-Feld eine Hauptveranstaltung, werden alle Zeilen ihr zugeordnet – egal, was in parent_event_id steht. Der schnellste Weg, eine Liste ohne Hierarchie-Spalte einzuhängen. Bleibt die Auswahl auf „– Aus CSV oder neu erstellen –“, entscheidet die Datei: parent_event_id verweist auf die event_id (oder den Titel) der Hauptveranstaltung.

Die Spalten der Veranstaltungsdatei

SpaltePflichtFormat und Bedeutung
event_idneinEindeutiger Schlüssel für spätere Aktualisierungen; wird bei Bedarf vergeben.
parent_event_idneinevent_id der Hauptveranstaltung.
titlejaName des Programmpunkts. Zeilen ohne Titel werden übersprungen.
statusneinpublish, draft, pending, private oder future (auch „Entwurf“, „privat“, „geplant“ …). Füllt der Export aus. Leer lässt den bisherigen Status.
datejaJJJJ-MM-TT, z. B. 2026-10-17.
start_timejaHH:MM, z. B. 10:30.
end_timeneinHH:MM – dringend empfohlen.
venueneinName des Ortes; fehlende Orte werden angelegt.
categoryneinKategorien, mehrere mit Semikolon: Vortrag; Keynote.
short_descriptionneinAuszug für Kachel, Liste und Zeitplan.
full_descriptionneinVolltext der Detailansicht; einfaches HTML wie <b>, <br>, <ul><li> ist erlaubt.
image_urlneinDirekte Bildadresse. Liegt das Bild schon in der Mediathek, wird es verknüpft, sonst heruntergeladen.
external_linkneinExterne Adresse für Direktlink oder „Weitere Informationen“.
show_detailsneinKlick-Aktion: page, external oder none (auch 1/0, yes/no).
link_targetnein_self oder _blank.
role_type, role_name, role_urlneinRolle, Name und Profil-Adresse der ersten Person. Fehlende Rollen werden angelegt.
languageneinSprache, z. B. „Deutsch, Englisch“.
ticket_url, ticket_hideneinTicket-Adresse (geht der der Hauptveranstaltung vor); 1 blendet das Ticket-Symbol aus.
website, shop, instagram …neinEine Spalte je Plattform (24 Plattformen) plus email. Kurzformen wie @name werden ergänzt, eine Telefonnummer in whatsapp wird zum Chat-Link.
internal_info_urlneinInterne Infoseite; auch Pfade wie /programm-info/.
speakersneinWeitere Personen ab der zweiten – Aufbau unter Sprecher importieren.
tags–Reserviert; wird exportiert, aber nicht ausgewertet.
Nicht in der CSV

Der Absage-Schalter, Preise, die Hauptkategorie und der Aussteller-Eintrag werden über die CSV weder exportiert noch importiert. Setzen Sie Absagen über den Master Editor oder die Bearbeitungsmaske.

Was ein Import überschreibt – und was nicht

Beim Aktualisieren gilt eine einfache Regel: Ein Import löscht nie etwas. Geschrieben wird nur, was in einer Zelle steht.

FallErgebnis
Spalte fehlt in der DateiDas Feld bleibt unverändert.
Spalte vorhanden, Zelle leerDas Feld bleibt unverändert – auch bei speakers, Terminen und Beschreibungen.
Zelle gefülltDer Wert wird übernommen. Listenspalten wie category oder speakers ersetzen dabei die bisherige Liste.
Ausdrücklicher „Aus“-WertWirkt wie angegeben, z. B. ticket_hide = 0 oder show_details = none.
Zuordnung zur HauptveranstaltungÄndert sich nur, wenn die Ziel-Veranstaltung oder parent_event_id eine Hauptveranstaltung liefern. Sonst bleibt sie, wie sie ist. Die Hauptveranstaltung darf auch weiter unten in derselben Datei stehen; was gar nicht gefunden wird, nennt die Abschlussmeldung.
StatusEine gefüllte Spalte status gilt. Ohne Angabe werden neue Einträge veröffentlicht, vorhandene behalten ihren Status – ein Entwurf bleibt Entwurf. Ein Eintrag im Papierkorb kommt zurück (ohne Angabe als Entwurf); in den Papierkorb legen kann ein Import nicht.
Neue EinträgeWas fehlt, bleibt leer; die Klick-Aktion steht auf „Detailseite“, die ID wird fortgezählt.

Beschreibungen werden nur übernommen, solange „CSV-Import: Beschreibungen“ erlaubt ist, Bilder nur bei „CSV-Import: Bilder“.

Abgespeckte Dateien sind erlaubt

Eine Datei mit nur event_id (oder title) und venue ändert nur die Orte – Termine, Beschreibungen und die Zuordnung zur Hauptveranstaltung bleiben stehen. Wichtig ist nur, dass jede Zeile ihren Programmpunkt findet; sonst entsteht ein neuer Eintrag. Ein Feld leeren geht nicht per Import, sondern in der Bearbeitungsmaske oder im Master Editor.

Der Status wandert mit

Der Gesamtexport enthält auch Entwürfe und schreibt den Status jeder Zeile in die Spalte status. So bleiben Entwürfe auch beim Import in eine andere Website Entwürfe. Fehlt die Spalte – etwa in einer älteren Exportdatei –, werden neue Zeilen veröffentlicht.

Die Export-Varianten

VarianteInhalt
Alle Veranstaltungen exportierenVollsicherung aller Programmpunkte einschließlich Entwürfen, aufsteigend nach Veranstaltungs-ID sortiert.
Spezifische HauptveranstaltungEine Hauptveranstaltung mit allen zugehörigen Programmpunkten – ideal, um ein Jahr weiterzugeben oder als Vorlage für das nächste zu nutzen.
Muster-VorlageAlle Spalten mit zwei Beispielzeilen.
Statistik-ExporteIm Dashboard: Favoriten, Hauptveranstaltungen, Orte und Kategorien, jeweils vollständig.

Das Trennzeichen wählen Sie direkt neben der Schaltfläche: Komma, Semikolon oder Tabulator. Die Wahl wird gemerkt; für deutsches Excel ist das Semikolon meist am bequemsten.

Einstellungen sichern & wiederherstellen

Dieser Bereich ist nur für Administratoren sichtbar. Er sichert alle Plugin-Einstellungen einschließlich Ihrer geänderten Texte & Labels in einer JSON-Datei – etwa vor einem Update oder zur Übertragung auf eine andere Website. Auf Wunsch kommen die Farben und Bilder der Orte, Kategorien und Rollen mit.

  1. 1
    Sicherung herunterladen

    „Einstellungssicherung herunterladen“, optional mit Farben und Bildern der Begriffe.

  2. 2
    Datei hochladen

    Unter „Einstellungen wiederherstellen“. Sie sehen zuerst, was sich ändern würde: geänderte Einstellungen, geänderte Texte, Texte, die auf den Standard zurückfallen, und gefundene Orte, Kategorien und Rollen.

  3. 3
    Bestätigen

    Erst jetzt wird überschrieben. Stammt die Sicherung von einer anderen Website, weist das Plugin darauf hin – prüfen Sie danach URL-Slugs und Bilder.

Nicht enthalten

Programmpunkte, Sprecher sowie die Orte und Kategorien selbst (dafür sind die CSV-Bereiche da), die Option „Daten bei Deinstallation löschen“ und technische Merker. Bilder, die es in der Mediathek der Zielseite nicht gibt, werden übersprungen.

Wenn beim Import etwas schiefgeht

BeobachtungUrsache und Lösung
Kryptische Zeichen statt UmlautenDie Datei ist nicht UTF-8. In Excel „CSV UTF-8 (durch Komma getrennt)“ wählen und erneut hochladen.
„Keine erkennbare Kopfzeile“Die Spalte title fehlt oder heißt anders. Kopfzeile aus der Muster-Vorlage übernehmen.
„Sicherheitsfehler“Keine echte .csv-Datei, oder der Anfang der Datei enthält Programmcode oder HTML.
Programm doppelt vorhandenDie Titel weichen minimal ab (ein Leerzeichen genügt), oder die Datei trägt eine andere event_id als der vorhandene Programmpunkt. Bestand exportieren, IDs übernehmen, wieder hochladen.
Einzelne Zeilen fehlenZeilen ohne Titel werden übersprungen. Prüfen Sie außerdem date und start_time.
Ein Feld lässt sich per Import nicht leerenGewollt: Leere Zellen ändern nichts – siehe „Was ein Import überschreibt“. Das Feld in der Bearbeitungsmaske oder im Master Editor leeren.
Bilder fehlen„CSV-Import: Bilder“ ist ausgeschaltet, oder der Server erlaubt keine ausgehenden Verbindungen. Bilder dann über die Mediathek oder den Master Editor nachpflegen.
Alles in der falschen HauptveranstaltungOben war eine Ziel-Veranstaltung gewählt – sie geht immer vor.
Abbruch bei sehr großen DateienIn Abschnitte von einigen hundert Zeilen teilen. Solange jede Zeile eine event_id trägt, können Sie beliebig oft nachladen.