Wraz z phpBB3, phpBB Group udostępniło dwa podstawowe style autorstwa subBlue - prosilver oraz subsilver2, które się znacznie do siebie różnią względem kodu i wyglądu - aby dać webdesignerom jak największe pole manewru. W artykule zostaną krótko opisane funkcje i zawartość wszystkich plików.
Każdy styl zawiera plik style.cfg, w którym są zawarte wszystkie podstawowe informacje, takie jak nazwa stylu, jego wersja i autor. Obok niego, w katalogu stylu znajdują się trzy inne podkatalogi i w zależności od przeznaczenia zawierają obrazki, pliki *.HTML lub *.CSS.
- imageset - Wszystkie użyte w stylu obrazki, dodatkowe katalogi na tłumaczenia przycisków i plik imageset.cfg który definiuje nazwy, rozszerzenie i rozmiar wczytywanych obrazków.
- template - Wszystkie pliki HTML, odpowiedzialne za formę każdej strony forum i plik template.cfg zawierający informacje tylko o nazwie stylu, autorze i wersji.
- theme - Zawiera pliki CSS, odpowiedzialne za tła, kolory, wyświetlanie bloków, linki itd., plik theme.cfg oraz katalog /images zawierający obrazkowe tła, gradienty, ikonki.
Poniżej znajdziesz listę wszystkich plików styli phpBB3 (prosilver, jak i subsilver2). Różnią się one pod względem kodu, dlatego niektóre pliki mają inne zastosowania. Lista zostanie podzielona na pliki o podobnych funkcjach oraz pliki o różnym zastosowaniu.
Katalog theme
- stylesheet - Plik zawierający wszystkie używane klasy stylu (subsilver2) lub importujący treść innych plików CSS (prosilver).
Pliki CSS o różnych funkcjach. prosilver:
- bidi.css - Odpowiedzialny za korekty RTL dla języka Arabskiego i Hebrajskiego.
- buttons.css - Odpowiedzialny za specyfikację przycisków (Rozpocznij wątek, Odpowiedz itd.).
- colours.css - Znajdziesz w nim tła i większość kolorów wykorzystanych w stylu.
- common.css - Zawiera atrybuty nieprzypisane do innych plików. Odpowiada za wygląd m.in TOPu (headeru), strony głównej, pozycjonowanie elementów na stronie.
- content.css - Wyświetlanie stron wątków, działów.
- cp.css - Plik odpowiedzialny za wygląd panelu moderatora i użytkownika (Zakłądki, prywatne wiadomości itd.)
- forms.css - Plik odpowiedzialny za wygląd pól tekstowych i formularzy.
- large.css - Wczytywany po dwukrotnym wciśnięciu przycisku 'A'. Definiuje duży rozmiar czcionki.
- links.css - Plik odpowiadający za kolory, tła, podświetlenia linków. (Kolory są używane z colours.css, ten plik wykorzystywany jest do stylizacji linków.).
- medium.css - Wczytywany po jednokrotnym wciśnięciu przycisku 'A', definiuje średni rozmiar czcionki.
- normal.css - Zawiera zdefiniowaną domyślną wielkość czcionki. Punkt odniesienia dla funkcji przycisku 'A'.
- print.css - Plik odpowiedzialny za odpowiednie sformatowanie wątku na stronie drukowania.
- tweaks.css - Plik zawierający hacki, obejścia błędów dla przeglądarek nieradzących sobie z poprawnym interpretowaniem kodu.
Pliki są importowane do stylesheet.css za pomocą komendy:
@import url("nazwapliku.css");
Katalog template
- attachment.html - Plik odpowiedzialny za wyświetlanie załączników w postach i prywatnych wiadomościach.
- bbcode.html - Zawiera specyfikację przycisków i funkcji BBCode'ów.
- confirm_body.html - Odpowiada za wyświetlanie potwierdzenia, pojawiającego się po wykonanej czynności.
- custom_profile_fields.html - Wyświetla stronę pól profilu, widoczną podczas edycji profilu, lub podczas rejestracji nowego użytkownika.
- editor.js - Odpowiedzialny za wstawianie BBCode'ów lub innych obiektów do edytora postów.
- faq_body.html - Plik odpowiedzialny za budowę przewodnika po BBCode i FAQ.
- forumlist_body.html - Wyświetla kategorie, działy i poddziały.
- index_body.html - Zawarta w nim jest strona główna forum, między nagłówkiem (headerem), a stopką.
- jumpbox.html - Ten plik odpowiedzialny jest za listy wyboru, np. przechodzenia między działami, wybór stylu lub daty panelu 'Twoje konto'.
- login_body.html - Strona używana podczas logowania i korzystania z funkcji przypominania hasła.
- login_forum.html - Plik buduje stronę wpisywania hasła do chronionego działu.
- mcp_approve.html - Wyświetla stronę z wątkami i postami oczekującymi na akceptację moderatora.
- mcp_ban.html - Gdy moderator ma odpowiednie uprawnienia, tworzy stronę banowania w panelu moderatora.
- mcp_footer.html - Stopka panelu moderatora. W stylu subsilver2 zawiera paginację wątków i postów.
- mcp_forum.html - Lista moderowanych działów w panelu moderatora.
- mcp_front.html - Odpowiada za wyświetlenie pięciu ostatnich zgłoszeń, akcji i niezaakceptowanych wątków na stronie głównej panelu moderatora.
- mcp_header.html - Wyświetla karty i tytuły miejsc w których aktualnie przebywa moderator.
- mcp_logs.html - Plik tworzy stronę logów wszystkich moderatorów łącznie.
- mcp_message.html - Wyświetla potwierdzenie wykonanej akcji przez moderatora.
- mcp_move.html - Plik odpowiedzialny za wyświetlanie listy działów i potwierdzenia czynności przenoszenia wątku przez moderatora.
- mcp_notes_front.html - Plik odpowiedzialny za pole wyboru użytkownika na stronie głównej notatek o użytkownikach.
- mcp_notes_user.html - Plik odpowiedzialny za wyświetlanie podstawowych informacji notatek o wybranych użytkownikach.
- mcp_post.html - Plik odpowiedzialny za wyświetlanie opcji moderowania wątku, takich jak edycja postów, zmiana autora, blokowanie itd.
- mcp_queue.html - Plik odpowiedzialny za wyświetlanie wątków na stronie kolejki moderacji.
- mcp_reports.html - Wyświetlanie otwartych i zamkniętych zgłoszeń na stronie zgłoszonych postów w panelu moderatora.
- mcp_topic.html - Plik odpowiedzialny za wyświetlanie strony moderacji wątku w panelu moderatora, w której możesz edytować, przyklejać i blokować wybrane wątki.
- mcp_viewlogs.html - Wyświetla logi aktywności moderatorów w konkretnym wątku.
- mcp_warn_front.html - Plik odpowiedzialny za wyświetlanie pola wyszukiwania użytkownika oraz listy pięciu najnowszych ostrzeżeń i użytkowników o ich największej ilości na stronie głównej ostrzeżeń w panelu moderatora.
- mcp_warn_list.html - Odpowiedzialny za wyświetlanie listy wszystkich użytkowników z ostrzeżeniem.
- mcp_warn_post.html - Plik odpowiedzialny za wyświetlanie strony ostrzegania użytkownika za konkretnego posta. Aby wyświetlić tę stronę, kliknij na przycisk "Ostrzeż użytkownika" w wątku.
- mcp_warn_user.html - Odpowiedzialny za wyświetlanie strony ostrzeżenia konkretnego użytkownika, dodatkowo wyświetla się kiedy będziesz chciał dać ostrzeżenie użytkownikowi.
- mcp_whois.html - Plik wyświetlający informacje o IP użytkownika, na stronie "Kto to?".
- memberlist_body.html - Plik budujący listę użytkowników forum, wyświetlaną po naciśnięciu 'Użytkownicy' w menu.
- memberlist_email.html - Buduje stronę wysyłana maila do innych użytkowników.
- memberlist_im.html - Dodatkowe okno pop-up, przez które można wysłać wiadomość na komunikator ICQ, np. klikając na numer ICQ w profilu.
- memberlist_leaders.html - Wyświetla listę administratorów i moderatorów na stronie 'Ekipa'.
- memberlist_search.html - Wyszukiwarka nad listą użytkowników, wywoływana z linka 'Znajdź użytkownika'.
- memberlist_view.html - Plik odpowiedzialny za wyświetlanie strony profilu konkretnego użytkownika.
- message_body.html - Buduje powiadomienia, wyświetlane po wykonanej akcji, np. po dodaniu nowego wątku, po zalogowaniu, wylogowaniu itd.
- overall_footer.html - Stopka forum, importowana na każdej stronie. Zawiera informacje o autorach skryptu, tłumaczenia, stylu.
- overall_header.html - Wyświetlany na wszystkich stronach nagłówek forum (header). Odpowiada za logo, menu, linki itd.
- posting_attach_body.html - Umożliwia wysyłanie załączników podczas pisania.
- posting_body.html - Plik odpowiada za wyświetlanie strony edytora, służącej do pisania wątków, postów, prywatnych wiadomości itd.
- posting_buttons.html - Odpowiada za wyświetlanie przycisków BBCode w momencie pisania wątku, postu, prywatnej wiadomości itd.
- posting_poll_body.html - Wyświetla kartę z menu dodawania ankiety, podczas pisania wątku.
- posting_preview.html - Podgląd napisanego postu.
- posting_review.html - Pojawia się informacja, gdy jesteś w trakcie pisania postu, a w międzyczasie pojawi się nowa odpowiedź. Plik odpowiada za wyświetlenie nowych postów nad edytorem.
- posting_smilies.html - Plik odpowiada za wyświetlenie uśmieszków na stronie pisania.
- posting_topic_review.html - Przegląd wątku pod edytorem na stronie odpowiedzi. Zawiera cytowanie selektywne, szczegóły postów, zmianę widoku.
- search_body.html - Odpowiada za budowę strony głównej zaawansowanego wyszukiwania.
- simple_footer.html - Stopka w dodatkowych oknach, takich jak np. strona wszystkich uśmieszków, nowa prywatna wiadomość itd.
- simple_header.html - Nagłówek w dodatkowych oknach, takich jak np. strona wszystkich uśmieszków, nowa prywatna wiadomość itd.
- template.cfg - Plik zawierający informacje o szablonach HTML stylu.
- ucp_agreement.html - Plik wyświetlający informacje o licencji przed rejestracją oraz potwierdzenie jej akceptowania.
- ucp_attachments.html - Strona wyświetlająca wszystkie załączniki dodane przez użytkownika.
- ucp_footer.html - (Pusta) stopka panelu 'Twoje konto'.
- ucp_groups_manage.html - Strona zarządzania grupami w panelu 'Twoje konto', wyświetlana dla liderów grup.
- ucp_groups_membership.html - Strona odpowiedzialna za wyświetlanie specjalnej stronie grupy, zawierającej jej opis, liderów i członków. Aby przejść do strony grupy, kliknij na jej nazwę w legendzie.
- ucp_header.html - Nagłówek panelu, zawiera karty, bloki, linki...
- ucp_main_bookmarks.html - Strona wyświetlająca wszystkie dodane przez ciebie zakładki, oraz dająca możliwość zarządzania nimi.
- ucp_main_drafts.html - Plik pozwalający na zarządzanie kopiami roboczymi w panelu użytkownika. Aby się dostać do strony zarządzania, kliknij na 'Kopie robocze' na stronie głównej panelu 'Twoje konto'.
- ucp_main_front.html - Strona główna panelu użytkownika, aby się do niego dostać, kliknij na link 'Twoje konto' w menu forum.
- ucp_main_subscribed.html - Plik odpowiedzialny za wyświetlanie strony obserwowanych przez nas wątków. Link znajduje się na stronie głównej panelu użytkownika.
- ucp_pm_history.html - Historia wiadomości wyświetlana pod edytorem, gdy odpisujemy na konkretną prywatną wiadomość.
- ucp_pm_message_footer.html - Stopka strony prywatnych wiadomości.
- ucp_pm_message_header.html - Nagłówek prywatnych wiadomości, wyświetlany podczas ich przeglądania.
- ucp_pm_options.html - Ustawienia prywatnych wiadomości, aby przejść na tę stronę, kliknij na 'Zasady, foldery i ustawienia' na stronie głównej prywatnych wiadomości.
- ucp_pm_popup.html - Dodatkowe okno informujące o nowej prywatnej wiadomości.
- ucp_pm_viewfolder.html - Odpowiada za wyświetlanie zawartości dodatkowych folderów wiadomości.
- ucp_pm_viewmessage.html - Wyświetla wiadomość, aby zobaczyć tę stronę, przeczytaj jakąś wiadomość.
- ucp_pm_viewmessage_print.html - Plik odpowiedzialny za przygotowanie formy wiadomości do drukowania.
- ucp_prefs_personal.html - Strona główna ustawień użytkownika, aby ją zobaczyć kliknij na Ustawienia forum w profilu użytkownika.
- ucp_prefs_post.html - Zawiera podstawowe ustawienia wyświetlania postów, w ustawieniach forum w panelu użytkownika kliknij na 'Przeglądanie postów'.
- ucp_prefs_view.html - Plik odpowiedzialny za wyświetlanie strony ustawień forum dla twojego konta.
- ucp_profile_avatar.html - Pozwala na określenie swojego avataru, poprzez podanie do niego ścieżki czy wgranie ze swojego komputera. Jest również funkcja usunięcia avatara.
- ucp_profile_profile_info.html - Wyświetla możliwe do edycji informacje o twoim profilu. Możesz na niej napisać numery popularnych komunikatorów, adres twojej strony www, zainteresowania itd.
- ucp_profile_reg_details.html - Wyświetla stronę ze szczegółami rejestracji. Zawiera funkcję zmiany maila, hasła i jeśli administrator na to zezwoli, zmiany nazwy użytkownika.
- ucp_profile_signature.html - Plik odpowiedzialny za budowę strony edycji sygnatury w panelu użytkownika.
- ucp_register.html - Wyświetla formularz rejestracji nowego użytkownika.
- ucp_remind.html - Strona odpowiedzialna za wyświetlanie formularza przypominania hasła.
- ucp_resend.html - Strona umożliwiająca wysłanie kolejny raz maila aktywacyjnego, jeśli nie aktywowałeś swojego maila, kliknij na "Wyślij mail aktywacyjny", aby zobaczyć tę stronę.
- ucp_zebra_foes.html - Strona zarządzania wrogami, umożliwia dodawanie, zarządzanie i pokazuje wrogów, w panelu użytkownika "Twoje konto" kliknij na kartę "Przyjaciele i wrogowie", a następnie na "Wrogowie", aby zobaczyć tę stronę.
- ucp_zebra_friends.html - Strona zarządzania przyjaciółmi, umożliwia dodawanie, zarządzanie i pokazuje przyjaciół, w panelu użytkownika "Twoje konto" kliknij na kartę "Przyjaciele i wrogowie", a następnie na "Przyjaciele", aby zobaczyć tę stronę.
- viewforum_body.html - Importowany do index_body.html, ma za zadanie wyświetlanie listy działów.
- viewonline_body.html - Odpowiada za stronę wyświetlającą informacje o tym, kto w tym momencie jest online. Aby ją zobaczyć, kliknij na link 'Kto przegląda forum' na stronie głównej.
- viewonline_whois.html - Strona pokazująca informacje o IP, gdy klikniemy w link 'Kto to?' na stronie viewonline.php (Kto przegląda forum).
- viewtopic_body.html - Odpowiada za wyświetlanie budowę strony wątku, formę wyświetlanych postów.
- viewtopic_print.html - Plik wyświetlający podgląd wydruku konkretnego wątku.
Pliki HTML o różnych funkcjach. prosilver:
- drafts.html - Po wciśnięciu przycisku 'Wczytaj' na stronie pisania, wyświetla wszystkie zapisane szkice.
- forum_fn.js - Plik kontrolujący funkcje forum, takie jak pop-upy, listy wyboru.
- posting_editor.html - Plik ma za zadanie wyświetlanie głównego edytora postów.
- posting_layout.html - Strona pisania, zawiera edytor postów, uśmieszki, zakładki i ankiety.
- posting_pm_layout.html - Spełnia funkcję podobną do posting_layout.html, z tym, że dla strony pisania prywatnych wiadomości.
- styleswitcher.js - Plik JavaScript zapisujący w ciasteczkach użytkownika informacje o wykorzystywanym stylu CSS, np. podczas zmiany czcionki przyciskiem 'A'.
- ucp_avatar_options.html - Ustawienia awatara użytkownika. Jest on importowany do 'ucp_porfile_avatar.html' i wyświetla tylko jego ustawienia.
Pliki HTML o różnych funkcjach. subsilver2:
- breadcrumbs.html - Pasek nawigacji, wyświetla ścieżkę do działu / wątku oraz ustawioną strefę czasową.
- mcp_jumpbox.html - Lista wyboru akcji moderacyjnych.
- memberlist_group.html - Strona wyświetlająca informacje o konkretnej grupie, takie jak opis, liderzy czy członkowie. Aby ją zobaczyć kliknij na nazwę grupy w legendzie.
- pagination.html - Plik odpowiedzialny za numerowanie, przeskakiwanie między stronami wątków, postów, gdy jest ich więcej niż jedna strona.
- posting_progress_bar.html - Pasek ładowania podczas wgrywania załącznika.
- searchbox.html - W pliku zbudowany jest wygląd wyszukiwarki, wyświetlanej w działach i wątkach.