WebMasterService N3rds@Work

PsourceMediathek Gallerie Anzeige Shortcodes

Shortcode:

[`psmt-list-gallery`]

Es gibt rund 30 Optionen, um Galerien aufzulisten. Wir werden all dies im folgenden Beispiel sehen.
Die Standardsyntax lautet:

[`psmt-list-gallery option_name=some value option1_name = some other value … `]

Zulässige Optionen:

Galerie-Typ-Parameter:

type: Zulässiger Galerietyp. Mögliche Werte sind

  • all
  • photo
  • audio
  • video
  • doc

Wenn Du „all“ verwendest, werden alle Arten von Galerien zurückgegeben. Du kannst „photo“, „audio“, „video“, „doc“ verwenden, um nur Galerien dieses Typs aufzulisten.

Komponentenparameter:

component: Die zulässigen Komponenten, für die eine Galerie erstellt werden kann.
Mögliche Werte sind:

  • members
  • groups
  • sitewide

Bei Verwendung von component=members werden nur Galerien von Benutzern aufgelistet. Wenn Du „groups“ verwendest, werden Gruppengalerien aufgelistet, und „sitewide“ werden Seitenweite-Galerien aufgelistet. Wenn Du keinen Wert angibst, werden Galerien von Benutzern sowie Gruppen aufgelistet.
component_id: Die Komponenten-ID kann verwendet werden, um Galerien von bestimmten Benutzern oder Gruppen abzurufen. Dies hängt von der Option „component“ ab. Die Komponentenoption muss angegeben werden. Wenn die Komponente „member“ ist, wird die Komponenten-ID als Benutzer-ID oder als Gruppen-ID behandelt.

Statusparameter:

status: Die Galerie für Statusbeschränkungen mit einem bestimmten Status, der aufgelistet werden soll. Wenn Du es nicht angibst, ist die Standardeinstellung „öffentlich“.
Mögliche Statuswerte sind:

  • public
  • private
  • loggedin
  • friendsonly
  • followers
  • following

Die letzten beiden (Follower, folgende) gelten nur, wenn das BuddyPress Followers-Plugin aktiviert ist.

id: Spezifische Galerie-ID, die Du auflisten möchtest. Es wird nur eine Galerie aufgelistet
slug: Es wird nur eine Galerie mit diesem Slug aufgelistet.
in: Durch Kommas getrennte Liste der Galerie-IDs, die Du in die Liste aufnehmen möchtest. Nur diese Galerien werden aufgelistet.
exclude: Durch Kommas getrennte Liste der Galerie-IDs, die Du nicht in die Liste aufnehmen möchtest.

Benutzerspezifische Parameter:

user_id: Du kannst die numerische Benutzer-ID angeben. Es werden alle Galerien für den angegebenen Benutzer zurückgegeben
user_name: Du kannst den Anmeldenamen des Benutzers (Benutzername) anstelle der oben angegebenen ID verwenden.
include_users: Eine durch Kommas getrennte Liste numerischer Benutzer-IDs. Dadurch werden die Galerien eingeschränkt, die nur von diesen Benutzern aufgelistet werden sollen.

Beispiel:

[`psmt-list-gallery include_user=’1,2,3,4,5’`]

listet Galerien für die angegebenen 5 Benutzer auf.

exclude_users: Eine durch Kommas getrennte Liste numerischer Benutzer-IDs. Es schließt Galerien von den angegebenen Benutzern in der aktuellen Galerieliste aus.

Beispiel:

[`psmt-list-gallery exclude_users=’1,2,3’`]

Galerien von Benutzern mit der ID 1 oder 2 oder 3 werden nicht aufgelistet.
for: Gib einen dynamischen Benutzerkontext an, um die Galerie eines bestimmten Benutzers aufzulisten. Mögliche Werte sind „logged“, „displayed“, „author“.

Beispiel: Liste Galerien für den angemeldeten Benutzer auf.

[`psmt-list-gallery for=”logged” type=”photo”`]

Es werden Fotogalerien des aktuell angemeldeten Benutzers aufgelistet. Wenn der Benutzer nicht angemeldet ist, wird nichts angezeigt.

Beispiel: Listengalerie für den angezeigten Benutzer.

[`psmt-list-gallery for=”displayed” type=”photo”`]

Die Galerien des Benutzers werden nur aufgelistet, wenn wir sie im Profil eines Benutzers verwenden.
Um die Galerien eines Autors (Postautors) anzuzeigen, kannst Du den folgenden Shortcode verwenden.

[`psmt-list-gallery for=”author” type=”photo”`]

Es funktioniert nicht außerhalb des Post-Kontexts.

Suchparameter:

search_terms: Du kannst es verwenden, um die Galerien aufzulisten, deren Titel oder Beschreibung dem angegebenen Wert entspricht.

Beispiel:

[`psmt-list-gallery search_terms=’leben’`]

Listet nur Galerien auf, deren Titel oder Beschreibung das Wort „Leben“ enthält.

Datumsparameter:

year: Liste der im angegebenen Jahr erstellten Galerien.

Beispiel:

[`psmt-list-gallery year=2020`]

listet nur die Galerien auf, die 2020 erstellt wurden.

month: Listet die in einem bestimmten Monat erstellten Galerien auf. Mögliche Werte sind 1-12.

Beispiel:

[`psmt-list-gallery month=2`]

listet nur die Galerien auf, die im Februar erstellt wurden.

week: Du kannst die Wochennummer angeben, ab der die Galerie aufgelistet werden soll.
Mögliche Werte sind von 1-53
Für andere mögliche Werte schauen Sie bitte bei WP_Query Date Parameter  nach möglichen Werten und ihrer Bedeutung. date_query Parameter wird derzeit nicht unterstützt.

Parameter für benutzerdefinierte Felder:

Der Shortcode unterstützt die Parameter meta_key und meta_value. Die PSMT_Gallery_Query unterstützt den Parameter meta_query, wird jedoch nicht im Shortcode unterstützt.
Bitte wirf hier einen Blick in die WP_Query-Dokumentation für benutzerdefinierte Felder, um sie zu verstehen.

Beispiel:

[`psmt-list-gallery meta_key=’is_featured’`]

listet nur Galerien auf, die einen Metaschlüssel namens „is_featured“ haben

Parameter anzeigen:

column:

  • type:- integer
  • default: 4
  • Es wird verwendet, um die Galerieliste im Raster anzuzeigen. Der Standardwert ist 4. Er definiert, wie viele Galerien pro Zeile aufgelistet werden sollen.

Paginierungsparameter:

per_page:

  • type: integer
  • steuert, wie viele Galerien pro Seite aufgelistet werden

offset:

  • type: integer
  • wie viele Galerien aus der Liste verschoben/verdrängt werden sollen (vom Anfang der Originalliste ausschließen)

page: Es ist dasselbe wie der ‚paged‘ Parameter von WP_Query, welche Ergebnisseite Du anzeigen möchtest.
nopaging: Wenn Du alle Galerien auflisten möchtest. Bitte vermeide dies, da dies zu einer Verschlechterung der Leistung führen kann. Verwende stattdessen immer pro_page.

Referenz: WP_Query Pagination Parameters.

show_creator:

  • type: Ganzzahl, Standard 0.
  • steuert, ob der Ersteller der Galerie angezeigt werden soll oder nicht.

before_creator:

  • type: String
  • Verwende ein beliebiges Markup oder eine beliebige Zeichenfolge, die Du vor den Namen des Erstellers der Galerie setzen möchtest.

after_creator:

  • type: String
  • Verwende ein beliebiges Markup oder einen beliebigen String, den Du nach dem Namen des Erstellers der Galerie einfügen möchtest.

Beispiel:

[`psmt-list-gallery show_creator=1 before_creator=”Von: ” `]

Diskussion (0)

Es gibt noch keine Kommentare zu diesem Dokument.

Hinterlasse eine Antwort

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.