Un ghid pentru începători în Cadrul Titan Adăugarea unei opțiuni pentru tipul de activare

Furnizarea de către utilizatorii finali a opțiunii de a activa sau dezactiva anumite funcții ale unui plugin premium sau a unei teme este destul de comună. Titan Framework a împins recent o nouă opțiune la baza sa, ceea ce face exact acest lucru. Să vedem cum puteți adăuga un buton de activare / dezactivare în cadrul unui panou de administrare, al unei metabox-uri sau al unei secțiuni de personalizare a temelor cu Titan Framework (TF).

Opțiunea de activare tip în cadrul Titan

Este o permite tip în Titan Framework pentru a crea butoane de activare / dezactivare. În tabloul de bord, permite tip opțiune apare astfel: 

Iată parametrii săi:

• Nume: Atribuie numele afișat al unui permite tip opțiune.
• id: Acest parametru specifică un nume unic care obține valorile opțiunilor salvate.
• desc: Adaugă o scurtă descriere cu numele opțiunii.
• Mod implicit: (Opțional) Se atribuie valoarea implicită.
• activat: (Opțional) Este eticheta butonului activat stat. Valoarea implicită este setată la Activat.
• invalid: (Opțional) Este eticheta butonului invalid stat. Valoarea implicită este setată la invalid.
• previzualizare live: (Opțional) De fiecare dată când adăugați un permite tip în cadrul unei secțiuni personalizate pentru temă, acest parametru vă permite să previzualizați modificările pe care le faceți.

Toți parametrii sunt şir după tip, cu excepția faptului că este implicit boolean.

Containerele disponibile pentru opțiunea Tip activare

Puteți adăuga această opțiune în interiorul:

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

Pentru a adăuga un permite tip în aceste containere, urmați acești pași:

• Obțineți o instanță prin getInstance () funcţie.
• Creați o opțiune prin createOption () funcţie.
• Obțineți valori salvate prin getOption () funcţie.

Dacă sunteți interesat să învățați cum să creați aceste containere cu TF, citiți articolele anterioare din această serie.

Crearea unei opțiuni de tip activare în interiorul unui panou de administrare

Exemplu de declarație

Să creați mai întâi această opțiune într-un panou de administrare.

createOption (array ('id' => 'aa_enable_opt', // ID-ul care va fi folosit pentru a obține valoarea acestei opțiuni 'type' => 'enable', // Tipul de opțiune creăm 'name' => 'Allow CSS custom', // Numele opțiunii care va fi afișată în panoul de administrare 'desc' => 'Activare / dezactivare CSS personalizat', // Descrierea opțiunii care va fi afișată în panoul de administrare 'implicit' => true // Valoarea implicită a opțiunii)); 

La linia # 8, am adăugat o permite tastați opțiunea prin createOption () funcția într-un panou de administrare $ aa_panel. Deoarece această funcție ocupă o matrice, am definit valorile parametrilor nume, tip, id, desc și Mod implicit. Valoarea ID trebuie să fie unică, adică. aa_enable_opt. Valoarea a Mod implicit este setat sa Adevărat, ceea ce înseamnă că starea opțiunii este setată la "activat' în mod implicit.

În captura de ecran de mai sus, există un permite introduceți opțiunea de tip Permiteți CSS personalizat într-un panou de administrare Neat Opțiuni.

Exemplu de utilizare

Să obținem valorile salvate.

getOption ('aa_enable_opt'); / ** * * Imprimați valoarea salvată * * / dacă (1 == $ aa_enable_opt_val) echo "CSS personalizat în fila admin este On.";  altceva echo "CSS personalizat în fila admin este Dezactivat."; ?>

Pentru a obține valoarea salvată, obțineți mai întâi o instanță prin intermediul getInstance () (linia 3). Apoi, la linia # 6, getOption () Funcția recuperează valoarea salvată înregistrând ID-ul opțiunii aa_enable_opt ca parametru. Am salvat rezultatul într-o nouă variabilă $ aa_enable_opt_val. Apoi am folosit un if-else verificați care imprimă valoarea salvată la front-end.  

Acum permite tip opțiune poate deține două valori: fie 1/0 sau adevarat fals. Valoarea este '1' (stare activată) sau '0' (starea dezactivată). Având în vedere acest fapt, am scris rândurile 15-20 ale codului, care verifică valoarea variabilei $ aa_enable_opt_val. Dacă este '1', atunci se imprimă 'CSS personalizat în panoul admin este activat ' la front-end. Dacă valoarea variabilei este "0", atunci se imprimă "CSS personalizat în panoul de administrare este dezactivat'.

Afișarea rezultatului la frontal

Să presupunem că am activat opțiunea și l-am salvat.

Iată o captură de ecran a rezultatului final care a apărut la front-end.

Crearea unei opțiuni de tip activare în cadrul unei file Admin

Exemplu de declarație

Înainte voi crea această opțiune într-o filă admin.

createOption (array ('id' => 'aa_enable_opt_in_tab', // ID-ul care va fi folosit pentru a obține valoarea acestei opțiuni 'type' => 'enable', // Tipul de opțiune creăm 'name' => 'Allow CSS custom', // Numele opțiunii care va fi afișată în panoul de administrare 'desc' => 'Activare / dezactivare CSS personalizat', // Descrierea opțiunii care va fi afișată în panoul de administrare 'activat' => 'On', // Etichetă pentru opțiunea activată 'dezactivat' => 'Oprit' // Etichetă pentru opțiunea dezactivată)); 

Aici am adăugat această opțiune într-o filă admin $ aa_tab1. Valoarea ID-ului este aa_enable_opt_in_tab. De data aceasta am definit și noi etichete pentru activat și invalid parametrii. 

În imagine, există un permite introduceți opțiunea în interior Tab. 1 de panou Opțiuni neat 2. Rețineți, de asemenea,Pe"pentru a permite și"de pe"pentru dezactivare.

Exemplu de utilizare

Acum voi obține valori salvate.

getOption ('aa_enable_opt_in_tab'); / ** * * Imprimați valoarea salvată * * / dacă (1 == $ aa_enable_opt_in_tab_val) echo "CSS personalizat în fila admin este On.";  altceva echo "CSS personalizat în fila admin este Dezactivat."; ?>

Codul este aproape similar cu ceea ce am scris mai sus. Deci, permiteți-mi să rezumăm toți pașii:

• Obțineți o instanță unică prin getInstance () funcția de la linia # 4.
• Obțineți valoarea salvată prin getOption () funcționează la linia # 7.
• Imprimați valoarea salvată la partea frontală prin intermediul if-else verificați declarația de pe liniile 15-20.

Afișarea rezultatului la frontal

De data aceasta am activat opțiunea de pe. Frontul imprimă următoarea linie:

Crearea unei opțiuni de activare în interiorul unui metabox

Exemplu de declarație

Acum o voi crea permite tip opțiune într-un metabox.

createOption (array ('id' => 'aa_enable_opt_in_metabox', // ID-ul care va fi folosit pentru a obține valoarea acestei opțiuni 'type' => 'enable', // Tipul de opțiune creăm 'name' => 'Allow CSS custom', // Numele opțiunii care va fi afișată 'desc' => 'Enable / Disable CSS personalizat', // Descrierea opțiunii care va fi afișată 'default' => false // Valoarea implicită a optiunea ) ); 

Aici am adăugat încă un altul permite tip opțiune într-un metabox $ aa_metbox. ID-ul său este aa_enable_opt_in_metabox. Valoarea a Mod implicit este setat sa fals.

În captura de ecran de mai sus, puteți găsi această opțiune într-un metabox. Apare pe toate ecranele de editare a paginilor și după editare.

Exemplu de utilizare

Să obținem valoarea salvată pentru această opțiune.

getOption ('aa_enable_opt_in_metabox', get_the_ID ()); / ** * Imprimați valoarea salvată * * / dacă (1 == $ aa_enable_opt_in_metabox_val) echo "CSS personalizat într-un metabox este activat";  altceva echo "CSS personalizat într-un metabox este dezactivat."; ?>

Am scris aproape același cod din nou. Singura diferență poate fi văzută la linia # 6. Există un nou parametru în interiorul getOption () funcţie. Acesta este get_the_ID () care este utilizată pentru a prelua o anumită pagină sau un ID post.

Afișarea rezultatului la frontal

Haideți din nou permite opțiunea și salvați-o. Front-end-ul apare astfel:

Crearea unei opțiuni de activare în interiorul unei secțiuni personalizate pentru tematică

Exemplu de declarație

În cele din urmă, voi crea această opțiune într-o secțiune de personalizare a temelor.

createOption (array ('id' => 'aa_enable_opt_in_sec', // ID-ul care va fi folosit pentru a obține valoarea acestei opțiuni 'type' => 'enable', // Tipul opțiunii creăm 'name' => 'Allow CSS custom', // Numele opțiunii care va fi afișată 'desc' => 'Enable / Disable CSS personalizat', // Descrierea opțiunii care va fi afișată 'default' => false // Valoarea implicită a optiunea ) ); 

Aici am creat această opțiune într-o secțiune de personalizare a temelor $ aa_section1. ID-ul său unic este aa_enable_opt_in_sec. Restul parametrilor sunt aceiași.

În imaginea de mai sus, există un permite tastați opțiunea dintr-o secțiune personalizată temă denumită Secțiunea mea.

Exemplu de utilizare

Utilizați următorul cod pentru a obține valori salvate.

getOption ('aa_enable_opt_in_sec'); / ** * * Imprimați valoarea salvată * * / dacă (1 == $ aa_enable_opt_in_sec_val) echo "CSS personalizat într-o secțiune personalizată este activată.";  altceva echo "CSS personalizat într-o secțiune personalizată este dezactivată."; ?>

Încă o dată, codul este exact același. Numai numele ID și numele variabilelor sunt diferite.

Afișarea rezultatului la frontal

Aici este captura de ecran, care afișează modificările în modul de previzualizare live.

Concluzie

Din punctul de vedere al utilizatorului final, permite tip este foarte util, deoarece puteți activa sau dezactiva oricare dintre caracteristici cu doar un singur clic. Deci, treceți prin acest tutorial și împărtășiți opiniile dvs. despre acest lucru în secțiunea de comentarii.

În acest moment, am acoperit tot ce trebuie să acopere despre Cadrul Titan. Nu uitați să completați pagina seriei dacă aveți întrebări sau comentarii cu privire la oricare dintre subiectele pe care le-am abordat. Sau nu ezitați să vă contactați pe Twitter.