Componente Parametri

Componente Parametri

Fișierul .parameters.php trebuie să fie localizat în folderul component. Fișierul de limbă este conectat automat (ar trebui să fie în / lang /<язык>/.parameters.php. față de folderul component).







Matricea $ arComponentParameters este definită în fișier. care descrie parametrii de intrare ai componentei. Dacă este necesar, se face o selecție a oricăror date suplimentare. De exemplu, pentru a genera o listă drop-down a tipurilor de blocuri de informații (parametrul de intrare IBLOCK_TYPE_ID), toate tipurile active sunt selectate.

Structura unui fișier tipic .parameters.php (de exemplu, componentele care lucrează cu modulul Blocări de informații):

Descriim mai detaliat cheile array $ arComponentParameters.

Lista grupurilor standard:

  • ADDITIONAL_SETTINGS (sortare - 700). Acest grup apare, de exemplu, prin specificarea parametrului SET_TITLE.
  • CACHE_SETTINGS (sortare - 600). Apare când este specificat parametrul CACHE_TIME.
  • SEF_MODE (sortează 500). Grup pentru toți parametrii asociați cu utilizarea CNC.
  • URL_TEMPLATES (sortare 400). Link template-uri
  • VISUAL (sortare 300). Grupuri rare utilizate. Aceasta ar trebui să conducă parametrii responsabili de aspect.
  • DATA_SOURCE (sortați 200). Tipul și ID-ul blocului de informații.
  • BASE (sortare 100). Parametrii de bază.
  • AJAX_SETTINGS (sortare 550). Tot ce-i privește pe ajax.

PARAMETRI

Valoarea acestei chei este o serie de parametri componenți. În fiecare grup de parametri, parametrii sunt în ordinea în care sunt specificați în fișier. O serie de parametri normali ai componentei constă din următoarele elemente:

Există valori pentru tipul de control TYPE:

  • LIST - selectați din lista de valori. Pentru tipul LIST, tasta VALUES conține o serie de valori de tipul următor:
  • STRING - câmp de introducere a textului.
  • CHECKBOX - da / nu.
  • CUSTOM - vă permite să creați comenzi personalizate.
  • FILE - selectați un fișier.

Aspectul listei se modifică în funcție de prezența / absența cheilor MULTIPLE și ADDITIONAL_VALUES:

  • Dacă MULTIPLE și ADDITIONAL_VALUES sunt absente sau egale cu "N", atunci este afișată o listă simplă, nu sunt adăugate valori în listă.
  • Dacă ADDITIONAL_VALUES = "Y", MULTIPLE = "N", atunci valoarea "other" este adăugată în listă și un număr de câmpuri suplimentare pentru introducerea manuală a valorii:






Componente Parametri

  • Dacă ADDITIONAL_VALUES = "N", MULTIPLE = "Y", atunci nimic nu este adăugat la listă, se pare că puteți selecta mai multe elemente:

    Componente Parametri

  • Dacă ADDITIONAL_VALUES = "Y", MULTIPLE = "Y", valoarea nu este adăugată la listă și un câmp suplimentar suplimentar pentru introducerea valorii este adăugat manual la listă.

    Notă. S-au făcut screenshot-uri pentru valoarea SIZE = 9. Dacă această cheie nu este specificată, lista va fi drop-down.

    Parametrul REFRESH permite, după selectarea valorii, să supraîncărcați întregul formular cu parametrii. Aceasta se face, de exemplu, pentru a selecta un anumit tip de bloc de informații. Adică, avem doi parametri - tipul blocului de informații și codul blocului de informații. Poziția de pornire - în prima listă a tuturor tipurilor de blocuri de informații în al doilea - o listă a tuturor blocurilor de informare ale site-ului, și apoi selectați setările componentei supraîncărcat de tipul dorit de bloc de informații și vom vedea doar blocurile de informații de tipul necesar.

    În exterior pentru parametrii tip LIST, această tastă apare ca un buton cu un text OK lângă parametru (vedeți capturile de ecran de mai sus).

    Dacă doriți ca un anumit parametru să apară sau nu în funcție de celălalt, acest lucru se va face. Trebuie să afișăm lista proprietăților blocului de informații. Să presupunem că ID-ul blocului de informații este conținut în parametrul componentei IBLOCK_ID. și parametrul, unde lista de proprietăți va fi denumită PROP_LIST. Parametrul IBLOCK_ID trebuie să aibă tasta REFRESH = 'Y'. cod:

    Există parametri specifici care sunt standardizați și nu trebuie să fie complet descriși. Este suficient să se indice că sunt. De exemplu,

    Prima dintre aceste opțiuni specifică dacă componenta trebuie setată la antetul paginii, iar a doua - toate setările legate de cache.

    Numai componentele complexe pot funcționa în modul CNC sau pot redefini variabilele care provin din cererea HTTP. În acest caz, trebuie să specificați doi parametri suplimentari printre parametri:

    • "VARIABLE_ALIASES" este un matrice care descrie variabilele pe care o componentă le poate primi de la o cerere HTTP. Fiecare element al matricei arată astfel:
    • "SEF_MODE" este o matrice care descrie modelele traseului în modul NC. Fiecare element al matricei arată astfel:

    Începând cu versiunea a douăsprezecea a produsului (noul kernel D7), a fost posibil să se adauge un control parametrilor controlului care vă permit să specificați culoarea (COLORPICKER).

    Pentru a face acest lucru, trebuie să specificați următoarele în fișierul parametru al componentei .parameters.php:

    Este important. Varianta cea mai corectă de personalizare a componentelor este să o copiați într-un spațiu de nume separat și să lucrați cu o copie a componentei. În acest caz, este necesar să se ia în considerare consecințele:
    • Numărul total de componente crește, la fel și cantitatea de resurse alocate pentru a le sprijini.
    • Dificultatea de a stăpâni un nou dezvoltator: mai întâi va trebui să găsească ceea ce este diferit de componenta standard deja existentă.






    Articole similare

    Pagina anterioară

    Pagina următoare

    Trimiteți-le prietenilor: