CMS-modulok integrálása és testreszabása

A bemutató előfeltételei és célja

Ehhez a bemutatóhoz szükséged van egy Fejlesztői hozzáférésre a bluetronix CMS-hez. Már tudnod kell, hogyan működnek a fejlesztői mappák, és miért jelölik a saját fájlokat _own címkével a rendszer mappákban.

Az elérhető Hírek - Blog modult használjuk példaként. Aktiválod a modult, integrálod a lista nézetét egy CMS-oldalba, majd célzottan testreszabod a saját modulfájlt és a konfigurációt. Az eredeti fájlok változatlanok maradnak.

1. Blog-modul aktiválása

Nyisd meg a CMS-t, válaszd a Modulok menüpontot, majd az Hírek - Blog modult.

Aktiváld a Blog modul aktiválása opciót, és erősítsd meg a biztonsági kérdést a OK gombbal.

Ezután a modul konfigurálója rendelkezésedre áll. Bal oldalon a műszaki beállítások, jobbra pedig a nyelvfüggő modul szövegek találhatók.

2. Blog lista beillesztése egy CMS oldalra

Nyisd meg az oldalt /Blog/index.html, és válaszd az HTML Kód opciót. A blogoldal rövid CMS-jelöléssel van integrálva.

<!--bx_Mod/Blog/Modul-Blog-List-->

A jelölés a blogmodulra és annak lista nézetére utal. A CMS ezen a ponton a modul által generált kimenetet helyezi el a renderelés során.

3. Központi modulfájlok megnyitása a fájlkezelőben

A modulok tényleges PHP- és HTML-logikája nem közvetlenül az oldal HTML-jében található, hanem központilag a bx_Mod rendszer mappájában. Először nyisd meg a Fájlkezelőt, majd ezt a mappát, és utána a Blog almappát.

A Blog mappában például a Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, további modulfájlok és a languages almappa található.

4. A blog lista alapfájlja

Válaszd a Modul-Blog-List.php fájlt, és nyisd meg a Szerkesztés menüpont alatt.

A standard fájl tartalmazza a programlogikát a lista nézethez. A bemutatott kódban többek között a modul konfigurációját és, ha létezik, a projektspecifikus config_own.php fájlt is beemeljük.

Ezzel egyetlen modul beágyazás ugyanazt a központi programlogikát használhatja különböző oldalakon. Azokhoz a projektekhez, amelyek a standard modult használják, a későbbi CMS-frissítések módosításokat hozhatnak erre a fájlra.

Ne módosítsd közvetlenül az eredeti Modul-Blog-List.php fájlt. Ez a rendszer része, és a CMS-frissítés során felülírhatják.

5. Saját listanézet létrehozása _own-nal

Ahhoz, hogy megváltoztathasd a kimenetet, másold le a standard fájlt. A saját másolat pontosan a megfelelő _own jelölést kapja:

Modul-Blog-List.php
        ↓ kopieren
Modul-Blog-List_own.php

Nyisd meg az új fájlt Modul-Blog-List_own.php. Ebben a projektspecifikus változatban módosíthatod a PHP logikát és a HTML kimenetet anélkül, hogy a standard fájt érintenéd.

A tesztünk során a fejléchez hozzáadjuk a jól látható NEW!!!! karakterláncot. A többi lista nézet változatlan marad.

Mentsd el a saját modul fájlt, és töltsd újra a blogoldalt. A CMS a megfelelő _own változatot használja, míg a helyőrző a /Blog/index.html fájlban változatlan marad. Az aktív saját fájl a megváltozott fejléc NEW!!!! NEUESTE ARTIKEL alapján azonosítható.

6. Modulbeállítások és saját konfiguráció

A HTML kimenet mellett a modul konfigurációját is módosíthatod. A képernyőképen a konfigurátor például a Modul-Blog-ShowCase esetében a DS Repeats = 3 értéket mutatja.

Módosítsd az értéket 2-re, és mentsd el a beállítást. Ezzel a kívánt számot állítod be ennek a ShowCase területnek. A beállítás a Modul-Blog-ShowCase modulra vonatkozik, és nem az összes blog lista nézet cikk számával egyenlő.

A saját konfiguráció a bx_Mod/Blog/config_own.php alatt található. Válaszd ki ezt a fájlt a fájlkezelőben.

A bemutatott config_own.php célzottan csak akkor írja felül az értéket, ha a vonatkozó modulterület Modul-Blog-ShowCase be van töltve:

if($ModulNameGB == "Modul-Blog-ShowCase") {
   $CF_DS_Repeats = 2;
}

A standard értékek továbbra is a config.php-ból származnak. Ezért egy saját konfigurációs fájlnak nem kell tartalmaznia az összes standard értéket, hanem csak a kívánt eltéréseket.

7. Adatbázistábla és modul oldalak meghatározása

A standard konfigurációban bx_Mod/Blog/config.php alatt található többek között a használt adatbázis tábla és az útvonalak a részletes és lista nézethez. A bemutatott példában az értékek a következők:

$CF_DatabaseTable = "Blog";

$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";

Ha a blog modul alapján saját változatot dolgozol ki más célra, akkor a saját konfigurációdban például egy másik adatbázis táblát is megadhatsz. Ellenőrizd, hogy az új tábla tartalmazza-e a modul fájlod által elvárt mezőket, és hogy a lista- és részletező oldalak illeszkednek-e az új változathoz.

8. A modul nyelvi fájljai

A bx_Mod/Blog/languages mappában találhatók a blog modul nyelvi fájljai. A létező nyelvekhez külön PHP fájlok tartoznak, például de.php, en.php és fr.php.

Itt kezeljük a nyelvfüggő modul szövegeket. A projektspecifikus változtatásokhoz használd a modul verziód által támogatott saját fájlformátumot, ahelyett, hogy közvetlenül felülírnád az eredeti nyelvi fájlokat.

9. Alapértelmezett modul és saját verzió megkülönböztetése

A _own szabály megvédi a módosításaidat a rendszeres frissítések általi felülírástól. Ugyanakkor neked kell gondoskodnod ennek az egyedi verziónak a karbantartásáról. Ellenőrizd a későbbi CMS-frissítéseknél, hogy a standard fájl legfontosabb módosításai relevánsak-e a saját fájlod számára.

10. Összefoglalás

A blog modult a Modulok → Hírek - Blog menüpont alatt aktiválod, a lista nézetet egy CMS-jelölőn keresztül ágyazod be, és az igazi programlogikát központilag a bx_Mod/Blog alatt kezeled. A saját módosításokhoz másold le a Modul-Blog-List.php fájlt Modul-Blog-List_own.php-ra. A standardtól eltérő beállításokat szükség szerint a config_own.php fájlba írd.

CMS-Seite /Blog/index.html
        ↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
        ↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
        ↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-Seite

Ezzel a módszerrel egy meglévő modult célzottan lehet bővíteni anélkül, hogy a rendszer eredeti fájljait megváltoztatnánk.