Talen: Engels – Italiano – 日本 Português do Brasil – Русский – (Voeg uw taal toe)

Met de functie Galerij kunt u een of meer afbeeldingsgalerijen aan uw berichten en pagina’s toevoegen met behulp van een eenvoudige shortcode. Sinds WordPress 2.5 en tot 3.5, de galerij shortcode werd vaak gebruikt in zijn meest elementaire vorm:

Vanaf 3.5 bevatten de gallery shortcodes standaard de image IDs. Zoals dit:

Het is belangrijk op te merken dat deze stijl van galerij shortcode niet nieuw is voor 3.5, voorheen konden we gebruik maken van het include attribuut. Het is echter veel gemakkelijker te genereren en te beheren met de nieuwe Media Workflow geïntroduceerd in 3.5.

Door ID’s in uw shortcode te specificeren, kunt u afbeeldingen in uw galerij opnemen die niet noodzakelijkerwijs aan uw bericht zijn “gekoppeld” – dat wil zeggen, niet zijn geupload vanuit uw bericht of pagina. Deze flexibiliteit stelt u in staat om een willekeurig aantal galerijen te maken en in te sluiten met een willekeurig aantal afbeeldingen!

Note: Als u ervoor kiest om alleen de “barebones” versie van de shortcode in uw bericht of pagina te gebruiken, zullen alleen afbeeldingen worden weergegeven die “gekoppeld” zijn aan dat bericht of die pagina.

Gebruik

Er zijn verschillende opties die met deze syntaxis kunnen worden opgegeven:

U kunt een galerij ook direct in een sjabloon afdrukken, zoals dit:

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

Dit werkt ook:

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

Opties

De volgende basisopties worden ondersteund:

volgorde specificeert hoe de getoonde miniaturen gesorteerd moeten worden. De standaardinstelling is “menu_order”. Opties:

• menu_order – u kunt de afbeeldingen opnieuw rangschikken in het tabblad Galerij van de pop-up Media toevoegen
• titel – rangschikken op de titel van de afbeelding in de Mediabibliotheek
• post_date – sorteren op datum/tijd
• rand – willekeurig rangschikken
• ID

order specificeer de sorteervolgorde die wordt gebruikt om miniaturen weer te geven. ASC of DESC. Bijvoorbeeld, om te sorteren op ID, DESC:

kolommen geeft het aantal kolommen aan. De galerij zal aan het einde van elke rij een breukmarkering invoegen, en de kolombreedte berekenen zoals aangewezen. De standaardwaarde is 3. Als kolommen is ingesteld op 0, worden er geen rij-einden opgenomen. Bijvoorbeeld, om een 4 koloms galerij te tonen:

id specificeer de post ID. De galerij zal de afbeeldingen tonen die bij dat bericht horen. Het standaard gedrag, indien geen ID is gespecificeerd, is om afbeeldingen te tonen die bij het huidige bericht horen. Bijvoorbeeld, om afbeeldingen te tonen bij bericht 123:

grootte specificeer de afbeeldingsgrootte die moet worden gebruikt voor de thumbnail-weergave. Geldige waarden zijn “thumbnail”, “medium”, “groot”, “volledig” en elke andere extra afbeeldingsgrootte die werd geregistreerd met add_image_size(). De standaardwaarde is “thumbnail”. De grootte van de afbeeldingen voor “thumbnail”, “medium” en “groot” kan worden geconfigureerd in het WordPress admin paneel onder Instellingen > Media. Bijvoorbeeld, om een galerij van middelgrote afbeeldingen weer te geven:

Een aantal geavanceerde opties zijn beschikbaar:

itemtag de naam van de XHTML tag die wordt gebruikt om elk item in de galerij te omsluiten. De standaardwaarde is “dl”. icontag de naam van de XHTML-tag die wordt gebruikt om elk thumbnail-icoon in de galerij te omsluiten. De standaardwaarde is “dt”. captiontag de naam van de XHTML tag die wordt gebruikt om elk bijschrift te omsluiten. De standaardwaarde is “dd”. Bijvoorbeeld, om de galerij opmaak te veranderen om div, span en p tags te gebruiken:

link Geef aan waarnaar de afbeelding moet linken. De standaard waarde linkt naar de permalink van de bijlage. Opties:

• bestand – Link direct naar afbeeldingsbestand
• none – Geen link

include comma separated attachment IDs om alleen de afbeeldingen uit deze bijlagen te tonen.

exclude bijlage-ID’s, gescheiden door komma’s, sluit de afbeeldingen van deze bijlagen uit. Let op: include en exclude kunnen niet samen worden gebruikt.

Ontwikkelaars – Dingen om te overwegen

Het standaard verwachte gedrag voor een galerij die geen expliciete ID’s heeft vermeld, is om alle afbeeldingen toe te voegen die de post als post-ouder toegewezen hebben gekregen. Met andere woorden, voeg alle afbeeldingen toe die zijn geupload met de “Media toevoegen” knop/link op dit post bewerkingsscherm. Hou in gedachten dat dit ook betekent dat elke bijlage die later aan dit bericht wordt toegevoegd, zal worden geïnterpreteerd als deel van de galerij. Het maakt niet uit of het als gewone bijlage werd weergegeven of niet.

Dit zou de standaard fallback moeten zijn als er geen argument werd gegeven: …lorem ipsum…

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

En stop met het gebruik van extract() op shortcode_atts() (of ergens anders). IDE’s zijn niet in staat om dat te backtracen.