Documentation: control/configure.php

control/configure.php - Change YACS main parameters (database, language, etc.)

Use this script to change database and other essential parameters of this server.

Access to this page is reserved to associates. Moreover, the current surfer is considered as an associate in any of following situations:

there is no configuration file and no switch file
there is no connection to the database and no switch file

Configuration information is saved into shared/parameters.include.php. If YACS is prevented to write to the file, it displays parameters to allow for a manual update.

The file shared/parameters.include.php.bak can be used to restore the active configuration before the last change.

If the file demo.flag exists, the script assumes that this instance of YACS runs in demonstration mode. In this mode the edit form is not displayed at all to protect database passwords.

Database parameters:

* database_server - database host name or IP address

* database_user - account to use to connect to the database

* database_password - to authenticate to the database server

* database - the name of the database to use

* table_prefix - the prefix for all tables used for this YACS instance

* users_database_server - only for user records - database host name or IP address

* users_database_user - only for user records - account to use to connect to the database

* users_database_password - only for user records - to authenticate to the database server

* users_database - only for user records - the name of the database to use

* users_table_prefix - only for user records - the prefix for the users table

System parameters:

* url_to_root - The absolute path to YACS scripts. The default value is '/yacs/'.

* preferred_language - The two-letter ISO code representing the language to be used for auto-generated text, such as background e-mail message, etc. Default value is 'en'.

* without_language_detection - By default YACS attempts to localize its interface depending on browser data. In some situations you may prefer to turn this parameter to 'Y', and to stick with the preferred language only.

* with_compression - By default page content is transferred 'as-is' to user agents. If this parameter is set explicitly to 'Y', YACS will attempt to compress every HTML and XML content. You should depart from the default mode if the HTTP service does not feature compression.

* without_cache - Normally YACS uses partial caching techniques to speed up page rendering. However sometimes it can be useful to disable this feature.

* with_cron - By default YACS attempts to add background processing to page rendering. If you have explicitly configured your server to trigger cron.php instead, you can set the parameter with_cron to 'Y' to save some CPU cycles.

* with_debug - By default YACS runs in production mode. However, at development site you can turn this parameter to 'Y' to get more information. For example, PHP is reconfigured to display all messages, including notices and warnings.

Inbound HTTP parameters:

* without_http_cache - By default YACS handles ETag and Last-Modified HTTP headers to help proxies and browsers cache provided information. However sometimes it can be useful to disable this feature.

* with_friendly_urls - By default pages are referenced using query strings (e.g;, articles/view.php?id=123). In numerous cases you can activate friendly URLS to let surfers and spiders reference your pages more easily (e.g;, articles/view.php/123).

Outbound HTTP parameters:

* without_outbound_http - By default YACS connects to other web servers. Change this parameter to 'Y' to disable this feature.

* proxy_server - if the infrastructure requires a proxy for external HTTP requests

* proxy_user - the account to be used against the proxy

* proxy_password - authentication data

Outbound e-mail parameters:

* with_email - the sending of e-mail messages has to be explicitly activated. By default YACS does not send messages.

* mail_smtp_server - host name or IP address of the server that will process our SMTP requests. There is no default value.

* mail_from - the account used to send messages There is no default value.

* mail_logger_recipient - one address, or a comma-separated list of addresses, that will receive event messages. There is no default value.

* mail_pop3_server, mail_pop3_user, and mail_pop3_password - data used for POP3 authentication before SMTP sending. There is no default values. These are required at ovh for SMTP to take place.

* debug_mail - if set to 'Y', save titles and recipients of sent messages into agents/debug.txt

Skin selection:

* skin - while YACS is able to support several skins, one of them will be privileged. Default value is 'skeleton'.

Password of last resort:

* password_of_last_resort - A pass phrase to be authenticated as an associate. This parameter cannot be set through a web form. The only way to set a password of last resort is to edit manually the main configuration file, shared/parameters.include.php. To suppress the password of last resort you can simply use this configuration panel, which will rewrite the configuration file.

This script is a reference file of this system.

Licence: GNU Lesser General Public License

Auteurs:

Bernard Paques bernard.paques@bigfoot.com

Testeurs:

Jan Boen
Kedare
Timster

Reste à faire:

support alias mail addresses with < and > (GnapZ)