WordPress-kortkoder brukes til å 1) redusere mengden kode du trenger å skrive; 2) forenkle bruken Av WordPress-plugins, temaer og andre funksjoner. De oppfører seg som makroer, når du setter inn en snarvei, erstattes den med en kodebit. Det kan være hva som helst.

WordPress kommer med noen forhåndsdefinerte kortkoder, som og , og de er også inkludert med mange populære plugins og temaer. Du kan også lage dine egne kortkoder for å gjøre ting som å lage kolonner på WordPress-nettstedet ditt.

i dette innlegget tar vi deg trinnvis gjennom prosessen med å lage og bruke dine egne kortkoder. Vi vil lede deg gjennom hele prosessen med å lage en ny snarvei og vise deg hvordan du kan endre og kontrollere snarvei attributter og funksjoner.

Vær oppmerksom på at dette er et mer avansert innlegg som vil gå inn i detaljer om hvordan du lager kortkoder. Hvis du jobber med kode, er det utenfor din tekniske kompetanse, og du vil bare ha den enkleste måten å komme i gang med å lage og bruke kortkoder, kan det være lurt å starte med et kortkodeplugin.

Når du lager dine egne kortkoder, er det to ting du må gjøre:

1. Opprett kortkodehandlerfunksjonen. En snarvei funksjon er en funksjon som tar valgfrie parametere (attributter) og returnerer et resultat.
2. Registrer shortcode handler-funksjonen. Bruk den innebygde WordPressadd_shortcut funksjon for å registrere tilpassede kortkoder.

Forbereder WordPress For Tilpassede Kortkoder

Selv Om det ikke er nødvendig, er det en god ide å beholde dine egendefinerte kortkoder i sin egen fil. Alternativt kan du legge dem til temaetsfunctions.php fil.

opprett Først en ny fil med navnetcustom-shortcodes.php, og lagre den i samme mappe som temaets functions.php fil.

deretter, i den nyopprettede filen, legg til følgende kodeblokk:

<?php ?>

neste, åpnefunctions.php fil, og legg til følgende kodelinje:

include('custom-shortcodes.php');

Du er nå klar til å begynne å legge til dine egendefinerte kortkoder.

Grunnleggende Kortkoder

i dette første eksemplet skal vi lage en grunnleggende WordPress-kortkode som setter Inn Dagen For Indie avatar-bildet nedenfor.

Opprette Snarvei

det første trinnet er å opprette snarvei funksjon. Inne i custom-shortcodes.php – filen, legg til følgende blokk med kode:

function dotiavatar_function() { return '<img src="http://dayoftheindie.com/wp-content/uploads/avatar-simple.png" alt="doti-avatar" width="96" height="96" class="left-align" />';}

i kodeeksemplet ovenfor returnerer dotiavatar_function-funksjonen et forhåndsbestemt bilde kalt avatar-simple.png.

det neste trinnet er å registrere kortnummeret Med WordPress ved hjelp av den innebygde funksjonen add_shortcode. Fortsatt inne custom-shortcodes.php, legg til følgende kodelinje:

add_shortcode('dotiavatar', 'dotiavatar_function');

når du registrerer en snarvei ved hjelp av add_shortcode funksjon, passerer du i snarvei tag ($tag) og tilsvarende funksjon ($func)/krok som vil utføre når snarveien brukes.

i dette tilfellet er snarveien dotiavatar og kroken er dotiavatar_function.

Merk: når du navngir koder, bruker du bare små bokstaver og ikke bindestreker.

Bruke Snarvei

Nå som du har snarvei opprettet og registrert, er det på tide å prøve det ut! Når DU vil AT doti-avataren skal vises inne i postinnholdet, kan du bruke kortnummeret i stedet:

Kortkoder med Parametere (Attributter)

DET FORRIGE EKSEMPLET var det ikke mye plass til å endre ting. La oss si, i stedet for å trykke på et enkelt bilde, vil vi gjerne kunne angi hvilket bilde som skal brukes ved hjelp av en parameter. Du kan gjøre det ved å legge til noen attributter ($atts).

igjen, innecustom-shortcodes.php, legg til en annen funksjon, slik som:

function dotirating_function( $atts = array() ) { // set up default parameters extract(shortcode_atts(array( 'rating' => '5' ), $atts)); return "<img src=\"http://dayoftheindie.com/wp-content/uploads/$rating-star.png\" alt=\"doti-rating\" width=\"130\" height=\"188\" class=\"left-align\" />";}

funksjonen ovenfor godtar en enkelt parameter: rating. Hvis en rating – verdi ikke er bestått, bruker den en standard strengverdi av 5. Det gjør dette ved å pakke ut attributtene ved hjelp av den innebygdeshortcode_atts – funksjonen, og kombinere standardverdiene med verdier som kan ha blitt sendt inn i funksjonen.

Ikke glem å registrere snarvei:

add_shortcode('dotirating', 'dotirating_function');

med snarvei funksjon opprettet, og kroken lagt, er snarvei nå klar til å brukes inne innlegget ditt innhold:

Alternativt kan du utelate rating, Og Bare gå med standardverdien:

og det er det! Du vet nå hvordan du lager Selvlukkende WordPress-kortkoder. Men det er en annen type du kan opprette.

Omslutter Kortkoder

frem til nå har vi jobbet med selvlukkende kortkoder. Men det er en annen type kortkode: omslutter kortkoder.

Omsluttende kortkoder lar deg bruke Et BBCode-stilformat. Det vil si en stil som ser slik ut:

content

Omsluttende kortkoder er nyttige når du trenger å manipulere det vedlagte innholdet. For eksempel, la oss si at du har en bestemt stil av knappen du bruker nettstedet ditt; DU kan bruke HTML-koden til å generere den knappen / stilen hver gang du trenger å bruke den, eller du kan sette opp en tilpasset omsluttende kortnummer i stedet.

ved å bruke en omsluttende snarvei, kan du holde fokus på innholdet, i stedet for på koden.

Opprette Snarvei

igjen, inne icustom-shortcodes.php fil, legge til følgende blokk med kode:

function dotifollow_function( $atts, $content = null ) { return '<a href="https://twitter.com/DayOfTheIndie" target="blank" class="doti-follow">' . $content . '</a>';}

i kodeblokken ovenfor, $content = null brukes til å identifisere denne funksjonen som en omsluttende snarvei. Og inne i den funksjonen pakker du innholdet ditt ($content) i HTML-koden.

OK, nå er det på tide å registrere kortnummeret:

add_shortcode('dotifollow', 'dotifollow_function');

Og Det er det! Din snarvei er klar til bruk.

Bruke Snarvei

Bruke en omsluttende snarvei er ikke mye annerledes enn å bruke en selvlukkende en. Som HTML må du bare sørge for at du har en åpning og en avsluttende setning:

Follow us on Twitter!

Selvfølgelig er dette bare et grunnleggende eksempel. Du kan også legge til parametere til en omsluttende snarvei, som du gjør med en selvlukkende snarvei.

Inne custom-shortcodes.php, legge til en funksjon:

function dotibutton_function( $atts = array(), $content = null ) { // set up default parameters extract(shortcode_atts(array( 'link' => '#' ), $atts)); return '<a href="'. $link .'" target="blank" class="doti-button">' . $content . '</a>';}

og deretter registrere snarvei:

add_shortcode('dotibutton', 'dotibutton_function');

Denne nye funksjonen lar deg sette en link for knappen ved hjelp av følgende syntaks:

Shop Now!

med omsluttende kortkoder kan du gjøre mye med svært lite kode.

et Ord om Widgets

som standard støttes kortkoder bare i innlegg, sider eller tilpassede innleggstyper; de støttes ikke i sidebar widgets. For å legge til støtte for widgets, må du legge til følgende kode tilfunctions.php fil:

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

når du gjør det, kan du bruke kortkoder i widgets – akkurat som du gjør i innlegg/sider.

Innpakning Ting opp

Legge til dine egne kortkoder tar ikke mye arbeid-spesielt når du forstår hvordan de er implementert. Hvis du vil lære mer, sjekk Ut WordPress codex.