Feed item field ID's (non-indexed)
[Feed and feed item field ID's]


Defines

#define AFPFID_ITEM_EXTERNALID   2000
 Used to retrieve the external ID of a feed item.
#define AFPFID_ITEM_TITLE   2001
 Used to retrieve the title of a feed item.
#define AFPFID_ITEM_URL   2002
 Used to retrieve the URL of a feed item.
#define AFPFID_ITEM_AUTHORNAME   2003
 Used to retrieve the name of a feed item's author.
#define AFPFID_ITEM_AUTHORURL   2004
 Used to retrieve the home URL of a feed item's author.
#define AFPFID_ITEM_AUTHOREMAIL   2005
 Used to retrieve the email address of a feed item's author.
#define AFPFID_ITEM_PUBDATE   2006
 Used to retrieve the published timestamp of a feed item.
#define AFPFID_ITEM_MODIFIEDTIME   2007
 Used to retrieve the modified timestamp of a feed item.
#define AFPFID_ITEM_COMMENTSURL   2008
 Used to retrieve the comments URL for a feed item.
#define AFPFID_ITEM_SOURCEURL   2009
 Used to retrieve the source URL for a feed item.
#define AFPFID_ITEM_SOURCENAME   2010
 Used to retrieve the source name for a feed item.
#define AFPFID_ITEM_FINGERPRINT   2100
 Used to retrieve the feed item's fingerprint.

Define Documentation

#define AFPFID_ITEM_EXTERNALID   2000
 

Used to retrieve the external ID of a feed item.

For RSS feeds:
Returns the value of the feed item's <dc:identifier> or <guid> tag.
For Atom feeds:
Returns the value of the feed item's <id> tag.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_TITLE   2001
 

Used to retrieve the title of a feed item.

For RSS feeds:
Returns the value of the feed item's <dc:title> or <title> tag.
For Atom feeds:
Returns the value of the feed item's <title> tag.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_URL   2002
 

Used to retrieve the URL of a feed item.

Feed items can have zero or more URL's associated with them. This field returns the URL that best represents the feed item. This will be:

  • the feed item's permalink.
  • any URL that has a reltype of "alternate".
  • the first URL associated with the feed item.

See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_AUTHORNAME   2003
 

Used to retrieve the name of a feed item's author.

For RSS feeds:
Returns the value of the feed item's <author> tag.
For Atom feeds:
Returns the value of the feed item's <author>/<name> tag.
Note:
Refer to AFPFID_ITEM_AUTHOREMAIL for details on how Awasu works around some bad data issues.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_AUTHORURL   2004
 

Used to retrieve the home URL of a feed item's author.

For RSS feeds:
Not used.
For Atom feeds:
Returns the value of the feed item's <author>/<url> tag.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_AUTHOREMAIL   2005
 

Used to retrieve the email address of a feed item's author.

For RSS feeds:
Returns the value of the feed item's <author> tag.
NOTE: The RSS spec states that this element should contain an email address. However, since many publishers are including the author's name, Awasu intelligently decides whether to return the element as AFPFID_ITEM_AUTHORNAME or AFPFID_ITEM_AUTHOREMAIL.
For Atom feeds:
Returns the value of the feed item's <author>/<email> tag.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_PUBDATE   2006
 

Used to retrieve the published timestamp of a feed item.

For RSS feeds:
Returns the value of the feed item's <dc:date> or <pubDate> tag as a time_t.
For Atom feeds:
Not used.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_MODIFIEDTIME   2007
 

Used to retrieve the modified timestamp of a feed item.

For RSS feeds:
Not used.
For RSS feeds:
Returns the value of the feed item's <modified> tag as a time_t.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_COMMENTSURL   2008
 

Used to retrieve the comments URL for a feed item.

For RSS feeds:
Returns the value of the feed item's <comments> tag.
For Atom feeds:
Not used.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_SOURCEURL   2009
 

Used to retrieve the source URL for a feed item.

For RSS feeds:
Returns the value of the feed item's <source> url attribute.
For Atom feeds:
Not used.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_SOURCENAME   2010
 

Used to retrieve the source name for a feed item.

For RSS feeds:
Returns the value of the feed item's <source> tag.
For Atom feeds:
Not used.
See also:
AFP_GetFeedItemField()

#define AFPFID_ITEM_FINGERPRINT   2100
 

Used to retrieve the feed item's fingerprint.

One of the major problems with feeds of any format is uniquely identifying feed items. This is a special feed item field that is generated from various parts of a feed item and while not guaranteed to be unique, should almost be so. The item fingerprint will almost certainly change if any part of the feed item is changed by the publisher and so can be used to detect when a feed item has been edited or modified in some way.

See also:
AFP_GetFeedItemField()