FILE

Important

This object was deprecated in TYPO3 9 LTS and will be removed in TYPO3 v10. See Deprecation: #85970 - FILE content object in the ChangeLog.

This object returns the content of the file specified in the property “file”.

It is defined as PHP function fileResource() in typo3/sysext/frontend/Classes/ContentObject/ContentObjectRenderer.php.

Note: Do not mix this up with the cObject FILES ; both are different cObjects.

Property

file

Description

The file whose content should be returned.

If the resource is jpg, jpeg, gif or png the image is inserted as an image-tag. All other formats are read and inserted into the HTML code.

The maximum filesize of documents to be read is set to 1024 KB internally!

Property

linkWrap

Description

(Executed before “.wrap” and “.stdWrap”.)

Property

wrap

Data type

wrap / stdWrap

Description

(Executed after “.linkWrap” and before “.stdWrap”.)

Property

stdWrap

Data type

->stdWrap

Description

(Executed after “.linkWrap” and “.wrap”.)

Property

altText

titleText

Data type

string / stdWrap

Description

For <img> output only!

If no alttext is specified, it will use an empty alttext.

Property

emptyTitleHandling

Data type

string / stdWrap

Description

Value can be “keepEmpty” to preserve an empty title attribute, or “useAlt” to use the alt attribute instead.

Default

useAlt

Property

longdescURL

Data type

string / stdWrap

Description

For <img> output only!

“longdesc” attribute (URL pointing to document with extensive details about image).

[tsref:(cObject).FILE]

Example:

In this example a page is defined, but the content between the body- tags comes directly from the file “gs.html”:

page = PAGE
page.typeNum = 0
page.10 = FILE
page.10.file = fileadmin/gs/gs.html