Articles

WordPress.org

by admin

Sprachen: English – Italiano – 日本語 Português do Brasil – Русский – (Fügen Sie Ihre Sprache hinzu)

Die Galerie-Funktion ermöglicht es Ihnen, eine oder mehrere Bildergalerien zu Ihren Beiträgen und Seiten mithilfe eines einfachen Shortcodes hinzuzufügen. Seit WordPress 2.5 und bis zu 3.5 wurde der Galerie-Shortcode häufig in seiner einfachsten Form verwendet: 



Ab 3.5 enthalten die Galerie-Shortcodes standardmäßig die Bild-IDs. Etwa so:




Es ist wichtig zu wissen, dass diese Art von Galerie-Shortcode nicht neu in 3.5 ist, vorher konnte man das include-Attribut verwenden. Allerdings ist es viel einfacher zu generieren und zu verwalten mit dem neuen Media Workflow in 3.5 eingeführt. 


Die Angabe von IDs in Ihrem Shortcode ermöglicht es Ihnen, Bilder in Ihre Galerie aufzunehmen, die nicht notwendigerweise an Ihren Beitrag „angehängt“ sind – d.h. nicht von Ihrem Beitrag oder Ihrer Seite hochgeladen wurden. Diese Flexibilität ermöglicht es Ihnen, eine beliebige Anzahl von Galerien mit einer beliebigen Anzahl von Bildern zu erstellen und einzubetten!


Hinweis: Wenn Sie nur die „Barebones“-Version des Shortcodes in Ihrem Beitrag oder Ihrer Seite verwenden, werden nur Bilder angezeigt, die diesem Beitrag oder dieser Seite „angehängt“ sind.


Verwendung


Es gibt mehrere Optionen, die mit dieser Syntax angegeben werden können:




Sie können eine Galerie auch direkt in einer Vorlage wie folgt ausgeben:


 <?php echo do_shortcode(''); ?>


Dies funktioniert auch:


 <?php $gallery_shortcode = ''; print apply_filters( 'the_content', $gallery_shortcode ); ?>


Optionen


Die folgenden grundlegenden Optionen werden unterstützt:


 orderby geben an, wie die angezeigten Miniaturbilder sortiert werden sollen. Der Standardwert ist „menu_order“. Optionen: 


    

  •  menu_order – Sie können die Bilder auf der Registerkarte „Galerie“ des Popup-Fensters „Medien hinzufügen“ neu anordnen
    • 

  •  title – Sortierung nach dem Titel des Bildes in der Medienbibliothek
    • 

  •  post_date – Sortierung nach Datum/Uhrzeit
    • 

  •  rand – zufällige Sortierung
    • 

  •  ID
    • 



 order geben Sie die Sortierreihenfolge für die Anzeige der Miniaturbilder an. ASC oder DESC. Zum Beispiel, um nach ID zu sortieren, DESC: 


 


 Spalten geben die Anzahl der Spalten an. Die Galerie fügt am Ende jeder Zeile ein Break-Tag ein und berechnet die Spaltenbreite entsprechend. Der Standardwert ist 3. Wenn columns auf 0 gesetzt ist, wird kein Zeilenumbruch eingefügt. Beispiel: Um eine 4-Spalten-Galerie anzuzeigen: 




 id gibt die ID des Beitrags an. Die Galerie zeigt die Bilder an, die zu diesem Beitrag gehören. Wenn keine ID angegeben wird, werden standardmäßig die Bilder angezeigt, die dem aktuellen Beitrag angehängt sind. Zum Beispiel, um Bilder anzuzeigen, die dem Beitrag 123 angehängt sind: 




 size geben Sie die Bildgröße an, die für die Anzeige der Miniaturbilder verwendet werden soll. Gültige Werte sind „thumbnail“, „medium“, „large“, „full“ und jede andere zusätzliche Bildgröße, die mit add_image_size() registriert wurde. Der Standardwert ist „thumbnail“. Die Größe der Bilder für „thumbnail“, „medium“ und „large“ kann im WordPress-Administrationsbereich unter Einstellungen > Medien konfiguriert werden. Zum Beispiel, um eine Galerie mit mittelgroßen Bildern anzuzeigen: 




Einige erweiterte Optionen sind verfügbar:


 itemtag der Name des XHTML-Tags, der verwendet wird, um jedes Element in der Galerie einzuschließen. Der Standardwert ist „dl“. icontag der Name des XHTML-Tags, der verwendet wird, um jedes Thumbnail-Symbol in der Galerie einzuschließen. Der Standardwert ist „dt“. captiontag der Name des XHTML-Tags, mit dem die einzelnen Bildunterschriften umschlossen werden. Der Standardwert ist „dd“. Zum Beispiel, um das Galerie-Markup so zu ändern, dass div, span und p Tags verwendet werden: 




 link Geben Sie an, wohin das Bild verlinkt werden soll. Der Standardwert verweist auf den Permalink des Anhangs. Optionen: 


    

  •  file – Link direkt zur Bilddatei
    • 

  •  none – Kein Link
    • 



 


 include comma separated attachment IDs, um nur die Bilder aus diesen Anhängen anzuzeigen. 


 


 exclude Komma getrennte Anhang-IDs schließt die Bilder aus diesen Anhängen aus. Bitte beachten Sie, dass include und exclude nicht zusammen verwendet werden können. 




Entwickler – Zu beachtende Dinge


Das standardmäßig erwartete Verhalten für eine Galerie, die keine expliziten IDs angegeben hat, ist, alle Bilder hinzuzufügen, denen der Beitrag als übergeordneter Beitrag zugewiesen ist. Mit anderen Worten, es werden alle Bilder hinzugefügt, die über die Schaltfläche/Link „Medien hinzufügen“ auf diesem Bearbeitungsbildschirm hochgeladen wurden. Beachten Sie, dass dies auch bedeutet, dass jeder Anhang, der später zu diesem Beitrag hinzugefügt wird, als Teil der Galerie interpretiert wird. Unabhängig davon, ob er als einfacher Anhang angezeigt wurde oder nicht.


Dies sollte der Standard-Fallback sein, wenn kein Argument angegeben wurde: …lorem ipsum…


$attachments = get_children( array('post_parent' => $attr,'post_status' => 'inherit','post_type' => 'attachment','post_mime_type' => 'image','order' => $attr,'orderby' => $attr,) );


Und hören Sie auf, extract() auf shortcode_atts() (oder irgendwo anders) zu verwenden. IDEs sind nicht in der Lage, das zurückzuverfolgen.