Path

7x / documentation / ez publish / technical manual / 4.x / reference / objects / ezcontentobject


Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

ezcontentobject

Summary

Contains information about a content object.

Persistent

Yes.

Attributes

Attribute

Type

Static*

Description

id

string

Yes.

The ID number of the object.

section_id

string

Yes.

The ID number of the section that the object belongs to.

owner_id

string

Yes.

The ID number of the object representing the user who initially created the object.

contentclass_id

string

Yes.

The ID number of the content class which the object is an instance of.

is_published

string

Yes.

Either 1 or 0. 1 means that the object has been published. 0 means that the object has not yet been published.

published

string

Yes.

A UNIX timestamp pinpointing the exact date/time when the object was published for the first time.

modified

string

Yes.

A UNIX timestamp pinpointing the exact date/time when the object was last modified.

current_version

string

Yes.

The number of the currently published version.

status

string

Yes.

The status of the object (0=Draft, 1=Published, 2=Archived).

remote_id

string

Yes.

A global unique ID for the object. The remote ID is an MD5 hash of the time when the object was created plus a random value. Remote IDs are used in order to avoid collisions of identical objects during an import.

language_mask

string

Yes.

The sum of the ID numbers of the languages in which the last published version of the object exists. Please note that the ID numbers are powers of 2. 1 (2^0) is reserved for marking objects that should always be available. Objects that are always available will be fetched even if they do not exist in any of the site/prioritized languages (the initial/main language of the object will be used).

initial_language_idassigned_nodes

string

Yes.

The ID number of the initial/main language.

current

object

No.

The current version (as ezcontentobjectversion) of the object.

versions

array

No.

The object's versions (as ezcontentobjectversion objects).

author_array

array

No.

Array of ezuser objects representing the different creators of the content object's versions.

class_name

string

No.

The name of the class which the content object is an instance of (for example "Consumer product").

content_class

object

No.

The content class (as ezcontentclass) which the content object is an instance of.

contentobject_attributes

array

No.

Array of ezcontentobjectattribute objects representing the attributes of the content object.

owner

object

No.

An ezcontentobject that represents the user who initially created the object.

related_contentobject_array

array

No.

An array of ezcontentobject objects that are related to this object. This attribute is deprecated. It is recommended to use the "related_objects" fetch function instead.

related_contentobject_count

string

No.

The number of objects that are related to this object. This attribute is deprecated. It is recommended to use the "related_objects_count" fetch function instead.

reverse_related_contentobject_array

array

No.

An array of ezcontentobject objects that make use of this object (reverse relations). This attribute is deprecated. It is recommended to use the "reverse_related_objects" fetch function instead.

reverse_related_contentobject_count

string

No.

The number of objects that are using this object. This attribute is deprecated. It is recommended to use the "reverse_related_objects_count" fetch function instead.

linked_contentobject_array

array

No.

An array of ezcontentobject objects that are related to this object by means of the "XML linked" object relation.

linked_contentobject_count

string

No.

The number of objects that are related to this object by means of the "XML linked" object relation.

reverse_linked_contentobject_array

array

No.

An array of ezcontentobject objects that make use of this object by means of the "XML linked" object relation.

reverse_linked_contentobject_count

string

No.

The number of objects that are using this object by means of the "XML linked" object relation.

embedded_contentobject_array

array

No.

An array of ezcontentobject objects that are related to this object by means of the "XML embedded" object relation.

embedded_contentobject_count

string

No.

The number of objects that are related to this object by means of the "XML embedded" object relation.

reverse_embedded_contentobject_array

array

No.

An array of ezcontentobject objects that make use of this object by means of the "XML embedded" object relation.

reverse_embedded_contentobject_count

string

No.

The number of objects that are using this object by means of the "XML embedded" object relation.

can_read

boolean

No.

Returns TRUE if the current user has read access to the object, FALSE otherwise.

can_pdf

boolean

No.

Not documented yet.

can_diff

boolean

No.

Not documented yet.

can_create

boolean

No.

Not documented yet.

can_create_class_list

array

No.

Not documented yet.

can_edit

boolean

No.

Returns TRUE if the current user has edit access to the object, FALSE otherwise.

can_translate

boolean

No.

Returns TRUE if the current user has permissions to translate the contents of the object, FALSE otherwise.

can_remove

boolean

No.

Returns TRUE if the current user has permissions to remove the object, FALSE otherwise.

can_move

boolean

No.

Not documented yet.

can_move_from

boolean

No.

Returns TRUE if the current user has permissions to move the main node of the object, FALSE otherwise.

can_view_embed

boolean

No.

Not documented yet.

data_map

array

No.

Array of ezcontentobjectattribute objects representing the actual attributes of the content object.

main_parent_node_id

string

No.

The ID number of the main node of the object encapsulated by the parent node.

assigned_nodes

array

No.

Array of nodes (as ezcontentobjecttreenode objects) that encapsulate the object.

parent_nodes

array

No.

An array of ID numbers of the parent nodes (as strings).

main_node_id

string

No.

The ID number of the object's main node.

main_node

object

No.

The object's main node (as ezcontentobjecttreenode).

default_language

string

No.

The default language for content objects (see ContentObjectLocale) if it is set or the most prioritized language (i.e. the first element of the "SiteLanguageList" array).

content_action_list

array

No.

An array of hashes revealing information about the content actions that can be performed on the object. The keys "name" and "action" contain the actual name (for example "Add to basket" - which should be value of the HTML input tag) and the action itself (for example "ActionAddToBasket" - which should be the name of the HTML input tag). The array is generated by a function that examines the object's attributes. If a datatype used to represent an attribute provides support for content actions or if the attribute is an information collector, the supported actions will be added to the "content_action_list" array. This array can be used to automatically generate action buttons (standard HTML buttons) for content objects that either make use of special datatypes or have attributes that are marked as information collectors.

class_identifier

string

No.

The identifier of the class which the object is an instance of (for example "consumer_product").

class_group_id_list

array

No.

An array of ID numbers of the class groups which the class (that the object is an instance of) belongs to.

name

string

No.

The actual name of the object in the current language (for example "Liver sandwich").

match_ingroup_id_list

array

No.

The ID numbers of the class groups that the class (which the object is an instance of) belongs to. This variable is connected with a feature that makes it possible to create template overrides based on class groups.

By default the "match_ingroup_id_list" always returns a boolean FALSE value because the class group override feature is turned off. It can be turned on by setting the "EnableClassGroupOverride" directive in the [ContentOverrideSettings] block of a configuration override for "content.ini" to "true".

current_language

string

No.

Not documented yet.

current_language_object

object

No.

Not documented yet.

initial_language

object

No.

The initial/main language as a ezcontentlanguage object.

initial_language_code

string

No.

The code of the initial/main language (for example "eng-GB").

available_languages

array

No.

The languages in which the last published version of the object exists (as an array of locale codes).

language_codes

array

No.

Not documented yet.

language_js_array

string

No.

Not documented yet.

languages

array

No.

The list of languages the object exists in, ordered by their priority (as an array of ezcontentlanguage objects).

can_edit_languages

array

No.

Not documented yet.

can_create_languages

array

No.

Not documented yet.

always_available

boolean

No.

Returns TRUE if the object is marked as "always available" (i.e. the object will be fetched even if it does not exist in any of the site languages), FALSE otherwise.

state_id_array

array

No.

Array containing the states ID of the content object.

state_identifier_array

array

No.

Array containing the states identifiers of the content object.

visible_nodes

object

No.

Returns the visible nodes of the current object. The main node is the first element in the returned value (if it is considered visible).
The setting site.ini/[SiteAccessSettings]/ShowHiddenNodes is taken into account. For instance, an hidden (or hidden by superior) node is considered visible if ShowHiddenNodes is true.

has_visible_node

boolean

No.

Returns whether the current object has at least one visible node.
The setting site.ini/[SiteAccessSettings]/ShowHiddenNodes is taken into account. For instance, an hidden (or hidden by superior) node is considered visible if ShowHiddenNodes is true.

* Indicates whether the attribute provides a pre-fetched value or if it needs to be computed upon request.

Balazs Halasy (22/02/2005 8:41 am)

Ricardo Correia (05/07/2013 1:33 pm)

Balazs Halasy, Svitlana Shatokhina, Julia Shymova, Geir Arne Waaler, Ricardo Correia


Comments

  • main_parent_node_id

    This was a bit unclear to me:
    "The ID number of the main node of the object encapsulated by the parent node. "

    Let me phrase it another way;
    "The object is encapsulated in a main node, that node has a parent node. main_parent_node_id is the node_id if that parent node.