akregator/src

Akregator::Feed Class Reference

#include <feed.h>

Inheritance diagram for Akregator::Feed:

Akregator::TreeNode List of all members.

Detailed Description

represents a feed

Definition at line 62 of file feed.h.


Public Types

enum  ArchiveMode {
  globalDefault, keepAllArticles, disableArchiving, limitArticleNumber,
  limitArticleAge
}

Public Slots

void fetch (bool followDiscovery=false)
void slotAbortFetch ()
virtual void slotDeleteExpiredArticles ()
virtual void slotMarkAllArticlesAsRead ()
virtual void slotAddToFetchQueue (FetchQueue *queue, bool intervalFetchOnly=false)

Signals

void fetchStarted (Feed *)
void fetched (Feed *)
void fetchError (Feed *)
void fetchDiscovery (Feed *)
void fetchAborted (Feed *)

Public Member Functions

 Feed ()
virtual ~Feed ()
virtual bool accept (TreeNodeVisitor *visitor)
virtual QDomElement toOPML (QDomElement parent, QDomDocument document) const
bool useCustomFetchInterval () const
void setCustomFetchIntervalEnabled (bool enabled)
int fetchInterval () const
void setFetchInterval (int interval)
ArchiveMode archiveMode () const
void setArchiveMode (ArchiveMode archiveMode)
int maxArticleAge () const
void setMaxArticleAge (int maxArticleAge)
int maxArticleNumber () const
void setMaxArticleNumber (int maxArticleNumber)
bool markImmediatelyAsRead () const
void setMarkImmediatelyAsRead (bool enabled)
void setUseNotification (bool enabled)
bool useNotification () const
void setLoadLinkedWebsite (bool enabled)
bool loadLinkedWebsite () const
const QPixmap & favicon () const
void setFavicon (const QPixmap &p)
const QPixmap & image () const
const QString & xmlUrl () const
void setXmlUrl (const QString &s)
const QString & htmlUrl () const
void setHtmlUrl (const QString &s)
const QString & description () const
void setDescription (const QString &s)
virtual QValueList< Articlearticles (const QString &tag=QString::null)
virtual Article findArticle (const QString &guid) const
virtual QStringList tags () const
bool fetchErrorOccurred ()
virtual int unread () const
virtual int totalCount () const
bool isArticlesLoaded () const
virtual bool isGroup () const
virtual TreeNodenext ()
void loadFavicon ()
void loadImage ()

Static Public Member Functions

static ArchiveMode stringToArchiveMode (const QString &str)
static QString archiveModeToString (ArchiveMode mode)
static FeedfromOPML (QDomElement e)

Protected Member Functions

void loadArticles ()
void recalcUnreadCount ()
virtual void doArticleNotification ()
void setUnread (int unread)

Friends

class Article

Member Enumeration Documentation

the archiving modes:

  • globalDefault: use default from Settings (default)
  • keepAllArticles: Don't delete any articles
  • disableArchiving: Don't save any articles except articles with keep flag set (equal to maxArticleNumber() == 0)
  • limitArticleNumber: Save maxArticleNumber() articles, plus the ones with keep flag set
  • limitArticleAge: Save articles not older than maxArticleAge() (or keep flag set)

Definition at line 75 of file feed.h.


Constructor & Destructor Documentation

Akregator::Feed::Feed (  ) 

default constructor

Definition at line 274 of file feed.cpp.


Member Function Documentation

Feed::ArchiveMode Akregator::Feed::stringToArchiveMode ( const QString &  str  )  [static]

converts strings to ArchiveMode value if parsing fails, it returns ArchiveMode::globalDefault

Definition at line 258 of file feed.cpp.

QString Akregator::Feed::archiveModeToString ( ArchiveMode  mode  )  [static]

converts ArchiveMode values to corresponding strings

Definition at line 104 of file feed.cpp.

Feed * Akregator::Feed::fromOPML ( QDomElement  e  )  [static]

creates a Feed object from a description in OPML format

Definition at line 125 of file feed.cpp.

QDomElement Akregator::Feed::toOPML ( QDomElement  parent,
QDomDocument  document 
) const [virtual]

exports the feed settings to OPML

Implements Akregator::TreeNode.

Definition at line 366 of file feed.cpp.

bool Akregator::Feed::useCustomFetchInterval (  )  const

returns whether this feed uses its own fetch interval or the global setting

Returns:
true iff this feed has a custom fetch interval

Definition at line 300 of file feed.cpp.

void Akregator::Feed::setCustomFetchIntervalEnabled ( bool  enabled  ) 

set if the feed has its custom fetch interval or uses the global setting

Parameters:
enabled true: use custom interval, false: use global default

Definition at line 302 of file feed.cpp.

int Akregator::Feed::fetchInterval (  )  const

Returns custom auto fetch interval of this feed.

Returns:
custom fetch interval in minutes, 0 if disabled

Definition at line 304 of file feed.cpp.

void Akregator::Feed::setFetchInterval ( int  interval  ) 

Sets custom auto fetch interval.

Parameters:
interval interval in minutes, -1 for disabling auto fetching

Definition at line 306 of file feed.cpp.

Feed::ArchiveMode Akregator::Feed::archiveMode (  )  const

returns the archiving mode which is used for this feed

Definition at line 700 of file feed.cpp.

void Akregator::Feed::setArchiveMode ( ArchiveMode  archiveMode  ) 

sets the archiving mode for this feed

Definition at line 705 of file feed.cpp.

int Akregator::Feed::maxArticleAge (  )  const

returns the maximum age of articles used for expiration by age (used in limitArticleAge archive mode)

Returns:
expiry age in days

Definition at line 308 of file feed.cpp.

void Akregator::Feed::setMaxArticleAge ( int  maxArticleAge  ) 

sets the maximum age of articles used for expiration by age (used in limitArticleAge archive mode)

Parameters:
maxArticleAge expiry age in days

Definition at line 310 of file feed.cpp.

int Akregator::Feed::maxArticleNumber (  )  const

returns the article count limit used in limitArticleNumber archive mode

Definition at line 312 of file feed.cpp.

void Akregator::Feed::setMaxArticleNumber ( int  maxArticleNumber  ) 

sets the article count limit used in limitArticleNumber archive mode

Definition at line 314 of file feed.cpp.

bool Akregator::Feed::markImmediatelyAsRead (  )  const

if true, new articles are marked immediately as read instead of new/unread.

Useful for high-traffic feeds.

Definition at line 316 of file feed.cpp.

void Akregator::Feed::setLoadLinkedWebsite ( bool  enabled  ) 

if true, the linked URL is loaded directly in the article viewer instead of showing the description

Definition at line 335 of file feed.cpp.

const QPixmap & Akregator::Feed::favicon (  )  const

returns the favicon

Definition at line 345 of file feed.cpp.

void Akregator::Feed::setFavicon ( const QPixmap &  p  ) 

sets the favicon (used in the tree view)

Definition at line 694 of file feed.cpp.

const QPixmap & Akregator::Feed::image (  )  const

returns the feed image

Definition at line 347 of file feed.cpp.

const QString & Akregator::Feed::xmlUrl (  )  const

returns the url of the actual feed source (rss/rdf/atom file)

Definition at line 349 of file feed.cpp.

void Akregator::Feed::setXmlUrl ( const QString &  s  ) 

sets the url of the actual feed source (rss/rdf/atom file)

Definition at line 351 of file feed.cpp.

const QString & Akregator::Feed::htmlUrl (  )  const

returns the URL of the HTML page of this feed

Definition at line 353 of file feed.cpp.

void Akregator::Feed::setHtmlUrl ( const QString &  s  ) 

sets the URL of the HTML page of this feed

Definition at line 355 of file feed.cpp.

const QString & Akregator::Feed::description (  )  const

returns the description of this feed

Definition at line 357 of file feed.cpp.

void Akregator::Feed::setDescription ( const QString &  s  ) 

sets the description of this feed

Definition at line 359 of file feed.cpp.

QValueList< Article > Akregator::Feed::articles ( const QString &  tag = QString::null  )  [virtual]

Returns a sequence of the articles this node contains.

For feed groups, this returns a concatenated list of all articles in the sub tree. If tag is not null, only articles tagged with tag are returned

Returns:
sequence of articles

Implements Akregator::TreeNode.

Definition at line 190 of file feed.cpp.

Article Akregator::Feed::findArticle ( const QString &  guid  )  const [virtual]

returns the article with the given guid, or a null article if it not exists

Definition at line 185 of file feed.cpp.

QStringList Akregator::Feed::tags (  )  const [virtual]

returns a list of all tags occurring in this node (sub tree for folders)

Implements Akregator::TreeNode.

Definition at line 180 of file feed.cpp.

bool Akregator::Feed::fetchErrorOccurred (  ) 

returns whether a fetch error has occurred

Definition at line 361 of file feed.cpp.

int Akregator::Feed::unread (  )  const [virtual]

returns the unread count for this feed

Implements Akregator::TreeNode.

Definition at line 710 of file feed.cpp.

int Akregator::Feed::totalCount (  )  const [virtual]

returns the number of total articles in this feed

Returns:
number of articles

Implements Akregator::TreeNode.

Definition at line 750 of file feed.cpp.

bool Akregator::Feed::isArticlesLoaded (  )  const

returns if the article archive of this feed is loaded

Definition at line 363 of file feed.cpp.

virtual bool Akregator::Feed::isGroup (  )  const [inline, virtual]

returns if this node is a feed group (false here)

Implements Akregator::TreeNode.

Definition at line 202 of file feed.h.

TreeNode * Akregator::Feed::next (  )  [virtual]

returns the next node in the tree.

Calling next() unless it returns 0 iterates through the tree in pre-order

Implements Akregator::TreeNode.

Definition at line 755 of file feed.cpp.

void Akregator::Feed::loadFavicon (  ) 

downloads the favicon

Definition at line 652 of file feed.cpp.

void Akregator::Feed::loadImage (  ) 

load the image from the cache if it is in there

Definition at line 207 of file feed.cpp.

void Akregator::Feed::fetch ( bool  followDiscovery = false  )  [slot]

starts fetching

Definition at line 546 of file feed.cpp.

void Akregator::Feed::slotDeleteExpiredArticles (  )  [virtual, slot]

deletes expired articles

Implements Akregator::TreeNode.

Definition at line 657 of file feed.cpp.

void Akregator::Feed::slotMarkAllArticlesAsRead (  )  [virtual, slot]

mark all articles in this feed as read

Implements Akregator::TreeNode.

Definition at line 393 of file feed.cpp.

void Akregator::Feed::slotAddToFetchQueue ( FetchQueue queue,
bool  intervalFetchOnly = false 
) [virtual, slot]

add this feed to the fetch queue queue

Implements Akregator::TreeNode.

Definition at line 407 of file feed.cpp.

void Akregator::Feed::fetchStarted ( Feed  )  [signal]

emitted when fetching started

void Akregator::Feed::fetched ( Feed  )  [signal]

emitted when feed finished fetching

void Akregator::Feed::fetchError ( Feed  )  [signal]

emitted when a fetch error occurred

void Akregator::Feed::fetchDiscovery ( Feed  )  [signal]

emitted when a feed URL was found by auto discovery

void Akregator::Feed::fetchAborted ( Feed  )  [signal]

emitted when a fetch is aborted

void Akregator::Feed::loadArticles (  )  [protected]

loads articles from archive

Definition at line 215 of file feed.cpp.

void Akregator::Feed::doArticleNotification (  )  [protected, virtual]

reimplement this in subclasses to do the actual notification called by articlesModified

Reimplemented from Akregator::TreeNode.

Definition at line 771 of file feed.cpp.

void Akregator::Feed::setUnread ( int  unread  )  [protected]

sets the unread count for this feed

Definition at line 715 of file feed.cpp.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys