Global navigation

 •  Documentation Center
 •  Technical documentation
 •  Glossary

 
User Manual:



⚠ WARNING ! This documentation is deprecated !

Please go to the current Editor Documentation

Skip to end of metadata
Go to start of metadata
Overview
eZ organizes content into Content items made up of Fields. A structure of a Content item is defined by its Content Type.

 

The role of a content management system is to organize and store content regardless of type and complexity. eZ allows you to create and modify flexible structures that perfectly satisfy customer needs. This is one of the key features that make eZ a versatile and successful system.

In this topic

Related topics

Understanding eZ Platform and eZ Studio

Content Types

Field Types

 

 

Content items

 

The basic unit with which you operate in eZ is a Content item. A Content item is a single piece of content: an article, a blog post, an image, a product, etc. Each Content item has a number of general characteristics such as name, but most importantly, it contains a number of Fields. These Fields will differ depending on what kind of Content you are dealing with. An article Content item may have Fields such as title, name, author, body, image and subscriber teaser, etc. A product Content item may have product name, category, price, size, color, etc. as Fields.

Each Content item belongs to a particular type which defines what Fields are available for it.

 

 

 

Content Types

 

Conceptually, you can treat a Content Type as a kind of pattern (a template) on which you base Content items. Whenever you create a new Content item, you must choose the Content Type to which it will belong.

The Content Type defines what Fields will be available in the Content item. A Content item may only contain the exact Fields that are defined in the Content Type (although not all of them must be obligatory).

eZ allows you to create, edit and delete Content Types and their Fields. A pre-configured set of Content Types and their Fields for you to use is available in the Demo Bundle.

 

 

Content items versus Content Types

 

The difference between Content items and Content Types is important for understanding the fundamentals of content management in eZ.

A Content item is an instance of a particular Content Type, in other words a single object created based on a template that is the Content Type.

When a Content item is created, it inherits the Fields from its Content Type. However, the values of the Fields (their "contents") are empty and you need to fill them separately for each Content item. The Fields in a Content Type are only definitions. This means that they describe what Fields of what kinds will be present in a Content item, but as a rule they do not provide these Fields' values.

As a consequence, all Content items of the same Content Type will share the same set of Fields, but their Field values will be different.

To visualize this concept, you can think of a Content Type as a stencil that you use to create multiple prints. Each print will have the same shape, but may be filled with a variety of paints. In the same way, a Content Type defines the shape using the Fields that are provided in it. Each Content item based on this Type will have the same "shape," that is the same Fields, but can fill them with any "paint," that is any values of these Fields.

Legacy terms

Legacy versions of eZ had the same underlying content model, but used different terms for describing it. For reference, the legacy terms were:

Content item – content object
Content Type – content class
Field – attribute
Field Type – datatype

Diagram of the content model

Fields and Field Types

 

 

Just like every Content item is based on a Content Type, so every Field belongs to one of the Field Types.

A Field Type defines what kind of data is stored in a Field. For example, a Field with a TextLine Field Type stores a single line of text, an Image Field Type stores an image, and Author Field Type holds information about author details (like name, email). By default, the system comes with a set of fundamental Field Types that cover most common needs (e.g. Text line, Rich text, Email, Author list, Content relation, Map location, Float, etc.)

Learn more

You can also create your own Field Types to build powerful and complex content structures.

Custom Field Types have to be programmed in the PHP scripting language. However, the built-in Field Types are usually sufficient for typical scenarios.

 

Summary

 

 

 

What you should know:

Content Items:

  1. A Content item consists of a number of Fields.
  2. Every Content item is based on a Content Type.

Content Types:

  1. A Content Type defines Fields that a Content item will be composed of.
  2. Every Field belongs to a Field Type which defines the kind of data it contains.
  3. eZ offers a Demo bundle which contains built-in Content Types. You can use them or create new ones.

Fields and Field Types:

  1. eZ comes with a collection of essential Field Types.
  2. It is possible to extend the system by creating custom Field Types for special needs.

You can find more in-depth, technical information about the content model in eZ at Content model overview.

 

 

What next?

Learn about the Demo Bundle.

 

 

2 Comments

  1. Bertrand Dunogier

    Really nice to read the fundamental concepts.

    I think we might wanna connect those concepts to their purpose, e.g. tools to modelize an Information System into Content, and maybe why it is important.

  2. Krzysztof Rajzer

    Bertrand, thank you for you feedback. The Doc team is always receptive to new ideas.