Общее описание файлов стиля phpBB3

Введение.
По умолчанию в phpBB3 включены два стиля: prosilver и subsilver2. Каждый из этих стилей имеет различный дизайн и структуру кода.
  • prosilver - пример стиля блочной вёрстки. Стиль разработан с широким применением блочных тегов <DIV>, <UL>, <DL> и почти полностью зависит от CSS.
  • Файлы CSS - Cascading Style Sheets(CSS) - каскадные таблицы стилей. Таблицы стилей - попытка отделить детали дизайна странички от ее структуры и содержания. В классическом HTML структура и дизайн были вперемешку: рядом с текстовым абзацем его цвет, размер шрифта, тип шрифта и т.п. Если вы захотите изменить такой простой параметр, как размер шрифта на своем сайте - придется переписывать все странички. CSS позволяет назначить всем объектам стиль, описание которого может храниться вообще в отдельном файле. Используя CSS, вы можете изменить размер шрифта во всех страницах сайта, исправив только один файл с описанием стилей. Самое главное, что не придется менять уже готовые HTML документы, лежащие на сервере. Браузер пользователя сам обратится к файлу (по ссылке) со стилями и придаст страничке нужный облик.
  • subsilver2 - пример стиля табличной вёрстки (подобно стилю subsilver в phpBB2). Основные теги структуры <table>, <tr>, <td> . Для определения цветов и фонов используется CSS.
Всё многообразие стилей для phpBB3 можно условно разделить на два вида: блочные (prosilver) и табличные (subsilver2). Расположение и названия файлов этих двух видов немного отличаются, что отметим отдельно ниже.

STYLES
Стили, используемые в phpBB3, расположены в папке styles/. Каждый стиль в своей папке, имя которой совпадает с именем стиля. Это важно! Поэтому не переименовывайте папки стиля, если точно не знаете, что делаете.

В каждой папке со стилем находится файл style.cfg, с информацией о стиле (название стиля, автор, версия), и три папки:
  • /imageset/ — содержит рисунки, используемые в стиле, в том числе вложенные папки языко-зависимых рисунков (как правило, кнопок), а также файл imageset.cfg, который содержит схему использования файлов-рисунков в стиле.
  • /template/ — содержит шаблоны стиля, основные файлы HTML, которые отвечают за общую структуру страниц, и файл template.cfg, с информацией о наборе шаблонов.
  • /theme/ — содержит файлы CSS, которые определяют отображение различных объектов, цвет, фон, стиль ссылок и так далее, вложенную папку /theme/images/ с графическими элементами для данного стиля и файл theme.cfg, с информацией о теме оформления.
STYLES/IMAGESET
Содержимое папки styles/imageset/ в особых комментириях не нуждается. Всё интуитивно понятно, к тому же названия файлов, как правило, кратко отображают назначение изображения (например, forum_unread_subforum.gif - иконка форума, содержащего непрочитанные сообщения, имеющего подфорум).

STYLES/THEME
В папка styles/theme/ расположены файлы CSS. Для табличных стилей это, как правило, один файл stylesheet.css, содержащий описание всех классов, используемых в стиле.
Для блочных стилей, широко использующих CSS, код разделен на несколько файлов для удобства, а файл stylesheet.css используется для сборки всего кода CSS при помощи конструкции @import url("filename.css"); .

Это следующие файлы:
Название файлаОписание назначения файла
bidi.cssотвечает за настройку RTL (текст справа налево), для некоторых языков, например арабского или еврейского.
buttons.cssотвечает за отображение кнопок форума (Новая тема, Ответить и так далее).
colours.cssотвечает за цвета форума, текста, фона и так далее.
common.cssотвечает за стиль общих элементов, таких как верхний и нижний колонтитул, главная страница и так далее.
content.cssотвечает за стиль внутреннего содержимого страниц (viewforum_body.html, viewtopic_body.html и так далее).
cp.cssотвечает за стиль личного и модераторского разделов, вкладок, страниц личных сообщений и так далее.
forms.cssстилизация различных форм (форма входа, страница размещения ответа, текстовые области и так далее).
large.cssувеличивает размер текста при нажатии на кнопку «A».
links.cssстилизация ссылок, эффекты при наведении мыши и так далее (цвета берутся из файла colours.css, а links.css используется для форматирования, изменения размеров текста, стилизации и так далее).
medium.cssотображает средний размер текста при нажатии на кнопку «A».
normal.cssотображает обычный размер текста при нажатии на кнопку «A».
print.cssотвечает за форматирование содержимого при выводе на печать (при нажатии кнопки «Версия для печати»).
tweaks.cssкорректировки для некоторых браузеров, таких, как IE.
Вы можете подключать свои собственные файлы CSS, добавив строки @import url("filename.css"); в файл stylesheet.css. Это весьма удобно при написании МОДов. Только нужно помнить, что при случайном использовании одинаковых названий для классов конечным определением для класса будет то, которое будет загружено последним.

STYLES/TEMPLATE
Страницы, генерируемые phpBB3, те, что вы видите на экране, по структуре можно разделить на три основные части: заголовок ("шапка" или верхний колонтитул, _header), основное содержимое (_body) и подвал (нижний колонтитул, _footer). При этом некоторые элементы структуры (html-теги), начинающиеся (открывающиеся) в заголовке (, ), заканчиваются (закрываются) в подвале (, ).
Пример структуры индексной страницы стиля subsilver2.

Изображение

Файл overall_header.html формирует заголовок, файл overall_footer.html — подвал. Всё остальное содержимое страниц (например, index.php, viewforum.php, viewtopic.php и так далее) определяется другими файлами шаблонов (index_body.html, viewforum_body.html, viewtopic_body.html), в которых верхнее и нижнее содержимое берётся с файлов overall_header.html и overall_footer.html.

Различные страницы всплывающих окон, списков и обзоров используют файлы simple_header.html и simple_footer.html. Для некоторых страниц в личном и модераторском разделе используются дополнительные заголовки (ucp_header.html, mcp_header.html, ucp_pm_message_header.html) и подвалы (ucp_footer.html, mcp_footer.html, ucp_pm_message_footer.html).
В отличие от phpBB2 в phpBB3 вызов заголовка и подвала производится непосредственно из шаблонов страниц, а не формируется в файлах PHP, поэтому вы можете указать другие файлы для использования в качестве колонтитулов, или создать свои собственные. Подробнее об этом в статье Руководство по синтаксису шаблонов.

Файлы шаблонов:
голубым цветом обозначены файлы шаблоны, использующиеся только в стиле prosilver,
серым цветом - файлы шаблонов, используемые только в стиле subsilver2 ).


Название файлаОписание назначения файла
attachment.htmlэтот файл отображает вложения в постах и в личных сообщениях.
breadcrumbs.htmlстраница, отображающая полосу навигации по конференции и настройки времени (subsilver2).
bbcode.htmlфайл кнопок BBCode, содержит кнопки и их расположение.
confirm_body.htmlстраница подтверждения. Эта страница появляется при подтверждении чего-нибудь (например, при удалении темы).
custom_profile_fields.htmlстраница дополнительных (созданных) полей в профиле. Появляется при редактировании профиля.
drafts.htmlстраница, отображающая загруженный черновик. Во время размещения нажмите кнопку «Загрузить», чтобы увидеть эту страницу (prosilver).
editor.jsфайл JavaScript, используемый при написании тем, ответов, личных сообщений для применения объектов встроенного редактора.
faq_body.htmlстраница FAQ (часто задаваемых вопросов).
forum_fn.jsфайл с функциями JavaScript конференции (управление всплывающими окнами, выпадающий список перехода к форумам и так далее) (prosilver).
forumlist_body.htmlфайл списка категории и форумов.
index_body.htmlфайл содержимого главной страницы.
jumpbox.html>выпадающий список для перехода в форумы конференции.
login_body.htmlстраница входа, используемая при входе на конференцию, или при подтверждении пароля во время входа в панель администрирования.
login_forum.htmlстраница входа в форумы, защищённые паролем.
mcp_approve.htmlстраница одобрения тем и сообщений. Если имеются отложенные темы и сообщения, то этот файл отвечает за их отображение.
mcp_ban.htmlстраница блокировок, отображаемая, если модератор имеет права для блокировки пользователей.
mcp_footer.htmlдополнительный подвал модераторского раздела. Содержит разбивку на страницы, темы, сообщения и так далее.
mcp_forum.htmlстраница модерации форума в модераторском разделе.
mcp_front.htmlглавная страница модераторского раздела. Содержит списки последних действий, таких, как пять последних жалоб, пять последних записей журнала и так далее.
mcp_header.htmlдополнительный заголовок модераторского раздела. Содержит вкладки и блоки, название модерируемого объекта и так далее.
mcp_jumpbox.htmlвыпадающий список для модератора (в актуальной версии этот файл больше не используется) (subsilver2).
mcp_logs.htmlстраница журнала модераторов, на которой модератор может просматривать действия других модераторов и свои собственные.
mcp_message.htmlсообщение, которое появляется после выполнения какого-либо действия модератором. Например, при изменении типа темы.
mcp_move.htmlстраница перемещения темы, с помощью которой можно выбрать форум для перемещения темы.
mcp_notes_front.htmlглавная страница заметок о пользователях. С помощью этой страницы выбирается пользователь, заметки о котором вы хотите просмотреть.
mcp_notes_user.htmlстраница отображения заметок о пользователе. Здесь вы можете читать заметки о пользователе и записывать новые.
mcp_post.htmlстраница редактирования сообщений в модераторском разделе. На этой странице отображаются опции для редактирования сообщения, изменения автора сообщения и так далее.
mcp_queue.htmlстраница, отображающая отложенные темы и сообщения в модераторском разделе.
mcp_reports.htmlстраница жалоб на сообщения, отображаемая в модераторском разделе.
mcp_topic.htmlстраница модерирования тем в модераторском разделе.
mcp_viewlogs.htmlстраница, отображающая журналы выбранных тем.
mcp_warn_front.htmlглавная страница с предупреждениями. Здесь можно увидеть пользователей с наибольшим числом предупреждений, последние пять предупреждений, а также можно выбрать пользователя и выдать ему предупреждение.
mcp_warn_list.htmlСтраница, отображающая список всех предупреждённых пользователей.
mcp_warn_post.htmlстраница выдачи предупреждения пользователю, отображаемая при щелчке на кнопку «Выдать предупреждение», находящуюся возле сообщения.
mcp_warn_user.htmlстраница выдачи предупреждения пользователю, отображаемая при поиске пользователя на главной странице предупреждений, или при щелчке по соответствующей кнопке в его профиле.
mcp_whois.htmlстраница, отображающая сведения об IP-адресах.
memberlist_body.htmlстраница со списком пользователей конференции.
memberlist_email.htmlстраница для отправки пользователю электронного сообщения.
memberlist_group.htmlстраница для отображения информации о группах (subsilver2).
memberlist_im.htmlстраница для отправки пользователю мгновенного сообщения.
memberlist_leaders.htmlстраница, отображающая администраторов и модераторов конференции. Для просмотра этой страницы нажмите ссылку «Команда сайта».
memberlist_search.htmlстраница поиска пользователей, проявляющая при переходе по ссылке «Найти пользователя».
memberlist_view.htmlстраница для отображения профиля пользователя.
message_body.htmlстраница сообщения. Отображается при выполнении некоторых действий с темами. Например, при размещении сообщения.
overall_footer.htmlобщий подвал.
overall_header.htmlобщий заголовок.
pagination.htmlфайл, отображающий меню перехода на страницы для форумов, тем, списков (subsilver2).
posting_attach_body.htmlформа для прикрепления файла к сообщению. Отображается на странице размещения сообщений.
posting_body.htmlстраница размещения сообщений. Используется для написания текстов сообщений, личных сообщений и так далее.
posting_buttons.htmlстраница, предназначенная для отображения кнопок BBCode на странице размещения сообщений.
posting_editor.htmlглавная страница для размещения сообщений в стиле prosilver.
posting_layout.htmlокно размещения сообщений, содержащее редактор, смайлики, добавление опроса, вложений и так далее (prosilver).
posting_pm_layout.htmlто же самое, что и posting_layout.html, но для личных сообщений (prosilver).
posting_poll_body.htmlэта страница отображается при добавлении опроса к сообщению.
posting_preview.htmlстраница предварительного просмотра темы или сообщения, появляющаяся при нажатии кнопки «Просмотр» во время написания сообщения.
posting_progress_bar.htmlстраница, отображаемая при процессе загрузки вложения (subsilver2).
posting_review.htmlэта страница появляется в момент размещения сообщения в тему, в которой кто-то разместил сообщение в то время, пока вы писали ответ.
posting_smilies.htmlокно со смайликами, отображаемое при написании сообщений.
posting_topic_review.htmlСтраница обзора темы, отображающаяся во время размещения ответа.
search_body.htmlстраница расширенного поиска.
search_results.htmlстраница, отображающая результаты поиска.
searchbox.htmlпоисковое поле в форумах, темах и так далее (subsilver2).
simple_footer.htmlупрощенный подвал для всплывающих окон, списков и так далее.
simple_header.htmlупрощенный заголовок для всплывающих окон, списков и так далее.
styleswitcher.jsфайл JavaScript, содержащий функции пользовательских cookies, изменения шрифта, параметры таблиц стилей и так далее (prosilver).
template.cfgфайл, содержащий сведения о наборе шаблонов.
ucp_agreement.htmlстраница соглашения с условиями регистрации.
ucp_attachments.htmlстраница, отображающая вложения пользователей.
ucp_avatar_options.htmlпараметры аватары пользователя. Этот файл также подключается в файле ucp_profile_avatar.html.( prosilver)
ucp_footer.htmlдополнительный подвал личного раздела.
ucp_groups_manage.htmlстраница управления группами. Если вы являетесь руководителем группы, то с помощью этой страницы можете управлять участниками группы.
ucp_groups_membership.htmlстраница, отображающая участников группы.
ucp_header.htmlдополнительный заголовок личного раздела.
ucp_main_bookmarks.htmlстраница, отображающая закладки пользователя.
ucp_main_drafts.htmlстраница, отображающая черновики пользователя.
ucp_main_front.htmlглавная страница личного раздела.
ucp_main_subscribed.htmlстраница, отображающая подписки пользователя.
ucp_pm_history.htmlстраница истории личных сообщений, отображающая ваши сообщения и ответы другого пользователя.
ucp_pm_message_footer.htmlдополнительный подвал для личных сообщений, отображаемый при просмотре сообщения.
ucp_pm_message_header.htmlдополнительный заголовок для личных сообщений, отображаемый при просмотре сообщения.
ucp_pm_options.htmlстраница, отображаемая во время настройки правил для личных сообщений.
ucp_pm_popup.htmlвсплывающее окно, уведомляющее пользователя о поступлении новых личных сообщений.
ucp_pm_viewfolder.htmlстраница папок для сообщений, отображающая сообщения в папках «Входящие», «Исходящие», «Отправленные» и так далее.
ucp_pm_viewmessage.htmlстраница для отображения личных сообщений.
ucp_pm_viewmessage_print.htmlстраница, используемая для отображения личных сообщений в версии для печати.
ucp_prefs_personal.htmlстраница общих настроек, отображаемая в личном разделе.
ucp_prefs_post.htmlстраница настроек размещения сообщений, отображаемая в личном разделе.
ucp_prefs_view.htmlстраница настроек отображения сообщений, отображаемая в личном разделе.
ucp_profile_avatar.htmlстраница настроек аватары, отображаемая в личном разделе.
ucp_profile_profile_info.htmlстраница личных данных, отображаемая в личном разделе.
ucp_profile_reg_details.htmlстраница регистрационных данных, отображаемая в личном разделе.
ucp_profile_signature.htmlстраница для создания и изменения подписи, отображаемая в личном разделе.
ucp_register.htmlстраница, отображаемая при регистрации пользователей.
ucp_remind.htmlстраница восстановления забытого пароля.
ucp_resend.htmlстраница отправки повторного кода активации.
ucp_zebra_foes.htmlстраница, отображающая ваших недругов.
ucp_zebra_friends.htmlстраница, отображающая ваших друзей.
viewforum_body.htmlстраница списка тем форума.
viewonline_body.htmlстраница «Кто сейчас на конференции».
viewonline_whois.htmlстраница, отображающая сведения об IP-адресах при щелчке по ссылке «Информация об IP-адресе» на странице viewonline.php.
viewtopic_body.htmlстраница, служащая для отображения сообщений темы.
viewtopic_print.htmlстраница, отображающая тему в версии для печати.
Источник phpbbguru.net