Местная подстройка

Пожалуйста, экспериментируйте в песочнице!

ВикиАдминистратор может сделать некоторые подстройки простой установкой переменных в файле local/config.php. Любая группа или страница также может иметь собственный конфигурационный файл.

С самого начала PmWiki была задумана так, чтобы ВикиАдминистраторы могли сильно перестраивать вывод страниц и последовательности разметки используемые для образования страниц. (Это даже явно указано на странице Философия червёртым правилом). В результате, сценарий ядра pmwiki.php всячески пользуется переменными для определения как обработать последовательности разметки и что каждая отдельная страница выведет.

Основная часть этой страницы описывает в общих чертах как работают подстройки, некоторые наиболее часто используемые смотри в Documentation Index, включая:

Простейший тип подстройки это установка переменной в значение 1(или TRUE). Вот пример включающий операции ?action=diag и ?action=phpinfo:

$EnableDiag = 1;

Для добавления комментария в начале строки можно поставить "#" (знак числа, известный как решётка или знак фунта). Кроме того, некоторые встроеные переменные PmWiki принимают другие значения, нежели 1 или 0 (истина или ложь). Вот ещё пример включающий расположение вики к поисковым роботам (смотри Cookbook:ControllingWebRobots):

# Разрешает индексировать сайт поисковыми системами.
$MetaRobots = 'index,follow';
$EnableRobotCloakActions = 1;

Подпапка scripts/ (относительно папки со сценарием pmwiki.php) содержит много подстроек. Рецептурник PmWiki содержит много примеров подстроек(рецептов), которые вы можете скачать в папку cookbook/. Первые пять строк каждого такого сценария в основном содержат инструкции как включить (и использовать) функции предлагаемые этим сценарием.

Такие подстройки включаются в ваш файл конфигурации сайта config.php. Для большинства сценариев включение делается простым добавление строк вроде

include_once("cookbook/recipefile.php");

и

include_once("scripts/scriptfile.php");

в конец файла config.php.

Некоторые сценарии автоматически включены для вас через сценарий scripts/stdconfig.php пока вы не выключите их установкой $EnableStdConfig=0; в local/config.php.

Заметьте, что вы должны усиленно сопротивляться соблазну напрямую изменить сценарий pmwiki.php или файлы в папке scripts/. Все изменения сделаные вами в этих файлах будут потеряны после выполнения обновления. Напротив, посмотрите на некоторые сценарии из примеров подстроек выполняемые из config.php. Вы даже можете создать свои собственные сценарии для подстройки и воспользоваться include_once(...) для вставки его в config.php. Если вы сделали собственный сценарий, вы можете его спокойно положить в папку cookbook/. И он не будет потерян при обновлении. Вы также можете захотеть представить вашу подстройку в списке рассылки пользователей pmwiki? или в Рецептурнике так, что другие могут воспользоваться вашим достижением. И даже возможно она может будет включена в будущий выпуск PmWiki.

<< Начальная настройка | Документация | Внешность >>

Как мне получить имя группы или страницы в локальной файле настроек (т.е. local/config.php)?

Используйте следующие функции в pmwiki-2.1.beta21 или новее:

## Получить имя группы или страницы
$pagename = ResolvePageName($pagename);
$group = PageVar($pagename, '$Group');
$name = PageVar($pagename, '$Name');

Перевод страницы PmWiki.LocalCustomizations - Оригинал перевода PmWikiRu.LocalCustomizations - Backlinks
PmWikiRu.LocalCustomizations: редакция от September 10, 2011, at 12:48 PM
PmWiki.LocalCustomizations: редакция от March 12, 2023, at 10:08 AM