• Skip to content
  • Skip to link menu
KDE API Reference
  • KDE API Reference
  • kdepim API Reference
  • KDE Home
  • Contact Us
 

kontact

  • sources
  • kde-4.14
  • kdepim
  • kontact
  • plugins
  • kmail
kmail_plugin.cpp
Go to the documentation of this file.
1 /*
2  This file is part of Kontact.
3 
4  Copyright (c) 2003-2013 Kontact Developer <kde-pim@kde.org>
5 
6  This program is free software; you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation; either version 2 of the License, or
9  (at your option) any later version.
10 
11  This program is distributed in the hope that it will be useful,
12  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  GNU General Public License for more details.
15 
16  You should have received a copy of the GNU General Public License along
17  with this program; if not, write to the Free Software Foundation, Inc.,
18  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19 
20  As a special exception, permission is given to link this program
21  with any edition of Qt, and distribute the resulting executable,
22  without including the source code for Qt in the source distribution.
23 */
24 
25 #include "kmail_plugin.h"
26 #include "kmailinterface.h"
27 #include "summarywidget.h"
28 
29 #include <KABC/VCardDrag>
30 #include <KCalCore/MemoryCalendar>
31 #include <KCalCore/FileStorage>
32 #include <KCalUtils/ICalDrag>
33 #include <KCalUtils/VCalDrag>
34 
35 #include <KontactInterface/Core>
36 
37 #include <KAction>
38 #include <KActionCollection>
39 #include <KDebug>
40 #include <KIcon>
41 #include <KLocalizedString>
42 #include <KStandardDirs>
43 #include <KTemporaryFile>
44 
45 #include <QDropEvent>
46 
47 using namespace KCalUtils;
48 using namespace KCalCore;
49 
50 EXPORT_KONTACT_PLUGIN( KMailPlugin, kmail )
51 
52 KMailPlugin::KMailPlugin( KontactInterface::Core *core, const QVariantList & )
53  : KontactInterface::Plugin( core, core, "kmail2" ), m_instance( 0 )
54 {
55  setComponentData( KontactPluginFactory::componentData() );
56 
57  KAction *action =
58  new KAction( KIcon( QLatin1String("mail-message-new") ),
59  i18nc( "@action:inmenu", "New Message..." ), this );
60  actionCollection()->addAction( QLatin1String("new_mail"), action );
61  action->setShortcut( QKeySequence( Qt::CTRL + Qt::SHIFT + Qt::Key_M ) );
62  action->setHelpText(
63  i18nc( "@info:status", "Create a new mail message" ) );
64  action->setWhatsThis(
65  i18nc( "@info:whatsthis",
66  "You will be presented with a dialog where you can create "
67  "and send a new email message." ) );
68  connect( action, SIGNAL(triggered(bool)), SLOT(slotNewMail()) );
69  insertNewAction( action );
70 
71  KAction *syncAction =
72  new KAction( KIcon( QLatin1String("view-refresh") ),
73  i18nc( "@action:inmenu", "Sync Mail" ), this );
74  syncAction->setHelpText(
75  i18nc( "@info:status", "Synchronize groupware mail" ) );
76  syncAction->setWhatsThis(
77  i18nc( "@info:whatsthis",
78  "Choose this option to synchronize your groupware email." ) );
79  connect( syncAction, SIGNAL(triggered(bool)), SLOT(slotSyncFolders()) );
80  actionCollection()->addAction( QLatin1String("sync_mail"), syncAction );
81  insertSyncAction( syncAction );
82 
83  mUniqueAppWatcher = new KontactInterface::UniqueAppWatcher(
84  new KontactInterface::UniqueAppHandlerFactory<KMailUniqueAppHandler>(), this );
85 }
86 
87 bool KMailPlugin::canDecodeMimeData( const QMimeData *mimeData ) const
88 {
89  return
90  ICalDrag::canDecode( mimeData ) ||
91  VCalDrag::canDecode( mimeData ) ||
92  KABC::VCardDrag::canDecode( mimeData );
93 }
94 
95 void KMailPlugin::shortcutChanged()
96 {
97  KParts::ReadOnlyPart *localPart = part();
98  if ( localPart ) {
99  if ( localPart->metaObject()->indexOfMethod( "updateQuickSearchText()" ) == -1 ) {
100  kWarning() << "KMailPart part is missing slot updateQuickSearchText()";
101  return;
102  }
103  QMetaObject::invokeMethod( localPart, "updateQuickSearchText" );
104  }
105 }
106 
107 
108 void KMailPlugin::processDropEvent( QDropEvent *de )
109 {
110  MemoryCalendar::Ptr cal( new MemoryCalendar( QString::fromLatin1( "UTC" ) ) );
111  KABC::Addressee::List list;
112  const QMimeData *md = de->mimeData();
113 
114  if ( VCalDrag::fromMimeData( md, cal ) || ICalDrag::fromMimeData( md, cal ) ) {
115  KTemporaryFile tmp;
116  tmp.setPrefix( QLatin1String("incidences-") );
117  tmp.setSuffix( QLatin1String(".ics") );
118  tmp.setAutoRemove( false );
119  tmp.open();
120  FileStorage storage( cal, tmp.fileName() );
121  storage.save();
122  openComposer( KUrl( tmp.fileName() ) );
123  } else if ( KABC::VCardDrag::fromMimeData( md, list ) ) {
124  KABC::Addressee::List::ConstIterator it;
125  QStringList to;
126  KABC::Addressee::List::ConstIterator end(list.constEnd());
127  for ( it = list.constBegin(); it != end; ++it ) {
128  to.append( ( *it ).fullEmail() );
129  }
130  openComposer( to.join( QLatin1String(", ") ) );
131  }
132 
133  kWarning() << QString::fromLatin1( "Cannot handle drop events of type '%1'." ).arg( QLatin1String(de->format()) );
134 }
135 
136 void KMailPlugin::openComposer( const KUrl &attach )
137 {
138  (void) part(); // ensure part is loaded
139  Q_ASSERT( m_instance );
140  if ( m_instance ) {
141  if ( attach.isValid() ) {
142  m_instance->newMessage( QString(), QString(), QString(), false, true, QString(), attach.isLocalFile() ?
143  attach.toLocalFile() : attach.path() );
144  } else {
145  m_instance->newMessage( QString(), QString(), QString(), false, true, QString(), QString() );
146  }
147  }
148 }
149 
150 void KMailPlugin::openComposer( const QString &to )
151 {
152  (void) part(); // ensure part is loaded
153  Q_ASSERT( m_instance );
154  if ( m_instance ) {
155  m_instance->newMessage( to, QString(), QString(), false, true, QString(), QString() );
156  }
157 }
158 
159 void KMailPlugin::slotNewMail()
160 {
161  openComposer( QString::null ); //krazy:exclude=nullstrassign for old broken gcc
162 }
163 
164 void KMailPlugin::slotSyncFolders()
165 {
166  QDBusMessage message =
167  QDBusMessage::createMethodCall( QLatin1String("org.kde.kmail"), QLatin1String("/KMail"),
168  QLatin1String("org.kde.kmail.kmail"),
169  QLatin1String("checkMail" ));
170  QDBusConnection::sessionBus().send( message );
171 }
172 
173 KMailPlugin::~KMailPlugin()
174 {
175  delete m_instance;
176  m_instance = 0;
177 }
178 
179 bool KMailPlugin::createDBUSInterface( const QString &serviceType )
180 {
181  if ( serviceType == QLatin1String( "DBUS/Mailer" ) ) {
182  if ( part() ) {
183  return true;
184  }
185  }
186  return false;
187 }
188 
189 QString KMailPlugin::tipFile() const
190 {
191  const QString file = KStandardDirs::locate( "data", QLatin1String("kmail2/tips") );
192  return file;
193 }
194 
195 KParts::ReadOnlyPart *KMailPlugin::createPart()
196 {
197  KParts::ReadOnlyPart *part = loadPart();
198  if ( !part ) {
199  return 0;
200  }
201 
202  m_instance = new OrgKdeKmailKmailInterface(
203  QLatin1String("org.kde.kmail"), QLatin1String("/KMail"), QDBusConnection::sessionBus() );
204 
205  return part;
206 }
207 
208 QStringList KMailPlugin::invisibleToolbarActions() const
209 {
210  return QStringList()<<QLatin1String( "new_message" );
211 }
212 
213 bool KMailPlugin::isRunningStandalone() const
214 {
215  return mUniqueAppWatcher->isRunningStandalone();
216 }
217 
218 KontactInterface::Summary *KMailPlugin::createSummaryWidget( QWidget *parent )
219 {
220  return new SummaryWidget( this, parent );
221 }
222 
224 
225 #include "../../../kmail/kmail_options.h"
226 void KMailUniqueAppHandler::loadCommandLineOptions()
227 {
228  KCmdLineArgs::addCmdLineOptions( kmail_options() );
229 }
230 
231 int KMailUniqueAppHandler::newInstance()
232 {
233  // Ensure part is loaded
234  (void)plugin()->part();
235  org::kde::kmail::kmail kmail( QLatin1String("org.kde.kmail"), QLatin1String("/KMail"), QDBusConnection::sessionBus() );
236  QDBusReply<bool> reply = kmail.handleCommandLine( false );
237 
238  if ( reply.isValid() ) {
239  bool handled = reply;
240  if ( !handled ) { // no args -> simply bring kmail plugin to front
241  return KontactInterface::UniqueAppHandler::newInstance();
242  }
243  }
244  return 0;
245 }
246 
247 bool KMailPlugin::queryClose() const
248 {
249  org::kde::kmail::kmail kmail( QLatin1String("org.kde.kmail"), QLatin1String("/KMail"), QDBusConnection::sessionBus() );
250  QDBusReply<bool> canClose = kmail.canQueryClose();
251  return canClose;
252 }
253 
kmail_plugin.h
QWidget
KMailPlugin::queryClose
virtual bool queryClose() const
Definition: kmail_plugin.cpp:247
KMailPlugin::createPart
virtual KParts::ReadOnlyPart * createPart()
Definition: kmail_plugin.cpp:195
KMailPlugin::openComposer
void openComposer(const KUrl &attach=KUrl())
Definition: kmail_plugin.cpp:136
KMailUniqueAppHandler::loadCommandLineOptions
virtual void loadCommandLineOptions()
Definition: kmail_plugin.cpp:226
QDropEvent::mimeData
const QMimeData * mimeData() const
QDBusReply
SummaryWidget
Definition: kmail/summarywidget.h:53
QDropEvent::format
virtual const char * format(int n) const
QDBusReply::isValid
bool isValid() const
QDBusConnection::sessionBus
QDBusConnection sessionBus()
QStringList::join
QString join(const QString &separator) const
summarywidget.h
QMimeData
KMailPlugin::slotSyncFolders
void slotSyncFolders()
Definition: kmail_plugin.cpp:164
KMailPlugin::shortcutChanged
void shortcutChanged()
Definition: kmail_plugin.cpp:95
fromMimeData
static MailList fromMimeData(const QMimeData *md)
QList::append
void append(const T &value)
KMailPlugin::isRunningStandalone
bool isRunningStandalone() const
Definition: kmail_plugin.cpp:213
KMailPlugin::processDropEvent
void processDropEvent(QDropEvent *)
Definition: kmail_plugin.cpp:108
QDropEvent
QDBusConnection::send
bool send(const QDBusMessage &message) const
KMailUniqueAppHandler::newInstance
virtual int newInstance()
Definition: kmail_plugin.cpp:231
to
QString to() const
QString
canDecode
static bool canDecode(const QMimeData *md)
QStringList
QMetaObject::invokeMethod
bool invokeMethod(QObject *obj, const char *member, Qt::ConnectionType type, QGenericReturnArgument ret, QGenericArgument val0, QGenericArgument val1, QGenericArgument val2, QGenericArgument val3, QGenericArgument val4, QGenericArgument val5, QGenericArgument val6, QGenericArgument val7, QGenericArgument val8, QGenericArgument val9)
KMailPlugin::tipFile
QString tipFile() const
Definition: kmail_plugin.cpp:189
KMailPlugin::invisibleToolbarActions
QStringList invisibleToolbarActions() const
Definition: kmail_plugin.cpp:208
QDBusMessage
QLatin1String
QKeySequence
KMailPlugin::~KMailPlugin
~KMailPlugin()
Definition: kmail_plugin.cpp:173
KMailPlugin::createDBUSInterface
bool createDBUSInterface(const QString &serviceType)
Definition: kmail_plugin.cpp:179
QString::fromLatin1
QString fromLatin1(const char *str, int size)
KMailPlugin::slotNewMail
void slotNewMail()
Definition: kmail_plugin.cpp:159
QString::arg
QString arg(qlonglong a, int fieldWidth, int base, const QChar &fillChar) const
KMailPlugin::canDecodeMimeData
bool canDecodeMimeData(const QMimeData *) const
Definition: kmail_plugin.cpp:87
QDBusMessage::createMethodCall
QDBusMessage createMethodCall(const QString &service, const QString &path, const QString &interface, const QString &method)
KMailPlugin::createSummaryWidget
virtual KontactInterface::Summary * createSummaryWidget(QWidget *parent)
Definition: kmail_plugin.cpp:218
KMailPlugin
Definition: kmail_plugin.h:48
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Mon Jun 22 2020 13:34:11 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

kontact

Skip menu "kontact"
  • Main Page
  • Namespace List
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members

kdepim API Reference

Skip menu "kdepim API Reference"
  • akonadi_next
  • akregator
  • blogilo
  • calendarsupport
  • console
  •   kabcclient
  •   konsolekalendar
  • kaddressbook
  • kalarm
  •   lib
  • kdgantt2
  • kjots
  • kleopatra
  • kmail
  • knode
  • knotes
  • kontact
  • korgac
  • korganizer
  • ktimetracker
  • libkdepim
  • libkleo
  • libkpgp
  • mailcommon
  • messagelist
  • messageviewer
  • pimprint

Search



Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal