1
0
mirror of https://github.com/vichan-devel/vichan.git synced 2024-11-30 18:24:29 +01:00

Created Configuration Basics (markdown)

Fredrick Brennan 2018-07-27 18:46:46 +08:00
parent 04dc693b13
commit 2197a4aa4c

28
Configuration-Basics.md Normal file

@ -0,0 +1,28 @@
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](http://web.archive.org/web/20121003095922/http://tinyboard.org/docs/?p=Config)_