Sidebar Plus — phpBB3 extension

[romaamor]

Sidebar Plus — phpBB3 extension
Sidebar Plus — расширение для phpBB, добавляющее на форум настраиваемые боковые панели (сайдбары) с поддержкой виджетов, социальных иконок, кастомного контента и гибкой настройки через ACP.
Версия: 1.1.0
Sidebar Plus (roma30/sidebarplus)

Sidebar Plus — мощное расширение для phpBB, добавляющее на форум настраиваемые боковые панели, горизонтальные блоки и гибкую систему управления контентом через административную панель.



Описание

Sidebar Plus предоставляет комплексное решение для добавления дополнительного контента на phpBB форум. Расширение включает в себя боковые сайдбары, горизонтальные блоки в заголовке и футере, а также специальные блоки на страницах тем. Все элементы полностью настраиваются через ACP и автоматически адаптируются под мобильные устройства.

Основные возможности

Боковые сайдбары
- **Левый и правый сайдбары** - независимая настройка каждого сайдбара
- **Настраиваемые размеры** - ширина и высота для каждого сайдбара
- **Пользовательский контент** - HTML/JS контент с поддержкой BBCode
- **Гибкие настройки отображения** - только на главной странице или глобально
- **Автоматическое скрытие на мобильных** - боковые панели не отображаются на мобильных устройствах

Header Blocks (блоки в заголовке)
- **Три позиции размещения**:
- После заголовка (`after_header`)
- После навигации (`after_navbar`)
- Перед контентом (`before_content`)
- **Полная настройка стилей** - фон, границы, радиус, отступы, тени
- **Поддержка BBCode** - в контенте блоков
- **Адаптивность на мобильных** - блоки остаются видимыми и адаптируются под мобильные экраны

Footer Blocks (блоки в футере)
- **Четыре позиции размещения**:
- Над футером (`above_footer`)
- После футера (`after_footer`)
- После навигации футера (`after_footer_navbar`)
- Под футером (`below_footer`)
- **Полная настройка стилей** - аналогично header blocks
- **Поддержка BBCode** - в контенте блоков
- **Адаптивность на мобильных** - блоки остаются видимыми

Topic Blocks (блоки в темах)
- **Четыре позиции размещения**:
- После первого сообщения (`after_first_post`)
- После не первого сообщения (`after_not_first_post`)
- Перед быстрым ответом (`before_quickreply`)
- После быстрого ответа (`after_quickreply`)
- **Полная настройка стилей** - аналогично другим блокам
- **Поддержка BBCode** - в контенте блоков
- **Адаптивность на мобильных** - блоки адаптируются под мобильные экраны

Виджеты и контент
- **Поиск** - быстрый поиск по форуму
- **Профиль пользователя** - информация о текущем пользователе
- **Социальные иконки** - 20+ популярных социальных сетей:
- Behance, Discord, Dribbble, Etsy, Facebook, GitHub
- Google+, Instagram, PayPal, Pinterest, Reddit
- Slack, Snapchat, SoundCloud, Steam, Tumblr
- Twitch, Twitter, Vimeo, YouTube
- **Пользовательский контент** - любой HTML/JS контент

Система скрытия
- **Скрытие для групп** - выборочное скрытие для определенных групп пользователей
- **Скрытие для форумов** - скрытие на определенных форумах (по ID)
- **Скрытие для тем** - скрытие в определенных темах (по ID)
- **Скрытие для страниц** - скрытие на определенных страницах (по частям URL)
- **Сворачивание** - возможность сворачивания сайдбаров

Стилизация
- **Настраиваемые цвета** - фон, границы, текст для всех элементов
- **Тени** - настраиваемые тени (X, Y, размытие, распространение, цвет)
- **Радиусы** - скругление углов
- **Отступы** - внутренние и внешние отступы
- **Фиксированное позиционирование** - прилипание к верху страницы при прокрутке
- **Верхний отступ** - настраиваемый отступ сверху для сайдбаров

Требования

- **phpBB**: 3.2.0 или выше
- **PHP**: 7.1.3 или выше
- **Поддерживаемые стили**: prosilver и совместимые

Установка
1. Скачайте расширение
2. Скопируйте папку `roma30/sidebarplus` в папку `ext/` вашего форума
3. Перейдите в **ACP** → **Расширения**
4. Найдите "Sidebar Plus" и нажмите **"Включить"**
5. Подтвердите установку
```

Настройка
Основные настройки сайдбаров
1. Перейдите в **ACP** → **Общие** → **Сайдбары**
2. Настройте основные параметры:
- Включение левого/правого сайдбара
- Размеры сайдбаров (ширина, высота)
- Пользовательский контент (HTML/JS)
- Социальные иконки
- Стили (фон, границы, тени)
- **Фиксированное позиционирование** - сайдбары остаются на месте при прокрутке
- **Верхний отступ** - настраиваемый отступ сверху для сайдбаров (в пикселях)
- **Локация отображения** - только на главной странице или глобально
- **Виджеты** - поиск и профиль пользователя

Header Blocks (блоки в заголовке)
1. В разделе "Header Blocks":
- Включите блоки под заголовком
- Выберите позицию размещения
- Добавьте контент (поддерживается BBCode)
- Настройте стили (фон, границы, тени и т.д.)

Footer Blocks (блоки в футере)
1. В разделе "Footer Blocks":
- Включите блоки в футере
- Выберите позицию размещения
- Добавьте контент (поддерживается BBCode)
- Настройте стили

Topic Blocks (блоки в темах)
1. В разделе "Topic Blocks":
- Включите блоки в темах
- Выберите позицию размещения
- Добавьте контент (поддерживается BBCode)
- Настройте стили

Настройки отображения
1. **Скрытие для групп**:
Выберите группы пользователей в списке групп для которых надо скрыть все блоки.
2. **Скрытие для форумов**: Введите ID форумов через запятую
- Пример: `5, 10, 15`
3. **Скрытие для тем**: Введите ID тем через запятую
- Пример: `1703, 2500, 3000`
4. **Скрытие для страниц**: Введите части URL через запятую
- Пример: `start=20, mode=view, t=1703&start=20`

Мобильная адаптация

Боковые сайдбары
- **Автоматически скрываются** на мобильных устройствах
- **Двухуровневая система**:
1. **PHP-проверка** - определение мобильного устройства по User-Agent
2. **CSS-медиазапросы** - дополнительное скрытие через CSS для экранов < 767px

Горизонтальные блоки
- **Header Blocks** - остаются видимыми и адаптируются
- **Footer Blocks** - остаются видимыми и адаптируются
- **Topic Blocks** - остаются видимыми и адаптируются

Поддерживаемые мобильные устройства
- iPhone, iPad, iPod
- Android устройства
- BlackBerry
- Windows Phone
- Opera Mini
- Другие мобильные браузеры

Примеры использования

Header Blocks

<!-- Пример контента для header blocks -->

Код: Выделить всё

<div style="text-align: center;">
    <h3>Добро пожаловать на наш форум!</h3>
    <p>Здесь вы можете найти полезную информацию и пообщаться с единомышленниками.</p>
    <a href="viewforum.php?f=5" class="button">Перейти к обсуждениям</a>
</div>

Footer Blocks

<!-- Пример контента для footer blocks -->

Код: Выделить всё

<div style="text-align: center;">
    <p><strong>Полезные ссылки:</strong></p>
    <a href="viewforum.php?f=10">Правила форума</a> | 
    <a href="viewforum.php?f=15">FAQ</a> | 
    <a href="viewforum.php?f=20">Контакты</a>
</div>

Topic Blocks

Код: Выделить всё

<!-- Пример контента для topic blocks -->
<div style="background: #f8f9fa; padding: 10px; border-radius: 5px;">
    <p><strong>💡 Полезный совет:</strong></p>
    <p>Используйте поиск по форуму, чтобы быстро найти нужную информацию!</p>
</div>

Скрытие для страниц
Скрыть на второй странице любой темы
start=20

Скрыть в режиме просмотра
mode=view

Скрыть на второй странице конкретной темы
t=1703&start=20

Скрыть в конкретном форуме
f=5

Фиксированные сайдбары

**Настройки в ACP:**
- **Фиксированные сайдбары** - включить прилипание к верху
- **Верхний отступ** - установить отступ в пикселях (например, 60px)
- **Стили** - настроить фон, границы, тени для лучшего отображения

Технические детали

Структура файлов
```
sidebarplus/
├── acp/ # ACP модули
├── adm/ # ACP шаблоны
├── event/ # Event listeners
├── header_blocks/ # Менеджер header blocks
├── footer_blocks/ # Менеджер footer blocks
├── language/ # Языковые файлы
├── migrations/ # Миграции БД
├── styles/ # Шаблоны и CSS
└── composer.json # Конфигурация расширения
```

Миграции
- `install_acp_module.php` - основная установка
- `m2_footer_blocks_schema.php` - добавление footer blocks
- `m3_topic_blocks_schema.php` - добавление topic blocks

Event файлы
- `overall_header_*.html` - позиции для header blocks
- `overall_footer_*.html` - позиции для footer blocks
- `viewtopic_*.html` - позиции для topic blocks

Удаление

1. Перейдите в **ACP** → **Расширения**
2. Найдите "Sidebar Plus" и нажмите **"Отключить"**
3. Подтвердите отключение
4. Удалить данные
5. Удалите папку `roma30/sidebarplus` из папки `ext/`


Обновление

1. Сделайте резервную копию настроек
2. Отключите расширение
3. Замените файлы новой версией
4. Включите расширение
5. Проверьте настройки

Устранение неполадок

Блоки не отображаются
1. Проверьте настройки в ACP
2. Очистите кэш phpBB
3. Проверьте права доступа к файлам

Стили не применяются
1. Очистите кэш браузера
2. Проверьте CSS файлы
3. Убедитесь, что стиль форума поддерживается

Проблемы на мобильных
1. Проверьте User-Agent
2. Убедитесь, что CSS медиазапросы работают
3. Проверьте адаптивность блоков

Поддержка

- **Автор**: roma30
- **Версия**: 1.0.2
- **Лицензия**: GPL-2.0
- **Совместимость**: phpBB 3.2.0+

Changelog

Версия 1.0.2
- Добавлены Topic Blocks (блоки в темах)
- Улучшены описания полей в ACP
- Исправлены неточности в описаниях
- Добавлены 4 позиции для topic blocks
- Полная настройка стилей для topic blocks

Версия 1.0.1
- Добавлены Footer Blocks (блоки в футере)
- Добавлены 3 позиции для footer blocks
- Полная настройка стилей для footer blocks

Версия 1.0.0
- Базовая функциональность сайдбаров
- Header Blocks (блоки в заголовке)
- Система скрытия блоков
- Мобильная адаптация
- Полная настройка через ACP

Демо - https://pikniktv.info/

roma30.zip

[Leo Angel]

А можно скрин как это выглядит на смартфоне?
У меня проблема (да, наверное, и у всех она есть), что основная масса посетителей сейчас уже сидят со смартфонов. И приходится всё проверять на предмет как это смотрится на них и править, если что-то не так...

[romaamor]

А можно скрин как это выглядит на смартфоне?

На смартфонах боковых блоков нет. Они для них отключаются.

[romaamor]

Обновил расширение до версии 1.0.2
Читайте первый пост темы.

[romaamor]

Расширение обновленно.
Исправленны проблемы с миграцией. Исправленна функция фиксации боковых блоков.

[romaamor]

Обновил расширение. Что нового в версии 1.1.0

- Глобальная фильтрация блоков по странам** — теперь можно показывать или скрывать все блоки (header, footer, topic) для выбранных стран (INCLUDE/EXCLUDE) через единый список в ACP.
- Современный и адаптивный дизайн страницы настроек** — настройки расширения в ACP получили светлый, яркий и адаптивный стиль, удобный на ПК и мобильных.