WebMasterService N3rds@Work

PsourceMediathek Gallerie Anzeige Shortcodes

PSOURCE Communityhub’s Dokumente PsourceMediathek 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:

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: You can specify the week number from which the gallery should be listed.
Possible values are from 1-53

For other possible values, please take a loo at WP_Query Date Parameter for possible values and their meaning. date_query parameter is not supported at the moment.

Custom Fields Parameters:-

The shortcode supports meta_key and meta_value parameter. The MPP_Gallery_Query (documentation coming soon) supports meta_query parameter but it is not supported in shortcode.

Please take a look at WP_Query documentation for custom fields section here to understand it.

Example:-
[`mpp-list-gallery meta_key=’is_featured’`] will only list galleries that have a meta key named ‘is_featured’

View Parameters:-

column:-

  • type:- integer
  • default: 4
  • It is used to display the gallery list in grid. Default value is 4. it defins how many galleries should be listed per row.

 

Pagination Parameters:-

per_page:-

  • type: integer
  • controls how many galleries to list per page

offset:-

  • type: integer
  • how many galleries from the list to offset/displace( exclude from beginning of the original list)

page:- It is same as the ‘paged’ parameter of WP_Query, Which page of result you want to display.

nopaging:- If you want to list all galleries. Please avoid it as It can lead to degraded performance. Always use per_page instead.

Reference:- WP_Query Pagination Parameters.

show_creator:-

  • type: integer, default 0.
  • controls whether to show the gallery creator or not.

before_creator:-

  • type: string
  • Use any markup or string you want to put before the gallery creator’s name.

after_creator:-

  • type: string
  • Use any markup or string you want to put after the gallery creator’s name.

Example:-

[`mpp-list-gallery show_creator=1 before_creator=”By: ” `]