1<?xml version="1.0" encoding="utf-8"?>
2<section id="ch_plugins">
3<title>Extendiendo &SC;</title>
4
5  <section id="plugins_default">
6    <title>Módulos</title>
7    <para>
8	Las capacidades de &SC; se amplian usando módulos, cuya lista
9	aparece debajo.
10    </para><para>
11	Los módulos se instalan en <filename class="directory"
12	>$PREFIX/lib/claws-mail/plugins/</filename> y
13	tienen el sufijo <quote>.so</quote>. Para cargar un módulo vaya
14	al menú <quote>Configuración/Módulos</quote> y pulse el botón
15	<quote>Cargar módulo</quote>. Seleccione el módulo que desee cargar y
16	pulse el botón <quote>Aceptar</quote>.
17    </para><para>
18	Si no encuentra el módulo que busca es posible que la distribución de
19	su sistema operativo lo proporcione en algún paquete distinto. En ese
20	caso busque el módulo con su gestor de paquetes.
21    </para><para>
22	Algunos módulos proporcionan la misma funcionalidad que otros (por
23	ejemplo, los tres módulos anti-correo basura). En tal caso tendrá que
24	elejir cual de ellos cargar, ya que &SC; no cargará más de uno del
25	mismo tipo a la vez.
26    </para>
27    <para>
28	Existe una lista de todos los módulos disponibles en <ulink
29	url="http://www.claws-mail.org/plugins.php"
30	>http://www.claws-mail.org/plugins.php</ulink>.
31    </para>
32    <variablelist>
33      <varlistentry>
34        <term>Nofificador ACPI</term>
35	<listitem>
36	  <para>
37	Permite la notificación del correo nuevo a través de los LEDs que se
38	encuentran en ciertos modelos de portátil de marcas como Acer, Asus,
39	Fujitsu o IBM.
40	Más información: <ulink
41	url="http://www.claws-mail.org/plugin.php?plugin=acpinotifier"
42	>www.claws-mail.org/plugin.php?plugin=acpinotifier</ulink>.
43	  </para>
44	</listitem>
45      </varlistentry>
46      <varlistentry>
47	<term>Guardián de direcciones</term>
48	<listitem>
49	  <para>
50	Guarda todas las direcciones de destinatarios desconocidos (
51	<quote>Para</quote>, <quote>Cc</quote> y/o <quote>Bcc</quote>)
52	en una carpeta de la agenda de direcciones designada al efecto.
53	  </para>
54	</listitem>
55      </varlistentry>
56      <varlistentry>
57	<term>Aviso de adjuntos</term>
58	<listitem>
59	  <para>
60	Le recuerda la posibilidad de que se haya olvidado adjuntos.
61	Comprueba expresiones comunes que se usan cuando se adjuntan
62	ficheros y le avisa si no se añadió ningún adjunto al correo
63	que se está enviando.
64	Más información: <ulink
65	url="http://www.claws-mail.org/plugin.php?plugin=attachwarner"
66	>www.claws-mail.org/plugin.php?plugin=attachwarner</ulink>.
67	  </para>
68	</listitem>
69      </varlistentry>
70      <varlistentry>
71	<term>Eliminador de adjuntos</term>
72	<listitem>
73	  <para>
74	Permite eliminar los ficheros adjuntos de los mensajes.
75	  </para>
76	</listitem>
77      </varlistentry>
78      <varlistentry>
79	<term>Bogofilter</term>
80	<listitem>
81	  <para>
82	El módulo Bogofilter viene con dos características principales:
83	  </para><para>
84	La habilidad para escanear el correo entrante recibido de cuentas
85	IMAP, POP3 o locales usando Bogofilter. Puede, opcionalmente, borrar
86	el correo identificado como basura o guardarlo en una carpeta
87	designada al efecto. El escaneado se puede desactivar.
88	  </para><para>
89	La posibilidad de que el usuario enseñe a Bogofilter a distinguir entre
90	el correo basura o el aceptable. Puede entrenar a Bogofilter marcando
91	los mensajes como correo basura o como buenos en el menú contextual de
92	la lista de mensajes, o a través del botón correspondiente en la
93	venana principal o de mensaje (vea
94	<quote>Configuración/Preferencias/Barras de herramientas</quote>.
95	Los mensajes marcados como basura se pueden
96	guardar en una carpeta designada al efecto también de manera opcional.
97	  </para><para>
98	Las preferencias del módulo se pueden encontrar en
99	<quote>Configuración/Preferencias/Módulos/Bogofilter</quote>.
100	  </para><para>
101	La ventaja de Bogofilter sobre SpamAssassin es su velocidad.
102	  </para><para>
103	Bogofilter necesita entrenamiento antes de poder filtrar mensajes.
104	Para entrenarlo es necesario marcar algún correo basura como tal y
105	algún correo legítimo como bueno.
106	  </para><para>
107	Bogofilter está disponible en <ulink
108	url="http://bogofilter.sourceforge.net/"
109	>http://bogofilter.sourceforge.net/</ulink>.
110	  </para>
111	</listitem>
112      </varlistentry>
113      <varlistentry>
114        <term>BSFilter</term>
115        <listitem>
116          <para>
117        BSFilter es un módulo muy similar al Bogofilter pero utiliza
118        para realizar su tarea el filtro bayesiano de correo basura
119	bsfilter (<ulink url="http://bsfilter.org/index-e.html"
120	>bsfilter.org/index-e.html</ulink>).
121          </para><para>
122	Al igual que con Bogofilter, hay que entrenarlo con mensajes
123	basura y mensajes legítimos para que pueda comenzar a reconocer
124	el correo basura.
125          </para><para>
126	Las preferencias se encuentran en
127        <quote>Configuración/Preferencias/Módulos/BSFilter</quote>.
128          </para>
129        </listitem>
130      </varlistentry>
131      <varlistentry>
132        <term>Clamd</term>
133        <listitem>
134          <para>
135	Permite escanear todos los mensajes recibidos de cuentas locales,
136	POP o IMAP usando el demonio clam, parte del software antivirus
137	Clam AV (<ulink url="http://www.clamav.net/"
138	>http://www.clamav.net/</ulink>).
139	  </para>
140	</listitem>
141      </varlistentry>
142      <varlistentry>
143        <term>Visor HTML Fancy</term>
144        <listitem>
145          <para>
146	Permite mostrar mensajes HTML usando la versión basada en GTK+
147	de la librería WebKit. Por omisión no se carga ningún contenido
148	remoto.
149	  </para><para>
150	Las preferencias se encuentran en
151        <quote>Configuración/Preferencias/Módulos/Visor HTML Fancy</quote>.
152	  </para>
153        </listitem>
154      </varlistentry>
155      <varlistentry>
156	<term>Fetchinfo</term>
157	<listitem>
158	  <para>
159	Inserta cabeceras que contienen cierta información sobre la descarga,
160	como el UIDL, el nombre de la cuenta de &SC;, el servidor POP, el
161	identificador de usuario y la hora de descarga.
162	  </para>
163	</listitem>
164      </varlistentry>
165      <varlistentry>
166	<term>GData</term>
167	<listitem>
168	  <para>
169	Proporciona un interface para los servicios de Google usando la
170	biblioteca gdata. La única funcionalidad implmementada actualmente
171	es incluir los contactos de Google en la función de auto-completar
172	direcciones con el tabulador.
173	  </para>
174	</listitem>
175      </varlistentry>
176      <varlistentry>
177	<term>Libravatar</term>
178	<listitem>
179	  <para>
180	Permite mostrar las imágenes de avatares asociadas a los perfiles de
181	usuario de libravatar.org o los dominios de los usuarios que esten
182	configurados para proporcionar avatares.
183	Más información: <ulink
184	url="http://www.claws-mail.org/plugin.php?plugin=libravatar"
185	>www.claws-mail.org/plugin.php?plugin=libravatar</ulink>.
186	  </para>
187	</listitem>
188      </varlistentry>
189      <varlistentry>
190	<term>Archivador de correo</term>
191	<listitem>
192	  <para>
193	Permite archivar carpetas y subcarpetas en varios formatos diferentes.
194	  </para>
195	</listitem>
196      </varlistentry>
197      <varlistentry>
198	<term>mailMBOX</term>
199	<listitem>
200	  <para>
201	Gestiona buzones en formato Mbox.
202	  </para>
203	</listitem>
204      </varlistentry>
205      <varlistentry>
206	<term>NewMail</term>
207	<listitem>
208	  <para>
209	Escribe un resumen de las cabeceras de los mensajes en un fichero
210	de traza (por defecto <filename>~/Mail/NewLog</filename>) cuando
211	llega correo nuevo y <emphasis>después</emphasis> de ordenarlo.
212	  </para>
213	</listitem>
214      </varlistentry>
215      <varlistentry>
216	<term>Notificación</term>
217	<listitem>
218	  <para>
219	Proporciona varios métodos para notificar al usuario sobre el
220	correo nuevo y no leído.
221	Más información: <ulink
222	url="http://www.claws-mail.org/plugin.php?plugin=notification"
223	>www.claws-mail.org/plugin.php?plugin=notification</ulink>.
224	  </para>
225	</listitem>
226      </varlistentry>
227      <varlistentry>
228	<term>Visor PDF</term>
229	<listitem>
230	  <para>
231	Permite visualizar los adjuntos de tipo PDF y PostScript utilizando
232	la biblioteca Poppler y el programa externo GhostScript.
233	Más información: <ulink
234	url="http://www.claws-mail.org/plugin.php?plugin=pdf_viewer"
235	>www.claws-mail.org/plugin.php?plugin=pdf_viewer</ulink>.
236	  </para>
237	</listitem>
238      </varlistentry>
239      <varlistentry>
240	<term>Perl</term>
241	<listitem>
242	  <para>
243	Para ampliar las posibilidades de filtrado de &SC;. Proporciona un
244	interfaz Perl al mecanismo de filtrado de &SC;, permitiendo el uso de
245	toda la potencia de Perl en los filtros de correo.
246	  </para>
247	</listitem>
248      </varlistentry>
249      <varlistentry>
250	<term>PGP/Core, PGP/Inline y PGP/MIME</term>
251	<listitem>
252	  <para>
253	Gestiona mensajes firmados y/o cifrados con PGP. Se pueden descifrar
254	correos y verificar firmas, así como firmar y cifrar sus propios
255	correos. Utiliza GnuPG/GPGME, <ulink
256	url="ftp://ftp.gnupg.org/gcrypt/gpgme/"
257	>ftp://ftp.gnupg.org/gcrypt/gpgme/</ulink>.
258	Más información: <ulink
259	url="http://www.claws-mail.org/plugin.php?plugin=gpg"
260	>www.claws-mail.org/plugin.php?plugin=gpg</ulink>.
261	  </para>
262	</listitem>
263      </varlistentry>
264      <varlistentry>
265        <term>Python</term>
266        <listitem>
267          <para>
268	Este módulo permite integrarse con Python.
269	Más información: <ulink
270	url="http://www.claws-mail.org/plugin.php?plugin=python"
271	>www.claws-mail.org/plugin.php?plugin=python</ulink>.
272	  </para>
273        </listitem>
274      </varlistentry>
275      <varlistentry>
276	<term>RSSyl</term>
277	<listitem>
278	  <para>
279	Le permite leer sus canales de noticias (<emphasis>feeds</emphasis>)
280	en &SC;. Actualmente están soportados los canales RSS 1.0 y 2.0, así
281	como los Atom.
282	Más información: <ulink
283	url="http://www.claws-mail.org/plugin.php?plugin=rssyl"
284	>www.claws-mail.org/plugin.php?plugin=rssyl</ulink>.
285	  </para>
286	</listitem>
287      </varlistentry>
288      <varlistentry>
289	<term>S/MIME</term>
290	<listitem>
291	  <para>
292	Gestiona correos firmados y/o cifrados S/MIME. Se pueden descifrar
293	correos y verificar firmas digitales, así como firmar y cifrar sus
294	propios correos. Utiliza GnuPG/GPGME y GpgSM, disponibles en <ulink
295	url="ftp://ftp.gnupg.org/gcrypt/gpgme/"
296	>ftp://ftp.gnupg.org/gcrypt/gpgme/</ulink>.
297	  </para>
298	</listitem>
299      </varlistentry>
300      <varlistentry>
301	<term>SpamAssassin</term>
302	<listitem>
303	  <para>
304	El módulo SpamAssassin proporciona dos grandes funcionalidades:
305	  </para><para>
306	La capacidad de escanear con SpamAssassin el correo entrante de
307	cualquier cuenta POP, IMAP o local. Opcionalmente puede borrar los
308	mensajes identificados como spam o guardarlos en una carpeta al efecto.
309	El escaneo de correo se puede desactivar, lo cual es útil si el
310	correo ya es escaneado en su servidor.
311	  </para><para>
312	La posibilidad para que los usuarios enseñen a SpamAssassin a
313	distinguir el spam de los correos deseados. Se puede entrenar a
314	SpamAssassin marcando los mensajes como spam o no usando el menú
315	contextual de la lista de mensajes, o usando un botón para ello en
316	la barra de herramientas de la ventana principal o de mensaje (vea
317	<quote>Configuración/Preferencias/Barras de herramientas</quote>.
318	Los mensajes marcados como spam se pueden
319	guardar opcionalmente en una carpeta destinada a ello.
320	  </para><para>
321	Las preferencias del módulo se encuentran en
322	<quote>Configuración/Preferencias/Módulos/SpamAssassin</quote>.
323	  </para><para>
324	SpamAssassin está disponible en <ulink
325	url="http://spamassassin.apache.org/"
326	>http://spamassassin.apache.org/</ulink>. Es necesaria la versión
327	3.1.x o superior para utilizar la funcionalidad de aprendizaje en
328	modo TCP.
329	  </para>
330	</listitem>
331      </varlistentry>
332      <varlistentry>
333	<term>SpamReport</term>
334	<listitem>
335	  <para>
336	Este módulo permite informar sobre correo basura en varios sitios.
337	Actualmente están soportados los sitios <ulink
338	url="http://spam-signal.fr">spam-signal.fr</ulink> y <ulink
339	url="http://spamcop.net">spamcop.net</ulink>, y el sistema de
340	nominación de correo basura de las <ulink url="http://lists.debian.org"
341	>listas de Debian (lists.debian.org)</ulink>.
342	  </para>
343	</listitem>
344      </varlistentry>
345      <varlistentry>
346	<term>Intérprete TNEF</term>
347	<listitem>
348	  <para>
349	Este módulo permite leer los adjuntos de tipo <literal
350	>application/ms-tnef</literal>.
351	Más información: <ulink
352	url="http://www.claws-mail.org/plugin.php?plugin=tnef_parser"
353	>www.claws-mail.org/plugin.php?plugin=tnef_parser</ulink>.
354          </para>
355        </listitem>
356      </varlistentry>
357      <varlistentry>
358	<term>vCalendar</term>
359	<listitem>
360	  <para>
361	Permite la gestión de mensajes vCalendar al estilo de Evolution u
362	Outlook, y también suscripciones Webcal.
363	Más información: <ulink
364	url="http://www.claws-mail.org/plugin.php?plugin=vcalendar"
365	>www.claws-mail.org/plugin.php?plugin=vcalendar</ulink>.
366	  </para>
367	</listitem>
368      </varlistentry>
369    </variablelist>
370    <para>
371	Si usted es un desarrollador, escribir un módulo para extender las
372	capacidades de &SC; será probablemente la mejor solución y la más
373	fácil. Nosotros proporcionaremos hospedaje para su código y
374	estaremos encantados de responder a sus preguntas en la lista de
375	correo o en el canal de IRC, <literal>#claws</literal> en
376	Freenode.
377    </para>
378  </section>
379
380  <section id="plugins_network">
381    <title>Acceso a la red desde los módulos</title>
382    <para>
383	Algunos de los módulos externos, por ejemplo RSSyl, vCalendar, Fancy
384	o Libravatar, necesitan acceso a Internet para llevar a cabo sus
385	funciones (recuperar canales en el caso de RSSyl o vCalendar, y
386	obtener imágenes en el caso de Fancy o Libravatar). Estos módulos usan
387	para ello la librería Curl. Por tanto, si su acceso a Internet está
388	restringido por un proxy necesitará decirle a libCurl que lo use.
389	Esto se consigue estableciendo la variable de entorno
390	<literal>http_proxy</literal>. Por ejemplo, <literal
391	>http_proxy=http://usuario:contra@miproxy.ejemplo.com:8080</literal>
392	le dirá a libCurl que conecte al puerto 8080 de la máquina
393	miproxy.ejemplo.com con el  usuario <quote>usuario</quote> y
394	contraseña <quote>contra</quote> para conectarse a Internet.
395    </para><para>
396	Puede establecer esta variable antes de iniciar &SC;, usando por
397	por ejemplo la orden
398	<command>http_proxy=http://usuario:contra@miproxy.ejemplo.com:8080
399	claws-mail</command>, o establecerla en su fichero
400	<filename>~/.bashrc</filename> (o el equivalente de su shell) añadiendo
401	la línea<footnote><para>Otros shells pueden tener diferentes sintaxis,
402	compruebe la página del manual de su shell.</para></footnote>:
403	<command>export
404	http_proxy=http://usuario:contra@miproxy.ejemplo.com:8080</command>
405	(tendrá que reconectar para que se tenga en cuenta).
406    </para>
407  </section>
408
409  <section id="plugin_path_config">
410    <title>Configuración de la ruta de los módulos</title>
411    <para>
412    Cuando se carga un módulo se guarda la ruta completa al mismo en el
413    fichero de configuración <filename>~/.claws-mail/clawsrc</filename>.
414    </para><para>
415    Puesto que la mayoría de usuarios sólo utilizan una copia de &SC; y
416    siempre usan el mismo método de instalación, esto no es un problema.
417    </para><para>
418    Por el contrario, si se tienen múltiples copias de &SC; instaladas y
419    desea compartir la misma configuración entre ellas esto puede no
420    funcionar, especialmente si se utilizan diferentes versiones de &SC;.
421    </para><para>
422    La copia instalada en segundo lugar intentará cargar los módulos
423    instalados por la primera y, si las versiones difieren, los módulos
424    serán rechazados.
425    </para><para>
426    Para evitar este problema se puede editar manualmente la sección de
427    los módulos en el fichero <filename>clawsrc</filename>, sustituyendo
428    la ruta completa por el nombre del fichero únicamente en aquellos que
429    desee cargar de manera relativa a la copia de &SC; en ejecución.
430    </para><para>
431    De esta manera cada copia de &SC; intentará cargar esos módulos de su
432    propio directorio de módulos en lugar de una ubicación concreta.
433    </para>
434  </section>
435
436</section>
437
438