Pobierz aplikację teraz i przetestuj przez 10 dni za darmo
Waluta Wybierz język Wybierz region

Cel samouczka

W tym samouczku zaimportujesz istniejący układ Bootstrap-5 do CMS bluetronix. Rozłożysz oryginalną stronę HTML na nagłówek, stopkę, pojedyncze szablony sekcji i właściwą ramę układu. Następnie możesz swobodnie wstawiać, przesuwać i wielokrotnie używać poszczególnych sekcji w edytorze.

Uwaga: Ten samouczek dotyczy podstawowego importu układów. Dalsza edycja lub zastąpienie obrazów będzie omówiona w następnym samouczku.

1. Otwórz oryginalny szablon w bx_Import

W menedżerze plików otwórz folder bx_Import. Tam zaimportowany układ znajduje się początkowo w oryginalnym stanie – na przykład z oryginalnymi folderami obrazów i plikami HTML. W tej sekcji pracujesz tylko z istniejącymi plikami oryginalnymi; zmiany nie będą zapisywane w oryginalnym szablonie.

Otwórz w tym przykładzie plik index.html i przejdź do Edycja. Ten plik zostanie teraz rozłożony na poszczególne składniki układu CMS.

Placeholder zróżniczenia ekranu: Menedżer plików z otwartym folderem bx_Import, folderami obrazów i oryginalnymi plikami HTML – dev_bootstrap_import_bx_import_originaldateien.jpeg. Zrób zdjęcie i wstaw je później w tym miejscu.

Placeholder zróżniczenia ekranu: index.html z bx_Import w edytorze HTML – dev_bootstrap_import_index_html_bearbeiten.jpeg. Zrób zdjęcie i wstaw je później w tym miejscu.

2. Wyodrębnij nagłówek z index.html

Wyszukaj w kodzie HTML za pomocą Strg + F header. Wiele szablonów Bootstrap pozwala szybko znaleźć nagłówek, ponieważ jest oznaczony odpowiednim elementem HTML. W niektórych szablonach nagłówek składa się jedynie z obszaru div; w takim przypadku musisz dokładniej zbadać budowę.

Zaznacz cały obszar nagłówka i skopiuj go. Najlepiej pracować w dwóch otwartych oknach, aby móc przełączać się między oryginalnym szablonem a projektem CMS.

Placeholder zróżniczenia ekranu: Obszar nagłówka index.html znaleziony przez wyszukiwanie i zaznaczony do skopiowania – dev_bootstrap_import_header_markieren.jpeg. Zrób zdjęcie i wstaw je później w tym miejscu.

3. Przenieś nagłówek do CMS

Wróć do swojego projektu, otwórz główny katalog, a następnie Nagłówek → Kod HTML. Wklej tam wcześniej skopiowany kod nagłówka.

Następnie sprawdź lokalne ścieżki. Wiele układów wymaga, aby ścieżki względne i ścieżki obrazów miały prowadzący ukośnik, aby poprawnie działały w ramach struktury CMS.

href="css/style.css"   →   href="/css/style.css"
src="images/logo.jpg"  →   src="/images/logo.jpg"

Ważne: Użyj Strg + H do wyszukiwania i zamieniania, ale nie wymieniaj ścieżek bezmyślnie. Szczególnie sprawdź zewnętrzne URL-e, kotwice, linki mailto: oraz już absolutne ścieżki.

Placeholder zrzutu ekranu: Główny katalog → Nagłówek → Kod HTML z wstawionym nagłówkiem – dev_bootstrap_import_header_html_einfuegen.jpeg. Zrób zdjęcie i następnie wstaw je w tym miejscu.

Następnie znajdź stopkę w oryginalnym index.html. Wytnij lub skopiuj cały obszar stopki i wklej go do przypisanej pliku stopki w głównym katalogu twojego projektu. Sprawdź również wszystkie lokalne href i src.

Placeholder zrzutu ekranu: Plik stopki w głównym katalogu z wstawionym kodem stopki – dev_bootstrap_import_footer_html_einfuegen.jpeg. Zrób zdjęcie i następnie wstaw je w tym miejscu.

5. Podziel obszar główny na pojedyncze szablony sekcji

Zawartość strony pozostająca po nagłówku i stopce nie jest kopiowana bezpośrednio do index.html twojego projektu. Zamiast tego otwórz bx_Layout → SectionTemplate.txt → Kod HTML.

Wklej pozostały obszar główny oryginalnego szablonu na końcu tego pliku. Następnie podziel go na poszczególne sekcje, które później będą dostępne oddzielnie w edytorze.

Między dwoma szablonami sekcji umieszczasz dokładnie następujący separator:

<!--__SP_SectionTemplate__-->

Każda sekcja oddzielona w ten sposób może być później wstawiana jako własny szablon w edytorze. Dzięki temu możesz dowolnie układać sekcje, korzystać z nich wielokrotnie lub pominąć na stronie.

Placeholder zrzutu ekranu: bx_Layout → SectionTemplate.txt z wieloma sekcjami i separatorem <!--__SP_SectionTemplate__--> – dev_bootstrap_import_sectiontemplate_trenner.jpeg. Zrób zdjęcie i następnie wstaw je w tym miejscu.

6. Przenieś ramę układu do 00_layout

Po oddzieleniu nagłówka, stopki i sekcji głównych pozostaje właściwa struktura HTML, na przykład z DOCTYPE, sekcją head oraz innymi nadrzędnymi elementami układu. Skopiuj ten pozostały kod.

Następnie otwórz zarządzanie bazą danych i edytuj bazę danych 00_layout. Są już dostępne szablony układu. Możesz edytować istniejący szablon lub stworzyć nowy.

Wklej skopiowaną strukturę pod LayoutHTML. W oryginalnych miejscach nagłówka, treści głównej i stopki użyj znaczników CMS:

__DB_Layout_Header__

__DB_Layout_Main__

__DB_Layout_Footer__

Podczas renderowania strony, te znaczniki zostaną zastąpione przez odpowiedni nagłówek, aktualną stronę główną i stopkę. Odpowiedni kod PHP pod LayoutPHP zostanie automatycznie wykonany podczas ładowania układu.

Placeholder zrzutu ekranu: Baza danych 00_layout z LayoutHTML oraz znacznikami dla nagłówka, głównej treści i stopki – dev_bootstrap_import_00_layout_layouthtml.jpeg. Zrób zdjęcie i następnie wstaw je w tym miejscu.

7. Sprawdź ścieżki CSS, JavaScript i favicon

Sprawdź w kodzie układu wszystkie odniesienia do plików CSS, JavaScript i favicon. Dodaj brakujący ukośnik na początku lokalnych ścieżek. Dla plików CSS i JavaScript użyj również oznaczenia wersji pliku CMS.

Wywołanie JavaScript może wyglądać na przykład tak:

<script src="__FV_/bx_script/core.min.js__"></script>

Znaczniki __FV_...__ pozwalają systemowi uwzględnić wersję pliku lub datę zmian podczas renderowania. Dzięki temu przeglądarka ładuje aktualny plik CSS lub JavaScript po zmianach, bez konieczności ręcznego aktualizowania pamięci podręcznej przeglądarki przez użytkownika.

8. Oczyść zawartość nagłówka i użyj HTML nagłówka

Sprawdź przejęty obszar head i usuń zawartości, które zostały już ustawione przez CMS lub są ładowane w innym miejscu. Możesz także usunąć trwały tytuł strony, jeśli jest on generowany automatycznie przez system.

Kod nagłówka, który jest potrzebny edytorowi i nie powinien być bezpośrednio częścią LayoutHTML, umieszczasz pod Extras → Header-HTML. Dzięki temu edytor może uwzględnić te treści podczas edytowania strony.

Placeholder zrzutu ekranu: Extras → Header-HTML z przeniesionym kodem nagłówka – dev_bootstrap_import_extras_header_html.jpeg. Zrób zdjęcie i następnie wstaw je w tym miejscu.

9. Wybierz zaimportowany układ dla strony

Jeśli stworzyłeś nowy układ w 00_layout, otwórz w edytorze Ustawienia strony i wybierz tam importowany układ. Dopiero wtedy odpowiednia strona będzie wyświetlana z tym szablonem układu.

Placeholder zrzutu ekranu: Ustawienia strony z wyborem nowo importowanego układu – dev_bootstrap_import_seiteneinstellungen_layout.jpeg. Zrób zdjęcie i następnie wstaw je w tym miejscu.

10. Zmontuj stronę główną z zaimportowanych sekcji

Kliknij na swojej stronie Edytować. Strona startowa może najpierw wydawać się pusta. To normalne, ponieważ żaden z nowych sekcji nie został jeszcze dodany do właściwej strony.

Wybierz Wstaw → Sekcję strony. Powinny pojawić się tam obszary, które wcześniej oddzieliłeś w SectionTemplate.txt przy użyciu separatora sekcji.

Wstaw kolejno potrzebne sekcje i odtwórz w ten sposób oryginalną stronę. Możesz później dowolnie przesuwać sekcje, pomijać je lub wstawiać wielokrotnie.

Placeholder zrzutu ekranu: Edytor → Wstaw → Sekcja strony z zaimportowanymi szablonami sekcji – dev_bootstrap_import_sections_einfuegen.jpeg. Zdjęcie należy jeszcze dodać i następnie umieścić w tym miejscu.

11. Użyj oryginalnej strony jako odniesienia

W Pliki → bx_Import możesz nadal otworzyć oryginalny index.html jako podgląd. Użyj go jako odniesienia, podczas gdy będziesz tworzyć swoją nową stronę CMS z poszczególnych sekcji.

Jeśli na początku brakuje zdjęć w poszczególnych szablonach, ich poprawne zaimportowanie będzie omówione w następnym poradniku.

12. Sprawdź ścieżki i edytowalność wszystkich sekcji

Na końcu jeszcze raz sprawdź Sekcje → Szablon sekcji i zweryfikuj wszystkie lokalne ścieżki. W przypadku wielu podobnych ścieżek możesz efektywnie wprowadzać zmiany w edytorze tekstu za pomocą Ctrl + H.

Następnie przetestuj każdą zaimportowaną sekcję w edytorze. Sprawdź, czy wszystkie treści są poprawnie wyświetlane i czy zamierzone teksty i elementy można edytować.

Jeśli na przykład tekstu nie można edytować, sprawdź jego strukturę HTML. Jeśli zwykły tekst znajduje się bezpośrednio w kontenerze div, może być sensowne przenieść go do odpowiedniego elementu p, w zależności od struktury.

Placeholder zrzutu ekranu: Gotowa strona startowa po wstawieniu i uporządkowaniu sekcji – dev_bootstrap_import_fertige_startseite.jpeg. Zdjęcie należy jeszcze dodać i następnie umieścić w tym miejscu.

13. Dlaczego układ jest dzielony

Dzięki podziałowi na nagłówek, stopkę, ramy układu i poszczególne sekcje, nie musisz ciągle kopiować tych elementów z oryginalnego pliku Bootstrap w przypadku nowych stron.

Centralny nagłówek i stopka mogą być ponownie wykorzystane, podczas gdy poszczególne sekcje strony są dostępne jako elastyczne szablony w edytorze. W ten sposób możesz tworzyć różne strony z szablonu Bootstrap i w każdej chwili zmieniać kolejność treści.

Podsumowanie

Do importu Bootstrap 5 użyj oryginalnych plików w bx_Import jako szablonu. Nagłówek i stopka są oddzielnie przenoszone do wyznaczonych obszarów CMS, główny obszar jest rozkładany na poszczególne szablony za pomocą SectionTemplate.txt, a pozostała ramka HTML jest zapisywana w 00_layout → LayoutHTML.

Następnie wybierasz układ w ustawieniach strony i komponujesz stronę za pomocą Wstaw → Sekcja strony z zaimportowanych sekcji. Na koniec sprawdź wszystkie ścieżki, odniesienia CSS i JavaScript oraz możliwość edytowania poszczególnych sekcji.

FAQ

co klienci często nas pytają

Dlaczego oryginalny szablon Bootstrap pozostaje w bx_Import?

Folder bx_Import służy jako punkt wyjścia i odniesienie dla zaimportowanego oryginalnego szablonu. Wymagane składniki są z niego przenoszone do odpowiednich obszarów CMS.

Którego pliku używam do pierwszego importu?

W tym poradniku używa się index.html jako punktu wyjścia. Z niego wydzielane są nagłówek, stopka, sekcje główne oraz pozostała ramka układu.

Jak szybko znaleźć nagłówek i stopkę w kodzie HTML?

Użyj Ctrl + F i wyszukaj na przykład w header lub footer. W przypadku szablonów bez odpowiednich znaczników HTML musisz dokładniej sprawdzić otaczające struktury div.

Gdzie są przechowywane poszczególne sekcje strony?

Szablony są przechowywane w bx_Layout w SectionTemplate.txt i oddzielane są za pomocą separatora <!--__SP_SectionTemplate__-->.

Jakie znaczniki są potrzebne w LayoutHTML?

W miejscach wyodrębnionych grup używasz __DB_Layout_Header__, __DB_Layout_Main__ i __DB_Layout_Footer__.

Dlaczego pliki CSS i JavaScript są oznaczone __FV_?

Dzięki temu CMS może brać pod uwagę wersję pliku lub datę jego zmiany podczas renderowania. Po przeprowadzeniu zmiany przeglądarka może załadować aktualny plik, zamiast używać przestarzałej wersji z pamięci podręcznej.

Dlaczego strona startowa jest początkowo pusta po imporcie układu?

Układ początkowo zapewnia jedynie ramkę. Rzeczywiste sekcje strony muszą być dodane za pomocą Wstaw → Sekcja strony.

Czy mogę wielokrotnie używać zaimportowanego fragmentu strony?

Tak. Oddzielne szablony sekcji można w edytorze wstawiać, przesuwać i używać wielokrotnie w razie potrzeby.

Co robić, gdy względne ścieżki do obrazów lub linków nie działają?

Sprawdź lokalne ścieżki href i src i w razie potrzeby dodaj wiodący slash. Możesz zastępować powtarzające się ścieżki za pomocą Ctrl + H, ale nie zmieniaj bezmyślnie zewnętrznych adresów URL, kotwic ani innych specjalnych ścieżek.

Co mogę zrobić, gdy tekst nie może być edytowany w edytorze?

Sprawdź strukturę HTML danej sekcji. Jeśli zwykły tekst znajduje się bezpośrednio w kontenerze div, odpowiedni element p może być sensowny w zależności od struktury.

Jak mogę porównać oryginalną stronę z tym, co tworzę?

Otwórz oryginalny index.html w sekcji Pliki → bx_Import przez podgląd i użyj go jako odniesienia do kolejności i struktury sekcji.

CMS