itiphandlerhelper_p.h

/*
  Copyright (c) 2002-2004 Klarälvdalens Datakonsult AB
        <info@klaralvdalens-datakonsult.se>

  Copyright (C) 2010 Bertjan Broeksema <broeksema@kde.org>
  Copyright (C) 2010 Klaralvdalens Datakonsult AB, a KDAB Group company <info@kdab.net>

  This library is free software; you can redistribute it and/or modify it
  under the terms of the GNU Library General Public License as published by
  the Free Software Foundation; either version 2 of the License, or (at your
  option) any later version.

  This library 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 Library General Public
  License for more details.

  You should have received a copy of the GNU Library General Public License
  along with this library; see the file COPYING.LIB.  If not, write to the
  Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  02110-1301, USA.
*/

#ifndef AKONADI_CALENDAR_ITIP_HANDLERHELPER_P_H
#define AKONADI_CALENDAR_ITIP_HANDLERHELPER_P_H

#include "itiphandler.h"
#include "mailscheduler_p.h"

#include <kcalcore/incidence.h>
#include <kcalcore/schedulemessage.h>

#include <KGuiItem>
#include <KLocalizedString>

#include <QObject>

class QWidget;

namespace Akonadi {

enum Status {
    StatusNone,
    StatusSendingInvitation
};

class ITIPHandlerHelper : public QObject
{
    Q_OBJECT
public:
    explicit ITIPHandlerHelper(QWidget *parent = 0);   // TODO
    ~ITIPHandlerHelper();

    enum SendResult {
        ResultCanceled,        
        ResultFailKeepUpdate,  
        ResultFailAbortUpdate, 
        ResultNoSendingNeeded, 
        ResultError,           
        ResultSuccess          
    };

    enum Action {
        ActionAsk,
        ActionSendMessage,
        ActionDontSendMessage
    };

    void setDefaultAction(Action action);

    void setDialogParent(QWidget *parent);

    ITIPHandlerHelper::SendResult sendIncidenceCreatedMessage(KCalCore::iTIPMethod method,
            const KCalCore::Incidence::Ptr &incidence);

    bool handleIncidenceAboutToBeModified(const KCalCore::Incidence::Ptr &incidence);

    ITIPHandlerHelper::SendResult sendIncidenceModifiedMessage(KCalCore::iTIPMethod method,
            const KCalCore::Incidence::Ptr &incidence,
            bool attendeeStatusChanged);

    ITIPHandlerHelper::SendResult sendIncidenceDeletedMessage(KCalCore::iTIPMethod method,
            const KCalCore::Incidence::Ptr &incidence);

    ITIPHandlerHelper::SendResult sendCounterProposal(const KCalCore::Incidence::Ptr &oldIncidence,
            const KCalCore::Incidence::Ptr &newIncidence);

    // Frees calendar if it doesn't have jobs running
    void calendarJobFinished(bool success, const QString &errorString);

Q_SIGNALS:
    void finished(Akonadi::ITIPHandlerHelper::SendResult result,
                  const QString &errorMessage);

private Q_SLOTS:
    void onSchedulerFinished(Akonadi::Scheduler::Result result, const QString &errorMsg);

private:
    ITIPHandlerHelper::SendResult sentInvitation(int messageBoxReturnCode,
            const KCalCore::Incidence::Ptr &incidence,
            KCalCore::iTIPMethod method);

    int askUserIfNeeded(const QString &question,
                        bool ignoreDefaultAction = true,
                        const KGuiItem &buttonYes = KGuiItem(i18n("Send Email")),
                        const KGuiItem &buttonNo = KGuiItem(i18n("Do Not Send"))) const;

    bool weAreOrganizerOf(const KCalCore::Incidence::Ptr &incidence);

    bool weNeedToSendMailFor(const KCalCore::Incidence::Ptr &incidence);

    ITIPHandlerHelper::Action mDefaultAction;
    QWidget *mParent;
    MailScheduler *m_scheduler;
    Status m_status;
};

}

#endif