Установка

Процедура установки frontPun

Существует два варианта установки:
- рядом с директорией форума, и
- в директорию форума

Сама процедура в реале очень простая, и только в виде текста выглядит так громоздко

Предполагается, что ваш punBB форум расположен в корне вашего сайта,  а вам требуется добавить к нему Главную Страницу frontPun.
Если вы готовы перенести форум из корня сайта в некую поддиректорию, а функции индексной странички (index.php) сайта отдать frontPun, тогда Вариант 1 для вас.
Если вы не готовы к этому, или по каким-то причинам не хотите переносить форум, то можно в директории форума сделать страничку portal.php и тогда для вас Вариант 2 подойдет лучше.


*** Вариант 1. Рядом с директорией форума ***
Если вы готовы перенести форум в site/forum

1)
- зайдите в форум администратором и в админ.панели (Admin menu) найдите пункт Опции (Options)
- найдите параметр Additional menu items и в текстовое поле добавьте ссылку на главную страницу -
   

0 = <a href="../">Main</a>

- измените пареметр Base URL , то есть интернет-ссылку на ваш ресурс, вида http://yoursite.org на http://yoursite.org/forum
- сохраните изменения, нажав на кнопку Save Options внизу страницы редактирования параметров форума.

2) В корне вашего сайте создайте директорию forum и перенесите в нее все файлы, которые касаются движка форума punBB.

3) Найдите директорию forum/cache и удалите из нее *.php файлы. Это нужно, чтобы очистить кеш  форума от старых значений конфигураци, которые мы поменяли.

4) В корень сайта распакуйте содержимое архива frontPun-vX.Y.tar.gz

5) у вас получится примерно такая структура корня сайта:

    
    /forum/
    /frontPun/
    index.php

показанный здесь index.php - это индексный файл из frontPun. Он будет обрабатывать запросы при обращении на http://yoursite.org - корень вашего сайта.

6) Теперь нужно настроить установленный frontPun.

Настройки

1) Откройте файл frontPun/config.php и отредактируйте все параметры в соответствии с вашими нуждами.
Каждый уникальный параметр снабжен пояснительным комментарием на русском языке. Так что, в общем-то, все должно быть понятно из пояснений, если не станет понятно из имени переменной.
Прочтите этот пункт еще раз и внимательнее! В настройке frontPun это самый главный пункт.
Параметры настройки выглядят так:

$FP_CONF['welcomeTopicId'] = 14; 
$FP_CONF['newsForumIds'] = "6";
$FP_CONF['newsCount'] = 5;
$FP_CONF['useHtmlInsteadOfBBCode'] = false;

Теперь вам нужно для всех параметров, которые содержат в имени "Id" - прочитать, понять, что они означают и указать свои Id, которые соответствуют данным из вашего форума. Вот что это означает.

Например:
$FP_CONF['welcomeTopicId'] = 14;
Так настроен параметр в дефолтном конфиге. Вы можете захотеть выводить топик с Id = 3. Тогда укажите
$FP_CONF['welcomeTopicId'] = 3;
или
$FP_CONF['welcomeTopicId'] = 0; - если вы не хотите, чтобы выводился Welcome Topic. К примеру, на этом сайте текст Welcome Topic показывается из топика номер 14, в тексте которого написано

frontPun - небольшой php проект, который предназначен для создания "портальной" странички на сайтах, созданных на базе форумного движка punBB или fluxBB.

и тд.

Еще пример:
$FP_CONF['newsForumIds'] = "6";
Это значение в дефолтном конфиге. Данный параметр указывает, из какого форума (точнее из форума с каким Id) нужно вынимать посты и показывать в виде новостей.
Допустим, что вы хотите показывать все новые посты из нескольких форумов. Из 10-го, 13-го и 4-го. Тогда вам нужно записать:
$FP_CONF['newsForumIds'] = "4, 13, 10";
Посты будут отсортированы по дате добавления, поэтому порядок записи номера в конфигурационной переменной роли не играет.
Опять таки, если вы не хотите показывать никаких новостей, укажите пустое значение для этой переменной:
$FP_CONF['newsForumIds'] = "";

Сначала отредактируйте все переменные, которые оперируют с Id топиков и форумов. А потом можно приступать к экспериментам с остальными переменными, ответственными за внешний вид всего index.php, его отдельных колонок или за настройки отдельных блоков.


*** Вариант 2. В директорию форума ***
Если вы не хотите перемещять форум, а хотите дать ему portal.php страничку

1) Распакуйте содержимое архива frontPun-vX.Y.tar.gz в директорию рядом с форумом.
Например в /frontTmp.
Рядом, потому что frontPun/index.php может затереть punBB/index.php.

2) Переименуйте frontTmp/index.php в frontTmp/portal.php.

3) Теперь в этом файле (frontTmp/portal.php) найдите строку 22

define('PUN_ROOT', './forum/');

и замените на

define('PUN_ROOT', './');

4) Перенесите все содержимое из frontTmp в директорию форума.
У вас должна получиться примерно такая структура корня сайта:

/some_dirs...
/frontPun 
some_files... 
index.php 
portal.php

где :

/some_dirs... - это несколько директорий punBB
/frontPun - это директория с файлами frontPun
some_files... - это все файлы punBB
index.php  - это индексный файл punBB
portal.php - это бывший index.php файл из frontPun

5) Добавьте ссылку "0 = <a href="./portal.php">Portal</a>" в список доп. элементов меню punBB

6) В коде punBB ничего менять не нужно, не нужно так же удалять кеш punBB.
Теперь позаботьтесь о том, чтобы portal.php был дефолтной страницей сайта для ваших посетителей.

7) Последнее: внимательно прочтите пункт Настройки из первого варианта установки. Этот пункт выше, сразу перед Вариантом 2 и настройте frontPun/config.php под свои нужды.