Bitrix Site Manager

Kernel settings

This topic provide a summary of system settings available to site administrators.

List of settings

The following is the list of system-wide settings, in the order as displayed by the Kernel module settings form.

Description of settings

Title: Allow the users to self-register
ID: new_user_registration
Description: If this parameter is set ("Y"), the Registration link will be avaulable ib the standard components:
  • /main/auth/authorize.php
  • /main/auth/authorize_registration.php
Default value: Y
Title: Upon registration, add to group
ID: new_user_registration_def_group
Description: Specifies groups to which a user is automatically added after the registration (using methods CUser::Register, CUser::SimpleRegister).
Default value: 2 (the Everyone group)
Title: Allow authorization caching
ID: store_password
Description: If this parameter is set ("Y"), and if a user selects Remember me at the time of authorization, the user authorization will be stored in his cookie. This parameter is also used to show or hide the  Remember me check box in the standard components:
  • /main/auth/authorize.php
  • /main/auth/auth_form.php
  • /main/auth/authorize_registration.php
Default value: Y
Title: Use secure storing of the authorization data in cookies
ID: use_secure_password_cookies
Description: If the parameter Allow authorization caching is set ("Y"), this parameter specifies the type of cookie in which the authorization is to be stored. If this parameter is checked ("Y"), the authorization cookie is created as secure, which implies automatic authorization for the secure connections (HTTPS) only.
Default value: N
Title: One or comma-separated list of E-mail addresses to receive copies of all the outcoming messages
ID: all_bcc
Description: E-mail address or a list of comma-separated addresses to which all the outcoming messages are duplicated.
Default value:
Title: Send email event and template identifiers in message
ID: send_mid
Description: If this parameter is set ("Y"), the following line is appended to the message body:
MID: EVENT_ID.TEMPLATE_ID (DATE_EVENT)
where:
  • EVENT_ID - mail event ID;
  • TEMPLATE_ID - mail template ID;
  • DATE_EVENT - date of the mail event creation.
Default value: N
Title: E-mail address in caption
ID: fill_to_mail
Description: If this parameter is set ("Y"), the "To" field is copied to the message header.
Default value: N
Title: E-mail of site administrator (default sender address)
ID: email_from
Description: This field usually contains the site administrator e-mail address. This address is available for mail templates as #DEFAULT_EMAIL_FROM#.
Default value: "admin@".$_SERVER["SERVER_NAME"]
Title: Convert Unix new line symbols to Windows format during email sending
ID: CONVERT_UNIX_NEWLINE_2_WINDOWS
Description: Setting this parameter to "Y" causes all new line symbols (aka carriage return, CR, \n) to be converted to the pair "line feed (LF)"+"new line" (\r\n).

This may be needed in situations when a site has been originally developed for the Unix server (with the new line symbol set to \n), but later ported to the Windows server (with the new line symbol set to a pair of \r\n). But as the RFC 2822 standard forbids the use of single \n or \r in e-mail messages, the mail server may cause errors when parsing e-mail messages.
Default value: N (do not convert)
Title: Convert 8-bit characters in the message header
ID: convert_mail_header
Description: According to the RFC 2822 standard, the message header ("To", "From", "Subject", "CC", "BCC" and other fields) may only contain characters with codes from 33 (100001) to 126 (1111110) (Latin letters, digits, punctuation marks); these symbols use the lower 7 bits of a byte. Symbols that use the bit 8 (128 and greater), are called 8-bit symbols. The RFC 2822 standard forbids their use in the message header. Many mail servers do not support 8-bit symbols in the message header.

Therefore, if you use 8-bit symbols (e.g. national) in the header, you have to set this parameter to "Y", which will convert 8-bit symbols to the "MIME base64" format used to transfer binary data in systems that do not support 8-bit symbols .
Default value: Y (perform conversion)
Title: Site name
ID: site_name
Description: Specifies the default site name (the field Site name in the site settings). Used in mail templates in the field #SITE_NAME#.
Default value: the value of the standard PHP variable $_SERVER["SERVER_NAME"]
Title: Site url(without http://). E.g., www.mysite.com
ID: server_name
Description: This parameter specifies the default value of the site address (the field Server URL in the site settings). Used in mail templates in the field #SERVER_NAME#.
Default value: the value of the standard PHP variable $_SERVER["SERVER_NAME"]
Title: Name of system update server
ID: update_site
Description: URL of the update server.
Default value: www.bitrixsoft.com
Title: Cookie name prefix
ID: cookie_name
Description: Prefix of the cookie names set by this portal.
Default value: BITRIX_SM
Title: File upload default folder
ID: upload_dir
Description: Any subdirectory of the DocumentRoot directory in which the files uploaded using CFile::SaveFile are contained. This parameter is extensively used by the CFile class methods. Uploaded files are those uploaded through the HTML forms, except file that can be uploaded to any folder using Site Explorer -> Explore -> Upload File.
Default value: upload
Title: Replace status 200 with 404 in header
ID: header_200
Description: If this parameter is set ("Y"), the status 200 (OK) will be sent every time a "page not found" (404) error occurs. This parameter is generally used for search engine robots when building services on the 404 error. For example, it can be used to create "nice addresses" without parameters (e.g. /news/345.php).
Default value: Y
Title: Menu type for the top level of the site map
ID: map_top_menu_type
Description: This parameter is used by the standard component /main/map/default.php used to display a site map. Stores the type of menu to be taken as the starting level of the site map.
Default value: top
Title: Menu type for other levels of the site map
ID: map_left_menu_type
Description: This parameter is used by the standard component /main/map/default.php used to display a site map. Stores the type of menu whose items are used to build the site map (after the starting level).
Default value: left
Title: Error report mode
ID: error_reporting
Description: This parameter is used in the prologue service section to set the PHP error and warning levels.
Default value: Errors only (E_COMPILE_ERROR|E_ERROR|E_CORE_ERROR|E_PARSE)
Title: Global authentication for all site domains
ID: auth_multisite
Description: If this parameter is set ("Y"), the user authorization (stored in cookie or session) will be spread among all domains of all sites of the portal.
Default value: N
Title: Keep the original names for uploaded files
ID: save_original_file_name
Description: Setting this parameter to "Y" causes the names of uploaded files to be left as is. Otherwise, their names will be replaced with the MD5 hash string.
Default value: N
Title: Automatically replace invalid symbols in the names of uploaded files
ID: convert_original_file_name
Description: If this parameter is set ("Y"), all invalid symbols which are not Latin letters, digits, dashes, underscores and dots will be replaced with random valid symbols.
Default value: Y