KMail now has "Tip of the Day"!

svn path=/trunk/kdenetwork/kmail/; revision=157669
24 years ago · 4f0f41849d
parent 9b0b8a1c21
commit 4f0f41849d
7 changed files with 94 additions and 1 deletions
--- a/Makefile.am
+++ b/Makefile.am
@ -75,6 +75,9 @@ updatedir = $(kde_datadir)/kconf_update
 update_DATA = kmail.upd upgrade-transport.pl kmail-pgpidentity.pl \
 		upgrade-signature.pl kmail-upd-identities.pl

+tipdir = $(kde_datadir)/kmail
+tip_DATA = tips
+
 messages: rc.cpp
 	$(XGETTEXT) *.cpp *.h -o $(podir)/kmail.pot

--- a/kmkernel.cpp
+++ b/kmkernel.cpp
@ -35,6 +35,7 @@
 #include "kmidentity.h"
 #include "identitymanager.h"
 #include <kwin.h>
+#include <ktip.h>

 #include <X11/Xlib.h>
 #include <kapplication.h>
@ -1009,5 +1010,13 @@ IdentityManager * KMKernel::identityManager() {
  return mIdentityManager;
 }

+void KMKernel::slotShowTipOnStart() {
+  KTipDialog::showTip(0);
+}
+
+void KMKernel::slotShowTip() {
+  KTipDialog::showTip( 0, QString::null, true );
+}
+

 #include "kmkernel.moc"
--- a/kmkernel.h
+++ b/kmkernel.h
@ -149,6 +149,12 @@ public:
  QByteArray getCollectedStdErr(KProcess*);

 public slots:
+  /** Show tip-of-the-day on startup */
+  void slotShowTipOnStart();
+
+  /** Show tip-of-the-day, forced */
+  void slotShowTip();
+
  /** Connect the received* signals of K(Shell)Process to these slots
      to let the kernel collect the output for you.

--- a/kmmainwin.cpp
+++ b/kmmainwin.cpp
@ -2789,6 +2789,10 @@ void KMMainWin::setupMenuBar()
 				i18n("Display KMail's Welcome Page") ),
 		      0, this, SLOT(slotIntro()),
 		      actionCollection(), "help_kmail_welcomepage" );
+  (void) new KAction( KGuiItem( i18n("Tip of the &Day..."), 0,
+				i18n("Show \"Tip of the Day\"") ),
+		      0, kernel, SLOT(slotShowTip()),
+		      actionCollection(), "help_show_tip" );

  createGUI( "kmmainwin.rc", false );

--- a/kmmainwin.rc
+++ b/kmmainwin.rc
@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!DOCTYPE kpartgui>
-<kpartgui version="35" name="kmmainwin" >
+<kpartgui version="36" name="kmmainwin" >
 <MenuBar>
  <Menu noMerge="1" name="file" >
   <text>&amp;File</text>
@ -103,6 +103,7 @@
  </Menu>
  <Menu name="help">
   <Action name="help_kmail_welcomepage"/>
+   <Action name="help_show_tip"/>
  </Menu>
 </MenuBar>
 <ToolBar noMerge="1" name="mainToolBar" fullWidth="true" >
--- a/main.cpp
+++ b/main.cpp
@ -11,6 +11,8 @@
 #include <stdlib.h>
 #include <unistd.h>

+#include <qtimer.h>
+
 #include <kuniqueapplication.h>
 #include <klocale.h>
 #include <kglobal.h>
@ -315,6 +317,9 @@ int main(int argc, char *argv[])
  // any dead letters?
  kmailKernel.recoverDeadLetters();

+  // show tip-of-the-day:
+  QTimer::singleShot( 5000, &kmailKernel, SLOT(slotShowTipOnStart()) );
+
  setSignalHandler(signalHandler);

  kapp->dcopClient()->resume(); // Ok. We are ready for DCOP requests.
--- a/65
+++ b/65
@ -0,0 +1,65 @@
+<tip category="KMail|Keyboard">
+<html>
+<p>...that you can use the Left/Right keys of your keyboard to go to
+the previous/next message?</p>
+</html>
+</tip>
+
+<tip category="KMail|Filters">
+<html>
+<p>...that you can rapidly create filters on sender, recipient,
+subject and mailing lists with <em>Tools->Create&nbsp;Filter</em>?</p>
+</html>
+</tip>
+
+<tip category="KMail|Filters">
+<html>
+<p>...that you can get rid of the &quot;[mailing list name]&quot;
+added to the subject of some mailing lists by using the <em>rewrite
+header</em> filter action? Just use
+<pre>rewrite header &quot;Subject&quot;
+   replace &quot;\s*\[mailing list name\]\s*&quot;
+   with &quot;&quot;</pre>
+</p>
+</html>
+</tip>
+
+<tip category="KMail|General">
+<html>
+<p>...that you can associate mailing lists with folders in the
+<em>Folder->Properties...</em> dialog? You can then use
+<em>Message->Post to Mailing List...</em> to open the composer with
+the mailing list address preset.</p>
+</html>
+</tip>
+
+<tip category="KMail|General">
+<html>
+<p>...that you can assign custom icons to each folder individually?
+See <em>Folder->Properties...</em></p>
+</html>
+</tip>
+
+<tip category="KMail|Security">
+<html>
+<p>...that KMail can show a color bar indicating the type of message
+(Plain text/HTML/OpenPGP) currently displayed?</p>
+<p>This thwards attempts to fake successful signature verification by
+sending HTML mails mimicking KMail's signature status frames.</p>
+</html>
+</tip>
+
+<tip category="KMail|Filters">
+<html>
+<p>...that you can filter on any header by simply entering it's name
+in the first edit field of a search rule?</p>
+</html>
+</tip>
+
+<tip category="KMail|Filters">
+<html>
+<p>...that you can filter out HTML-only messages with the rule
+<pre>&quot;Content-type&quot; contains &quot;text/html&quot;?</pre>
+</p>
+</html>
+</tip>