[TASK] Caching framework db backend: Use own namespace
[Packages/TYPO3.CMS.git] / t3lib / config_default.php
1 <?php
2 /**
3 * TYPO3 default configuration
4 *
5 * TYPO3_CONF_VARS is a global array with configuration for the TYPO3 libraries
6 * THESE VARIABLES MAY BE OVERRIDDEN FROM WITHIN localconf.php
7 *
8 * 'IM' is short for 'ImageMagick', which is an external image manipulation package available from www.imagemagick.org. Version is ABSOLUTELY preferred to be 4.2.9, but may be 5+. See the install notes for TYPO3!!
9 * 'GD' is short for 'GDLib/FreeType', which are libraries that should be compiled into PHP4. GDLib <=1.3 supports GIF, while the latest version 1.8.x and 2.x supports only PNG. GDLib is available from www.boutell.com/gd/. Freetype has a link from there.
10 * Revised for TYPO3 3.6 2/2003 by Kasper Skårhøj
11 *
12 * @author Kasper Skårhøj <kasperYYYY@typo3.com>
13 */
14
15 if (!defined ('PATH_typo3conf')) die ('The configuration path was not properly defined!');
16
17 //Security related constant: Default value of fileDenyPattern
18 define('FILE_DENY_PATTERN_DEFAULT', '\.(php[3-6]?|phpsh|phtml)(\..*)?$|^\.htaccess$');
19
20 //Security related constant: Comma separated list of file extensions that should be registered as php script file extensions
21 define('PHP_EXTENSIONS_DEFAULT', 'php,php3,php4,php5,php6,phpsh,inc,phtml');
22
23 // Defines a list that are basically required by a TYPO3 system.
24 define('REQUIRED_EXTENSIONS', 'cms,lang,sv,em,recordlist');
25
26 $TYPO3_CONF_VARS = array(
27 'GFX' => array( // Configuration of the image processing features in TYPO3. 'IM' and 'GD' are short for ImageMagick and GD library respectively.
28 'image_processing' => TRUE, // Boolean: Enables image processing features. Disabling this means NO image processing with either GD or IM!
29 'thumbnails' => TRUE, // Boolean: Enables the use of thumbnails in the backend interface. Thumbnails are generated by IM/partly GD in the file typo3/thumbs.php
30 'thumbnails_png' => 0, // Bits. Bit0: If set, thumbnails from non-jpegs will be 'png', otherwise 'gif' (0=gif/1=png). Bit1: Even JPG's will be converted to png or gif (2=gif/3=png)
31 'gif_compress' => TRUE, // Boolean: Enables the use of the t3lib_div::gif_compress() workaround function for compressing giffiles made with GD or IM, which probably use only RLE or no compression at all.
32 'imagefile_ext' => 'gif,jpg,jpeg,tif,tiff,bmp,pcx,tga,png,pdf,ai', // Commalist of file extensions perceived as images by TYPO3. List should be set to 'gif,png,jpeg,jpg' if IM is not available. Lowercase and no spaces between!
33
34 'gdlib' => TRUE, // Boolean: Enables the use of GD.
35 'gdlib_png' => FALSE, // Boolean: Enables the use of GD, with PNG only. This means that all items normally generated as gif-files will be png-files instead!
36
37 'im' => TRUE, // Boolean: Enables the use of IM.
38 'im_path' => '/usr/bin/', // Path to the IM tools 'convert', 'combine', 'identify'.
39 'im_path_lzw' => '/usr/bin/', // Path to the IM tool 'convert' with LZW enabled! See 'gif_compress'. If your version 4.2.9 of ImageMagick is compiled with LZW you may leave this field blank AND disable the flag 'gif_compress'! Tip: You can call LZW 'convert' with a prefix like 'myver_convert' by setting this path with it, eg. '/usr/bin/myver_' instead of just '/usr/bin/'.
40
41 'im_version_5' => 'im6', // String: Set this either to "im6" or "gm" (uses GraphicsMagick instead of ImageMagick). Setting this value will automatically configure some settings for use with the specified program version.
42 'im_negate_mask' => FALSE, // Boolean: Indicates if the mask images should be inverted first. This depends of the ImageMagick version. Below ver. 5.1 this should be FALSE. Above ImageMagick version 5.2+ it should be TRUE. Just set the flag if the masks works opposite the intension!
43 'im_imvMaskState' => FALSE, // Boolean: If set, the 'im_negate_mask' state is inverted. This is very useful with newer versions of IM5 (at least 5.4.3+) where the 'im_version_5' setting will set 'im_negate_mask' which will eventually be wrong... Halleluja for ImageMagick - have I ever regreted using that package...
44 'im_no_effects' => FALSE, // Boolean: This is necessary if using ImageMagick 5+. Effects in Imagemagick 5+ tends to render very slowly! Therefore this must be disabled in order not to perform sharpen, blurring and such. (However lately IM5 is allowed for effects again, but syntax has changed!)
45 'im_v5effects' => 0, // <p>Integer (-1, 0, 1)</p><dl><dt>0</dt><dd>disabled</dd><dt>-1</dt><dd>Do not sharpen images by default</dd><dt>1</dt><dd>All; blur and sharpening is allowed in ImageMagick again and the 'im_no_effects' flag is cancelled.</dd></dl><p>Blurring and sharpening has new syntaxes though. See class.t3lib_stdgraphic.php for details.</p>
46 'im_mask_temp_ext_gif' => FALSE, // Boolean: This should be set if ImageMagick is version 5+. This is used in class.tslib_content.php for masking images and the extension png is normally used because it's faster than gif for temporary files. But png seems not to work with some IM 5+ versions, so...
47 'im_mask_temp_ext_noloss' => 'miff', // String: Loss-less ImageMagick extension to use for mask processing in temporary filenames. Normally 'miff' (ImageMagick's OWN format) will do fine. However at least IM 5.4.9 has proved not to be able to write to its own file format which forced me to add this option. You can try and set this to tif/png/jpg if some masking doesn't work the way it should.
48 'im_noScaleUp' => FALSE, // Boolean: If set, images are not being scaled up if told so (in t3lib/stdgraphics.php)
49 'im_combine_filename' => 'combine', // String: Latest ImageMagick versions has changed the name of combine to composite. Configure here if needed.
50 'im_noFramePrepended' => FALSE, // Boolean: If set, the [x] frame indicator is NOT prepended to filenames in stdgraphic. Some IM5+ version didn't work at all with the typical [0]-prefix, which allow multipage pdf's and animated gif's to be scaled only for the first frame/page and that seriously cuts down rendering time. Set this flag only if your ImageMagick version cannot find the files. Notice that changing this flag causes temporary filenames to change, thus the server will begin scaling images again which were previously cached.
51 'im_stripProfileCommand' => '+profile \'*\'', // String: Specify the command to strip the profile information, which can reduce thumbnail size up to 60KB. Command can differ in IM/GM, IM also know the -strip command. See <a href="http://www.imagemagick.org/Usage/thumbnails/#profiles" target="_blank">imagemagick.org</a> for details
52 'im_useStripProfileByDefault' => TRUE, // Boolean: If set, the im_stripProfileCommand is used with all IM Image operations by default. See tsRef for setting this parameter explocit for IMAGE generation.
53 'jpg_quality' => 70, // Integer: Default JPEG generation quality
54 'enable_typo3temp_db_tracking' => FALSE, // Boolean: If set, then all files in typo3temp will be logged in a database table. In addition to being a log of the files with original filenames, it also serves to secure that the same image is not rendered simultaneously by two different processes.
55 'TTFdpi' => 72, // Integer: Enter how many dpi the FreeType module uses. Freetype1 should be set to 72. Freetype2 should be set to 96 (otherwise fonts are rendered way bigger than FreeType1). This works as a global scaling factor for Freetype.
56 'png_truecolor' => FALSE, // Boolean: If set PNGs will get created as truecolor PNGs. If you use GDlib2 you can create truecolor images if they look not well currently. Note that this results in an increased image size. JPEGs get always created in truecolor now (GDlib2 required)
57 ),
58 'SYS' => array( // System related concerning both frontend and backend.
59 'lang' => array(
60 'format' => array(
61 'priority' => 'xlf,xml,php'
62 ),
63 'parser' => array(
64 'php' => 'tx_lang_parser_Llphp',
65 'xml' => 'tx_lang_parser_Llxml',
66 'xlf' => 'tx_lang_parser_Xliff',
67 ),
68 ),
69 'sitename' => 'TYPO3', // Name of the base-site. This title shows up in the root of the tree structure if you're an 'admin' backend user.
70 'compat_version' => '3.8', // Compatibility version. TYPO3 behavior will try to be compatible with the output from the TYPO3 version set here. It is recommended to change this setting with the Upgrade Wizard.
71 'encryptionKey' => '', // This is a "salt" used for various kinds of encryption, CRC checksums and validations. You can enter any rubbish string here but try to keep it secret. You should notice that a change to this value might invalidate temporary information, URLs etc. At least, clear all cache if you change this so any such information can be rebuild with the new key.
72 'cookieDomain' => '', // Restricts the domain name for FE and BE session cookies. When setting the value to ".domain.com" (replace domain.com with your domain!), login sessions will be shared across subdomains. Alternatively, if you have more than one domain with sub-domains, you can set the value to a regular expression to match against the domain of the HTTP request. The result of the match is used as the domain for the cookie. eg. /\.(example1|example2)\.com$/ or /\.(example1\.com)|(example2\.net)$/. Separate domains for FE and BE can be set using <a href="#FE-cookieDomain">$TYPO3_CONF_VARS['FE']['cookieDomain']</a> and <a href="#BE-cookieDomain">$TYPO3_CONF_VARS['BE']['cookieDomain']</a> respectively.
73 'cookieSecure' => 0, // <p>Integer (0, 1, 2): Indicates that the cookie should only be transmitted over a secure HTTPS connection from the client.</p><dl><dt>0</dt><dd>always send cookie</dd><dt>1 (force HTTPS)</dt><dd>the cookie will only be set if a secure (HTTPS) connection exists - use this in combination with lockSSL since otherwise the application will fail and throw an exception</dd><dt>2</dt><dd>the cookie will be set in each case, but uses the secure flag if a secure (HTTPS) connection exists.</dd></dl>
74 'cookieHttpOnly' => FALSE, // Boolean: When enabled the cookie will be made accessible only through the HTTP protocol. This means that the cookie won't be accessible by scripting languages, such as JavaScript. This setting can effectively help to reduce identity theft through XSS attacks (although it is not supported by all browsers).
75 'doNotCheckReferer' => FALSE, // Boolean: If set, it's NOT checked numerous places that the refering host is the same as the current. This is an option you should set if you have problems with proxies not passing the HTTP_REFERER variable.
76 'recursiveDomainSearch' => FALSE, // Boolean: If set, the search for domain records will be done recursively by stripping parts of the host name off until a matching domain record is found.
77 'devIPmask' => '127.0.0.1,::1', // Defines a list of IP addresses which will allow development-output to display. The debug() function will use this as a filter. See the function t3lib_div::cmpIP() for details on syntax. Setting this to blank value will deny all. Setting to "*" will allow all.
78 'sqlDebug' => 0, // <p>Integer (0, 1, 2). Allows displaying executed SQL queries in the browser (for debugging purposes and development)</p><dl><dt>0</dt><dd>no SQL shown (default)</dd><dt>1</dt><dd>show only failed queries</dd><dt>2</dt><dd>show all queries</dd></dl>
79 'enable_DLOG' => FALSE, // Boolean: Whether the developer log is enabled. See constant "TYPO3_DLOG"
80 'ddmmyy' => 'd-m-y', // Format of Date-Month-Year - see PHP-function <a href="http://php.net/date" target="_blank">date()</a>
81 'hhmm' => 'H:i', // Format of Hours-Minutes - see PHP-function <a href="http://php.net/date" target="_blank">date()</a>
82 'USdateFormat' => FALSE, // Boolean: If TRUE, dates entered in the TCEforms of the backend will be formatted mm-dd-yyyy
83 'loginCopyrightWarrantyProvider' => '', // String: If you provide warranty for TYPO3 to your customers insert you (company) name here. It will appear in the login-dialog as the warranty provider. (You must also set URL below).
84 'loginCopyrightWarrantyURL' => '', // String: Add the URL where you explain the extend of the warranty you provide. This URL is displayed in the login dialog as the place where people can learn more about the conditions of your warranty. Must be set (more than 10 chars) in addition with the 'loginCopyrightWarrantyProvider' message.
85 'loginCopyrightShowVersion' => FALSE, // Boolean: If set, the current TYPO3 version is shown.
86 'curlUse' => FALSE, // Boolean: If set, try to use cURL to fetch external URLs
87 'curlProxyServer' => '', // String: Proxyserver as http://proxy:port/.
88 'curlProxyTunnel' => FALSE, // Boolean: If set, use a tunneled connection through the proxy (usefull for websense etc.).
89 'curlProxyUserPass' => '', // String: Proxyserver authentication user:pass.
90 'curlTimeout' => 0, // Integer: Timeout value for cURL requests in seconds. 0 means to wait indefinitely.
91 'form_enctype' => 'multipart/form-data', // String: This is the default form encoding type for most forms in TYPO3. It allows for file uploads to be in the form. However if file-upload is disabled for your PHP version even ordinary data sent with this encryption will not get to the server. So if you have file_upload disabled, you will have to change this to eg. 'application/x-www-form-urlencoded'
92 'textfile_ext' => 'txt,html,htm,css,tmpl,js,sql,xml,csv,' . PHP_EXTENSIONS_DEFAULT, // Text file extensions. Those that can be edited. Executable PHP files may not be editable in webspace if disallowed!
93 'contentTable' => '', // This is the page-content table (Normally 'tt_content')
94 'T3instID' => 'N/A', // A unique installation ID - not used yet. The idea is that a TYPO3 installation can identify itself by this ID string to the Extension Repository on TYPO3.org so that we can keep a realistic count of serious TYPO3 installations.
95 'binPath' => '', // String: List of absolute paths where external programs should be searched for. Eg. <code>/usr/local/webbin/,/home/xyz/bin/</code>. (ImageMagick path have to be configured separately)
96 'binSetup' => '', // String (textarea): List of programs (separated by newline or comma). By default programs will be searched in default paths and the special paths defined by 'binPath'. When PHP has openbasedir enabled the programs can not be found and have to be configured here. Example: <code>perl=/usr/bin/perl,unzip=/usr/local/bin/unzip</code>
97 't3lib_cs_convMethod' => '', // String (values: "iconv", "recode", "mbstring", default is homemade PHP-code). Defines which of these PHP-features to use for various charset conversion functions in t3lib_cs. Will speed up charset conversion radically.
98 't3lib_cs_utils' => '', // String (values: "iconv", "mbstring", default is homemade PHP-code). Defines which of these PHP-features to use for various charset processing functions in t3lib_cs. Will speed up charset functions radically.
99 'no_pconnect' => TRUE, // Boolean: If TRUE, "connect" is used instead of "pconnect" when connecting to the database!
100 'multiplyDBfieldSize' => 1, // Double: 1-5: Amount used to multiply the DB field size when the install tool is evaluating the database size (eg. "2.5"). This is only useful e.g. if your database is ISO-8859-1 encoded but you want to use UTF-8 for your site. For Western European sites using UTF-8 the need should not be for more than twice the normal single-byte size (2) and for Chinese / Asian languages 3 should suffice. NOTICE: It is recommended to change the native database charset instead! (see <a href="http://wiki.typo3.org/index.php/UTF-8_support" target="_blank">TYPO3 wiki: UTF-8 support</a> for more information). NOTICE: This option is deprecated since TYPO3 4.5, and will not be used anymore in 4.7+. Please use proper tools to set your installation to native UTF-8.
101 'setDBinit' => '-1', // String (textarea): Commands to send to database right after connecting, separated by newline. Ignored by the DBAL extension except for the 'native' type!
102 'dbClientCompress' => FALSE, // Boolean: if TRUE, data exchange between TYPO3 and database server will be compressed. This may improve performance if (1) database serever is on the different server and (2) network connection speed to database server is 100mbps or less. CPU usage will be higher if this option is used but database operations will be executed faster due to much less (up to 3 times) database network traffic. This option has no effect if MySQL server is localhost.
103 'setMemoryLimit' => 0, // Integer: memory_limit in MB: If more than 16, TYPO3 will try to use ini_set() to set the memory limit of PHP to the value. This works only if the function ini_set() is not disabled by your sysadmin.
104 'forceReturnPath' => FALSE, // Boolean: <em>Note: This option is deprecated as of TYPO3 4.5 together with t3lib_htmlmail. This behaviour is the default using the new t3lib_mail methods.</em> Force return path to be applied in mail() calls. If this is set, all calls to mail() done by t3lib_htmlmail will be called with '-f&lt;return_path&gt; as the 5th parameter. This will make the return path correct on almost all Unix systems. There is a known problem with Postfix below version 2: Mails are not sent if this option is set and Postfix is used. On Windows platforms, the return path is set via a call to ini_set.
105 'serverTimeZone' => 1, // Integer: GMT offset of servers time (from time()). Default is "1" which is "GMT+1" (central european time). This value can be used in extensions that are GMT aware and wants to convert times to/from other timezones.
106 'phpTimeZone' => '', // String: timezone to force for all date() and mktime() functions. A list of supported values can be found at <a href="http://php.net/manual/en/timezones.php" target="_blank">php.net</a>. If this is not set, a valid fallback will be searched for by PHP (php.ini's <a href="http://www.php.net/manual/en/datetime.configuration.php#ini.date.timezone" target="_blank">date.timezone</a> setting, server defaults, etc); and if no fallback is found, the value of "UTC" is used instead.
107 'systemLog' => '', // <p>String: semi-colon separated list. Defines one or more logging methods. Possible methods:</p><dl><dt>file,&lt;abs-path-to-file&gt;[,&lt;level&gt;]</dt><dd>logs to a file</dd><dt>mail,&lt;to&gt;[/&lt;from&gt;][,&lt;level&gt;]</dt><dd>sends the log entries via mail</dd><dt>syslog,&lt;facility&gt;,[,&lt;level&gt;]</dt><dd>uses the operating system's log. Facility may be one of LOCAL0..LOCAL7, USER (on Windows USER is the only valid type).</dd><dt>error_log[,,&lt;level&gt;]</dt><dd>uses the PHP error log</dd></dl><p>The &lt;level&gt; is the individual logging level (see <a href="#SYS-systemLogLevel">[SYS][systemLogLevel]</a>).</p>
108 'systemLogLevel' => 0, // <p>Integer (0, 1, 2, 3, 4): Only messages with same or higher severity are logged.</p><ul><li>0: info</li><li>1: notice</li><li>2: warning</li><li>3: error</li><li>4: fatal error</li></ul>
109 'enableDeprecationLog' => 'file', // Commalist: Enables the logging of deprecated methods and functions. Default is 'file'. The following options are allowed: 'file': The log file will be written to typo3conf/deprecation_[hash-value].log 'devlog': The log will be written to the development log 'console': The log will be displayed in the Backend's Debug Console. The logging options can be combined by comma-separating them.
110 'maxFileNameLength' => 60, // Integer: This is the maximum file name length. The value will be taken into account by basic file operations like renaming or creation of files and folders.
111 'UTF8filesystem' => FALSE, // Boolean: If TRUE and <a href="#BE-forceCharset">[BE][forceCharset]</a> is set to utf-8, then TYPO3 uses utf-8 to store file names. This allows for accented Latin letters as well as any other non-latin characters like Cyrillic and Chinese.
112 'systemLocale' => '', // String: locale used for certain system related functions; for example escaping shell commands.
113 'lockingMode' => 'simple', // String: Define which locking mode is used to control requests to pages being generated. Can be one of either "disable" (no locking), "simple" (checks for file existance), "flock" (using PHPs <a href="http://php.net/flock" target="_blank">flock()</a> function), "semaphore" (using PHPs <a href="http://php.net/sem-acquire" target="_blank">sem_acquire()</a> function). Default is "disable".
114 'reverseProxyIP' => '', // String: list of IP addresses. If TYPO3 is behind one or more (intransparent) reverese proxies the IP addresses must be added here.
115 'reverseProxyHeaderMultiValue' => 'none', // String: "none","first","last": defines which values of a proxy header (eg HTTP_X_FORWARDED_FOR) to use, if more than one is found. "none" discards the value, "first" and "last" use the first/last of the values in the list.
116 'reverseProxyPrefix' => '', // String: optional prefix to be added to the internal URL (SCRIPT_NAME and REQUEST_URI).
117 'reverseProxySSL' => '', // String: '*' or list of IP addresses of proxies that use SSL (https) for the connection to the client, but an unencrypted connection (http) to the server. If '*' all proxies defined in <a href="#SYS-reverseProxyIP">[SYS][reverseProxyIP]</a> use SSL.
118 'reverseProxyPrefixSSL' => '', // String: prefix to be added to the internal URL (SCRIPT_NAME and REQUEST_URI) when accessing the server via an SSL proxy. This setting overrides <a href="#SYS-reverseProxyPrefix">[SYS][reverseProxyPrefix]</a>.
119 'caching' => array(
120 'cacheFrontends' => array(
121 't3lib_cache_frontend_VariableFrontend' => 't3lib_cache_frontend_VariableFrontend',
122 't3lib_cache_frontend_StringFrontend' => 't3lib_cache_frontend_StringFrontend',
123 't3lib_cache_frontend_PhpFrontend' => 't3lib_cache_frontend_PhpFrontend',
124 ),
125 'cacheBackends' => array(
126 't3lib_cache_backend_DbBackend' => 't3lib_cache_backend_DbBackend',
127 't3lib_cache_backend_FileBackend' => 't3lib_cache_backend_FileBackend',
128 't3lib_cache_backend_MemcachedBackend' => 't3lib_cache_backend_MemcachedBackend',
129 't3lib_cache_backend_PdoBackend' => 't3lib_cache_backend_PdoBackend',
130 't3lib_cache_backend_RedisBackend' => 't3lib_cache_backend_RedisBackend',
131 't3lib_cache_backend_ApcBackend' => 't3lib_cache_backend_ApcBackend',
132 't3lib_cache_backend_NullBackend' => 't3lib_cache_backend_NullBackend',
133 't3lib_cache_backend_TransientMemoryBackend' => 't3lib_cache_backend_TransientMemoryBackend',
134 ),
135 'cacheConfigurations' => array(
136 'cache_hash' => array(
137 'frontend' => 't3lib_cache_frontend_VariableFrontend',
138 'backend' => 't3lib_cache_backend_DbBackend',
139 'options' => array(),
140 ),
141 'cache_pages' => array(
142 'frontend' => 't3lib_cache_frontend_VariableFrontend',
143 'backend' => 't3lib_cache_backend_DbBackend',
144 'options' => array(),
145 ),
146 'cache_pagesection' => array(
147 'frontend' => 't3lib_cache_frontend_VariableFrontend',
148 'backend' => 't3lib_cache_backend_DbBackend',
149 'options' => array(),
150 )
151 )
152 ),
153 'useCachingFramework' => FALSE, // Boolean: Enable this if you want to use the caching framework by default for the core caches cache_pages, cache_pagesection and cache_hash.
154 'displayErrors' => -1, // <p>Integer (-1, 0, 1, 2). Configures whether PHP errors should be displayed.</p><dl><dt>0</dt><dd>Do not display any PHP error messages. Overrides the value of "exceptionalErrors" and sets it to 0 (= no errors are turned into exceptions), the configured "productionExceptionHandler" is used as exception handler</dd><dt>1</dt><dd>Display error messages with the registered errorhandler. The configured "debugExceptionHandler" is used as exception handler</dd><dt>2</dt><dd>Display errors only if client matches <a href="#SYS-devIPmask">[SYS][devIPmask]</a>. If devIPmask matches the users IP address the configured "debugExceptionHandler" is used for exceptions, if not "productionExceptionHandler" will be used</dd><dt>-1</dt><dd>Default setting. With this option, you can override the PHP setting "display_errors". If devIPmask matches the users IP address the configured "debugExceptionHandler" is used for exceptions, if not "productionExceptionHandler" will be used.</dd></dl>
155 'productionExceptionHandler' => 't3lib_error_ProductionExceptionHandler', // String: Classname to handle exceptions that might happen in the TYPO3-code. Leave empty to disable exception handling. Default: "t3lib_error_ProductionExceptionHandler". This exception handler displays a nice error message when something went wrong. The error message is logged to the configured logs. Note: The configured "productionExceptionHandler" is used if displayErrors is set to "0" or to "-1" and devIPmask doesn't match the users IP.
156 'debugExceptionHandler' => 't3lib_error_DebugExceptionHandler', // String: Classname to handle exceptions that might happen in the TYPO3-code. Leave empty to disable exception handling. Default: "t3lib_error_DebugExceptionHandler". This exception handler displays the complete stack trace of any encountered exception. The error message and the stack trace is logged to the configured logs. Note: The configured "debugExceptionHandler" is used if displayErrors is set to "1" and if displayErrors is "-1" or "2" and the devIPmask matches the users IP.
157 'errorHandler' => 't3lib_error_ErrorHandler', // String: Classname to handle PHP errors. E.g.: t3lib_error_ErrorHandler. This class displays and logs all errors that are registered as "errorHandlerErrors" (<a href="#SYS-errorHandlerErrors">[SYS][errorHandlerErrors]</a>). Leave empty to disable error handling. Errors can be logged to syslog (see: <a href="#SYS-systemLog">[SYS][systemLog]</a>) to the installed developer log and to the "syslog" table. If an error is registered in "exceptionalErrors" ([SYS][exceptionalErrors]) it will be turned into an exception to be handled by the configured exceptionHandler.
158 'errorHandlerErrors'=> E_ALL ^ E_NOTICE, // Integer: The E_* constant that will be handled by the errorhandler. Default is "E_ALL ^ E_NOTICE".
159 'exceptionalErrors' => E_ALL ^ E_NOTICE ^ E_WARNING ^ E_USER_ERROR ^ E_USER_NOTICE ^ E_USER_WARNING, // Integer: The E_* constant that will be handled as an exception by t3lib_error_ErrorHandler. Default is "E_ALL ^ E_NOTICE ^ E_WARNING ^ E_USER_ERROR ^ E_USER_NOTICE ^ E_USER_WARNING" (4341) and "0" if displayError=0. Some values for errors: E_ALL=6143, E_ALL ^ E_NOTICE ^ E_WARNING=6133. See php documentation for more details on this integer.
160 'enable_errorDLOG' => 0, // Boolean: If set, errors are written to the developer log (requires an installed *devlog* extension).
161 'enable_exceptionDLOG' => 0, // Boolean: If set, exceptions are written to the developer log (requires an installed *devlog* extension).
162 'syslogErrorReporting' => E_ALL ^ E_NOTICE, // Integer: Configures which PHP errors should be logged to the configured syslogs (see: [SYS][systemLog]). If set to "0" no PHP errors are logged to the syslog. Default is "E_ALL ^ E_NOTICE" (6135).
163 'belogErrorReporting' => E_ALL ^ E_NOTICE, // Integer: Configures which PHP errors should be logged to the "syslog" table (extension: belog). If set to "0" no PHP errors are logged to the sys_log table. Default is "E_ALL ^ E_NOTICE" (6135).
164 'locallangXMLOverride' => array(), // For extension/overriding of the arrays in 'locallang' files in frontend and backend. See 'Inside TYPO3' for more information.
165 'generateApacheHtaccess' => 1, // Boolean: TYPO3 can create <em>.htaccess</em> files which are used by Apache Webserver. They are useful for access protection or performance improvements. Currently <em>.htaccess</em> files in the following directories are created, if they do not exist: <ul><li>typo3temp/compressor/</li></ul>You want to disable this feature, if you are not running Apache or want to use own rulesets.
166 ),
167 'EXT' => array ( // Options related to the Extension Management
168 'noEdit' => TRUE, // Boolean: If set, the Extension Manager does NOT allow extension files to be edited! (Otherwise both local and global extensions can be edited.)
169 'allowGlobalInstall' => FALSE, // Boolean: If set, global extensions in typo3/ext/ are allowed to be installed, updated and deleted etc.
170 'allowLocalInstall' => TRUE, // Boolean: If set, local extensions in typo3conf/ext/ are allowed to be installed, updated and deleted etc.
171 'allowSystemInstall' => FALSE, // Boolean: If set, you can install extensions in the sysext/ dir. Use this to upgrade the 'cms' and 'lang' extensions.
172 'em_wsdlURL' => 'http://typo3.org/wsdl/tx_ter_wsdl.php', // The SOAP URL for uploading extensions to the TER2. Usually doesn't need to be changed.
173 'em_mirrorListURL' => 'http://repositories.typo3.org/mirrors.xml.gz', // Allows to preset the URL for fetching the extension repository mirror list from. Used in the Extension Manager.
174
175 'requiredExt' => '', // String. List of additional extensions which are REQUIRED and cannot be unloaded by the Extension Manager!
176 'ignoredExt' => '', // String. List of extensions to be ignored (not loaded), e.g. "em" can be disabled this way.
177 'excludeForPackaging' => '(CVS|\..*|.*~|.*\.bak)', // String: List of directories and files which will not be packaged into extensions nor taken into account otherwise by the Extension Manager. Perl regular expression syntax!
178 'extCache' => 1, // <p>Integer (0, 1, 2, 3)</p><dl><dt>0</dt><dd>ext-scripts (ext_localconf.php and ext_tables.php) are NOT cached, but included every time</dd><dt>1</dt><dd>scripts cached to typo3conf/temp_CACHED_[sitePathHash]* (saves some milliseconds even with PHP accelerators)</dd><dt>2</dt><dd>scripts cached and prefix includes a hash based on the 'extList' string</dd><dt>3</dt><dd>scripts cached to typo3conf/temp_CACHED_* (no hash included at all...)</dd></dl>
179 'extList' => 'filelist,version,tsconfig_help,context_help,extra_page_cm_options,impexp,belog,about,cshmanual,aboutmodules,setup,opendocs,install,t3editor,felogin,feedit,recycler', // String (exclude) List of extensions which are enabled for this install. Use the Extension Manager (EM) to manage this!
180 'extList_FE' => '', // String (exclude). Same as extList, but only this extensions are loaded in FE
181 'extConf' => array( // Config-options for extensions, stored as serialized arrays by extension-keys. Handled automatically by the EM.
182 // '--key--' => array()
183 ),
184 ),
185 'BE' => array( // Backend Configuration.
186 'lang' => array(
187 'degug' => FALSE, // Debug LL in the backend
188 ),
189 'unzip_path' => '', // Path to "unzip".
190 'diff_path' => 'diff', // Path to "diff". For Windows this program can be downloaded here: <a href="http://unxutils.sourceforge.net/" target="_blank">unxutils.sourceforge.net</a>
191 'fileadminDir' => 'fileadmin/', // Path to the fileadmin dir. This is relative to PATH_site. (Automatically mounted for admin-users if set)
192 'RTEenabled' => TRUE, // Boolean: If set, the Rich Text editor will be an option in the backend. Notice that the editor must be enabled per-user and options are configurable. See admin guide.
193 'RTE_imageStorageDir' => 'uploads/', // Default storage directory for Rich Text Editor files
194 'RTE_reg' => array(), // Contains arrays of possible RTEs available (keys=extKey, values=cfg-array). Each array contains a key, "objRef", which contains a user function call with prefixed script path and instanciating a persistent global object. This can report back if browser requirements are OK, draw the RTE and do the transformations needed.
195 'staticFileEditPath' => 'fileadmin/static/', // Path to directory with static files for editing (see table sys_staticfiles_edit). Relative to PATH_site.
196 'lockRootPath' => '', // This path is used to evaluate if paths outside of PATH_site should be allowed. Ending slash required! This path is also used to restrict userHomePath/groupHomePath. Observe that the first part of 'userHomePath' and 'groupHomePath' must be the value of 'lockRootPath'. Eg. '/home/typo3/'.
197 'userHomePath' => '', // Path to the directory where TYPO3 backend-users have their home-dirs. Eg. '/home/typo3/users/'. A home for backend user 2 would be: '/home/typo3/users/2/'. Ending slash required!
198 'groupHomePath' => '', // Path to the directory where TYPO3 backend-groups have their home-dirs. Remember that the first part of this path must be 'lockRootPath'. Eg. '/home/typo3/groups/'. A home for backend group 1 would be: '/home/typo3/groups/1/'. Ending slash required!
199 'userUploadDir' => '', // Suffix to the user home dir which is what gets mounted in TYPO3. Eg. if the user dir is "../123_user/" and this value is "/upload" then "../123_user/upload" gets mounted.
200 'fileCreateMask' => '0644', // File mode mask for Unix file systems (when files are uploaded/created).
201 'folderCreateMask' => '0755', // As above, but for folders.
202 'createGroup' => '', // Group for newly created files and folders (Unix only). Group ownership can be changed on Unix file systems (see above). Set this if you want to change the group ownership of created files/folders to a specific group. This makes sense in all cases where the webserver is running with a different user/group as you do. Create a new group on your system and add you and the webserver user to the group. Now you can safely set the last bit in fileCreateMask/folderCreateMask to 0 (e.g. 770). Important: The user who is running your webserver needs to be a member of the group you specify here! Otherwise you might get some error messages.
203 'warning_email_addr' => '', // Email address that will receive notification whenever an attempt to login to the Install Tool is made and that will also receive warnings whenever more than 3 failed backend login attempts (regardless of user) are detected within an hour.
204 'warning_mode' => '', // Bit 1: If set, warning_email_addr will be notified every time a backend user logs in. Bit 2: If set, warning_email_addr will be notified every time an ADMIN backend user logs in. Other bits are reserved for future options.
205 'lockIP' => 4, // Integer (0-4). Session IP locking for backend users. See <a href="#FE-lockIP">[FE][lockIP]</a> for details. Default is 4 (which is locking the FULL IP address to session).
206 'sessionTimeout' => 3600, // Integer: seconds. Session time out for backend users. Default is 3600 seconds = 1 hour.
207 'IPmaskList' => '', // String: Lets you define a list of IP-numbers (with *-wildcards) that are the ONLY ones allowed access to ANY backend activity. On error an error header is sent and the script exits. Works like IP masking for users configurable through TSconfig. See syntax for that (or look up syntax for the function t3lib_div::cmpIP())
208 'lockBeUserToDBmounts' => TRUE, // Boolean: If set, the backend user is allowed to work only within his page-mount. It's advisable to leave this on because it makes security easy to manage.
209 'lockSSL' => 0, // <p>Integer (0, 1, 2, 3). If &gt;0, If set (1,2,3), the backend can only be operated from an SSL-encrypted connection (https)</p><dl><dt>0</dt><dd>no locking (default)</dd><dt>1</dt><dd>only allow access via SSL</dd><dt>2</dt><dd>redirect user trying to access non-https admin-urls to SSL URLs instead</dd><dt>3</dt><dd>only the login is forced to SSL, then the user switches back to non-SSL-mode</dd></dl>
210 'lockSSLPort' => 0, // Integer: Use a non-standard HTTPS port for lockSSL. Set this value if you use lockSSL and the HTTPS port of your webserver is not 443.
211 'enabledBeUserIPLock' => TRUE, // Boolean: If set, the User/Group TSconfig option 'option.lockToIP' is enabled.
212 'lockHashKeyWords' => 'useragent', // Keyword list (Strings comma separated). Currently only "useragent"; If set, then the BE user session is locked to the value of HTTP_USER_AGENT. This lowers the risk of session hi-jacking. However in some cases (like during development) you might need to switch the user agent while keeping the session. In this case you can disable that feature (e.g. with a blank string).
213 'cookieDomain' => '', // Same as <a href="#SYS-cookieDomain">$TYPO3_CONF_VARS['SYS']['cookieDomain']</a> but only for BE cookies. If empty, $TYPO3_CONF_VARS['SYS']['cookieDomain'] value will be used.
214 'loginSecurityLevel' => '', // String: Keywords that determines the security level of login to the backend. "normal" means the password from the login form is sent in clear-text, "challenged" means the password is not sent but hashed with some other values, "superchallenged" (default) means the password is first hashed before being hashed with the challenge values again (means the password is stored as a hashed string in the database also), "rsa" uses RSA password encryption (only if the rsaauth extension is installed). DO NOT CHANGE this value manually; without an alternative authentication service it will only prevent logins in TYPO3 since the "superchallenged" method is hardcoded in the default authentication system.
215 'showRefreshLoginPopup' => FALSE, // Boolean: If set, the Ajax relogin will show a real popup window for relogin after the count down. Some auth services need this as they add custom validation to the login form. If it's not set, the Ajax relogin will show an inline relogin window.
216 'adminOnly' => 0, // <p>Integer (-1, 0, 1, 2)</p><dl><dt>-1</dt><dd>total shutdown for maintenance purposes</dd><dt>0</dt><dd>normal operation, everyone can login (default)</dd><dt>1</dt><dd>only admins can login</dd><dt>2</dt><dd>only admins and regular CLI users can login</dd></dl>
217 'disable_exec_function' => FALSE, // Boolean: Don't use exec() function (except for ImageMagick which is disabled by <a href="#GFX-im">[GFX][im]</a>=0). If set, all fileoperations are done by the default PHP-functions. This is nescessary under Windows! On Unix the system commands by exec() can be used, unless this is disabled.
218 'usePHPFileFunctions' => TRUE, // Boolean: If set, all fileoperations are done by the default PHP-functions. Default on Unix is using the system commands by exec().
219 'compressionLevel' => 0, // Determines output compression of BE output. Makes output smaller but slows down the page generation depending on the compression level. Requires a) zlib in your PHP installation and b) special rewrite rules for .css.gzip and .js.gzip (please see _.htacces for an example). Range 1-9, where 1 is least compression and 9 is greatest compression. 'true' as value will set the compression based on the PHP default settings (usually 5). Suggested and most optimal value is 5.
220 'maxFileSize' => '10240', // Integer: If set this is the max filesize in KB's for file operations in the backend. Can be overridden through $TCA per table field separately.
221 'forceCharset' => '-1', // String: Normally the charset of the backend users language selection is used. If you set this value to a charset found in t3lib/csconvtbl/ (or "utf-8") the backend (and database) will ALWAYS use this charset. Always use a lowercase value. NOTICE: This option is deprecated since TYPO3 4.5, and will be removed in 4.7. Please use proper tools to set your installation to native UTF-8.
222 'installToolPassword' => '', // String: This is the md5-hashed password for the Install Tool. Set this to '' and access will be totally denied. PLEASE consider to externally password protect the typo3/install/ folder, eg. with a .htaccess file.
223 'pageTree' => array(
224 'preloadLimit' => 50, // Integer: Count of pages that will be preloaded in pagetree. Big amount makes collapsing new branches faster but requires more SQL queries.
225 ),
226 'defaultUserTSconfig' => 'options.enableBookmarks=1
227 options.enableShowPalettes=1
228 options.file_list.enableDisplayBigControlPanel=selectable
229 options.file_list.enableDisplayThumbnails=selectable
230 options.file_list.enableClipBoard=selectable
231 options.pageTree {
232 doktypesToShowInNewPageDragArea = 1,6,4,7,3,254,255,199
233 }
234
235 options.contextMenu.options.leftIcons = 1
236 options.contextMenu {
237 table {
238 pages_root {
239 disableItems =
240
241 items {
242 100 = ITEM
243 100 {
244 name = view
245 label = LLL:EXT:lang/locallang_core.xml:cm.view
246 spriteIcon = actions-document-view
247 displayCondition = canBeViewed != 0
248 callbackAction = viewPage
249 }
250
251 200 = ITEM
252 200 {
253 name = new
254 label = LLL:EXT:lang/locallang_core.xml:cm.new
255 spriteIcon = actions-page-new
256 displayCondition = canCreateNewPages != 0
257 callbackAction = newPageWizard
258 }
259
260 300 = DIVIDER
261
262 400 = ITEM
263 400 {
264 name = history
265 label = LLL:EXT:lang/locallang_misc.xml:CM_history
266 spriteIcon = actions-document-history-open
267 displayCondition = canShowHistory != 0
268 callbackAction = openHistoryPopUp
269 }
270 }
271 }
272
273 pages {
274 disableItems =
275
276 items {
277 100 = ITEM
278 100 {
279 name = view
280 label = LLL:EXT:lang/locallang_core.xml:cm.view
281 spriteIcon = actions-document-view
282 displayCondition = canBeViewed != 0
283 callbackAction = viewPage
284 }
285
286 200 = DIVIDER
287
288 300 = ITEM
289 300 {
290 name = disable
291 label = LLL:EXT:lang/locallang_common.xml:disable
292 spriteIcon = actions-edit-hide
293 displayCondition = getRecord|hidden = 0 && canBeDisabledAndEnabled != 0
294 callbackAction = disablePage
295 }
296
297 400 = ITEM
298 400 {
299 name = enable
300 label = LLL:EXT:lang/locallang_common.xml:enable
301 spriteIcon = actions-edit-unhide
302 displayCondition = getRecord|hidden = 1 && canBeDisabledAndEnabled != 0
303 callbackAction = enablePage
304 }
305
306 500 = ITEM
307 500 {
308 name = edit
309 label = LLL:EXT:lang/locallang_core.xml:cm.edit
310 spriteIcon = actions-document-open
311 displayCondition = canBeEdited != 0
312 callbackAction = editPageProperties
313 }
314
315 600 = ITEM
316 600 {
317 name = info
318 label = LLL:EXT:lang/locallang_core.xml:cm.info
319 spriteIcon = actions-document-info
320 displayCondition = canShowInfo != 0
321 callbackAction = openInfoPopUp
322 }
323
324 700 = ITEM
325 700 {
326 name = history
327 label = LLL:EXT:lang/locallang_misc.xml:CM_history
328 spriteIcon = actions-document-history-open
329 displayCondition = canShowHistory != 0
330 callbackAction = openHistoryPopUp
331 }
332
333 800 = DIVIDER
334
335 900 = SUBMENU
336 900 {
337 label = LLL:EXT:lang/locallang_core.xml:cm.copyPasteActions
338
339 100 = ITEM
340 100 {
341 name = new
342 label = LLL:EXT:lang/locallang_core.xml:cm.new
343 spriteIcon = actions-page-new
344 displayCondition = canCreateNewPages != 0
345 callbackAction = newPageWizard
346 }
347
348 200 = DIVIDER
349
350 300 = ITEM
351 300 {
352 name = cut
353 label = LLL:EXT:lang/locallang_core.xml:cm.cut
354 spriteIcon = actions-edit-cut
355 displayCondition = isInCutMode = 0 && canBeCut != 0 && isMountPoint != 1
356 callbackAction = enableCutMode
357 }
358
359 400 = ITEM
360 400 {
361 name = cut
362 label = LLL:EXT:lang/locallang_core.xml:cm.cut
363 spriteIcon = actions-edit-cut-release
364 displayCondition = isInCutMode = 1 && canBeCut != 0
365 callbackAction = disableCutMode
366 }
367
368 500 = ITEM
369 500 {
370 name = copy
371 label = LLL:EXT:lang/locallang_core.xml:cm.copy
372 spriteIcon = actions-edit-copy
373 displayCondition = isInCopyMode = 0 && canBeCopied != 0
374 callbackAction = enableCopyMode
375 }
376
377 600 = ITEM
378 600 {
379 name = copy
380 label = LLL:EXT:lang/locallang_core.xml:cm.copy
381 spriteIcon = actions-edit-copy-release
382 displayCondition = isInCopyMode = 1 && canBeCopied != 0
383 callbackAction = disableCopyMode
384 }
385
386 700 = ITEM
387 700 {
388 name = pasteInto
389 label = LLL:EXT:lang/locallang_core.xml:cm.pasteinto
390 spriteIcon = actions-document-paste-into
391 displayCondition = getContextInfo|inCopyMode = 1 || getContextInfo|inCutMode = 1 && canBePastedInto != 0
392 callbackAction = pasteIntoNode
393 }
394
395 800 = ITEM
396 800 {
397 name = pasteAfter
398 label = LLL:EXT:lang/locallang_core.xml:cm.pasteafter
399 spriteIcon = actions-document-paste-after
400 displayCondition = getContextInfo|inCopyMode = 1 || getContextInfo|inCutMode = 1 && canBePastedAfter != 0
401 callbackAction = pasteAfterNode
402 }
403
404 900 = DIVIDER
405
406 1000 = ITEM
407 1000 {
408 name = delete
409 label = LLL:EXT:lang/locallang_core.xml:cm.delete
410 spriteIcon = actions-edit-delete
411 displayCondition = canBeRemoved != 0 && isMountPoint != 1
412 callbackAction = removeNode
413 }
414 }
415
416 1000 = SUBMENU
417 1000 {
418 label = LLL:EXT:lang/locallang_core.xml:cm.branchActions
419
420 100 = ITEM
421 100 {
422 name = mountAsTreeroot
423 label = LLL:EXT:lang/locallang_core.xml:cm.tempMountPoint
424 spriteIcon = actions-system-extension-documentation
425 displayCondition = canBeTemporaryMountPoint != 0 && isMountPoint = 0
426 callbackAction = mountAsTreeRoot
427 }
428
429 200 = DIVIDER
430
431 300 = ITEM
432 300 {
433 name = expandBranch
434 label = LLL:EXT:lang/locallang_core.xml:cm.expandBranch
435 spriteIcon = actions-pagetree-expand
436 displayCondition =
437 callbackAction = expandBranch
438 }
439
440 400 = ITEM
441 400 {
442 name = collapseBranch
443 label = LLL:EXT:lang/locallang_core.xml:cm.collapseBranch
444 spriteIcon = actions-pagetree-collapse
445 displayCondition =
446 callbackAction = collapseBranch
447 }
448 }
449 }
450 }
451 }
452 }
453 ', // String (exclude). Enter lines of default backend user/group TSconfig.
454 'defaultPageTSconfig' => 'mod.web_list.enableDisplayBigControlPanel=selectable
455 mod.web_list.enableClipBoard=selectable
456 mod.web_list.enableLocalizationView=selectable', // String (exclude).Enter lines of default Page TSconfig.
457 'defaultPermissions' => array ( // Default permissions set for new pages in t3lib/tce_main.php. Keys are 'show,edit,delete,new,editcontent'. Enter as comma-list
458 // 'user' => '', // default in tce_main is 'show,edit,delete,new,editcontent'. If this is set (uncomment), this value is used instead.
459 // 'group' => '', // default in tce_main is 'show,edit,new,editcontent'. If this is set (uncomment), this value is used instead.
460 // 'everybody' => '' // default in tce_main is ''. If this is set (uncomment), this value is used instead.
461 ),
462 'newPagesVersioningType' => -1, // Integer: Default versioning type for new pages create as versions. -1 means "element", 0 means "page", 1 means "branch". If using enything else than -1 ("element") here you also have to set "elementVersioningOnly=FALSE" . Please note that "page" and "branch" types are deprecated since TYPO3 4.2 and will be unsupported in TYPO3 4.6. Thus, this option will be removed in TYPO3 4.6.
463 'defaultUC' => array ( // Override default settings for BE-users. See class.t3lib_beuserauth.php, array $uc_default
464 ),
465 // The control of fileextensions goes in two catagories. Webspace and Ftpspace. Webspace is folders accessible from a webbrowser (below TYPO3_DOCUMENT_ROOT) and ftpspace is everything else.
466 // The control is done like this: If an extension matches 'allow' then the check returns TRUE. If not and an extension matches 'deny' then the check return FALSE. If no match at all, returns TRUE.
467 // You list extensions comma-separated. If the value is a '*' every extension is matched
468 // If no fileextension, TRUE is returned if 'allow' is '*', FALSE if 'deny' is '*' and TRUE if none of these matches
469 // This configuration below accepts everything in ftpspace and everything in webspace except php3,php4,php5 or php files
470 'fileExtensions' => array (
471 'webspace' => array('allow'=>'', 'deny'=> PHP_EXTENSIONS_DEFAULT),
472 'ftpspace' => array('allow'=>'*', 'deny'=>'')
473 ),
474 'customPermOptions' => array(), // Array with sets of custom permission options. Syntax is; 'key' => array('header' => 'header string, language splitted', 'items' => array('key' => array('label, language splitted', 'icon reference', 'Description text, language splitted'))). Keys cannot contain ":|," characters.
475 'fileDenyPattern' => FILE_DENY_PATTERN_DEFAULT , // A perl-compatible regular expression (without delimiters!) that - if it matches a filename - will deny the file upload/rename or whatever in the webspace. For security reasons, files with multiple extensions have to be denied on an Apache environment with mod_alias, if the filename contains a valid php handler in an arbitary position. Also, ".htaccess" files have to be denied. Matching is done case-insensitive. Default value is stored in constant FILE_DENY_PATTERN_DEFAULT
476 'interfaces' => 'backend', // This determines which interface options is available in the login prompt and in which order (All options: ",backend,frontend")
477 'useOnContextMenuHandler' => TRUE, // Boolean: If set, the context menus (clickmenus) in the backend are activated on right-click - although this is not a XHTML attribute!
478 'loginLabels' => 'Username|Password|Interface|Log In|Log Out|Backend,Front End,Traditional Backend|Administration Login on ###SITENAME###|(Note: Cookies and JavaScript must be enabled!)|Important Messages:|Your login attempt did not succeed. Make sure to spell your username and password correctly, including upper/lowercase characters.', // Language labels of the login prompt, separated with a pipe symbol (|). These should not be used anymore to change the labels since TYPO3 4.3, furthermore overload the labels with , see EXT:lang/locallang_login.xml for the used labels.
479 'loginNews' => array(), // In this array you can define news-items for the login screen. To this array, add arrays with assoc keys 'date', 'header', 'content' (HTML content) and for those appropriate value pairs
480 'loginNewsTitle' => '', // Define alternative header message for the LoginNews. If this var is empty, the default header "Important messages:" is displayed.
481 'XLLfile' => array(), // @deprecated For extension/overriding of the arrays in 'locallang' files in the backend. See 'Inside TYPO3' for more information.
482 'notificationPrefix' => '[TYPO3 Note]', // String: Used to prefix the subject of mails sent in the taskcenter
483 'accessListRenderMode' => 'checkbox', // Can be "singlebox", "checkbox" or blank. Refers to the "renderMode" for the selector boxes in be-groups configuration.
484 'explicitADmode' => 'explicitDeny', // Sets the general allow/deny mode for selector box values. Value can be either "explicitAllow" or "explicitDeny", nothing else!
485 'TSconfigConditions' => TRUE, // Boolean: When set it is possible to have TypoScript like conditions in BE Page/User/Group TS-Config
486 'niceFlexFormXMLtags' => TRUE, // If set, the flexform XML will be stored with meaningful tags which can be validated with DTD schema. If you rely on custom reading of the XML from pre-4.0 versions you should set this to FALSE if you don't like to change your reader code (internally it is insignificant since t3lib_div::xml2array() doesn't care for the tags if the index-attribute value is set)
487 'flexFormXMLincludeDiffBase' => TRUE, // If set, an additional tag with index "vXX.vDEFbase" is created for translations in flexforms holding the value of the default language when translation was changed. Used to show diff of value. This setting will change whether the system thinks flexform XML looks clean. For example when FALSE XX.vDEFbase fields will be removed in cleaning while accepted if TRUE (of course)
488 'compactFlexFormXML' => 0, // If set, the flexform XML will not contain indentation spaces making XML more compact
489 'flexformForceCDATA' => 0, // Boolean: If set, will add CDATA to Flexform XML. Some versions of libxml have a bug that causes HTML entities to be stripped from any XML content and this setting will avoid the bug by adding CDATA.
490 'explicitConfirmationOfTranslation' => FALSE, // If set, then the diff-data of localized records is not saved automatically when updated but requires that a translator clicks the special finish_translation/save/close button that becomes available.
491 'elementVersioningOnly' => TRUE, // If TRUE, only element versioning is allowed in the backend (see option newPagesVersioningType). Setting this flag is recommended for new installations of TYPO3 4.2+ since "page" and "branch" versioning types are known for the drawbacks of loosing ids and "element" type versions supports moving now. Please note that "page" and "branch" types are deprecated since TYPO3 4.2 and will be unsupported in TYPO3 4.6. Thus, this option will be removed in TYPO3 4.6.
492 'versionNumberInFilename' => FALSE, // <p>Boolean: If TRUE, included CSS and JS files will have the timestamp embedded in the filename, ie. filename.1269312081.js. This will make browsers and proxies reload the files if they change (thus avoiding caching issues). IMPORTANT: this feature requires extra .htaccess rules to work (please refer to _.htaccess or the _.htaccess file from the dummy package)</p><p>If FALSE the filemtime will be appended as a query-string.</p>
493 'spriteIconGenerator_handler' => '', // String: Used to register own/other spriteGenerating Handler, they have to implement the interface t3lib_spritemanager_SpriteIconGenerator. If set to "t3lib_spritemanager_SpriteBuildingHandler" icons from extensions will automatically merged into sprites.
494 'debug' => FALSE, // Boolean: If set, the loginrefresh is disabled and pageRenderer is set to debug mode. Use this to debug the backend only!
495 'AJAX' => array( // array of key-value pairs for a unified use of AJAX calls in the TYPO3 backend. Keys are the unique ajaxIDs where the value will be resolved to call a method in an object. See ajax.php and the classes/class.typo3ajax.php for more information.
496 'SC_alt_db_navframe::expandCollapse' => 'typo3/alt_db_navframe.php:SC_alt_db_navframe->ajaxExpandCollapse',
497 'SC_alt_file_navframe::expandCollapse' => 'typo3/alt_file_navframe.php:SC_alt_file_navframe->ajaxExpandCollapse',
498 'TYPO3_tcefile::process' => 'typo3/classes/class.typo3_tcefile.php:TYPO3_tcefile->processAjaxRequest',
499 't3lib_TCEforms_inline::createNewRecord' => 't3lib/class.t3lib_tceforms_inline.php:t3lib_TCEforms_inline->processAjaxRequest',
500 't3lib_TCEforms_inline::getRecordDetails' => 't3lib/class.t3lib_tceforms_inline.php:t3lib_TCEforms_inline->processAjaxRequest',
501 't3lib_TCEforms_inline::synchronizeLocalizeRecords' => 't3lib/class.t3lib_tceforms_inline.php:t3lib_TCEforms_inline->processAjaxRequest',
502 't3lib_TCEforms_inline::setExpandedCollapsedState' => 't3lib/class.t3lib_tceforms_inline.php:t3lib_TCEforms_inline->processAjaxRequest',
503 't3lib_TCEforms_suggest::searchRecord' => 't3lib/tceforms/class.t3lib_tceforms_suggest.php:t3lib_TCEforms_suggest->processAjaxRequest',
504 'ShortcutMenu::getGroups' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->getAjaxShortcutGroups',
505 'ShortcutMenu::saveShortcut' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->setAjaxShortcut',
506 'ShortcutMenu::render' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->renderAjax',
507 'ShortcutMenu::delete' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->deleteAjaxShortcut',
508 'ShortcutMenu::create' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->createAjaxShortcut',
509 'ModuleMenu::saveMenuState' => 'typo3/classes/class.modulemenu.php:ModuleMenu->saveMenuState',
510 'ModuleMenu::getData' => 'typo3/classes/class.modulemenu.php:ModuleMenu->getModuleData',
511 'BackendLogin::login' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->login',
512 'BackendLogin::logout' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->logout',
513 'BackendLogin::refreshLogin' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->refreshLogin',
514 'BackendLogin::isTimedOut' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->isTimedOut',
515 'BackendLogin::getChallenge' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->getChallenge',
516 'BackendLogin::refreshTokens' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->refreshTokens',
517 'ExtDirect::getAPI' => 't3lib/extjs/class.t3lib_extjs_extdirectapi.php:t3lib_extjs_ExtDirectApi->getAPI',
518 'ExtDirect::route' => 't3lib/extjs/class.t3lib_extjs_extdirectrouter.php:t3lib_extjs_ExtDirectRouter->route',
519 ),
520 'XCLASS' => array(), // See 'Inside TYPO3' document for more information.
521 ),
522 'FE' => array( // Configuration for the TypoScript frontend (FE). Nothing here relates to the administration backend!
523 'png_to_gif' => FALSE, // Boolean: Enables conversion back to gif of all png-files generated in the frontend libraries. Notice that this leaves an increased number of temporary files in typo3temp/
524 'tidy' => FALSE, // Boolean: If set, the output html-code will be passed through "tidy" which is a little program you can get from <a href="http://www.w3.org/People/Raggett/tidy/" target="_blank">w3c.org</a>. "Tidy" cleans the HTML-code for nice display!
525 'tidy_option' => 'cached', // options [all, cached, output]. "all" = the content is always passed through "tidy" before it may be stored in cache. "cached" = only if the page is put into the cache, "output" = only the output code just before it's echoed out.
526 'tidy_path' => 'tidy -i --quiet true --tidy-mark true -wrap 0 -raw', // Path with options for tidy. For XHTML output, add " --output-xhtml true"
527 'logfile_dir' => '', // Path where TYPO3 should write webserver-style logfiles to. This path must be write-enabled for the webserver. If this path is outside of PATH_site, you have to allow it using <a href="#BE-lockRootPath">[BE][lockRootPath]</a>
528 'publish_dir' => '', // Path where TYPO3 should write staticly published documents. This path must be write-enabled for the webserver. Remember slash AFTER! Eg: 'publish/' or '/www/htdocs/publish/'. See admPanel option 'publish'
529 'addAllowedPaths' => '', // Additional relative paths (comma-list) to allow TypoScript resources be in. Should be prepended with '/'. If not, then any path where the first part is like this path will match. That is: 'myfolder/ , myarchive' will match eg. 'myfolder/', 'myarchive/', 'myarchive_one/', 'myarchive_2/' ... No check is done to see if this directory actually exists in the root of the site. Paths are matched by simply checking if these strings equals the first part of any TypoScript resource filepath. (See class template, function init() in t3lib/class.t3lib_tsparser.php)
530 'allowedTempPaths' => '', // Additional paths allowed for temporary images. Used with imgResource. Eg. 'alttypo3temp/,another_temp_dir/';
531 'debug' => FALSE, // Boolean: If set, some debug HTML-comments may be output somewhere. Can also be set by TypoScript.
532 'simulateStaticDocuments' => FALSE, // Boolean: This is the default value for simulateStaticDocuments (configurable with TypoScript which overrides this, if the TypoScript value is present), since TYPO3 4.3 you also need to install the system extension "simulatestatic" to get this to work.
533 'noPHPscriptInclude' => FALSE, // Boolean: If set, PHP-scripts are not included by TypoScript configurations, unless they reside in 'media/scripts/'-folder. This is a security option to ensure that users with template-access do not terrorize
534 'strictFormmail' => TRUE, // Boolean: If set, the internal "formmail" feature in TYPO3 will send mail ONLY to recipients which has been encoded by the system itself. This protects against spammers misusing the formmailer.
535 'secureFormmail' => TRUE, // Boolean: If set, the internal "formmail" feature in TYPO3 will send mail ONLY to the recipients that are defined in the form CE record. This protects against spammers misusing the formmailer.
536 'formmailMaxAttachmentSize' => 250000, // Integer: Sets the maximum allowed size (in bytes) of attachments for the internal "formmail" feature.
537 'compressionLevel' => 0, // Integer: Determines output compression of FE output. Makes output smaller but slows down the page generation depending on the compression level. Requires zlib in your PHP installation. Range 1-9, where 1 is least compression and 9 is greatest compression. 'true' as value will set the compression based on the PHP default settings (usually 5). Suggested and most optimal value is 5.
538 'pageNotFound_handling' => '', // <p>How TYPO3 should handle requests for non-existing/accessible pages.</p> <dl><dt>empty (default)</dt><dd>The next visible page upwards in the page tree is shown.</dd> <dt>'true' or '1'</dt><dd>An error message is shown.</dd><dt>String</dt><dd>Static HTML file to show (reads content and outputs with correct headers), e.g. 'notfound.html' or 'http://www.example.org/errors/notfound.html'.</dd> <dt>Prefix "REDIRECT:"</dt><dd> If prefixed with "REDIRECT:" it will redirect to the URL/script after the prefix.</dd><dt>Prefix "READFILE:"</dt><dd>If prefixed with "READFILE" then it will expect the remaining string to be a HTML file which will be read and outputted directly after having the marker "###CURRENT_URL###" substituted with REQUEST_URI and ###REASON### with reason text, for example: "READFILE:fileadmin/notfound.html".</dd> <dt>Prefix "USER_FUNCTION:"</dt><dd> If prefixed with "USER_FUNCTION:" a user function is called, e.g. "USER_FUNCTION:fileadmin/class.user_notfound.php:user_notFound->pageNotFound" where the file must contain a class "user_notFound" with a method "pageNotFound" inside with two parameters $param and $ref.</dd></dl>
539 'pageNotFound_handling_statheader' => 'HTTP/1.0 404 Not Found', // If 'pageNotFound_handling' is enabled, this string will always be sent as header before the actual handling.
540 'pageNotFoundOnCHashError' => FALSE, // Boolean: If TRUE, a page not found call is made when cHash evaluation error occurs. By default they will just disable caching but still display page output.
541 'pageUnavailable_handling' => '', // <p>How TYPO3 should handle requests when pages are unavailable due to system problems.</p><dl><dt>empty (default)</dt><dd>An error message is shown.</dd><dt>String</dt><dd>HTML file or URL to show (reads content and outputs with correct headers), e.g. 'unavailable.html' or 'http://www.example.org/errors/unavailable.html'.</dd><dt>Prefix "REDIRECT:"</dt><dd>If prefixed "REDIRECT:" it will redirect to the URL/script after the prefix.</dd><dt>Prefix "READFILE:"</dt><dd>If prefixed with "READFILE:" then it will expect the remaining string to be a HTML file which will be read and outputted directly after having the marker "###CURRENT_URL###" substituted with REQUEST_URI and ###REASON### with reason text, for example: "READFILE:fileadmin/unavailable.html".</dd><dt>Prefix "USER_FUNCTION:"</dt><dd>If prefixed "USER_FUNCTION:" then it will call a user function, eg. "USER_FUNCTION:fileadmin/class.user_unavailable.php:user_unavailable->pageUnavailable" where the file must contain a class "user_unavailable" with a method "pageUnavailable" inside with two parameters $param and $ref. If the client matches <a href="#SYS-devIPmask">[SYS][devIPmask]</a>, this setting is ignored and the page is shown as normal.</dd></dl>
542 'pageUnavailable_handling_statheader' => 'HTTP/1.0 503 Service Temporarily Unavailable', // If 'pageUnavailable_handling' is enabled, this string will always be sent as header before the actual handling.
543 'pageUnavailable_force' => FALSE, // Boolean: If TRUE, pageUnavailable_handling is used for every frontend page. If the client matches <a href="#SYS-devIPmask">[SYS][devIPmask]</a>, the page is shown as normal. This is useful during temporary site maintenance.
544 'userFuncClassPrefix' => 'user_', // This prefix must be the first part of any function or class name called from TypoScript, for instance in the stdWrap function.
545 'addRootLineFields' => '', // Comma-list of fields from the 'pages'-table. These fields are added to the select query for fields in the rootline.
546 'checkFeUserPid' => TRUE, // Boolean: If set, the pid of fe_user logins must be sent in the form as the field 'pid' and then the user must be located in the pid. If you unset this, you should change the fe_users.username eval-flag 'uniqueInPid' to 'unique' in $TCA. This will do: $TCA['fe_users']['columns']['username']['config']['eval']= 'nospace,lower,required,unique';
547 'lockIP' => 2, // Integer (0-4). If >0, fe_users are locked to (a part of) their REMOTE_ADDR IP for their session. Enhances security but may throw off users that may change IP during their session (in which case you can lower it to 2 or 3). The integer indicates how many parts of the IP address to include in the check. Reducing to 1-3 means that only first, second or third part of the IP address is used. 4 is the FULL IP address and recommended. 0 (zero) disables checking of course.
548 'loginSecurityLevel' => '', // See description for <a href="#BE-loginSecurityLevel">[BE][loginSecurityLevel]</a>. Default state for frontend is "normal". Alternative authentication services can implement higher levels if preferred. For example, "rsa" level uses RSA password encryption (only if the rsaauth extension is installed)
549 'lifetime' => 0, // Integer: positive. If >0, the cookie of FE users will have a lifetime of the number of seconds this value indicates. Otherwise it will be a session cookie (deleted when browser is shut down). Setting this value to 604800 will result in automatic login of FE users during a whole week, 86400 will keep the FE users logged in for a day.
550 'sessionDataLifetime' => 86400, // Integer: positive. If >0, the session data will timeout and be removed after the number of seconds given (86400 seconds represents 24 hours).
551 'permalogin' => 0, // <p>Integer:</p><dl><dt>-1</dt><dd>Permanent login for FE users disabled.</dd><dt>0</dt><dd>By default permalogin is disabled for FE users but can be enabled by a form control in the login form.</dd><dt>1</dt><dd>Permanent login is by default enabled but can be disabled by a form control in the login form.</dd><dt>2</dt><dd>Permanent login is forced to be enabled.// In any case, permanent login is only possible if <a href="#FE-lifetime">[FE][lifetime]</a> lifetime is > 0.</dd></dl>
552 'maxSessionDataSize' => 10000, // Integer: Setting the maximum size (bytes) of frontend session data stored in the table fe_session_data. Set to zero (0) means no limit, but this is not recommended since it also disables a check that session data is stored only if a confirmed cookie is set.
553 'cookieDomain' => '', // Same as <a href="#SYS-cookieDomain">$TYPO3_CONF_VARS['SYS']['cookieDomain']</a> but only for FE cookies. If empty, $TYPO3_CONF_VARS['SYS']['cookieDomain'] value will be used.
554 'lockHashKeyWords' => 'useragent', // Keyword list (Strings commaseparated). Currently only "useragent"; If set, then the FE user session is locked to the value of HTTP_USER_AGENT. This lowers the risk of session hi-jacking. However some cases (like payment gateways) might have to use the session cookie and in this case you will have to disable that feature (eg. with a blank string).
555 'defaultUserTSconfig' => '', // String (textarea). Enter lines of default frontend user/group TSconfig.
556 'defaultTypoScript_constants' => '', // String (textarea). Enter lines of default TypoScript, constants-field.
557 'defaultTypoScript_constants.' => array(), // Lines of TS to include after a static template with the uid = the index in the array (Constants)
558 'defaultTypoScript_setup' => '', // Enter lines of default TypoScript, setup-field.
559 'defaultTypoScript_setup.' => array(), // As above, but for Setup
560 'defaultTypoScript_editorcfg' => '', // String (textarea). Enter lines of default TypoScript, editorcfg-field (Backend Editor Configuration)
561 'defaultTypoScript_editorcfg.' => array(), // As above, but for Backend Editor Configuration
562 'dontSetCookie' => FALSE, // Boolean: If set, the no cookies is attempted to be set in the front end. Of course no userlogins are possible either...
563 'additionalAbsRefPrefixDirectories' => '', // Enter additional directories to be prepended with absRefPrefix. Directories must be comma-separated. TYPO3 already prepends the following directories: media/, typo3conf/ext/, fileadmin/
564 'IPmaskMountGroups' => array( // This allows you to specify an array of IPmaskLists/fe_group-uids. If the REMOTE_ADDR of the user matches an IPmaskList, then the given fe_group is add to the gr_list. So this is an automatic mounting of a user-group. But no fe_user is logged in though! This feature is implemented for the default frontend user authentication and might not be implemented for alternative authentication services.
565 // array('IPmaskList_1','fe_group uid'), array('IPmaskList_2','fe_group uid')
566 ),
567 'get_url_id_token' => '#get_URL_ID_TOK#', // This is the token, which is substituted in the output code in order to keep a GET-based session going. Normally the GET-session-id is 5 chars ('&amp;ftu=') + hash_length (norm. 10)
568 'content_doktypes' => '1,2,5,7', // List of pages.doktype values which can contain content (so shortcut pages and external url pages are excluded, but all pages below doktype 199 should be included. doktype=6 is not either (backend users only...). For doktypes going into menus see class.tslib_menu.php, line 494 (search for 'doktype'))
569 'enable_mount_pids' => TRUE, // Boolean: If set to "1", the mount_pid feature allowing 'symlinks' in the page tree (for frontend operation) is allowed.
570 'pageOverlayFields' => 'uid,title,subtitle,nav_title,media,keywords,description,abstract,author,author_email,url,urltype,shortcut,shortcut_mode', // List of fields from the table "pages_language_overlay" which should be overlaid on page records. See t3lib_page::getPageOverlay()
571 'hidePagesIfNotTranslatedByDefault' => FALSE, // Boolean: If TRUE, pages that has no translation will be hidden by default. Basically this will inverse the effect of the page localization setting "Hide page if no translation for current language exists" to "Show page even if no translation exists"
572 'eID_include' => array(), // Array of key/value pairs where key is "tx_[ext]_[optional suffix]" and value is relative filename of class to include. Key is used as "?eID=" for index_ts.php to include the code file which renders the page from that point. (Useful for functionality that requires a low initialization footprint, eg. frontend ajax applications)
573 'disableNoCacheParameter' => FALSE, // Boolean: If set, the no_cache request parameter will become ineffective. This is currently still an experimental feature and will require a website only with plugins that don't use this parameter. However, using "&amp;no_cache=1" should be avoided anyway because there are better ways to disable caching for a certain part of the website (see COA_INT/USER_INT documentation in TSref).
574 'workspacePreviewLogoutTemplate' => '', // If set, points to an HTML file relative to the TYPO3_site root which will be read and outputted as template for this message. Example: fileadmin/templates/template_workspace_preview_logout.html. Inside you can put the marker %1$s to insert the URL to go back to. Use this in &lt;a href="%1$s"&gt;Go back...&lt;/a&gt; links
575 'versionNumberInFilename' => 'querystring', // String: embed,querystring,''. Allows to automatically include a version number (timestamp of the file) to referred CSS and JS filenames on the rendered page. This will make browsers and proxies reload the files if they change (thus avoiding caching issues). Set to 'embed' will have the timestamp embedded in the filename, ie. filename.1269312081.js. IMPORTANT: 'embed' requires extra .htaccess rules to work (please refer to _.htaccess or the _.htaccess file from the dummy package)<p>Set to 'querystring' (default setting) to append the version number as a query parameter (doesn't require mod_rewrite). Set to '' will turn this functionality off (behaves like TYPO3 &lt; v4.4).</p>
576 'XCLASS' => array(), // See 'Inside TYPO3' document for more information.
577 ),
578 'MAIL' => array( // Mail configurations to tune how t3lib_mail classes will send their mails.
579 'transport' => 'mail', // <p>String:</p><dl><dt>mail</dt><dd>Sends messages by delegating to PHP's internal mail() function. No further settings required. This is the most unreliable option. If you are serious about sending mails, consider using "smtp" or "sendmail".</dd><dt>smtp</dt><dd>Sends messages over the (standardized) Simple Message Transfer Protocol. It can deal with encryption and authentication. Most flexible option, requires a mail server and configurations in transport_smtp_* settings below. Works the same on Windows, Unix and MacOS.</dd><dt>sendmail</dt><dd>Sends messages by communicating with a locally installed MTA - such as sendmail. See setting transport_sendmail_command bellow.<dd><dt>mbox</dt><dd>This doesn't send any mail out, but instead will write every outgoing mail to a file adhering to the RFC 4155 mbox format, which is a simple text file where the mails are concatenated. Useful for debugging the mail sending process and on development machines which cannot send mails to the outside. Configure the file to write to in the 'transport_mbox_file' setting below</dd></dl>
580 'transport_smtp_server' => 'localhost:25', // String: <em>only with transport=smtp</em>: &lt;server:port> of mailserver to connect to. &lt;port> defaults to "25".
581 'transport_smtp_encrypt' => '', // String: <em>only with transport=smtp</em>: Connect to the server using the specified transport protocol. Requires openssl library. Usually available: <em>ssl, sslv2, sslv3, tls</em>. Check <a href="http://www.php.net/stream_get_transports" target="_blank">stream_get_transports()</a>.
582 'transport_smtp_username' => '', // String: <em>only with transport=smtp</em>: If your SMTP server requires authentication, enter your username here.
583 'transport_smtp_password' => '', // String: <em>only with transport=smtp</em>: If your SMTP server requires authentication, enter your password here.
584 'transport_sendmail_command' => '/usr/sbin/sendmail -bs', // String: <em>only with transport=sendmail</em>: The command to call to send a mail locally. The default works on most modern UNIX based mail server (sendmail, postfix, exim)
585 'transport_mbox_file' => '', // String: <em>only with transport=mbox</em>: The file where to write the mails into. This file will be conforming the mbox format described in RFC 4155. It is a simple text file with a concatenation of all mails. Path must be absolute.
586 'substituteOldMailAPI' => 1, // Boolean: If this is set, old calls to t3lib_utility_mail::Mail() will be translated to new t3lib_mail calls. This should work on most cases and thus respect the above transport settings. If you get garbled emails (or no attachments), consider setting this off. Ask the extension author to upgrade their code to make use of t3lib_mail (instead of the deprecated t3lib_htmlmail).
587 'defaultMailFromAddress' => '', // String: This default email address is used when no other "from" address is set for a TYPO3-generated email. You can specify an email address only (ex. info@example.org).
588 'defaultMailFromName' => '', // String: This default name is used when no other "from" name is set for a TYPO3-generated email.
589 ),
590 'MODS' => array( // Backend Module Configuration (obsolete, make extension instead)
591 ),
592 'USER' => array( // Here you may define your own setup-vars for use in your include-scripts. (obsolete, make extension instead)
593 ),
594 'SC_OPTIONS' => array( // Here you can more or less freely define additional configuration for scripts in TYPO3. Of course the features supported depends on the script. See documentation "Inside TYPO3" for examples. Keys in the array are the relative path of a script (for output scripts it should be the "script ID" as found in a comment in the HTML header ) and values can then be anything that scripts wants to define for itself. The key "GLOBAL" is reserved.
595 'GLOBAL' => array(
596 'softRefParser' => array(
597 'substitute' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
598 'notify' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
599 'images' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
600 'typolink' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
601 'typolink_tag' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
602 'TSconfig' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
603 'TStemplate' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
604 'ext_fileref' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
605 'email' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
606 'url' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
607 ),
608 'softRefParser_GL' => array(), // Global soft reference parsers
609 'cliKeys' => array( // Arrays of EXT:file and module name pairs. See EXT:lowlevel/ext_localconf.php for example.
610 )
611 ),
612 't3lib/class.t3lib_tsfebeuserauth.php' => array(
613 'frontendEditingController' => array(
614 'default' => 't3lib/class.t3lib_frontendedit.php:t3lib_frontendedit'
615 )
616 ),
617 'ExtDirect' => array( // array of key value pairs (provider -> location:className) that holds the classes for the ExtDirect functionality
618 'TYPO3.CSH.ExtDirect' => 't3lib/extjs/dataprovider/class.extdirect_dataprovider_contexthelp.php:extDirect_DataProvider_ContextHelp',
619 'TYPO3.LiveSearchActions.ExtDirect' => 't3lib/extjs/dataprovider/class.extdirect_dataprovider_backendlivesearch.php:extDirect_DataProvider_BackendLiveSearch',
620 'TYPO3.BackendUserSettings.ExtDirect' => 't3lib/extjs/dataprovider/class.extdirect_dataprovider_beusersettings.php:extDirect_DataProvider_BackendUserSettings',
621 'TYPO3.ExtDirectStateProvider.ExtDirect' => 't3lib/extjs/dataprovider/class.extdirect_dataprovider_state.php:extDirect_DataProvider_State',
622 'TYPO3.Components.PageTree.DataProvider' => 't3lib/tree/pagetree/extdirect/class.t3lib_tree_pagetree_extdirect_tree.php:t3lib_tree_pagetree_extdirect_Tree',
623 'TYPO3.Components.PageTree.Commands' => 't3lib/tree/pagetree/extdirect/class.t3lib_tree_pagetree_extdirect_tree.php:t3lib_tree_pagetree_extdirect_Commands',
624 'TYPO3.Components.PageTree.ContextMenuDataProvider' => 't3lib/contextmenu/pagetree/extdirect/class.t3lib_contextmenu_pagetree_extdirect_contextmenu.php:t3lib_contextmenu_pagetree_extdirect_ContextMenu',
625 ),
626 ),
627 'EXTCONF' => array( // Here you may add manually set configuration options for your extensions. Eg. $TYPO3_CONF_VARS['EXTCONF']['my_extension_key']['my_option'] = 'my_value';
628 // '--key--' => array()
629 ),
630 'SVCONF' => array( // Here you may add manually set configuration options for services.
631 // Eg. ...['service_type']['setup']['my_option'] = 'my_value'; Setup options how to handle the service (call it or not and how when)
632 // Eg. ...['service_type']['default']['my_option'] = 'my_value';
633 // Eg. ...['service_type']['service_key']['my_option'] = 'my_value';
634 )
635 );
636 $T3_VAR = array(); // Initialize.
637
638 // TYPO3 version
639 $TYPO_VERSION = '4.6-dev'; // deprecated: use the constants defined below
640 define('TYPO3_version', $TYPO_VERSION);
641 define('TYPO3_branch', '4.6');
642 define('TYPO3_copyright_year', '1998-2011');
643 define('TYPO3_user_agent', 'User-Agent: TYPO3/'.TYPO3_version);
644
645 // Database-variables are cleared!
646 $typo_db = ''; // The database name
647 $typo_db_username = ''; // The database username
648 $typo_db_password = ''; // The database password
649 $typo_db_host = ''; // The database host
650 $typo_db_tables_script = ''; // The filename of the tables.php script in typo3conf/ folder IF the default t3lib/stddb/tables.php should NOT be used for some reason. It's recommended to use the default and modify it through the extTableDef-script, see below.
651 $typo_db_extTableDef_script = ''; // The filename of an additional script in typo3conf/-folder which is included after tables.php. Code in this script should modify the tables.php-configuration only, and this provides a good way to extend the standard-distributed tables.php file.
652
653 // TYPO3 links
654 define('TYPO3_URL_GENERAL', 'http://typo3.com/');
655 define('TYPO3_URL_ORG', 'http://typo3.org/');
656 define('TYPO3_URL_LICENSE', 'http://typo3.org/license');
657 define('TYPO3_URL_EXCEPTION', 'http://typo3.org/go/exception/v4/');
658 define('TYPO3_URL_MAILINGLISTS', 'http://lists.typo3.org/cgi-bin/mailman/listinfo');
659 define('TYPO3_URL_DOCUMENTATION', 'http://typo3.org/documentation/');
660 define('TYPO3_URL_DOCUMENTATION_TSREF', 'http://typo3.org/documentation/document-library/references/doc_core_tsref/current/view/');
661 define('TYPO3_URL_DOCUMENTATION_TSCONFIG', 'http://typo3.org/documentation/document-library/references/doc_core_tsconfig/current/view/');
662 define('TYPO3_URL_CONSULTANCY', 'http://typo3.com/Consultancies.1248.0.html');
663 define('TYPO3_URL_CONTRIBUTE', 'http://typo3.org/community/participate/');
664 define('TYPO3_URL_SECURITY', 'http://typo3.org/teams/security/');
665 define('TYPO3_URL_DOWNLOAD', 'http://typo3.org/download/packages/');
666 define('TYPO3_URL_SYSTEMREQUIREMENTS', 'http://typo3.org/1275.0.html');
667 define('TYPO3_URL_DONATE', 'http://typo3.org/donate/');
668
669 // Include localconf.php. Use this file to configure TYPO3 for your needs and database
670 if (!@is_file(PATH_typo3conf . 'localconf.php')) {
671 throw new Exception('localconf.php is not found!');
672 }
673 require(PATH_typo3conf.'localconf.php');
674
675
676 /**
677 * Checking for UTF-8 in the settings since TYPO3 4.5
678 *
679 * Since TYPO3 4.5, everything other than UTF-8 is deprecated.
680 * The -1 operator is used to see if the option was set in the installations localconf.php.
681 *
682 * [BE][forceCharset] is set to the charset that TYPO3 is using
683 * [SYS][setDBinit] is used to set the DB connection
684 * and both settings need to be adjusted for UTF-8 in order to work properly
685 */
686 // If this value is -1 then the setting has not been modified in localconf.php
687 if ($TYPO3_CONF_VARS['BE']['forceCharset'] == '-1' && $typo_db) {
688 if (t3lib_div::compat_version('4.5')) {
689 // 1) no option was set in localconf.php but the Update Wizard
690 // was already used, so the admin is knowing what he's doing,
691 // 2) a new installation with the new default value
692 $TYPO3_CONF_VARS['BE']['forceCharset'] = 'utf-8';
693 } elseif (TYPO3_enterInstallScript !== '1') {
694 // The value needs to be set in localconf.php
695 die('This installation was just upgraded to TYPO3 ' . TYPO3_branch . '. In this version, some default settings have changed.<br />' .
696 'You can continue to use your settings by specifying the former default values in localconf.php.<br />' .
697 'Please proceed to the Update Wizard in the TYPO3 Install Tool to update your configuration.');
698 }
699
700 } elseif ($TYPO3_CONF_VARS['BE']['forceCharset'] !== 'utf-8' && $typo_db) {
701 t3lib_div::deprecationLog('This TYPO3 installation does not enforce the UTF-8 character set.' . chr(10) .
702 'Everything other than UTF-8 is deprecated since TYPO3 4.5.' . chr(10) .
703 'The DB, its connection and TYPO3 should be migrated to UTF-8 therefore. Please check your setup.');
704 }
705
706
707 // If this value is -1 then the setting has not been modified in localconf.php
708 if ($TYPO3_CONF_VARS['SYS']['setDBinit'] == '-1' && $typo_db) {
709 if (t3lib_div::compat_version('4.5')) {
710 // 1) no option was set in localconf.php but the Update Wizard
711 // was already used, so the admin is knowing what he's doing,
712 // 2) a new installation with the new default value
713 $TYPO3_CONF_VARS['SYS']['setDBinit'] = 'SET NAMES utf8';
714 } elseif (TYPO3_enterInstallScript !== '1' && $typo_db) {
715 // The value needs to be set in localconf.php
716 die('This installation was just upgraded to TYPO3 ' . TYPO3_branch . '. In this version, some default settings have changed.<br />' .
717 'You can continue to use your settings by specifying the former default values in localconf.php.<br />' .
718 'Please proceed to the Update Wizard in the TYPO3 Install Tool to update your configuration.');
719 }
720
721 // Only accept "SET NAMES utf8" for this setting. Otherwise, a deprecation warning will be issued.
722 } elseif (!preg_match('/SET NAMES utf8/', $TYPO3_CONF_VARS['SYS']['setDBinit']) && $typo_db) {
723 // TODO: Add a link to a website with more information here
724 t3lib_div::deprecationLog('This TYPO3 installation is using the $TYPO3_CONF_VARS[\'SYS\'][\'setDBinit\'] property with the following value:' . chr(10) .
725 $TYPO3_CONF_VARS['SYS']['setDBinit'] . chr(10) . chr(10) .
726 'It looks like UTF-8 is not used for this connection.' . chr(10) . chr(10) .
727 'Everything other than UTF-8 is deprecated since TYPO3 4.5.' . chr(10) .
728 'The DB, its connection and TYPO3 should be migrated to UTF-8 therefore. Please check your setup.');
729 }
730
731
732
733 $timeZone = $GLOBALS['TYPO3_CONF_VARS']['SYS']['phpTimeZone'];
734 if (empty($timeZone)) {
735 // time zone from the server environment (TZ env or OS query)
736 $defaultTimeZone = @date_default_timezone_get();
737 if ($defaultTimeZone !== '') {
738 $timeZone = $defaultTimeZone;
739 } else {
740 $timeZone = 'UTC';
741 }
742 }
743 // sets the default to avoid E_WARNINGs under PHP 5.3
744 date_default_timezone_set($timeZone);
745
746 // Defining the database setup as constants
747 define('TYPO3_db', $typo_db);
748 define('TYPO3_db_username', $typo_db_username);
749 define('TYPO3_db_password', $typo_db_password);
750 define('TYPO3_db_host', $typo_db_host);
751 define('TYPO3_tables_script', $typo_db_tables_script);
752 define('TYPO3_extTableDef_script', $typo_db_extTableDef_script);
753
754 // Defining backend system languages
755 // When adding new keys, remember to:
756 // - Update pages.lang item array (t3lib/stddb/tbl_be.php)
757 // - Add character encoding for lang. key in t3lib/class.t3lib_cs.php (default for new languages is "utf-8")
758 // - Add mappings for language in t3lib/class.t3lib_cs.php (TYPO3/ISO, language/script, script/charset)
759 // - Update 'setup' extension labels (sysext/setup/mod/locallang.xml)
760 // - Using translation server? Create new user with username = "language key", member of "translator" group, set to "language key" language.
761 // Thats it! Use extension "llxmltranslate" to begin translation. Language pack is automatically created in "typo3conf/l10n/[language key]/"
762 define('TYPO3_languages', 'default|dk|de|no|it|fr|es|nl|cz|pl|si|fi|tr|se|pt|ru|ro|ch|sk|lt|is|hr|hu|gl|th|gr|hk|eu|bg|br|et|ar|he|ua|lv|jp|vn|ca|ba|kr|eo|my|hi|fo|fa|sr|sq|ge|ga|km|qc');
763
764 // Unsetting the configured values. Use of these are deprecated.
765 unset($typo_db);
766 unset($typo_db_username);
767 unset($typo_db_password);
768 unset($typo_db_host);
769 unset($typo_db_tables_script);
770 unset($typo_db_extTableDef_script);
771
772 // Based on the configuration of the image processing some options may be forced:
773 if (!$GLOBALS['TYPO3_CONF_VARS']['GFX']['image_processing']) {
774 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im']=0;
775 $GLOBALS['TYPO3_CONF_VARS']['GFX']['gdlib']=0;
776 }
777 if (!$GLOBALS['TYPO3_CONF_VARS']['GFX']['im']) {
778 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_path']='';
779 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_path_lzw']='';
780 $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']='gif,jpg,jpeg,png';
781 $GLOBALS['TYPO3_CONF_VARS']['GFX']['thumbnails'] = 0;
782 }
783 if ($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_version_5']) {
784 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_negate_mask'] = 1;
785 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_no_effects'] = 1;
786 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_mask_temp_ext_gif'] = 1;
787
788 if ($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_version_5']==='gm') {
789 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_negate_mask'] = 0;
790 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_imvMaskState'] = 0;
791 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_no_effects'] = 1;
792 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_v5effects'] = -1;
793 }
794 }
795 if ($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_imvMaskState']) {
796 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_negate_mask']=$GLOBALS['TYPO3_CONF_VARS']['GFX']['im_negate_mask']?0:1;
797 }
798
799
800 // Convert type of "pageNotFound_handling" setting in case it was written as a string (e.g. if edited in Install Tool)
801 // TODO: Once the Install Tool handles such data types correctly, this workaround should be removed again...
802 if (!strcasecmp($TYPO3_CONF_VARS['FE']['pageNotFound_handling'],'TRUE')) {
803 $TYPO3_CONF_VARS['FE']['pageNotFound_handling'] = TRUE;
804 }
805
806
807 // simple debug function which prints output immediately
808 function xdebug($var = '', $debugTitle = 'xdebug') {
809 // If you wish to use the debug()-function, and it does not output something, please edit the IP mask in TYPO3_CONF_VARS
810 if (!t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) return;
811 t3lib_utility_Debug::debug($var, $debugTitle);
812 }
813 // Debug function which calls $GLOBALS['error'] error handler if available
814 function debug($variable='', $name='*variable*', $line='*line*', $file='*file*', $recursiveDepth=3, $debugLevel=E_DEBUG) {
815 // If you wish to use the debug()-function, and it does not output something, please edit the IP mask in TYPO3_CONF_VARS
816 if (!t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) return;
817
818 if(is_object($GLOBALS['error']) && @is_callable(array($GLOBALS['error'],'debug'))) {
819 $GLOBALS['error']->debug($variable, $name, $line, $file, $recursiveDepth, $debugLevel);
820 } else {
821 $title = ($name === '*variable*') ? '' : $name;
822 $group = ($line === '*line*') ? NULL : $line;
823 t3lib_utility_Debug::debug($variable, $title, $group);
824 }
825 }
826 function debugBegin() {
827 if(is_object($GLOBALS['error']) && @is_callable(array($GLOBALS['error'],'debugBegin'))) {
828 $GLOBALS['error']->debugBegin();
829 }
830 }
831 function debugEnd() {
832 if(is_object($GLOBALS['error']) && @is_callable(array($GLOBALS['error'],'debugEnd'))) {
833 $GLOBALS['error']->debugEnd();
834 }
835 }
836
837
838 // Init services array:
839 $T3_SERVICES = array();
840
841 // Error & exception handling
842 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] = $TYPO3_CONF_VARS['SYS']['productionExceptionHandler'];
843 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionalErrors'] = $TYPO3_CONF_VARS['SYS']['exceptionalErrors'];
844
845 // Mail sending via Swift Mailer
846 if ($TYPO3_CONF_VARS['MAIL']['substituteOldMailAPI']) {
847 $TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/utility/class.t3lib_utility_mail.php']['substituteMailDelivery'][] = 't3lib_mail_SwiftMailerAdapter';
848 }
849
850 // Turn error logging on/off.
851 if (($displayErrors = intval($TYPO3_CONF_VARS['SYS']['displayErrors'])) != '-1') {
852 if ($displayErrors == 2) { // Special value "2" enables this feature only if $TYPO3_CONF_VARS[SYS][devIPmask] matches
853 if (t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) {
854 $displayErrors = 1;
855 } else {
856 $displayErrors = 0;
857 }
858 }
859 if ($displayErrors == 0) {
860 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionalErrors'] = 0;
861 }
862 if ($displayErrors == 1) {
863 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] = $TYPO3_CONF_VARS['SYS']['debugExceptionHandler'];
864 define('TYPO3_ERRORHANDLER_MODE','debug');
865 }
866
867 @ini_set('display_errors', $displayErrors);
868 } elseif (t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) {
869 // with displayErrors = -1 (default), turn on debugging if devIPmask matches:
870 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] = $TYPO3_CONF_VARS['SYS']['debugExceptionHandler'];
871 }
872
873
874
875 // Set PHP memory limit depending on value of $TYPO3_CONF_VARS["SYS"]["setMemoryLimit"]
876 if(intval($TYPO3_CONF_VARS["SYS"]["setMemoryLimit"])>16) {
877 @ini_set('memory_limit',intval($TYPO3_CONF_VARS["SYS"]["setMemoryLimit"]).'m');
878 }
879
880
881 // setting the request type so devs exactly know what type of request it is
882 define('TYPO3_REQUESTTYPE_FE', 1);
883 define('TYPO3_REQUESTTYPE_BE', 2);
884 define('TYPO3_REQUESTTYPE_CLI', 4);
885 define('TYPO3_REQUESTTYPE_AJAX', 8);
886 define('TYPO3_REQUESTTYPE_INSTALL', 16);
887 define('TYPO3_REQUESTTYPE',
888 (TYPO3_MODE == 'FE' ? TYPO3_REQUESTTYPE_FE : 0) |
889 (TYPO3_MODE == 'BE' ? TYPO3_REQUESTTYPE_BE : 0) |
890 ((defined('TYPO3_cliMode') && TYPO3_cliMode) ? TYPO3_REQUESTTYPE_CLI : 0) |
891 ((defined('TYPO3_enterInstallScript') && TYPO3_enterInstallScript) ? TYPO3_REQUESTTYPE_INSTALL : 0) |
892 ($TYPO3_AJAX ? TYPO3_REQUESTTYPE_AJAX : 0)
893 );
894
895
896 // *********************
897 // Autoloader
898 // *********************
899 require_once(PATH_t3lib . 'class.t3lib_autoloader.php');
900 t3lib_autoloader::registerAutoloader();
901
902
903 // Load extensions:
904 if (TYPO3_MODE=='FE' && is_object($TT)) $TT->push('Loading localconf.php extensions','');
905 $TYPO3_LOADED_EXT = t3lib_extMgm::typo3_loadExtensions();
906 if ($TYPO3_LOADED_EXT['_CACHEFILE']) {
907 require(PATH_typo3conf.$TYPO3_LOADED_EXT['_CACHEFILE'].'_ext_localconf.php');
908 } else {
909 $temp_TYPO3_LOADED_EXT = $TYPO3_LOADED_EXT;
910 foreach ($temp_TYPO3_LOADED_EXT as $_EXTKEY => $temp_lEDat) {
911 if (is_array($temp_lEDat) && $temp_lEDat['ext_localconf.php']) {
912 $_EXTCONF = $TYPO3_CONF_VARS['EXT']['extConf'][$_EXTKEY];
913 require($temp_lEDat['ext_localconf.php']);
914 }
915 }
916 }
917 if (TYPO3_MODE=='FE' && is_object($TT)) $TT->pull();
918
919 require_once(t3lib_extMgm::extPath('lang') . 'lang.php');
920
921 // Define disposal of caching framewor for core caches:
922 define('TYPO3_UseCachingFramework', (bool)$GLOBALS['TYPO3_CONF_VARS']['SYS']['useCachingFramework']);
923 // Define "TYPO3_DLOG" constant
924 define('TYPO3_DLOG', $GLOBALS['TYPO3_CONF_VARS']['SYS']['enable_DLOG']);
925
926 define('TYPO3_ERROR_DLOG', $GLOBALS['TYPO3_CONF_VARS']['SYS']['enable_errorDLOG']);
927 define('TYPO3_EXCEPTION_DLOG', $GLOBALS['TYPO3_CONF_VARS']['SYS']['enable_exceptionDLOG']);
928
929 // Unsetting other reserved global variables:
930 // Those which are/can be set in "stddb/tables.php" files:
931 unset($PAGES_TYPES);
932 unset($ICON_TYPES);
933 unset($TCA);
934 unset($TBE_MODULES);
935 unset($TBE_STYLES);
936 unset($FILEICONS);
937
938 // Those set in init.php:
939 unset($WEBMOUNTS);
940 unset($FILEMOUNTS);
941 unset($BE_USER);
942
943 // Those set otherwise:
944 unset($TBE_MODULES_EXT);
945 unset($TCA_DESCR);
946 unset($LOCAL_LANG);
947 unset($TYPO3_AJAX);
948
949
950 // Setting some global vars:
951 $EXEC_TIME = time(); // $EXEC_TIME is set so that the rest of the script has a common value for the script execution time
952 $SIM_EXEC_TIME = $EXEC_TIME; // $SIM_EXEC_TIME is set to $EXEC_TIME but can be altered later in the script if we want to simulate another execution-time when selecting from eg. a database
953 $ACCESS_TIME = $EXEC_TIME - ($EXEC_TIME % 60); // $ACCESS_TIME is a common time in minutes for access control
954 $SIM_ACCESS_TIME = $ACCESS_TIME; // if $SIM_EXEC_TIME is changed this value must be set accordingly
955
956 ?>