Folosind codurile scurte WordPress și câmpurile personalizate pentru notele de subsol

În ceea ce privește designul și dezvoltarea web, lucrurile pe care le puteți face cu WordPress sunt aproape nelimitate. Aveți posibilitatea să rulați un agregator de știri, să creați o platformă de cultură, să vindeți bilete pentru primul concert al trupei, să afișați arta într-o galerie virtuală și așa mai departe.

Puteți de asemenea să creați o clona Wikipedia și să imități caracteristicile sale ca o secțiune "tabel de conținut" sau referințe încrucișate legate. În acest tutorial, vom face uz de coduri scurte și câmpuri personalizate pentru a crea o secțiune de lucru "Note".

Introducerea notei de subsol

Am fost contactat de un profesor universitar care a dorit să publice o parte din articolele sale online. Avea acest mic ... edu.tr/~hisname/ pagina de pornire și a decis că a fost timpul să mutați conținutul într-un site web "real" și el a auzit că WordPress ar fi alegerea potrivită pentru a fi utilizat ca sistem de management al conținutului.

După cum știți, lucrările științifice pot include mai multe comentarii, citări și referințe externe pe care le numim, în general, note de subsol. Când a spus că dorește ca articolele sale să fie mai interactive, m-am gândit imediat la funcționalități similare în Wikipedia și am început să caut pluginuri care oferă acest tip de serviciu. 

Deși am găsit unul, printre mulți, am crezut că ar fi un exercițiu drăguț dacă am încercat să creez propriul plugin pentru adăugarea de note de subsol. În acest scop, am făcut tocmai acest lucru și voi merge prin procesul de-a lungul restului acestui articol.

Construirea Pluginului pentru notele noastre

Procesul de creare a plugin-ului nostru va fi relativ ușor, chiar și pentru dezvoltatorii începători. Noi vom:

  • creați fișierul plugin
  • construiți codul nostru scurt,
  • codificați funcția subsolului nostru
  • scrieți o altă funcție care adaugă notele de subsol la conținutul mesajului prin conectarea la continutul.

Bucată de tort, bine? 

Dacă sunteți un începător dornic să învețe elementele de bază ale dezvoltării plugin-ului WordPress, acest tutorial are doar cantitatea potrivită de informații pentru a începe. Și dacă sunteți puțin mai avansat, acest tutorial vă poate oferi idei bune.

1. Creați fișierul Plugin

Dacă sunteți familiarizați cu plugin-uri (cum ar fi construirea unui fișier sau chiar vizualizarea codului sursă al unuia), veți ști că trebuie să pornim fișierele principale ale plugin-ului nostru cu următoarele informații antet:

Toate liniile sunt auto-explicative, așa că nu voi intra în detaliu spunându-vă că versiunea reprezintă numărul versiunii pluginului. 

Cu toate acestea, există câteva sfaturi pe care le pot da:

  • Singura linie necesară este linia "Plugin Name"; restul este opțional (dar foarte util).
  • Puteți folosi un cod HTML simplu în linia "Descriere".
  • Există și alte "nume de antet" pe care le puteți găsi în pagina "Antet fișier" din Codul.

Acum, am terminat cu anteturile, să trecem la pasul în care construim codul nostru scurt!

2. Creați codul scurt

Dacă citiți tutorialele mele mai vechi, vă veți aminti că eu dragoste API-ul Shortcode. Ca atare, aceasta este partea mea preferată.

Așa cum am spus mai devreme, scopul codului nostru scurt va fi afișarea numărului notei noastre de subsol, pe care o puteți specifica drept parametru. Deoarece sunt doar câteva linii simple de cod, să scriem codul și să îl revedem imediat după:

 '1',), $ atts)); întoarcere '['. id id. „]„;  add_shortcode ('ref', 'footnotes_sc'); ?>

După cum puteți vedea, codul este foarte simplu. Iată ce face:

  • Am creat o funcție numită footnotes_sc,
  • Am creat un singur parametru numit id (cu o valoare implicită de "1") și a transformat-o într-o variabilă cu extrage() funcţie,
  • Noi întoarcere un șir simplu, cu o legătură cu nota de subsol corespunzătoare,
  • Și, în cele din urmă, am stabilit un shortcode numit [Ref] și ne-a cuprins footnotes_sc () funcția la acesta.

De-acum inainte; de fiecare dată când folosim [Ref] shortcode (unde X este codul de subsol), WordPress va imprima numărul de referință ca [1].

3. Crearea funcției de notă de subsol

Pentru a face de fapt note de subsol, trebuie să folosim "câmpurile personalizate" ale WordPress. Funcția de mai jos nu este "cod avansat", dar din moment ce este un pic mai lung, am putea să îl documentăm pas cu pas. Începem:

 $ get_post_meta);  // dacă $ footnotes_array NU este gol ... if (count ($ footnotes_array)> 0) // ... începe variabila de ieșire $ cu un DIV ... $ output = '
„; // ... folosiți valorile implicite ale argumentelor funcției $ output = = '<' . $titletag . '>". titlul $. '„; $ output = '<' . $listtag . '>„; // listați notele de subsol cu ​​prefixul de referință corespunzător ($ footnotes_array ca notă de subsol) foreach (notă de subsol $ ca $ ref_id => $ footnote_content) $ output. = '
  • ". $ footnote_content. '
  • „; // închide etichetele HTML $ output = = '„; $ output = '
    „; // și returnați variabila de ieșire $ dacă este un singur mesaj sau pagină dacă (is_singular ()) return $ output;

    Pe scurt; am salvat posta noastră meta într-o matrice, am umplut $ ieșire variabil, transformând notele de subsol într-o listă HTML și returnate $ ieșire. Ușor ca o plăcintă.

    Folosind pluginul pentru notele noastre

    Utilizarea pluginului este destul de simplă: dacă adăugați câmpuri personalizate numite ref-1, -Ref 2, ref-3 și așa mai departe, o secțiune "Note" va apărea imediat după articolul dvs. Și am acoperit deja modul de utilizare a codului scurt, deci tot ce trebuie să faceți.

    Înfășurarea în sus

    Acum, că avem o funcție care returnează o listă HTML a notelor de subsol, este timpul să adăugăm această listă în articolele noastre!

     

    Aceasta este probabil cea mai ușoară parte a codului nostru, deoarece suntem numiți doar funcția noastră anterioară de a adăuga rezultatul după conținutul postului, apoi apelați această nouă funcție la continutul filtru.

    Dacă nu doriți să adăugați automat secțiunea "Note de subsol" de sub conținut, continuați și eliminați aceste linii. În schimb, va trebui să utilizați un pic de cod în tema dvs. în locul în care doriți să afișați notele de subsol ale articolului. De asemenea, puteți schimba argumentele implicite ale funcției.

    Concluzie

    În cele din urmă, profesorul mi-a plăcut cu adevărat ceea ce am făcut cu funcția "note de subsol" și cred că mai folosește site-ul pe care l-am construit - a folosit pagina sa de peste 10 ani și probabil va folosi WordPress mai mult timp. Sper că ți-a plăcut și el. Dacă doriți să accesați codul complet, îl puteți găsi aici.

    Aveți ceva de adăugat? Vă rugăm să împărtășiți-vă gândurile cu noi comentând mai jos. Și dacă ți-a plăcut acest tutorial, nu uita să o împărți cu prietenii tăi!