Un ghid pentru începători pentru platforma Titan Adăugarea unei opțiuni de tip dată

În acest articol, vom explora Data opțiunea de tip din Titan Framework: cum funcționează și ce parametri oferă. Aflați cum puteți crea un selector de date într-un panou de administrare personalizat WordPress, într-o secțiune metabox sau personalizator.

Opțiunea pentru tipul de dată în cadrul Titan

În cadrul Titan, există o a Data tip care permite utilizatorilor finali să introducă date și setări de timp dinamic în temele lor. Această opțiune încarcă întregul calendar și puteți seta orice dată la alegere. Iată structura acestei opțiuni:

Să aruncăm o privire la lista parametrilor pe care această opțiune le suportă:

  • Nume: Definește numele afișat al Data tip opțiune.
  • id: Acest parametru specifică un nume unic care ajută la obținerea valorilor salvate.
  • desc: Afișează o scurtă descriere cu numele opțiunii.
  • Mod implicit(Opțional) Setează setarea implicită Data Setări. Acest parametru ocupă un anumit format de valori, adică. Y-m-d pentru data, Bună pentru timpul și Y-m-d H: i atât pentru dată cât și pentru timp.
  • Data: (Opțional) Dacă fals, această opțiune nu este afișată. Este setat la Adevărat în mod implicit.
  • timp: (Opțional) Dacă Adevărat, această opțiune va apărea. Este setat la fals în mod implicit.

Parametrii Data și timp sunteți boolean pe tip, în timp ce restul sunt de tip şir

Containerele disponibile pentru opțiunea Tip dată

Data opțiunea de tip poate fi creată în interiorul: 

  • Panoul Administratorului
  • Fii Admin
  • METABOX
  • Tema Customizer Section

Această opțiune este creată urmând o rutină de cod similar, indiferent de tipul containerului:

  • Obțineți o instanță unică prin getInstance () funcţie.
  • Adăugați o opțiune prin createOption () funcţie.
  • Obțineți valorile salvate prin getOption () funcţie. 

Cu toate acestea, dacă doriți să aflați cum sunt create aceste containere cu Titan Framework, puteți găsi detaliile din articolele anterioare din această serie.

Crearea unei opțiuni pentru tipul de dată într-un panou de administrare

Exemplu de declarație

Mai intai voi crea acest tip de optiune intr-un panou de administrare.

createOption (array ('id' => 'aa_date', // ID-ul care va fi folosit pentru a obține valoarea acestei opțiuni 'type' => 'date', // Tipul de opțiune pe care o creați ' "Opțiunea mea de dată", // 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 'default' = = > '2015-8-15' // Valoare implicită));

Data tip este creată în interiorul unui panou de administrare $ aa_panel prin createOption () (linia # 7). Am definit parametrii id, tip, nume, desc și Mod implicit. ID-ul (adică. aa_date) ar trebui să fie întotdeauna unic. 

Puteți vedea că opțiunea numită Opțiunea mea de dată există în interiorul unui panou de administrare Neat Opțiuni. Setarea de dată prestabilită apare și în ecranul de mai sus. 

Exemplu de utilizare

Să obținem valorile opțiunilor salvate.

getOption ('aa_date'); // Convertiți data de ecou a datei datei ('r', $ aa_date_epoch_val); // ieșire ca RFC 2822 data - returnează ora locală - pentru mai multă citire http://goo.gl/g9tZLi?> 

În linia # 3, o instanță este achiziționată prin getInstance () , care are un parametru unic, preferabil numele temei (am folosit curat). Valorile memorate sunt preluate prin getOption () în linia # 6, care înregistrează ID-ul aa_date ca parametru și își salvează valoarea într-o nouă variabilă $ aa_date_val.

Ultima parte a codului imprimă valori la front-end. În cele mai multe cazuri, serverul ne poate întoarce o valoare epocă, pe care va trebui să o convertim folosind PHP Data() funcţie. Discuțiile despre valorile epocilor nu fac parte din acest tutorial, dar puteți citi mai multe despre el aici.

Afișarea rezultatului la frontal

Acum voi seta orice valoare data de demo și să o salvez. De exemplu, eu aleg 2015-08-20.

Să vedem ieșirea lui la front-end.

Setarea pentru data salvată este imprimată corect, cu timpul. Ca parametru pentru timp este dezactivată pentru moment, nu sunt afișate setări de timp. Cum stabilești timpul? Voi ajunge la asta puțin.

Crearea unei opțiuni de tip dată în interiorul unei file Admin

Exemplu de declarație

Acum, voi adăuga această opțiune într-o filă admin, dar va afișa ambele Data și timp setări.

createID (array ('id' => 'aa_date_in_tab1_panel2', // ID-urile trebuie să fie întotdeauna unice. ID-ul care va fi folosit pentru a obține valoarea acestei opțiuni 'type' => 'date' Crearea "name" => "Opțiunea mea de dată", // 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 "default" => '2015-8-15 00:00', // Valoarea implicită pentru data & ora 'time' => true // Setările de timp activate.)); 

De data asta adaug o Data tastați opțiunea într-o filă admin $ aa_tab1. ID-ul său este aa_date_in_tab1_panel2. Uită-te la lista de parametri. Se arată timp este setat sa Adevărat. Aceasta înseamnă că selectarea timpului este activată. Notați formatul de valoare pentru Mod implicit, care este setat pentru ambele Data și timp.

Puteți găsi Opțiunea mea de dată în Tab. 1din panoul de administrare Opțiuni neat 2.

Exemplu de utilizare

Să recuperăm valorile.

getOption ('aa_date_in_tab1_panel2'); data ecou ('r', $ aa_date_in_tab1_panel2_val); // ieșire ca RFC 2822 data - returnează ora locală - pentru mai multă citire http://goo.gl/g9tZLi?> 

Nu este nimic nou în acest cod.

Afișarea rezultatului la frontal

Să presupunem că datele mele demo și data sunt valabile 2015-09-06 și 08:45. Este deasemenea o Acum care stabilește valoarea timpului curent într-un singur clic.

Front-end-ul apare astfel:

Crearea unei opțiuni de tip dată într-un metabox

Exemplu de declarație

Să-i scriem codul.

createID (array ('id' => 'aa_mb_date', // ID-urile trebuie să fie întotdeauna unice. ID-ul care va fi folosit pentru a obține valoarea acestei opțiuni 'type' => 'date', // Tipul de opțiune suntem Crearea numelui => 'Selectați setările de timp', // Numele opțiunii care va fi afișată 'desc' => 'Aceasta este opțiunea noastră', // Descrierea opțiunii care va fi afișată 'default' => 00:00 ', // Valoare implicită pentru data' time '=> false, // Setările datei au fost dezactivate.' Time '=> true // Setările de dată activate.)); 

 createOption () funcția adaugă a Data tip opțiune într-un metabox $ aa_metbox (linia # 5). Dar acest cod afișează numai timp setări deoarece Data este setat la fals. De aceea l-am schimbat Nume și Mod implicit valori ale acestei opțiuni în consecință.

Imaginea de mai sus afișează un selector de timp denumit Selectați setările de timpîn interiorul unui metabox. Acest lucru apare pe toate ecranele de editare a paginilor și postărilor.

Exemplu de utilizare

Să obținem valorile de timp salvate.

getOption ('aa_mb_date', get_the_ID ()); data ecou ('r', $ aa_mb_time_epoch_val); // ieșire ca RFC 2822 data - returnează ora locală - pentru mai multă citire http://goo.gl/g9tZLi?> 

Tocmai am recuperat valoarea timpului și apoi l-am convertit cu Data() funcţie.

Afișarea rezultatului la frontal

Valoarea mea de demo este 13: 03.

Ieșirea tipărește astfel:

Crearea unei opțiuni pentru tipul de dată într-o secțiune personalizată temă

Exemplu de declarație

În final, o să adaug această opțiune într-o secțiune de personalizare a temelor.

createID (array ('id' => 'aa_sec_date', // ID-urile trebuie să fie întotdeauna unice. ID-ul care va fi folosit pentru a obține valoarea acestei opțiuni 'type' => 'date', // Crearea numelui => 'Selectați setările de dată / oră', // Numele opțiunii care va fi afișată 'desc' => 'Aceasta este opțiunea noastră', // Descrierea opțiunii care va fi afișată 'default' = = > '2015-08-01', // Valoare implicită pentru data & ora 'date' => true, // Setările date activate. 'Time' => true // Setările de timp activate.)); 

În sfârșit, am adăugat această opțiune urmând aceeași procedură într-o secțiune de personalizare a temelor.

Imaginea de ecran vă arată clar.

Exemplu de utilizare

Să obținem valorile opțiunilor salvate.

getOption ('aa_sec_date'); ?> 
Valoarea datei / orei este

Voi obține valorile salvate în header.php fişier. Deci, mai întâi obțineți o instanță și înregistrați ID-ul unic în interiorul getOption () funcţie. Apoi creați un div și imprimați ieșirea variabilei $ aa_sec_date_val prin Data() (linia # 13).

Afișarea rezultatului la frontal

Iată o captură de ecran a modificărilor care au loc.

Concluzie

Acesta este modul în care puteți adăuga setări dinamice de dată și oră în temele și pluginurile WordPress. Această opțiune poate fi folosită ori de câte ori doriți ca utilizatorul final să introducă data și ora din orice motiv. 

De exemplu, am construit această temă WordPress unde am vrut să adaug un tip de post personalizat pentru evenimente (prin intermediul unui plugin). În acel moment, am avut opțiunea de a adăuga oricare dintre cele mai frecvent utilizate plug-uri de evenimente sau de a codifica un plugin destul de mic. 

Deci, în loc să ofere clientului meu un plugin de eveniment care ar fi arătat ca un cockpit al unui avion, am folosit Titan Framework. Am folosit Data introduceți opțiunea de două ori în două metaboxe diferite pentru datele evenimentului.

Integrați această opțiune în proiectul dvs. și reduceți povara scrisului de cod lung. În următorul articol, vom explora radio tip în cadrul Titan.

Aveti vreo intrebare? Postați-le în comentariile de mai jos sau contactați Twitter.

Cod