I version 2.5 har WordPress introducerat kortnummer, och vi har alla brukar använt dem på ett eller annat sätt. De kommer vanligtvis buntade med plugins, eller till och med teman, och vad de gör är att titta på när du sätter in någonting inuti kvadratkonsoler, ersätt det med något annat innehåll. det kan vara en enkel mening eller det kan vara en massiv PHP-funktion, allt beror på vad du instruerade WordPress att göra.

Medföljande kortkoder är bra och snabbare upp saker, men skulle det inte vara bra att veta hur man skapar egna kortnummer?

I den här artikeln tar jag dig genom att skapa några enkla WordPress-kortkoder som hjälper dig att skapa vilken funktionalitet du gillar.

En enkel kortnummer

Shortcode API fungerar väldigt enkelt: Först måste du skapa en återuppringningsfunktion som körs när som helst kortnummer används. då måste du knyta den funktionen till en specifik kortnummer som gör den klar för användning. Koden placeras ofta i functions.php-filen, men om du planerar att ha många kortkoder är det meningsfullt att skapa en separat fil och inkludera den filen i din functions.php-fil.

I vårt första exempel vill vi skapa en kortnummer som kommer att skapa lite lorem ipsum varje gång vi skriver in [lorem] i redaktören. Först måste vi skapa återuppringningsfunktionen som kommer att returnera lorem ipsum (i kortnummer vi inte echo någonting returneras allt):

function lorem_function() {return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';}

Därefter måste vi lägga till denna kortnummer till WordPress med add_shortcode- funktionen i antingen vår functions.php-fil eller en fil som ingår i den. Den här funktionen lägger till kortkoden och binder den till den funktion som vi just skapat. add_shortcode tar bara två argument, den första är namnet vi vill ha den här kortkoden (vad vi ska skriva mellan de firkantiga parenteserna) och den andra är den funktion som vi vill bifoga den kortnummer:

add_shortcode('lorem', 'lorem_function');

Det är allt som krävs för att skapa en enkel kortnummer i WordPress.

Lägga till parametrar

Fortsätt med denna dummyhemsidé, vi behöver ofta bilder i vårt innehåll när vi förbereder våra mockups och dessa bilder måste vara olika storlekar, så nu skapar vi en kortnummer för att infoga en bild så här:

[picture width="500" height="500"]

När WordPress möter detta vill vi ha en funktion som ska infoga en bild. Det måste läsa bredden och höjdattributen, men bara om vi också ger standardvärden så att den kan användas utan attribut. Eftersom vi kanske inte har en bild tillgänglig, kommer vi att använda lorempixel.com service för att ge oss en slumpmässig bild.

Först måste vi skapa funktionen:

function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '';}

Vi namngav denna funktion random_picture och eftersom denna kortnummer kommer att kunna ta argument gav vi den $ atts- parametern. För att kunna använda attributen behöver vi två funktioner: shortcode_atts som är en WordPress-funktion som kombinerar våra attribut med kända attribut och fyller i standardvärden när det behövs. och extraktet PHP-funktionen som, som namnet antyder, extraherar de attribut vi satte in för vår kortnummer. Slutligen returnerar funktionen det värde vi vill ha, i det här fallet HTML-koden för vår bild kombinerad med bredden och höjdsvariablerna.

Det enda som kvarstår är att registrera denna kortnummer:

add_shortcode('picture', 'random_picture');

Vårt kortnummer är komplett, när vi skriver [bild] kommer det att ge oss en slumpmässig bild 400 med 200, och om vi använder attributen kan vi skapa en bild av vilken storlek som helst vi önskar.

Slutsats

Att skapa små kortkoder för saker vi använder ofta hjälper oss definitivt när du skriver blogginlägg eftersom du kan göra allt du vill med kortkoder, det kan vara lika enkelt som att returnera en mening, eller så komplicerat som att lägga till ett formulär eller de senaste inläggen sorterade efter månad.

Har du skapat användbara kortkoder för WordPress? Vilka kortkoder önskar du existerat? Låt oss veta i kommentarerna.

Utvalda bild / miniatyrbild, kodbild via Marjan Krebelj.