creator

A reference to the creator of a content item. Content item authors are themselves represented by person objects. A person object is a special type of content item containing the fields needed to hold the usual kinds of personal details (name, phone number, email address and so on).

A creator element must therefore contain a reference to a person object in the publication or a person element in the syndication file.

Syntax
<creator
    id-ref="text"?
    (source="text" sourceid="text")?
    dbid="text"?
    first-name="text"?
    last-name="text"?
    username="text"?
    email-address="text"?
    publication-name="text"?
  />
Attributes
id-ref="text" (optional)

The id of the creator. If this attribute is specified, a person element with an id attribute that matches this attribute must appear somewhere before this creator element in the syndication file.

If dbid or source and sourceid are specified, then this attribute is ignored.

source="text" (optional)

The source of the creator. If this attribute is specified, then sourceid must also be specified. One of the following two conditions must be satisfied:

  • The target publication must already contain a "person" or "user" content item with source and sourceid attributes that match this element's source and sourceid, or

  • A person or user element with source and sourceid attributes that match source and sourceid must appear somewhere before this creator element in the syndication file.

If dbid is specified, then source and sourceid are ignored.

sourceid="text" (optional)

The sourceid of the creator. If this attribute is specified, then source must also be specified. One of the following two conditions must be satisfied:

  • The target publication must already contain a "person" or "user" content item with source and sourceid attributes that match this element's source and sourceid, or

  • A person or user element with source and sourceid attributes that match source and sourceid must appear somewhere before this creator element in the syndication file.

If dbid is specified, then source and sourceid are ignored.

dbid="text" (optional)

The dbid of the creator. If this attribute is specified, then one of the following two conditions must be satisfied:

  • The target publication must already contain a "person" or "user" content item with a dbid attribute that matches this attribute, or

  • A person or user element with a dbid attribute that matches this attribute must appear somewhere before this creator element in the syndication file.

first-name="text" (optional)

The first name of the this creator. If this attribute is specified, then one of the following two conditions must be satisfied:

  • The target publication must already contain a "person" or "user" content item with a first-name field that matches this attribute, or

  • A person or user element with a field called first-name that matches this attribute must appear somewhere before this creator element in the syndication file.

Using the first-name attribute on its own is not recommended; you should use it in combination with the last-name attribute.

If dbid or source and sourceid or id-ref are specified, then this attribute is ignored.

last-name="text" (optional)

The surname of the this creator. If this attribute is specified, then one of the following two conditions must be satisfied:

  • The target publication must already contain a "person" or "user" content item with a last-name field that matches this attribute, or

  • A person or user element with a field called last-name that matches this attribute must appear somewhere before this creator element in the syndication file.

Using the last-name attribute on its own is not recommended; you should use it in combination with the first-name attribute.

If dbid or source and sourceid or id-ref are specified, then this attribute is ignored.

username="text" (optional)

The username of the this creator. If this attribute is specified, then one of the following two conditions must be satisfied:

  • The target publication must already contain a "person" or "user" content item with a username field that matches this attribute, or

  • A person or user element with a field called username that matches this attribute must appear somewhere before this creator element in the syndication file.

If dbid or source and sourceid or id-ref are specified, then this attribute is ignored.

email-address="text" (optional)

The email of the this creator. If this attribute is specified, then one of the following two conditions must be satisfied:

  • The target publication must already contain a "person" or "user" content item with an email-address field that matches this attribute, or

  • A person or user element with a field called email-address that matches this attribute must appear somewhere before this creator element in the syndication file.

If dbid or source and sourceid or id-ref are specified, then this attribute is ignored.

publication-name="text" (optional)

The name of the publication to which the referenced content item or section belongs. This attribute may only be used in combination with the source and source-id attributes. It is needed to ensure unique identification in situations where cross-publishing is in use and the referenced content item or section does not belong to the current publication.