WordPress introduserte snarvei API seks år siden med utgivelsen Av WordPress 2.5. Kortkoder brukes nå av Et stort antall WordPress-plugins for å tillate brukere å legge til innhold i sine innlegg og sider.
the shortcode API lar deg lage dine egne kortkoder ved å legge funksjoner til tema funksjoner.php mal (dette ligger på www.yourwebsite.com/wp-content/themes/yourtheme/).
I tillegg til å lage dine egne kortkoder, WordPress inneholder også fem standard kortkoder Med WordPress kjerne:
- lyd-Lar deg legge inn lydfiler.
- caption-Lar deg bryte bildetekster rundt innhold. Det brukes ofte med bilder.
- embed-Lar deg legge inn et bredt spekter av innhold som video, lyd og tweets.
- galleri-Lar deg sette inn bildegallerier.
- video-Lar deg legge inn videofiler.
selv om Standard wordpress kortkoder er ofte brukt, svært Få WordPress brukere dra nytte av snarvei API og design unike kortkoder for deres hjemmeside. I denne opplæringen vil jeg gjerne vise deg hvor rett frem det er å forbedre nettstedet ditt med tilpassede kortkoder.
før du begynner, må du sørge for at du tar en sikkerhetskopi av funksjoner.php og andre filer du redigerer før du gjør endringer med ditt live nettsted.
Opprette En Snarvei-Et Grunnleggende Eksempel
for å gi deg en god forståelse av Hvordan WordPress Snarvei API fungerer, la oss starte med en grunnleggende snarvei funksjon.
husk at kortkoder skal opprettes for innhold og funksjonalitet som du bruker ofte. Hele poenget med å bruke kortkoder er å spare noen tid. Hvis du bare skal bruke noe en gang, er det ikke mye poeng i å lage en kortkode for den.
jeg skriver rundt et dusin artikler per uke. En ting jeg gjør ofte er å oppmuntre de som likte artiklene mine til å abonnere på bloggen min (eller bloggen jeg skriver for). Jeg skriver for tiden dette ut hver gang, men jeg kunne spare meg mye tid ved å lage en kortkode for teksten.
for å gjøre dette kan jeg legge til en funksjon som dette i temaets funksjoner.php template:
De av dere som ikke har noen kodingserfaring, kan finne koden ovenfor litt skremmende, men det er lett å forstå når du bryter koden ned linje for linje.
det første vi gjør er å legge til en kommentar over vår funksjon. Dette vil hjelpe oss raskt å se hva vår funksjon er for når vi ser koden på et senere tidspunkt.
// Function to add subscribe text to posts and pages
vi definerer deretter vår funksjon. Jeg liker å bruke navn som er selvforklarende, så jeg har kalt min funksjon «subscribe_link_shortcode».
function subscribe_link_shortcode() {
neste definerer vi meldingen vår. Returerklæringen vil vise vår melding når den kalles. Det lagrer også meldingene (i motsetning til echo, som vil skrive ut det, men ikke lagre det).
funksjonen lukkes da.
}
vi definerer deretter kortnummeret selv ved hjelp av add_shortcode-funksjonen. Den første variabelen som er angitt definerer kortnummeret som skal brukes, og den andre variabelen kaller vår funksjon (dvs. den vi definerte ovenfor).
add_shortcode('subscribe', 'subscribe_link_shortcode');
etter lagring av funksjonene.php mal, kan vi nå ringe vår melding når vi ønsker å bruke snarvei abonnere.
bruke abonner snarvei i et innlegg eller side vil gi følgende melding:
hvis du likte denne artikkelen, oppfordrer jeg deg til å abonnere På Elegant Temaer blogg VIA RSS.
jeg brukte en enkel melding i mitt eksempel, men du kan endre dette for å vise mange andre ting. Du kan for eksempel opprette en snarvei for visning av adsense-annonser eller et abonnementsskjema for nyhetsbrevet, og deretter sette dem inn hvor du vil i artiklene dine.
Opprette En Snarvei med Attributter
Attributter kan utvide funksjonaliteten til kortkoder ved at du kan sende data gjennom kortkoder.
i eksemplet nedenfor vil jeg vise deg hvordan attributter kan brukes til å utvide funksjonen vi opprettet tidligere. Som du kan se, forblir mye av koden den samme.
$atts er navnet på vår attributt array. Vi bruker deretter ekstraktfunksjonen til å importere variabler fra vårt utvalg (via Shortcode_atts WordPress-funksjonen).
To attributter defineres deretter: subtype og og subtypeurl. Disse representerer typen abonnement og abonnementsadressen. Disse egenskapene kalles da i vårt budskap.
VÅR standard abonnementstype ER RSS og vår standard abonnement URL er http://feeds.feedburner.com/ElegantThemes. Denne informasjonen vises når ingen attributter er definert.
Derfor, når du legger til følgende i et innlegg:
vi vil få følgende utgang:
sørg for å abonnere på fremtidige Elegante Temaer oppdateringer AV RSS.
hvis vi definerer attributter, er utfallet annerledes. Følgende kode:
ville utgang:
sørg for å abonnere på fremtidige Elegante Temaer oppdateringer AV RSS.
sørg for å abonnere på fremtidige Elegante Temaer oppdateringer Av Twitter.
sørg for å abonnere på fremtidige Elegante Temaer oppdateringer Av Facebook.
sørg for å abonnere på fremtidige Elegante Temaer oppdateringer Av Google.
Selv om dette var et grunnleggende eksempel på hvordan attributter fungerer, er det lett å se hvordan plugin utviklere kan bruke snarvei API for å gjøre kompliserte funksjoner mer brukervennlig for brukerne.
Oversikt
hvis du følger trinnene nevnt i denne opplæringen, bør du nå ha en grunnleggende forståelse av hvordan du kan lage dine egne kortkoder for ditt nettsted. Kortkoder er en fin måte å gjøre kompliserte oppgaver enklere, så jeg oppfordrer Deg til å holde WordPress snarvei API i tankene i fremtiden.
ikke vær bekymret hvis denne opplæringen var litt vanskelig for deg. Alle Elegante Temaer design kommer pakket med kortkoder som gjør publisering vakkert innhold enkelt. Kortkodene kan brukes til å lage lysbildeserier, kolonner og tabeller. Den lar deg til og med passordbeskytte innholdet ditt.
jeg håper du har hatt denne opplæringen på å skape en unik snarvei For WordPress nettsted. I så fall oppfordrer jeg deg til Å abonnere På Elegante Temaer, da vi har noe bra innhold i rørledningen 🙂
Også, igjen, minner jeg deg om å sikkerhetskopiere filer før du redigerer dem.