Simple data types

Decides about alignment.

Possible values for boolean variables are 1 and 0 meaning TRUE and FALSE.

Everything else is evaluated to one of these values by PHP: Non-empty strings (except 0 [zero]) are treated as TRUE, empty strings are evaluated to FALSE.

dummy.enable = 0   # false, preferred notation
dummy.enable = 1   # true,  preferred notation
dummy.enable =     # false, because the value is empty

Do a case conversion.

Code:

10 = TEXT
10.value = Hello world!
10.case = upper

Result:

HELLO WORLD!

Used to format a date, see PHP function date(). See the documentation of allowed date time formats in PHP.

page.10.date-conf = d-m-y

-90 to 90, integers

Example: 45

[path relative to the web root of the site] | [list of valid extensions] | [sorting: name, size, ext, date] | [reverse: "r"] | [return full path: boolean]

Files matching are returned in a comma-separated string.

This example returns a list of all pdf, gif and jpg-files from fileadmin/files/ sorted by their name reversely and with the full path (with fileadmin/files/ prepended):

page.10.dir = fileadmin/files/ | pdf,gif,jpg | name | r | true

Indicates a function or method in a class to call. See more information at the USER cObject.

If no namespaces are used, then the class or function name, but not the method name, should probably be prefixed with user_. The prefix can be changed in the $GLOBALS['TYPO3_CONF_VARS'] config though. The function / method is normally called with 2 parameters, $conf which is the TypoScript configuration and $content, some content to be processed and returned.

If no namespaces are used and if a method in a class is called, it is checked (when using the USER/USER_INT objects) whether a class with the same name, but prefixed with ux_ is present and if so, this class is instantiated instead. See the document "Inside TYPO3" for more information on extending classes in TYPO3!

Method in namespaced class. This is the preferred version:

Your\NameSpace\YourClass->reverseString

Single Function:

user_reverseString

Method in class without namespace:

user_yourClass->reverseString

[colordef] : [modifier]

Where modifier can be an integer which is added or subtracted to the three RGB-channels or a floating point with an * before, which will then multiply the values with that factor.

The color can be given as HTML-color or as a comma-separated list of RGB-values (integers). An extra parameter can be given, that will modify the color mathematically:

• red (HTML color)
• #ffeecc (HTML color as hexadecimal notation)
• 255,0,255 (HTML color as decimal notation)

Extra:

• red : *0.8 ("red" is darkened by factor 0.8)
• #ffeecc : +16 ("ffeecc" is going to #fffedc because 16 is added)

Image extensions can be anything among the allowed types defined in the global variable $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext'] . Standard is pdf, gif, jpg, jpeg, tif, bmp, ai, pcx, tga, png.

The value "web" is special. This will ensure that an image is converted to a web image format (gif or jpg) if it happens not to be already!

jpg

web (gif or jpg ..)

1. A resource plus imgResource properties.

   Filetypes can be anything among the allowed types defined in the configuration variable $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext'] . Standard is pdf, gif, jpg, jpeg, tif, bmp, ai, pcx, tga, png.

2. A GIFBUILDER object. See the object reference for GIFBUILDER.

Here "file" is an imgResource:

10 = IMAGE
10 {
    file = fileadmin/toplogo.gif
    file.width = 200
}

GIFBUILDER:

10 = IMAGE
10.file = GIFBUILDER
10.file {
    # GIFBUILDER properties here...
}

42, -8, -9, 0

This data type is sometimes used generally though another type would have been more appropriate, like pixels.

Path relative to the root directory from which we operate. Also resolves EXT: syntax.

page.10.settings.somePath = fileadmin/stuff/

pixel-distance

page.10.someWidth = 345

Positive integer.

42, 8, 9

If the value contains a "/", it is expected to be a reference (absolute or relative) to a file in the file system. There is no support for wildcard characters in the name of the reference.

Reference to a file in the file system:

page.10.settings.someFile = fileadmin/picture.gif

See function strftime on php.net.

Sometimes used generally though another type would have been more appropriate, like "align".

The quick brown fox jumps over the lazy dog.

An HTML tag.

page.10.settings.bodyTag = <body lang="de">

Parameters for a tag.

For <frameset>-params:

page.10.settings.someParams = border="0" framespacing="0"

_top, _blank, content

Target in an <a>-tag.

This is normally the same value as the name of the root-level object that defines the frame.

Syntax

<...> | </...>

Used to wrap something. The vertical bar ("|") is the place, where your content will be inserted; the parts on the left and right of the vertical line are placed on the left and right side of the content.

Spaces between the wrap-parts and the divider ("|") are trimmed off from each part of the wrap.

If you want to use more sophisticated data functions, then you should use stdWrap.dataWrap instead of wrap.

A wrap is processed and rendered as the last of the other components of a cObject.

This will cause the value to be wrapped in a p-tag coloring the value red:

page.10.stdWrap.wrap = <p class="bg-red"> | </p>