1
0
mirror of https://github.com/vichan-devel/vichan.git synced 2024-11-13 18:40:49 +01:00
1 Configuration Basics
Fredrick Brennan edited this page 2018-07-27 18:46:46 +08:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Its important that you read this page and dont just assume its okay to make changes to inc/config.php; its not. inc/config.php is used only to hold default values. Its updated very frequently, so placing your local configuration there would make upgrading a very complicated process.

Instead, edit inc/instance-config.php.

Config files

Vichan is made up of multiple configuration files:

  • inc/config.php — These are the defaults. Do not edit this file or you will have a very hard time upgrading in the future.
  • inc/instance-config.php — Make all your site-wide changes here. This file is generated upon installation.
  • <board>/config.php — Optional board-specific configuration files can also be made. These files dont exist by default.

The syntax for inc/instance-config.php and <board>/config.php is exactly the same to that of inc/config.php. You can copy lines from config.php and place them in either one of these config files. That is what config.php is for.

The configuration variable ($config) is just one huge associative array, occasionally split into “sections”. Loading order

Its important to understand how the configuration files work to get the most out of Vichan.

  • inc/config.php — $config is reset with the defaults.
  • inc/instance-config.php — Some $config values are overwritten or changed.
  • <board>/config.php — If it exists, some more $config values are overwritten.

Comments

The comments in inc/config.php are probably the greatest source of documentation. It is filled with descriptions for specific config variables as well as examples, for you to copy into inc/instance-config.php and modify.

This page originated from the Tinyboard wiki. Source