Widok dewelopera i obszary systemowe w bluetronix CMS
Dzięki dostępowi dewelopera zyskujesz dostęp do dodatkowych funkcji, folderów systemowych, tabel bazy danych oraz obszarów źródłowych bluetronix CMS. W tym samouczku dowiesz się, które obszary są dostępne i jak oddzielić własne rozszerzenia od plików systemowych.
Dodatkowe funkcje z dostępem dewelopera
Dzięki dostępowi dewelopera w bluetronix CMS dostępne są dodatkowe funkcje, które nie są widoczne w normalnym widoku użytkownika.
Obejmuje to dodatkowe foldery dewelopera w zarządzaniu plikami, dostęp do kodu PHP stron, dodatkowe tabele bazy danych dla deweloperów, a także skrypty systemowe, szablony layoutów i moduły.
Edycja kodu PHP stron
W normalnym widoku CMS możesz edytować kod HTML strony. Z dostępem dla dewelopera dostępny jest dodatkowo przycisk PHP Code.
Dzięki temu możesz umieścić własny kod PHP na stronie CMS, na przykład do zapytań bazy danych, treści dynamicznych, zastąpień w $LayoutHTML, funkcji CMS lub własnych funkcji PHP.
Dodatkowe tabele bazy danych
Z dostępem dla dewelopera w zarządzaniu bazą danych wyświetlane są dodatkowe tabele systemowe. Obejmuje to na przykład tabele dla layoutów, zarządzania stronami, konfiguracji systemu i inne wewnętrzne funkcje CMS.
Te tabele dewelopera i systemowe są oznaczone na czerwono w zarządzaniu bazą danych.
Struktura czerwono oznaczonych tabel bazy danych dewelopera nie może być zmieniana. Nie wolno usuwać, dodawać ani zmieniać nazw kolumn, zmieniać typów danych ani dostosowywać struktur systemowych. Tabele te mogą być aktualizowane lub zastępowane podczas aktualizacji systemu.
Foldery dewelopera w zarządzaniu plikami
Z dostępem dla dewelopera widoczne są dodatkowe foldery systemowe w zarządzaniu plikami. Te foldery dewelopera przedstawione są na czerwono i zasadniczo zaczynają się od bx_.
Do najważniejszych folderów należą bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script i bx_style.
bx_doc
W folderze bx_doc znajdują się przedinstalowane pliki i dokumenty przykładowe. Mogą to być na przykład dokumenty PDF używane w przykładowych stronach lub szablonach.
bx_fonts
W folderze bx_fonts znajdują się czcionki dostarczane przez bluetronix CMS lub zainstalowane. Te czcionki mogą być używane w różnych wzorach i układach CMS.
bx_Img
Folder bx_Img zawiera standardowe obrazy aktualnie używanego zestawu tematów.
Jako deweloper możesz wybrać inny zestaw obrazów tematycznych. Różne zestawy obrazów tematycznych używają tych samych zdefiniowanych nazw plików, co sprawia, że działają jak jednolita szablon. Struktura HTML nie musi być zmieniana podczas zmiany zestawu obrazów tematycznych.
bx_Import
Folder bx_Import jest używany do importowania zewnętrznych stron internetowych. Można na przykład przygotować strony Bootstrap-5 do importu i umieścić je w tym obszarze. Pliki są następnie analizowane i przejmowane do struktury bluetronix CMS.
bx_Layout
W folderze bx_Layout znajdują się szablony stron i sekcji CMS. Te szablony są następnie dostępne dla użytkownika, na przykład poprzez Wstaw → Sekcja strony.
Jako deweloper możesz tworzyć własne szablony dla sekcji Hero, obszarów tekstowych, obszarów produktów, obszarów kontaktowych, elementów teaserów i innych indywidualnych sekcji stron. Ostateczny klient może następnie dodać te elementy za pośrednictwem zwykłego edytora, nie musząc samodzielnie programować w HTML.
bx_script
W folderze bx_script znajdują się pliki JavaScript dostarczane przez bluetronix CMS. Należą do nich między innymi BxHeadScript.js oraz BxScript.js.
W zależności od aktywowanych języków mogą być również generowane wersje zależne od języka, na przykład BxScript_en.js, BxScript_de.js lub BxScript_fr.js.
W obrębie folderu skryptów znajduje się również katalog źródłowy. Tam znajdują się pojedyncze pliki źródłowe, z których generowane są później używane pliki główne.
bx_style
Analogicznie do bx_Script, bx_style zawiera centralne style bluetronix CMS. Na ich podstawie generowane są między innymi pliki arkusza stylów używane przez system. Tutaj również mogą być dostępne pliki źródłowe, z których są składane ostateczne pliki CSS.
Foldery systemowe i aktualizacje
Czerwono oznaczone foldery systemowe bx_ należą do bluetronix CMS i mogą być całkowicie lub częściowo nadpisywane podczas aktualizacji systemu. Dlatego własne zmiany nie mogą być zapisywane bezpośrednio w zwykłych plikach systemowych.
Własne pliki w obszarach systemowych muszą być oznaczone jako _own. To oznaczenie informuje bluetronix CMS, że jest to własny plik specyficzny dla projektu.
Przykłady to config_own.php, MyScript_own.js, MyStyle_own.css lub MyTemplate_own.txt. Rozszerzenie pliku nie ma w tym przypadku zasadniczego znaczenia. Decydujące jest oznaczenie _own w nazwie pliku.
Własne dostosowania należy zatem zawsze tworzyć wewnątrz czerwonych folderów systemowych jako plik _own. Dzięki temu te własne pliki pozostaną również podczas aktualizacji bluetronix CMS.
Nie zmieniać plików systemowych bezpośrednio
Istniejącego pliku systemowego nie powinieneś zatem edytować bezpośrednio. W razie potrzeby użyj go jako szablonu, skopiuj go, oznacz kopię jako _own i wprowadź własne zmiany w tym pliku.
bx_Mod
W folderze bx_Mod znajdują się moduły bluetronix CMS. Mogą to być między innymi blog, sklep, wyszukiwarka, logowanie i inne moduły CMS.
Moduł może zawierać różne pliki i obszary, takie jak konfiguracje, listy, widoki szczegółowe, skrypty PHP i inne pliki modułowe.
Dostosowywanie plików modułów
W przypadku plików modułowych również obowiązuje zasada: oryginalny plik systemowy nie powinien być modyfikowany bezpośrednio. Możesz go przeglądać, czytać, używać jako podstawy i kopiować. Aby stworzyć własną wersję, następnie tworzysz kopię z _own i wprowadzasz zmiany tam.
Najważniejsze zasady dla deweloperów
1. Nie zmieniaj strukturalnie tabel bazy danych oznaczonych na czerwono.
2. Czerwono oznaczone foldery systemowe bx_ mogą zostać nadpisane podczas aktualizacji.
3. Nie zmieniaj bezpośrednio plików systemowych dla swoich własnych dostosowań.
4. Własne pliki w obrębie obszarów systemowych zawsze oznaczaj jako _own.
5. Pliki systemowe mogą być używane jako wzór do odczytu i kopiowania.
6. Własne dostosowania wprowadzaj później w pliku _own.
Podsumowanie
Dostęp dewelopera rozszerza CMS bluetronix o dodatkowe funkcje i obszary systemowe, takie jak kod PHP, tabele bazy danych dla deweloperów, foldery systemowe bx_, moduły, skrypty, style i szablony układów.
Szczególnie istotne jest rozdzielenie plików systemowych i własnych rozszerzeń. Oryginalne pliki systemowe używasz jako wzoru, a własne dostosowania tworzysz jako pliki _own.
FAQ
co klienci często nas pytają
Jakie dodatkowe funkcje otrzymam z dostępem dewelopera?
Otrzymasz między innymi dostęp do dodatkowych folderów dewelopera, kodu PHP z podstron, dodatkowych tabel systemowych oraz do skryptów systemowych, szablonów układów i modułów.
Gdzie mogę umieścić własny kod PHP dla strony?
Z dostępem dewelopera przy stronie CMS dostępny jest dodatkowy przycisk PHP Code.
Czy mogę strukturalnie zmieniać tabeli bazy danych oznaczone na czerwono?
Struktura tych tabel deweloperskich i systemowych nie może być zmieniana. Nie powinieneś tam usuwać, dodawać ani zmieniać nazw kolumn oraz dostosowywać typów danych lub struktur systemowych.
Jak rozpoznam foldery dewelopera?
Foldery dewelopera są przedstawiane na czerwono w zarządzaniu plikami i w zasadzie zaczynają się od bx_.
Jakie zadanie ma bx_Layout?
W bx_Layout znajdują się szablony stron i sekcji CMS. Jako deweloper możesz tam udostępniać własne szablony, które później klient końcowy może wybierać przez Wstaw → Sekcja strony.
Dlaczego nie powinienem zmieniać plików systemowych bezpośrednio?
Pliki systemowe i foldery systemowe mogą zostać nadpisane podczas aktualizacji CMS bluetronix. Bezpośrednie zmiany mogą w związku z tym zostać utracone.
Jak stworzyć własne pliki, które będą odporne na aktualizacje?
Własne pliki w obrębie obszarów systemowych oznaczasz w nazwie pliku jako _own, na przykład MyScript_own.js lub MyStyle_own.css.
Czy mogę użyć istniejących plików systemowych jako szablonów?
Tak. Możesz przeglądać plik systemowy i używać go jako podstawy. Aby wprowadzić własne zmiany, powinieneś go skopiować, oznaczyć kopię jako _own i potem edytować tylko ten własny plik.