Этот пункт документации почти полностью повторяет содержимое файла frontPun/config.php, за исключением того, что некоторые параметры снабжены чуть-чуть большим количеством пояснений, чем в самом конфиге.
Все переменные, работающие с Id топиков или форумов, принимают следующие значения:
- число, если предполагается один Id. То есть int. Например - 10. Если вы не хотите использовать контент-блок, который управляется этой переменной, передайте в значение 0.
- строку с перечисленными через запятую числами внутри, если предполагается возможность указания нескольких Ids. То есть String. Например - "10, 12, 1"; или "10" - если число одно; или пустую строку - "" - если вы не хотите использовать контент-блок, который управляется этой переменной.
Остальные переменные принимают либо значения true/false, обычно означающие - показывать/не показывать элемент, либо строку. В строках, как правило, указываются названия элементов, которые будут использованы при выводе.
Как вы уже поняли, frontPun может показывать 1, 2 или 3 колонки. Первая и третья - боковые, они опциональны. Их можно включить или выключить простой булевой переменной - useLeftPanel/useRightPanel = true/false. Но средняя колонка - показывается всегда, ее выключить нельзя.
Называются они - левая, серединная и правая 
Еще я их называю панелями. leftPanel, middlePanel и rightPanel. Так написано в коде и так я их иногда называю в документации.
Колонки отрисовываются в index.php в простой html таблице. Так что размеры или другие параметры таблицы можно легко подправить в html коде index.php.
Теперь сами переменные:
НАСТРОЙКИ СЕРЕДИННОЙ ПАНЕЛИ.
$FP_CONF['welcomeTopicId'] = 14;
Если значение не 0, то в качестве welcome-msg вверху Главной страницы будем использовать указанный топик.
Можно сделать к примеру скрытый форум в специальной категории, если убрать у форума права на чтение у всех групп пользователей кроме админа; и в этот форум добавить welcome-topic.
Если значение 0, то welcome-msg не показывается.
Вам нужно указать 0 или Id топика из вашего форума, который вы хотите показать в качестве Welcome Message.
$FP_CONF['newsForumIds'] = "6"; или
$FP_CONF['newsForumIds'] = "6, 10, 33, 24"; или
$FP_CONF['newsForumIds'] = ""; - не показывать новости.
Перечисляются Id форумов через запятую, топики которых будут выводиться в серединную панель новостей. Означает это вот что. У вас есть форумы, из которых каждые новые топики хочется показывать на главной стрице. В форуме появился топик - на главной стрице появилась новость. Порядок, в котором указаны эти Id - не важен. Топики все равно будут отсортированы по дате, и самой верхней новостью в колонке новостей будет самый последний по дате топик из всех этих форумов.
Вам нужно указать значения Id новостных форумов из вашего списка форумов, или указать пустую строку.
$FP_CONF['newsCount'] = 5;
Количество новостей на главной странице, эта переменная относится к предыдущей. Из указанных выше форумов будет показываться указанное в этом параметре количество новостей.
$FP_CONF['limitNewsLength'] = 0;
Ограничивать длину новости, если она превышает X слов.
0 - ноль, не ограничивать длину. Текст новости будет показан полностью.
Внимание! html или BBCode могут испортиться, т.к. "слова" вычленяются по пробелам между ними. К примеру, если ограничение 50 слов, и пятидесятым словом будет начало тега <img - то на этом месте текст будет обрезан.
$FP_CONF['readMore'] = "... подробнее";
Если limitNewsLength включен, то что писать в ссылке, "читать дальше" или "продолжение" или что-то еще.
$FP_CONF['useHtmlInsteadOfBBCode'] = false;
Значения - true/false.
Если true - то использовать html вместо использования bbcode.
При этом функция parse_message($topic_message), которая преобразует постовые смайлики и обычный bbcode, не будет использоваться.
Эта опция дает преимущества в боковых панелях при использовании StaticTopic-блока, таким образом можно, например, вывести сложное меню или баннеропоказ, если постить в указанный топик продуманный html.
Внимание! эта опция влияет на всю колонку. То есть, если она указана в true, и вы выводите несколько StaticTopic-блоков и, допустим, новостной блок, то все тексты в статик-топиках и новостях будут рендерится как html.
$FP_CONF['useWholeBorder'] = false;
Использовать рамку (border) вокруг всей панели
$FP_CONF['normalizeFontSize'] = true;
$FP_CONF['normalizeFontSizeTo'] = "font-size: 12px;";
Нормализация размера шрифта в новостях.
Обычно punBB использует до одури мелкий шрифт.
$FP_CONF['spaceBetweenTopics'] = "<br/><br/>";
Сколько расстояния отступать между топиками.
Один <br/> - плотненько. Два - <br/><br/> - разреженненько.
$FP_CONF['usePostBorder'] = false;
Показывать рамку (бордер) вокруг поста, используется class="box". Симпатично, если не используется бордер вокруг всей панели.
$FP_CONF['usePostStatusBar'] = false;
Показывать статусную строку под каждой новостью: дата, автор, форум
$FP_CONF['usePostTitle'] = true;
Показывать заголовок топика. Действует так же на всю колонку, так что будте аккуратны. Если false, то топики будут без заголовка, как в news-блоках, так и staticTopic-блоках.
$FP_CONF['usePostLink'] = true;
Сделать заголовок ссылкой на исходный новостной пост. Если false, тогда заголовок просто не будет ссылкой на исходный топик. Это полезно, если вы сокращаете длину новостного поста до X слов, и на сам пост ведет ссылка "читать дальше", следуемая за урезанным текстом.
$FP_CONF['usePostTitleAccent'] = false;
Использовать выделение цветом полосы с заголовком топика
При выделении используется h2, как заголовок топика в форуме.
Без выделения - h1 или h3
$FP_CONF['useSmallTitleNoAccent'] = false;
Если заголовок без акцента (usePostTitleAccent = false)
то использовать большой или маленький шрифт (h1 - большой, h3 - маленький. )
useSmallTitleNoAccent = true - будет h3
useSmallTitleNoAccent = false - будет h1
Что касается двух последних переменных, они не очень понятны, и я об этом знаю. Однако вопрос уже обсуждался. Пожалуйста, просмотрите топик http://frontpun.org.ua/forum/viewtopic.php?id=41 и топик http://frontpun.org.ua/forum/viewtopic.php?pid=57#p57 (ответ номер #16, если что). Вам станет понятнее. И, на всякий случай, три скриншота.
usePostTitleAccent = true
usePostTitleAccent = false && useSmallTitleNoAccent = fasle
usePostTitleAccent = false && useSmallTitleNoAccent = true
$FP_CONF['useLeftPanel'] = true;
Использовать ли вообще левую панель. То есть, будет ли она показана.
Следующую часть переменных я описывать не буду. Они описаны только что. Единственное их отличие от предыдущих - это префикс "lp_" в имени ключа переменной. Такой префикc означает, что эти переменные контролируют состоянии элементов левой панели. Тоже касается и правой панели. Ее переменные будут предварены, по логике, префиксом "rp_".
Вот переменные, которые уже не нуждаются в описании:
$FP_CONF['lp_newsForumIds'] = "";
$FP_CONF['lp_newsCount'] = 5;
$FP_CONF['lp_limitNewsLength'] = 0;
$FP_CONF['lp_readMore'] = "... подробнее";
$FP_CONF['lp_useHtmlInsteadOfBBCode'] = true;
$FP_CONF['lp_useWholeBorder'] = false;
$FP_CONF['lp_normalizeFontSize'] = false;
$FP_CONF['lp_normalizeFontSizeTo'] = "font-size: 14px;";
$FP_CONF['lp_spaceBetweenTopics'] = "<br/>";
$FP_CONF['lp_usePostBorder'] = true;
$FP_CONF['lp_usePostStatusBar'] = false;
$FP_CONF['lp_usePostTitle'] = true;
$FP_CONF['lp_usePostLink'] = false;
$FP_CONF['lp_usePostTitleAccent'] = true;
$FP_CONF['lp_useSmallTitleNoAccent'] = true;
Переменные, которых еще не было, но которые контролиуют элементы из боковых панелей:
$FP_CONF['lp_staticTopicIds'] = "22,13";
Через запятую перечисляются Id топиков, которые должны быть обработаны как staticTopic блоки. Если 0 или пустая строка - то staticTopic блок не используется.
Этот параметр - альтернатива $FP_CONF['lp_newsForumIds']. Другими словами - news-блок динамический, каждый новый топик будет показан. Статик-топик-блок - статический, показывается один и тот же текст в одном и том же месте. Удобно для создания дополнительного меню в боковой панельке или отработки скрипта баннера.
Search-блок
$FP_CONF['lp_useSearchFormBlock'] = true;
Показывать ли блок с формой поиска.
RecentPosts-блок
$FP_CONF['lp_useRecentPostsBlock'] = true;
Показывать ли блок "последних постов". Выглядит, как ссылки на топики. Содержимое этого блока может быть настроено по его типу.
$FP_CONF['lp_recentPostsBlockType'] = 'active';
Тип этих постов. Значения: active, new.
Отличия: active - показываются ссылки на топики с самыми новыми комментами (в них же могут попасть и new).
new - показываются ссылки на последние добавленные именно топики, то есть, последние по дате добавления на форум.
$FP_CONF['lp_recentPostsBlockTitle'] = 'Обновленные сообщения:';
Заголовок блока RecentPosts
$FP_CONF['lp_recentPostsBlockCount'] = 10;
Количество ссылок блока RecentPosts
$FP_CONF['lp_recentPostsBlockLinkLength'] = 2;
Количество слов в ссылках на топики в блоке RecentPosts
UsersOnline блок
$FP_CONF['lp_useUsersOnlineBlock'] = true;
Показывать ли блок онлайн-юзеров
$FP_CONF['lp_usersOnlineBlockTitle'] = 'Сейчас на форуме:';
Заголовок блока онлайн-юзеров
BoardStats блок
$FP_CONF['lp_useBoardStatsBlock'] = true;
Показывать ли блок статистики. В него включается количество постов на форуме, количество зарегистрированных пользователей и имя последнего зарегистрированного пользователя.
$FP_CONF['lp_boardStatsBlockTitle'] = ' Статистика форума:';
Заголовок блока статистики
LinkNews блок
$FP_CONF['lp_useLinkNewsBlock'] = true;
Показывать ли блок новостей в виде ссылок, как RecentPosts. Такой-себе гибридный блок. В отличае от обычных новостей, этот блок не показывает текст новости, только ссылки на новостные топики. Задумывался, как блок "других" новостей, которые не слишком-то и важны, вроде бы, но ссылки на них не помешают.
$FP_CONF['lp_linkNewsBlockTitle'] = 'Другие события:';
Заголовок для блока LinkNewsBlock
$FP_CONF['lp_linkNewsBlockForumIds'] = "5";
Номера Id форумов, из которых вынимаем топики для LinkNewsBlock. Здесь тоже допустимо перечисление Ids через запятую, или одно значение, или пустая строка, если такой блок не нужен. Обязательно отредактируйте этот параметр в соответствии с доступными Id из вашего форума.
$FP_CONF['lp_linkNewsBlockLinkLength'] = 2;
Количество слов в ссылках на топики в блоке LinkNewsBlock
TopTopics блок
$FP_CONF['lp_useTopTopicsBlock'] = true;
Показывать ли блок TopTopics. Это блок ссылок на самые популярные топики на вашем форуме. Популярность может рассчитываться либо по количеству комментариев, либо по количеству просмотров топика.
$FP_CONF['lp_topTopicsBlockTitle'] = "Топ топиков";
Заголовок блока TopTopics.
$FP_CONF['lp_topTopicsBlockType'] = "num_replies";
Допустимые значения: num_replies (по кол-ву комментариев), num_views (по кол-ву просмотров)
$FP_CONF['lp_topTopicsBlockCount'] = 10;
Количество ссылок-топиков в блоке TopTopics.
$FP_CONF['lp_topTopicsBlockLinkLength'] = 3;
Количество слов в ссылках на топики в блоке TopTopics
TopUsers блок
$FP_CONF['lp_useTopUsersBlock'] = true;
Показывать ли блок TopUsers. Блок представляет из себя имена самых многопишущих пользователей в виде ссылки на их профайлы.
$FP_CONF['lp_topUsersBlockTitle'] = "Топ пользователей:";
Заголовок блока TopUsers.
$FP_CONF['lp_topUsersBlockCount'] = 5;
Количество выводимых топ-юзеров в блоке.
$FP_CONF['lp_topUsersBlockShowNumPosts'] = true;
Показывать количество постов топ-юзеров.
$FP_CONF['lp_topUsersBlockShowIcon'] = true;
Показывать простую иконку возле ссылки на пользователя. Это не аватар, просто маленькая картинка "человечек", как в мессенджерах.
Настроечные переменные для правой панельки абсолютно идентичны переменным настроек левой панели. За исключением префикса "rp_" вместо "lp_". Поэтому приводить их полностью я не буду.
В заключение скажу, что все эти переменнные есть в конфиг-файле, все снабжены кратким комментарием и все должны быть. Сократить конфиг файл нельзя (кроме как удалением комментариев), ни одну переменную нельзя выбросить. Значений по умолчанию нет, поэтому каждая переменная нужна для правильной работы движка.
Однако, настраивая frontPun, вам скорее всего потребуется всего лишь заменить значения для переменных, работающих с Id форумов или топиков и в нескольких местах установить true/false для блоков, которые вы хотите показать/скрыть.
Удач в настройке.
