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]

[browser = browser1,browser2,...]

Each value is compared with the ($browsername.$browserversion, eg. "netscape4.72") in a strstr().

So if the value is "netscape" or just "scape" or "net" all netscape browsers will match.

If the value is "netscape4" all netscape 4.xx browsers will match.

If any value in the list matches the current browser, the condition returns true.

[browser = netscape, opera]

[version = value1, >value2, =value3, <value4, ...]

values are floating-point numbers with "." as the decimal separator.

The values may be preceeded by three operators:

[version=  =4.03]

[version=  >4][browser= netscape3]

[system= system1,system2]

Values are strings an a match happens if one of these strings is the first part of the system-identification.

Fx. if the value is "win9" this will match with "win95" and "win98" systems.

This will match with windows and mac -systems only

[system= win,mac]

[device= device1, device2]

Values are strings an a match happens if one of these strings equals the type of device

[device= wap, pda]

[useragent= agent]

This is a direct match on the useragent string from getenv(“HTTP_USER_AGENT”)

You have the options of putting a "*" at the beginning and/or end of the value agent thereby matching with this wildcard!

[useragent = Mozilla/4.0 (compatible; Lotus-Notes/5.0; Windows-NT)]

[useragent = *Lotus-Notes*]

This is some of the known WAP agents:

[language = lang1, lang2, ...]

The values must be a straight match with the value of getenv(“HTTP_ACCEPT_LANGUAGE”) from PHP. Alternatively, if the value is wrapped in “*” (eg. “*en-us*”) then it will split all languages found in the HTTP_ACCEPT_LANGUAGE string and try to match the value with any of those parts of the string. Such a string normally looks like “de,en-us;q=0.7,en;q=0.3” and “*en-us*” would match with this string.

[IP = ipaddress1, ipaddress2, ...]

The values are compared with the getenv(“REMOTE_ADDR”) from PHP.

You may include "*" instead of one of the parts in values. You may also list the first one, two or three parts and only they will be tested.

[IP = 123.*.*.*]

[IP = 123]

[IP = *.*.*.123][IP = 192.168.1.34]

[hostname = hostname1, hostname2, ...]

The values are compared with the fully qualiteid hostname of getenv(“REMOTE_ADDR”) retrieved by PHP.

Value is comma-list of domain names to match with. *-wildcard allowed but cannot be part of a string, so it must match the full host name (eg. myhost.*.com => correct, myhost.*domain.com => wrong)

[hour = hour1, >hour2, <hour3, ...]

The values in floating point are compared with the current hour (24-hours-format) of the server.

[minute = ...]

Minute of hour, 0-59

[dayofweek = ...]

Day of week, starting with sunday being 0 and saturday being 6

[dayofmonth = ...]

Day of month, 1-31

[month = ...]

Month, january being 1 and december being 12

[usergroup = group1-uid, group2-uid, ...]

The comparison can only return true if the grouplist is not empty (global var "gr_list").

The values must either exists in the grouplist OR the value must be a "*".

[usergroup = *]

[usergroup = 1,2]

[loginUser = fe_users-uid, fe_users-uid, ...]

Matches on the uid of a logged in fe_user. Works like 'usergroup' above including the * wildcard to select ANY user.

[loginUser = *]

[treeLevel = levelnumber, levelnumber, ...]

This checks if the last element of the rootLine is at a level corresponding to one of the figures in "treeLevel". Level = 0 is the "root" of a website. Level=1 is the first menuen

[treeLevel = 0,2]

[PIDinRootline = pages-uid, pages-uid, ...]

This checks if one of the figures in "treeLevel" is a PID (pages-uid) in the rootline

[PIDinRootline = 34,36]

[PIDupinRootline = pages-uid, pages-uid, ...]

Do the same as PIDinRootline, except the current page-uid is excluded from check.

[compatVersion = x.y.z]

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.

[globalVar=   var1=value,  var2<value2, var3>value3, ...]

The values in floating point are compared with the global var "var1" from above.

[globalString =   var1=value,  var2= *value2, var3= *value3*, ...]

This is a direct match on global strings.

You have the options of putting a "*" as a wildcard or using a PCRE style regular expression (must be wrapped in "/") to the value.

[globalString = HTTP_HOST=www.typo3.com]

[globalString = HTTP_HOST= *typo3.com]

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 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!

[globalVar = GP:print > 0]

[globalString = IENV:REMOTE_ADDR = 192.168.*]

[globalVar = TSFE:id > 10]

[globalVar = TSFE:page|layout = 1]

[globalString = TSFE:fe_user|user|username = test]

[globalVar = LIT:1 = {$constant_to_turnSomethingOn}]

[userFunc = user_match(checkLocalIP)]

This call the function “user_match” with the first parameter “checkLocalIP”. You write that function. You decide what it checks. Function result is evaluated as true/false.

function user_match($cmd){

switch($cmd){

case "checkLocalIP":

if (strstr(getenv("REMOTE_ADDR"),"192.168")){

return true;

}

break;

case "checkSomethingElse":

// ....

break;

}

}

[userFunc = user_match(checkLocalIP)]