Register_sidebar () - înregistrează panoul widget (locul unde widget-urile sunt situate în panoul admin,

Înregistrează panoul widget (locul unde sunt plasate widgeturile în panoul de administrare, apoi pentru a le afișa în partea din față).

register_sidebar () înregistrează panoul (loc, container) pentru widget-uri și formatul de ieșire pentru fiecare widget: tag-ul header html, eticheta html înainte și după widget. După înregistrarea panoului, va fi un loc în panoul de administrare unde puteți plasa widget-uri. Prin plasarea widget-urilor în panou, putem afișa panoul cu widget-urile din șablon utilizând funcția dynamic_sidebar (). (vezi exemplul 2).

Funcția trebuie să fie conectată la evenimentul widgets_init.

Funcția de suport widget: add_theme_support ('widgets') trebuie să fie activată pentru temă, în funcțiile.php. Dacă nu, register_sidebar () o va activa automat.

Nu utilizați numele de identificare pentru parametrul ID din această listă. Acolo, sub link, veți găsi o funcție mică care colectează ID-ul folosit deja în WordPress.

Utilizați register_sidebars (). pentru a crea mai multe panouri la un moment dat. Acest lucru va crea un nume unic pentru fiecare panou, de exemplu: "Bara laterală dreaptă", "Bara laterală din stânga". În ciuda faptului că aceste nume sunt vizibile numai în panoul de administrare, este important să oferiți utilizatorului o idee despre locul în care va fi afișat panoul.

register_sidebars () este, de asemenea, recomandat dacă doriți să înregistrați mai multe panouri similare pentru widget-uri (numele diferă în număr), de exemplu: Panou 1. Panou 2. Panou 3.

Valorile implicite ale parametrilor înainte / după se calculează pe subiecte care creează panouri laterale ca listă LI cu anteturi în eticheta H2. Această înregistrare este recomandată de dezvoltatorii WordPress pentru toate subiectele.

Dacă dintr-un anumit motiv etichetarea trebuie modificată, se recomandă copierea id-urilor (id = "% 1 $ s") și a clasei (class = "widget% 2 $ s") specificate în mod prestabilit și nu le specificați rigid. Aveți nevoie de acest lucru pentru a fi creat dinamic utilizând funcția sprintf ().

Nu puteți lăsa numele și parametrii id goi!

Ele nu pot fi specificate deloc sau trebuie specificate în același timp, trebuie să fie unice și nu goale.

Dacă nu definiți un id sau un nume, valorile implicite cu un increment vor fi folosite pentru ele:

Unde $ i este numărul egal cu numărul de panouri de pe site + 1.

Cârlige din funcție:

se întoarce

Un șir. ID-ul trecut în parametrul ID.

utilizarea

Șablonul de utilizare

Argumente pentru înregistrarea panoului widget. Puteți specifica ca un șir sau un matrice:
Dacă sub forma unui șir, argumentele trebuie să fie separate de semn :

Aceleași argumente sunt în matrice:

Implicit: setările implicite.

Argumente pentru parametrul $ args

nume (șir) Numele panoului widget. Numele va fi vizibil în panoul de administrare al WordPress. Valoarea implicită este "Bara laterală 1" (localizarea din Bara laterală $ i. Unde $ i este numărul ordinal al barei laterale). Valoarea nu trebuie să fie goală!
Implicit: sprintf (__ ('Bara laterală.'), $ I) id (string) Widget id. Un șir în care nu ar trebui să fie majuscule sau spații. Valoarea nu trebuie să fie goală, dacă lăsați acest parametru gol, apoi în modul de dezvoltare (atunci când se depanează), veți primi o notă de tipul E_USER_NOTICE.
Implicit: descrierea barei laterale - $ i (șir) Textul care descrie unde va fi afișat panoul widget. Acesta este afișat în panoul de control al widget-urilor.
Implicit: clasa (șir) O clasă CSS care va fi adăugată la eticheta HTML principală a panoului widget.
Implicit: '' before_widget (șir) Codul HTML care va fi plasat înaintea fiecărui widget din panou. De exemplu:

'after_title (line) cod HTML după titlul widgetului.
Implicit: "

Scopul principal al acestor argumente este de a specifica etichete adecvate pentru tema ambalajului fiecare widget și a titlului. În WordPress este obișnuit să înfășurați widget-ul într-o etichetă li și antetul widget-ului în eticheta h2.

# 1 Înregistrarea widget-urilor pentru bara laterală a site-ului

Codul de mai jos va înregistra un panou numit "Bara laterală dreaptă a site-ului". Numele panoului va fi înfășurat în etichete

După ce plasăm acest cod în fișierul temă functions.php, în panoul de administrare din pagina widget, va apărea un panou în care putem adăuga widget-uri. În șablon, acest panou este afișat utilizând funcția dynamic_sidebar ():

# 2 Înregistrați panoul widget pentru pagina principală a site-ului

Să adăugăm codul funcțiilor.php:

În fișierul home.php introducem ieșirea panoului:

Codul este bara laterală de înregistrare. wp-include / widgets.php WP 4.8.3

Funcții înrudite

Otshelnik-Fm 181 site: across-ocean.otshelnik-fm.ru

Timur salutări. Adăugați ID widget: "Dacă nu setați valoarea identificatorului de argument, veți primi mesaje E_USER_NOTICE în modul de depanare, începând cu versiunea 4.2."

Puțini nu înțelegeau ce să termine și de ce, și nu l-au găsit în documentație.

Dacă nu setați id-ul sau numele, atunci acestea vor utiliza valorile implicite cu o creștere.

Unde $ i va crește automat numărul: panouri înregistrate pe site + 1.

Trimiteți-le prietenilor: