Hur lägger man till en kortnummer i WordPress?

Har du någonsin haft en tid där du ville lägga till specialiserat innehåll till ditt WordPress-inlägg eller -sida, men var inte säker på hur? Kanske vill du bädda in en Twitter-widget eller något innehåll som kallas tillbaka från någon webbplats eller API. Hur kan du enkelt lägga till den här typen av innehåll i ditt WordPress-inlägg? Lyckligtvis ger WordPress något som kallas en kortnummer för att göra denna typ av uppgift extremt lätt. Denna handledning tar dig genom processen att bygga, installera och använda en kortnummer i din WordPress-installation. Låt oss börja med att se vad en kortnummer är.

Vad är en WordPress Shortcode?

Kortfattat är en kortnummer en specialkod som du kan skriva in i ett inlägg som ersätts med annat innehåll när du faktiskt tittar på posten på webbplatsen. Om du någonsin har inbäddat ett WordPress-galleri på din blogg så har du redan sett den inbyggda kortkoden .

När du laddar en bloggsida med [gallery] -koden, ersätter WordPress [gallery] -koden med all den kod som faktiskt visar ett galleri av dina bilder.

Som du kan se från det ovanstående exemplet, ser en kortnummer ut som en HTML-tagg, men är omslagen med fackhakparentes istället för vinklar. Den här koden ersätts med någon annan kod när sidan faktiskt är laddad i en webbläsare. Det riktigt coola är att WordPress låter dig skapa egna kortnummer för att visa ganska mycket! Du kan använda den för att mata ut en Youtube-video, visa dina senaste tweets, eller till och med anpassa det dock du vill.

Om det inte är meningslöst, låt oss titta på ett exempel. Låt oss säga att jag vill ge ut en AdSense-annons i mitt inlägg. Jag kunde gå in i HTML-läget för WordPress-innehållsredigeraren och kopiera och klistra in Adsense-kodblocket i det, men det skulle vara tråkigt och eventuellt distraherande med all extra markup i mitt inlägg. Dessutom skulle jag, om jag ville ändra annonsblocket, gå tillbaka till varje post för att ändra det till det nya. Ett enklare sätt och mer tillförlitligt sätt att lägga till Adsense-blocket varhelst jag ville skulle vara att använda en adsense shortcode. Kortnummeret kan se ut så här:

[Adsense] 

När du faktiskt tittar på inlägget på din webbplats kommer kortnummeret att ersättas med Adsense-annonsblocket. Så hur skapar du denna kortnummer? Självklart måste du berätta för WordPress vad som ska ersättas med kortnummer på något sätt. Låt oss titta på det där nästa.

Hur skapar jag en kortnummer?

Lyckligtvis gör WordPress det ganska enkelt att skapa egna kortkoder, så låt oss faktiskt gå om att implementera [adsense] kortnummer. Det första vi behöver göra är att definiera en funktion som matar ut den faktiska Adsense-koden. Alla följande kod kommer att gå i functions.php i ditt tema (det kan också gå i en fristående plugin-fil). Jag fattar? Ok, så låt oss titta på den funktionen.

 funktion get_adsense ($ atts) return '';  

Den här funktionen är ganska enkel - den returnerar bara min Google AdSense-kod som en sträng. Oavsett vilken funktion som returneras är vad min kortnummer kommer att ersättas med, så jag kunde eventuellt ha returnerat html för en Twitter-widget eller en lista över barnposterna i den här eller något annat.

Nu när vi har en funktion som returnerar vad vi vill, hur kopplar vi det till en kortnummer? Nu är det här där WordPress API kommer in. Återigen, låt oss titta på hur vi gör det och förklara vad som händer. Här är samtalet för att ställa in adsense shortcode.

 add_shortcode ('adsense', 'get_adsense'); 

Det är allt! Den första parametern som passerat är namnet på kortkoden, så i vårt fall säger "adsense" WordPress att skapa [adsense] -koden. Den andra parametern betecknar den funktion som ska ringas när den nya kortkoden uppträder. I vårt fall säger "get_adsense" att WordPress ska ersätta [adsense] med resultaten av vår get_adsense metod.

Inte så illa är det? Nu är det här en mycket enkel kortkod, med WordPress kan du göra mycket mer med dina kortkoder, inklusive att lägga till parametrar (kanske du vill välja mellan adsense-block?). Det fullständiga API kan ses på WordPress Codex.

Hur använder jag min kortnummer?

Den här sista delen är enkel, lägg bara till [adsense] -kodkoden i HTML- eller visuella vyerna av innehållsredigeraren för inlägg eller sidor. Det är allt! Du har skapat din första kortnummer.

John Gadbois är medejer och teknisk ledare på Domain Superstar, ett domännamn verktygssida. Han kör också CalculatorPro, en cool räknare webbplatser med alla typer av finansiella räknemaskiner. Han tycker om att lära sig om och koda med Ruby on Rails, jQuery, WordPress och PHP.