Un ghid pentru începători în Cadrul Titan Crearea unui metabox cu Titan

Titan Framework a simplificat într-adevăr sarcina de a crea metaboxi în proiectul dvs. de dezvoltare web. Înainte de Titan Framework, trebuia să scriu câteva coduri de lungă durată pentru a afișa metaboxuri în ecranele de postare și / sau editare de pagini. Acum face acest proces foarte ușor, și asta voi face să discut astăzi. Deci, să învățăm cum să creăm un metabox cu Cadrul Titan.

Crearea unui metabox în Titan

Înainte de a mă arunca în acest subiect, să presupunem că aveți:

  • un demo de lucru demo cu WordPress instalat 
  • Titan Framework plugin instalat și activat sau încorporat în acest site demo 
  • titan-cadru-checker.php fișier inclus în proiectul dvs.

Încă o dată mă refer la tema mea numită Neat pentru codul pe care îl voi folosi aici. În articolele anterioare, am explicat că fișierele șablonului temei au fost organizate în așa fel încât să existe un dosar separat pentru chestii legate de administrare în interiorul bunuri pliant. Acesta conține în continuare un fișier pentru codul metaboxelor, adică. METABOX-opțiuni-init.php, care este situat aici: active / admin /titanframework/metabox-options-init.php.

Deci, iată codul care va adăuga un metabox pe ecranele de editare a tuturor tipurilor de posturi pe care le-am menționat, care au fost:

  • pagină
  • post
  • my_custom_post_type, care trebuie să fie numele oricărui tip de post personalizat
create_etape '=> array (' page ',' post ',' my_custom_post_type ') // poate fi un șir sau un matrice. ); 

La început, există câteva linii comentate care vă oferă câteva dintre legăturile de ajutor pe care le puteți trece în legătură cu dezvoltarea metaboxelor. Mai jos este un ADD_ACTION () funcția care preia funcția tf_create_options cârlig care înregistrează aa_metabox_options pentru adăugarea de opțiuni în interiorul metaboxului.

Înainte (linia 14) Am definit o funcție pentru a înfășura codul nostru metabox, adică. aa_metabox_options. Aceasta conține întreaga funcționalitate necesară pentru a crea metaboxul nostru. 

Procesul începe prin obținerea unei instanțe unice a Titan - ului și înregistrarea acestuia în $ Titan variabilă (la linia 17). Apelarea getInstance () funcția este o parte integrantă a Titanului și este necesară în fiecare nouă rutină sau fișier în care utilizați Titan Framework. Această funcție are un parametru unic, în mod ideal numele temei dvs. pentru a inițializa Titan în proiectul dvs. De aceea am folosit "curat“ ca numele meu unic. I-am explicat în detaliu și într-un articol anterior.

Linia 23 a acestui cod este locul unde am creat metaboxul. Cu ajutorul platformei Titan, puteți utiliza funcția createMetaBox () pentru a adăuga metaboxuri în temele / pluginurile dvs. Deci, în conformitate cu această linie de cod, creez un $ aa_metbox metabox în cadrul Titan.

Rețineți un alt lucru: createMetaBox () funcția primește o serie de parametri care pot lua parametri ca Nume, desc, post_type, etc Deci, făcând uz de acestea am numit acest metabox "Metabox Opțiuni"(linia 24). Prin urmare, va apărea cu acest nume în pagina mea și după editarea ecranului.

Ultima linie (linia 25) a acestui cod atașează acest metabox nou creat la toate tipurile de posturi pe care le menționez. post_type este din nou un parametru care specifică în ce tip de post (uri) acest metabox va fi afișat. În cazul codului meu, îl afișez pe toate paginile și postările și la my_custom_post_type. De asemenea, rețineți că acest parametru ocupă o matrice dacă trebuie să utilizați metaboxul pe mai multe tipuri de posturi. Dar poate fi, de asemenea, un șir pentru când trebuie să utilizați metaboxul numai pentru un singur post, de ex. 'post_type' => 'pagina'.

Acum du-te la tabloul de bord WordPress și faceți clic pe Adăugați meniul Nou în Mesaje. Derulați în jos și veți găsi un metabox numit Metabox Opțiuni. Iată captura de ecran pentru aceasta:

Faceți același lucru pentru orice tip de pagină sau post particularizat al site-ului dvs. și veți găsi același metabox acolo.

Acest metabox este gol momentan. Deci, să adăugăm opțiuni în ea.

Adăugarea de opțiuni într-un metabox

Trebuie doar să copiați și să lipiți aceste linii chiar sub codul scris mai sus.  

createOption (array ('id' => 'aa_mb_txt', // ID-ul care va fi folosit pentru a obține valoarea acestei opțiuni 'type' => 'text', // Tipul opțiunii pe care o creăm. => 'Opțiunea mea de text', // Numele opțiunii care va fi afișată în panoul de administrare. 'Desc' => 'Aceasta este opțiunea noastră' // Descrierea opțiunii care va fi afișată în panoul de administrare. ); 

Crearea opțiunilor în Titan nu este ceva nou pentru tine. Am folosit din nou createOption () pentru a adăuga opțiuni. Dar ceea ce ar trebui să rețineți este linia 9, care specifică de asemenea unde să creați această opțiune, adică în interiorul acesteia $ aa_metbox. Deci, am creat o text introduceți câmpul din interiorul metaboxului numit "Opțiunea mea de text"a cărui identitate este aa_mb_txt

Imaginea de mai sus este rezultatul dezvoltării mele până acum. Dar de data aceasta este o pagină. Puteți găsi în mod clar Metabox Opțiuni cutie care are a Opțiunea mea de text domeniu în ea.

Deci, ce a mai rămas? Imprimarea ieșirii pe partea frontală după preluarea valorii. Să facem asta acum!

Obținerea valorilor salvate

Acum, voi recupera valorile salvate la front-end pentru pagina din captura de ecran de mai sus. Poftim:

getOption ('aa_mb_txt', get_the_ID ()); / ** * Prima opțiune metabox. * / // Să folosim această valoare în HTML. ?> 

Valoarea opțiunii metabox txt pentru această pagină este:

Aici getOption () (linia 10) poartă două parametri. Una este identitatea unică a opțiunii, adică. aa_mb_txt, iar al doilea este get_the_ID_ () funcţie. Am folosit-o get_the_ID () deoarece metaboxul a fost creat pentru toate tipurile de posturi pe care le-am definit. Dacă trebuie să obțineți valoarea unei opțiuni metabox pentru o anumită pagină / post, atunci veți da getOptions () funcția ID-ul postului respectiv / paginii respective. Rezultatul este salvat în $ aa_mb_txt_val.

Apoi, se creează un paragraf (linia 19) în care am folosit ecou comanda pentru a imprima de ieșire prin intermediul aa_mb_txt_val

Să presupunem că am intrat AA-text-Option în metabox și a publicat pagina.

Și voila, totul funcționează ca un farmec.

Concluzie

Acum știi cum să creezi metale cu Titan Framework. Îți dai seama cât de simplu este. În articolele viitoare din această serie, voi scrie despre cum să creați un anumit tip de opțiune cu Titan Framework într-o casetă meta. Acolo voi presupune că deja știți cum să creați cutia de metale în sine. Deci, este vital să încercați acest lucru.

În următorul articol, voi crea secțiuni personalizate tematice și panouri cu opțiuni - cât de cool este asta? Până atunci, dacă aveți vreo întrebare, anunțați-mă prin comentarii sau contactați-mă la Twitter.

Cod