author

A reference to a content item author. 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).

An author element must therefore contain a reference to a person object in the target publication or a person element in the syndication file.

Syntax
<author
    id-ref="text"?
    (source="text" sourceid="text")?
    dbid="text"?
    first-name="text"?
    last-name="text"?
    username="text"?
    email-address="text"?
    publication-name="text"?
  />
Examples
  • This example imports a reference to an author (person). The referenced author must already exist in the database or appear before this element in the syndication file.

    <author username="m.cicero"/>
    
Attributes
id-ref="text" (optional)

The id of the author. If this attribute is specified, a person element with an id attribute that matches this attribute must appear somewhere before this author 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 author. 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 author element in the syndication file.

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

sourceid="text" (optional)

The sourceid of the author. 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 author element in the syndication file.

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

dbid="text" (optional)

The dbid of the author. 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 author element in the syndication file.

first-name="text" (optional)

The first name of the this author. 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 author 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 author. 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 author 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 author. 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 author 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 author. 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 author 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.