Octobercms orosz
Kétféle módon lehet beállítani plugin: formanyomtatvány az adminisztrációs felület, és a konfigurációs fájlok. A formák, hogy több lehetőséget, de használatuk speciális szakértelmet igényel. Ezért a kezdeti szakaszban a fejlődés jobb kihasználása konfigurációs fájlokat.
Beállítása az adatbázis
Hozhat létre modelleket kell tárolni a beállításokat az adatbázist a végrehajtás SettingsModel viselkedés az osztályban modellben. Ez a modell is használható űrlapok létrehozásához a beállításokat a közigazgatási része a helyszínen. Nem kell, hogy hozzon létre saját táblát az adatbázisban és ellenőrzések formáinak kialakítása.
Class konfigurációs modell kell terjednie a Model osztály és végrehajtja viselkedés System.Behaviors.SettingsModel. Modellek a beállításokkal, valamint más modelleket kell egy alkönyvtárban bővítmény modellek. A modell ebben a példában legyen a plugins / csúcspont / demo / modellek / settings.php.
$ SettingsCode tulajdonság kötelező a modell a beállításokat. Ez tartalmaz egy egyedi kulcs tárolására használt adatbázis beállításokat.
Az ingatlan $ settingsFields is elengedhetetlen, ha lesz hozzá az űrlapot a beállításokon ezt a modellt. Az ingatlan nevét tartalmazza YAML fájlt, amely tartalmazza a leírást mezőket. Ezt a fájlt kell elhelyezni egy mappában, amelynek neve megegyezik a nevét a modell osztályban. Az előző példában a mappastruktúrát kell kinéznie:
Modellek a beállításokkal lehet regisztrálni a regisztrációs bővítmény fájlt. hogy megjelennek a beállítások oldalon, de ez nem kötelező. Beállíthatjuk, és letölteni az értékeket ugyanúgy, mint bármely más modellek.
Entry modell beállítások
Modell egy statikus konfiguráció módszerének beállítása. amely lehetővé teszi, hogy mentse az egyéni vagy több értéket. Ön is használja a szabványos funkciók a modell, hogy rögzítse a tulajdonságok a modell, és mentse magát a modellt. például:
Olvasás a modellben a beállításokat
A modell a beállításokkal egy statikus módszer get. amely lehetővé teszi, hogy megkapjuk az egyes értékeket. Ezen felül, ha létrehoz egy példányt a modell osztály segítségével példánymetódus. Közvetlenül is kap az értékeket az adatbázisból.
oldal beállítások
Az adminisztrációs része a helyszínen van egy külön rész a beállítások és konfigurációk. Ez akkor érhető el, ha rákattint a Beállítások hivatkozásra (beállítások) a főmenüben. Ez az oldal tartalmaz egy listát a linkeket a beállítások oldalon, amelyeket a rendszer által, vagy plug-inek.
Egy link hozzáadása az oldalt a beállítások menüben
A listát a linkeket oldalakat a beállítások módosíthatók módszerrel registerSettings belül a plugin regisztrációs osztályban. Amikor egy új kapcsolat, akkor két lehetőség van: hozzon létre egy linket egy adott oldal vagy az oldalra a modellt. A következő példa bemutatja, hogyan lehet létrehozni egy linket erre az oldalra:
Megjegyzés: A beállítási oldalakon meg kell határoznia az összefüggésben, hogy jelölje ki a megfelelő elemet a menüben. A modell keretében automatikusan kerül meghatározásra.
A következő példa bemutatja, hogyan lehet létrehozni egy linket a modell beállításait.
Tetszőleges használt paraméter a kulcsszavak. Ha nincs megadva, a keresés lesz a címkén és a leírás.
Beállítása keretében
Akárcsak a vezérlőben. beállítások oldalon meg kell határozniuk a kontextusban. Erre azért van szükség annak érdekében, hogy megtalálják a jelenlegi menüpont, és legyen az aktív. Ezt általában a kontroller kivitelező:
Az első érv a módszer setContext - author.plugin. Következő a legfontosabb, hogy a megadott módszer registerSettings.
konfigurációs fájl
Plug-inek tartalmazhat egy konfigurációs fájlt config.php az almappa config. Példa fájl tartalma:
Használja a Config osztály eléréséhez meghatározott értékeket a konfigurációs fájlban. Módszer Config :: kap ($ name, $ default = null) veszi az első paraméter a neve a következő formátumban: Acme.Demo :: maxItems. A második paraméter az alapértelmezett érték, amelyet vissza kell, ha a konfigurációs opció nem létezik. például:
Most, hogy APP_ENV - termelés. maxItems 25 egyenlő lesz.