Använda WordPress-kortkoder och anpassade fält för fotnoter

När det gäller webbdesign och utveckling är de saker du kan göra med WordPress nära gränslösa. Du kan köra en nyhetsaggregat, skapa en crowdfunding plattform, sälja biljetter till ditt bands första konsert, visa din konst i ett virtuellt galleri och så vidare.

Du kan också skapa en Wikipedia-klon och efterlikna dess funktioner som en "innehållsförteckning" eller länkade korsreferenser. I denna handledning ska vi använda kortnummer och anpassade fält för att skapa en fungerande "Fotnoter" sektion.

Presentation av fotnoter

Jag kontaktades av en universitetsprofessor som ville publicera några av hans artiklar online. Han hade den här lilla ... edu.tr/~hisname/ hemsida och bestämde att det var dags att flytta innehållet till en "riktig" hemsida och han hörde att WordPress skulle vara det rätta valet att använda som ett innehållshanteringssystem.

Som du vet kan vetenskapliga artiklar innehålla många kommentarer, citat och externa referenser som vi allmänt hänvisar till som fotnoter. När han sa att han ville att artiklarna skulle bli mer interaktiva tänkte jag omedelbart på liknande funktionalitet i Wikipedia och började leta efter plugins som erbjuder denna typ av tjänst. 

Även om jag hittade en bland många tyckte jag att det skulle vara en trevlig övning om jag försökte skapa en egen plugin för att lägga till fotnoter. För det ändamålet gjorde jag just det och kommer att gå igenom processen under resten av denna artikel.

Bygga våra fotnoter Plugin

Processen att skapa vårt plugin kommer att vara relativt enkelt, även för nybörjareutvecklare. Vi ska:

• skapa vår pluginfil
• bygga vår kortnummer,
• koda vår sidfotsfunktion
• skriv en annan funktion som lägger fotnoter till inlägget genom att haka till innehållet.

Kaka, rätt? 

Om du är en nybörjare som vill lära dig grunderna i WordPress plugin-utveckling, har denna handledning precis rätt mängd information för att komma igång. Och om du är lite mer avancerad kan den här handledningen ge dig bra idéer.

1. Skapa pluginfilen

Om du är bekant med plugins (som om du bygger en eller ens tittar på källkoden för en) vet du att vi måste starta huvudfilerna i vårt plugin med följande rubrikinformation:

Linjerna är alla självförklarande, så jag kommer inte att gå in i detalj genom att säga att versionen representerar versionsnumret för din plugin. 

Även om det finns några tips jag kan ge:

• Den enda obligatoriska raden är "Plugin Name" -linjen; resten är valfri (men mycket hjälpsam).
• Du kan använda en viss enkel HTML-kod i "Beskrivning" -raden.
• Det finns några andra "header names" som du kan hitta på "File Header" -sidan i Codex.

Nu är vi färdiga med rubrikerna, låt oss gå vidare till det steg där vi bygger vår kortnummer!

2. Skapa kortnummer

Om du läser mina äldre handledning kommer du ihåg att jag kärlek Shortcode API. Som sådan är detta min favorit del.

Som tidigare sagt är syftet med vår kortnummer att visa numret på vår fotnot, som du kan ange som en parameter. Eftersom det bara är några enkla kodrader, låt oss skriva koden nu och granska direkt efter:

 '1',), $ atts)); lämna tillbaka '['. $ id. ']';  add_shortcode ('ref', 'footnotes_sc'); ?>

Som du kan se är koden verkligen väldigt enkel. Så här gör det:

• Vi skapade en funktion som heter footnotes_sc,
• Vi skapade bara en namngiven parameter id (med ett standardvärde på "1") och förvandlade det till en variabel med extrahera() fungera,
• Vi lämna tillbaka en enkel sträng med en länk till motsvarande fotnot,
• Och slutligen ställer vi in ​​en kortkod som heter [Ref] och hakade våra footnotes_sc () funktion till det.

Från och med nu; varje gång vi använder [Ref] shortcode (där X är fotnot ID), kommer WordPress skriva ut referensnumret som ^[1].

 $ get_post_meta);  // om $ footnotes_array är INTE tom ... om (räkna ($ footnotes_array)> 0) // ... starta $ output variabeln med en DIV ... $ output = '
'; // ... använd standardvärdena för funktionens argument $ output. = '<' . $titletag . '>'. $ titel. ''; $ output. = '<' . $listtag . '>'; // lista fotnoter med motsvarande referens-ID föreach ($ footnotes_array som $ fotnot) foreach ($ fotnot som $ ref_id => $ footnote_content) $ output. = '
'. $ footnote_content. '
';  // stäng HTML-taggarna $ output. = ''; $ output. = '
';  // och returnera $ output variabeln om det är ett enda inlägg eller en sida om (is_singular ()) return $ output;  

 
Det här är förmodligen den enklaste delen av vår kod eftersom vi bara ringer till vår tidigare funktion för att lägga till dess utdata efter inläggets innehåll och sedan koppla den här nya funktionen till innehållet filtrera.
 
Om du inte automatiskt vill lägga till avsnittet "Fotnoter" under innehållet, fortsätt och ta bort dessa rader. I stället måste du använda en liten bit kod i ditt tema som  På platsen vill du visa artikelns fotnoter. Du kan också ändra standardargument för funktionen.
 
Slutsats
 
I slutändan tyckte professorn verkligen om vad jag gjorde med "fotnoter" funktionalitet och jag tror att han fortfarande använder webbplatsen jag byggt - han använde sin hemsida i över 10 år och han brukar använda WordPress längre. Jag hoppas att du gillade det också. Om du vill komma åt hela koden kan du hitta den här.
 
Har du något att lägga till? Vänligen dela dina tankar med oss ​​genom att kommentera nedan. Och om du gillade den här handledningen, glöm inte att dela den med dina vänner!



		
			
	   
	




Koda