/*

* Copyright (c) 2009-2010 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:

*

*/

#include "nmuiengineheaders.h"

/*!

 \class NmBaseClientPlugin

 \brief The NmBaseClientPlugin plugin provides ui services for IMAP/POP mail protocols.

 The NmBaseClientPlugin contains the following services:

 \li get actions

 \li refresh mailbox

 \li create new email

 \li open settings

 \li send email

 \li delete email

 \li open email

 \li reply email

 \li reply all email

 \li forward email

 The plugin provides a list of supported UI services as NmAction objects. Actions are connected to

 different public slots and when they are triggered plugin will handle action by itself directly to

 NmUiEngine or by using NmActionResponse to inform user of service.

*/

/*!

    \fn void NmBaseClientPlugin::getActions(const NmActionRequest &request, QList<NmAction*> &actionList)

    Implementation of NmUiExtension interface. The plugin provides to caller supported actions for email protocol.

    \a request contains NmActionRequest with needed request data.

    \a actionList QList array will be filled by action supported protocol and controlled by NmActionRequest.

*/

/*!

    \fn void NmBaseClientPlugin::openMessage()

    When open action is triggered this slot is called to open message.

*/

/*!

    \fn void NmBaseClientPlugin::deleteMessage()

    When delete action is triggered this slot is called to delete message.

*/

/*!

    \fn void NmBaseClientPlugin::refresh()

    When refresh action is triggered this slot is called to start refreshing the mailbox.

*/

/*!

    \fn void NmBaseClientPlugin::createNewMail()

    When create new action is triggered this slot is called to notify responce observer

    with NmActionResponseCommandNewMail enum.

*/

/*!

    \fn void NmBaseClientPlugin::settings()

    When settings action is triggered this slot is called to open settings.

*/

/*!

    \fn void NmBaseClientPlugin::sendMail()

    When send mail action is triggered this slot is called to send an email.

*/

/*!

    \fn void NmBaseClientPlugin::replyMail()

    When reply mail action is triggered this slot is called to reply an email.

*/

/*!

    \fn void NmBaseClientPlugin::replyAllMail()

    When reply all mail action is triggered this slot is called to reply all an email.

*/

/*!

    \fn void NmBaseClientPlugin::forwardMail()

    When forward mail action is triggered this slot is called to forward an email.

*/

/*!

    Constructs a new NmBaseClientPlugin.

*/

NmBaseClientPlugin::NmBaseClientPlugin()

:mMenuRequest(NULL),

mEditorToolBarRequest(NULL),

mViewerToolBarRequest(NULL),

{

    NMLOG("NmBaseClientPlugin::NmBaseClientPlugin()-->");

    mUiEngine = NmUiEngine::instance();

    NMLOG("<--NmBaseClientPlugin::NmBaseClientPlugin()");

}

/*!

    Destructor.

*/

NmBaseClientPlugin::~NmBaseClientPlugin()

{

    NMLOG("NmBaseClientPlugin::~NmBaseClientPlugin()-->");

    NmUiEngine::releaseInstance(mUiEngine);

    mUiEngine = NULL;

    NMLOG("<--NmBaseClientPlugin::~NmBaseClientPlugin()");

}

/*!

    Provides list of supported NmActions.

    Implementation of NmUiExtensionInterface.

    Parameter \a request controls list of request services.

    Parameter \a actionList is updated by supported NmActions.

*/

void NmBaseClientPlugin::getActions(

      const NmActionRequest &request,

      QList<NmAction *> &actionList)

{

    NMLOG("NmBaseClientPlugin::getActions()-->");

    if (request.observer()) {

        switch (request.contextView()) {

            case NmActionContextViewMessageList:

            {

                createMessageListCommands(request, actionList);

                break;

            }

            case NmActionContextViewViewer:

            {

                createViewerViewCommands(request, actionList);

                break;

            }

            case NmActionContextViewEditor:

            {

                createEditorViewCommands(request, actionList);

                break;

            }

            default:

            {

                NMLOG(QString("NmBaseClientPlugin::getActions(): Unknown contextView()=%1").arg(request.contextView()));

                break;

            }

        }

    }

    NMLOG("<--NmBaseClientPlugin::getActions()");

}

/*!

    Public slot connected to options menu refresh NmAction.

    Refreshes mailbox using the NmUiEngine instance.

*/

void NmBaseClientPlugin::refresh()

{

    NMLOG("NmBaseClientPlugin::refresh()-->");

    int err = mUiEngine->refreshMailbox(mMenuRequest.mailboxId());

    if (NmNoError != err) {

        // Failed to refresh the mailbox!

        NMLOG(QString("NmBaseClientPlugin::refresh(): failed err=%1").arg(err));

    }

    NMLOG("<--NmBaseClientPlugin::refresh()");

}

/*!

    Public slot connected to triggered() signal of open message action instance.

    The method sends an open response command to the action observer.

*/

void NmBaseClientPlugin::openMessage()

{

    handleRequest(NmActionResponseCommandOpen, mMenuRequest);

}

/*!

    Public slot connected to delete message. Method asks UI engine to delete messages

*/

void NmBaseClientPlugin::deleteMessage()

{

    NMLOG("NmBaseClientPlugin::deleteMessage()-->");

    QList<NmId> messageList;

    messageList.append(mMenuRequest.messageId());

    int err = mUiEngine->deleteMessages(mMenuRequest.mailboxId(),

                                        mMenuRequest.folderId(),

                                        messageList);

    if (NmNoError != err) {

        // Failed to delete the messages!

        NMLOG(QString("NmBaseClientPlugin::deleteMessage(): failed err=%1").arg(err));

    }

    messageList.clear();

    NMLOG("<--NmBaseClientPlugin::deleteMessage()");

}

/*!

    Public slot connected to triggered() signal of delete action instance.

    The method sends a delete mail command to the action observer.

*/

void NmBaseClientPlugin::deleteMessageFromViewerView()

{

    handleRequest(NmActionResponseCommandDeleteMail, mViewerViewRequest);

}

/*!

    Public slot connected to triggered() signal of create mail action instance.

    The method sends a new mail command to the action observer.

*/

void NmBaseClientPlugin::createNewMailViewerToolBar()

{

    handleRequest(NmActionResponseCommandNewMail, mViewerToolBarRequest);

}

/*!

    Public slot for handling the event of menu request for creating a new email.

    The method sends a new mail command to the action observer of the menu request.

*/

void NmBaseClientPlugin::createNewMail()

{

    handleRequest(NmActionResponseCommandNewMail, mMenuRequest);

}

/*!

    Public slot connected to options menu settings NmAction.

    Opens mailbox settings.

*/

void NmBaseClientPlugin::settings()

{

}

/*!

    Public slot connected to triggered() signal of send mail action instance.

    Sends the send mail command to the action observer.

*/

void NmBaseClientPlugin::sendMail()

{

    handleRequest(NmActionResponseCommandSendMail, mEditorToolBarRequest);

}

/*!

    Public slot connected to triggered() signal of reply action instance of the

    toolbar. Sends a reply mail command to the action observer.

*/

void NmBaseClientPlugin::replyMail()

{

    handleRequest(NmActionResponseCommandReply, mViewerViewRequest);

}

/*!

    Public slot connected to triggered signal of reply all action instance of

    the toolbar. Sends a reply all mail command to the action observer.

*/

void NmBaseClientPlugin::replyAllMail()

{

    handleRequest(NmActionResponseCommandReplyAll, mViewerViewRequest);

}

/*!

    Public slot connected to triggered() signal of forward action instance of

    the toolbar. Sends a forward mail command to the action observer.

*/

void NmBaseClientPlugin::forwardMail()

{

    handleRequest(NmActionResponseCommandForward, mViewerViewRequest);

}

/*!

    Public slot connected to set high priority toolbar action.

*/

void NmBaseClientPlugin::setPriorityHigh()

{

    handleRequest(NmActionResponseCommandPriorityHigh, mMenuRequest);

}

/*!

    Public slot connected to set normal priority toolbar action.

*/

void NmBaseClientPlugin::setPriorityNormal()

{

    handleRequest(NmActionResponseCommandNone, mMenuRequest);

}

/*!

    Public slot connected to set low priority toolbar action.

*/

void NmBaseClientPlugin::setPriorityLow()

{

    handleRequest(NmActionResponseCommandPriorityLow, mMenuRequest);

}

/*!

    Public slot connected to attach toolbar action.

*/

void NmBaseClientPlugin::attach()

{

    handleRequest(NmActionResponseCommandAttach, mEditorToolBarRequest);

}

/*!

    Public slot connected to remove attachment context menu action

*/

void NmBaseClientPlugin::removeAttachment()

{

    handleRequest(NmActionResponseCommandRemoveAttachment, mMenuRequest);

}

/*!

    Public slot connected to open attachment context menu action

*/

void NmBaseClientPlugin::openAttachment()

{

    handleRequest(NmActionResponseCommandOpenAttachment, mMenuRequest);

}

/*!

    Private slot connected to settings view launcher.

    \param mailboxId Id of mailbox.

    \param type type of change.

*/

void NmBaseClientPlugin::mailboxListChanged(const NmId &mailboxId,

    NmSettings::MailboxEventType type)

{

    Q_UNUSED(mailboxId)

    Q_UNUSED(type)

    handleRequest(NmActionResponseCommandMailboxDeleted, mMenuRequest);

}

/*!

    Private slot connected to settings view launcher.

    \param mailboxId Id of mailbox.

    \param property

    \param value

*/

void NmBaseClientPlugin::mailboxPropertyChanged(const NmId &mailboxId, QVariant property,

    QVariant value)

{

    Q_UNUSED(property)

    Q_UNUSED(value)

    NmActionObserver *observer = mMenuRequest.observer();

    if (observer) {

        // Force model item to be updated, because framework adapter sends it too slowly.

        // Data changed signal is not emitted by this change, it is send when ever famework adapter

        // calls data model's handleMailboxEvent method.

        mUiEngine->mailboxListModel().refreshModelItem(mailboxId, false);

        // Notify view of changes.

        NmActionResponse response(NmActionResponseCommandUpdateMailboxName, mMenuRequest);

        observer->handleActionCommand(response);

    }

}

/*!

    Private slot connected to settings view launcher.

    \param mailboxId Id of mailbox.

*/

void NmBaseClientPlugin::goOnline(const NmId &mailboxId)

{

}

/*!

    Private slot connected to settings view launcher.

    \param mailboxId Id of mailbox.

*/

void NmBaseClientPlugin::goOffline(const NmId &mailboxId)

{

        mUiEngine->goOffline(mailboxId);

}

/*!

    Create messagelist command actions.

    Internal helper method.

    Parameter \a request is used to identify requested menu type.

    Parameter \a actionList is updated by supported NmActions for message list.

*/

void NmBaseClientPlugin::createMessageListCommands(

    const NmActionRequest &request,

    QList<NmAction *> &actionList)

{

    NMLOG("NmBaseClientPlugin::createMessageListCommands()-->");

    switch (request.menuType()) {

        case NmActionOptionsMenu:

        {

            mMenuRequest = request;

            NmAction *refreshAction = new NmAction(0);

            refreshAction->setObjectName("baseclientplugin_refresh");

            refreshAction->setText(hbTrId("txt_mail_opt_send_and_receive_now"));

            connect(refreshAction, SIGNAL(triggered()), this, SLOT(refresh()));

            actionList.append(refreshAction);

            NmAction *settingsAction = new NmAction(0);

            settingsAction->setObjectName("baseclientplugin_settings");

            settingsAction->setText(hbTrId("txt_common_opt_settings"));

            connect(settingsAction, SIGNAL(triggered()), this, SLOT(settings()));

            actionList.append(settingsAction);

            break;

        }

        case NmActionToolbar:

        {

            mViewerToolBarRequest = request;

            NmAction *createMailAction = new NmAction(0);

            createMailAction->setObjectName("baseclientplugin_createmailaction");

            createMailAction->setText(hbTrId("txt_mail_button_new_mail"));

            createMailAction->setIcon(NmIcons::getIcon(NmIcons::NmIconNewEmail));

            connect(createMailAction, SIGNAL(triggered()),

                    this, SLOT(createNewMailViewerToolBar()));

            actionList.append(createMailAction);

            break;

        }

        case NmActionContextMenu:

        {

            if (request.contextDataType() == NmActionContextDataMessage){

                mMenuRequest = request;

                // Delete message

                NmAction* deleteAction = new NmAction(0);

                deleteAction->setObjectName("baseclientplugin_deleteaction");

                deleteAction->setText(hbTrId("txt_common_menu_delete"));

                connect(deleteAction, SIGNAL(triggered()), this, SLOT(deleteMessage()));

                actionList.append(deleteAction);

                    }

                }

            }

            break;

        }

        default:

        {

            NMLOG(QString("NmBaseClientPlugin::createMessageListCommands(): Unknown menuType()=%1").arg(request.menuType()));

            break;

        }

    }

    NMLOG("<--NmBaseClientPlugin::createMessageListCommands()");

}

/*!