Slik lager du dine egne WordPress-kortkoder
I versjon 2.5 har WordPress introdusert kortkoder, og alle av oss har sannsynligvis brukt dem på en eller annen gang. De kommer vanligvis sammen med plugins, eller til og med temaer, og hva de gjør er å se etter når du setter inn noe i firkantede parenteser, og erstatt det med noe annet innhold; det kan være en enkel setning eller det kan være en massiv PHP-funksjon, alt avhenger av hva du instruerte WordPress å gjøre.
Kombinert kortkoder er flotte, og farten opp ting betydelig, men ville det ikke vært bra å vite hvordan du lager egne kortnummer?
I denne artikkelen tar jeg deg gjennom å lage noen enkle WordPress-kortkoder for å hjelpe deg med å opprette en hvilken som helst funksjonalitet du liker.
En enkel kortkode
Shortcode API fungerer veldig enkelt: Først må du opprette en tilbakeringingsfunksjon som vil løpe når som helst kortkoden brukes. da må du knytte den funksjonen til en bestemt kortkode som gjør den klar til bruk. Koden er ofte plassert i functions.php-filen, men hvis du planlegger å ha mange kortkoder, er det fornuftig å lage en egen fil og inkludere den filen i din functions.php-fil.
I vårt første eksempel vil vi lage en kortkode som vil skape noe lorem ipsum hver gang vi skriver inn [lorem] i redaktøren. Først må vi opprette tilbakeringingsfunksjonen som returnerer lorem ipsum (i kortkoder vi ikke ekko noe, 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.';}Deretter må vi legge til denne kortnummeret til WordPress ved hjelp av add_shortcode- funksjonen i enten vår functions.php-fil eller en fil som er inkludert i den. Denne funksjonen legger til kortnummeret og binder den til funksjonen vi nettopp har opprettet. add_shortcode tar bare to argumenter, den første er navnet vi vil ha denne koden til å ha (hva vi skal skrive mellom firkantede parenteser) og den andre er den funksjonen vi vil legge til den kodenavn:
add_shortcode('lorem', 'lorem_function');Det er alt som trengs for å lage en enkel shortcode i WordPress.
Legge til parametere
Fortsetter med denne dummyinnholdsideen, trenger vi ofte bilder i innholdet vårt når vi forbereder våre mockups, og disse bildene må være forskjellige størrelser, så nå lager vi en kortnummer for å sette inn et bilde som dette:
[picture width="500" height="500"]Når WordPress møter dette, ønsker vi en funksjon som vil sette inn et bilde. Den må lese bredde- og høydeattributtene, men bare hvis vi også skal angi standardverdier slik at den kan brukes uten attributtene. Fordi vi kanskje ikke har et bilde tilgjengelig, skal vi bruke lorempixel.com tjeneste for å gi oss et tilfeldig bilde.
Først må vi opprette funksjonen:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Vi kalt denne funksjonen random_picture og siden denne shortcode vil kunne ta argumenter ga vi den $ atts parameteren. For å kunne bruke attributter trenger vi to funksjoner: shortcode_atts som er en WordPress-funksjon som kombinerer våre attributter med kjente attributter og fyller inn standard når det trengs; og ekstraktet PHP-funksjonen som, som navnet antyder, trekker ut de attributene vi angir for vår kortkode. Endelig returnerer funksjonen verdien vi ønsker, i dette tilfellet HTML-koden for bildet vårt kombinert med bredde- og høydevariablene.
Det eneste du må gjøre er å registrere denne koden:
add_shortcode('picture', 'random_picture');Vårt kortnummer er fullført, når vi skriver [bilde] vil det gi oss et tilfeldig bilde 400 med 200, og hvis vi bruker attributter, kan vi lage et bilde av hvilken som helst størrelse vi ønsker.
Konklusjon
Å lage små kortkoder for ting vi bruker ofte, hjelper oss definitivt når du skriver blogginnlegg fordi du kan gjøre alt du vil med kortkoder, det kan være like enkelt som å returnere en setning eller like komplisert som å legge til et skjema eller de siste innleggene sortert etter måned.
Har du opprettet nyttige kortkoder for WordPress? Hvilke kortkoder ønsker du eksistert? Gi oss beskjed i kommentarene.
Utvalgt bilde / miniatyrbilde, kode bilde via Marjan Krebelj.