Î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.
Î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ă:
Data
tip opțiune.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.fals
, această opțiune nu este afișată. Este setat la Adevărat
în mod implicit.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
.
Data
opțiunea de tip poate fi creată în interiorul:
Această opțiune este creată urmând o rutină de cod similar, indiferent de tipul containerului:
getInstance ()
funcţie.createOption ()
funcţie.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.
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ă));
A 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.
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.
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.
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.
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.
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:
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.
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.
Valoarea mea de demo este 13: 03.
Ieșirea tipărește astfel:
Î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.
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).
Iată o captură de ecran a modificărilor care au loc.
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.