PunBB/PanBB для чайников. Практика.

Перепаковка архива с форумом, первичная локализация. (требуется только для официальной версии форума)

Определившись с базовым URL, мы должны подготовить скачанный форум к установке на сервер. Дело в том, что официальный PunBB 1.4.4 поставляется в таком архиве, что с разгону установить его на сервер получится только в подкаталог (см выше).

В архиве лежит папка punbb-1.4.4

а уже в ней - файлы форума

Т.е. если мы распакуем этот архив в корень сайта (выше некуда!), сам форум, его файлы, его корень  окажется в подкаталоге корень_сайта/punbb-1.4.4. Да, можно переименовать эту папку, например, в /forum, но в сам корень сайта такой архив и не распаковать.

Поэтому, первым делом распакуем его у себя на домашнем компьютере, зайдём в эту самую папку punbb-1.4.4.
Раз мы уже здесь, сразу позаботимся о локализации форума - хотябы первичной.

Зайдите в папку /lang. Видите? Форум готов говорить с нами только по-английски. Для того, чтобы добавить желаемых языков, обратимся в соседний подфорум, и найдём там требуемые локали.

В архиве локали находится папка с языковыми файлами. Имя папки обязательно пишется латиницей, с большой буквы. Из скачанных архивов вынимаем эти папки, и помещаем в каталог /lang форума - рядом с English.

Теперь выбор этих языков будет возможен с самого первого шага установки. Подробнее разбираться с локализацией будем позже.

Вернёмся к подготовке архива для закачки на сервер.
Зайдём в корень распакованной папки punbb-1.4.4, выделим все его файлы (внутри!) и создадим из них архив:

Формат архива следует выбирать *.zip - его точно сможет распаковать файловый менежджер  любого  сервера!

"Чистый" движок и сборки PanBB в этих телодвижениях не нуждаются!

Вот теперь, когда файлы форума в архиве лежат россыпью, а не в папке, его можно распаковать на сервере в корень сайта, и базовый URL совпадёт с адресом сайта. А можно создать там, на сервере, папку  /forum, и распаковать в неё, если Вы решили установить форум таким образом.

Установка официального PunBB 1.4.4 с БД MySQL.

Следует понимать, что форум, установленный разными способами, работает совершенно одинаково!

Условимся считать, что мы перепаковали архив, как сказано выше, заодно добавив локали. Если нет – делаем в уме соответствующие поправки.

Прежде всего, нужно создать БД MySQL, с которой будет работать форум. Некоторые хостинг - провайдеры предоставляют простейший удобный инструмент для этого: несколько полей с именем будущей базы, и логином – паролем пользователя. 

Почти всегда можно воспользоваться (как на локальном сервере, так и у провайдера) инструментом PHPMyAdmin, а при отсутствии специальных инструментов,  MySQL управляется из его консоли.

В любом случае, нужно создать БД, назвать её, придумать логин и пароль для пользователя.

Вот, как это выглядит в PHPMyAdmin:

Изначально в моём MySQL установлен  администратор root  с паролем k, ему по умолчанию и принадлежит созданная БД.

Теперь можно приступить собственно,  к установке форума.

Распаковываем архив, куда нацелились – например, в корень сайта. Или создаём в корне сайта каталог /forum, и распаковываем файлы туда. Всё зависит от нашего решения насчёт базового URL, о чём подробно рассказывалось выше.

Открываем браузер, вводим адрес форума. Т.к. он пока не установлен, видим сообщение:

Нам предлагается запустить установку, и любезно предоставляется ссылка, запускающая процесс.  Пройдём же по ней.

Вся установка занимает одну страницу, заполнив поля которой, останется нажать внизу кнопку. Большую часть этой страницы занимают пояснения.

Первое, что  видим – выбор языка установки.  Не зря ранее, при перепаковке архива, рекомендовалось сразу добавить локалей, помимо английской (если их не добавить, выбор языков не будет доступен).  Теперь, выбрав понятный язык, читаем все пояснения на нём.

Пока этот выбор языка относится лишь к этой самой странице установки. Языки форума выставляются позже отдельно.

Ниже находятся поля для подключения БД MySQL, которую мы создали ранее. Заполняем:

Далее следуют совершенно очевидные вопросы – данные администратора форума:

Ниже – важный момент, о котором говорилось выше – базовый URL форума.  Механизм установки сам пытается его определить. Как правило, он делает это правильно, но тем не менее, разработчики настаивают на проверке. Убедитесь, что в этом поле указан адрес, по которому Вы распаковали файлы форума, и по которому он впоследствии должен быть доступен из браузера.

Ещё ниже видим выбор языка форума по умолчанию. Этот язык (доступный из установленных ранее локалей) будут видеть незарегистрированные гости. Этот язык будет работать при регистрации, и он же будет включен у пользователей, если они не включат другой доступный у себя в профиле. В любой момент его можно переназначить.

Остаётся нажать кнопку «Start install» -  начать установку.

Через непродолжительное время появится сообщение об успехе, со ссылкой на главную страницу установленного форума.

Форум содержит тестовый раздел с тестовой темой и одним постом в ней.

Теперь можно войти, как администратор, воспользовавшись заданными ранее логином и паролем, и приступить к настройкам форума. А позже и приглашать пользователей к регистрации.

Отличия  установки форума («чистого» движка) PanBB.
Помимо исправлений ошибок и доббавления мелких удобств, в PanBB упрощена и сделана более удобной  установка.

Форум устанавливается точно так же, как описано выше для официального PunBB, за исключением того, что архив уже подготовлен для удобной распаковки на сервере, и в него уже включены пять наиболее востребованных языков: русский, немецкий, французский, английский и испанский. 

Эти действия для  PanBB не требуются - всё уже готово.

PanBB, как и PunBB, может работать с БД MySQL и $matches[2], и всё, описанное выше, относится к ним обоим в равной степени, если скачать для установки универсальный (MySQL и SQLite3) вариант:

This content is available only to registered users.

Установка этого варианта не отличается от официального PunBB. С MySQL  вот ссылка   с $matches[2]: вот ссылка

Скачав же вариант PanBB только для $matches[2], мы не увидим в установщике выбора типа БД, всё произойдёт «за кадром». Язык, выбираемый для установки, становится и языком форума по умолчанию. Естественно, впоследствии его можно изменить из админки:

This content is available only to registered users.

kisa, привет! Можно уже писать в тему? 

Предлагаю при установке убрать это приветственное окно

с точки зрения устанавливающего форум новичка может создаться впечатление что произошла какая то ошибка. Наверное лучше миновать эту страницу и перейти непосредственно к самой установке.

В файле essentials.php поменять

if (!defined('FORUM'))
   error('The file \'config.php\' doesn\'t exist or is corrupt.<br />Please run <a href="'.FORUM_ROOT.'admin/install.php">install.php</a> to install PunBB first.');

на

if (!defined('FORUM'))
{
   // Make an educated guess regarding base_url
   $base_url_guess = ((isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == 'on') ? 'https://' : 'http://').preg_replace('/:80$/', '', $_SERVER['HTTP_HOST']).str_replace('\\', '/', dirname($_SERVER['SCRIPT_NAME']));

   header("HTTP/1.1 301 Moved Permanently");
   header("Location: ".$base_url_guess.'/admin/install.php');
}

Сборка PanBB минимальная
Содержит минимальный набор расширений, обеспечивающий работу форума. Расширения больше относятся к скрытлому, но важному функционалу, чем к интерфейсу пользователя. Здесь отсутствуют смайлы, закачка картинок и т.д. Такой форум может послужить чем-то вроде корпоративного комуникатора и т.д.

Сборка содержит расширения:
        'pun_jquery' (библиотеки),
    'pan_framework', (библиотеки)
   
    'fancy_stop_spam', (защита от ботов)
    'db_tracktopics', (помечает прочитанные темы)
    'pan_external_links', (обрабатывает и маскирует внешние ссылки)
    'pan_msg_before_send', (отслеживает новые сообщения  в теме во время написания Вашего)
    'pun_bbcode', (панель кнопок  ВВ-кодов )   
        'pan_manage_extensions' (управление расширениями)

Также имеется закачанное, но не установленное расширение 'pan_smiles', которое легко можно подключить из админки.

This content is available only to registered users.

В установленном виде минимальная сборка выглядит так вот ссылка
Логин demo пароль demo

_______________________

Сбрка PanBB стандарт
Это уже форум, в котором можно вести каую-то форумную жизнь. К минимальному набору добавлены такие элементы интерфейса, как смайлы, закачка картинок и др.

ополнительно к минимальному варианту, сборка «Стандарт» включает в себя:
        'pan_smiles', (коллекция смайлов)
        'pan_nick_to_form', (обращение к пользователю в виде стрелки рядом с ником)
    'pan_uploader', (закачка картинок и файлов на форум)
    'pun_pm',(Личные сообщения)
    'pan_views_in_topic', (счётчик просмотров в теме)
    'pan_scrolling', (быстрая прокрутка страниц стрелками)
    'strikethrough', (зачёркнутый текст)
    'sva_spoiler',  (спойлер)
    'pun_move_posts', (возможность перемещения сообщений модератором)
        'pan_manage_extensions' (управление расширениями)

This content is available only to registered users.

____________________________

Сборка PanBB расширенная.
Здесь больше разного рода удобных "плюшек" как для пользователя, так и для администрирования.

Дополнительно к расширениям, использованным в более скромных сборках, здесь есть:

         'fancy_favorite_topic', (закладки)
    'fancy_video_tag', (вставка видео с youtube и д.)
    'pan_default_avatar', (аватар по умолчанию)
    'pan_next_previous', (стрелки следующей и предыдущей темы)
    'pan_resize_avatar', (автоматическая подгонка размера аватара под требования форума)
    'pan_statistic', (статистика форума)
    'pan_subscriptions', (управление подписками)
    'pun_poll', (блок голосования в теме)
    'pan_preview_image', (маленькие превью изображений)
    'fancy_box_for_pan_preview_image', (Открытие изображений в красивом оформлении $matches[2])
    'gender', (указание пола пользователя в профиле)
    'pan_color_text', (оформление текста сообщения цветом)
    'pun_pm_notifier', (сигнализация новых ЛС)
    'pan_likes', (лайки)
________________________
* Если расширение не срабатывает - зайдите в Администрирование - Расширения, найдите fancy_box_for_pan_preview_image и обновите хуки.

This content is available only to registered users.

Все сборки основаны на PanBB, и имеют одинаковый чистый движок. Работать с ними можно точно так же - добавлять, удалять, включать, откключать расширения, менять стили и настройки.

После установки в окне поздравления с успешной установкой, могут выскакивать ошибки. Это неприятно, но безвредно. Работа с этой проблемой ведётся.

Единственное отличие от чистого движка - минимальная необходимая работа уже сделана за Вас.

Коротко рассмотрим файл  config.php.

Начало его обеспечивает подключение базы данных. Здесь мы видим тип БД - sqlite3, хост, адрес к самому файлу БД. 

Поля логина и пароля для доступа к Базе пусты -  SQLite3 этого не требует.  Если форум работает с MySQL, эта часть файла будет заполнена соответствующим образом, в т.ч. с обязательными в этом случае логином и паролем.

$db_type = 'sqlite3';
$db_host = 'localhost';
$db_name = 'admin/db/sqlite3.sql';
$db_username = '';
$db_password = '';
$db_prefix = '';
$p_connect = false;

Важнейшая вещь – базовый URL форума. Об этом много и прочувствованно  говорилось выше. Вот здесь он и прописывается в итоге, отсюда и берётся для работы всего форума.

$base_url = 'http://panbb.org';

Данные для куков.

$cookie_name = 'forum_cookie_3f92ad';
$cookie_domain = '';
$cookie_path = '/';
$cookie_secure = 0;

Опции работы форума. Все, кроме одной, по умолчанию закомментированы (если в начале строчки стоят два слеша // -   эта строчка не обрабатывается интерпретатором, отключается, её как бы нет)
Единственная работающая по умолчанию строчка ВКЛЮЧАЕТ ФОРУМ. Это главный рубильник. $matches[2]

define('FORUM', 1);

И ещё строчка, могущая представлять интерес для новичков:

// Enable DEBUG mode by removing // from the following line
//define('FORUM_DEBUG', 1);

Вот эта часть - // Enable DEBUG mode by removing // from the following line – закомментированное слешами объяснение, его не трогаем. А сама «рабочая» строчка  - //define('FORUM_DEBUG', 1 . Убрав слеши, раскомментировав строчку, мы разрешим вывод сообщений об ошибках и кое-какой вспомогательной служебной информации.   Этим можно безболезненно побаловаться. Не забудьте вернуть слеши на место, когда наиграетесь. В случае неполадок это приходится делать всерьёз, дабы отследить причину.

Дальше файл содержит ещё ряд «выключателей» различных служебных опций.

// Enable show DB Queries mode by removing // from the following line
//define('FORUM_SHOW_QUERIES', 1);

// Enable forum IDNA support by removing // from the following line
//define('FORUM_ENABLE_IDNA', 1);

// Disable forum CSRF checking by removing // from the following line
//define('FORUM_DISABLE_CSRF_CONFIRM', 1);

// Disable forum hooks (extensions) by removing // from the following line
//define('FORUM_DISABLE_HOOKS', 1);

// Disable forum output buffering by removing // from the following line
//define('FORUM_DISABLE_BUFFERING', 1);

// Disable forum async JS loader by removing // from the following line
//define('FORUM_DISABLE_ASYNC_JS_LOADER', 1);

// Disable forum extensions version check by removing // from the following line
//define('FORUM_DISABLE_EXTENSIONS_VERSION_CHECK', 1);

Если мы заглянем в файлы форума,  найдём там папку extensions . Она и содержит расширения – каждое в своей папке.

Скачанные где-либо (например, на этом сайте) расширения, необходимо распаковать именно сюда. Тогда они автоматически будут доступны для управления.

Просто распакованные в папку расширения становятся доступными для установки из админки.  К инструменту для управления попадаем  через Администрирование – Расширения

Здесь  видим список закачанных, но не установленных расширений, готовых к установке или обновлению. И установленных расширений, которые можно отключить либо удалить.

Зависимости расширений.
Некоторые расширения требуют для своей работы других – обычно, библиотек. Или, например, расширение добавляет свою кнопку в панель ВВ-кодов, тогда понятно, сама панель уже должна быть установлена.   Предупреждения о зависимостях выводятся при манипуляциях с расширениями, при этом Вам придётся удовлетворить зависимости – например, pan_smiles откажется устанавливаться, пока не будет установлено pun_jqwery.  А pun_jqwery откажется удаляться, если ещё установлено pan_smiles.

Установка расширения.
После нажатия кнопки «установить», появится окно подтверждения. Кроме того, возможно сообщение, что расширение не тестировалось с данной версией форума. В таком случае продолжаем установку на свой страх и риск. Тем не менее, большинство расширений при этом устанавливаются, запускаются и работают.

Настройка расширения.
Если расширение имеет  какие-то настройки, они добавляются где-то в  в админку форума. Для удобства администратора, чтобы облегчить ему поиски этих новых настроек, некоторые расширения имеют кнопку-ссылку, которая ведёт в дебри админки к этим самым настройкам.
Это сделано только для удобства поиска настроек. Если в управлении расширениями нет такой кнопки, это не значит, что оно не настраивается. Читайте описания.

Обновление расширения
ЕСЛИ В ОПИСАНИИ РАСШИРЕНИЯ НЕ УКАЗАН ДРУГОЙ ПОРЯДОК, стандартно процесс выглядит так:
Распаковываем новую версию расширения поверх старой. В управлении расширениями жмём «Обновить»

При этом все данные расширения (закачанные картинки и т.д.) сохраняются.

Отключение расширения
Если расширение отключить, оно просто перестанет работать, все настройки и данные сохраняются,  при включении всё окажется на месте.

Удаление расширения
Удаляется расширение и все его данные и настройки. В управлении оно переместится в список неустановленных.  Теперь, если Вы решили отказаться от него навсегда, его файлы  можно удалить на сервере из папки extensions.

Pan Manage Extensions
(Его устаревший аналог - Pun Admin Manage Extensions Improved, важные функции которого  не работают на форуме с БД SQLite3)

Это инструмент по управлению расширениями. Список в нём более удобен и компактен, чем стандартный, а дополнительные функции   – обновление хуков и переустановка расширения  помогают в администрировании.

Pan Manage Extensions входит в состав сборок PanBB.

Stressout, Обращайтесь 

Только базовый движок в этом посте https://punbb.softplaza.net/post4771.html#p4771
Он отличается от официального патчами, включением пяти языков и более удобной организацией архива. В любом случае, настоятельно рекомендую использовать его вместо официального.

Т.к. при использовании mySQL требуется заполнить пару полей, предполагается, что админ после этого сможет сам добавить и требуемые расширения .

На самом деле, это сложно осуществить эээ.... организационно.

Не исключено, что полезен был бы конвертер для перевода с SQLite на mySQL. Тогда, установив сборку, можно было бы перевести её на эту БД по желанию.

Grand91, эта сборка установит также кучу расширений. Тебе просто нужно скопировать все файлы на хостинг и поменять базовый урл в конфиге. Можно очистить папку кеша, все файлы кроме index.html и .htaccess.

Что бы посмотреть ошибки, в config.php есть строка:

define('FORUM_DEBUG', 1);

раскоментируй ее. Это покажет ошибочные запросы в БД.

А так же советую на некоторое время прописать такие строки:

ini_set('error_reporting', E_ALL);
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);

Покажет на экране все PHP ошибки.

Что покажет, выкладывай, будем думать.

ничего, все мы друг у друга учимся и ранее допускали куда более глупые ошибки 

Всегда рады помочь 

Ну и правильно, нечего тут делать жмотам и тунеядцам