Språk: English – Italiano – 日本語 Português do Brasil – Русский – (Lägg till ditt språk)

Med Gallery-funktionen kan du lägga till ett eller flera bildgallerier till dina inlägg och sidor med hjälp av en enkel kortkod. Sedan WordPress 2.5 och fram till 3.5 användes kortkoden för galleri ofta i sin mest grundläggande form:

Från och med 3.5 innehåller kortkoder för galleri bild-ID:n som standard. Så här:

Det är viktigt att notera att den här typen av galleri shortcode inte är ny i 3.5, tidigare kunde vi använda attributet include. Den är dock mycket enklare att generera och hantera med det nya Media Workflow som introduceras i 3.5.

Specificera ID i din kortkod gör att du kan inkludera bilder i ditt galleri som inte nödvändigtvis är ”bifogade” till ditt inlägg – det vill säga som inte har laddats upp från ditt inlägg eller din sida. Denna flexibilitet gör att du kan skapa och bädda in valfritt antal gallerier som innehåller valfritt antal bilder!

Observera: Om du väljer att bara använda ”barebones”-versionen av kortkoden i ditt inlägg eller på din sida kommer endast bilder som är ”bifogade” till det inlägget eller den sidan att visas.

Användning

Det finns flera alternativ som kan anges med den här syntaxen:

Du kan också skriva ut ett galleri direkt i en mall på följande sätt:

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

Det här fungerar också:

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

Optioner

Följande grundalternativ har stöd för:

orderby anger hur visningsminiatyrbilderna ska sorteras. Standardvärdet är ”menu_order”. Alternativ:

• menu_order – du kan ordna om bilderna på fliken Galleri i popup-fönstret Lägg till media
• title – ordna efter bildens titel i Mediebiblioteket
• post_date – sortera efter datum/tid
• rand – ordna slumpmässigt
• ID

order ange den sorteringsordning som används för att visa miniatyrbilder. ASC eller DESC. Till exempel, för att sortera efter ID, DESC:

kolumner anger antalet kolumner. Galleriet kommer att inkludera en brytpunkt i slutet av varje rad och beräkna kolumnbredden på lämpligt sätt. Standardvärdet är 3. Om kolumnerna är 0 kommer inga radbrytningar att inkluderas. Till exempel, för att visa ett galleri med 4 kolumner:

id ange inläggets ID. Galleriet kommer att visa bilder som är kopplade till det inlägget. Standardbeteendet, om inget ID anges, är att visa bilder som är kopplade till det aktuella inlägget. Till exempel, för att visa bilder som är kopplade till inlägg 123:

size anger den bildstorlek som ska användas för miniatyrbilder. Giltiga värden är ”thumbnail”, ”medium”, ”large”, ”full” och alla andra ytterligare bildstorlekar som registrerats med add_image_size(). Standardvärdet är ”thumbnail”. Storleken på bilderna för ”thumbnail”, ”medium” och ”large” kan konfigureras i WordPress adminpanel under Settings > Media. Till exempel för att visa ett galleri med medelstora bilder:

Det finns några avancerade alternativ:

itemtag namnet på den XHTML-tagg som används för att omsluta varje objekt i galleriet. Standardvärdet är ”dl”. icontag namnet på den XHTML-tagg som används för att omsluta varje miniatyrbildsikon i galleriet. Standardvärdet är ”dt”. captiontag namnet på den XHTML-tagg som används för att omsluta varje bildtext. Standardvärdet är ”dd”. Om du t.ex. vill ändra galleriets markeringar så att div-, span- och p-taggar används:

link Ange var du vill att bilden ska länkas. Standardvärdet länkar till bilagans permalink. Alternativ:

• file – Länkar direkt till bildfilen
• none – Ingen länk

include comma separated attachment IDs (kommaseparerade ID:n för bilagor) för att endast visa bilderna från dessa bilagor.

exclude comma separated attachment IDs utesluter bilderna från dessa bilagor. Observera att include och exclude inte kan användas tillsammans.

Utvecklare – saker att tänka på

Det förväntade standardbeteendet för ett galleri som inte har några explicita ID:n angivna är att lägga till alla bilder som har posten som post förälder tilldelad. Med andra ord, lägg till alla bilder som laddades upp med hjälp av knappen/länken ”Lägg till media” på den här redigeringsskärmen för inlägget. Tänk på att detta också innebär att alla bilagor som läggs till i inlägget senare kommer att tolkas som en del av galleriet. Det spelar ingen roll om den visades som en vanlig bilaga eller inte.

Detta bör vara standardfallback om inget argument anges: …lorem ipsum…

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

Och sluta använda extract() på shortcode_atts() (eller någon annanstans). IDE:er kan inte spåra detta bakåt.