NAME

XML::NewsML_G2::News_Item - a news item (story)

DESCRIPTION

This module acts as a base class for NewsML-G2 news items. Instead of using this class, use the most appropriate subclass, e.g. XML::NewsML_G2::News_Item_Text.

ATTRIBUTES

authors

List of strings containing names of the news item's authors

cities

List of strings containing city names where the story has been written down (as opposed to: where the story occured)

closing

Final comment on planned updates of this story

content_created

DateTime instance, defaults to now

content_modified

DateTime instance

credit

Human readable credit line

caption

Human readable content description string

dateline

Natural language information indicating the place and time that the content was created

derived_from

Deprecated - use derived_froms and add_derived_from instead!

derived_froms

List of XML::NewsML_G2::Link instances

desks

List of XML::NewsML_G2::Desk instances

doc_status

Defaults to "usable".

doc_version

Defaults to "1"

embargo

DateTime instance

embargo_text

additional text for specifying details on the embargo

event_references

List of XML::NewsML_G2::Event_Ref instances

evolved_froms

List of XML::NewsML_G2::Link instances

genres

List of XML::NewsML_G2::Genre instances

guid

"identifier that is guaranteed to be globally unique for all time and independent of location". Defaults to a UUID

indicators

List of strings to signal additional information

language

language of the story, required. E.g. "en", "de", ...

locations

Hash mapping qcodes to XML::NewsML_G2::Location instances

media_topics

Hash mapping qcodes to XML::NewsML_G2::Media_Topic instances

concepts

Hash mapping generated uids to XML::NewsML_G2::Concept instances

message_id

Human-readable alternative ID of the story

note

Editorial notes

organisations

List of XML::NewsML_G2::Organisation instances

paragraphs

An XML::LibXML::Node instance containing the content (quite likely p elements, hence the name) of the story - to be put into the XHTML body. Use the add_paragraph method to add text unless you want more control of the output.

priority

Numeric message priority, defaults to 5

processed_froms

List of XML::NewsML_G2::Link instances

products

List of XML::NewsML_G2::Product instances

provider

List of XML::NewsML_G2::Provider instances

remotes

Hash mapping of hrefs to remote object (e.g. XML::NewsML_G2::Picture) instances

see_also

Deprecated - use see_alsos and add_see_also instead!

see_alsos

List of XML::NewsML_G2::Link instances

service

XML::NewsML_G2::Service instance

slugline

String containing the slugline

slugline_sep

Slugline separator, defaults to "/"

election_district

XML::NewsML_G2::ElectionDistrict instance

sources

List of strings containing story source names

storytypes

List of XML::NewsML_G2::StoryType instances

subtitle

Subtitle string

summary

A short overview of all, or at least the most important, facets of the content of the item

byline

A free-text expression of the person or organisation that created the content

teaser

A short description intended to attract the user to view the full content

title

Title string

topics

List of XML::NewsML_G2::Topic instances

usage_terms

String containing human readable usage terms

METHODS

add_author

Add a string to the authors

add_city

Add a string to the cities

add_derived_from

Add a new "derived from" link - either a string, or a XML::NewsML_G2::Link instance

add_desk

Add a XML::NewsML_G2::Desk instance

add_event_reference

Add a XML::NewsML_G2::Event_Ref instance

add_genre

Add a XML::NewsML_G2::Genre instance

add_indicator

Add a string to the indicators

add_location

Add a new XML::NewsML_G2::Location instance

add_media_topic

Add a new XML::NewsML_G2::MediaTopic instance

add_concept

Add a new XML::NewsML_G2::Concept instance

add_organisation

Add a new XML::NewsML_G2::Organisation instance

add_paragraph

Takes a string to be added to the paragraphs Node instance as a p element. To have more control over the created XHTML output, directly set the paragraphs attribute with a Node instance you created by yourself.

add_product

Add a new XML::NewsML_G2::Product instance

add_remote

Add a new remote instance (e.g. XML::NewsML_G2::Picture) with a given href

add_see_also

Add a new "see also" link - either a string, or a XML::NewsML_G2::Link instance

add_source

Add a string to the sources

add_topic

Add a new XML::NewsML_G2::Topic instance

AUTHOR

Philipp Gortan <philipp.gortan@apa.at>

LICENCE AND COPYRIGHT

Copyright (c) 2013-2015, APA-IT. All rights reserved.

See XML::NewsML_G2 for the license.