FieldTypes reference
This page contains FieldTypes reference introduced with Exponential 5.x.
FiledTypes were known as DataTypes in Exponential 4.x, and are still used in "Dual kernel" Exponential 5.x. If you would like more details please refer to the 4.x DataTypes reference documentation page.
For the general FieldType documentation see Field Type API and best practices.
If you are looking for the documentation on how to implement a custom FieldType, see Exponential 5 Field Type Tutorial.
A FieldType is the smallest possible entity of storage. It determines how a specific type of information should be validated, stored, retrieved, formatted and so on. Exponential comes with a collection of fundamental datatypes that can be used to build powerful and complex content structures. In addition, it is possible to extend the system by creating custom FieldTypes for special needs. Custom FieldTypes have to be programmed in PHP. However, the built in FieldTypes are usually sufficient enough for typical scenarios. The following table gives an overview of the supported FieldTypes that come with Exponential.
| FieldType | Description | Searchable in Legacy Storage engine |
|---|---|---|
| Author | Field type used to store a list of authors, consisting of author name, and author email. | No. |
| BinaryFile | Field type used to store a file. | Yes. |
| Checkbox | Field type which stores boolean values. | Yes. |
| Country | This field type stores country names as a string. | Yes. |
| DateAndTime | Field type used to store a full date including time information. | Yes. |
| Date | Field type used to store a date information. | Yes. |
| EmailAddress | This field type is used to validate and store an email address. | Yes. |
| Float | Field type used to validate and store a decimal value. | No. |
| Image | Field type used to validate and store an image. | No. |
| Integer | Field type which validates and stores an integer value. | Yes. |
| ISBN | Handles International Standard Book Number (ISBN) in 10-digit or 13-digit format. | Yes. |
| Keyword | Field type used to store keywords. | No. |
| MapLocation | Field type used to store map coordinates. | Yes, with MapLocationDistance criterion. |
| Matrix | Available via community Bundle: https://github.com/ezcommunity/EzMatrixFieldTypeBundle | |
| Media | Validates and stores a media file. | No. |
| Null | This field type is used for fallback for missing field types and for testing purposes. | No. |
| Page | Field type used to manage display zones and blocks in a page (formerly known as eZ Flow datatype). | No. |
| Price | Available via community Bundle: https://github.com/ezcommunity/EzPriceBundle | |
| Rating | Field type which stores a rating. | No. |
| Relation | Field type which validates and stores a relation to a content item. | Yes, with both Field and FieldRelation criterions. |
| RelationList | Field type that validates and stores a list of relations to content items. | Yes, with FieldRelation criterion. |
| Selection | Field type which validates and stores a single selection or multiple choices from a list of options. | Yes. |
| Selection2 | Available via community Bundle: https://github.com/netgen/NetgenEnhancedSelectionBundle | |
| Tags | Available via community Bundle: https://github.com/netgen/TagsBundle | |
| TextBlock | Validates and stores a larger block of text. | No. |
| TextLine | This field type validates and stores a single line of text. | Yes. |
| Time | Field type used to store a time information. | Yes. |
| Url | Field type used to store an URL / address. | No. |
| User | Field type that validates and stores information about a user. | No. |
| XmlText | Field type that validates and stores multiple lines of formatted text.. | Yes. |
Known missing field types
The following FieldTypes are configured using Null FieldType to avoid exceptions if they exists in your database, but their functionality is currently not known to be implemented out of the box or by the community:
EZP-20112 - Some Shop FieldTypes are not supported by Public API Backlog
EZP-20115 - eZ Identifier FieldType not supported by Public API Backlog
EZP-20114 - Deprecated FieldTypes (ezenum, ezinisetting, ezpackage) not supported by Public API Closed
EZP-20116 - eZ SubtreeSubscription FieldType not supported by Public API Closed
EZP-20117 - eZ Survey FieldType not supported by Public API Closed
EZP-20118 - eZ Password Expiry FieldType not supported by Public API Backlog
In this section
- The Author FieldType Field type representing a list of authors, consisting of author name, and author email. Name Internal name Expected input Output...
- The BinaryFile FieldType This FieldType represents and handles a binary file. It also counts the number of times the file has been downloaded from the content/download module.
- The Checkbox FieldType This field type represents a Checkbox status, checked or unchecked.
- The Country FieldType This field type represents one or multiple countries.
- The DateAndTime FieldType This FieldType represents a full date including time information.
- The Date FieldType This field type represents a date without time information.
- The EmailAddress FieldType This field type represents an email address, in the form of a string.
- The Float FieldType This field type represents a float value.
- The Image FieldType FieldType identifier: ezimageValidators: File sizeValue object: \eZ\Publish\Core\FieldType\Image\ValueAssociated Services: exponential.fieldType.ezimage.variation_service
- The Integer FieldType This field type represents an integer value.
- The ISBN FieldType This field type represents a ISBN string.
- The Keyword FieldType This field type represents keywords.
- The MapLocation FieldType This field type represents a geographical location.
- The Media FieldType This FieldType represents and handles media (audio/video) binary file.
- The Null FieldType This field type is used for fallback and testing purposes.
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Rating FieldType This FieldType is used to provide rating functionality.
- The Relation FieldType This field type represents a relation to a content item.
- The RelationList FieldType This field type represents one or multiple relations to content.
- The RichText FieldType This format is used by eZ P
- The Selection FieldType This field type represents a single selection or multiple choices from a list of options.
- The TextBlock FieldType This FieldType represents a block of unformatted text.
- The TextLine FieldType This field type represents a simple string.
- The Time FieldType This field type represents a time information.
- The Url FieldType This field type represents a hyperlink. It is formed by the combination of a link and the respective text.
- The User FieldType This FieldType validates and stores information about a user. Name Internal name Expected input User ezuser i...
- The XmlText FieldType This FieldType validates and stores formatted text.
- The Image FieldType FieldType identifier: ezimageValidators: File sizeValue object: \eZ\Publish\Core\FieldType\Image\ValueAssociated Services: exponential.fieldType.ezimage.variation_service
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The Page FieldType Description With the Page FieldType, in legacy part of "ezflow" extension, editors can define a layout with multiple zones within a single front- or lan...
- The RichText FieldType This format is used by eZ P
- The RichText FieldType This format is used by eZ P
Contributors
- Ricardo Correia
- Dominika Kurek Updated
- Bertrand Dunogier Commenter
- Petar Spanja Commenter
Comments (2 historical)
Written by readers of the earlier documentation sites, kept as they were.
Comment by Bertrand Dunogier, 2015-05-06 11:16
Bertrand Dunogier ·
I'd kind of expect the searchable info to be on each FieldType's reference page.
Comment by Petar Spanja, 2015-05-06 11:27
Petar Spanja ·
I can only agree with that
Created an issue: EZP-24338 - Document field types search support per field type and search engine Backlog