urlhandlermanager.cpp

Go to the documentation of this file.

/*  -*- c++ -*-
    urlhandlermanager.cpp

    This file is part of KMail, the KDE mail client.
    Copyright (c) 2003      Marc Mutz <mutz@kde.org>
    Copyright (C) 2002-2003, 2009 Klarälvdalens Datakonsult AB, a KDAB Group company, info@kdab.net
    Copyright (c) 2009 Andras Mantia <andras@kdab.net>

    KMail is free software; you can redistribute it and/or modify it
    under the terms of the GNU General Public License, version 2, as
    published by the Free Software Foundation.

    KMail 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., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA

    In addition, as a special exception, the copyright holders give
    permission to link the code of this program with any edition of
    the Qt library by Trolltech AS, Norway (or with modified versions
    of Qt that use the same license as Qt), and distribute linked
    combinations including the two.  You must obey the GNU General
    Public License in all respects for all of the code used other than
    Qt.  If you modify this file, you may extend this exception to
    your version of the file, but you are not obligated to do so.  If
    you do not wish to do so, delete this exception statement from
    your version.
*/




#include "urlhandlermanager.h"

#include "interfaces/urlhandler.h"
#include "interfaces/bodyparturlhandler.h"
#include "partnodebodypart.h"
#include "viewer/viewer_p.h"
#include "viewer/mailwebview.h"
#include "viewer/nodehelper.h"
#include "utils/util.h"
#include "stl_util.h"

#include <messagecore/utils/stringutil.h>
#include <libkdepim/misc/broadcaststatus.h>
#include <libkdepim/job/openemailaddressjob.h>

#include <akonadi/contact/contactsearchjob.h>

#include <kmime/kmime_content.h>
#include <KPIMUtils/Email>
#include <KPIMUtils/KFileIO>

#include <KMenu>
#include <KMimeType>
#include <KRun>
#include <KStandardDirs>
#include <KUrl>

#include <QApplication>
#include <QClipboard>
#include <QProcess>
#include <QFile>
#include <QMimeData>
#include <QDrag>

#include <algorithm>

using std::for_each;
using std::remove;
using std::find;
using namespace MessageViewer;
using namespace MessageCore;

URLHandlerManager * URLHandlerManager::self = 0;

namespace {
  class KMailProtocolURLHandler : public URLHandler {
  public:
    KMailProtocolURLHandler() : URLHandler() {}
    ~KMailProtocolURLHandler() {}

    bool handleClick( const KUrl &, ViewerPrivate * ) const;
    bool handleContextMenuRequest( const KUrl & url, const QPoint &, ViewerPrivate * ) const {
      return url.protocol() == QLatin1String( "kmail" );
    }
    QString statusBarMessage( const KUrl &, ViewerPrivate * ) const;
  };

  class ExpandCollapseQuoteURLManager : public URLHandler {
  public:
    ExpandCollapseQuoteURLManager() : URLHandler() {}
    ~ExpandCollapseQuoteURLManager() {}

    bool handleClick( const KUrl &, ViewerPrivate * ) const;
    bool handleContextMenuRequest( const KUrl &, const QPoint &, ViewerPrivate * ) const {
      return false;
    }
    QString statusBarMessage( const KUrl &, ViewerPrivate * ) const;

  };

  class SMimeURLHandler : public URLHandler {
  public:
    SMimeURLHandler() : URLHandler() {}
    ~SMimeURLHandler() {}

    bool handleClick( const KUrl &, ViewerPrivate * ) const;
    bool handleContextMenuRequest( const KUrl &, const QPoint &, ViewerPrivate * ) const {
      return false;
    }
    QString statusBarMessage( const KUrl &, ViewerPrivate * ) const;
  };

  class MailToURLHandler : public URLHandler {
  public:
    MailToURLHandler() : URLHandler() {}
    ~MailToURLHandler() {}

    bool handleClick( const KUrl &, ViewerPrivate * ) const { return false; }
    bool handleContextMenuRequest( const KUrl &, const QPoint &, ViewerPrivate * ) const {
      return false;
    }
    QString statusBarMessage( const KUrl &, ViewerPrivate * ) const;
  };

  class ContactUidURLHandler : public URLHandler {
  public:
    ContactUidURLHandler() : URLHandler() {}
    ~ContactUidURLHandler() {}

    bool handleClick( const KUrl &, ViewerPrivate * ) const;
    bool handleContextMenuRequest( const KUrl &url, const QPoint &p, ViewerPrivate * ) const;
    QString statusBarMessage( const KUrl &, ViewerPrivate * ) const;
  };

  class HtmlAnchorHandler : public URLHandler {
  public:
    HtmlAnchorHandler() : URLHandler() {}
    ~HtmlAnchorHandler() {}

    bool handleClick( const KUrl &, ViewerPrivate * ) const;
    bool handleContextMenuRequest( const KUrl &, const QPoint &, ViewerPrivate * ) const {
      return false;
    }
    QString statusBarMessage( const KUrl &, ViewerPrivate * ) const { return QString(); }
  };

  class AttachmentURLHandler : public URLHandler {
  public:
    AttachmentURLHandler() : URLHandler() {}
    ~AttachmentURLHandler() {}

    bool handleClick( const KUrl &, ViewerPrivate * ) const;
    bool handleShiftClick( const KUrl &, ViewerPrivate *window ) const;
    bool handleContextMenuRequest( const KUrl &, const QPoint &, ViewerPrivate * ) const;
    bool handleDrag( const KUrl &url, ViewerPrivate *window ) const;
    bool willHandleDrag( const KUrl &url, ViewerPrivate *window ) const;
    QString statusBarMessage( const KUrl &, ViewerPrivate * ) const;
  private:
    KMime::Content* nodeForUrl( const KUrl &url, ViewerPrivate *w ) const;
    bool attachmentIsInHeader( const KUrl &url ) const;
  };

  class ShowAuditLogURLHandler : public URLHandler {
  public:
      ShowAuditLogURLHandler() : URLHandler() {}
      ~ShowAuditLogURLHandler() {}

      bool handleClick( const KUrl &, ViewerPrivate * ) const;
      bool handleContextMenuRequest( const KUrl &, const QPoint &, ViewerPrivate * ) const;
      QString statusBarMessage( const KUrl &, ViewerPrivate * ) const;
  };

  // Handler that prevents dragging of internal images added by KMail, such as the envelope image
  // in the enterprise header
  class InternalImageURLHandler : public URLHandler {
  public:
      InternalImageURLHandler() : URLHandler()
        {}
      ~InternalImageURLHandler()
        {}
      bool handleDrag( const KUrl &url, ViewerPrivate *window ) const;
      bool willHandleDrag( const KUrl &url, ViewerPrivate *window ) const;
      bool handleClick( const KUrl &, ViewerPrivate * ) const
        { return false; }
      bool handleContextMenuRequest( const KUrl &, const QPoint &, ViewerPrivate * ) const
        { return false; }
      QString statusBarMessage( const KUrl &, ViewerPrivate * ) const
        { return QString(); }
  };

  class KRunURLHandler : public URLHandler {
  public:
      KRunURLHandler() : URLHandler()
        {}
      ~KRunURLHandler()
        {}

      bool handleClick( const KUrl &, ViewerPrivate * ) const;
      bool handleContextMenuRequest( const KUrl &, const QPoint &, ViewerPrivate * ) const {
        return false;
      }
      QString statusBarMessage( const KUrl &, ViewerPrivate * ) const { return QString(); }
  };

} // anon namespace


//
//
// BodyPartURLHandlerManager
//
//

class URLHandlerManager::BodyPartURLHandlerManager : public URLHandler {
public:
  BodyPartURLHandlerManager() : URLHandler() {}
  ~BodyPartURLHandlerManager();

  bool handleClick( const KUrl &, ViewerPrivate * ) const;
  bool handleContextMenuRequest( const KUrl &, const QPoint &, ViewerPrivate * ) const;
  QString statusBarMessage( const KUrl &, ViewerPrivate * ) const;

  void registerHandler( const Interface::BodyPartURLHandler * handler );
  void unregisterHandler( const Interface::BodyPartURLHandler * handler );

private:
  typedef QVector<const Interface::BodyPartURLHandler*> BodyPartHandlerList;
  BodyPartHandlerList mHandlers;
};

URLHandlerManager::BodyPartURLHandlerManager::~BodyPartURLHandlerManager() {
  for_each( mHandlers.begin(), mHandlers.end(),
            DeleteAndSetToZero<Interface::BodyPartURLHandler>() );
}

void URLHandlerManager::BodyPartURLHandlerManager::registerHandler( const Interface::BodyPartURLHandler * handler ) {
  if ( !handler )
    return;
  unregisterHandler( handler ); // don't produce duplicates
  mHandlers.push_back( handler );
}

void URLHandlerManager::BodyPartURLHandlerManager::unregisterHandler( const Interface::BodyPartURLHandler * handler ) {
  // don't delete them, only remove them from the list!
  mHandlers.erase( remove( mHandlers.begin(), mHandlers.end(), handler ), mHandlers.end() );
}

static KMime::Content * partNodeFromXKMailUrl( const KUrl & url, ViewerPrivate * w, QString * path ) {
  assert( path );

  if ( !w || url.protocol() != QLatin1String( "x-kmail" ) )
    return 0;
  const QString urlPath = url.path();

  // urlPath format is: /bodypart/<random number>/<part id>/<path>

  kDebug() << "BodyPartURLHandler: urlPath ==" << urlPath;
  if ( !urlPath.startsWith( QLatin1String("/bodypart/") ) )
    return 0;

  const QStringList urlParts = urlPath.mid( 10 ).split( QLatin1Char('/') );
  if ( urlParts.size() != 3 )
    return 0;
  //KMime::ContentIndex index( urlParts[1] );
  *path = KUrl::fromPercentEncoding( urlParts[2].toLatin1() );
  return w->nodeFromUrl( urlParts[1] );
}

bool URLHandlerManager::BodyPartURLHandlerManager::handleClick( const KUrl & url, ViewerPrivate * w ) const {
  QString path;
  KMime::Content * node = partNodeFromXKMailUrl( url, w, &path );
  if ( !node )
    return false;

  PartNodeBodyPart part( w->message().get(), node, w->nodeHelper(), w->overrideCodec() );
  BodyPartHandlerList::const_iterator end( mHandlers.constEnd() );
  
  for ( BodyPartHandlerList::const_iterator it = mHandlers.constBegin() ; it != end ; ++it ) {
    if ( (*it)->handleClick( w->viewer(), &part, path ) )
      return true;
  }

  return false;
}

bool URLHandlerManager::BodyPartURLHandlerManager::handleContextMenuRequest( const KUrl & url, const QPoint & p, ViewerPrivate * w ) const {
  QString path;
  KMime::Content * node = partNodeFromXKMailUrl( url, w, &path );
  if ( !node )
    return false;

  PartNodeBodyPart part( w->message().get(), node, w->nodeHelper(), w->overrideCodec() );
  BodyPartHandlerList::const_iterator end( mHandlers.constEnd() );
  for ( BodyPartHandlerList::const_iterator it = mHandlers.constBegin() ; it != end ; ++it )
    if ( (*it)->handleContextMenuRequest( &part, path, p ) )
      return true;
  return false;
}

QString URLHandlerManager::BodyPartURLHandlerManager::statusBarMessage( const KUrl & url, ViewerPrivate * w ) const {
  QString path;
  KMime::Content * node = partNodeFromXKMailUrl( url, w, &path );
  if ( !node )
    return QString();

  PartNodeBodyPart part( w->message().get(), node, w->nodeHelper(), w->overrideCodec() );
  BodyPartHandlerList::const_iterator end( mHandlers.constEnd() );
  for ( BodyPartHandlerList::const_iterator it = mHandlers.constBegin() ; it != end ; ++it ) {
    const QString msg = (*it)->statusBarMessage( &part, path );
    if ( !msg.isEmpty() )
      return msg;
  }
  return QString();
}

//
//
// URLHandlerManager
//
//

URLHandlerManager::URLHandlerManager() {
  registerHandler( new KMailProtocolURLHandler() );
  registerHandler( new ExpandCollapseQuoteURLManager() );
  registerHandler( new SMimeURLHandler() );
  registerHandler( new MailToURLHandler() );
  registerHandler( new ContactUidURLHandler() );
  registerHandler( new HtmlAnchorHandler() );
  registerHandler( new AttachmentURLHandler() );
  registerHandler( mBodyPartURLHandlerManager = new BodyPartURLHandlerManager() );
  registerHandler( new ShowAuditLogURLHandler() );
  registerHandler( new InternalImageURLHandler );
  registerHandler( new KRunURLHandler() );
}

URLHandlerManager::~URLHandlerManager() {
  for_each( mHandlers.begin(), mHandlers.end(),
            DeleteAndSetToZero<URLHandler>() );
}

void URLHandlerManager::registerHandler( const URLHandler * handler ) {
  if ( !handler )
    return;
  unregisterHandler( handler ); // don't produce duplicates
  mHandlers.push_back( handler );
}

void URLHandlerManager::unregisterHandler( const URLHandler * handler ) {
  // don't delete them, only remove them from the list!
  mHandlers.erase( remove( mHandlers.begin(), mHandlers.end(), handler ), mHandlers.end() );
}

void URLHandlerManager::registerHandler( const Interface::BodyPartURLHandler * handler ) {
  if ( mBodyPartURLHandlerManager )
    mBodyPartURLHandlerManager->registerHandler( handler );
}

void URLHandlerManager::unregisterHandler( const Interface::BodyPartURLHandler * handler ) {
  if ( mBodyPartURLHandlerManager )
    mBodyPartURLHandlerManager->unregisterHandler( handler );
}

bool URLHandlerManager::handleClick( const KUrl & url, ViewerPrivate * w ) const {
  HandlerList::const_iterator end( mHandlers.constEnd() );
  for ( HandlerList::const_iterator it = mHandlers.constBegin() ; it != end ; ++it )
    if ( (*it)->handleClick( url, w ) )
      return true;
  return false;
}

bool URLHandlerManager::handleShiftClick( const KUrl &url, ViewerPrivate *window ) const
{
  HandlerList::const_iterator end( mHandlers.constEnd() );
  for ( HandlerList::const_iterator it = mHandlers.constBegin() ; it != end ; ++it )
    if ( (*it)->handleShiftClick( url, window ) )
      return true;
  return false;
}

bool URLHandlerManager::willHandleDrag( const KUrl &url, ViewerPrivate *window ) const
{
  HandlerList::const_iterator end(  mHandlers.constEnd() );
  
  for ( HandlerList::const_iterator it = mHandlers.constBegin() ; it != end ; ++it )
    if ( (*it)->willHandleDrag( url, window ) )
      return true;
  return false;
}

bool URLHandlerManager::handleDrag( const KUrl &url, ViewerPrivate *window ) const
{
  HandlerList::const_iterator end( mHandlers.constEnd() );
  for ( HandlerList::const_iterator it = mHandlers.constBegin() ; it != end ; ++it )
    if ( (*it)->handleDrag( url, window ) )
      return true;
  return false;
}

bool URLHandlerManager::handleContextMenuRequest( const KUrl & url, const QPoint & p, ViewerPrivate * w ) const {

  HandlerList::const_iterator end( mHandlers.constEnd() );
  for ( HandlerList::const_iterator it = mHandlers.constBegin() ; it != end ; ++it )
    if ( (*it)->handleContextMenuRequest( url, p, w ) )
      return true;
  return false;
}

QString URLHandlerManager::statusBarMessage( const KUrl & url, ViewerPrivate * w ) const {
  HandlerList::const_iterator end( mHandlers.constEnd() );
  for ( HandlerList::const_iterator it = mHandlers.constBegin() ; it != end ; ++it ) {
    const QString msg = (*it)->statusBarMessage( url, w );
    if ( !msg.isEmpty() )
      return msg;
  }
  return QString();
}


//
//
// URLHandler
//
//

#include <ui/messagebox.h>

#include <klocale.h>
#include <kmessagebox.h>

namespace {
  bool KMailProtocolURLHandler::handleClick( const KUrl & url, ViewerPrivate * w ) const {
    if ( url.protocol() == QLatin1String( "kmail" ) ) {
      if ( !w )
        return false;
      const QString urlPath( url.path() );
      if ( urlPath == QLatin1String( "showHTML" ) ) {
        w->setHtmlOverride( !w->htmlOverride() );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "goOnline" ) ) {
        w->goOnline();
        return true;
      }
      else if ( urlPath == QLatin1String( "goResourceOnline" ) ) {
        w->goResourceOnline();
        return true;
      }
      else if ( urlPath == QLatin1String( "loadExternal" ) ) {
        w->setHtmlLoadExtOverride( !w->htmlLoadExtOverride() );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "decryptMessage" ) ) {
        w->setDecryptMessageOverwrite( true );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "showSignatureDetails" ) ) {
        w->setShowSignatureDetails( true );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "hideSignatureDetails" ) ) {
        w->setShowSignatureDetails( false );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "showAttachmentQuicklist" ) ) {
        w->setShowAttachmentQuicklist( true );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "hideAttachmentQuicklist" ) ) {
        w->setShowAttachmentQuicklist( false );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "showFullToAddressList" ) ) {
        w->setShowFullToAddressList( true );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "hideFullToAddressList" ) ) {
        w->setShowFullToAddressList( false );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "showFullCcAddressList" ) ) {
        w->setShowFullCcAddressList( true );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "hideFullCcAddressList" ) ) {
        w->setShowFullCcAddressList( false );
        w->update( Viewer::Force );
        return true;
      }
      else if ( urlPath == QLatin1String( "showRawToltecMail" ) ) {
        w->setShowRawToltecMail( true );
        w->update( Viewer::Force );
        return true;
      }
    }
    return false;
  }

  QString KMailProtocolURLHandler::statusBarMessage( const KUrl & url, ViewerPrivate * ) const {
    if ( url.protocol() == QLatin1String( "kmail" ) )
    {
      const QString urlPath( url.path() );
      if ( urlPath == QLatin1String( "showHTML" ) )
        return i18n("Turn on HTML rendering for this message.");
      else if ( urlPath == QLatin1String( "loadExternal" ) )
        return i18n("Load external references from the Internet for this message.");
      else if ( urlPath == QLatin1String( "goOnline" ) )
        return i18n("Work online.");
      else if ( urlPath == QLatin1String( "goResourceOnline" ) )
        return i18n("Make account online.");
      else if ( urlPath == QLatin1String( "decryptMessage" ) )
        return i18n("Decrypt message.");
      else if ( urlPath == QLatin1String( "showSignatureDetails" ) )
        return i18n("Show signature details.");
      else if ( urlPath == QLatin1String( "hideSignatureDetails" ) )
        return i18n("Hide signature details.");
      else if ( urlPath == QLatin1String( "showAttachmentQuicklist" ) )
        return i18n( "Show attachment list." );
      else if ( urlPath == QLatin1String( "hideAttachmentQuicklist" ) )
        return i18n( "Hide attachment list." );
      else if ( urlPath == QLatin1String( "showFullToAddressList" ) )
        return i18n( "Show full \"To\" list" );
      else if ( urlPath == QLatin1String( "hideFullToAddressList" ) )
        return i18n( "Hide full \"To\" list" );
      else if ( urlPath == QLatin1String( "showFullCcAddressList" ) )
        return i18n( "Show full \"Cc\" list" );
      else if ( urlPath == QLatin1String( "hideFullCcAddressList" ) )
        return i18n( "Hide full \"Cc\" list" );
      else if ( urlPath == QLatin1String( "showRawToltecMail" ) )
        return i18n( "Show Raw Message" );
      else return QString();
    }
    return QString() ;
  }
}

namespace {

  bool ExpandCollapseQuoteURLManager::handleClick(
      const KUrl & url, ViewerPrivate * w ) const
  {
    //  kmail:levelquote/?num      -> the level quote to collapse.
    //  kmail:levelquote/?-num      -> expand all levels quote.
    if ( url.protocol() == QLatin1String( "kmail" ) && url.path()==QLatin1String( "levelquote" ) )
    {
      const QString levelStr= url.query().mid( 1,url.query().length() );
      bool isNumber = false;
      const int levelQuote= levelStr.toInt(&isNumber);
      if ( isNumber )
        w->slotLevelQuote( levelQuote );
      return true;
    }
    return false;
  }
  QString ExpandCollapseQuoteURLManager::statusBarMessage(
      const KUrl & url, ViewerPrivate * ) const
  {
      if ( url.protocol() == QLatin1String( "kmail" ) && url.path() == QLatin1String( "levelquote" ) )
      {
        const QString query= url.query();
        if ( query.length()>=2 ) {
          if ( query[ 1 ] ==QLatin1Char( '-' )  ) {
            return i18n("Expand all quoted text.");
          }
          else {
            return i18n("Collapse quoted text.");
          }
        }
      }
      return QString() ;
  }

}

bool foundSMIMEData( const QString &aUrl,
                     QString& displayName,
                     QString& libName,
                     QString& keyId )
{
  static QString showCertMan(QLatin1String("showCertificate#"));
  displayName.clear();
  libName.clear();
  keyId.clear();
  int i1 = aUrl.indexOf( showCertMan );
  if( -1 < i1 ) {
    i1 += showCertMan.length();
    int i2 = aUrl.indexOf(QLatin1String(" ### "), i1);
    if( i1 < i2 )
    {
      displayName = aUrl.mid( i1, i2-i1 );
      i1 = i2+5;
      i2 = aUrl.indexOf(QLatin1String(" ### "), i1);
      if( i1 < i2 )
      {
        libName = aUrl.mid( i1, i2-i1 );
        i2 += 5;

        keyId = aUrl.mid( i2 );
        /*
        int len = aUrl.length();
        if( len > i2+1 ) {
          keyId = aUrl.mid( i2, 2 );
          i2 += 2;
          while( len > i2+1 ) {
            keyId += ':';
            keyId += aUrl.mid( i2, 2 );
            i2 += 2;
          }
        }
        */
      }
    }
  }
  return !keyId.isEmpty();
}


namespace {
  bool SMimeURLHandler::handleClick( const KUrl & url, ViewerPrivate * w ) const {
    if ( !url.hasRef() )
      return false;
    QString displayName, libName, keyId;
    if ( !foundSMIMEData( url.path() + QLatin1Char('#') +
                          QUrl::fromPercentEncoding( url.ref().toLatin1() ),
                          displayName, libName, keyId ) )
      return false;
    QStringList lst;
    lst << QLatin1String("-parent-windowid") << QString::number((qlonglong)w->viewer()->mainWindow()->winId() ) << QLatin1String("-query") << keyId;
    if ( !QProcess::startDetached( QLatin1String("kleopatra"),lst) )
      KMessageBox::error( w->mMainWindow, i18n("Could not start certificate manager. "
                                  "Please check your installation."),
                             i18n("KMail Error") );
    return true;
  }

  QString SMimeURLHandler::statusBarMessage( const KUrl & url, ViewerPrivate * ) const {
    QString displayName, libName, keyId;
    if ( !foundSMIMEData( url.path() + QLatin1Char('#') +
                          QUrl::fromPercentEncoding( url.ref().toLatin1() ),
                          displayName, libName, keyId ) )
      return QString();
    return i18n("Show certificate 0x%1", keyId );
  }
}

namespace {
  bool HtmlAnchorHandler::handleClick( const KUrl & url, ViewerPrivate * w ) const {
    if ( url.hasHost() || !url.hasRef() )
      return false;

    w->htmlPart()->scrollToAnchor( url.ref() );
    return true;
  }
}

namespace {
  QString MailToURLHandler::statusBarMessage( const KUrl & url, ViewerPrivate * ) const {
    if ( url.protocol() == QLatin1String( "mailto" ) )
      return KPIMUtils::decodeMailtoUrl( url );
    return QString();
  }
}

namespace {
  static QString searchFullEmailByUid( const QString &uid )
  {
    QString fullEmail;
    Akonadi::ContactSearchJob *job = new Akonadi::ContactSearchJob();
    job->setLimit( 1 );
    job->setQuery( Akonadi::ContactSearchJob::ContactUid, uid, Akonadi::ContactSearchJob::ExactMatch );
    job->exec();
    const KABC::Addressee::List res = job->contacts();
    if ( !res.isEmpty() ) {
      KABC::Addressee addr = res.first();
      fullEmail = addr.fullEmail();
    }
    return fullEmail;
  }

  static void runKAddressBook( const KUrl &url )
  {
    KPIM::OpenEmailAddressJob *job = new KPIM::OpenEmailAddressJob( url.path(), 0 );
    job->start();
  }

  bool ContactUidURLHandler::handleClick( const KUrl &url, ViewerPrivate * ) const
  {
    if ( url.protocol() == QLatin1String( "uid" ) ) {
      runKAddressBook( url );
      return true;
    } else {
      return false;
    }
  }

  bool ContactUidURLHandler::handleContextMenuRequest( const KUrl &url, const QPoint &p,
                                                       ViewerPrivate * ) const
  {
    if ( url.protocol() != QLatin1String( "uid" ) || url.path().isEmpty() ) {
      return false;
    }

    KMenu *menu = new KMenu();
    QAction *open =
      menu->addAction( KIcon( QLatin1String("view-pim-contacts") ), i18n( "&Open in Address Book" ) );
#ifndef QT_NO_CLIPBOARD
    QAction *copy =
      menu->addAction( KIcon( QLatin1String("edit-copy") ), i18n( "&Copy Email Address" ) );
#endif

    QAction *a = menu->exec( p );
    if ( a == open ) {
      runKAddressBook( url );
#ifndef QT_NO_CLIPBOARD
    } else if ( a == copy ) {
      const QString fullEmail = searchFullEmailByUid( url.path() );
      if ( !fullEmail.isEmpty() ) {
        QClipboard *clip = QApplication::clipboard();
        clip->setText( fullEmail, QClipboard::Clipboard );
        clip->setText( fullEmail, QClipboard::Selection );
        KPIM::BroadcastStatus::instance()->setStatusMsg( i18n( "Address copied to clipboard." ) );
      }
#endif
    }
    delete menu;
    
    return true;
  }

  QString ContactUidURLHandler::statusBarMessage( const KUrl &url, ViewerPrivate * ) const
  {
    if ( url.protocol() == QLatin1String( "uid" ) ) {
      return i18n( "Lookup the contact in KAddressbook" );
    } else {
      return QString();
    }
  }
}

namespace {
 KMime::Content* AttachmentURLHandler::nodeForUrl( const KUrl &url, ViewerPrivate *w ) const
 {
   if ( !w || !w->mMessage )
     return 0;
   if ( url.protocol() == QLatin1String( "attachment" ) )
   {
     KMime::Content * node = w->nodeFromUrl( url );
     return node;
   }
   return 0;
 }

 bool AttachmentURLHandler::attachmentIsInHeader( const KUrl &url ) const
 {
   bool inHeader = false;
   const QString place = url.queryItem( QLatin1String("place") ).toLower();
   if ( !place.isNull() ) {
     inHeader = ( place == QLatin1String( "header" ) );
   }
   return inHeader;
 }

  bool AttachmentURLHandler::handleClick( const KUrl & url, ViewerPrivate * w ) const
  {
    KMime::Content *node = nodeForUrl( url, w );
    if ( !node )
      return false;

    const bool inHeader = attachmentIsInHeader( url );
    const bool shouldShowDialog = !w->nodeHelper()->isNodeDisplayedEmbedded( node ) || !inHeader;
    if ( inHeader )
      w->scrollToAttachment( node );
    if ( shouldShowDialog )
       // PENDING(romain_kdab) : replace with toLocalFile() ?
       w->openAttachment( node, w->nodeHelper()->tempFileUrlFromNode( node ).path() );

    return true;
  }

  bool AttachmentURLHandler::handleShiftClick( const KUrl &url, ViewerPrivate *window ) const
  {
    KMime::Content *node = nodeForUrl( url, window );
    if ( !node )
      return false;
    if ( !window )
      return false;
    Util::saveContents( window->viewer(), QList<KMime::Content*>() << node );
    return true;
  }

  bool AttachmentURLHandler::willHandleDrag( const KUrl &url, ViewerPrivate *window ) const
  {
    return nodeForUrl( url, window ) != 0;
  }

  bool AttachmentURLHandler::handleDrag( const KUrl &url, ViewerPrivate *window ) const
  {
#ifndef QT_NO_DRAGANDDROP
    KMime::Content *node = nodeForUrl( url, window );
    if ( !node )
      return false;

    const KUrl tUrl = window->nodeHelper()->tempFileUrlFromNode( node );
    const QString fileName = tUrl.path();
    if ( !fileName.isEmpty() ) {
      QFile f(fileName);
      f.setPermissions(QFile::ReadOwner|QFile::WriteOwner|QFile::ReadUser|QFile::ReadGroup|QFile::ReadOther);
      const QString icon = window->nodeHelper()->iconName( node, KIconLoader::Small );
      QDrag *drag = new QDrag( window->viewer() );
      QMimeData *mimeData = new QMimeData();
      mimeData->setUrls( QList<QUrl>() << tUrl );
      drag->setMimeData( mimeData );
      if ( !icon.isEmpty() ) {
        drag->setPixmap( QPixmap( icon ) );
      }
      drag->start();
      return true;
    }
    else
#endif
      return false;
  }

  bool AttachmentURLHandler::handleContextMenuRequest( const KUrl & url, const QPoint & p, ViewerPrivate * w ) const
  {
    KMime::Content *node = nodeForUrl( url, w );
    if ( !node )
      return false;
    // PENDING(romain_kdab) : replace with toLocalFile() ?
    w->showAttachmentPopup( node, w->nodeHelper()->tempFileUrlFromNode( node ).path(), p );
    return true;
  }

  QString AttachmentURLHandler::statusBarMessage( const KUrl & url, ViewerPrivate * w ) const
  {
    KMime::Content *node = nodeForUrl( url, w );
    if ( !node )
      return QString();
    const QString name = MessageViewer::NodeHelper::fileName( node );
    if ( !name.isEmpty() )
      return i18n( "Attachment: %1", name );
    else if ( dynamic_cast<KMime::Message*>( node ) ) {
      if ( node->header<KMime::Headers::Subject>() ) {
        return i18n( "Encapsulated Message (Subject: %1)",
                     node->header<KMime::Headers::Subject>()->asUnicodeString() );
      } else {
        return i18n( "Encapsulated Message" );
      }
    }
    return i18n( "Unnamed attachment" );
  }
}

namespace {
  static QString extractAuditLog( const KUrl & url ) {
    if ( url.protocol() != QLatin1String( "kmail" )
         || url.path() != QLatin1String( "showAuditLog" ) )
      return QString();
    assert( !url.queryItem( QLatin1String("log") ).isEmpty() );
    return url.queryItem( QLatin1String("log") );
  }

  bool ShowAuditLogURLHandler::handleClick( const KUrl & url, ViewerPrivate * w ) const {
    const QString auditLog = extractAuditLog( url );
    if ( auditLog.isEmpty() )
        return false;
    Kleo::MessageBox::auditLog( w->mMainWindow, auditLog );
    return true;
  }

  bool ShowAuditLogURLHandler::handleContextMenuRequest( const KUrl & url, const QPoint &, ViewerPrivate * w ) const {
    Q_UNUSED( w );
    // disable RMB for my own links:
    return !extractAuditLog( url ).isEmpty();
  }

  QString ShowAuditLogURLHandler::statusBarMessage( const KUrl & url, ViewerPrivate * ) const {
    if ( extractAuditLog( url ).isEmpty() )
      return QString();
    else
      return i18n("Show GnuPG Audit Log for this operation");
  }
}

namespace {
  bool InternalImageURLHandler::handleDrag( const KUrl &url, ViewerPrivate *window ) const
  {
    Q_UNUSED( window );
    Q_UNUSED( url );

    // This will only be called when willHandleDrag() was true. Return false here, that will
    // notify ViewerPrivate::eventFilter() that no drag was started.
    return false;
  }

  bool InternalImageURLHandler::willHandleDrag( const KUrl &url, ViewerPrivate *window ) const
  {
    Q_UNUSED( window );
    if ( url.protocol() == QLatin1String( "data" ) && url.path().startsWith( QLatin1String("image") ) )
      return true;

    const QString imagePath = KStandardDirs::locate( "data", QLatin1String("libmessageviewer/pics/") );
    return url.path().contains( imagePath );
  }
}

namespace {
  bool KRunURLHandler::handleClick( const KUrl & url, ViewerPrivate * w ) const
  {
    const QString protocol(url.protocol() );
    if ( ( protocol == QLatin1String( "http" ) ) || ( protocol == QLatin1String( "https" ) ) ||
         ( protocol == QLatin1String( "ftp" ) )  || ( protocol == QLatin1String( "file" ) )  ||
         ( protocol == QLatin1String( "ftps" ) ) || ( protocol == QLatin1String( "sftp" ) ) ||
         ( protocol == QLatin1String( "help" ) ) || ( protocol == QLatin1String( "vnc" ) )   ||
         ( protocol == QLatin1String( "smb" ) )  || ( protocol == QLatin1String( "fish" ) )  ||
         ( protocol == QLatin1String( "news" ) ) )
    {
      KPIM::BroadcastStatus::instance()->setTransientStatusMsg( i18n("Opening URL..."));
      QTimer::singleShot( 2000, KPIM::BroadcastStatus::instance(), SLOT(reset()) );

      KMimeType::Ptr mime = KMimeType::findByUrl( url );
      if (mime->name() == QLatin1String("application/x-desktop") ||
          mime->name() == QLatin1String("application/x-executable") ||
          mime->name() == QLatin1String("application/x-ms-dos-executable") ||
          mime->name() == QLatin1String("application/x-shellscript") )
      {
        if ( KMessageBox::warningYesNo( 0, i18nc( "@info", "Do you really want to execute <filename>%1</filename>?",
            url.pathOrUrl() ), QString(), KGuiItem(i18n("Execute")), KStandardGuiItem::cancel() ) != KMessageBox::Yes)
          return true;
      }
      if ( !MessageViewer::Util::handleUrlWithQDesktopServices( url.pathOrUrl() ) ) {
        KRun *runner = new KRun( url, w->viewer() ); // will delete itself
        runner->setRunExecutables( false );
      }

      return true;
    }
    else return false;
  }
}