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

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

ВикиАдминистратор может сделать некоторые подстройки простой установкой переменных в файле 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 - Ссылаются
PmWikiRu.LocalCustomizations: редакция от 10.09.2011 18:48
PmWiki.LocalCustomizations: редакция от 14.12.2025 12:07

Array
(
    [post_max_size] => 64M
    [$_POST keys] => 
    [$_REQUEST keys] => n
    [$_SERVER] => Array
        (
            [CONTEXT_DOCUMENT_ROOT] => /home/pmwiki/public_html
            [CONTEXT_PREFIX] => 
            [DOCUMENT_ROOT] => /home/pmwiki/public_html
            [GATEWAY_INTERFACE] => CGI/1.1
            [HTTPS] => on
            [HTTP_ACCEPT] => */*
            [HTTP_ACCEPT_ENCODING] => gzip, br, zstd, deflate
            [HTTP_HOST] => www.pmwiki.org
            [HTTP_USER_AGENT] => Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
            [HTTP_X_HTTPS] => 1
            [PATH] => /bin:/usr/bin
            [PHP_INI_SCAN_DIR] => /opt/cpanel/ea-php70/root/etc:/opt/cpanel/ea-php70/root/etc/php.d:.
            [QUERY_STRING] => n=PmWikiRu%2fLocalCustomizations
            [REDIRECT_HTTPS] => on
            [REDIRECT_QUERY_STRING] => n=PmWikiRu%2fLocalCustomizations
            [REDIRECT_SCRIPT_URI] => https://www.pmwiki.org/wiki/PmWikiRu/LocalCustomizations
            [REDIRECT_SCRIPT_URL] => /wiki/PmWikiRu/LocalCustomizations
            [REDIRECT_SSL_TLS_SNI] => www.pmwiki.org
            [REDIRECT_STATUS] => 200
            [REDIRECT_UNIQUE_ID] => afILs9D-CqAO2irN-jjPKgAAAIw
            [REDIRECT_URL] => /wiki/PmWikiRu/LocalCustomizations
            [REMOTE_ADDR] => 216.73.216.31
            [REMOTE_PORT] => 42253
            [REQUEST_METHOD] => GET
            [REQUEST_SCHEME] => https
            [REQUEST_URI] => /wiki/PmWikiRu/LocalCustomizations
            [SCRIPT_FILENAME] => /home/pmwiki/public_html/index.php
            [SCRIPT_NAME] => /index.php
            [SCRIPT_URI] => https://www.pmwiki.org/wiki/PmWikiRu/LocalCustomizations
            [SCRIPT_URL] => /wiki/PmWikiRu/LocalCustomizations
            [SERVER_ADDR] => 23.254.203.248
            [SERVER_ADMIN] => webmaster@pmwiki.org
            [SERVER_NAME] => www.pmwiki.org
            [SERVER_PORT] => 443
            [SERVER_PROTOCOL] => HTTP/1.1
            [SERVER_SIGNATURE] => 
            [SERVER_SOFTWARE] => Apache
            [SSL_TLS_SNI] => www.pmwiki.org
            [TZ] => America/Los_Angeles
            [UNIQUE_ID] => afILs9D-CqAO2irN-jjPKgAAAIw
            [PHP_SELF] => /index.php
            [REQUEST_TIME_FLOAT] => 1777470387.5304
            [REQUEST_TIME] => 1777470387
            [argv] => Array
                (
                    [0] => n=PmWikiRu%2fLocalCustomizations
                )

            [argc] => 1
        )

)