--- manual-doc_core_tsref-07-10-2005_13-15-59.txt 2006-07-26 17:23:29.000000000 +0200 +++ manual-doc_core_tsref_4-0-0.txt 2006-07-26 18:37:06.000000000 +0200 @@ -6,7 +6,7 @@ TSref Extension Key: doc_core_tsref -Copyright 2000-2005, Kasper Skårhøj, +Copyright 2000-2006, kasperYYYY@typo3.com, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml @@ -208,7 +206,7 @@ 2) If the value contains a "/" it?s expected to be a reference (absolute or relative) to a file on the file-system instead of the resource-field. No support for wildcards. imgResource -Here "file" is a imgResource: +Here "file" is an imgResource: file = toplogo*.gif file.width = 200 @@ -491,7 +489,7 @@ See cObject "LOAD_REGISTER" leveltitle, leveluid, levelmedia: [levelTitle, uid or media in rootLine, 0- , negative = from behind, , slide parameter forces a walk to the bottom of the rootline until there?s a true value to return. Useful with levelmedia.] levelfield: Like leveltitle et al. but where the second parameter is the rootLine field you want to fetch. Syntax: [pointer, integer], [fieldname], [slide] -global : [GLOBAL-var, split with | if you want to get from an array! DEPRECIATED, use GPvar, TSFE or getenv] +global : [GLOBAL-var, split with | if you want to get from an array! DEPRECATED, use GPvar, TSFE or getenv] date : [date-conf] page : [current page record] current : 1 (gets ?current? value) @@ -509,9 +507,12 @@ LLL: Reference to a locallang (php or xml) label. Reference consists of [fileref]:[labelkey] path: path to a file, possibly placed in an extension, returns empty if the file doesn?t exist. -cObj: [internal variable from list: parentRecordNumber] +cObj: [internal variable from list: parentRecordNumber]: For CONTENT and RECORDS cObjects that are returned +by a select query, this returns the row number (1,2,3,...) of the current cObject record. debug: Returns HTML formated content of PHP variable defined by keyword. Available keys are rootLine, fullRootLine, data -------------------- +Getting array/object elements. +You can fetch the value of an array/object by splitting it with a pipe |.Example: TSFE:fe_user|user|username Getting more values. By separating the value of getText with "//" (double slash) you let getText fetch the first value. If it appears empty ("" or zero) the next value is fetched and so on. Example: = field:header // field:title // field:uid @@ -569,9 +570,9 @@ Whenever you see ->[objectname] in the tables it means that the property is an object "objectname" with properties from object objectname. You don?t need to define the objecttype. Calculating values (+calc): Sometimes a datatype is set to "something +calc". "+calc" indicates that the value is calculated with "+-/*". Be aware that the operators has no "weight". The calculation is done in the order of the operators.Example: 45 + 34 * 2 = 158(which is the same as this is ordinary arithmetic: (45+34)*2=158 ) -"... / stdWrap": -When a datatype is set to "type / stdWrap" it means that the value is parsed through the stdWrap function with the properties of the value as parameters.Example: -pixels / stdWrap:Here the value should be set to pixels and parsed through stdWrap. +"... /stdWrap": +When a datatype is set to "type /stdWrap" it means that the value is parsed through the stdWrap function with the properties of the value as parameters.Example: +pixels /stdWrap:Here the value should be set to pixels and parsed through stdWrap. In a real application we could do like this: .pixels.field = imagewidth .pixels.intval = 1 @@ -691,8 +692,19 @@ ....(yellow)middle, subpart 1 ....(green)middle, subpart 2 Contact(yellow)middle, subpart 1 -Links(green)middle, subpart 2ConditionsCondition reference: General note: -Values are normally trimmed for whitespace before comparison.browserSyntax: +Links(green)middle, subpart 2ConditionsCondition reference: General notes: +Values are normally trimmed for whitespaces before comparison. +You may combine several conditions with two operators: && (and), || (or) +Alternatively you may use "AND" and "OR" instead of "&&" and "||". The AND operator has always higher precedence over OR. If no operator has been specified, it will default to OR.Examples: +This condition will match if the visitor opens the website with Internet Explorer on Windows (but not on Mac) +[browser = msie] && [system = win] + +This will match with either Opera or Netscape browsers +[browser = opera] || [browser = netscape] + +This will match with either Internet Explorer or Netscape. In case of Netscape, the version must be above 4. +[browser = msie] || [browser = netscape] && [version => 4] +browserSyntax: [browser = browser1,browser2,...] Values and comparison: Browser: @@ -967,6 +979,10 @@ PIDupinRootlineSyntax: [PIDupinRootline = pages-uid, pages-uid, ...]Comparison: Do the same as PIDinRootline, except the current page-uid is excluded from check. +compatVersionSyntax: +[compatVersion = x.y.z]Comparison: +Require a minimum compatibility version. This version is not necessary equal with the TYPO3 version, it is a configurable value that can be changed in the Upgrade Wizard of the Install Tool. +compatVersion is especially useful if you want to provide new default settings but keep the backwards compatibility for old versions of TYPO3. globalVars:Syntax: [globalVar= var1=value, var2value3, ...] Comparison: @@ -980,10 +996,10 @@ < The var must be less than the value globalString:Syntax: -[globalString= var1=value, var2= *value2, var3= *value3*, ...] +[globalString = var1=value, var2= *value2, var3= *value3*, ...] Comparison: This is a direct match on global strings. -You have the options of putting a "*" at the beginning and/or end of the value thereby matching with this wildcard!Examples: +You have the options of putting a "*" as a wildcard or using a PCRE style regular expression (must be wrapped in "/") to the value.Examples: If the HTTP_HOST is "www.typo3.com" this will match with: [globalString = HTTP_HOST=www.typo3.com] @@ -991,12 +1007,12 @@ [globalString = HTTP_HOST= *typo3.com] ... but this will also match with a HTTP_HOST like this: "demo.typo3.com" -IMPORTANT NOTE ON GlobalVar and GlobalString: -You can use values from global arrays by deviding the var-name with a "|" (vertical line). -Example: the global var $HTTP_POST_VARS["key"]["levels"] would be retrieved by "HTTP_POST_VARS|key|levels " +IMPORTANT NOTE ON globalVar and globalString: +You can use values from global arrays and objects by deviding the var-name with a "|" (vertical line). +Examples: The global var $HTTP_POST_VARS["key"]["levels"] would be retrieved by "HTTP_POST_VARS|key|levels" Also note that it?s recommended to program your scripts in compliance with the php.ini-optimized settings. Please see that file (from your distribution) for details. -Caring about this means that you would get values like HTTP_HOST by getenv(), you would retrieve GET/POST values with t3lib_div::GPvar(). Finally a lot of values from the TSFE object are useful. In order to get those values for comparison with globalVar and globalString conditions, you prefix that varname with either "IENV"/ENV: , GP:, TSFE: or LIT: respectively. Still the | divider may be used to separate keys in arrays. LIT means literal and the string after : is trimmed and returned as the value (without being divided by | or anything) -Notice: Using the "IENV:" prefix is highly recommended to get server/environment variables which are system independant. Basically this will call and return the value from t3lib_div::getIndpEnv() function. With "ENV:" you get the raw output from getenv() which is NOT always the same on all systems! "IENV:" is supported from TYPO3 3.6Examples: +Caring about this means that you would get values like HTTP_HOST by getenv(), you would retrieve GET/POST values with t3lib_div::GPvar(). Finally a lot of values from the TSFE object are useful. In order to get those values for comparison with globalVar and globalString conditions, you prefix that varname with either "IENV"/ENV: , GP:, TSFE: or LIT: respectively. Still the | divider may be used to separate keys in arrays and/or objects. LIT means literal and the string after : is trimmed and returned as the value (without being divided by | or anything) +Notice: Using the "IENV:" prefix is highly recommended to get server/environment variables which are system independant. Basically this will call and return the value from t3lib_div::getIndpEnv() function. With "ENV:" you get the raw output from getenv() which is NOT always the same on all systems!Examples: This will match with a url like ...&print=1 [globalVar = GP:print > 0] @@ -1009,6 +1025,9 @@ This will match with the pages having the layout field set to Layout 1: [globalVar = TSFE:page|layout = 1] +This will match with the user whose username is test: +[globalString = TSFE:fe_user|user|username = test] + If the constant {$constant_to_turnSomethingOn} is 1 then this matches: [globalVar = LIT:1 = {$constant_to_turnSomethingOn}] userFunc:Syntax: @@ -1040,10 +1059,10 @@ 10.value.case = upper Here the content of the object "10" is uppercased before it?s returned. -stdWrap properties are executed in the order they appear in the table below. If you want to study this further please refer to tslib/content.php/, function stdWrap() +stdWrap properties are executed in the order they appear in the table below. If you want to study this further please refer to typo3/sysext/cms/tslib/class.tslib_content.php, function stdWrap() -(from tslib/class.tslib_content.php) +(from typo3/sysext/cms/tslib/class.tslib_content.php) Content-supplying properties of stdWrap: The properties in this table is parsed in the listed order. The properties "data", "field", "current", "cObject" (in that order!) are special as they are used to import content from variables or arrays. The above example could be rewritten to this: @@ -1068,7 +1087,7 @@ Sets the "current"-value. This is normally set from some outside routine, so be careful with this. But it might be handy to do this lang -array of language-keys +Array of language keys This is used to define optional language specific values. If the global language key set by the ->config property .language is found in this array, then this value is used instead of the default input value to stdWrap. @@ -1106,12 +1125,12 @@ Returns the number of rows resulting from the select filelist -dir / stdWrap +dir /stdWrap Reads a directory and returns a list of files. The value is exploded by "|" into parameters: 1: The path 2: comma-list of allowed extensions (no spaces between); if empty all extensions goes. -3: sorting: name, size, ext, date +3: sorting: name, size, ext, date, mdate (modification date) 4: reverse: Set to "r" if you want a reversed sorting 5: fullpath_flag: If set, the filelist is returned with complete paths, and not just the filename @@ -1131,8 +1150,11 @@ ifEmpty string /stdWrap -if the content is empty (trimmed) at this point, the content is loaded with "ifEmpty". -Zero?s are an empty value. +if the content is empty (trimmed) at this point, the content is loaded with "ifEmpty". Zeros are treated as empty values! + +ifBlank +string /stdWrap +Same as "ifEmpty" but the check is done using strlen(). listNum int @@ -1142,10 +1164,11 @@ Special keyword: "last" is set to the last element of the array! -Property: -.splitChar = string; Defines the string used to explode the value. If splitChar is an integer, the character with that number is used (eg. "10" to split lines...) -.stdWrap = stdWrap properties of the listNum... -Default = "," (comma) +.splitChar (string): +Defines the string used to explode the value. If splitChar is an integer, the character with that number is used (eg. "10" to split lines...). +Default: ," (comma) +.stdWrap (stdWrap properties): +stdWrap properties of the listNum... Examples: We have a value of "item 1, item 2, item 3, item 4": @@ -1326,11 +1349,11 @@ innerWrap wrap /stdWrap - +Wraps the content innerWrap2 wrap /stdWrap - +same as .innerWrap (but watch the order in which they are executed) fontTag wrap @@ -1368,6 +1391,16 @@ ->typolink Wraps the content with a link-tag +TCAselectItem. +Array of properties +Resolves a comma seperated list of values into the TCA item representation. + +.table (string): The Table to look up +.field (string): The field to resolve +.delimiter (string): Delimiter for concatenating multiple elements. + +Notice: Currently this works only with TCA fields of type select which are not database relations. + spaceBefore int /stdWrap Pixels space before. Done with a clear-gif;
@@ -1397,7 +1430,7 @@ wrap2 wrap /+.splitChar -see .wrap +same as .wrap (but watch the order in which they are executed) dataWrap @@ -1417,11 +1450,11 @@ wrap3 wrap /+.splitChar -see .wrap +same as .wrap (but watch the order in which they are executed) outerWrap wrap /stdWrap - +Wraps the complete content insertData boolean @@ -1544,15 +1577,31 @@ web width -pixels / stdWrap -If both the width and heigth is set and one of the numbers has an "m" after it, the proportions will be preserved and thus width/height will work as max-dimensions for the image. +pixels /stdWrap +If both the width and the heigth are set and one of the numbers is appended by an "m", the proportions will be preserved and thus width/height are treated as maximum dimensions for the image. The image will be scaled to fit into width/height rectangle. -height -pixels / stdWrap +If both the width and the heigth are set and at least one of the numbers is appended by a "c", cropscaling will be enabled. This means that the proportions will be preserved and the image will be scaled to fit around a rectangle with width/height dimensions. Then, a centered portion from inside of the image (size defined by width/height) will be cut out. +The "c" can have a percentage value (-100 ... +100) after it, which defines how much the cropping will be moved off the center to the border. +Notice that you can only use m or c at the same time! -params +Examples: +This crops 120x80px from the center of the scaled image: +.width = 120c.height = 80c +This crops 100x100px; from landscape-images at the left and portrait-images centered: +.width = 100c-100.height = 100c + +This crops 100x100px; from landscape-images a bit right of the center and portrait-images a bit upper than centered: +.width = 100c+30 +.height = 100c-25 + +height +pixels /stdWrap +see .width + +params +string ImageMagick command-line: fx. "-rotate 90" or "-negate" @@ -1570,7 +1619,7 @@ "" = first frame (zero) import -path / stdWrap +path /stdWrap value should be set to the path of the file with stdWrap you get the filename from the data-array @@ -1581,11 +1630,11 @@ .import.listNum = 0 maxW -pixels / stdWrap +pixels /stdWrap Max width maxH -pixels / stdWrap +pixels /stdWrap Max height minW @@ -1678,9 +1727,15 @@ Each picture will open in a new window! JSwindow.altUrl -string/stdWrap +string /stdWrap If this returns anything, the URL shown in the JS-window is NOT showpic.php but the url given here! +JSwindow.altUrl_noDefaultParams +boolean +If this is set, the image parameters are not appended to the altUrl +automatically. This is useful if you want to create them with a userfunction +instead. + typolink ->typolink NOTE: This overrides the imageLinkWrap if it returns anything!! @@ -1764,7 +1819,7 @@ without "where"!, Eg. " (title LIKE ?%SOMETHING%? AND NOT doktype) " andWhere -SQL-where / stdWrap +SQL-where /stdWrap without "AND"!, Eg. "NOT doktype". languageField @@ -1802,17 +1857,21 @@ Description: Default: token -str / stdWrap +str /stdWrap string or character (token) used to split the value max -int / stdWrap +int /stdWrap max number of splits min -int / stdWrap +int /stdWrap min number of splits. +returnKey +int /stdWrap +Instead of parsing the split result, just return this element of the index immediately. + cObjNum cObjNum +optionSplit @@ -1850,37 +1909,37 @@ Description: Default: isTrue -str / stdWrap +str /stdWrap If the content is "true".... (not empty string and not zero) isFalse -str / stdWrap +str /stdWrap If the content is "false"... (empty or zero) isPositive -int / stdWrap +int /stdWrap + calc returns false if content is not positive isGreaterThan -value / stdWrap +value /stdWrap returns false if content is not greater than ".value" isLessThan -value / stdWrap +value /stdWrap returns false if content is not less than ".value" equals -value / stdWrap +value /stdWrap returns false if content does not equal ".value" isInList -value / stdWrap +value /stdWrap returns false if content is not in the comma-separated list ".value". The list in ".value" may not have spaces between elements!! value -value / stdWrap +value /stdWrap "value" (the comparison value mentioned above) negate @@ -1961,6 +2020,10 @@ boolean Add the QUERY_STRING to the start of the link. Notice that this does not check for any duplicate parameters! This is not a problem (only the last parameter of the same name will be applied), but enable "config.uniqueLinkVars" if you still don?t like it. +.method: If set to to GET or POST then then the parsed query arguments (GET or POST data) will be used. This settings are useful if you use URL processing extensions like Real URL, which translate part of the path into query arguments. + +.exclude: List of query arguments to exclude from the link (eg L or cHash). + wrap wrap Wraps the links. @@ -1996,15 +2059,18 @@ If you insert only "#234" where "234" is the tt_content record number, it links to the current page-id Target -Target is normally defined by the ".extTarget" and "target" properties of typolink. But you may override this target by adding the new target after the parameter separated by whitespace. Thus the target becomes the ?second? parameter. -If the ?Target? parameter is set to the ?-? character, then it?s the same as no target passed to the function. This feature enables you to still pass a class as third parameter without setting the target also. +Target is normally defined by the "extTarget" and "target" properties of typolink. But you may override this target by adding the new target after the parameter separated by a whitespace. Thus the target becomes the second parameter. +If the Target parameter is set to the - character, then it?s the same as no target passed to the function. This feature enables you to still pass a class as third parameter and title as fourth parameter without setting the target also. Open in windows with fixed dimensions (JavaScript) It is possible to open the link in a window opened by JavaScript (with window.open). For this, just set the target value to 123x456 where 123 is the window width and 456 is the window height. You can also specify additional parameters to the function by entering them separated from the width and height with a colon :. For instance 230x450:resizable=0,location=1 will disable resizing of the window and enable the location bar. Also see property JSwindow. Class -If you specify a ?third parameter? separated by whitespace in the parameter value this becomes the class-parameter of the link. This class parameter is inserted in the link-tag before any values from .ATagParams which means this class value will override any class value set in ATagParams (at least for MSIE). +If you specify a third parameter separated by whitespace in the parameter value this becomes the class-parameter of the link. This class parameter is inserted in the link-tag before any values from .ATagParams which means this class value will override any class value set in ATagParams (at least for MSIE). If set to -, then it?s the same as no class passed to the function. This feature enables you to still pass a title as fourth parameter without setting the class also. + +Title +The title attribute is normally specified via .ATagParams or directly via the .title property. But you may override this value by adding the desired title as the fourth parameter (parameters separated by whitespace) to typolink. Examples of multiparameters: Consider this .parameter value passed to this function: @@ -2016,6 +2082,10 @@ +title +string /stdWrap +Sets the title parameter of the A-tag. + JSwindow_params string Preset values for opening the window. This example lists almost all possible attributes: @@ -2033,7 +2103,7 @@ This is used create a link, which jumps from one page directly the section on another page. ATagParams --params +-params /stdWrap Additional parameters Example: @@ -2441,7 +2511,7 @@ ATagParams --params +-params /stdWrap Additional parameters Example: @@ -2453,13 +2523,13 @@ altText titleText -string / stdWrap +string /stdWrap For icons (image made with "iconCObject" must have their own properties) If no titltext is specified, it will use the alttext insteadIf no alttext is specified, it will use an empty alttext longdescURL -string / stdWrap +string /stdWrap For icons (image made with "iconCObject" must have their own properties) "longdesc" attribute (URL pointing to document with extensive details about image). @@ -2664,7 +2734,7 @@ "scheme,path,query": http://www.webaddress.rld/test/doc.php?id=3 http.ATagParams --params +-params /stdWrap Additional parameters Example: @@ -2679,7 +2749,7 @@ If set, the link is first wrapped with mailto.wrap and then the -tag. mailto.ATagParams --params +-params /stdWrap Additional parameters Example: @@ -2949,7 +3019,7 @@ Here you can configure how data submitted from the front-end should be processed, which script and so on. includeLibs -array of strings +Array of strings With this you can include php-files with function libraries for use in your includescript in TYPO3. Please see the PAGE-object, which has the same property. @@ -3014,11 +3084,11 @@ This works only if the plugin calls $this->pi_setPiVarDefaults(). _LOCAL_LANG.[lang-key].[label-key] -String +string Can be used to override the default locallang labels for the plugin. [tsref:plugin]"CONFIG": -In tslib/ this is known as $GLOBALS["TSFE"]->config["config"], thus the property "debug" below is accessible as $GLOBALS["TSFE"]->config["config"]["debug"]. +In typo3/sysext/cms/tslib/ this is known as $GLOBALS["TSFE"]->config["config"], thus the property "debug" below is accessible as $GLOBALS["TSFE"]->config["config"]["debug"]. Property: Data type: Description: @@ -3127,24 +3197,19 @@ doctype string -If xhtml_frames then a header for XHTML-frames is outputted. -If value is "xhtml_trans" then a header for XHTML transitional is outputted: +If set, then a document type declaration (and an XML prologue) will be generated. The value can either be a complete doctype or one of the following keywords: + +"xhtml_trans" for XHTML 1.0 Transitional doctype. +"xhtml_frames" for XHTML 1.0 Frameset doctype. +"xhtml_strict" for XHTML 1.0 Strict doctype. +"xhtml_basic" for XHTML basic doctype. +"xhtml_11" for XHTML 1.1 doctype. +"xhtml_2" for XHTML 2 doctype. +"none" for NO doctype at all. - - - -Keyword list: -keyword xhtml_trans for XHTML 1.0 Transitional doctype. -keyword xhtml_frames for XHTML 1.0 Frameset doctype. -keyword xhtml_strict for XHTML 1.0 Strict doctype. -keyword xhtml_11 for XHTML 1.1 doctype. -keyword xhtml_2 for XHTML 2 doctype. -keyword "none" for NO doctype at all. +Note that the keywords also change the way TYPO3 generates some of the XHTML tags to ensure valid XML. If you set doctype to a string, then you must also set config.xhtmlDoctype (see below). -Any other value than these keywords will be outputted as the doctype itself! -Notice that some doctype keywords (all the xhtml* sorts) will set appropriate attributes for the tag as well. See "config.htmlTag_setParams" and "config.htmlTag_langKey" below for more details. +See "config.htmlTag_setParams" and "config.htmlTag_langKey" for more details on the effect on the html tag. Default is a DOCTYPE like this: @@ -3165,9 +3230,44 @@ If your browser has detected the DOCTYPE correctly it will report CSS1Compat If you are not running in compliance mode you will get some other message. MSIE will report BackCompat for instance - this means it runs in quirks-mode, supporting all the old browser-bugs. +xhtmlDoctype +string +Sets the document type for the XHTML version of the generated page. + +If config.doctype is set to a string then config.xhtmlDoctype must be set to one of these keywords: + +"xhtml_trans" for XHTML 1.0 Transitional doctype. +"xhtml_frames" for XHTML 1.0 Frameset doctype. +"xhtml_strict" for XHTML 1.0 Strict doctype. +"xhtml_basic" for XHTML basic doctype. +"xhtml_11" for XHTML 1.1 doctype. +"xhtml_2" for XHTML 2 doctype. + + +This is an example to use MathML 2.0 in an XHTML 1.1 document: + +config.doctype ( + +) +config.xhtmlDoctype = xhtml_11 + +Default: +same as config.doctype if set to a keyword + xmlprologue string -If none then no XML prologue is created when config.doctype is set to one of the XHTML modes. +If empty (not set) then the default XML 1.0 prologue is set, when the doctype is set to a known keyword (eg xhtml_11): + + + +If set to one of the know keywords then a standard prologue will be set: +xml_10 XML 1.0 prologue (see above) +xml_11 XML 1.1 prologue + +If "none" then the default XML prologue is not set. +Any other string is used as the XML prologue itself. htmlTag_setParams string @@ -3258,27 +3358,37 @@ pageGenScript resource Alternative page generation script for applications using index_ts.php for initialization, caching, stating and so on. This script is included in the global scope of index_ts.php-script and thus you may include libraries here. Always use include_once for libraries. -Remember not to output anything from such an included script. All content must be set into $TSFE->content. Take a look at tslib/pagegen.php +Remember not to output anything from such an included script. All content must be set into $TSFE->content. Take a look at typo3/sysext/cms/tslib/pagegen.php NOTE: This option is ignored if $TYPO3_CONF_VARS["FE"]["noPHPscriptInclude"]=1; is set in localconf.php. -tslib/pagegen.php +typo3/sysext/cms/tslib/pagegen.php debug boolean If set any debug-information in the TypoScript code is output. Currently this applies only to the menu-objects message_page_is_being_generated string -Alternative message in HTML that appears if a page is being generated. -Normally when a page is being generated a temporary copy is stored in the cache-table with an expire-time of 30 seconds. +Alternative HTML message that appears if a page is being generated. +Normally when a page is being generated a temporary copy is stored in the cache-table with an expire-time of 30 seconds. + +It is possible to use some keywords that are replaced with the corresponding values. Possible keywords are: ###TITLE###, ###REQUEST_URI### message_preview string Alternative message in HTML that appears when the preview function is active! +message_preview_workspace +string +Alternative message in HTML that appears when the preview function is active in a draft workspace. You can use sprintf() placeholders for Workspace title (first) and number (second). + +Examples: +config.message_preview_workspace =
Displaying workspace named "%s" (number %s)!
+config.message_preview_workspace =
Displaying workspace number %2$s named "%1$s"!
+ locale_all string PHP: setlocale("LC_ALL", [value]); @@ -3310,7 +3420,8 @@ default external target. Used by typolink if no extTarget is set _top spamProtectEmailAddresses -boolean / "ascii" / -5 to 1 +"ascii" / +-10 to 10 If set, then all email addresses in typolinks will be encrypted so spam bots cannot detect them. @@ -3460,8 +3571,7 @@ false stat_apache_logfile filename -This the filename of the logfile in the directory $TYPO3_CONF_VARS["FE"]["logfile_dir"] (localconf) on the server where TYPO3 writes to the apachelogfile. The directory defined by $TYPO3_CONF_VARS["FE"]["logfile_dir"] must exist and be writable. It can be relative (to PATH_site) or absolute, but in any case it must be within the regular allowed paths of TYPO3 (meaning for absolute paths that it must be within the lockRootDir set up in TYPO3_CONF_VARS). -The logfile also must exist. +This the filename of the logfile in the directory $TYPO3_CONF_VARS["FE"]["logfile_dir"] (localconf) on the server where TYPO3 writes to the apachelogfile. The directory defined by $TYPO3_CONF_VARS["FE"]["logfile_dir"] must exist and be writable. It can be relative (to PATH_site) or absolute, but in any case it must be within the regular allowed paths of TYPO3 (meaning for absolute paths that it must be within the lockRootDir set up in TYPO3_CONF_VARS). stat_apache_pagenames string @@ -3482,13 +3592,21 @@ boolean If true the HTTP_HOST is - if available - NOT inserted instead of the IP-address +stat_apache_niceTitle +boolean +If set, the URL will be transliterated from the renderCharset to ASCII (eg ä => ae, à => a, α "alpha" => a), which yields nice and readabe page titles in the log. All non-ASCII characters that cannot be converted will be changed to underscores. + +stat_apache_noRoot +boolean +If set, the root part (level 0) of the path will be removed from the path. This makes a shorter name in case you have only a redundant part like "home" or "my site". + stat_titleLen int 1-100 The lenght of the page names in the path written to logfile/database 20 simulateStaticDocuments boolean / -string: PATH_INFO +string If set TYPO3 makes all links in another way than usual. This can be used with Apache compiled with mod_rewrite and configured in httpd.conf for use of this in the ".htaccess"-files. Include this in the .htaccess file RewriteEngine On @@ -3505,7 +3623,7 @@ TYPO3 will interprete this as the page with alias = "start" and the type is zero (default): start.html -_____________________________________________ + Alternative option (PATH_INFO): Instead of using the rewrite-module in apache (eg. if you?re running Windows!) you can use the PATH_INFO variable from PHP. It?s very simple. Just set simulateStaticDocuments to PATH_INFO and you?re up and running! @@ -3536,6 +3654,15 @@ 23.0.html would be 23.html (that is without the zero) 23.1.html would still be 23.1.html +simulateStaticDocuments_replacementChar +string +Word separator for URLs generated by simulateStaticDocuments. If set to +hyphen, this option allows search engines to index keywords in URLs. Before TYPO3 4.0 this character was hard-coded to underscore. + +Depends on the compatibility mode (see Tools>Install>Update wizard): +compatibility mode < 4.0.0: underscore _ +compatibility mode >= 4.0.0: hyphen - + simulateStaticDocuments_dontRedirectPathInfoError boolean Regarding PATH_INFO mode: @@ -3632,6 +3759,8 @@ strict - The system will report an error if the requested translation does not exist. Basically this means that all pages with gray background in the Web>Info / Localization overview module will fail (they would otherwise fall back to default language in one or another way) +ignore - The system will stay with the selected language even if the page is not translated and there?s no content available in this language, so you can handle that situation on your own then. + sys_language_overlay boolean / keyword If set, records from certain tables selected by the CONTENT cObject using the languageField setting will select the default language (0) instead of any language set by sys_language_uid / sys_language_mode. In addition the system will look for a translation of the selected record and overlay configured fields. @@ -3695,7 +3824,7 @@ notification_email_encoding string -This sets the encoding of plaintext emails (notification messages). Normally no encoding is applied at all. But setting this to eg. base64 will encode the content with base64 encoding (charset ISO-8859-1). +This sets the encoding of plaintext emails (notification messages). The default encoding is quoted-printable. But setting this to eg. base64 will encode the content with base64 encoding. Values possible: base64 @@ -3704,7 +3833,7 @@ notification_email_charset string -Alternative charset for the notification mails. Is set only if an encoding type is entered. +Alternative charset for the notification mails. ISO-8859-1 admPanel boolean / ->ADMPANEL properties @@ -3779,17 +3908,15 @@ disablePrefixComment boolean -If set, the stdWrap property prefixComment will be disabled, thus preventing any revealing and spaceconsuming comments in the HTML source code. (ver. > 3.6.0RC1) +If set, the stdWrap property prefixComment will be disabled, thus preventing any revealing and spaceconsuming comments in the HTML source code. baseURL -boolean or string -If set to 1 this will automatically write out the tag with current sites URL in the header of the document. -If you set the value to a string that is expected to be the URL. Examples: +string +This writes the tag in the header of the document. Set this to the value that is expected to be the URL. +Example: config.baseURL = http://typo3.org/sub_dir/ -config.baseURL = 1 - tx_[extension key with no underscores]_[*] - Configuration space for plugins @@ -3896,6 +4023,22 @@ ->CONFIG configuration for the page. Any entries override the same entries in the toplevel-object "config". +includeJS.[array] +resource +Inserts one or more (Java)Scripts in