Shortcodes

Die einzelnen Daten aus AURA werden über Shortcodes eingebunden. Die Shortcodes können frei auf den Seiten platziert werden.

Wichtig

Fast alle Shortcodes geben HTML aus und müssen deshalb zwingend in einem HTML-Block verwendet werden. Nutzt man sie außerhalb eines HTML-Blocks resultiert das mit großer Wahrscheinlichkeit in Darstellungsfehlern, da Wordpress häufig zusätzliches HTML in das HTML des Shortcode einfügt.

Allgemeine Hinweise

Implizite Datenquellen auf Detailseiten

Werden die Shortcodes auf den Detailseiten verwendet, geben sie Daten für den jeweiligen aktuellen Datensatz aus. [aura_show_description] gibt beispielsweise auf der Sendereihen-Detailseite die Beschreibung der aktuellen Sendereihe aus.

Teilweise ergibt sich dieser implizite Kontext auch durch eine Eltern-Beziehung. So funktioniert der oben genannte [aura_show_description] Shortcode auch auf der Sendetermin/Episoden Detailseite, da diese immer einer spezifischen Sendereihe zugeordnet sind. So lassen sich dort nicht nur Informationen des jeweiligen Sendetermins anzeigen, sondern auch allgemeine Informationen über die Sendereihe.

Explizite Datenquelle

Alle Shortcodes erlauben die Definition einer expliziten Datenquelle über den id Parameter.

Das kann z.B. hilfreich sein, wenn man einen einfachen Artikel schreibt, in dem man eine neue Sendereihe vorstellt, und Informationen zu dieser Sendereihe direkt aus AURA einbetten möchte. Die Einbindung des [aura_show_timeslots id=901 limit=3 future]-Shortcode würde im Artikel beispielsweise die Vorschauen der kommenden drei Sendetermine der Sendereihe mit der Id 901 anzeigen.

Die ids selber lassen sich im AURA Dashboard finden, wenn auch etwas umständlich. Sie sind Teil der URL in der Adressleiste des Browsers.

Sendereihen Shortcodes

aura_show_list

Gibt die Gesamtübersicht der Sendereihen samt Suche und Sprach- sowie Themenfilter aus.

aura_show_preview

Gibt eine Vorschau der Sendereihe aus.

Parameter

variant=<variante>

Gibt eine Darstellungsvariante vor. Standard ist default. Alternativ möglich ist about.

aura_show_description

Gibt die Beschreibung der Sendereihe aus.

aura_show_image

Gibt das Bild der Sendereihe aus.

aura_show_logo

Gibt das Logo der Sendereihe aus.

aura_show_languages

Gibt die Sprachen der Sendereihe aus.

aura_show_topics

Gibt die Themen der Sendereihe aus.

aura_show_links

Gibt die Links der Sendereihe aus.

aura_show_schedules

Gibt die Sendeschemata der Sendereihe als Text aus.

aura_show_editors

Gibt die Redaktion der Sendereihe aus.

aura_show_timeslots

Gibt die Sendetermine (Episoden) der Sendereihe aus. Standardmäßig werden Termine, die in der Zukunft liegen, ausgegeben.

Parameter

past

gibt vergangene Termine aus.

limit=<zahl>

legt fest wie viele Termine auf einmal ausgegeben werden. Standardmäßig sind es 12.

paginate-by=<eindeutiger-url-parameter>

erlaubt das Vor/Zurück-Blättern in der Ansicht.

Beispiele

Bettet sechs Sendetermine ein und erlaubt das Vor/Zurück-Blättern:

[aura_show_timeslots limit=6 paginate-by="futureEpisodesPage"]

Bettet die letzten zwölf vergangenen Sendetermine ein.

[aura_show_timeslots past]

Episoden Shortcodes

aura_episode_summary

Gibt die Zusammenfassung der Episode aus.

aura_episode_content

Gibt den Inhalt der Episode aus.

aura_episode_image

Gibt das Bild der Episode aus.

aura_episode_cba_player

Bindet den Player von cba.media aus, wenn eine CBA Id für die Episode hinterlegt wurde.

Wurde keine CBA Id angegeben, wird nichts ausgegeben.

aura_episode_topics

Gibt die Themen der Episode aus.

aura_episode_languages

Gibt die Sprachen der Episode aus.

aura_episode_contributors

Gibt die Mitwirkenden der Episode aus.

aura_episode_links

Gibt die Links der Episode aus.

Sendetermine (Sendungen/ Timeslots) Shortcodes

aura_timeslot_time

Gibt die Sendezeit aus.

Parameter

label=<Beschriftung>

Platziert eine Beschriftung vor der Sendezeit.

Profile (Sendungsmacher*innen) Shortcodes

aura_profile_finder

Gibt Profile aus, die für eine Sendereihe als Redaktion eingetragen sind.

Parameter

limit=<zahl>

Legt fest wie viele Termine auf einmal ausgegeben werden. Standardmäßig sind es 12. Sollen alle Profile auf einmal angezeigt werden kann -1 gesetzt werden.

paginate-by=<eindeutiger-url-parameter>

erlaubt das Vor/Zurück-Blättern in der Ansicht. Standardmäßig auf auraProfilePage gesetzt.

aura_profile_name

Gibt den Namen des Profils aus.

Enthält nur inline-HTML und kann deshalb auch außerhalb eines HTML-Blocks aufgerufen werden.

aura_profile_biography

Gibt die Biographie des Profils aus.

aura_profile_image

Gibt das Bild des Profils aus.

aura_profile_links

Gibt die Links des Profils aus.

aura_profile_shows

Gibt die dem Profil zugeordneten Sendereihen aus.

Suche

Diese Shortcodes können auf der Suchseite verwendet werden. Sie durchsuchen dann automatisch AURA nach passenden Einträgen und geben diesen aus.

Alternativ kann auch der term-Parameter manuell gesetzt werden. Damit lassen sich z.B. in einem Blogpost alle Sendungen einbetten, die einem bestimmten Suchbegriff entsprechen.

aura_search_shows

Gibt Sendereihen zum aktuellen Suchbegriff aus.

Parameter

limit=<zahl>

legt fest wie viele Sendereihen auf einmal ausgegeben werden. Standardmäßig sind es 12.

paginate-by=<eindeutiger-url-parameter>

erlaubt das Vor/Zurück-Blättern in der Ansicht.

term=<suchbegriff>

legt einen statischen Suchbegriff fest, nach dem gesucht werden soll.

aura_search_timeslots

Gibt Sendetermine/ Episoden zum aktuellen Suchbegriff aus.

Parameter

limit=<zahl>

legt fest wie viele Episoden auf einmal ausgegeben werden. Standardmäßig sind es 12.

paginate-by=<eindeutiger-url-parameter>

erlaubt das Vor/Zurück-Blättern in der Ansicht.

term=<suchbegriff>

legt einen statischen Suchbegriff fest, nach dem gesucht werden soll.

Info

Episoden können in AURA ohne Sendetermin existieren. Dieser Shortcode gibt nur Informationen zu Episoden aus, wenn diese tatsächlich auch einen Sendetermin haben.

Programm

aura_program_day

Gibt eine Übersicht des aktuellen Tagesprogramm aus. Erlaubt das Blättern zu anderen Tagen.

aura_program_current_preview

Gibt Titel und Beschreibung des aktuellen Programms aus. Sofern Informationen zur Episode bereitstehen, werden diese bevorzugt.

Die Ansicht des aktuellen Programms aktualisiert sich alle 60 Sekunden.

Player

aura_player_trigger

Bettet den Play Button für den Livestream ein. Erzeugt eine leere Ausgabe, wenn keine Audioquellen für den Livestream definiert sind.

Playout

aura_playout_current_track

Gibt den Interpret:in und Titel des aktuellen Tracks aus dem AURA Playout aus. Aktualisiert sich alle