WordPress.org

Talen: Engels – Français – 日本 (Voeg uw taal toe)

Sinds versie 2.5 ondersteunt WordPress zogenaamde Shortcodes. Deze zijn geïntroduceerd voor het creëren van macro’s die gebruikt kunnen worden in de inhoud van een post. Voor voorbeelden van shortcodes en hoe ze te gebruiken, zie WordPress.com Shortcodes, hoewel sommige shortcodes daar exclusief zijn voor WordPress.com.

Een triviale shortcode voor een galerie ziet er als volgt uit:

Shortcodes kunnen ook worden gebruikt met extra attributen, zoals het volgende voorbeeld laat zien:

Beide voorbeelden tonen een afbeeldingsgalerij, die moeilijk te onderhouden zou zijn als je de HTML markup ervoor zou moeten schrijven en deze in sync zou moeten houden met geüploade afbeeldingen. Door een shortcode te gebruiken, wordt de opmaak voor de galerie dynamisch en automatisch gemaakt.

Ingebouwde en aanvullende shortcodes

WordPress biedt sommige shortcodes standaard aan (bijvoorbeeld die voor de galerie) en plugins kunnen hun eigen shortcodes ook toevoegen via de Shortcode API.

De volgende shortcodes worden met WordPress meegeleverd:

Snelkoppelingen escapen

Soms wilt u misschien de tekst die gewoonlijk een snelkoppeling weergeeft in uw berichten gebruiken. Om dit te doen, moet u de shortcode escapen door twee sets haakjes te gebruiken in plaats van slechts één. Dus om dit in uw bericht weer te geven:

U zou dit schrijven:

]

Voor shortcodes die een begin- en eindtag hebben, hoeft u alleen de allereerste en allerlaatste haakjes te escapen:

 ... ]

Merk op dat alleen shortcodes die momenteel beschikbaar zijn op deze manier kunnen worden ge-escaped. Het gebruik van dubbele haakjes rond tekst die momenteel niet is geregistreerd als een shortcode zal resulteren in beide sets van haakjes worden weergegeven in uw bericht, niet slechts een zoals bij het escapen van geregistreerde shortcodes.

Shortcodes in Widgets

Tot 4.9 ondersteunt WordPress standaard geen shortcodes binnen Sidebar Widgets. Het breidt de shortcodes alleen uit binnen de inhoud van een Post, Pagina, of aangepast post type. Om shortcode ondersteuning toe te voegen aan sidebar widgets, kun je een plugin installeren, de onderstaande code gebruiken, of Widget Verbeteringen in 4.9 bekijken:

add_filter( 'widget_text', 'shortcode_unautop' );add_filter( 'widget_text', 'do_shortcode' );

Het is belangrijk dat deze regels in deze volgorde worden toegevoegd. De eerste regel voorkomt dat WordPress regeleinden omzet in alinea-tags, omdat dit voorkomt dat shortcodes werken. De tweede regel is degene die ervoor zorgt dat de shortcodes werken.

Shortcodes voor ontbrekende plugins (niet-geregistreerde namen)

Naast de ingebouwde shortcodes worden alle andere toegevoegd via plugins. Als de plugin die een bepaalde shortcode levert ontbreekt of gedeactiveerd is, zal WordPress de hele shortcode, de attributen en de inhoud erin als normale platte tekst behandelen en de speciale tekens in de uitvoer-HTML behouden.

<(^_^<) -- <Yay>

<> – (rendert)- Joepie!

Yay!

<Yay>

<(^_^)>

<(^_^)> -- Yay!

Yay!

<Yay>