Komme i gang med WordPress-kortkoder

I denne artikkelen vil du få en detaljert forklaring på WordPress 'shortcode API og lære å lage en shortcode? den riktige måten. Du vil da bli vist noen nyttige eksempler på mer avanserte kortkoder og hvordan du kan kode dine egne tilpassede variasjoner! Klar til å legge til en ny ferdighet i vesken din? La oss komme i gang!

Hva er kortkoder?

Kortkoder ble introdusert i WordPress 2.5. For å sette ting enkelt, er en kortkode a snarvei. De er WordPress-spesifikke kodestykker som lar deg spare tid og gjøre ting som ellers ville kreve teknisk kunnskap og muligens store mengder kode. Ved å legge til kortkoder til temaene eller programtilleggene dine, kan du gjøre det lettere og intuitivt å bruke det. Du kan for eksempel ha en kortkode [Most_popular_post] det da skrevet ut akkurat slik ville vise det mest populære innlegget på ditt WordPress-nettsted. Hvis du vil gjøre dette manuelt, må du skrive noen HTML-koden, så vel som å endre det manuelt etter hvert som innleggets popularitet endret seg. En kortnummer fjerner behovet for dette, og forenkler ting for deg.

En shortcode er en WordPress-spesifikk kode som lar deg gjøre smarte ting med svært liten innsats. Kortkoder kan legge inn filer eller lage objekter som normalt krever mye komplisert, stygg kode på bare én linje.
Shortcode = snarvei.
-WordPress.com

Hvordan opprettes kortnummer?

Kortkoder blir opprettet ved hjelp av WordPress shortcode API. de jobber mye som WordPress-filtre. Du må definere en behandleren funksjon som analyserer kortnummeret og returnerer litt utgang. Du registrerer deretter kortnummeret ved hjelp av add_shortcut () funksjon. En snarveierhåndteringsfunksjon aksepterer opptil tre argumenter, oppført nedenfor:

$ att: En rekke av eventuelle shortcode attributter
$ innhold: Eventuelt innhold som kortnummeret kan legge til
$ kode: Kortnummernavnet (brukes vanligvis når samme håndterer brukes til flere kortnummer

Jeg skjønner at dette kan virke litt forvirrende for deg, så her er noen eksempler på hva disse argumentene kan være, ved hjelp av en hypotetisk kortkode wptuts.

 [wptuts]

$ att = array ()
$ innhold = null

 [wptuts] Lorem ipsum dolor sit amet [/ wptuts]

$ att = array ()
$ innhold = Lorem ipsum dolor sit amet

 [wptuts navn = "noe navn"]

$ att = array ('id' => '555', 'navn' => 'noe navn')
$ innhold = null

 [wptuts] Lorem ipsum dolor sit amet [/ wptuts]

$ att = array ('id' => '555')
$ innhold = Lorem ipsum dolor sit amet

Det bør gi deg en god ide om hvordan argumenter sendes til kortnummerbehandleren.

Merk: Kortkoder er selvomslutter. Derfor, [wptuts] er det samme som [wptuts /]. Du trenger bare å bruke åpning og lukking av kortkode-koder når det er innhold i mellom.

Opprett din første kortkode

Nå som du har lært grunnleggende om shortcode API, kan du gå videre og opprette din første kortkode. Jeg vil bruke TwentyEleven-temaet som følger med WordPress, og skjermbilder vil gjenspeile dette, men du kan bruke et hvilket som helst tema etter eget valg, eller til og med skrive et plugin.

Å begynne, åpne opp functions.php fil av temaet, og legg til denne linjen med kode til toppen:

 inkludere 'shortcodes.php';

Din functions.php skal se slik ut:

Deretter lager du filen du bare refererte til - shortcodes.php. For å gjøre det enklere, vil alle våre kortkoder være i denne filen. For å begynne, vil vi opprette en veldig enkel snarvei som genererer en link til Tweet postadressen. Lag en funksjon wptuts_first_shortcode () og fyll den inn med denne koden:

function funksjon wptuts_first_shortcode ($ atts, $ content = null) $ post_url = get_permalink ($ post-> ID); $ post_title = get_the_title ($ post-> ID); $ tweet = 'Del på Twitter'; returnere $ tweet;  add_shortcode ('twitter', 'wptuts_first_shortcode');

Din første kortnummer er nå klar til å gå! Du kan prøve det ved å skrive [Twitter] inn i et innlegg. Her er et eksempel på produksjonen din:

Flere kortkoder

Nå som du har opprettet en grunnleggende kortkode, kan vi gå videre og lage noen flere snarveier som bruker de forskjellige argumentene som $ att og $ innhold.

Legge sammen en YouTube-video

En YouTube-innebygd kortkode tjener en stor hensikt siden innebygd en video krever kodingskunnskap; med en kortkode, effor krever er betydelig redusert. I tillegg kan denne teknikken brukes til å lage kortnummer som kan legge inn andre videoer eller til og med medier som bilder eller lydfiler. Lim inn denne koden i shortcodes.php:

 funksjonen wptuts_youtube ($ atts, $ content = null) ekstrakt (shortcode_atts (array ('id' => ", $ atts)); $ return = $ content;

"; $ return. = ''; returnere $ return;  add_shortcode ('youtube', 'wptuts_youtube');

Legg merke til hva vi gjør her. Kortnummeret har et enkelt attributt: video-ID-en (som kan hentes fra nettadressen til en youtube video). Funksjonen shortcode_atts () ( fungerer mye som wp_parse_args (). Det analyserer attributter og bruker det angitte valget som en av standardene. Den returnerte verdien er en matrise med alle tastene fra den første gruppen, erstattet med de tilsvarende verdiene i $ att array, hvis tilstede. Hvis innholdet mellom shortcode tags ikke er tomt, viser vi det, legger til et par linjeskift og legger inn videoen. Prøv det! Koden jeg brukte var:

 [youtube] Sjekk ut denne videoen! [/ youtube]

Her er resultatet:

Vis siste innlegg fra bloggen

Et annet eksempel på en flott kortkode er en som viser det siste blogginnlegget. Fordelen med dette er at hver gang et nytt innlegg kommer ut, er det ikke nødvendig med manuell oppdatering. Her er koden:

 funksjon wptuts_recentpost ($ atts, $ content = null) $ getpost = get_posts (array ('number' => 1)); $ getpost = $ getpost [0]; $ return = $ getpost-> post_title. "
". $ getpost-> post_excerpt."? "; $ return. ="
ID). "">Les mer ?"; return $ return; add_shortcode ('newestpost', 'wptuts_recentpost');

Det vi gjør er å bruke get_posts () funksjon for å hente det siste innlegget og vise tittelen, utdraget og en lenke til innlegget. Kortnummeret har ingen attributter, men du kan for eksempel legge til attributter for å vise innlegg fra en bestemt kategori eller vise et brukerdefinert antall nyeste innlegg. Du kan prøve kortnummeret med denne koden:

Sjekk ut vårt siste innlegg: 
 [Newestpost]

Slik ser det ut:

Pakke det hele opp

Det er noen flere ting som kan komme til nytte når du dykker inn i mer avansert kortkodeutvikling.

Fjerner kortnummer: Kortnummer kan fjernes ved hjelp av remove_shortcode () funksjon. Bruk er remove_shortcode ($ shorcodename). Du kan også fjerne alle kortkoder ved hjelp av funksjonen remove_all_shortcodes ()
Bruk av kortnummerfilteret: Som standard skanner WordPress innleggets innhold for snarveier og bruker dem. Det er imidlertid to tilfeller der du kanskje vil uttrykkelig fortelle WordPress å analysere kortkoder i en streng. For dette trenger du do_shortcode ($ innhold) funksjon. Det første tilfellet er for nestede kortkoder - bare bruk do_shortcode på $ innhold sendt til deg, dvs. i stedet for returnere $ content;, bruk returner do_shortcode ($ content). Dette vil sikre at nestede snarveier behandles.
Det andre scenariet der du kanskje vil ha dette, er når du vil at ikke-postinnhold skal skannes for kortkoder. Hvis du for eksempel vil at innholdet av widgets skal analyseres, kan du bare legge til dette filteret:
```
 add_filter ('widget_text', 'do_shortcode');
```
(kilde: kortnummer i widgets)

Hopefull du har lært en god mengde om WordPress-kortkoder nå. Du vil nå kunne lage en rekke kortkoder som forenkler og effektiviserer WordPress, og brukerne, enten det er deg selv eller dine kunder, vil takke deg for det!

Ønsker flere kortkoder?

Ta en titt på vår nyeste "Resource Roundup" på de beste og mest kreative kortkodene der ute akkurat nå!

Kode