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


Более-менее подробное описание настроек файла config.php (лежит в папке sites/ с названием wakka.config.имя сайта.php)

Старый вариант можно найти здесь: http://web.archive.org/web/20070317062824/http://wackowiki.com:80/WackoDokumentacija/FajjlKonfiguracii

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

Оглавление документа


1. primary settings

The detailed description of configuration file config.php

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

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

'db_layer' => 'mysql',
или mysqli
также может быть совсем не установлен – тогда автоматический выбор

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

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

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

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

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

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

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

2. secondary settings

stored in config table

Changes in the secondary config can be done via 

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

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

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

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

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

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

'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 дней и т.д.

'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,
– режим отладки. Вам он вряд ли понадобится.
– для разработчиков:
  • 1 – показывает время генерации страницы
  • 2 – показывает детальную расшифровку времени генерации страницы

'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 – нет

'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,
– (?)

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

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

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

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

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

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

3. QS settings


'allow_showsource' => 1,
Позволяет пользователям, имеющим право на чтение страницы, также иметь право на просмотр её исходного кода (по ссылке page/showsource)
Реализуется с помощью хендлера handlers/page/showsource.php, добавленного в QS 5, но также который может быть добавлен в более ранние версии.

'not_root_html_redirect' => '1',
Позволяет при заходе на корневую страницу сайта отображать ее сразу (http://qs.janvarev.ru/) вместо редиректа на http://qs.janvarev.ru/HomePage

'paragrafica_nop' => '1',
Выключает вставку <p class="auto"> в параграфике (для упрощения работы с div-версткой)
Оставляет остальные фичи параграфики типа формирования оглавления (toc)