2 * Claws Mail -- a GTK+ based, lightweight, and fast e-mail client
3 * Copyright (C) 2014-2015 Ricardo Mones and the Claws Mail Team
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
21 #include "claws-features.h"
25 #include <glib/gi18n.h>
27 #include <curl/curl.h>
30 #include "libravatar.h"
31 #include "libravatar_prefs.h"
32 #include "libravatar_cache.h"
33 #include "libravatar_image.h"
34 #include "libravatar_missing.h"
35 #include "libravatar_federation.h"
36 #include "prefs_common.h"
37 #include "procheader.h"
42 /* indexes of keys are default_mode - 10 if applicable */
43 static const char *def_mode[] = {
44 "404", /* not used, only useful in web pages */
52 static gulong update_hook_id = HOOK_NONE;
53 static gulong render_hook_id = HOOK_NONE;
54 static gchar *cache_dir = NULL; /* dir-separator terminated */
56 static gboolean libravatar_header_update_hook(gpointer source, gpointer data)
58 AvatarCaptureData *acd = (AvatarCaptureData *)source;
60 debug_print("libravatar avatar_header_update invoked\n");
62 if (!strcmp(acd->header, "From:")) {
65 a = g_strdup(acd->content);
69 for (lower = a; *lower; lower++)
70 *lower = g_ascii_tolower(*lower);
72 debug_print("libravatar added '%s'\n", a);
73 procmsg_msginfo_add_avatar(acd->msginfo, AVATAR_LIBRAVATAR, a);
77 return FALSE; /* keep getting */
80 static gchar *federated_base_url_from_address(const gchar *address)
82 #if defined USE_GNUTLS
83 gchar *base_url = NULL;
85 if (!libravatarprefs.allow_federated) {
86 debug_print("federated domains disabled by configuration\n");
90 base_url = federated_url_for_address(address);
91 if (base_url != NULL) {
97 return g_strdup(libravatarprefs.base_url);
100 static GtkWidget *image_widget_from_pixbuf(GdkPixbuf *picture)
102 GtkWidget *image = NULL;
105 image = gtk_image_new_from_pixbuf(picture);
106 g_object_unref(picture);
108 g_warning("null picture returns null widget");
113 static GtkWidget *image_widget_from_filename(const gchar *filename)
115 GdkPixbuf *picture = NULL;
116 GError *error = NULL;
119 gdk_pixbuf_get_file_info(filename, &w, &h);
121 if (w != AVATAR_SIZE || h != AVATAR_SIZE)
122 /* server can provide a different size from the requested in URL */
123 picture = gdk_pixbuf_new_from_file_at_scale(
124 filename, AVATAR_SIZE, AVATAR_SIZE, TRUE, &error);
125 else /* exact size */
126 picture = gdk_pixbuf_new_from_file(filename, &error);
129 g_warning("failed to load image '%s': %s", filename, error->message);
134 return image_widget_from_pixbuf(picture);
137 static gchar *cache_name_for_md5(const gchar *md5)
139 if (libravatarprefs.default_mode >= DEF_MODE_MM
140 && libravatarprefs.default_mode <= DEF_MODE_RETRO) {
141 /* cache dir for generated avatars */
142 return g_strconcat(cache_dir, def_mode[libravatarprefs.default_mode - 10],
143 G_DIR_SEPARATOR_S, md5, NULL);
145 /* default cache dir */
146 return g_strconcat(cache_dir, md5, NULL);
149 static GtkWidget *image_widget_from_url(const gchar *url, const gchar *md5)
151 GtkWidget *image = NULL;
152 AvatarImageFetch aif;
156 aif.filename = cache_name_for_md5(md5);
157 libravatar_image_fetch(&aif);
159 image = gtk_image_new_from_pixbuf(aif.pixbuf);
160 g_object_unref(aif.pixbuf);
162 g_free(aif.filename);
167 static gboolean is_recent_enough(const gchar *filename)
172 if (libravatarprefs.cache_icons) {
174 if (t != (time_t)-1 && !g_stat(filename, &s)) {
175 if (t - s.st_ctime <= libravatarprefs.cache_interval * 3600)
180 return FALSE; /* re-download */
183 static GtkWidget *image_widget_from_cached_md5(const gchar *md5)
185 GtkWidget *image = NULL;
188 filename = cache_name_for_md5(md5);
189 if (is_file_exist(filename) && is_recent_enough(filename)) {
190 debug_print("found cached image for %s\n", md5);
191 image = image_widget_from_filename(filename);
198 static gchar *libravatar_url_for_md5(const gchar *base, const gchar *md5)
200 if (libravatarprefs.default_mode >= DEF_MODE_404) {
201 return g_strdup_printf("%s/%s?s=%u&d=%s",
202 base, md5, AVATAR_SIZE,
203 def_mode[libravatarprefs.default_mode - 10]);
204 } else if (libravatarprefs.default_mode == DEF_MODE_URL) {
205 gchar *escaped = g_uri_escape_string(libravatarprefs.default_mode_url, "/", TRUE);
206 gchar *url = g_strdup_printf("%s/%s?s=%u&d=%s",
207 base, md5, AVATAR_SIZE, escaped);
210 } else if (libravatarprefs.default_mode == DEF_MODE_NONE) {
211 return g_strdup_printf("%s/%s?s=%u&d=404",
212 base, md5, AVATAR_SIZE);
215 g_warning("invalid libravatar default mode: %d", libravatarprefs.default_mode);
219 static gboolean libravatar_image_render_hook(gpointer source, gpointer data)
221 AvatarRender *ar = (AvatarRender *)source;
222 GtkWidget *image = NULL;
223 gchar *a = NULL, *url = NULL;
226 debug_print("libravatar avatar_image_render invoked\n");
228 a = procmsg_msginfo_get_avatar(ar->full_msginfo, AVATAR_LIBRAVATAR);
232 md5_hex_digest(md5sum, a);
233 /* try missing cache */
234 if (is_missing_md5(libravatarmisses, md5sum)) {
238 image = image_widget_from_cached_md5(md5sum);
240 if (ar->image) /* previous plugin set one */
241 gtk_widget_destroy(ar->image);
243 ar->type = AVATAR_LIBRAVATAR;
246 /* not cached copy: try network */
247 if (prefs_common_get_prefs()->work_offline) {
248 debug_print("working off-line: libravatar network retrieval skipped\n");
251 base = federated_base_url_from_address(a);
252 url = libravatar_url_for_md5(base, md5sum);
254 image = image_widget_from_url(url, md5sum);
257 if (ar->image) /* previous plugin set one */
258 gtk_widget_destroy(ar->image);
260 ar->type = AVATAR_LIBRAVATAR;
268 return FALSE; /* keep rendering */
271 static gint cache_dir_init()
273 cache_dir = libravatar_cache_init(def_mode, DEF_MODE_MM - 10, DEF_MODE_RETRO - 10);
274 cm_return_val_if_fail (cache_dir != NULL, -1);
279 static gint missing_cache_init()
281 gchar *cache_file = g_strconcat(get_rc_dir(), G_DIR_SEPARATOR_S,
282 LIBRAVATAR_CACHE_DIR, G_DIR_SEPARATOR_S,
283 LIBRAVATAR_MISSING_FILE, NULL);
285 libravatarmisses = missing_load_from_file(cache_file);
288 if (libravatarmisses == NULL)
294 static void missing_cache_done()
298 if (libravatarmisses != NULL) {
299 cache_file = g_strconcat(get_rc_dir(), G_DIR_SEPARATOR_S,
300 LIBRAVATAR_CACHE_DIR, G_DIR_SEPARATOR_S,
301 LIBRAVATAR_MISSING_FILE, NULL);
302 missing_save_to_file(libravatarmisses, cache_file);
304 g_hash_table_destroy(libravatarmisses);
308 static void unregister_hooks()
310 if (render_hook_id != HOOK_NONE) {
311 hooks_unregister_hook(AVATAR_IMAGE_RENDER_HOOKLIST,
313 render_hook_id = HOOK_NONE;
315 if (update_hook_id != HOOK_NONE) {
316 hooks_unregister_hook(AVATAR_HEADER_UPDATE_HOOKLIST,
318 update_hook_id = HOOK_NONE;
325 * @param error For storing the returned error message.
327 * @return 0 if initialization succeeds, -1 on failure.
329 gint plugin_init(gchar **error)
331 if (!check_plugin_version(MAKE_NUMERIC_VERSION(3,9,3,29),
332 VERSION_NUMERIC, _("Libravatar"), error))
334 /* get info from headers */
335 update_hook_id = hooks_register_hook(AVATAR_HEADER_UPDATE_HOOKLIST,
336 libravatar_header_update_hook,
338 if (update_hook_id == HOOK_NONE) {
339 *error = g_strdup(_("Failed to register avatar header update hook"));
342 /* get image for displaying */
343 render_hook_id = hooks_register_hook(AVATAR_IMAGE_RENDER_HOOKLIST,
344 libravatar_image_render_hook,
346 if (render_hook_id == HOOK_NONE) {
348 *error = g_strdup(_("Failed to register avatar image render hook"));
352 if (cache_dir_init() == -1) {
354 *error = g_strdup(_("Failed to create avatar image cache directory"));
357 /* preferences page */
358 libravatar_prefs_init();
360 curl_global_init(CURL_GLOBAL_DEFAULT);
362 if (missing_cache_init() == -1) {
364 *error = g_strdup(_("Failed to load missing items cache"));
367 debug_print("Libravatar plugin loaded\n");
373 * Destructor for the plugin.
374 * Unregister the callback function and frees matcher.
376 * @return Always TRUE.
378 gboolean plugin_done(void)
381 libravatar_prefs_done();
382 missing_cache_done();
383 if (cache_dir != NULL)
385 debug_print("Libravatar plugin unloaded\n");
391 * Get the name of the plugin.
393 * @return The plugin's name, maybe translated.
395 const gchar *plugin_name(void)
397 return _("Libravatar");
401 * Get the description of the plugin.
403 * @return The plugin's description, maybe translated.
405 const gchar *plugin_desc(void)
407 return _("Display libravatar profiles' images for mail messages. More\n"
408 "info about libravatar at http://www.libravatar.org/. If you have\n"
409 "a gravatar.com profile but not a libravatar one, those will also\n"
410 "be retrieved (when redirections are allowed in plugin config).\n"
411 "Plugin config page is available from main window at:\n"
412 "/Configuration/Preferences/Plugins/Libravatar.\n\n"
413 "This plugin uses libcurl to retrieve images, so if you're behind a\n"
414 "proxy please refer to curl(1) manpage for details on 'http_proxy'\n"
415 "configuration. More details about this and others on README file.\n\n"
416 "Feedback to <ricardo@mones.org> is welcome.\n");
420 * Get the kind of plugin.
422 * @return The "GTK2" constant.
424 const gchar *plugin_type(void)
430 * Get the license acronym the plugin is released under.
432 * @return The "GPL3+" constant.
434 const gchar *plugin_licence(void)
440 * Get the version of the plugin.
442 * @return The current version string.
444 const gchar *plugin_version(void)
450 * Get the features implemented by the plugin.
452 * @return A constant PluginFeature structure with the features.
454 struct PluginFeature *plugin_provides(void)
456 static struct PluginFeature features[] =
457 { {PLUGIN_OTHER, N_("Libravatar")},
458 {PLUGIN_NOTHING, NULL}};