Attention

TYPO3 v7 has reached its end-of-life November 30th, 2018 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.

There is no further ELTS support. It is recommended that you upgrade your project and use a supported version of TYPO3.

TYPE: "none"

This type will just show the value of the field in the backend. The field is not editable.

Properties

Property

Data Type

cols

integer

fixedRows

boolean

format

string

pass_content

boolean

rows

integer

size

integer

type

string

Property details

type

Key

type

Datatype

string

Description

[Must be set to "none"]

format

Key

format

Datatype

string (keyword) + array

Description

The value of a none-type fields is normally displayed as is. It is however possible to format it using this property. The following keywords are available, some having sub-properties. Sub-properties are called with the format. keyword (note the trailing dot), which is itself an array.

date

Formats the value of the field as a date. The default formatting uses PHP's date() function and d-m-Y as a format. Possible options are:

strftime

(boolean) If true, strftime() is used instead date() for formatting.

option

(string) Format string (i.e. Y-m-d or %x, etc.).

appendAge

(boolean) If true, the age of the value is appended is appended to the formatted output.

datetime

Formats the values using PHP's date() function and H:i d-m-Y as a format.

time

Formats the values using PHP's date() function and H:i as a format.

timesec

Formats the values using PHP's date() function and H:i:s as a format.

year

Formats the values using PHP's date() function and Y as a format.

int

Formats the values as an integer using PHP's sprintf() in various bases. The default base is decimal (dec). The base is defined as an option:

base

(string) Defines the base of the value. Possible bases are "dec", "hex", "HEX", "oct" and "bin".

float

Formats the values as an real number using PHP's sprintf() and the %f marker. The number of decimals is an option:

precision

(integer) Defines the number of decimals to use (maximum is 10, default is 2).

number

Formats the values as a number using PHP's sprintf(). The format to use is an option:

option

(string) A format definition according to PHP's sprintf() function (see the reference).

md5

Returns the md5 hash of the values.

filesize

Formats the values as file size using \TYPO3\CMS\Core\Utility\GeneralUtility::formatSize(). One option exists:

appendByteSize

(boolean) If true, the original value is appended to the formatted string (between brackets).

user

Calls a user-defined function to format the values. The only option is the reference to the function:

userFunc

(string) Reference to the user-defined function. The function receives the field configuration and the field's value as parameters.

Examples

'format' => 'date'
'format.' => array(
        'strftime' => TRUE,
        'option' => '%x'
)

'eval' => 'double2'
'format' => 'float'
'format.' => array(
        'precision' => 8
)

pass_content

Key

pass_content

Datatype

boolean

Description

If set, then content from the field is directly outputted in the <div> section. Otherwise the content will be passed through htmlspecialchars() and possibly nl2br() if there is configuration for rows.

Be careful to set this flag since it allows HTML from the field to be outputted on the page, thereby creating the possibility of XSS security holes.

rows

Key

rows

Datatype

integer

Description

If this value is greater than 1 the display of the non-editable content will be shown in a <div> area trying to simulate the rows/columns known from a text-type element.

cols

Key

cols

Datatype

integer

Description

See rows and size.

fixedRows

Key

fixedRows

Datatype

boolean

Description

If this is set the <div> element will not automatically try to fit the content length but rather respect the size selected by the value of the rows key.

size

Key

size

Datatype

integer

Description

If rows is less than one, the cols value is used to set the width of the field and if cols is not found, then size is used to set the width.

The measurements corresponds to those of input and text type fields.