Установка
Установить тему очень просто.
- Удостоверьтесь, что у Вас есть папка
/my-templates/в корневой директории bbPress. - Загрузите тему на Ваш сервер как поддиректорию в директории
/my-templates/. - И это все!
Активировать тему еще проще. Просто выберите ее в административной панели bbPress, в меню "Дизайн".
Дизайн
Тема состоит из трех вещей:
- Стилей (
style.css). - Скриншота размером 300×225 пикселей (
screenshot.png). - Нескольких файлов-шаблонов.
Стили
Реально тема нуждаяется только в одном файле: style.css со описанием стилей. Вначале этого файла Вы должны поместить следующую информацию, чтобы bbPress распознал тему.
/*
Theme Name: Название Вашей темы.
Theme URI: url Вашей темы. Это может быть запись в Вашем блоге.
Description: Приведите здесь описание вашей темы. Например Вы можете написать что-то типа этого “Голубое и зеленое в двухколоночном формате”.
Version: Нумеруйте Ваши релизы. Используйте, пожалуйста, только цифры и точку.
Author: Автор оригинальной темы,
Author URI: и его url.
Ported By: Имя человека, адаптировавшего тему для bbPress (если это так),
Porter URI: и его url.
*/
Скриншот
Вы должны включить скриншот размером 300×225 пикселей (screenshot.png) для того, чтобы Вашу тему можно было увидеть и выбрать из административной панели.
Файлы темы
В дополнение к таблице стилей bbPress будет искать следующие файлы в Вашей теме. Если он не находит какой-то файл, в котором он нуждается, он использует аналогичный файл из заданной по умолчанию темы bbPres, Kakumei.
- front-page.php
- Используется для главной страницы Вашего форума.
- forum.php
- Просмотр форума.
- edit-post.php
- Редактирование сообщения.
- edit-form.php
- Вызывается
edit_form(). - favorites.php
- Просмотр закладок.
- header.php
- Вызывается
bb_get_header(). - footer.php
- Вызывается
bb_get_footer(). - login.php
- Страница входа в систему ( /bb-login.php).
- login-form.php
- Вызывается login_form() в случае, если пользователь не вошел в систему.
- logged-in.php
- Вызывается login_form() в случае, если пользователь вошел в систему.
- password-reset.php
- Страница сброса пароля.
- post-form.php
- Вызывается post_form().
- post.php
- Вызывается bb_post_template()
- profile.php
- Просмотр профиля пользователя.
- profile-edit.php
- Редактирование профиля пользователя.
- profile-base.php
- Просмотр страницы, добавленной плагином к профилю пользователя.
- register.php
- Страница регистрации пользователя.
- register-success.php
- Страница успешной регистрации пользователя.
- search.php
- Страница поиска.
- search-form.php
- Вызывается search_form().
- stats.php
- Статистика форума.
- topic.php
- Просмотр темы.
- topic-tags.php
- Вызывается topic_tags().
- tag-form.php
- Вызывается tags_form().
- topic-tags.php
- Вызывается topic_tags().
- tags.php
- Страница тэгов.
- tag-single.php
- Просмотр одного тэга.
- view.php
- Просмотр вошедшим в систему пользователем таких страниц как ‘Темы без ответов’.
Гмм. Это много. Но помните, Ваша тема не должна включать все из них: вместо файлов которые Вы не включите, bbPress будет использовать заданные по умолчанию файлы Kakumei.
Примечания
И, в заключение, несколько вещей, которые должен иметь ввиду разработчик темы.
- bbPress имеет некоторые предопределенные функции для добавления CSS-классов для различных элементов. Посмотрите как темы по умолчанию используют функции
alt_class(),post_del_class()иtopic_class(). - Скрипты AJAX, используемые на страницах темы, немного зависят от разметки темы и требуют javascript, включенного в файл заголовка темы по умолчанию.
- Список (или таблица) должен иметь id
thread. - Каждое сообщение должно быть включено в элемент с id
post-{$post_id}. - Форма отправки сообщений должена иметь id
postform, а ее кнопка - idpostformsub. - Список меток для текущего пользователя должна иметь id
yourtaglist, а для всех остальных пользователей - idotherstaglist. - Каждая метка должна быть включена в элемент с id
tag-{$tag_id}_{$user_id}. - Форма меток должна иметь id
tagform, а ее кнопка - idtagformsub. - Мета-информация о теме должна быть включена в элемент с id
topicmeta, а элемент, включающий в себя ссылку на закладки должен иметь idfavorites-toggle.
Все эти ограничения являются немного раздражающими. Мы надеемся, что разметка темы по умолчанию Kakumei сделана достаточно гибкой, и Вы сможете сделать большую часть Ваших настроек через CSS.
- Список (или таблица) должен иметь id