Sådan oprettes dine egne WordPress-kortkoder
I version 2.5 introducerede WordPress kortnumre, og vi alle har sikkert brugt dem på et eller andet tidspunkt. De kommer sædvanligvis sammen med plugins eller endda temaer, og hvad de gør er at se på, når du indsætter noget indenfor firkantede parenteser, og erstatt det med noget andet indhold. det kunne være en simpel sætning, eller det kunne være en massiv PHP-funktion, det hele afhænger af, hvad du instruerede WordPress til at gøre.
Bundlede kortkoder er gode, og fremskynder tingene betydeligt, men ville det ikke være godt at vide, hvordan man opretter kortnumre på egen hånd?
I denne artikel tager jeg dig igennem ved at oprette nogle enkle WordPress-kortkoder for at hjælpe dig med at oprette en hvilken som helst funktionalitet, du kan lide.
En simpel kortkode
Shortcode API virker meget simpelt: først skal du oprette en tilbagekaldsfunktion, som vil køre, når som helst kortkoden bruges. så skal du binde denne funktion til en bestemt kortkode, der gør den klar til brug. Koden er ofte placeret i functions.php filen, men hvis du planlægger at have mange kortkoder, giver det mening at oprette en separat fil og inkludere den fil i din functions.php-fil.
I vores første eksempel ønsker vi at oprette en shortcode, der vil skabe noget lorem ipsum hver gang vi skriver [lorem] ind i editoren. Først skal vi oprette tilbagekaldelsesfunktionen, som returnerer lorem ipsum (i kortkoder vi ikke echo noget, returneres alt):
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.';}Derefter skal vi tilføje denne shortcode til WordPress ved hjælp af add_shortcode funktionen i enten vores functions.php fil eller en fil, der er inkluderet i den. Denne funktion tilføjer shortcode og binder den også til den funktion, vi netop har oprettet. add_shortcode tager kun to argumenter, den første er navnet vi vil have denne kortkode at have (hvad vi vil skrive mellem de firkantede parenteser) og den anden er den funktion, vi ønsker at vedhæfte den pågældende kortkode:
add_shortcode('lorem', 'lorem_function');Det er alt, hvad der kræves for at oprette en simpel kortkode i WordPress.
Tilføjelse af parametre
Ved at fortsætte med denne dummy indholdside, har vi ofte brug for billeder i vores indhold, når vi forbereder vores mockups, og disse billeder skal have forskellige størrelser, så nu vil vi oprette en kortkode for at indsætte et billede som dette:
[picture width="500" height="500"]Når WordPress møder dette, ønsker vi en funktion, der vil indsætte et billede. Det skal læse bredde- og højdeattributterne, men bare hvis vi også giver standardværdier, så det kan bruges uden attributterne. Fordi vi måske ikke har et billede tilgængeligt, skal vi bruge lorempixel.com service til at give os et tilfældigt billede.
Først skal vi oprette funktionen:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Vi hedder denne funktion random_picture, og da denne shortcode vil kunne tage argumenter, gav vi den $ atts parameteren. For at bruge attributterne har vi brug for to funktioner: shortcode_atts, som er en WordPress-funktion, der kombinerer vores attributter med kendte attributter og udfylder standardindstillinger, når det er nødvendigt; og ekstraktet PHP-funktionen, som, som navnet antyder, uddrager de attributter, vi indstiller til vores shortcode. Endelig returnerer funktionen den værdi, vi ønsker, i dette tilfælde HTML-koden for vores billede kombineret med bredden og højden variabler.
Det eneste der er tilbage at gøre er at registrere denne shortcode:
add_shortcode('picture', 'random_picture');Vores shortcode er komplet, når vi skriver [billede] vil det give os et tilfældigt billede 400 med 200, og hvis vi bruger attributterne, kan vi lave et billede af enhver størrelse, vi har lyst til.
Konklusion
Oprettelse af små kortkoder for ting, vi bruger ofte hjælper os helt sikkert, når vi skriver blogindlæg, fordi du kan gøre alt hvad du behøver med kortkoder, det kan være så enkelt som at returnere en sætning eller lige så kompleks som at tilføje en formular eller de seneste indlæg sorteret efter måned.
Har du lavet nyttige kortkoder til WordPress? Hvilke kortkoder ønsker du eksisteret? Lad os vide i kommentarerne.
Fremhævet billede / miniaturebillede, kode billede via Marjan Krebelj.