Blokkal

an Extendable KDE Blogging Client

• Download
• Screenshots
• LiveJournal Community
• API Documentation
• Contact

• Class Hierarchy
• Class List
• File List
• Class Members

blokkalaccount.h

/***************************************************************************
 *   Copyright (C) 2006 - 2008 by Martin Mueller                           *
 *   orvio@orvio.de                                                        *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/
#ifndef BLOKKALACCOUNT_H
#define BLOKKALACCOUNT_H

#include <QtCore/QObject>

#include "blokkal_export.h"

class QAction;

class KUrl;
class QDomElement;
class KIcon;

namespace KWallet {
class Wallet;
}

namespace Blokkal  {
class Protocol;
class AccountConfig;
class Blog;
class BlogConfig;
namespace Io {
class CategoryManager;
}

class BLOKKAL_EXPORT Account : public QObject
{
Q_OBJECT
public:
        enum ConnectionStatus {
                Connected = 1, 
                Connecting = 2, 
                Disconnected = 3, 
        };

        enum DisconnectReason {
                UserDisconnect = 1, 
                IOErrorDisconnect = 2, 
                OtherDisconnect = 3, 
                AuthenticationDisconnect = 4, 
        };

        virtual ~Account( void );

        Blokkal::Protocol * protocol( void ) const;
                
        QString serverName( void ) const;

        void setServerName( const QString & serverName );

        KUrl connectAddress( void ) const;

        void setConnectAddress( const QString & address );
        
        bool usesDefaultConnectAddress( void ) const;

        void setUsesDefaultConnectAddress( bool useDefault );

        bool autoConnect( void ) const;

        void setAutoConnect( bool enable ) const;

        QString id( void ) const;

        QString userName( void ) const;

        void setUserName( const QString & user );

        virtual KIcon icon( void ) const;

        virtual void removeAccount( void );

        Blokkal::Account::ConnectionStatus connectionStatus( void ) const;

        bool isConnected( void ) const;

        bool isDisconnected( void ) const;

        QList< Blokkal::Blog * > blogs( void ) const;

        Blokkal::Blog * blog( const QString & id ) const;

        QString dataDirectory( void ) const;

        virtual QList<QAction*> actionList( void );

public Q_SLOTS:
        virtual void connectAccount( void ) = 0;

        virtual void disconnectAccount( Blokkal::Account::DisconnectReason reason = UserDisconnect,
                                        const QString & reasonString = 0 );

        void restoreBlogs( void );

        Blokkal::Io::CategoryManager * categoryManager( void ) const;

Q_SIGNALS:
        void accountDestroyed( Blokkal::Account * account );

        void connectionStatusChanged( Blokkal::Account * account );

        void blogRegistered( Blokkal::Blog * blog );

        void blogUnregistered( Blokkal::Blog * blog );

protected:
        Account( Blokkal::Protocol * protocol, const QString & id = 0 );
        
        void setConnectionStatus( Blokkal::Account::ConnectionStatus status );

        Blokkal::AccountConfig * config( void ) const;
        
        QDomElement blogNode( const QString & id );
        
        virtual Blokkal::Blog * restoreBlog( Blokkal::BlogConfig * config ) = 0;
        
protected Q_SLOTS:
        Blokkal::Blog * registerBlog( Blokkal::Blog * blog );

        void unregisterBlog( Blokkal::Blog * blog );

private:
        class Private;
        Private * const d;
        friend class BlogConfig;
};

class BLOKKAL_EXPORT PasswordedAccount : public Blokkal::Account
{
Q_OBJECT
public: 
        virtual ~PasswordedAccount( void );

        virtual void removeAccount( void );

public Q_SLOTS:
        virtual void connectAccount( void );

        virtual void disconnectAccount( Blokkal::Account::DisconnectReason reason = UserDisconnect,
                                        const QString & reasonString = 0 );
        
protected:
        PasswordedAccount( Blokkal::Protocol * protocol, const QString & id = 0 );

        const QString & password( void ) const;

protected Q_SLOTS:
        virtual void connectInner( void ) = 0;

private Q_SLOTS:
        void slotWalletOpened( KWallet::Wallet * wallet );
        
private:
        QString promptUser( bool & success, KWallet::Wallet * wallet );
        
        class Private;
        Private * const d;

};

} //Blokkal




#endif