Beitragslisten über Shortcodes in die Website einfügen

Wenn Du an bestimmten Stellen Deiner Website eine Liste von Beiträgen ausgeben willst, die bestimmten Kriterien folgen, kannst Du das über die sogenannten Shortcodes tun. Shortcodes kannst Du wie normalen Text im Editor einfügen.

Anstelle des Shortcodes wird dann eine Liste von Beiträgen angezeigt, die der Konfiguration, die Du im Shortcode angegeben hast, entsprechen. 

[list-posts]

Der Shortcode für eine Liste von Beträgen lautet: 

[list-posts]

Mit weiteren Variablen kannst Du den Shortcode konfigurieren. Ganz unten findest Du einen Hinweis dazu, dass Du die Variablen auch in einem Shortcode kombinieren kannst.

tag

Mit "tag=" kannst Du dafür sorgen, dass nur die Beiträge angezeigt werden, die einem oder mehreren Schlagworten entsprechen. Mehrere Schlagworte trennst Du mit einem Komma (ohne Leerzeichen). Die angegebenen Schlagworte werden mit OR verknüpft. Das bedeutet, dass Beiträge, die dem einen Schlagwort entsprechen, Beiträge die dem anderen Schlagwort entsprechen und solche, die beiden oder mehreren Schlagworten entsprechen, ausgegeben werden. 

Beispiel:

[list-posts tag="Homepage,Eilmeldung"]

Mit diesem Beispiel-Shortcode kannst Du Beiträge auflisten lassen, denen Du das Schlagwort "Homepage" oder das Schlagwort "Eilmeldung" oder beide zugeordnete hast.

tagid

Mit "tagid=" kannst Du statt der ausgeschriebenen Schlagworte auch deren ID verwenden. Diese findest Du in soz.is-Redaktionssystem dort, wo Du die Schlagworte verwalten kannst. Zum Beispiel unter "Beiträge" > "Schlagworte" im Menü des soz.is-Redaktionssystems links. 

Du kannst auch hier ein oder mehrere Tag-Ids angeben. Auch diese werden wie bei "tag" per OR verknüpft.

Beispiel:

[list-posts tagid="12,15"]

Mit diesem Beispiel-Shortcode kannst Du Beiträge auflisten lassen, denen Du Schlagworte vergeben hast, die im Redaktionssystem mit der ID 12 oder mit der ID 15 oder mit beiden verwaltet werden.

TIPP

Manchmal ist es geschickter, im Shortcode statt der ausgeschriebenen Schlagworte mit "tag=" die Schlagworte mit "tagid=" aufzunehmen:

Ausgangslage: Du hast einigen Beträgen im soz.is-Redaktionssystem das Schlagwort "Verkehr" mitgegeben. Das Schlagwort wir im soz.is-Redaktionssystem mit der Id 4 verwaltet. Nun fügst Du irgendwo auf Deiner Website den Shortcode [list-posts tag="Verkehr"] ein, um dort Beiträge aufzulisten, die mit dem Schlagwort "Verkehr" versehen sind. Später bearbeitest Du das Schlagwort "Verkehr" über die Schlagwortverwaltung und änderst es auf "Mobilität" ab. Der Shortcode kann dann nicht mehr dafür sorgen, dass Beiträge aufgelistet werden, weil es kein Schlagwort "Verkehr" mehr gibt und alle Beiträge nun mit dem Schlagwort "Mobilität" verknüpft sind. Wenn Du aber stattdessen den Shortcode [list-posts tagid="4"] verwendet hättest, würde der Shortcode weiter funktionieren, weil sich die ID des Schlagwortes bei der Textänderung nicht geändert hat. Es ist also häufig ratsam, statt der Variable "tag=" die Variable "tagid=" zu verwenden.

cat

Mit "cat=" kannst Du dafür sorgen, dass nur die Beiträge angezeigt werden, die einer oder mehreren Kategorien entsprechen. Mehrere Kategorien trennst Du mit einem Komma (ohne Leerzeichen). Die angegebenen Kategorien werden mit OR verknüpft. Das bedeutet, dass Beiträge, die der einen Kategorie entsprechen, Beiträge die der anderen Kategorie entsprechen und solche, die beiden oder mehreren Kategorien entsprechen, ausgegeben werden. 

Beispiel:

[list-posts cat="allgemein,Presse"]

Mit diesem Beispiel-Shortcode kannst Du Beiträge auflisten lassen, denen Du die Kategorie "allgemein" oder die Kategorie "Presse" oder beide zugeordnete hast.

catid

Mit "catid=" kannst Du statt der ausgeschriebenen Kategorien auch deren ID verwenden. Diese findest Du in soz.is-Redaktionssystem dort, wo Du die Kategorien verwalten kannst. Zum Beispiel unter "Beiträge" > "Kategorien" im Menü des soz.is-Redaktionssystems links.

Du kannst auch hier ein oder mehrere Tag-Ids angeben. Auch diese werden wie bei "tag" per OR verknüpft.

Beispiel:

[list-posts tagid="12,15"]

Mit diesem Beispiel-Shortcode kannst Du Beiträge auflisten lassen, denen Du Kategorien vergeben hast, die im Redaktionssystem mit der ID 12 oder mit der ID 15 oder mit beiden verwaltet werden.

TIPP

Auch hier gilt: Manchmal ist es geschickter, im Shortcode statt der ausgeschriebenen Kategorien mit "cat=" die Kategorien mit "catid=" aufzunehmen:

Ausgangslage: Du hast einigen Beträgen im soz.is-Redaktionssystem die Kategorie "Pressemitteilung" mitgegeben. Die Kategorie wir im soz.is-Redaktionssystem mit der Id 7 verwaltet. Nun fügst Du irgendwo auf Deiner Website den Shortcode [list-posts cat="Pressemitteilung"] ein, um dort Beiträge aufzulisten, die mit der Kategorie "Pressemitteilung" versehen sind. Später bearbeitest Du die Kategorie "Pressemitteilung" über die Kategorienverwaltung und änderst sie auf "Medienmitteilung" ab. Der Shortcode kann dann nicht mehr dafür sorgen, dass Beiträge aufgelistet werden, weil es keine Kategorie "Pressemitteilung" mehr gibt und alle Beiträge nun mit der Kategorie "Medienmitteilung" verknüpft sind. Wenn Du aber stattdessen den Shortcode [list-posts catid="7"] verwendet hättest, würde der Shortcode weiter funktionieren, weil sich die ID der Kategorie bei der Textänderung nicht geändert hat. Es ist also häufig ratsam, statt der Variable "cat=" die Variable "catid=" zu verwenden.

limit

Mit "limit=" kannst Du festlegen, wie viele Beiträge in der Auflistung maximal angezeigt werden. Der Zahlenwert muss dabei zwischen 0 und 1000 liegen.

Beispiel:

[list-posts limit=5]

Mit diesem Beispiel-Shortcode werden an der Stelle des Shortcodes maximal fünf Beiträge aufgelistet.

paged

Mit "paged=" kannst Du dafür sorgen, dass bei einer großen Zahl an Beiträgen, die an der Stelle des Shortcodes aufgelistet werden, nur eine begrenzte Zahl untereinander aufgelistet wird und darunter Links angezeigt werden, um weitere Beiträge anzuzeigen. Diese Links nennt man "Pagination". Um die Pagination anzuschalten, setzt Du die Variable auf "true".

Beispiel:

[list-posts paged="true"]

Mit diesem Beispiel-Shortcode sorgst Du dafür, dass nicht alle Beiträge untereinander dargestellt werden, sondern nur ein Teil. Unterhalb der Liste werden dann Links angezeigt, um an die nächste Seite mit Beiträgen zu kommen.

exclude_pools

Mit dieser Variablen kannst Du dafür sorgen, dass in der Beitragsliste keine Inhalte aufgeführt werden, die aus Pools stammen, die Du für Deine Website über das soz.is-Netzwerk von anderen Websites abonniert hast. Der Standardfall ist, dass diese mit angezeigt werden. Wenn Du dies Variable auf "true" setzt, werden die Pool-Beiträge nicht mit angezeigt.

Beispiel:

[list-posts exclude_pools="true"]

Mit diesem Beispiel-Shortcode sorgst Du dafür, dass in der Liste Beiträge nicht angezeigt werden, die aus abonnierten Pools von anderen Websites stammen. 

ignore_sticky_posts

Bei einem Beitrag kannst Du im soz.is-Redaktionssystem im Kasten "Veröffentlichen" in der rechten Spalte unter "Sichtbarkeit" die Option "Beitrag auf der Startseite halten" anwählen. Standardmäßig wird diese Angabe in den Betragslisten über Shortcodes ignoriert. Der Standardwert für diese Variable ist also "true". Du kannst für die Beitragslisten mit dieser Variablen dafür sorgen, dass diese Angabe ignoriert wird und auf diese Weise die Angabe berücksichtigt wird. Es handelt sich im Prinzip um eine doppelte Verneinung.

Beispiel:

[list-posts ignore_sticky_posts="false"]

Mit diesem Beispiel-Shortcode sorgst Du dafür, das die Angabe "Beitrag auf der Startseite halten" im  Beitragslisting über den Shortcode berücksichtigt wird und ein entsprechender Beitrag also im Listing auf jeden Fall erscheint.  

Kombination mehrerer Variablen

Alle Variablen kannst Du im Shortcode mischen und kombinieren. Du trennst sie einfach mit einem Leerzeichen. Die Kombination von Variablen entspricht der Verknüpfung mit AND. Das bedeutet, dass für die Beiträge, die mit dem Shortcode ausgeben werden, ALLE von Dir gesetzten Variablen gleichzeitig zutreffen müssen. Ein Beispiel: Kombinierst Du das Schlagwort "Startseite" mit der Kategorie "Medienmeldung" im Shortcode zu

[list-posts tag="Startseite" cat="Medienmeldung"]

dann werden dort nur Beiträge aufgelistet, denen das Schlagwort "Startseite" UND die Kategorie "Medienmeldung" zugewiesen wurde.