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.

URL

Summary

Validates and stores a URL / address.

Properties

NameInternal nameSearchableInformation collector
URL ezurl No. No.

Description

This datatype allows the validation and storage of a hyperlink. The following screenshot shows the class attribute edit interface for this datatype.

Class attribute edit interface for the "URL" datatype.

Class attribute edit interface for the "URL" datatype.

Object attribute edit interface

For each link, an address and an additional text may be stored. The following screenshot shows the object attribute edit interface for this datatype.

Object attribute edit interface for the "URL" datatype.

Object attribute edit interface for the "URL" datatype.

URL storage and checking

URLs that are input, either using the URL or the XML block datatype, are stored and handled in a special way. This solution makes it possible to view, edit and check if the URLs actually work on a massive scale.

Important note

Keep in mind that if an URL is marked as invalid by the linkcheck.php cronjob script, the has_content attribute for the matching ezurl attribute will return FALSE. The has_content attribute normally only returns FALSE if the attribute has no content.

Please refer to the "URL storage" section of the "Concepts and basics" chapter for more information about this feature.

Raw output

The ".content" of an ezcontentobjectattribute object using this datatype returns a string containing the actual address.

Balazs Halasy (21/02/2005 2:44 pm)

Ester Heylen (12/07/2010 5:29 pm)

Balazs Halasy, Ester Heylen


Comments

  • 'Text' given by .data_text

    The ".data_text" of an ezcontentobjectattribute object using this datatype returns a string containing the 'Text' description associated with the URL.
    • Re: 'Text' given by .data_text

      Even if it is stated in the docs, be careful. Url text is not mandatory, so you should check for data_text before using it (the std eZ template outputs url target if text is missing)