Fixed bug #17073: Final Integration of the pagetree (Thanks to Stefan Galinski)
[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 *
11 * $Id$
12 * Revised for TYPO3 3.6 2/2003 by Kasper Skårhøj
13 *
14 * @author Kasper Skårhøj <kasperYYYY@typo3.com>
15 */
16
17 if (!defined ('PATH_typo3conf')) die ('The configuration path was not properly defined!');
18
19 //Security related constant: Default value of fileDenyPattern
20 define('FILE_DENY_PATTERN_DEFAULT', '\.(php[3-6]?|phpsh|phtml)(\..*)?$|^\.htaccess$');
21
22 //Security related constant: Comma separated list of file extensions that should be registered as php script file extensions
23 define('PHP_EXTENSIONS_DEFAULT', 'php,php3,php4,php5,php6,phpsh,inc,phtml');
24
25 $TYPO3_CONF_VARS = array(
26 'GFX' => array( // Configuration of the image processing features in TYPO3. 'IM' and 'GD' are short for ImageMagick and GD library respectively.
27 'image_processing' => TRUE, // Boolean: Enables image processing features. Disabling this means NO image processing with either GD or IM!
28 '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
29 '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)
30 '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.
31 '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!
32
33 'gdlib' => TRUE, // Boolean: Enables the use of GD.
34 '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!
35
36 'im' => TRUE, // Boolean: Enables the use of IM.
37 'im_path' => '/usr/bin/', // Path to the IM tools 'convert', 'combine', 'identify'.
38 '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/'.
39
40 'im_version_5' => '', // String: Set this if you're using ImageMagick/GraphicsMagick but not IM 4.x. Setting this value will automatically configure some settings for use with the specified program version. Allowed values are: "im4", "im5", "im6" and "gm" (uses GraphicsMagick instead of ImageMagick).
41 '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!
42 '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...
43 '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!)
44 '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>
45 '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...
46 '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.
47 'im_noScaleUp' => FALSE, // Boolean: If set, images are not being scaled up if told so (in t3lib/stdgraphics.php)
48 'im_combine_filename' => 'combine', // String: Latest ImageMagick versions has changed the name of combine to composite. Configure here if needed.
49 '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.
50 '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
51 '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.
52 'jpg_quality' => 70, // Integer: Default JPEG generation quality
53 '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.
54 'TTFLocaleConv' => '', // String: Enter locale conversion string used to recode input to TrueType functions. Eg. 'cp1250..UTF-8'. Deprecated from ver. 3.6.0 of TYPO3. Set up <a href="#BE-forceCharset">[BE][forceCharset]</a> as strings are automatically converted from database charset to UTF-8.
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 '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.
60 '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.
61 '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.
62 '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.
63 '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>
64 '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).
65 '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.
66 '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.
67 '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.
68 '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>
69 'enable_DLOG' => FALSE, // Boolean: Whether the developer log is enabled. See constant "TYPO3_DLOG"
70 'ddmmyy' => 'd-m-y', // Format of Date-Month-Year - see PHP-function <a href="http://php.net/date" target="_blank">date()</a>
71 'hhmm' => 'H:i', // Format of Hours-Minutes - see PHP-function <a href="http://php.net/date" target="_blank">date()</a>
72 'USdateFormat' => FALSE, // Boolean: If true, dates entered in the TCEforms of the backend will be formatted mm-dd-yyyy
73 '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).
74 '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.
75 'loginCopyrightShowVersion' => FALSE, // Boolean: If set, the current TYPO3 version is shown.
76 'curlUse' => FALSE, // Boolean: If set, try to use cURL to fetch external URLs
77 'curlProxyServer' => '', // String: Proxyserver as http://proxy:port/.
78 'curlProxyTunnel' => FALSE, // Boolean: If set, use a tunneled connection through the proxy (usefull for websense etc.).
79 'curlProxyUserPass' => '', // String: Proxyserver authentication user:pass.
80 'curlTimeout' => 0, // Integer: Timeout value for cURL requests in seconds. 0 means to wait indefinitely.
81 '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'
82 '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!
83 'contentTable' => '', // This is the page-content table (Normally 'tt_content')
84 '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.
85 '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)
86 '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>
87 '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.
88 '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.
89 'no_pconnect' => FALSE, // Boolean: If true, "connect" is used instead of "pconnect" when connecting to the database!
90 '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.
91 '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!
92 '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.
93 '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.
94 'forceReturnPath' => FALSE, // Boolean: 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. This has no effect if safe_mode in PHP is on.
95 '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.
96 '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.
97 '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>
98 '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>
99 '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.
100 '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.
101 '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.
102 'systemLocale' => '', // String: locale used for certain system related functions; for example escaping shell commands.
103 '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".
104 'reverseProxyIP' => '', // String: list of IP addresses. If TYPO3 is behind one or more (intransparent) reverese proxies the IP addresses must be added here.
105 '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.
106 'reverseProxyPrefix' => '', // String: optional prefix to be added to the internal URL (SCRIPT_NAME and REQUEST_URI).
107 '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.
108 '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>.
109 'caching' => array(
110 'cacheFrontends' => array(
111 't3lib_cache_frontend_VariableFrontend' => 't3lib_cache_frontend_VariableFrontend',
112 't3lib_cache_frontend_StringFrontend' => 't3lib_cache_frontend_StringFrontend',
113 't3lib_cache_frontend_PhpFrontend' => 't3lib_cache_frontend_PhpFrontend',
114 ),
115 'cacheBackends' => array(
116 't3lib_cache_backend_DbBackend' => 't3lib_cache_backend_DbBackend',
117 't3lib_cache_backend_FileBackend' => 't3lib_cache_backend_FileBackend',
118 't3lib_cache_backend_MemcachedBackend' => 't3lib_cache_backend_MemcachedBackend',
119 't3lib_cache_backend_PdoBackend' => 't3lib_cache_backend_PdoBackend',
120 't3lib_cache_backend_RedisBackend' => 't3lib_cache_backend_RedisBackend',
121 't3lib_cache_backend_ApcBackend' => 't3lib_cache_backend_ApcBackend',
122 't3lib_cache_backend_NullBackend' => 't3lib_cache_backend_NullBackend',
123 't3lib_cache_backend_TransientMemoryBackend' => 't3lib_cache_backend_TransientMemoryBackend',
124 ),
125 'cacheConfigurations' => array(
126 'cache_hash' => array(
127 'frontend' => 't3lib_cache_frontend_VariableFrontend',
128 'backend' => 't3lib_cache_backend_DbBackend',
129 'options' => array(
130 'cacheTable' => 'cachingframework_cache_hash',
131 'tagsTable' => 'cachingframework_cache_hash_tags',
132 )
133 ),
134 'cache_pages' => array(
135 'frontend' => 't3lib_cache_frontend_VariableFrontend',
136 'backend' => 't3lib_cache_backend_DbBackend',
137 'options' => array(
138 'cacheTable' => 'cachingframework_cache_pages',
139 'tagsTable' => 'cachingframework_cache_pages_tags',
140 )
141 ),
142 'cache_pagesection' => array(
143 'frontend' => 't3lib_cache_frontend_VariableFrontend',
144 'backend' => 't3lib_cache_backend_DbBackend',
145 'options' => array(
146 'cacheTable' => 'cachingframework_cache_pagesection',
147 'tagsTable' => 'cachingframework_cache_pagesection_tags',
148 )
149 )
150 )
151 ),
152 '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.
153 '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>
154 '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.
155 '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.
156 '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.
157 'errorHandlerErrors'=> E_ALL ^ E_NOTICE, // Integer: The E_* constant that will be handled by the errorhandler. Default is "E_ALL ^ E_NOTICE".
158 '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.
159 'enable_errorDLOG' => 0, // Boolean: If set, errors are written to the developer log (requires an installed *devlog* extension).
160 'enable_exceptionDLOG' => 0, // Boolean: If set, exceptions are written to the developer log (requires an installed *devlog* extension).
161 '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).
162 '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).
163 'locallangXMLOverride' => array(), // For extension/overriding of the arrays in 'locallang' files in frontend and backend. See 'Inside TYPO3' for more information.
164 ),
165 'EXT' => array ( // Options related to the Extension Management
166 '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.)
167 'allowGlobalInstall' => FALSE, // Boolean: If set, global extensions in typo3/ext/ are allowed to be installed, updated and deleted etc.
168 'allowLocalInstall' => TRUE, // Boolean: If set, local extensions in typo3conf/ext/ are allowed to be installed, updated and deleted etc.
169 'allowSystemInstall' => FALSE, // Boolean: If set, you can install extensions in the sysext/ dir. Use this to upgrade the 'cms' and 'lang' extensions.
170 '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.
171 '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.
172
173 'requiredExt' => 'cms,lang,sv,em,list', // String (exclude). List of extensions which are REQUIRED and cannot be unloaded by the Extension Manager!
174 '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!
175 '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>
176 '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!
177 'extList_FE' => '', // String (exclude). Same as extList, but only this extensions are loaded in FE
178 'extConf' => array( // Config-options for extensions, stored as serialized arrays by extension-keys. Handled automatically by the EM.
179 // '--key--' => array()
180 ),
181 ),
182 'BE' => array( // Backend Configuration.
183 'unzip_path' => '', // Path to "unzip".
184 '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>
185 'fileadminDir' => 'fileadmin/', // Path to the fileadmin dir. This is relative to PATH_site. (Automatically mounted for admin-users if set)
186 '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.
187 'RTE_imageStorageDir' => 'uploads/', // Default storage directory for Rich Text Editor files
188 '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.
189 'staticFileEditPath' => 'fileadmin/static/', // Path to directory with static files for editing (see table sys_staticfiles_edit). Relative to PATH_site.
190 '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/'.
191 '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!
192 '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!
193 '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.
194 'fileCreateMask' => '0644', // File mode mask for Unix file systems (when files are uploaded/created).
195 'folderCreateMask' => '0755', // As above, but for folders.
196 '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.
197 '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.
198 '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.
199 '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).
200 'sessionTimeout' => 3600, // Integer: seconds. Session time out for backend users. Default is 3600 seconds = 1 hour.
201 '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())
202 '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.
203 '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>
204 '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.
205 'enabledBeUserIPLock' => TRUE, // Boolean: If set, the User/Group TSconfig option 'option.lockToIP' is enabled.
206 '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.
207 '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.
208 '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.
209 '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>
210 '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.
211 'usePHPFileFunctions' => TRUE, // Boolean: If set, all fileoperations are done by the default PHP-functions. Default on Unix is using the system commands by exec(). You need to set this flag under safe_mode.
212 '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 misc/advanced.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.
213 '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.
214 '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.
215 '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.
216 'defaultUserTSconfig' => 'options.enableBookmarks=1
217 options.enableShowPalettes=1
218 options.file_list.enableDisplayBigControlPanel=selectable
219 options.file_list.enableDisplayThumbnails=selectable
220 options.file_list.enableClipBoard=selectable
221 options.pageTree {
222 doktypesToShowInNewPageDragArea = 1,6,4,7,3,254,255,199
223 }
224
225 options.contextMenu {
226 table {
227 pages_root {
228 disableItems =
229
230 items {
231 100 = ITEM
232 100 {
233 name = view
234 label = LLL:EXT:lang/locallang_core.xml:cm.view
235 spriteIcon = actions-document-view
236 displayCondition = canBeViewed != 0
237 callbackAction = viewPage
238 }
239
240 200 = ITEM
241 200 {
242 name = new
243 label = LLL:EXT:lang/locallang_core.xml:cm.new
244 spriteIcon = actions-page-new
245 displayCondition = canCreateNewPages != 0
246 callbackAction = newPageWizard
247 }
248
249 300 = DIVIDER
250
251 400 = ITEM
252 400 {
253 name = history
254 label = LLL:EXT:lang/locallang_misc.xml:CM_history
255 spriteIcon = actions-document-history-open
256 displayCondition = canShowHistory != 0
257 callbackAction = openHistoryPopUp
258 }
259 }
260 }
261
262 pages {
263 disableItems =
264
265 items {
266 100 = ITEM
267 100 {
268 name = view
269 label = LLL:EXT:lang/locallang_core.xml:cm.view
270 spriteIcon = actions-document-view
271 displayCondition = canBeViewed != 0
272 callbackAction = viewPage
273 }
274
275 200 = DIVIDER
276
277 300 = ITEM
278 300 {
279 name = disable
280 label = LLL:EXT:lang/locallang_core.xml:cm.hide
281 spriteIcon = actions-edit-hide
282 displayCondition = getRecord|hidden = 0 && canBeDisabledAndEnabled != 0
283 callbackAction = disablePage
284 }
285
286 400 = ITEM
287 400 {
288 name = enable
289 label = LLL:EXT:lang/locallang_core.xml:cm.unhide
290 spriteIcon = actions-edit-unhide
291 displayCondition = getRecord|hidden = 1 && canBeDisabledAndEnabled != 0
292 callbackAction = enablePage
293 }
294
295 500 = ITEM
296 500 {
297 name = edit
298 label = LLL:EXT:lang/locallang_core.xml:cm.edit
299 spriteIcon = actions-document-open
300 displayCondition = canBeEdited != 0
301 callbackAction = editPageProperties
302 }
303
304 600 = ITEM
305 600 {
306 name = info
307 label = LLL:EXT:lang/locallang_core.xml:cm.info
308 spriteIcon = actions-document-info
309 displayCondition = canShowInfo != 0
310 callbackAction = openInfoPopUp
311 }
312
313 700 = ITEM
314 700 {
315 name = history
316 label = LLL:EXT:lang/locallang_misc.xml:CM_history
317 spriteIcon = actions-document-history-open
318 displayCondition = canShowHistory != 0
319 callbackAction = openHistoryPopUp
320 }
321
322 800 = DIVIDER
323
324 900 = SUBMENU
325 900 {
326 label = LLL:EXT:lang/locallang_core.xml:cm.copyPasteActions
327
328 100 = ITEM
329 100 {
330 name = new
331 label = LLL:EXT:lang/locallang_core.xml:cm.new
332 spriteIcon = actions-page-new
333 displayCondition = canCreateNewPages != 0
334 callbackAction = newPageWizard
335 }
336
337 200 = DIVIDER
338
339 300 = ITEM
340 300 {
341 name = cut
342 label = LLL:EXT:lang/locallang_core.xml:cm.cut
343 spriteIcon = actions-edit-cut
344 displayCondition = isInCutMode = 0 && canBeCut != 0 && isMountPoint != 1
345 callbackAction = enableCutMode
346 }
347
348 400 = ITEM
349 400 {
350 name = cut
351 label = LLL:EXT:lang/locallang_core.xml:cm.cut
352 spriteIcon = actions-edit-cut-release
353 displayCondition = isInCutMode = 1 && canBeCut != 0
354 callbackAction = disableCutMode
355 }
356
357 500 = ITEM
358 500 {
359 name = copy
360 label = LLL:EXT:lang/locallang_core.xml:cm.copy
361 spriteIcon = actions-edit-copy
362 displayCondition = isInCopyMode = 0 && canBeCopied != 0
363 callbackAction = enableCopyMode
364 }
365
366 600 = ITEM
367 600 {
368 name = copy
369 label = LLL:EXT:lang/locallang_core.xml:cm.copy
370 spriteIcon = actions-edit-copy-release
371 displayCondition = isInCopyMode = 1 && canBeCopied != 0
372 callbackAction = disableCopyMode
373 }
374
375 700 = ITEM
376 700 {
377 name = pasteInto
378 label = LLL:EXT:lang/locallang_core.xml:cm.pasteinto
379 spriteIcon = actions-document-paste-into
380 displayCondition = getContextInfo|inCopyMode = 1 || getContextInfo|inCutMode = 1 && canBePastedInto != 0
381 callbackAction = pasteIntoNode
382 }
383
384 800 = ITEM
385 800 {
386 name = pasteAfter
387 label = LLL:EXT:lang/locallang_core.xml:cm.pasteafter
388 spriteIcon = actions-document-paste-after
389 displayCondition = getContextInfo|inCopyMode = 1 || getContextInfo|inCutMode = 1 && canBePastedAfter != 0
390 callbackAction = pasteAfterNode
391 }
392
393 900 = DIVIDER
394
395 1000 = ITEM
396 1000 {
397 name = delete
398 label = LLL:EXT:lang/locallang_core.xml:cm.delete
399 spriteIcon = actions-edit-delete
400 displayCondition = canBeRemoved != 0 && isMountPoint != 1
401 callbackAction = removeNode
402 }
403 }
404
405 1000 = SUBMENU
406 1000 {
407 label = LLL:EXT:lang/locallang_core.xml:cm.branchActions
408
409 100 = ITEM
410 100 {
411 name = mountAsTreeroot
412 label = LLL:EXT:lang/locallang_core.xml:cm.tempMountPoint
413 spriteIcon = actions-system-extension-documentation
414 displayCondition = canBeTemporaryMountPoint != 0 && isMountPoint = 0
415 callbackAction = mountAsTreeRoot
416 }
417
418 200 = DIVIDER
419
420 300 = ITEM
421 300 {
422 name = expandBranch
423 label = LLL:EXT:lang/locallang_core.xml:cm.expandBranch
424 displayCondition =
425 callbackAction = expandBranch
426 }
427
428 400 = ITEM
429 400 {
430 name = collapseBranch
431 label = LLL:EXT:lang/locallang_core.xml:cm.collapseBranch
432 displayCondition =
433 callbackAction = collapseBranch
434 }
435 }
436 }
437 }
438 }
439 }
440 ', // String (exclude). Enter lines of default backend user/group TSconfig.
441 'defaultPageTSconfig' => 'mod.web_list.enableDisplayBigControlPanel=selectable
442 mod.web_list.enableClipBoard=selectable
443 mod.web_list.enableLocalizationView=selectable', // String (exclude).Enter lines of default Page TSconfig.
444 'defaultPermissions' => array ( // Default permissions set for new pages in t3lib/tce_main.php. Keys are 'show,edit,delete,new,editcontent'. Enter as comma-list
445 // 'user' => '', // default in tce_main is 'show,edit,delete,new,editcontent'. If this is set (uncomment), this value is used instead.
446 // 'group' => '', // default in tce_main is 'show,edit,new,editcontent'. If this is set (uncomment), this value is used instead.
447 // 'everybody' => '' // default in tce_main is ''. If this is set (uncomment), this value is used instead.
448 ),
449 '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.
450 'defaultUC' => array ( // Override default settings for BE-users. See class.t3lib_beuserauth.php, array $uc_default
451 ),
452 // 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.
453 // 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.
454 // You list extensions comma-separated. If the value is a '*' every extension is matched
455 // If no fileextension, true is returned if 'allow' is '*', false if 'deny' is '*' and true if none of these matches
456 // This configuration below accepts everything in ftpspace and everything in webspace except php3,php4,php5 or php files
457 'fileExtensions' => array (
458 'webspace' => array('allow'=>'', 'deny'=> PHP_EXTENSIONS_DEFAULT),
459 'ftpspace' => array('allow'=>'*', 'deny'=>'')
460 ),
461 '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.
462 '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
463 'interfaces' => 'backend', // This determines which interface options is available in the login prompt and in which order (All options: ",backend,frontend")
464 'useOnContextMenuHandler' => TRUE, // Boolean: If set, the context menus (clickmenus) in the backend are activated on right-click - although this is not a XHTML attribute!
465 '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.
466 '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
467 'loginNewsTitle' => '', // Define alternative header message for the LoginNews. If this var is empty, the default header "Important messages:" is displayed.
468 'XLLfile' => array(), // @deprecated For extension/overriding of the arrays in 'locallang' files in the backend. See 'Inside TYPO3' for more information.
469 'notificationPrefix' => '[TYPO3 Note]', // String: Used to prefix the subject of mails sent in the taskcenter
470 'accessListRenderMode' => 'checkbox', // Can be "singlebox", "checkbox" or blank. Refers to the "renderMode" for the selector boxes in be-groups configuration.
471 'explicitADmode' => 'explicitDeny', // Sets the general allow/deny mode for selector box values. Value can be either "explicitAllow" or "explicitDeny", nothing else!
472 'TSconfigConditions' => TRUE, // Boolean: When set it is possible to have TypoScript like conditions in BE Page/User/Group TS-Config
473 '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)
474 '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)
475 'compactFlexFormXML' => 0, // If set, the flexform XML will not contain indentation spaces making XML more compact
476 '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.
477 '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.
478 '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.
479 '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 misc/advanced.htaccess or the _.htaccess file from the dummy package)</p><p>If false the filemtime will be appended as a query-string.</p>
480 '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.
481 'allowDonateWindow' => TRUE, // Boolean: Defines whether to display a TYPO3 donate window to admin users that have been working with the system for more than three months.
482 'debug' => FALSE, // Boolean: If set, the loginrefresh is disabled and pageRenderer is set to debug mode. Use this to debug the backend only!
483 '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.
484 'SC_alt_db_navframe::expandCollapse' => 'typo3/alt_db_navframe.php:SC_alt_db_navframe->ajaxExpandCollapse',
485 'SC_alt_file_navframe::expandCollapse' => 'typo3/alt_file_navframe.php:SC_alt_file_navframe->ajaxExpandCollapse',
486 'TYPO3_tcefile::process' => 'typo3/classes/class.typo3_tcefile.php:TYPO3_tcefile->processAjaxRequest',
487 't3lib_TCEforms_inline::createNewRecord' => 't3lib/class.t3lib_tceforms_inline.php:t3lib_TCEforms_inline->processAjaxRequest',
488 't3lib_TCEforms_inline::getRecordDetails' => 't3lib/class.t3lib_tceforms_inline.php:t3lib_TCEforms_inline->processAjaxRequest',
489 't3lib_TCEforms_inline::synchronizeLocalizeRecords' => 't3lib/class.t3lib_tceforms_inline.php:t3lib_TCEforms_inline->processAjaxRequest',
490 't3lib_TCEforms_inline::setExpandedCollapsedState' => 't3lib/class.t3lib_tceforms_inline.php:t3lib_TCEforms_inline->processAjaxRequest',
491 't3lib_TCEforms_suggest::searchRecord' => 't3lib/tceforms/class.t3lib_tceforms_suggest.php:t3lib_TCEforms_suggest->processAjaxRequest',
492 'ShortcutMenu::getGroups' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->getAjaxShortcutGroups',
493 'ShortcutMenu::saveShortcut' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->setAjaxShortcut',
494 'ShortcutMenu::render' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->renderAjax',
495 'ShortcutMenu::delete' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->deleteAjaxShortcut',
496 'ShortcutMenu::create' => 'typo3/classes/class.shortcutmenu.php:ShortcutMenu->createAjaxShortcut',
497 'ModuleMenu::saveMenuState' => 'typo3/classes/class.modulemenu.php:ModuleMenu->saveMenuState',
498 'ModuleMenu::getData' => 'typo3/classes/class.modulemenu.php:ModuleMenu->getModuleData',
499 'BackendLogin::login' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->login',
500 'BackendLogin::logout' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->logout',
501 'BackendLogin::refreshLogin' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->refreshLogin',
502 'BackendLogin::isTimedOut' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->isTimedOut',
503 'BackendLogin::getChallenge' => 'typo3/classes/class.ajaxlogin.php:AjaxLogin->getChallenge',
504 'DonateWindow::disable' => 'typo3/classes/class.donatewindow.php:DonateWindow->disable',
505 'DonateWindow::postpone' => 'typo3/classes/class.donatewindow.php:DonateWindow->postpone',
506 'ExtDirect::getAPI' => 't3lib/extjs/class.t3lib_extjs_extdirectapi.php:t3lib_extjs_ExtDirectApi->getAPI',
507 'ExtDirect::route' => 't3lib/extjs/class.t3lib_extjs_extdirectrouter.php:t3lib_extjs_ExtDirectRouter->route',
508 ),
509 'XCLASS' => array(), // See 'Inside TYPO3' document for more information.
510 ),
511 'FE' => array( // Configuration for the TypoScript frontend (FE). Nothing here relates to the administration backend!
512 '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/
513 '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!
514 '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.
515 'tidy_path' => 'tidy -i --quiet true --tidy-mark true -wrap 0 -raw', // Path with options for tidy. For XHTML output, add " --output-xhtml true"
516 '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>
517 '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'
518 '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)
519 'allowedTempPaths' => '', // Additional paths allowed for temporary images. Used with imgResource. Eg. 'alttypo3temp/,another_temp_dir/';
520 'debug' => FALSE, // Boolean: If set, some debug HTML-comments may be output somewhere. Can also be set by TypoScript.
521 '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.
522 '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
523 '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.
524 '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.
525 'formmailMaxAttachmentSize' => 250000, // Integer: Sets the maximum allowed size (in bytes) of attachments for the internal "formmail" feature.
526 '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.
527 '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>
528 '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.
529 '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.
530 '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>
531 '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.
532 '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.
533 'userFuncClassPrefix' => 'user_', // This prefix must be the first part of any function or class name called from TypoScript, for instance in the stdWrap function.
534 'addRootLineFields' => '', // Comma-list of fields from the 'pages'-table. These fields are added to the select query for fields in the rootline.
535 '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';
536 '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.
537 '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)
538 '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.
539 '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).
540 '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>
541 '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.
542 '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.
543 '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).
544 'defaultUserTSconfig' => '', // String (textarea). Enter lines of default frontend user/group TSconfig.
545 'defaultTypoScript_constants' => '', // String (textarea). Enter lines of default TypoScript, constants-field.
546 'defaultTypoScript_constants.' => array(), // Lines of TS to include after a static template with the uid = the index in the array (Constants)
547 'defaultTypoScript_setup' => '', // Enter lines of default TypoScript, setup-field.
548 'defaultTypoScript_setup.' => array(), // As above, but for Setup
549 'defaultTypoScript_editorcfg' => '', // String (textarea). Enter lines of default TypoScript, editorcfg-field (Backend Editor Configuration)
550 'defaultTypoScript_editorcfg.' => array(), // As above, but for Backend Editor Configuration
551 'dontSetCookie' => FALSE, // Boolean: If set, the no cookies is attempted to be set in the front end. Of course no userlogins are possible either...
552 'additionalAbsRefPrefixDirectories' => '', // Enter additional directories to be prepended with absRefPrefix. Directories must be comma-separated. TYPO3 already prepends the following directories: media/, typo3conf/ext/, fileadmin/
553 '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.
554 // array('IPmaskList_1','fe_group uid'), array('IPmaskList_2','fe_group uid')
555 ),
556 '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)
557 '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'))
558 'enable_mount_pids' => TRUE, // Boolean: If set to "1", the mount_pid feature allowing 'symlinks' in the page tree (for frontend operation) is allowed.
559 '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()
560 '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"
561 '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)
562 '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).
563 '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
564 '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 misc/advanced.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>
565 'XCLASS' => array(), // See 'Inside TYPO3' document for more information.
566 ),
567 'MAIL' => array( // Mail configurations to tune how t3lib_mail classes will send their mails.
568 '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>
569 '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".
570 'transport_smtp_encrypt' => FALSE, // Boolean: <em>only with transport=smtp</em>: Connect to the server using encryption and TLS. Requires openssl library.
571 'transport_smtp_username' => '', // String: <em>only with transport=smtp</em>: If your SMTP server requires authentication, enter your username here.
572 'transport_smtp_password' => '', // String: <em>only with transport=smtp</em>: If your SMTP server requires authentication, enter your password here.
573 '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)
574 '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.
575 ),
576 'MODS' => array( // Backend Module Configuration (obsolete, make extension instead)
577 ),
578 'USER' => array( // Here you may define your own setup-vars for use in your include-scripts. (obsolete, make extension instead)
579 ),
580 '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.
581 'GLOBAL' => array(
582 'softRefParser' => array(
583 'substitute' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
584 'notify' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
585 'images' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
586 'typolink' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
587 'typolink_tag' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
588 'TSconfig' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
589 'TStemplate' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
590 'ext_fileref' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
591 'email' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
592 'url' => 't3lib/class.t3lib_softrefproc.php:&t3lib_softrefproc',
593 ),
594 'softRefParser_GL' => array(), // Global soft reference parsers
595 'cliKeys' => array( // Arrays of EXT:file and module name pairs. See EXT:lowlevel/ext_localconf.php for example.
596 )
597 ),
598 't3lib/class.t3lib_tsfebeuserauth.php' => array(
599 'frontendEditingController' => array(
600 'default' => 't3lib/class.t3lib_frontendedit.php:t3lib_frontendedit'
601 )
602 ),
603 'ExtDirect' => array( // array of key value pairs (provider -> location:className) that holds the classes for the ExtDirect functionality
604 'TYPO3.CSH.ExtDirect' => 't3lib/extjs/dataprovider/class.extdirect_dataprovider_contexthelp.php:extDirect_DataProvider_ContextHelp',
605 'TYPO3.LiveSearchActions.ExtDirect' => 't3lib/extjs/dataprovider/class.extdirect_dataprovider_backendlivesearch.php:extDirect_DataProvider_BackendLiveSearch',
606 'TYPO3.BackendUserSettings.ExtDirect' => 't3lib/extjs/dataprovider/class.extdirect_dataprovider_beusersettings.php:extDirect_DataProvider_BackendUserSettings',
607 'TYPO3.ExtDirectStateProvider.ExtDirect' => 't3lib/extjs/dataprovider/class.extdirect_dataprovider_state.php:extDirect_DataProvider_State',
608 'TYPO3.Components.PageTree.DataProvider' => 't3lib/tree/pagetree/extdirect/class.t3lib_tree_pagetree_extdirect_tree.php:t3lib_tree_pagetree_extdirect_Tree',
609 'TYPO3.Components.PageTree.Commands' => 't3lib/tree/pagetree/extdirect/class.t3lib_tree_pagetree_extdirect_tree.php:t3lib_tree_pagetree_extdirect_Commands',
610 'TYPO3.Components.PageTree.ContextMenuDataProvider' => 't3lib/contextmenu/pagetree/extdirect/class.t3lib_contextmenu_pagetree_extdirect_contextmenu.php:t3lib_contextmenu_pagetree_extdirect_ContextMenu',
611 ),
612 ),
613 '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';
614 // '--key--' => array()
615 ),
616 'SVCONF' => array( // Here you may add manually set configuration options for services.
617 // Eg. ...['service_type']['setup']['my_option'] = 'my_value'; Setup options how to handle the service (call it or not and how when)
618 // Eg. ...['service_type']['default']['my_option'] = 'my_value';
619 // Eg. ...['service_type']['service_key']['my_option'] = 'my_value';
620 )
621 );
622 $T3_VAR = array(); // Initialize.
623
624 // TYPO3 version
625 $TYPO_VERSION = '4.5-dev'; // deprecated: use the constants defined below
626 define('TYPO3_version', $TYPO_VERSION);
627 define('TYPO3_branch', '4.5');
628 define('TYPO3_copyright_year', '1998-2010');
629 define('TYPO3_user_agent', 'User-Agent: TYPO3/'.TYPO3_version);
630
631 // Database-variables are cleared!
632 $typo_db = ''; // The database name
633 $typo_db_username = ''; // The database username
634 $typo_db_password = ''; // The database password
635 $typo_db_host = ''; // The database host
636 $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.
637 $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.
638
639 // Include localconf.php. Use this file to configure TYPO3 for your needs and database
640 if (!@is_file(PATH_typo3conf . 'localconf.php')) {
641 throw new Exception('localconf.php is not found!');
642 }
643 require(PATH_typo3conf.'localconf.php');
644
645
646 /**
647 * Checking for UTF-8 in the settings since TYPO3 4.5
648 *
649 * Since TYPO3 4.5, everything other than UTF-8 is deprecated.
650 * The -1 operator is used to see if the option was set in the installations localconf.php.
651 *
652 * [BE][forceCharset] is set to the charset that TYPO3 is using
653 * [SYS][setDBinit] is used to set the DB connection
654 * and both settings need to be adjusted for UTF-8 in order to work properly
655 */
656 // If this value is -1 then the setting has not been modified in localconf.php
657 if ($TYPO3_CONF_VARS['BE']['forceCharset'] == '-1' && $typo_db) {
658 if (t3lib_div::compat_version('4.5')) {
659 // 1) no option was set in localconf.php but the Update Wizard
660 // was already used, so the admin is knowing what he's doing,
661 // 2) a new installation with the new default value
662 $TYPO3_CONF_VARS['BE']['forceCharset'] = 'utf-8';
663 } elseif (TYPO3_enterInstallScript !== '1') {
664 // The value needs to be set in localconf.php
665 die('This installation was just upgraded to TYPO3 ' . TYPO3_branch . '. In this version, some default settings have changed.<br />' .
666 'You can continue to use your settings by specifying the former default values in localconf.php.<br />' .
667 'Please proceed to the Update Wizard in the TYPO3 Install Tool to update your configuration.');
668 }
669
670 } elseif ($TYPO3_CONF_VARS['BE']['forceCharset'] !== 'utf-8' && $typo_db) {
671 t3lib_div::deprecationLog('This TYPO3 installation does not enforce the UTF-8 character set.' . chr(10) .
672 'Everything other than UTF-8 is deprecated since TYPO3 4.5.' . chr(10) .
673 'The DB, its connection and TYPO3 should be migrated to UTF-8 therefore. Please check your setup.');
674 }
675
676
677 // If this value is -1 then the setting has not been modified in localconf.php
678 if ($TYPO3_CONF_VARS['SYS']['setDBinit'] == '-1' && $typo_db) {
679 if (t3lib_div::compat_version('4.5')) {
680 // 1) no option was set in localconf.php but the Update Wizard
681 // was already used, so the admin is knowing what he's doing,
682 // 2) a new installation with the new default value
683 $TYPO3_CONF_VARS['SYS']['setDBinit'] = 'SET NAMES utf8';
684 } elseif (TYPO3_enterInstallScript !== '1' && $typo_db) {
685 // The value needs to be set in localconf.php
686 die('This installation was just upgraded to TYPO3 ' . TYPO3_branch . '. In this version, some default settings have changed.<br />' .
687 'You can continue to use your settings by specifying the former default values in localconf.php.<br />' .
688 'Please proceed to the Update Wizard in the TYPO3 Install Tool to update your configuration.');
689 }
690
691 // Only accept "SET NAMES utf8" for this setting. Otherwise, a deprecation warning will be issued.
692 } elseif (!preg_match('/SET NAMES utf8/', $TYPO3_CONF_VARS['SYS']['setDBinit']) && $typo_db) {
693 // TODO: Add a link to a website with more information here
694 t3lib_div::deprecationLog('This TYPO3 installation is using the $TYPO3_CONF_VARS[\'SYS\'][\'setDBinit\'] property with the following value:' . chr(10) .
695 $TYPO3_CONF_VARS['SYS']['setDBinit'] . chr(10) . chr(10) .
696 'It looks like UTF-8 is not used for this connection.' . chr(10) . chr(10) .
697 'Everything other than UTF-8 is deprecated since TYPO3 4.5.' . chr(10) .
698 'The DB, its connection and TYPO3 should be migrated to UTF-8 therefore. Please check your setup.');
699 }
700
701
702
703 $timeZone = $GLOBALS['TYPO3_CONF_VARS']['phpTimeZone'];
704 if (empty($timeZone)) {
705 // time zone from the server environment (TZ env or OS query)
706 $defaultTimeZone = @date_default_timezone_get();
707 if ($defaultTimeZone !== '') {
708 $timeZone = $defaultTimeZone;
709 } else {
710 $timeZone = 'UTC';
711 }
712 }
713 // sets the default to avoid E_WARNINGs under PHP 5.3
714 date_default_timezone_set($timeZone);
715
716 // Defining the database setup as constants
717 define('TYPO3_db', $typo_db);
718 define('TYPO3_db_username', $typo_db_username);
719 define('TYPO3_db_password', $typo_db_password);
720 define('TYPO3_db_host', $typo_db_host);
721 define('TYPO3_tables_script', $typo_db_tables_script);
722 define('TYPO3_extTableDef_script', $typo_db_extTableDef_script);
723
724 // Defining backend system languages
725 // When adding new keys, remember to:
726 // - Update pages.lang item array (t3lib/stddb/tbl_be.php)
727 // - Add character encoding for lang. key in t3lib/class.t3lib_cs.php (default for new languages is "utf-8")
728 // - Add mappings for language in t3lib/class.t3lib_cs.php (TYPO3/ISO, language/script, script/charset)
729 // - Update 'setup' extension labels (sysext/setup/mod/locallang.xml)
730 // - Using translation server? Create new user with username = "language key", member of "translator" group, set to "language key" language.
731 // Thats it! Use extension "llxmltranslate" to begin translation. Language pack is automatically created in "typo3conf/l10n/[language key]/"
732 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');
733
734 // Unsetting the configured values. Use of these are deprecated.
735 unset($typo_db);
736 unset($typo_db_username);
737 unset($typo_db_password);
738 unset($typo_db_host);
739 unset($typo_db_tables_script);
740 unset($typo_db_extTableDef_script);
741
742 // Based on the configuration of the image processing some options may be forced:
743 if (!$GLOBALS['TYPO3_CONF_VARS']['GFX']['image_processing']) {
744 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im']=0;
745 $GLOBALS['TYPO3_CONF_VARS']['GFX']['gdlib']=0;
746 }
747 if (!$GLOBALS['TYPO3_CONF_VARS']['GFX']['im']) {
748 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_path']='';
749 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_path_lzw']='';
750 $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']='gif,jpg,jpeg,png';
751 $GLOBALS['TYPO3_CONF_VARS']['GFX']['thumbnails'] = 0;
752 }
753 if (!strcmp('0', $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_version_5'])) {
754 unset($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_version_5']); // Make sure that setting "im_version_5" to "0" means IM4
755 }
756 if ($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_version_5']) {
757 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_negate_mask'] = 1;
758 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_no_effects'] = 1;
759 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_mask_temp_ext_gif'] = 1;
760
761 if ($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_version_5']==='gm') {
762 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_negate_mask'] = 0;
763 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_imvMaskState'] = 0;
764 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_no_effects'] = 1;
765 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_v5effects'] = -1;
766 }
767 }
768 if ($GLOBALS['TYPO3_CONF_VARS']['GFX']['im_imvMaskState']) {
769 $GLOBALS['TYPO3_CONF_VARS']['GFX']['im_negate_mask']=$GLOBALS['TYPO3_CONF_VARS']['GFX']['im_negate_mask']?0:1;
770 }
771
772
773 // Convert type of "pageNotFound_handling" setting in case it was written as a string (e.g. if edited in Install Tool)
774 // TODO: Once the Install Tool handles such data types correctly, this workaround should be removed again...
775 if (!strcasecmp($TYPO3_CONF_VARS['FE']['pageNotFound_handling'],'TRUE')) {
776 $TYPO3_CONF_VARS['FE']['pageNotFound_handling'] = TRUE;
777 }
778
779
780 // simple debug function which prints output immediately
781 function xdebug($var = '', $debugTitle = 'xdebug') {
782 // If you wish to use the debug()-function, and it does not output something, please edit the IP mask in TYPO3_CONF_VARS
783 if (!t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) return;
784 t3lib_utility_Debug::debug($var, $debugTitle);
785 }
786 // Debug function which calls $GLOBALS['error'] error handler if available
787 function debug($variable='', $name='*variable*', $line='*line*', $file='*file*', $recursiveDepth=3, $debugLevel=E_DEBUG) {
788 // If you wish to use the debug()-function, and it does not output something, please edit the IP mask in TYPO3_CONF_VARS
789 if (!t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) return;
790
791 if(is_object($GLOBALS['error']) && @is_callable(array($GLOBALS['error'],'debug'))) {
792 $GLOBALS['error']->debug($variable, $name, $line, $file, $recursiveDepth, $debugLevel);
793 } else {
794 $title = ($name === '*variable*') ? '' : $name;
795 $group = ($line === '*line*') ? NULL : $line;
796 t3lib_utility_Debug::debug($variable, $title, $group);
797 }
798 }
799 function debugBegin() {
800 if(is_object($GLOBALS['error']) && @is_callable(array($GLOBALS['error'],'debugBegin'))) {
801 $GLOBALS['error']->debugBegin();
802 }
803 }
804 function debugEnd() {
805 if(is_object($GLOBALS['error']) && @is_callable(array($GLOBALS['error'],'debugEnd'))) {
806 $GLOBALS['error']->debugEnd();
807 }
808 }
809
810
811 // Init services array:
812 $T3_SERVICES = array();
813
814 // Error & exception handling
815 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] = $TYPO3_CONF_VARS['SYS']['productionExceptionHandler'];
816 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionalErrors'] = $TYPO3_CONF_VARS['SYS']['exceptionalErrors'];
817
818 // Mail sending via Swift Mailer
819 $TYPO3_CONF_VARS['SC_OPTIONS']['t3lib/utility/class.t3lib_utility_mail.php']['substituteMailDelivery'][] = 't3lib_mail_SwiftMailerAdapter';
820
821 // Turn error logging on/off.
822 if (($displayErrors = intval($TYPO3_CONF_VARS['SYS']['displayErrors'])) != '-1') {
823 if ($displayErrors == 2) { // Special value "2" enables this feature only if $TYPO3_CONF_VARS[SYS][devIPmask] matches
824 if (t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) {
825 $displayErrors = 1;
826 } else {
827 $displayErrors = 0;
828 }
829 }
830 if ($displayErrors == 0) {
831 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionalErrors'] = 0;
832 }
833 if ($displayErrors == 1) {
834 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] = $TYPO3_CONF_VARS['SYS']['debugExceptionHandler'];
835 define('TYPO3_ERRORHANDLER_MODE','debug');
836 }
837
838 @ini_set('display_errors', $displayErrors);
839 } elseif (t3lib_div::cmpIP(t3lib_div::getIndpEnv('REMOTE_ADDR'), $GLOBALS['TYPO3_CONF_VARS']['SYS']['devIPmask'])) {
840 // with displayErrors = -1 (default), turn on debugging if devIPmask matches:
841 $TYPO3_CONF_VARS['SC_OPTIONS']['errors']['exceptionHandler'] = $TYPO3_CONF_VARS['SYS']['debugExceptionHandler'];
842 }
843
844
845
846 // Set PHP memory limit depending on value of $TYPO3_CONF_VARS["SYS"]["setMemoryLimit"]
847 if(intval($TYPO3_CONF_VARS["SYS"]["setMemoryLimit"])>16) {
848 @ini_set('memory_limit',intval($TYPO3_CONF_VARS["SYS"]["setMemoryLimit"]).'m');
849 }
850
851
852 // setting the request type so devs exactly know what type of request it is
853 define('TYPO3_REQUESTTYPE_FE', 1);
854 define('TYPO3_REQUESTTYPE_BE', 2);
855 define('TYPO3_REQUESTTYPE_CLI', 4);
856 define('TYPO3_REQUESTTYPE_AJAX', 8);
857 define('TYPO3_REQUESTTYPE_INSTALL', 16);
858 define('TYPO3_REQUESTTYPE',
859 (TYPO3_MODE == 'FE' ? TYPO3_REQUESTTYPE_FE : 0) |
860 (TYPO3_MODE == 'BE' ? TYPO3_REQUESTTYPE_BE : 0) |
861 ((defined('TYPO3_cliMode') && TYPO3_cliMode) ? TYPO3_REQUESTTYPE_CLI : 0) |
862 ((defined('TYPO3_enterInstallScript') && TYPO3_enterInstallScript) ? TYPO3_REQUESTTYPE_INSTALL : 0) |
863 ($TYPO3_AJAX ? TYPO3_REQUESTTYPE_AJAX : 0)
864 );
865
866
867 // *********************
868 // Autoloader
869 // *********************
870 require_once(PATH_t3lib . 'class.t3lib_autoloader.php');
871 t3lib_autoloader::registerAutoloader();
872
873
874 // Load extensions:
875 if (TYPO3_MODE=='FE' && is_object($TT)) $TT->push('Loading localconf.php extensions','');
876 $TYPO3_LOADED_EXT = t3lib_extMgm::typo3_loadExtensions();
877 if ($TYPO3_LOADED_EXT['_CACHEFILE']) {
878 require(PATH_typo3conf.$TYPO3_LOADED_EXT['_CACHEFILE'].'_ext_localconf.php');
879 } else {
880 $temp_TYPO3_LOADED_EXT = $TYPO3_LOADED_EXT;
881 foreach ($temp_TYPO3_LOADED_EXT as $_EXTKEY => $temp_lEDat) {
882 if (is_array($temp_lEDat) && $temp_lEDat['ext_localconf.php']) {
883 $_EXTCONF = $TYPO3_CONF_VARS['EXT']['extConf'][$_EXTKEY];
884 require($temp_lEDat['ext_localconf.php']);
885 }
886 }
887 }
888 if (TYPO3_MODE=='FE' && is_object($TT)) $TT->pull();
889
890 require_once(t3lib_extMgm::extPath('lang') . 'lang.php');
891
892 // Define disposal of caching framewor for core caches:
893 define('TYPO3_UseCachingFramework', (bool)$GLOBALS['TYPO3_CONF_VARS']['SYS']['useCachingFramework']);
894 // Define "TYPO3_DLOG" constant
895 define('TYPO3_DLOG', $GLOBALS['TYPO3_CONF_VARS']['SYS']['enable_DLOG']);
896
897 define('TYPO3_ERROR_DLOG', $GLOBALS['TYPO3_CONF_VARS']['SYS']['enable_errorDLOG']);
898 define('TYPO3_EXCEPTION_DLOG', $GLOBALS['TYPO3_CONF_VARS']['SYS']['enable_exceptionDLOG']);
899
900 // Unsetting other reserved global variables:
901 // Those which are/can be set in "stddb/tables.php" files:
902 unset($PAGES_TYPES);
903 unset($ICON_TYPES);
904 unset($LANG_GENERAL_LABELS);
905 unset($TCA);
906 unset($TBE_MODULES);
907 unset($TBE_STYLES);
908 unset($FILEICONS);
909
910 // Those set in init.php:
911 unset($WEBMOUNTS);
912 unset($FILEMOUNTS);
913 unset($BE_USER);
914
915 // Those set otherwise:
916 unset($TBE_MODULES_EXT);
917 unset($TCA_DESCR);
918 unset($LOCAL_LANG);
919 unset($TYPO3_AJAX);
920
921
922 // Setting some global vars:
923 $EXEC_TIME = time(); // $EXEC_TIME is set so that the rest of the script has a common value for the script execution time
924 $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
925 $ACCESS_TIME = $EXEC_TIME - ($EXEC_TIME % 60); // $ACCESS_TIME is a common time in minutes for access control
926 $SIM_ACCESS_TIME = $ACCESS_TIME; // if $SIM_EXEC_TIME is changed this value must be set accordingly
927
928 ?>