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, aperson
element with anid
attribute that matches this attribute must appear somewhere before thisauthor
element in the syndication file.If
dbid
orsource
andsourceid
are specified, then this attribute is ignored. source="
text"
(optional)-
The
source
of the author. If this attribute is specified, thensourceid
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
andsourceid
attributes that match this element'ssource
andsourceid
, or -
A
person
oruser
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thisauthor
element in the syndication file.
If
dbid
is specified, thensource
andsourceid
are ignored. -
sourceid="
text"
(optional)-
The
sourceid
of the author. If this attribute is specified, thensource
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
andsourceid
attributes that match this element'ssource
andsourceid
, or -
A
person
oruser
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thisauthor
element in the syndication file.
If
dbid
is specified, thensource
andsourceid
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: 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
oruser
element with afield
calledfirst-name
that matches this attribute must appear somewhere before thisauthor
element in the syndication file.
Using the
first-name
attribute on its own is not recommended; you should use it in combination with thelast-name
attribute.If
dbid
orsource
andsourceid
orid-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
oruser
element with afield
calledlast-name
that matches this attribute must appear somewhere before thisauthor
element in the syndication file.
Using the
last-name
attribute on its own is not recommended; you should use it in combination with thefirst-name
attribute.If
dbid
orsource
andsourceid
orid-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
oruser
element with afield
calledusername
that matches this attribute must appear somewhere before thisauthor
element in the syndication file.
If
dbid
orsource
andsourceid
orid-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
oruser
element with afield
calledemail-address
that matches this attribute must appear somewhere before thisauthor
element in the syndication file.
If
dbid
orsource
andsourceid
orid-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
andsource-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.