Liitä ja mukauta CMS-moduuleja
Tässä oppaassa mukautat bluetronix CMS:n blogimoduulia: blogiluettelon aktivoinnista ja liittämisestä omiin moduulitiedostoihisi, asetusarvoihin ja kielitiedostoihin.
Oppaan vaatimukset ja tavoite
Tätä opasta varten tarvitset kehittäjäkäynnin bluetronix CMS:ään. Sinun pitäisi jo tietää, miten kehittäjäkansiot toimivat, ja miksi omat tiedostot merkitään järjestelmäkansioissa _own-merkinnällä.
Käytämme olemassa olevaa News - Blog -moduulia esimerkkinä. Aktivoi moduuli, liitä sen luettelo näkymä CMS-sivulle ja sen jälkeen mukauta omaa moduulitiedostoa sekä konfiguraatiota. Alkuperäiset tiedostot pysyvät muuttumattomina.
1. Aktivoi blogimoduuli
Avaa CMS:ssä Moduulit ja valitse News - Blog.
Aktivoi vaihtoehto Aktivoi blogimoduuli ja vahvista turvakysely OK.
Sen jälkeen moduulin konfiguraattori on käytettävissä. Vasemmalla ovat tekniset asetukset, oikealla kieliriippuvaiset moduulitekstit.
2. Blogiluettelo sisällytetään CMS-sivulle
Avaa sivu /Blog/index.html ja valitse HTML-koodi. Blogisivu liitetään lyhyellä CMS-merkinnällä.
<!--bx_Mod/Blog/Modul-Blog-List-->
Merkintä viittaa blogimoduuliin ja sen luettelo näkymään. CMS liittää renderöinnissä tässä kohdassa moduulin tuottaman ulostulon.
3. Keskusmoduulitiedostot avataan tiedostonhallinnassa
Moduulien todellinen PHP- ja HTML-logiikka ei sijaitse suoraan sivun HTML:ssä, vaan keskusjärjestelmäkansiossa bx_Mod. Avaa ensin tämä kansio Tiedostonhallinnassa ja sitten alikansio Blog.
Blogikansiossa löydät esimerkiksi Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, muita moduulitiedostoja ja alikansion languages.
4. Blogiluettelon oletustiedostoa katsotaan
Valitse Modul-Blog-List.php ja avaa se valitsemalla Muokkaa.
Oletustiedosto sisältää ohjelmalogikan luettelo-näkymälle. Näytetyssä koodissa liitetään muun muassa moduulin asetukset ja, jos saatavilla, projekti- erityinen config_own.php.
Näin voi yksi moduulin liittäminen eri sivuilla käyttää samaa keskeistä ohjelmalogikkaa. Projekteille, jotka käyttävät oletusmoduulia, voi myöhempi CMS-päivitys tehdä muutoksia tähän tiedostoon.
Älä muokkaa alkuperäistä Modul-Blog-List.php suoraan. Se kuuluu järjestelmään ja voidaan ylikirjoittaa CMS-päivityksessä.
5. Luo oma luettelonäkymä _own:n avulla
Jos haluat muuttaa tulosta, kopioi oletustiedosto. Omalla kopiollesi annetaan tarkalleen oikea _own-tunnus:
Modul-Blog-List.php
↓ kopieren
Modul-Blog-List_own.php
Avaa uusi tiedosto Modul-Blog-List_own.php. Tässä projekti- erityisessä versiossa voit muuttaa PHP-logiikkaa ja HTML-tulostusta ilman, että käsittelet oletustiedostoa.
Testissämme lisäämme otsikkoon hyvin näkyvän merkkijonon NEW!!!!. muu luettelonäkymä pysyy ennallaan.
Tallenna oma moduulitiedostosi ja lataa blogisivu uudelleen. CMS käyttää sopivaa _own-versiota, kun taas paikka, jossa on /Blog/index.html, pysyy muuttumattomana. Tunnistat aktiivisen oman tiedoston muuttuneesta otsikosta NEW!!!! UUSIMMAT ARTIKKELIT.
6. Moduulin asetukset ja oma kokoonpano
HTML-luonnoksen lisäksi voit muuttaa myös moduulin asetuksia. Kuvakaappauksessa näkyy asetussivulla esimerkiksi Modul-Blog-ShowCase arvo DS Repeats = 3.
Muuta arvo 2:ksi ja tallenna asetukset. Tämä määrittää halutun määrän tälle ShowCase-alueelle. Asetus liittyy Modul-Blog-ShowCase ja se ei ole automaattisesti sama kuin kaikkien blogiluettelon artikkelien määrä.
Oma konfiguraatio sijaitsee bx_Mod/Blog/config_own.php-tiedostossa. Valitse tämä tiedosto tiedostohallinnasta.
Näytetty config_own.php ylikirjoittaa arvon vain silloin, kun kyseinen moduuliosa Modul-Blog-ShowCase ladataan:
if($ModulNameGB == "Modul-Blog-ShowCase") {
$CF_DS_Repeats = 2;
}
Oletusarvot tulevat edelleen config.php:stä. Oma konfiguraatiotiedosto ei siten tarvitse toistaa kaikkia oletusarvoja, vaan se voi sisältää vain halutut poikkeamat.
7. Tietokannan taulukot ja moduulisivut määrätään
Oletusasetuksessa bx_Mod/Blog/config.php löydät muun muassa käytetyn tietokantataulun sekä polut yksityiskohtiin ja luetteloon. Näytetyissä esimerkeissä arvot ovat:
$CF_DatabaseTable = "Blog";
$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";
Jos kehität oman version blogimoduulista toiseen tarkoitukseen, voit omassa konfiguraatiossasi määrittää esimerkiksi toisen tietokantataulun. Tarkista samalla, että uusi taulu sisältää moduulitiedostosi odottamat kentät ja että luettelon ja yksityiskohtien sivut sopivat uuteen versioon.
8. Moduulin kielitiedostot
Polun bx_Mod/Blog/languages alla ovat blogimoduulin kielitiedostot. Olemassa oleville kielille on erilliset PHP-tiedostot, kuten de.php, en.php ja fr.php.
Täällä hallitaan kieliriippuvaisia moduulitekstejä. Käytä projekti- erityisiä muutoksia varten oman moduuliversiosi tukemaa tiedostomuotoa sen sijaan, että ylikirjoitat alkuperäisiä kielitiedostoja suoraan.
9. Eroa oletusmoduulin ja oman version välillä
_own-sääntö suojaa mukautuksesi ylikirjoittamiselta tavanomaisilla päivityksillä. Samalla olet itse vastuussa tämän yksilöllisen version ylläpidosta. Tarkista myöhemmissä CMS-päivityksissä, ovatko tärkeitä muutoksia oletustiedostoon myös merkityksellisiä omalle tiedostollesi.
10. Yhteenveto
Aktivoit blogimoduulin kohdasta Moduulit → Uutiset - Blogi, liität luettelo-näkymän CMS-merkinnän avulla ja hallitset varsinaista ohjelmalogiiikkaa keskeisesti kohdassa bx_Mod/Blog. Omia muutoksia varten kopioit Modul-Blog-List.php tiedoston Modul-Blog-List_own.php:ksi. Poikkeavat asetukset määritetään tarvittaessa config_own.php:ssä.
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-SeiteTällä tavalla olemassa olevaa moduulia voidaan laajentaa ilman, että alkuperäisiä järjestelmätiedostoja muokataan.
UKK
mitä asiakkaat meiltä usein kysyvät
Mitä pääsyä tarvitsen CMS-moduulien muokkaamiseen?
Tarvitset kehittäjäpääsyn bluetronix CMS:ään. Lisäksi sinun tulisi tuntea kehittäjäkansiot ja _own-sääntö.
Mistä aktivoidaan blogimoduuli?
Avaa Moduulit, valitse Uutiset - Blogi ja aktivoi Aktivoi Blogimoduuli. Vahvista turvallisuuskysymys.
Miten liitän blogilistan CMS-sivulle?
Avaa haluamasi sivun HTML-koodi ja lisää moduulimerkintä <!--bx_Mod/Blog/Modul-Blog-List-->.
Pitääkö blogilistan koko PHP-koodi kopioida sivulle?
Ei. Sivulla on vain moduulimerkintä. Asiaankuuluva logiikka ladataan keskitetysti blogimoduulista.
Missä sijaitsee blogilistan vakiotiedosto?
Löydät sen kohdasta bx_Mod/Blog/Modul-Blog-List.php tiedostonhallinnan kehittäjäalueelta.
Miten muokkaan moduulitiedostoa päivittämistä varten?
Kopioi vakiotiedosto ja merkitse kopio _own:lla, esimerkiksi Modul-Blog-List_own.php. Muokkaa sitten vain tätä omaa tiedostoa.
Kannattaako moduulimerkintää muuttaa, kun luon _own-tiedoston?
Ei. CMS:n tukemalle moduulitiedostolle voidaan automaattisesti käyttää sopivaa _own-versiota ilman, että olemassa olevaa moduuliyhdistelmää muutetaan.
Mihin käytetään config_own.php:tä?
Kohdasta bx_Mod/Blog/config_own.php voit ylikirjoittaa yksittäisiä arvoja vakiokonfiguraatiosta projektikohtaisesti.
Mitä DS Repeats tekee tässä esimerkissä?
Esimerkeissä Modul-Blog-ShowCase -asetusta muutetaan 3:sta 2:een. Se määrää tämän moduulialueen toistomäärän.
Missä on määritelty, mikä tietokantataulu blogimoduuli käyttää?
Konfiguraatiossa bx_Mod/Blog/config.php lukee esimerkissä $CF_DatabaseTable = "Blog";. Yhteys voidaan säätää omalle moduuliversiolle.
Missä löydän blogimoduulin kielitiedostot?
Kieliriippuvaiset PHP-tiedostot sijaitsevat kohdassa bx_Mod/Blog/languages, esimerkiksi de.php ja en.php.
Kuka vastaa oman moduulitiedoston ylläpidosta?
Oma _own-tiedosto pysyy voimassa säännöllisten CMS-päivitysten yhteydessä. Kehittäjän on itse tarkistettava, haluaako hän siirtää uusia virheenkorjauksia tai toimintoja vakiotiedostosta.