Ru:Configuration Basics

Основы настройки

Важно помнить о том, что все изменения, описываемые здесь, применяются не к файлу inc/config.php. Этот файл содержит стандартные настройки и регулярно обновляется, так что вам придётся настраивать всё заново каждый раз, когда вы захотите обновить движок.

Для хранения пользовательских конфигураций редактируйте файл inc/instance-config.php.

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

Вся настройка движка производится с помощью конфигурационных файлов.

• inc/config.php -- все стандартные настройки. Старайтесь не редактировать этот файл и не хранить в нём конфигурацию движка.
• inc/instance-config.php -- конфигурация установленного движка. Храните изменённые настройки в этом файле, чтобы избежать проблем с обновлениями.
• %доска%/config.php (опционально) -- файл конфигурации для отдельной доски. Вам нужно будет создать этот файл самостоятельно, если вы не можете его найти.

Файлы inc/instance-config.php и %доска%/config.php ничем не отличаются от inc/config.php. Вы можете просто копировать строчки из файла config.php в конфигурационные файлы. Кроме этого, файл config.php снабжён подробными комментариями по каждому параметру.

Конфигурационная переменная $config является одним большим ассоциативным массивом, изредка разделённым на "секции".

Порядок подключения конфигурационных файлов

Важно не просто бездумно копировать строчки из основного конфигурационного файла, но и понимать, как в Fukuro работают конфигурационные файлы. Все три файла подключаются друг за другом:

• inc/config.php -- $config сбрасывается на стандартный;
• inc/instance-config.php -- некоторые значения $config изменяются или переписываются;
• %доска%/config.php -- если файл существует, значения $config снова изменяются или переписываются.

Предположим, вам нужно включить Recaptcha на всём сайте, кроме доски /b/. Для этого:

• в файле inc/instance-config.php добавьте строчку $config['captcha'] = true;
• в файле b/config.php добавьте строчку $config['captcha'] = false;.

Ещё раз: никогда не изменяйте файл inc/config.php.

Комментарии

Каждая строчка в файле inc/config.php содержит комментарии, описывающие подключаемый функционал. Кроме этого, иногда там могут попадаться комментарии, содержащие примеры кода, который вы можете вставить в файл inc/instance-config.php.