Файл Конфигурации

Имеется также Deutsch, English, Française


Более-менее подробное описание настроек файла config.php


для WackoWiki R5.5


Знак (?) означает я сомневаюсь в правильности комментария. Кому известнен
точный вариант, либо уточнение деталей, прошу править.



1. primary settings

Детальное описание конфигурационного файла config.php


'base_url' => 'http://example.com/wiki/',
– полный адрес, по которому расположена Вака


'database_charset' => '[cp1251|greek|latin1|latin2|...]',
– Устанавливает кодировку клиента


'database_driver' => 'mysqli_legacy',
'mysqli_legacy' -> mysqli
'mysql' -> pdo


'database_host' => 'localhost',
– имя хоста, на котором расположена СУБД mySQL (обычно localhost)


'database_port' => ' ',


'database_database' => 'wacko',
– имя базы данных


'database_user' => 'db_user',
– имя пользователя базы данных


'database_password' => 'mypassword',
– пароль к базе данных


'database_collation' => '0',
– кодировка, с которой данные (страницы и т.п.) будут добавляться или читаться из базы, должна совпадать с кодировкой в которой создана база данных, Подробнее см документацию mysql : команда SET NAMES 'codepage' . Эта настройка применяется в функции connect() (см. файл wacko\db\mysql.php)
Пример использования:
'db_collation' => 'cp1251',


'table_prefix' => 'wacko_',
– префикс таблиц базы данных


'system_seed' => '12345678901234567890',
– system seed


'recovery_password' => '',
– contains the password hash for the recovery password which can be generated with the action {{admin_recovery}} with Admin rights
– the recovery password is needed in order to log in admin panel
– без заданного хэша пароля или изменения system_seed доступ к панели администрирования невозможен.


'wacko_version' => '5.5.0',
– версия Ваки (не менять!)

2. secondary settings

stored in config table


Changes in the secondary config can be done via 
  1. editing config_value your prefix_config table via phpMyAdmin.
    • config_name config_value
      news_cluster News
    • Don't forget to delete the _cache/config/config.php afterwards, e.g. via {{admincache}}
  2. Администраторский раздел

'root_page' => 'HomeWiki',
– Вики-название корневой страницы. Станет корневой ссылкой.


'wacko_name' => 'MyWackoWiki',
– название Вака-сайта


'session_store' => 1,
– This option defines where the the session data is stored. By default either file or database session storage is selected..
1 – File (default)
2 – Database


'rewrite_mode' => 1,
– 'короткие, красивые URL'
1 – да; 0 – нет.
Если есть возможность, рекомендуется выставлять. Поисковые системы любят короткие имена файлов.
Возможность зависит от того, установлен mod_rewrite или нет.


'language' => 'ru',
– язык по-умолчанию. ru – русский; en – английский, и так далее.


'theme' => 'default',
– тема, скин, шаблон, внешний вид Ваки. Лежат в папке themes/
Можно изменять под свои требования.


'allow_themes' => '0',
'0' – all available themes are allowed (default)
'default,coffee' – here only these both themes are allowed


'allow_themes_per_page' => '0',
'0' – themes per page are not allowed (default)
'1' – allowed, Admin-Panel to enable


'show_spaces' => 1,
– показывать пробелы в ВикиСловах
Пробелы рекомендуется оставлять – это полезно для поисковых систем.


'default_typografica' => '1',
– использовать встроенную типографику
1 – да; 0 – нет.


'paragrafica' => 1,
– использовать встроенную параграфику?
1 – да; 0 – нет.


'referrers_purge_time' => 1,
– время хранения информации о ссылках на данную страницу (кол-во дней)
'0' – неограниченное кол-во времени.


'pages_purge_time' => 0,
– время хранения истории изменений страницы.
'0' – неограниченное время.
'1' – один день,
'90' – 90 дней и т.д.


'keep_deleted_time' => 0,
– the storage time of deleted pages if store_deleted_pages is active.
'0' – неограниченное время.
'1' – один день,
'90' – 90 дней и т.д.


'edit_summary' => 0,
– shows change summary in the edit mode
'0' – disabled (default)
'1' – enabled
'2' – mandatory


'minor_edit' => 0,
– enables minor edit option in the edit mode
'0' – disabled (default)
'1' – enabled


'hide_comments' => 0,
– скрывать комментарии к странице.
'0' – нет
'1' – да, hide them from all users
'2' – да, hide them from non-registered users


'hide_files' => 0,
– скрывать список загруженных файлов к этой странице
'0' – нет
'1' – да, hide them from all users
'2' – да, hide them from non-registered users


'debug' => 0,
– режим отладки. Вам он вряд ли понадобится.


'debug_admin_only' => 0,
'0' – disabled
'1' – отладка только для администраторов


'debug_sql_threshold' => 0,
0 показывает все SQL-запросы, 0.01, например, только запросы, достигающие порога времени выполнения более 0.01 секунды.


'log_min_level' => 0,
'0' – disabled
'1' – critical : admin action, object deletion, suspected hacking attempt
'2' – highest: locking, acl change, unsuccessful user login
'3' – high: page renaming/moving/splitting/merging, user password change/reminder, successful user login
'4' – medium: page creation (settings change), file upload, pm sending, user registration and email activation, page ownership claim
'5' – low: comment posting, user logout
'6' – lowest: page edit, user settings update
'7' – debugging: everything, where logging is necessary


'youarehere_text' => ' ',
– (?)
WikiAdmin: Убирает на странице ссылки на нее же, форматирует по шаблону 'текст', например для текст = '<i>####</i>' курсивит. Не проверял, прочел в английском мануале, спасибо SkiPer.


'hide_locked' => 1,
– скрывать страницы с ограниченными правами доступа от тех, для кого этот доступ не предназначен. 'Скрывать' означает не выводить в различных списках, таких как RecentChanges.
1 – да; 0 – нет (рядом с ссылкой будет замочек).


'allow_rawhtml' => 0,
– разрешать синтаксис для вставки произвольного HTML-кода.


'disable_safehtml' => '0'
Поддержка SafeHTML.


'urls_underscores' => 0,
– формировать адреса (URLs) с подчерками (например, http://somewhere/Wiki_Page).


'default_write_acl' => '*',
– права на возможность создавать новые записи на страницах. Смотри ПраваДоступа


'default_read_acl' => '*',
– права на чтение


'default_comment_acl' => '*',
– права на возможность оставлять комментарии


'default_rename_redirect' => 1,
– по умолчанию устанавливать редирект со старой страницы на новую при переименовании
0 – удалять старую страницу


'owners_can_remove_comments' => 1,
– все пользователи имеют право удалять свои комментарии (?)
Если '0', то удалять могут только администраторы (?)


'allow_registration' => 1,
– открытая регистрация. Если '0', то регистрировать новых пользователей могу только администраторы (?)


'standard_handlers' => 'acls|addcomment|claim|diff|edit|msword|print|referrers|referrers_sites|remove|rename|revisions|revisions\.xml|show|watch|settings',
Набор обработчиков для каждой страницы твоей Ваки


'footer_comments' => 1,
наличие комментариев на странице
1 – да; 0 – нет


'footer_files' => 0,
наличие формы загрузки файлов на странице
1 – да; 0 – нет


'disable_tikilinks' => 0,
– (?)


'remove_onlyadmins' => 0,
– только админы имеют право на удаление страниц
1 – да; 0 – нет


'store_deleted_pages' => 1,
Хранит резервную копию для удаленных страниц.
'0' – нет
'1' – да (default)


'upload' => 'admins',
– права на загрузку файлов
'admins' означает, что только группа admins может загружать файлы
'0' (нуль) означает, что загрузка отключена.
ЗагрузкаФайлов здесь написано: upload = false, true, “admins” — кто может загружать. Анонимы не могут загружать никогда


'upload_images_only' => 0,
– возможно загружать только картинки
1 – да; 0 – нет


'upload_max_size' => 100,
– максимальный размер одного загружаемого файла


'upload_banned_exts' => 'php|cgi|js|php|php3|php4|php5|pl|ssi|jsp|phtm|phtml|shtm|shtml|xhtm|xht|asp|aspx|htw|ida|idq|cer|cdx|asa|htr|idc|stm|printer|asax|ascx|ashx|asmx|axd|vdisco|rem|soap|config|cs|csproj|vb|vbproj|webinfo|licx|resx|resources',
– расширения файлов, запрещенные к закачиванию


'outlook_workaround' => 1,
– (?)


'autosubscribe' => 1,
Выключить автоматическую подписку на наблюдение за своими страницами
1 – да; 0 – нет
Рекомендуется оставить значение '0'. В этом случае можно будет получать по почте оперативные сигналы об изменениях твоих страниц.


'allow_gethostbyaddr' => 1,
Для анонимных пользователей пытается записать и отобразить имя хоста, вместо IP адреса.


'multilanguage' => 0,
– возможность выбора языка интерфейса из имеющихся.
1 – да; 0 – нет
Если значение '0', значит будет использоваться язык указанный по умолчанию (см. выше)


'cache' => 1,
– использование кэша (временного сохранения сгенерированных файлов). Кэш позволяет ускорить загрузку страниц Вики благодаря тому, что не нужно тратить ресурс на генерацию уже сохраненных страниц. Кэшируются все просмотренные страницы без исключения.
На практике был такой случай: Вика размером в 1400 страниц за 3 дня 'накэшировала' 10000 файлов общим размером в 300 мегов. Появились торможения в работе скрипта и проблемы с выделенным под хостинг местом. Кэш пришлось отключить.
Для очистки кэша необходимо создать страницу, вставить туда {{admincache}}. После сохранения страницы появится кнопка очистки кэша. Данная возможность доступна только администраторам.


'cache_ttl' => 600,
– время валидности кэша в секундах.
По прошествии данного времени файл в кэше будет считаться 'недействительным' и страница будет заново сформирована на основе запросов в БД и сохранена в кэш.


'rename_globalacl' => 'Admins',
– пользователи (или группы), обладающие правом на глобальное переименование страниц


'spam_filter' => 1
– spam_filter config parameter
– We load in the external antispam.conf file and then search the entire body content for each of the words defined as spam. If we find any then we return from the function, not saving the changes.


'pwd_min_chars' => 10,
– Минимальная длина пароля


'pwd_admin_min_chars' => 15,
– Минимальная длина пароля


'pwd_char_classes' => 0,
– Требуемая сложность пароля
'0' – не проверяется
'1' – любые буквы + цифры
'2' – заглавные и строчные + цифры
'3' – заглавные и строчные + цифры + символы


'pwd_unlike_login' => 1,
– Дополнительная сложность
'0' – не проверяется
'1' – пароль не идентичен логину
'2' – пароль не содержит логин


'enable_captcha' => 1,
Captcha?


'captcha_new_comment' => 1,


'captcha_new_page' => 1,


'captcha_edit_page' => 1,


'captcha_registration' => 1,


'date_format' => 'd/m/Y',
'time_format' => 'H:i',
'time_format_seconds' => 'H:i',
'name_date_macro' => '%s (%s)',
– see php:date for format local time/date


'admin_name' => 'AdminWiki',
– ВикиИмя администратора, оно же логин для входа.


2.1. Email settings

Эта информация используется, когда вики отправляет электронные письма вашим пользователям. Пожалуйста, убедитесь, что указанный вами адрес электронной почты является действительным, на него, скорее всего, будут отправлены любые сообщения с ошибками или недоставленные сообщения. Если ваш хост не предоставляет родной (PHP) почтовый сервис, вы можете отправлять сообщения напрямую через SMTP. Для этого требуется адрес соответствующего сервера (при необходимости обратитесь к своему провайдеру). Если сервер требует аутентификации (и только если она требуется) введите необходимое имя пользователя, пароль и способ аутентификации.


'enable_email' => 1
Enabling email


'enable_email_notification' => 1
Allow email notification. Set to ON to enable email notifications, OFF to disable them. Note that disabling email notifications has no effect on emails generated as part of the user signup process.


'phpmailer_method' => ''
The e-mail function used to send mails through PHP, using the Phpmailer class.

  1. mail
  2. sendmail
  3. smtp

'email_from' => ''
The sender name, part of "From:" header in emails for all the email-notification site.


'admin_email' => 'admin@example.com',
– е-майл администратора


'abuse_email' => 'admin@example.com'
Address requests for urgent matters: registration for a foreign email, etc. It may coincide with the previous.


'smtp_host' => ''
SMTP server address


'smtp_port' =>
Измените это значение, только если вы знаете, что ваш SMTP сервер расположен на другом порту. (по умолчанию 25 или 587)


'smtp_connection_mode' => ''
Используется, только если установлено имя пользователя/пароль, спросите у своего провайдера, не уверены ли вы, какой метод использовать.


'smtp_username' => ''
Вводите имя пользователя только в том случае, если этого требует ваш SMTP-сервер.


'smtp_password' => ''
Вводите пароль только в том случае, если он необходим вашему SMTP-серверу.
Внимание: Этот пароль будет сохранен в виде простого текста в базе данных, который будет виден всем, кто имеет доступ к вашей базе данных или может просмотреть эту страницу конфигурации.

3. constants

The detailed description of configuration file constants.php


Read comments (4 comments)