<title>Extending Claws Mail</title>
<section id="plugins_default">
- <title>Provided plugins</title>
+ <title>Plugins</title>
<para>
- Claws Mail's capabilities are extended by plugins. It comes with
- the plugins listed below included, all of which are built automatically
- if the required libraries are present.
+ Claws Mail's capabilities are extended by plugins, which are
+ listed below.
</para><para>
Plugins are installed in <filename class="directory"
>$PREFIX/lib/claws-mail/plugins/</filename> and have a suffix of
<quote>.so</quote>. To load a plugin go to
<quote>Configuration/Plugins</quote> and click the
<quote>Load Plugin</quote> button. Select the plugin that you want and
- click <quote>Open</quote> button.
+ click the <quote>Open</quote> button.
</para><para>
If you don't find the plugin you're looking for, it is possible that
your Operating System distribution provides it in a separate package.
In this case, search for the plugin in your package manager.
</para><para>
Some plugins provide the same functionality as others, (for example, the
- three HTML message viewers). In this case you will have to choose which
+ 3 anti-Spam plugins). In this case you will have to choose which
one to load, as Claws Mail will refuse to load more than one of
the same type.
</para>
<para>
- There is an onlile list of all plugins available at <ulink
+ There is a list of all plugins available at <ulink
url="http://www.claws-mail.org/plugins.php"
>http://www.claws-mail.org/plugins.php</ulink>.
</para>
</para><para>
Bogofilter's advantage over Spamassassin is its speed.
</para><para>
+ Bogofilter must be trained before it can filter messages. To train
+ it you will need to mark some spam as Spam, and some legitimate
+ emails as Ham.
+ </para><para>
Bogofilter is available from <ulink
url="http://bogofilter.sourceforge.net/"
>http://bogofilter.sourceforge.net/</ulink>.
<listitem>
<para>
Allows scanning all messages received from IMAP, POP or local accounts
- using the clam daemon part of the Clam AV (AntiVirus) software.
+ using the clam daemon part of the ClamAV (AntiVirus) software (<ulink
+ url="http://www.clamav.net/">http://www.clamav.net/</ulink>).
</para>
</listitem>
</varlistentry>
<term>Fancy</term>
<listitem>
<para>
- Enables the display of HTML messages using the GTK+ port of the
- WebKit library.
+ Enables the rendering of HTML messages using the GTK+ port of the
+ WebKit library. By default, no remote content is loaded.
+ </para><para>
+ Plugin preferences can be found in
+ <quote>Configuration/Preferences/Plugins/Fancy</quote>.
</para>
</listitem>
</varlistentry>
</listitem>
</varlistentry>
<varlistentry>
- <term>GeoLocation</term>
+ <term>Libravatar</term>
<listitem>
<para>
- Provides geolocation functionality based on the addresses contained
- in the messages.
+ Enables the display of avatar images associated with user profiles at
+ libravatar.org or the user's avatar enabled domains.
+ More information: <ulink
+ url="http://www.claws-mail.org/plugin.php?plugin=libravatar"
+ >www.claws-mail.org/plugin.php?plugin=libravatar</ulink>
</para>
</listitem>
</varlistentry>
<term>NewMail</term>
<listitem>
<para>
- Writes a msg header summary to a log file, (Default:
- <filename>~/Mail/NewLog</filename>), on arrival of new mail
- <emphasis>after</emphasis> sorting.
+ Writes a message header summary to a log file, (Default:
+ <filename>~/Mail/NewLog</filename>), on arrival of new mail
+ <emphasis>after</emphasis> sorting.
</para>
</listitem>
</varlistentry>
<term>TNEF parse</term>
<listitem>
<para>
- This plugin enables reading <literal>application/ms-tnef attachments</literal>.
+ This plugin enables reading <literal>application/ms-tnef</literal> attachments.
More information: <ulink
url="http://www.claws-mail.org/plugin.php?plugin=tnef_parser"
>www.claws-mail.org/plugin.php?plugin=tnef_parser</ulink>
If you're a developer, writing a plugin to extend Claws Mail's
capabilities is probably the best and easiest solution. We will
provide hosting to your code, and will be glad to answer your questions
- in the mailing-list or on the IRC channels,
- <literal>#claws</literal> on Freenode or IRCnet.
+ in the mailing-list or on the IRC channel,
+ <literal>#claws</literal> on Freenode.
</para>
</section>
<section id="plugins_network">
<title>Network access from the plugins</title>
<para>
- Some of the external plugins, for example RSSyl, vCalendar or GtkHtml
- Viewer, need Internet access for their operations (retrieving feeds in
- the case of RSSyl or vCalendar, and fetching images in the case of
- GtkHtml Viewer). These plugins use the Curl library. Hence, if your
+ Some of the external plugins, for example RSSyl, vCalendar, Libravatar
+ or Fancy, need Internet access for their operations (retrieving feeds in
+ the case of RSSyl or vCalendar, and fetching images in the case of
+ Libravatar or Fancy). These plugins use the Curl library. Hence, if your
Internet access is restricted by a proxy, you will need to tell libCurl
- to use this proxy. This is done by setting an environment variable,
+ to use this proxy. This is done by setting an environment variable,
<literal>http_proxy</literal>. For example,
-<literal>http_proxy=http://user:passwd@myproxy.example.com:8080</literal>
- will tell libCurl to connect to port 8080 of the machine
- myproxy.example.com, with the user <quote>user</quote> and password
- <quote>passwd</quote> to connect to the Internet.
+ <literal>http_proxy=http://user:passwd@myproxy.example.com:8080</literal>
+ will tell libCurl to connect to port 8080 of the machine
+ myproxy.example.com, with the user <quote>user</quote> and password
+ <quote>passwd</quote> to connect to the Internet.
</para><para>
- You can either set this variable before starting Claws Mail, by
- using for example
- <command>http_proxy=http://user:passwd@myproxy.example.com:8080
- claws-mail</command>, or set it in your
- <filename>~/.bashrc</filename> file (or your shell equivalent), by
- adding the following line<footnote><para>Other shells may have
- diferent syntaxes, check your shell's manual page.</para></footnote>:
-<command>export http_proxy=http://user:passwd@myproxy.example.com:8080</command>
+ You can either set this variable before starting Claws Mail by
+ using, for example,
+ <command>http_proxy=http://user:passwd@myproxy.example.com:8080
+ claws-mail</command>, or you can set it in your
+ <filename>~/.bashrc</filename> file (or your shell equivalent), by
+ adding the following line<footnote><para>Other shells may have
+ diferent syntaxes, check your shell's manual page.</para></footnote>:
+ <command
+ >export http_proxy=http://user:passwd@myproxy.example.com:8080</command>
(you'll have to reconnect to have it taken into account).
</para>
</section>
- <section id="plugins_obsolete">
- <title>Obsolete plugins</title>
+ <section id="plugin_path_config">
+ <title>Plugin path configuration</title>
<para>
- Some plugins have became obsolete with time, either because an
- improved one was written, or they're not necessary anymore or just
- because nobody is actively developing it.
+ By default, when loading a plugin, its full path is saved in
+ <filename>~/.claws-mail/clawsrc</filename>.
+ </para><para>
+ As most users have only one copy of Claws Mail installed and always
+ use the same installation method, this is not a problem.
+ </para><para>
+ However, if you have multiple copies of Claws Mail installed
+ and want to share the same configuration among them, this may not
+ work, particularly when using different versions of Claws Mail.
</para><para>
- These are listed below, mostly for historical purposes. You are free
- to use them, as they probably still work if you're able to build them,
- but note that they are not currently supported.
+ A second installed copy will try to load the plugins installed by
+ the first and, if the versions differ, the plugins will be rejected.
</para><para>
- Of course, if you are interested you are encouraged to become the
- maintainer of any of them. Contact the team on the mailing list (see
- <xref linkend="intro_information" />) or on IRC (see above).
+ In order to avoid this problem you can manually edit the plugins
+ section in the <filename>clawsrc</filename> file, replacing the full
+ path with just the plugin file name of those you want to load
+ relative to the copy of Claws Mail being run.
+ </para><para>
+ In so doing, each copy of Claws Mail will try to load those plugins
+ from its own plugin directory, rather than a fixed location.
</para>
- <variablelist>
- <varlistentry>
- <term>Dillo HTML Viewer</term>
- <listitem>
- <para>
- Enables the viewing of HTML messages using the Dillo web browser,
- version 0.7.0 or newer. It uses Dillo's <literal>--local</literal>
- option by default for safe browsing. Preferences can be found in
- <quote>/Configuration/Preferences/Plugins/Dillo Browser</quote>.
- Dillo is available from <ulink url="http://www.dillo.org/"
- >http://www.dillo.org/</ulink>.
- </para><para>
- For displaying HTML messages or parts Fancy plugin should be used.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>CacheSaver</term>
- <listitem>
- <para>
- Saves the caches every 60 seconds (or user-defined period). It helps
- avoiding the loss of metadata if your computer (<emphasis>or
- Claws Mail!</emphasis>) crashes. (NOTE: using this plugin can slow
- down Claws Mail.)
- </para><para>
- This plugin is not required anymore.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>GtkHtml2 Viewer</term>
- <listitem>
- <para>
- Like Dillo, enables the viewing of HTML messages, but in a nicer way
- (antialiased fonts).
- More information: <ulink
- url="http://www.claws-mail.org/plugin.php?plugin=gtkhtml2"
- >www.claws-mail.org/plugin.php?plugin=gtkhtml2</ulink>
- </para><para>
- For displaying HTML messages or parts Fancy plugin should be used.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>SynCE</term>
- <listitem>
- <para>
- Assists in keeping the address book of a Windows CE device (Pocket
- PC, iPAQ, Smartphone, etc.) in sync with Claws Mail' address book,
- with respect to email addresses.
- </para><para>
- This plugin is not maintained anymore.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>Trayicon</term>
- <listitem>
- <para>
- Places an icon in the system tray that indicates whether you have any
- new mail. A tooltip also shows the current new, unread and total number
- of messages.
- </para><para>
- For this feature the system tray icon option of Notification plugin
- should be used.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
</section>
</section>