Kehittäjänäyttö ja järjestelmäalueet bluetronix CMS:ssä
Kehittäjäkäytön kautta saat pääsyn lisätoimintoihin, järjestelmähakemistoihin, tietokantatauluihin ja bluetronix CMS:n lähdealueisiin. Tässä oppaassa opit, mitkä alueet ovat käytettävissä ja miten voit pitää omat laajennuksesi eristettyinä järjestelmätiedostoista.
Lisätoiminnot kehittäjäkäytön kautta
Kehittäjäkäytön kautta bluetronix CMS:ssä on saatavilla lisätoimintoja, joita ei näy tavallisessa käyttäjänäkymässä.
Näihin kuuluvat lisäkehittäjän kansiot tiedostonhallinnassa, pääsy PHP-koodiin sivuilla, lisäkehittäjä tietokantataulut sekä järjestelmäskriptit, ulkoasupohjat ja moduulit.
Muokkaa sivujen PHP-koodia
Normaalissa CMS-näkymässä voit muokata sivun HTML-koodia. Kehittäjäpääsyllä sinulla on lisäksi käytössä PHP Code -painike.
Tämän avulla voit liittää omaa PHP-koodia CMS-sivulle, esimerkiksi tietokantakyselyille, dynaamisille sisällöille, korvauksille $LayoutHTML:ssä, CMS-toiminnoille tai omille PHP-toiminnoillesi.
Lisä tietokantatauluja
Kehittäjäpääsyllä tietokannan hallinnassa näytetään lisäjärjestelmätietokantatauluja. Näihin kuuluvat esimerkiksi taulut ulkoasuille, sivuhallinnalle, järjestelmäkokoonpanolle ja muille sisäisille CMS-toiminnoille.
Nämä kehittäjä- ja järjestelmätietokantataulut korostetaan punaisella tietokannan hallinnassa.
Punaisella merkittyjen kehittäjätietokantataulujen rakennetta ei saa muuttaa. Et saa poistaa, lisätä tai nimetä uudelleen sarakkeita, muuttaa tietotyyppejä tai mukauttaa järjestelmästruktuureita. Nämä taulut voidaan päivittää tai korvata järjestelmäpäivityksen yhteydessä.
Kehittäjäkansiot tiedostohallinnassa
Kehittäjäpääsyllä tiedostonhallinnassa näkyvät lisäjärjestelmäkansiot. Nämä kehittäjäkansiot on merkitty punaisella ja ne alkavat pääsääntöisesti bx_-alkuisilla nimillä.
Tärkeimpiä kansioita ovat bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script ja bx_style.
bx_doc
Kansiossa bx_doc on esiasennettuja esimerkkitiedostoja ja asiakirjoja. Näihin voivat kuulua esimerkiksi PDF-dokumentit, joita käytetään esimerkkisivuilla tai malleissa.
bx_fonts
Kansiossa bx_fonts on bluetronix CMS:n tarjoamat tai asennetut fontit. Näitä fontteja voidaan käyttää CMS:n eri ulkoasuissa ja muodoissa.
bx_Img
Kansio bx_Img sisältää nykyisin käytössä olevan teeman vakiokuvat.
Kehittäjänä voit valita toisen teeman kuvapaketin. Eri teemakuvapaketit käyttävät samoja määriteltyjä tiedostonimiä, joten ne toimivat yhtenäisenä mallina. HTML-rakennetta ei tarvitse muuttaa, kun teemakuvapakettia vaihdetaan.
bx_Import
Kansiossa bx_Import käytetään ulkoisten verkkosivujen tuontiin. Esimerkiksi Bootstrap-5-sivustot voidaan valmistella tuontia varten ja tallentaa tälle alueelle. Tiedostot analysoidaan tämän jälkeen ja otetaan bluetronix CMS:n rakenteeseen.
bx_Layout
Kansiossa bx_Layout ovat CMS:n sivu- ja osiomallit. Nämä mallit ovat käyttäjän käytettävissä esimerkiksi kohdasta Lisää → Sivupätkä.
Kehittäjänä voit luoda omia malleja Hero-osioille, tekstialueille, tuotealueille, yhteystietoalueille, teaser-elementeille ja muille yksilöllisille sivuosioille. Loppukäyttäjä voi lisätä nämä elementit tavallisen editorin kautta ilman, että hänen tarvitsee ohjelmoida HTML:ää.
bx_script
Kansiossa bx_script on bluetronix CMS:n tarjoamat JavaScript-tiedostot. Näihin kuuluvat muun muassa BxHeadScript.js ja BxScript.js.
Riippuen käytössä olevista kielistä voidaan luoda myös kieliriippuvaisia versioita, kuten BxScript_en.js, BxScript_de.js tai BxScript_fr.js.
Skriptikansiossa on lisäksi lähdetiedostohakemisto. Siellä sijaitsevat yksittäiset lähdetiedostot tai osat, joista myöhemmin käytettävät päädokumentit luodaan.
bx_style
Analogisesti bx_Script:in kanssa bx_style sisältää bluetronix CMS:n keskeiset tyylit. Näistä luodaan muun muassa järjestelmän käyttämät CSS-tiedostot. Myös täällä voi olla lähdetiedostoja, joista lopulliset CSS-tiedostot koottiin.
Järjestelmähakemistot ja päivitykset
Punaisella merkittyjä bx_-järjestelmökansioita käytetään bluetronix CMS:ssä, ja ne voidaan järjestelmäpäivityksen yhteydessä kokonaan tai osittain korvata. Omia muutoksia ei siis saa tallentaa suoraan normaaleihin järjestelmätiedostoihin.
Omien tiedostojen järjestelmäalueilla on merkittävä _own. Tämä merkintä ilmoittaa bluetronix CMS:lle, että kyseessä on oma projektiin liittyvä tiedosto.
Esimerkkejä ovat config_own.php, MyScript_own.js, MyStyle_own.css tai MyTemplate_own.txt. Tiedostopäätteellä ei ole perusteita, tärkeä on merkintä _own tiedoston nimessä.
Omia mukautuksia tulisi siten aina luoda punaisissa järjestelmäkansioissa _own-tiedostona. Tämä varmistaa, että nämä omat tiedostot säilyvät myös bluetronix CMS:n päivityksen yhteydessä.
Älä muuta järjestelmätiedostoja suoraan
Ole siis muokkaamatta suoraan olemassa olevaa järjestelmätiedostoa. Käytä sitä mallina tarvittaessa, kopioi se, merkitse kopio _own:lla ja tee omat mukautuksesi sitten tähän tiedostoon.
bx_Mod
Kansiossa bx_Mod ovat bluetronix CMS:n moduulit. Näihin voivat kuulua esimerkiksi blogi, kauppa, haku, kirjautuminen ja muut CMS-moduulit.
Moduuli voi sisältää erilaisia tiedostoja ja alueita, kuten kokoonpanoja, listoja, yksityiskohtaisia näkymiä, PHP-skriptejä ja muita modulitiedostoja.
Muokkaa moduulitiedostoja
Myös moduulitiedostojen kohdalla pätee: alkuperäistä järjestelmätiedostoa ei tulisi muuttaa suoraan. Voit näyttää, lukea, käyttää pohjana ja kopioida sitä. Oman version luomiseksi tee sen jälkeen kopio, jossa on _own, ja tee muutoksesi siellä.
Tärkeimmät säännöt kehittäjille
1. Punaisella merkittyjä tietokantatauluja ei saa muuttaa rakenteellisesti.
2. Punaisella merkittyjä bx_-järjestelmäkansioita voidaan ylikirjoittaa päivityksissä.
3. Järjestelmätiedostoja ei saa muuttaa suoraan omia mukautuksia varten.
4. Omia tiedostoja järjestelmäalueissa on aina merkittävä _own.
5. Järjestelmätiedostoja voidaan lukea ja kopioida mallina.
6. Omia mukautuksia on suoritettava sen jälkeen _own-tiedostossa.
Yhteenveto
Kehittäjäkäyttöoikeus laajentaa bluetronix CMS:ää lisätoiminnoilla ja järjestelmäalueilla, kuten PHP-koodilla, kehittäjä-tietokantatauluilla, bx_-järjestelmäkansioilla, moduuleilla, skripteillä, tyyleillä ja asettelupohjilla.
Erityisen tärkeää on erottaa järjestelmätiedostot ja omat laajennukset. Käytä alkuperäisiä järjestelmätiedostoja mallina, omat mukautukset tee _own-tiedostona.
UKK
mitä asiakkaat meiltä usein kysyvät
Mitä lisätoimintoja saan kehittäjäkäyttöoikeuden myötä?
Saat muun muassa pääsyn lisäkehittäjäkansioihin, sivujen PHP-koodiin, lisäjärjestelmätauluihin sekä järjestelmäskripteihin, asettelupohjiin ja moduuleihin.
Missä voin tallentaa oman PHP-koodin sivua varten?
Kehittäjäkäytön yhteydessä CMS-sivulla on lisäksi käytettävissä PHP Code -painike.
Saanko muuttaa punaisella merkittyjä tietokantatauluja rakenteellisesti?
Tätä kehittäjä- ja järjestelmätaulujen rakennetta ei saa muuttaa. Siellä ei tule poistaa, lisätä tai nimetä sarakkeita uudelleen eikä muuttaa tietotyyppejä tai järjestelmärakenteita.
Mistä tunnistan kehittäjäkansiot?
Kehittäjäkansiot näkyvät tiedostohallinnassa punaisina ja ne alkavat aina bx_.
Mikä on bx_Layoutin tehtävä?
bx_Layout:ssa on CMS:n sivu- ja osapohjat. Kehittäjänä voit tarjota omia malleja, joita loppukäyttäjä voi myöhemmin valita Lisää → Osio kautta.
Miksi en saa muuttaa järjestelmätiedostoja suoraan?
Järjestelmätiedostoja ja -kansioita voidaan ylikirjoittaa bluetronix CMS:n päivityksen yhteydessä. Suorat muutokset saattavat sen vuoksi kadota.
Miten voin luoda omat tiedostoni päivitysystävällisiksi?
Omat tiedostosi järjestelmäalueissa tulee merkitä tiedostonimessä _own, esimerkiksi MyScript_own.js tai MyStyle_own.css.
Voinko käyttää olemassa olevia järjestelmätiedostoja mallina?
Kyllä. Voit tarkastella järjestelmätiedostoa ja käyttää sitä pohjana. Omia mukautuksia varten sinun tulisi kopioida se, merkitä kopio _own:llä ja muokata vain tätä omaa tiedostoa.