#include <gdata.h>

Inheritance diagram for KBlog::GData:

Signals
void	createdComment (const KBlog::BlogPost post, const KBlog::BlogComment comment)

void	fetchedProfileId (const QString &profileId)

void	listedAllComments (const QList< KBlog::BlogComment > &commentsList)

void	listedBlogs (const QList< QMap< QString, QString > > &blogsList)

void	listedComments (KBlog::BlogPost *post, const QList< KBlog::BlogComment > &comments)

void	removedComment (const KBlog::BlogPost post, const KBlog::BlogComment comment)

Signals inherited from KBlog::Blog
void	createdPost (KBlog::BlogPost *post)

void	error (KBlog::Blog::ErrorType type, const QString &errorMessage)

void	errorComment (KBlog::Blog::ErrorType type, const QString &errorMessage, KBlog::BlogPost post, KBlog::BlogComment comment)

void	errorMedia (KBlog::Blog::ErrorType type, const QString &errorMessage, KBlog::BlogMedia *media)

void	errorPost (KBlog::Blog::ErrorType type, const QString &errorMessage, KBlog::BlogPost *post)

void	fetchedPost (KBlog::BlogPost *post)

void	listedRecentPosts (const QList< KBlog::BlogPost > &posts)

void	modifiedPost (KBlog::BlogPost *post)

void	removedPost (KBlog::BlogPost *post)

Public Member Functions
	GData (const KUrl &server, QObject *parent=0)

	~GData ()

virtual void	createComment (KBlog::BlogPost post, KBlog::BlogComment comment)

void	createPost (KBlog::BlogPost *post)

void	fetchPost (KBlog::BlogPost *post)

void	fetchProfileId ()

QString	fullName () const

QString	interfaceName () const

virtual void	listAllComments ()

virtual void	listBlogs ()

virtual void	listComments (KBlog::BlogPost *post)

void	listRecentPosts (int number)

virtual void	listRecentPosts (const QStringList &label=QStringList(), int number=0, const KDateTime &upMinTime=KDateTime(), const KDateTime &upMaxTime=KDateTime(), const KDateTime &pubMinTime=KDateTime(), const KDateTime &pubMaxTime=KDateTime())

void	modifyPost (KBlog::BlogPost *post)

QString	profileId () const

virtual void	removeComment (KBlog::BlogPost post, KBlog::BlogComment comment)

void	removePost (KBlog::BlogPost *post)

virtual void	setFullName (const QString &fullName)

virtual void	setProfileId (const QString &pid)

Public Member Functions inherited from KBlog::Blog
	Blog (const KUrl &server, QObject *parent=0, const QString &applicationName=QString(), const QString &applicationVersion=QString())

virtual	~Blog ()

QString	blogId () const

QString	password () const

virtual void	setBlogId (const QString &blogId)

virtual void	setPassword (const QString &password)

virtual void	setTimeZone (const KTimeZone &timeZone)

virtual void	setUrl (const KUrl &url)

void	setUserAgent (const QString &applicationName, const QString &applicationVersion)

virtual void	setUsername (const QString &username)

KTimeZone	timeZone ()

KUrl	url () const

QString	userAgent () const

QString	username () const

Public Member Functions inherited from QObject
	QObject (QObject *parent)

	QObject (QObject parent, const char name)

bool	blockSignals (bool block)

QObject *	child (const char objName, const char inheritsClass, bool recursiveSearch) const

const QObjectList &	children () const

const char *	className () const

bool	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const

void	deleteLater ()

void	destroyed (QObject *obj)

bool	disconnect (const QObject receiver, const char method)

bool	disconnect (const char signal, const QObject receiver, const char *method)

void	dumpObjectInfo ()

void	dumpObjectTree ()

QList< QByteArray >	dynamicPropertyNames () const

virtual bool	event (QEvent *e)

virtual bool	eventFilter (QObject watched, QEvent event)

T	findChild (const QString &name) const

QList< T >	findChildren (const QRegExp &regExp) const

QList< T >	findChildren (const QString &name) const

bool	inherits (const char *className) const

void	insertChild (QObject *object)

void	installEventFilter (QObject *filterObj)

bool	isA (const char *className) const

bool	isWidgetType () const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

const char *	name () const

const char *	name (const char *defaultName) const

QString	objectName () const

QObject *	parent () const

QVariant	property (const char *name) const

void	removeChild (QObject *object)

void	removeEventFilter (QObject *obj)

void	setName (const char *name)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

bool	setProperty (const char *name, const QVariant &value)

bool	signalsBlocked () const

int	startTimer (int interval)

QThread *	thread () const

Protected Member Functions
	GData (const KUrl &server, GDataPrivate &dd, QObject *parent=0)

Protected Member Functions inherited from KBlog::Blog
	Blog (const KUrl &server, BlogPrivate &dd, QObject *parent=0, const QString &applicationName=QString(), const QString &applicationVersion=QString())

Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char signal, const QObject object, const char *method)

virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const char *signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const char *signal)

int	receivers (const char *signal) const

QObject *	sender () const

int	senderSignalIndex () const

virtual void	timerEvent (QTimerEvent *event)

Additional Inherited Members
Public Types inherited from KBlog::Blog
enum	ErrorType { XmlRpc, Atom, ParsingError, AuthenticationError, NotSupported, Other }

Static Public Member Functions inherited from QObject
bool	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

bool	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)

Protected Attributes inherited from KBlog::Blog
BlogPrivate *const	d_ptr

Properties inherited from QObject
	objectName

Detailed Description

A class that can be used for access to GData blogs.

The new blogspot.com accounts ( August 2007 ) exclusively support GData API which is a standard based on Atom API. Compared to Blogger 1.0, which is based on Xml-Rpc and less secure, it adds new functionality like titles and comments.

Blog* myblog = new GData("http://myblogspot.account.com");
myblog->setProfileId( "2039484587348593945823" ); // can be fetched via fetchProfileId()
myblog->setBlogId( "1" ); // can be caught by listBlogs()
myblog->setUsername( "your_email@address.com" );
myblog->setPassword( "yOuRFuNnYPasSword" );
KBlog::BlogPost *post = new BlogPost();
post->setTitle( "This is the title." );
post->setContent( "Here is some the content..." );
myblog->createPost( post );

Author: Christian Weilbach <christian_weilbach@web.de>; Reinhold Kainhofer <reinhold@kainhofer.com>

Definition at line 70 of file gdata.h.

Constructor & Destructor Documentation

GData::GData	(	const KUrl &	server,
		QObject *	parent = `0`
	)

explicit

Create an object for GData.

Parameters

server	The server url for the xmlrpc gateway.
parent	The parent object, inherited from QObject.

Definition at line 45 of file gdata.cpp.

GData::~GData ( )

Destructor.

Definition at line 52 of file gdata.cpp.

KBlog::GData::GData	(	const KUrl &	server,
		GDataPrivate &	dd,
		QObject *	parent = `0`
	)

protected

Overloaded for private inheritance handling.

Member Function Documentation

void GData::createComment	(	KBlog::BlogPost *	post,
		KBlog::BlogComment *	comment
	)

virtual

Create a comment on the server.

Parameters

post	This is the post with its id set correctly.
comment	This is the comment to create.

See also: BlogPost::setPostId( const QString& ); createdComment( KBlog::BlogPost*, KBlog::BlogComment* )

Definition at line 365 of file gdata.cpp.

void KBlog::GData::createdComment	(	const KBlog::BlogPost *	post,
		const KBlog::BlogComment *	comment
	)

signal

This signal is emitted when a comment has been created on the blogging server.

Parameters

post	This is the corresponding post.
comment	This is the created comment.

See also: createComment( KBlog::BlogPost *post, KBlog::BlogComment *comment )

void GData::createPost ( KBlog::BlogPost * post )

virtual

Create a new post on server.

Parameters

post	This is send to the server.

See also: createdPost( KBlog::BlogPost *post )

Implements KBlog::Blog.

Definition at line 266 of file gdata.cpp.

void KBlog::GData::fetchedProfileId ( const QString & profileId )

signal

This signal is emitted when the profile id has been fetched.

Parameters

profileId This is the fetched id. On error it is QString()

See also: fetchProfileId()

void GData::fetchPost ( KBlog::BlogPost * post )

virtual

Fetch the Post with a specific id.

Parameters

post	This is the post with its id set correctly.

See also: BlogPost::setPostId( const QString& ); fetchedPost( KBlog::BlogPost *post )

Implements KBlog::Blog.

Definition at line 181 of file gdata.cpp.

void GData::fetchProfileId ( )

Get information about the profile from the blog.

Sets the profileId automatically for the blog it is called from.

See also: setProfileId( const QString& ); void fetchedProfileId( const QString& )

Definition at line 89 of file gdata.cpp.

QString GData::fullName ( ) const

Returns the full name of user of the blog.

See also: setFullName()

Definition at line 63 of file gdata.cpp.

QString GData::interfaceName ( ) const

virtual

Returns the of the inherited object.

Implements KBlog::Blog.

Definition at line 57 of file gdata.cpp.

void GData::listAllComments ( )

virtual

List the all comments available for this authentication on the server.

See also: void listedAllComments( const QList<KBlog::BlogComment>& )

Definition at line 170 of file gdata.cpp.

void GData::listBlogs ( )

virtual

List the blogs available for this authentication on the server.

See also: void listedBlogs( const QList<QMap<QString,QString>>& )

Definition at line 99 of file gdata.cpp.

void GData::listComments ( KBlog::BlogPost * post )

virtual

List the comments available for this post on the server.

Parameters

post	The post, which posts should be listed.

See also: void listedComments( KBlog::BlogPost*, const QList<KBlog::BlogComment>& )

Definition at line 156 of file gdata.cpp.

void KBlog::GData::listedAllComments ( const QList< KBlog::BlogComment > & commentsList )

signal

This signal is emitted when a list of all comments has been fetched from the blogging server.

Parameters

commentsList The list of comments.

See also: listAllComments()

void KBlog::GData::listedBlogs ( const QList< QMap< QString, QString > > & blogsList )

signal

This signal is emitted when a list of blogs has been fetched from the blogging server.

Parameters

blogsList The list of blogs.

See also: listBlogs()

void KBlog::GData::listedComments	(	KBlog::BlogPost *	post,
		const QList< KBlog::BlogComment > &	comments
	)

signal

This signal is emitted when a list of comments has been fetched from the blogging server.

Parameters

post	This is the corresponding post.
comments	The list of comments.

See also: listComments( KBlog::BlogPost* )

void GData::listRecentPosts ( int number )

virtual

List recent posts on the server.

The status of the posts will be Fetched.

Parameters

number The number of posts to fetch. The order is newest first.

See also: void listedPosts( const QList<KBlog::BlogPost>& ); void fetchPost( KBlog::BlogPost* ); BlogPost::Status

Implements KBlog::Blog.

Definition at line 150 of file gdata.cpp.

void GData::listRecentPosts	(	const QStringList &	label = `QStringList()`,
		int	number = `0`,
		const KDateTime &	upMinTime = `KDateTime()`,
		const KDateTime &	upMaxTime = `KDateTime()`,
		const KDateTime &	pubMinTime = `KDateTime()`,
		const KDateTime &	pubMaxTime = `KDateTime()`
	)

virtual

List recent posts on the server depending on meta information about the post.

Parameters

label	The lables of posts to fetch.
number	The number of posts to fetch. The order is newest first.
upMinTime	The oldest upload time of the posts to fetch.
upMaxTime	The newest upload time of the posts to fetch.
pubMinTime	The oldest publication time of the posts to fetch.
pubMaxTime	The newest publication time of the posts to fetch.

See also: void listedPosts( const QList<KBlog::BlogPost>& ); void fetchPost( KBlog::BlogPost* )

Definition at line 110 of file gdata.cpp.

void GData::modifyPost ( KBlog::BlogPost * post )

virtual

Modify a post on server.

Parameters

post	This is used to send the modified post including the correct id.

Implements KBlog::Blog.

Definition at line 201 of file gdata.cpp.

QString GData::profileId ( ) const

Returns the profile id of the blog.

This is used for rss paths internally.

Returns: The profile id.

See also: setProfileId( const QString& )

Definition at line 76 of file gdata.cpp.

void GData::removeComment	(	KBlog::BlogPost *	post,
		KBlog::BlogComment *	comment
	)

virtual

Remove a comment from the server.

Parameters

post	This is the post with its id set correctly.
comment	This is the comment to remove.

See also: BlogPost::setPostId( const QString& ); removedComment( KBlog::BlogPost*, KBlog::BlogComment* )

Definition at line 419 of file gdata.cpp.

void KBlog::GData::removedComment	(	const KBlog::BlogPost *	post,
		const KBlog::BlogComment *	comment
	)

signal

This signal is emitted when a comment has been removed from the blogging server.

Parameters

post	This is the corresponding post.
comment	This is the removed comment.

See also: removeComment( KBlog::BlogPost *post, KBlog::BlogComment *comment )

void GData::removePost ( KBlog::BlogPost * post )

virtual

Remove a post from the server.

Parameters

post	This is the post with its id set correctly.

See also: BlogPost::setPostId( const QString& ); removedPost( KBlog::BlogPost* )

Implements KBlog::Blog.

Definition at line 326 of file gdata.cpp.

void GData::setFullName ( const QString & fullName )

virtual

Sets the user's name for the blog.

Username is only the E-Mail address of the user. This is used in createPost and modifyPost.

Parameters

fullName is a QString containing the blog username.

See also: username(); createPost( KBlog::BlogPost* ); modifiyPost( KBlog::BlogPost* )

Definition at line 69 of file gdata.cpp.

void GData::setProfileId ( const QString & pid )

virtual

Get the profile's id of the blog.

Parameters

pid	This is nummeric id.

See also: profileId()

Definition at line 82 of file gdata.cpp.

The documentation for this class was generated from the following files:

KBlog Client Library

Signals

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

KBlog Client Library

kdepimlibs API Reference

Search