Share
WordPress Shortcode API ble introdusert til WordPress i versjon 2.5. Siden da har det blitt en mye brukt metode for å tillate rask tilpasning av layout og innføring av visse formateringsrapporter. Men kortkoder kan være like nyttige når du lager WordPress-temaer - her er hvordan du kan få full nytte av dem!
Kortkoder har mange fordeler hvis de brukes riktig i temafiler. Hvis du er kjent med preprosessor-makroer i C / C + +, kan kortkodene tjene en noe lignende funksjon i WordPress. Det grunnleggende formålet med å bruke en kortkode er å erstatte plassholderen med ditt eget tilpassede stykke HTML-kode når serveren sender siden til klientsiden. Trinnene som er involvert i opprettelse og implementering av kortkoder er som følger.
I denne Quick Tip, skal vi bruke kortnummer for å vise egendefinerte innlegg. Jeg har gitt en detaljert forklaring om hvordan du oppretter egendefinerte innleggstyper og bruker tomme temaer på Nettuts +, men for dette eksempelet vil vi endre standard TwentyTen-temaet som tilbys av WordPress.
Funksjonen du lager for kortnummeret, definerer faktisk formålet med kortnummeret. En grunnleggende funksjon kan defineres på følgende måte (du kan legge til all koden nederst på din functions.php-fil):
Accentsconagua
// Definere funksjonen som brukes til å vise egendefinert prosjektpost. funksjon project_shortcode ($ atts) // Utdrag av argumentene for kortnummeret. ekstrakt (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); / * Dette er hvor vi skal skrive koden for å hente data * og bygge HTML-strukturen som skal returneres i $ output-variabelen * / $ output = 'Dette vil inneholde den endelige HTML-utgangen for din tilpassede prosjektløkke.'; returnere $ output; Bare vær sikker på at du ikke legger noen hvite plass på slutten av functions.php-filen, da det kan føre til et problem. La oss nå legge til noen kode for å hente det egendefinerte innlegget "prosjektet" og bygge HTML-strukturen som erstatter vår kortkode.
funksjon project_shortcode ($ atts) ekstrakt (shortcode_atts (array ('limit' => '10', 'orderby' => 'date',), $ atts)); // Opprett egendefinert spørring for å hente prosjektet type egendefinert innlegg. $ loop = ny WP_Query (array ('post_type' => 'prosjekt', 'posts_per_page' => $ limit, 'orderby' => $ orderby)); // Looping gjennom innleggene og bygge HTML-strukturen. hvis ($ loop) while ($ loop-> have_posts ()) $ loop-> the_post (); $ output. = ''.Get_the_title ().'
'; $ output. = ''.Get_the_excerpt ().''; else $ output = 'Beklager, ingen prosjekter enda. Kom tilbake snart.'; // Nå returnerer vi HTML-koden tilbake til stedet der kortnummeret ble kalt. returnere $ output; '$ Atts' er attributter som følger med kortnummeret. PHPs ekstraktmetode brukes til å dele arrayelementene i variabler slik at de kan brukes direkte i funksjonen.
I dette eksemplet bruker vi attributter som er passert i funksjonen, for å lage et tilpasset søk for å hente "prosjektet" egendefinerte innleggsdata. Så løper vi gjennom alle prosjektpostene som returneres.
Innenfor sløyfen henter vi og legger til dataene i utgangsvariabelen med de riktige HTML-kodene. Når sløyfen er fullført, inneholder utskriftsvariabelen den komplette HTML-koden for vår prosjektliste. Denne HTML-koden returneres, og snarveien som brukes i temaet, erstattes av dette når siden lastes.
Nå som vi har opprettet funksjonen, må vi registrere den i databasen sammen med kortnummeret som skal brukes til det. Vi kan gjøre dette med
register_shortcode metode levert av WordPress.
add_shortcode ( 'prosjekter', 'project_shortcode');
Det første argumentet i denne metoden er navnet på kortnummeret som vi vil bruke i temaet, og det andre argumentet er navnet på funksjonen (som vi definerte ovenfor) knyttet til den aktuelle kodenavn. Slik forstår WordPress hva du skal gjøre når den korte koden er analysert eller oppstått.
WordPress gir en shortcode parsing metode som svært få utviklere vurdere å bruke alt som ofte. Do_shortcode-metoden kan brukes til å sette inn kortkoder i temafiler selv.
Kortkodesyntaxen ligner på hva du vil sette inn i redigeringsredigeren. I dette tilfellet passerer vi attributter for grensen for antall innlegg som skal vises, og hvordan du bestiller dem. Når vi viser "prosjekt" egendefinerte innlegg, vil vi opprette en ny dedikert sidemal og bruke kortnummeret i det. Opprett en mal som heter 'page-project.php' og bruk følgende:
Nå for å vise malen du nettopp opprettet, opprett en side som heter 'Project'. Åpenbart lage noen demo "Project" innlegg også!
Voila! Kortkoden viser de egendefinerte innleggene.
Som du kan se, hjelper ovennevnte metode for å lage en kortkode for egendefinerte innlegg og bruk av dem i temaet oss å holde temafilene håndterbare og rene. Dette har også en ekstra fordel at alle kan sette inn den egendefinerte innleggsløkken fra WordPress-backendredigeren også.
Eksemplet ovenfor viser hvordan vi kan bruke kortkoder under temautvikling på en effektiv måte. Det er mange innovative og produktive måter å benytte seg av kortnumre i WordPress-temaer - vær så snill å dele dine egne ideer i kommentarene!
