Начальная настройка

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

администраторам (основы)

Теперь, когда на вашем сайте есть работающая PmWiki (смотри Установка), настало время для её настройки под ваши частные запросы.

Большинство настроек PmWiki находится в файле local/config.php. Но некоторые настройки, такие, как меню Site.SideBar, сделаны на специальных страницах группы Site.

Файл конфигурации (local/config.php)

После первой установки PmWiki файл local/config.php отсутствует. Чтобы его создать, скопируйте файл sample-config.php (из папки docs/) в local/config.php и используйте его как отправную точку. Конечно, Вы могли бы создать файл local/config.php с нуля, но sample-config.php для удобства уже заполнен множеством опций готовых для правки.

Вот пример короткого файла config.php:

<?php if (!defined('PmWiki')) exit();
$WikiTitle = "My New Wiki";
$PageLogoUrl = "http://www.example.com/mylogo.gif";

$DefaultPasswords['admin'] = crypt('onesecret');

$EnableUpload = 1;
$DefaultPasswords['upload'] = crypt('secrettwo');

putenv("TZ=EST5EDT");
$TimeFmt = '%B %d, %Y, at %I:%M %p EST';

Заметьте, что config.php начинается с <?php . Завершающий тэг PHP ?> не обязателен и для улучшения совместимости с некоторыми системами может быть опущен. Непременно убедитесь в отсутствии пустых строк или пробелов перед тэгом <?php и после ?>. В противном случае вы можете получить в начале ваших страниц странные сообщения о PHP-ошибках.

Файл config.php, указанный выше, устанавливает значения четырёх PHP-переменных используемых PmWiki:

  • $WikiTitle назначает имя вашего сайта, отображаемое в заголовке браузера пользователя. Если вы хотите ввести название сайта на русском языке, то не забудьте, что для редактирования файла config.php нужно будет использовать текстовый редактор, поддерживающий UTF-8 без BOM.
  • $PageLogoUrl указывает путь к пиктограмме (логотипу), видимому в левом верхнем углу каждой вики страницы.
  • $DefaultPasswords['admin'] определяет пароль администратора.
  • Установка $EnableUpload в "1" разрешает Закачки ("Прикреплёные файлы"). $DefaultPasswords['upload'] устанавливает пароль на закачку.
  • Переменная окружения TZ определяет часовой пояс.
  • $TimeFmt определяет формат времени и (вместе с TZ) настраивает wiki на конкретную зону времени.

Установкой этих (и других) переменных в local/config.php изменяется внешний вид и поведение PmWiki. Полный список переменных PmWiki смотрите на странице Переменные, а примеры сайтов, использующих PmWiki на странице PmWiki:PmWikiUsers .

Установка пароля администратора

Страницы в группе Site (за исключением Site.SideBar) по умолчанию закрыты. Чтобы разрешить редактировать страницы этой группы, вам надо в файле local/config.php назначить пароль администратора. Пароль администратора в значение "mysecret" устанавливается так:

$DefaultPasswords['admin'] = crypt('mysecret');

Выбирайте пароль с каким-либо осмысленным значением. Подробнее о более безопасном определении паролей смотрите Администрирование паролей

Не меняйте и не переименовывайте pmwiki.php

PmWiki разработана таким образом, чтобы настройка не затрагивала файлы дистрибутива. Одно из достоинств такой организации - это обеспечение простого обновления. PmWiki никогда не меняет файлы в директориях local/ и cookbook/, так что размещение в них ваших настроек упрощает отслеживание изменений и обновление PmWiki без потерь настроек.

При конфигурировании вашего сайта либо изменяйте файл local/config.php, либо добавляйте файлы в папки cookbook/ и pub. Не трогайте pmwiki.php или файлы в директории scripts/, так как они предположительно будут перезаписаны во время обновления.

Вам не следует также переименовывать pmwiki.php. Если вы переименуете его, то он не будет перезаписан во время обновления ПО, что приведёт к возможным сбоям.

Многие администраторы добавляют в папке pmwiki "сценарий оболочку" index.php, который содержит одну строку:

<?php include('pmwiki.php');

Другие настройки

После настройки файла local/config.php вы можете пожелать сделать другую подгонку. Большое количество дополнений вы найдёте на странице Рецептурник PmWiki. И не бойтесь брать из него рецепты - они все хорошо приготовлены, так что большинство из них требуют загрузки всего одного файла, добавки однострочной команды вставки в config.php, и вуаля! - они заработали!

Если вы (или другие совладельцы вашего сервера) захотите поддержать более, чем одну вики на одном сервере, то почитайте страничку ВикиФермы.

Что теперь?

Не забудьте присоединиться к списку рассылок PmWiki, где вы можете списаться с другими вики администраторами для получения помощи в переделке PmWiki и поучаствовать в обсуждениях исправлений PmWiki. Имея же свой собственный действующий PmWiki сайт, не стесняясь, добавьте его на страницу PmWiki:PmWikiUsers так, чтобы другие о вас знали!

<< Установка | Документация | Местная подстройка >>

Перевод страницы PmWiki.InitialSetupTasks - Оригинал перевода PmWikiRu.InitialSetupTasks - Ссылаются
PmWikiRu.InitialSetupTasks: редакция от 06.01.2012 17:35
PmWiki.InitialSetupTasks: редакция от 19.06.2025 07:48

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_COOKIE] => PHPSESSID=e01u5fdtjde18lu8aatn29tv85; imstime=1777620093
            [HTTP_HOST] => www.pmwiki.org
            [HTTP_REFERER] => http://www.pmwiki.org/wiki/PmWikiRu.InitialSetupTasks
            [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%2eInitialSetupTasks
            [REDIRECT_HTTPS] => on
            [REDIRECT_QUERY_STRING] => n=PmWikiRu%2eInitialSetupTasks
            [REDIRECT_SCRIPT_URI] => https://www.pmwiki.org/wiki/PmWikiRu.InitialSetupTasks
            [REDIRECT_SCRIPT_URL] => /wiki/PmWikiRu.InitialSetupTasks
            [REDIRECT_SSL_TLS_SNI] => www.pmwiki.org
            [REDIRECT_STATUS] => 200
            [REDIRECT_UNIQUE_ID] => afRUjxTBWSQ56Rt3Xg0AnQAAAAI
            [REDIRECT_URL] => /wiki/PmWikiRu.InitialSetupTasks
            [REMOTE_ADDR] => 216.73.216.25
            [REMOTE_PORT] => 57437
            [REQUEST_METHOD] => GET
            [REQUEST_SCHEME] => https
            [REQUEST_URI] => /wiki/PmWikiRu.InitialSetupTasks
            [SCRIPT_FILENAME] => /home/pmwiki/public_html/index.php
            [SCRIPT_NAME] => /index.php
            [SCRIPT_URI] => https://www.pmwiki.org/wiki/PmWikiRu.InitialSetupTasks
            [SCRIPT_URL] => /wiki/PmWikiRu.InitialSetupTasks
            [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] => afRUjxTBWSQ56Rt3Xg0AnQAAAAI
            [PHP_SELF] => /index.php
            [REQUEST_TIME_FLOAT] => 1777620111.1836
            [REQUEST_TIME] => 1777620111
            [argv] => Array
                (
                    [0] => n=PmWikiRu%2eInitialSetupTasks
                )

            [argc] => 1
        )

)