Alkatrészparaméterek
Alkatrészparaméterek
A .parameters.php fájlt az összetevőkártyán kell elhelyezni. A nyelvi fájl automatikusan csatlakozik (a / lang /<язык>/.parameters.php. az összetevő mappához viszonyítva).
A $ arComponentParameters tömb a fájlban van megadva. amely leírja az összetevő bemeneti paramétereit. Szükség esetén minden további adatról kiválasztunk. Például az információs blokk típusok legördülő listájának (IBLOCK_TYPE_ID bemeneti paraméter) létrehozásához minden aktív típust ki kell választani.
Egy tipikus .parameters.php fájl struktúrája (például az Információs blokkok modullal együttműködő összetevők):
Az $ arComponentParameters tömb kulcsait részletesebben ismertetjük.
Szabványos csoportok listája:
- ADDITIONAL_SETTINGS (rendezés - 700). Ez a csoport például a SET_TITLE paraméter megadásával jelenik meg.
- CACHE_SETTINGS (válogatás - 600). Akkor jelenik meg, ha a CACHE_TIME paraméter van megadva.
- SEF_MODE (500 sor). Csoport a CNC használatával kapcsolatos valamennyi paraméterhez.
- URL_TEMPLATES (sorrend 400). Link sablonok
- VISUAL (válogatás 300). Ritkán használt csoport. Ez feltételezi a megjelenésért felelős paraméterek vezetését.
- DATA_SOURCE (sorszám 200). Az információs blokk típusa és azonosítója.
- BASE (100 sort). Alapvető paraméterek.
- AJAX_SETTINGS (550 sor). Minden, ami az ajaxot érinti.
PARAMÉTEREK
Ennek a kulcsnak az értéke egy összetett paraméterek tömbje. Minden paramétercsoportban a paraméterek a fájlban megadott sorrendben vannak. A normál komponens paraméterek egy csoportja a következő elemekből áll:
A TYPE vezérlő típus értékei:
- LISTA - válassza ki az értékek listáját. A LIST-típus esetében az értékek a következő típusú értékekből állnak:
- STRING - szövegbeviteli mező.
- CHECKBOX - igen / nem.
- CUSTOM - lehetővé teszi egyedi vezérlők létrehozását.
- FÁJL - válasszon ki egy fájlt.
A lista megjelenése a MULTIPLE és ADDITIONAL_VALUES gombok jelenlététől / hiányától függően változik:
- Ha a MULTIPLE és az ADDITIONAL_VALUES hiányzik, vagy egyenlő az "N" értékkel, akkor megjelenik egy egyszerű lista, a listához nincsenek értékek.
- Ha ADDITIONAL_VALUES = "Y", MULTIPLE = "N", akkor hozzáadódik a "other" érték a listához és további manuális mezőbe írja be az értéket:
Megjegyzés. Pillanatképek készültek a SIZE = 9 értékre. Ha ez a kulcs nincs megadva, akkor a lista lesz lefelé.
A REFRESH paraméter az érték kiválasztása után lehetővé teszi az egész alak túlterhelését paraméterekkel. Ez például egy adott információs blokk típusának kiválasztására szolgál. Vagyis két paraméterünk van: az információs blokk típusa és az információs blokk kódja. A kiindulási pozíció az összes információblokk első listáján található, ezen a webhely összes információblokkjának második listájában, és az információblokk kívánt típusának kiválasztása után az összetevő paraméterei túlterheltek és csak a kívánt típusú információblokkokat látjuk.
Külsőleg LIST típusú paraméterek esetén ez a gomb olyan gombként jelenik meg, amelyen a paraméter melletti OK szöveg szerepel (lásd a fenti képernyőképeket).
Ha egy bizonyos paramétert szeretne megjeleníteni, vagy nem a másiktól függ, akkor ez megtörténik. Meg kell adnunk az információs blokk tulajdonságainak listáját. Tegyük fel, hogy az információblokk azonosító az IBLOCK_ID összetevő paraméterében található. és a paraméter, ahol a tulajdonságok listája PROP_LIST lesz. Az IBLOCK_ID paraméternek tartalmaznia kell a REFRESH = 'Y' gombot. kód:
Vannak speciális paraméterek, amelyek szabványosítottak és nem kell teljesen leírni. Elég, hogy jelezzék, hogy ők. Például,
Az első opció meghatározza, hogy az összetevő legyen-e az oldalfejlécre állítva, és a második - az összes gyorsítótárazási beállítás.
Csak összetett komponensek működhetnek a CNC módban, vagy újra definiálhatják a HTTP kérésből származó változókat. Ebben az esetben két paramétert kell megadni a paraméterek között:
- A "VARIABLE_ALIASES" egy tömb, amely leírja azokat a változókat, amelyeket egy összetevő HTTP-kérésből fogadhat. A tömb minden eleme így néz ki:
- "SEF_MODE" egy olyan tömb, amely leírja az útvonal módját az NC üzemmódban. A tömb minden eleme így néz ki:
A termék 12. változatával (az új D7 rendszermaggal) kezdődően lehetőség nyílt a kontroll paraméterek hozzáadására, amelyek lehetővé teszik a szín (COLORPICKER) meghatározását.
Ehhez a .parameters.php összetevő paraméterfájljában meg kell adnia a következőket:
Fontos. Az összetevők testreszabásának legmegfelelőbb változata egy külön névtérbe másolásra kerül, és az alkatrész egy példányával együtt dolgozik. Ebben az esetben figyelembe kell venni a következményeket:- Az összetevők összlétszáma növekszik, így a támogatandó források összege is nő.
- Az új fejlesztõ elsajátításának nehézsége: elõször meg kell találnia, ami eltér a már létezõ standard összetevõtõl.