Acesta este cel de-al treilea articol al seriei și, până în prezent, am discutat importanța și caracteristicile Titan-ului împreună cu configurația de bază. În primul articol, am discutat despre configurația în trei etape a Titan-ului, care merge în felul următor: 

1. Configurați-vă proiectul.
2. Creați opțiuni.
3. Obțineți valori.

Am explicat primul pas din articolul precedent, în care am aflat că Titan Framework este un framework plug-and-play, adică vine ca un plugin, deși poate fi integrat și prin încorporarea acestuia în cadrul proiectului dvs. de dezvoltare web. Deci, să continuăm de unde am rămas și să continuu cu următorii doi pași.

Aici vă voi explica cum și în ce măsură funcționează Titan Framework în proiectul dvs. de dezvoltare web. Apoi voi sari la conceptul de a crea Instanțe și Opțiuni din care voi primi cei mântuiți valori la front-end. Deci, să începem! 

1. Configurați-vă proiectul

Mai întâi de toate, să aflăm ce veți avea nevoie pentru a implementa tutorialul de astăzi. Vom crea o temă simplă WordPress cu care vom folosi Titan Framework pentru a explora diferitele seturi de opțiuni pe care le poate crea. O să ai nevoie:

1. Configurarea WordPress locală, de ex. Eu folosesc DesktopServer (crede-ma, e uimitor!).
2. O temă WordPress de bază - o să folosesc Neat pentru acest scop. Am creat o nouă filială numită Neat: TitanFramework pentru acest tutorial.

Setarea mea

Pe măsură ce voi folosi tema Neat WordPress, este important să explic mai întâi structura acesteia. Deschideți directorul tematic din editorul de text în interiorul paginii bunuri director Am creat un nou dosar numit admin. Scopul său este de a gestiona toate codurile relevante pentru opțiunile de administrare. Înăuntru este un alt director, titanframework,și un fișier PHP, admin-init.php.

admin-init.php Fişier

Acest fișier PHP se va ocupa de toate activitățile legate de administrare. Dacă parcurgi codul lui, vei afla că l-am folosit get_template_directory () pentru a include patru fișiere din titanframework director. Codul următor este destul de explicabil, dar voi explica într-un timp scurt scopul fiecăruia dintre aceste fișiere.

Aici este codul pentru admin-init.php:

Director numit titanframework 
Am discutat anterior că Titan Framework vă ajută să creați Panouri de administrare și file, metaboxuri și Temă personalizator secțiuni și panouri. Așadar, am creat fișiere separate pentru fiecare dintre ele. Evident, ele pot fi create cu linii separate de cod. Voi discuta fiecare dintre acestea în articolele mele viitoare, dar pentru moment tot ce trebuie să înțelegeți este pentru ce sunt aceste fișiere.
 
 titan-cadru-checker.php: este responsabil pentru includerea în tema a cadrului Titan.
 
 AdminPanel-opțiuni-init.php: conține codul pentru crearea panoului admin și filelor cu un set de opțiuni.
 
 METABOX-opțiuni-init.php: Conține codul pentru crearea metaboxelor pentru tipurile de posturi cu un set de opțiuni în ele.
 
 -opțiuni de personalizare-init.php: Conține codul pentru crearea panourilor de personalizare a temelor și a secțiunilor cu un set de opțiuni.
 
Incluzând admin-init.php Fişier
Până acum, trebuie să te întrebi de ce am creat atât de multe fișiere noi. De ce nu am adăugat tot codul în functions.php fişier? Ei bine, nu consider că este o abordare bună de proiectare a arhitecturii. Pentru a construi un produs mentenabil, trebuie să definiți un model de design bun. 
Care este scopul de a-ți face rău functions.php fișier cu atât de multe linii de cod? Am experimentat-o ​​singură: spre sfârșitul oricărui proiect de dezvoltare, codul devine atât de masiv încât devine dificil să se ocupe de toate într-un singur fișier, mai ales atunci când vine vorba de depanare și corectare a oricăror erori. Este întotdeauna mai bine să creați fișiere separate, deci gândiți-vă la aceste fișiere ca module.
Să includem admin-init.php în a noastră functions.php fişier.
Aici am adăugat admin-init.php fișier prin intermediul aceluiași get_template_directory () și require_once () funcții.
În acest moment, am analizat configurarea de bază a unei teme pe care o voi folosi pentru a explica modul în care funcționează Titan Framework. Am finalizat setarea și încorporat Titan Framework în tema WordPress. Să creăm un panou de admin cu opțiuni și să obținem valorile pentru partea frontală.
Lucrul cu Cadrul Titan
Pentru a lucra cu Titan Framework, trebuie să urmați un anumit flux de lucru care este:
 
Creați o instanță de cadru Titan pe fișier.
 
Creați panoul Admin / tab-uri, metaboxuri sau tematică personalizator secțiuni / panouri.
 
Creați opțiuni în ele.
 
Obțineți Valorile.
 
Lasă-mă să scriu prima parte a codului pe care o voi folosi în acest scop. Acesta este codul pentru adminpanels-opțiuni-init.php fișier care este prezent în interiorul active / admin / titanframwork / director.
createAdminPanel (array ('name' => 'Opțiuni netede' // numele meniului de opțiuni)); / ** * Creați opțiunile. * Acum vom crea opțiuni pentru panoul nostru pe care tocmai l-am creat numit '$ aa_panel'. * / $ aa_panel-> createOption (array ('id' => 'aa_txt', // ID-ul care va fi folosit pentru a obtine valoarea acestei optiuni. sunt create 'name' => 'Opțiunea My 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.)); / ** * Butonul Salvare pentru opțiuni. * * La crearea opțiunilor pentru panoul de administrare, utilizați acest cod pentru a adăuga opțiunea "Salvați" * deoarece nu există altă modalitate de a salva opțiunile utilizatorului. Utilizatorii dvs. pot salva acum * (și resetați) opțiunile pe care tocmai le-am creat. * / $ aa_panel-> createOption (array ('tip' => 'salvați')); 
La început am adăugat câteva link-uri de ajutor din documentația Titan-cadru. Acum o să explic acest rând de linii de cod.
Linia 17
Aici avem un cârlig numit tf_create_options, care se utilizează pentru a crea opțiuni prin aa_options_creating_function () funcţie. 
Linii 19
Am creat o funcție numită aa_options_creating_function (), care va fi responsabil pentru crearea acestor opțiuni.
Linia 22
La linia 22, am creat un instanță pentru Cadrul Titan. Crearea unei instanțe este o parte integrantă a acestui cadru și trebuie creată în fiecare fișier ori de câte ori avem nevoie pentru a interacționa cu Titan Framework. Pentru a face un exemplu unic, puteți adăuga numele produsului în el. De exemplu, am adăugat "unat" ca parametru. 
Obțineți o instanță a cadrului Titan
Crearea unei instanțe a platformei Titan este destul de simplă. Avem o instanță unică pentru a evita orice confuzie doar în cazul în care un alt plugin folosește Titan Framework pentru a crea opțiuni. Autorul afirmă că: 
Funcția getInstance creează / obține o instanță unică a Titan Framework specifică "mytheme". Acesta este Spațiu de nume vom folosi pentru a ne asigura că setările noastre nu vor intra în conflict cu alte pluginuri care utilizează platforma Titan. Asigurați-vă că îl modificați în numele temei sau pluginului.
Iată un exemplu de cod de obținere a unui exemplu cu Titan. 
$ titan = TitanFramework :: getInstance ('my-theme');
În cazul meu Neattemă voi folosi parametrul curatin loc demi-temă pentru a-mi face codul unic, adică. 
$ titan = TitanFramework :: getInstance ('neat');
Crearea unui panou de administrare; Linii 33-35
Aceste linii vor crea un panou de admin pe care l-am denumit "$ aa_panel". Titan Framework vă ajută să creați secțiuni precum panoul de administrare, filele de administrare, metaboxurile și panourile personalizate ale temelor în cadrul proiectului dvs. Dar pentru moment voi crea doar un panou de administrare ca un exemplu pentru a explica lucrurile. 
Aceste linii de cod sună pe noi createAdminPanel () funcția în cadrul Titan, care formează o matrice. Această funcție va adăuga o nouă secțiune în tabloul de bord WordPress numit Neat Opțiuni.
Imaginea de mai sus este o captură de ecran a tabloului de bord WordPress, unde puteți găsi o nouă secțiune adăugată în panoul de administrare.
Doar pentru a rezuma ceea ce am făcut până acum: am creat proiectul meu de dezvoltare web și apoi i-am adăugat o instanță, după care am creat un panou de administrare. 
În acest moment, dacă fac clic pe Neat Opțiuni, atunci această secțiune este goală. Deci, acum voi crea opțiuni în acest panou de administrare nou creat. 
Crearea de opțiuni în cadrul Titan
Teme personalizabile WordPress sunt preferate deoarece utilizatorii finali doresc mai mult să configureze teme fără a scrie o singură linie de cod. Acest lucru este posibil prin adăugarea de opțiuni flexibile în timpul dezvoltării temelor. 
Putem adăuga astfel de opțiuni într-un panou de administrare separat sau sub formă de metaboxe sau opțiuni de panouri în interiorul temei personalizate. Opțiunile servesc scopului de a stoca valorile care sunt recuperate mai târziu la front-end.
Linii 42-47
Acum, aruncați o privire la aceste linii de cod. Acestea vor fi folosite pentru a crea opțiuni în cadrul unui panou de administrare sau al unei file. Linia 42 definește createOption () funcția pentru $ aa_panel. Această funcție este din nou o matrice care poartă anumiți parametri id, tip, nume, descriere, etc În conformitate cu aceste linii am creat o opțiune care este un câmp de text și este numit Opțiunea mea de text. 
Aceasta este captura de ecran care afișează opțiunea creată în cadrul Neat Opțiuni panou.  
Linii 56-58
Ultimele două linii ale codului creează o altă opțiune în acest panou. Dar scopul său este de a salva setările. De exemplu, în Opțiunea mea de text câmpul, utilizatorul îl umple John Doe. Aceasta înseamnă că utilizatorul dorește să modifice setarea implicită, lucru care este posibil numai dacă utilizatorul salvează setările personalizate.
Deci, am folosit din nou createOption () funcția și a atribuit valoarea parametrului "tip = salvați". 
Acesta este captura finală a dezvoltării pe care am făcut-o până acum. 
În acest moment, ați înființat Titan Framework, ați creat câteva opțiuni pentru obținerea rezultatelor dinamice și acum tot ce trebuie să faceți este să obțineți valorile din opțiunile pe care le-ați configurat în primul rând. Din cele trei pasi, am discutat primele două din cele două articole anterioare. Deci, haideți să ajungem la ultima și chiar cea mai importantă parte a modului în care lucrează Titan Framework.
Obținerea de valori
Crearea opțiunilor se face la back-end, iar acum trebuie să preluăm valorile față de acele opțiuni, setate de un utilizator final, pentru a le folosi la front-end. Putem recupera valori setate în funcție de opțiuni printr-o funcție simplă, adică. getOption ().
Următoarea este structura de bază a codului pentru a prelua valorile salvate:
getOption ('my_text_option'); / / Faceți lucruri aici. 
Deci, am creat o funcție numită myFunction unde am înregistrat prima dată o instanță a lui Titan. Înregistrarea unei instanțe este un pas important, deoarece devine obiectul creat de Titan Framework pentru setările dvs. înregistrate într-o variabilă, adică. $ Titan. Puteți vedea că instanța noastră este specifică temei noastre, adică. mi-temă, care ar trebui să fie numele nostru de temă sau ceva unic. 
Preluarea valorilor la frontal
Să folosim valorile stabilite față de opțiunile de la front-end. Am creat un șablon de pagină personalizat gol. Dacă te referi la ordinat temă, veți găsi un fișier numit aa_titanframework.php în rădăcină. Puteți face același lucru și cu tema dvs..
Creeaza o fișier nou în editorul de text și copiați și inserați următoarele linii de cod.
getOption ('aa_txt'); ?> 
 
 
  
 
 
 
Înainte de a explica codul menționat mai sus, consultați codul din articolul meu anterior, în care am creat un panou de administrare și opțiunile acestuia, pentru că folosesc aceleași nume, ID-uri etc. și aici.
Primele patru linii ale codului sunt pentru WordPress pentru a înregistra acest șablon de pagină personalizat, care este destul de standard - nu știință de rachete acolo.
Obținerea valorilor opțiunilor
Voi obține valorile opțiunilor pe care le - am creat în AdminPanel-opțiuni-init.php fișier (trimiteți codul său la articolul meu anterior) aici. Sunt necesare două măsuri pentru a realiza acest lucru:
 
Obțineți o instanță unică Titan Framework și salvați-o într-o variabilă.
 
Obțineți valoarea prin ID folosind getOption () funcţie.
 
Linia 12
În urma primului pas, am inițializat o instanță unică împotriva variabilei $ Titan, o singură dată pentru fiecare fișier în care o folosesc. Exemplul meu este unic de când l-am numit curat, adică numele pachetului pentru tema mea - îl puteți numi ceva unic. Este necesar ca, dacă un plugin utilizează Titan și tema dvs. o folosește și ea, atunci ar trebui să existe o modalitate de a face diferența între opțiunile setate de acest plugin și tema dvs..
$ titan = TitanFramework :: getInstance ('neat');
Linia 14
Al doilea pas este să utilizați ID-ul și să obțineți valoarea salvată pentru acea opțiune. Codul pentru această linie este:
$ aa_txt_val = $ titan-> getOption ('aa_txt'); 
Am recuperat valoarea pentru aa_txt care este salvată împotriva variabilei $ aa_txt_val.  aa_txt parametru se referă la ID-ul opțiunii pe care am creat-o în primul meu panou de administrare (consultați articolul meu anterior).
Deci, am stabilit structura de bază pentru a obține valorile salvate. Acum, să folosim valorile salvate la front-end.
Linile 22-35
Aceste linii de cod sunt folosite pentru a afișa valorile salvate pe front-end. Uitați-vă la linia 29 unde am folosit ecou comanda pentru a obține ieșirea. Același lucru se face și pe linia 35, dar de această dată afișez ieșirea pentru $ aa_txt_val într-un format H3 (rubrica 3). Deci, acum orice valoare setată de utilizatorul final pentru această opțiune, va fi afișată la front-end.
Rezultate
Pentru a afișa rezultatele pentru codul pe care l-am explicat mai sus, urmați acești pași:
 
Du-te la WordPress tablou de bord 
 
Creeaza o Pagina noua prin intermediul Pagini> Adăugați noi.
 
Denumiți pagina Cadrul Titan (opțional, ați ști asta)
 
Imaginea de mai sus arată pagina pe care am creat-o. În același timp, puteți găsi și noul meniu Panou de administrare, adică. Neat Opțiuni, unde am creat opțiunile.
Apoi, alegeți Șablon de pagină, adică. Cadrul Titan, pentru această pagină înainte de ao publica.
 aa_titanframework.php fișierul adaugă o pagină nouă Format numit "Cadrul Titan" care apare în lista derulantă. Alegeți șablonul respectiv.
 
Publicați pagina.
 
Apoi mergeți la Neat Opțiuni meniu și adăugați o anumită valoare împotriva opțiunii numite Opțiunea mea de text. 
 
Imaginea arată că am completat acest câmp AA-text-Option și apoi am făcut clic Salvează modificările.
Reveniți la pagina Titan Cadru și vedere pagina.
Imaginea de mai sus afișează rezultatul final. Acesta esteCadrul Titan pagină. Valoarea opțiunii salvate (adică AA-Text-Option) pentru aa_txt este afișată în două forme diferite. Primul este în paragraf format în timp ce al doilea este în h3 format.
Concluzie
Până acum trebuie să aveți o înțelegere a cadrului Titan și a muncii sale. Aceasta este setarea de bază care trebuie urmată de fiecare dată când dezvoltați ceva cu Titan Framework. 
Acum, că știți cum să o configurați, creați câteva opțiuni și obțineți valorile salvate; încercați-l și spuneți-mi în cazul în care aveți întrebări prin comentarii sau contactați-mă la Twitter. 
În continuare în această serie vom explora setul de opțiuni pe care le putem crea cu Titan Framework și cum să le folosim. 



		
			
	   
	




Cod