]> git.0d.be Git - empathy.git/blobdiff - libempathy-gtk/empathy-ui-utils.c
Merge branch 'irc-dialog-579800'
[empathy.git] / libempathy-gtk / empathy-ui-utils.c
index bc4d7597b58965c70693a345e1806dd9b52c75a0..9a249e65be2663beea79c4d37cfa9dbea5b05644 100644 (file)
@@ -22,6 +22,7 @@
  *          Richard Hult <richard@imendio.com>
  *          Martyn Russell <martyn@imendio.com>
  *          Xavier Claessens <xclaesse@gmail.com>
+ *          Jonny Lamb <jonny.lamb@collabora.co.uk>
  * 
  *          Part of this file is copied from GtkSourceView (gtksourceiter.c):
  *          Paolo Maggi
 #include <string.h>
 #include <X11/Xatom.h>
 #include <gdk/gdkx.h>
-#include <glib/gi18n.h>
+#include <glib/gi18n-lib.h>
 #include <gtk/gtk.h>
 #include <gio/gio.h>
-#include <glade/glade.h>
+#include <canberra-gtk.h>
 
 #include <libmissioncontrol/mc-profile.h>
 
 #include "empathy-ui-utils.h"
 #include "empathy-images.h"
+#include "empathy-conf.h"
 
 #define DEBUG_FLAG EMPATHY_DEBUG_OTHER
 #include <libempathy/empathy-debug.h>
+#include <libempathy/empathy-utils.h>
+#include <libempathy/empathy-dispatcher.h>
+#include <libempathy/empathy-idle.h>
+#include <libempathy/empathy-tp-file.h>
+
+#define SCHEMES "(https?|s?ftps?|nntp|news|javascript|about|ghelp|apt|telnet|"\
+               "file|webcal|mailto)"
+#define BODY "([^\\ \\n]+)"
+#define END_BODY "([^\\ \\n]*[^,;\?><()\\ \"\\.\\n])"
+#define URI_REGEX "("SCHEMES"://"END_BODY")" \
+                 "|((mailto:)?"BODY"@"BODY"\\."END_BODY")"\
+                 "|((www|ftp)\\."END_BODY")"
 
-struct SizeData {
-       gint     width;
-       gint     height;
-       gboolean preserve_aspect_ratio;
-};
-
-static GladeXML *
-get_glade_file (const gchar *filename,
-               const gchar *root,
-               const gchar *domain,
-               const gchar *first_required_widget,
-               va_list      args)
+void
+empathy_gtk_init (void)
 {
-       GladeXML   *gui;
-       const char *name;
-       GtkWidget **widget_ptr;
+       static gboolean initialized = FALSE;
 
-       DEBUG ("Loading glade file %s", filename);
+       if (initialized)
+               return;
 
-       gui = glade_xml_new (filename, root, domain);
+       empathy_init ();
+       gtk_icon_theme_append_search_path (gtk_icon_theme_get_default (),
+                                          PKGDATADIR G_DIR_SEPARATOR_S "icons");
 
-       if (!gui) {
-               g_warning ("Couldn't find necessary glade file '%s'", filename);
-       }
-
-       for (name = first_required_widget; name; name = va_arg (args, char *)) {
-               widget_ptr = va_arg (args, void *);
+       initialized = TRUE;
+}
 
-               *widget_ptr = glade_xml_get_widget (gui, name);
+GRegex *
+empathy_uri_regex_dup_singleton (void)
+{
+       static GRegex *uri_regex = NULL;
 
-               if (!*widget_ptr) {
-                       g_warning ("Glade file '%s' is missing widget '%s'.",
-                                  filename, name);
-                       continue;
-               }
+       /* We intentionally leak the regex so it's not recomputed */
+       if (!uri_regex) {
+               uri_regex = g_regex_new (URI_REGEX, 0, 0, NULL);
        }
 
-       return gui;
+       return g_regex_ref (uri_regex);
 }
 
-void
-empathy_glade_get_file_simple (const gchar *filename,
-                             const gchar *root,
-                             const gchar *domain,
-                             const gchar *first_required_widget, ...)
+static GtkBuilder *
+builder_get_file_valist (const gchar *filename,
+                        const gchar *first_object,
+                        va_list      args)
 {
-       va_list   args;
-       GladeXML *gui;
+       GtkBuilder  *gui;
+       const gchar *name;
+       GObject    **object_ptr;
+       GError      *error = NULL;
 
-       va_start (args, first_required_widget);
+       DEBUG ("Loading file %s", filename);
 
-       gui = get_glade_file (filename,
-                             root,
-                             domain,
-                             first_required_widget,
-                             args);
+       gui = gtk_builder_new ();
+       if (!gtk_builder_add_from_file (gui, filename, &error)) {
+               g_critical ("GtkBuilder Error: %s", error->message);
+               g_clear_error (&error);
+               g_object_unref (gui);
+               return NULL;
+       }
 
-       va_end (args);
+       for (name = first_object; name; name = va_arg (args, const gchar *)) {
+               object_ptr = va_arg (args, GObject**);
 
-       if (gui) {
-               g_object_unref (gui);
+               *object_ptr = gtk_builder_get_object (gui, name);
+
+               if (!*object_ptr) {
+                       g_warning ("File is missing object '%s'.", name);
+                       continue;
+               }
        }
+
+       return gui;
 }
 
-GladeXML *
-empathy_glade_get_file (const gchar *filename,
-                      const gchar *root,
-                      const gchar *domain,
-                      const gchar *first_required_widget, ...)
+GtkBuilder *
+empathy_builder_get_file (const gchar *filename,
+                         const gchar *first_object,
+                         ...)
 {
-       va_list   args;
-       GladeXML *gui;
-
-       va_start (args, first_required_widget);
-
-       gui = get_glade_file (filename,
-                             root,
-                             domain,
-                             first_required_widget,
-                             args);
+       GtkBuilder *gui;
+       va_list     args;
 
+       va_start (args, first_object);
+       gui = builder_get_file_valist (filename, first_object, args);
        va_end (args);
 
-       if (!gui) {
-               return NULL;
-       }
-
        return gui;
 }
 
 void
-empathy_glade_connect (GladeXML *gui,
-                     gpointer  user_data,
-                     gchar     *first_widget, ...)
+empathy_builder_connect (GtkBuilder *gui,
+                        gpointer    user_data,
+                        gchar      *first_object,
+                        ...)
 {
        va_list      args;
        const gchar *name;
        const gchar *signal;
-       GtkWidget   *widget;
-       gpointer    *callback;
-
-       va_start (args, first_widget);
+       GObject     *object;
+       GCallback    callback;
 
-       for (name = first_widget; name; name = va_arg (args, char *)) {
-               signal = va_arg (args, void *);
-               callback = va_arg (args, void *);
+       va_start (args, first_object);
+       for (name = first_object; name; name = va_arg (args, const gchar *)) {
+               signal = va_arg (args, const gchar *);
+               callback = va_arg (args, GCallback);
 
-               widget = glade_xml_get_widget (gui, name);
-               if (!widget) {
-                       g_warning ("Glade file is missing widget '%s', aborting",
-                                  name);
+               object = gtk_builder_get_object (gui, name);
+               if (!object) {
+                       g_warning ("File is missing object '%s'.", name);
                        continue;
                }
 
-               g_signal_connect (widget,
-                                 signal,
-                                 G_CALLBACK (callback),
-                                 user_data);
+               g_signal_connect (object, signal, callback, user_data);
        }
 
        va_end (args);
 }
 
-void
-empathy_glade_setup_size_group (GladeXML         *gui,
-                              GtkSizeGroupMode  mode,
-                              gchar            *first_widget, ...)
+GtkWidget *
+empathy_builder_unref_and_keep_widget (GtkBuilder *gui,
+                                      GtkWidget  *widget)
 {
-       va_list       args;
-       GtkWidget    *widget;
-       GtkSizeGroup *size_group;
-       const gchar  *name;
-
-       va_start (args, first_widget);
-
-       size_group = gtk_size_group_new (mode);
-
-       for (name = first_widget; name; name = va_arg (args, char *)) {
-               widget = glade_xml_get_widget (gui, name);
-               if (!widget) {
-                       g_warning ("Glade file is missing widget '%s'", name);
-                       continue;
-               }
+       /* On construction gui sinks the initial reference to widget. When gui
+        * is finalized it will drop its ref to widget. We take our own ref to
+        * prevent widget being finalised. The widget is forced to have a
+        * floating reference, like when it was initially unowned so that it can
+        * be used like any other GtkWidget. */
 
-               gtk_size_group_add_widget (size_group, widget);
-       }
-
-       g_object_unref (size_group);
+       g_object_ref (widget);
+       g_object_force_floating (G_OBJECT (widget));
+       g_object_unref (gui);
 
-       va_end (args);
+       return widget;
 }
 
 const gchar *
@@ -247,9 +232,19 @@ empathy_icon_name_for_contact (EmpathyContact *contact)
 GdkPixbuf *
 empathy_pixbuf_from_data (gchar *data,
                          gsize  data_size)
+{
+       return empathy_pixbuf_from_data_and_mime (data, data_size, NULL);
+}
+
+GdkPixbuf *
+empathy_pixbuf_from_data_and_mime (gchar  *data,
+                                  gsize   data_size,
+                                  gchar **mime_type)
 {
        GdkPixbufLoader *loader;
+       GdkPixbufFormat *format;
        GdkPixbuf       *pixbuf = NULL;
+       gchar          **mime_types;
        GError          *error = NULL;
 
        if (!data) {
@@ -260,28 +255,45 @@ empathy_pixbuf_from_data (gchar *data,
        if (!gdk_pixbuf_loader_write (loader, data, data_size, &error)) {
                DEBUG ("Failed to write to pixbuf loader: %s",
                        error ? error->message : "No error given");
-               g_clear_error (&error);
-               g_object_unref (loader);
-               return NULL;
+               goto out;
        }
        if (!gdk_pixbuf_loader_close (loader, &error)) {
                DEBUG ("Failed to close pixbuf loader: %s",
                        error ? error->message : "No error given");
-               g_clear_error (&error);
-               g_object_unref (loader);
-               return NULL;
+               goto out;
        }
 
        pixbuf = gdk_pixbuf_loader_get_pixbuf (loader);
        if (pixbuf) {
                g_object_ref (pixbuf);
+
+               if (mime_type != NULL) {
+                       format = gdk_pixbuf_loader_get_format (loader);
+                       mime_types = gdk_pixbuf_format_get_mime_types (format);
+
+                       *mime_type = g_strdup (*mime_types);
+                       if (mime_types[1] != NULL) {
+                               DEBUG ("Loader supports more than one mime "
+                                       "type! Picking the first one, %s",
+                                       *mime_type);
+                       }
+                       g_strfreev (mime_types);
+               }
        }
 
+out:
+       g_clear_error (&error);
        g_object_unref (loader);
 
        return pixbuf;
 }
 
+struct SizeData {
+       gint     width;
+       gint     height;
+       gboolean preserve_aspect_ratio;
+};
+
 static void
 pixbuf_from_avatar_size_prepared_cb (GdkPixbufLoader *loader,
                                     int              width,
@@ -486,7 +498,7 @@ empathy_pixbuf_scale_down_if_necessary (GdkPixbuf *pixbuf, gint max_size)
        width = gdk_pixbuf_get_width (pixbuf);
        height = gdk_pixbuf_get_height (pixbuf);
 
-       if (width > max_size || height > max_size) {
+       if (width > 0 && (width > max_size || height > max_size)) {
                factor = (gdouble) max_size / MAX (width, height);
 
                width = width * factor;
@@ -501,14 +513,12 @@ empathy_pixbuf_scale_down_if_necessary (GdkPixbuf *pixbuf, gint max_size)
 }
 
 GdkPixbuf *
-empathy_pixbuf_from_icon_name (const gchar *icon_name,
-                             GtkIconSize  icon_size)
+empathy_pixbuf_from_icon_name_sized (const gchar *icon_name,
+                                    gint size)
 {
-       GtkIconTheme  *theme;
-       GdkPixbuf     *pixbuf = NULL;
-       GError        *error = NULL;
-       gint           w, h;
-       gint           size = 48;
+       GtkIconTheme *theme;
+       GdkPixbuf *pixbuf;
+       GError *error = NULL;
 
        if (!icon_name) {
                return NULL;
@@ -516,10 +526,6 @@ empathy_pixbuf_from_icon_name (const gchar *icon_name,
 
        theme = gtk_icon_theme_get_default ();
 
-       if (gtk_icon_size_lookup (icon_size, &w, &h)) {
-               size = (w + h) / 2;
-       }
-
        pixbuf = gtk_icon_theme_load_icon (theme,
                                           icon_name,
                                           size,
@@ -533,6 +539,24 @@ empathy_pixbuf_from_icon_name (const gchar *icon_name,
        return pixbuf;
 }
 
+GdkPixbuf *
+empathy_pixbuf_from_icon_name (const gchar *icon_name,
+                              GtkIconSize  icon_size)
+{
+       gint  w, h;
+       gint  size = 48;
+
+       if (!icon_name) {
+               return NULL;
+       }
+
+       if (gtk_icon_size_lookup (icon_size, &w, &h)) {
+               size = (w + h) / 2;
+       }
+
+       return empathy_pixbuf_from_icon_name_sized (icon_name, size);
+}
+
 /* Stolen from GtkSourceView, hence the weird intendation. Please keep it like
  * that to make it easier to apply changes from the original code.
  */
@@ -1294,17 +1318,22 @@ empathy_get_toplevel_window (GtkWidget *widget)
 static gchar *
 fixup_url (const gchar *url)
 {
-       if (!g_str_has_prefix (url, "ghelp:") &&
-           !strstr (url, ":/") &&
-           !strstr (url, "@")) {
-               return g_strdup_printf ("http://%s", url);
-       } else {
+       if (g_str_has_prefix (url, "ghelp:") ||
+           g_str_has_prefix (url, "mailto:") ||
+           strstr (url, ":/")) {
                return NULL;
        }
+
+       if (strstr (url, "@")) {
+               return g_strdup_printf ("mailto:%s", url);
+       }
+
+       return g_strdup_printf ("http://%s", url);
 }
 
 void
-empathy_url_show (const char *url)
+empathy_url_show (GtkWidget *parent,
+                 const char *url)
 {
        gchar  *real_url;
        GError *error = NULL;
@@ -1314,10 +1343,9 @@ empathy_url_show (const char *url)
                url = real_url;
        }
 
-       /* FIXME: this does not work for multihead, we should use
-        * GdkAppLaunchContext or gtk_show_url, see bug #514396.
-        */
-       g_app_info_launch_default_for_uri (url, NULL, &error);
+       gtk_show_uri (gtk_widget_get_screen (parent), url,
+                     gtk_get_current_event_time (), &error);
+
        if (error) {
                GtkWidget *dialog;
 
@@ -1325,7 +1353,7 @@ empathy_url_show (const char *url)
                                                 GTK_MESSAGE_ERROR, GTK_BUTTONS_CLOSE, 
                                                 _("Unable to open URI"));
                gtk_message_dialog_format_secondary_text (GTK_MESSAGE_DIALOG (dialog),
-                                                         error->message);
+                                                         "%s", error->message);
 
                g_signal_connect (dialog, "response",
                                  G_CALLBACK (gtk_widget_destroy),
@@ -1343,7 +1371,7 @@ link_button_hook (GtkLinkButton *button,
                  const gchar *link,
                  gpointer user_data)
 {
-       empathy_url_show (link);
+       empathy_url_show (GTK_WIDGET (button), link);
 }
 
 GtkWidget *
@@ -1373,51 +1401,259 @@ empathy_toggle_button_set_state_quietly (GtkWidget *widget,
        g_signal_handlers_unblock_by_func (widget, callback, user_data);
 }
 
-GtkTextTag *
-empathy_text_buffer_tag_set (GtkTextBuffer *buffer,
-                            const gchar   *tag_name,
-                            const gchar   *first_property_name,
-                            ...)
+/* Sending files with the file chooser */
+
+static void
+file_manager_send_file_request_cb (EmpathyDispatchOperation *operation,
+                                  const GError *error, gpointer user_data)
 {
-       GtkTextTagTable *table;
-       GtkTextTag      *tag;
+       GFile *file = (GFile *)user_data;
+       EmpathyTpFile *tp_file;
 
-       g_return_val_if_fail (GTK_IS_TEXT_BUFFER (buffer), NULL);
-       g_return_val_if_fail (tag_name != NULL, NULL);
+       if (error != NULL) {
+               DEBUG ("Couldn't request channel: %s", error->message);
+               g_object_unref (file);
+               return;
+       }
 
-       table = gtk_text_buffer_get_tag_table (buffer);
-       tag = gtk_text_tag_table_lookup (table, tag_name);
+       DEBUG ("Starting to send file");
 
-       if (!tag) {
-               tag = gtk_text_tag_new (tag_name);
-               gtk_text_tag_table_add (table, tag);
-               g_object_unref (tag);
-       } else {
-               /* Clear the old values so that we don't affect the new theme. */
-               g_object_set (tag,
-                             "background-set", FALSE,
-                             "foreground-set", FALSE,
-                             "invisible-set", FALSE,
-                             "justification-set", FALSE,
-                             "paragraph-background-set", FALSE,
-                             "pixels-above-lines-set", FALSE,
-                             "pixels-below-lines-set", FALSE,
-                             "rise-set", FALSE,
-                             "scale-set", FALSE,
-                             "size-set", FALSE,
-                             "style-set", FALSE,
-                             "weight-set", FALSE,
-                             NULL);
-       }
-
-       if (first_property_name) {
-               va_list list;
-
-               va_start (list, first_property_name);
-               g_object_set_valist (G_OBJECT (tag), first_property_name, list);
-               va_end (list);
-       }
-
-       return tag;
+       tp_file = EMPATHY_TP_FILE (
+               empathy_dispatch_operation_get_channel_wrapper (operation));
+
+       empathy_tp_file_offer (tp_file, file, NULL);
+
+       g_object_unref (file);
+}
+
+static void
+file_manager_send_file_response_cb (GtkDialog      *widget,
+                                   gint            response_id,
+                                   EmpathyContact *contact)
+{
+       if (response_id == GTK_RESPONSE_OK) {
+               GSList *list;
+               GSList *l;
+
+               list = gtk_file_chooser_get_uris (GTK_FILE_CHOOSER (widget));
+
+               DEBUG ("File chooser selected files:");
+
+               for (l = list; l; l = l->next) {
+                       gchar            *uri;
+                       GFile            *gfile;
+                       GFileInfo        *info;
+                       GtkRecentManager *manager;
+                       gchar *filename;
+                       GTimeVal mtime;
+                       GError *error = NULL;
+
+                       uri = l->data;
+                       gfile = g_file_new_for_uri (uri);
+                       info = g_file_query_info (gfile,
+                               G_FILE_ATTRIBUTE_STANDARD_SIZE ","
+                               G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE ","
+                               G_FILE_ATTRIBUTE_TIME_MODIFIED,
+                               0, NULL, &error);
+
+                       if (error) {
+                               DEBUG ("Can't get info about the file: %s", error->message);
+                               g_clear_error (&error);
+                               g_object_unref (gfile);
+                               continue;
+                       }
+
+                       DEBUG ("\t%s", uri);
+                       filename = g_file_get_basename (gfile);
+                       g_file_info_get_modification_time (info, &mtime);
+
+                       empathy_dispatcher_send_file_to_contact (contact,
+                               filename, g_file_info_get_size (info), mtime.tv_sec,
+                               g_file_info_get_content_type (info),
+                               file_manager_send_file_request_cb, gfile);
+
+                       g_free (filename);
+                       g_object_unref (info);
+
+                       manager = gtk_recent_manager_get_default ();
+                       gtk_recent_manager_add_item (manager, uri);
+
+                       g_free (uri);
+               }
+               g_slist_free (list);
+       }
+
+       gtk_widget_destroy (GTK_WIDGET (widget));
+}
+
+void
+empathy_send_file_with_file_chooser (EmpathyContact *contact)
+{
+       GtkWidget               *widget;
+       GtkWidget               *button;
+
+       g_return_if_fail (EMPATHY_IS_CONTACT (contact));
+
+       DEBUG ("Creating selection file chooser");
+
+       widget = gtk_file_chooser_dialog_new (_("Select a file"),
+                                             NULL,
+                                             GTK_FILE_CHOOSER_ACTION_OPEN,
+                                             GTK_STOCK_CANCEL,
+                                             GTK_RESPONSE_CANCEL,
+                                             NULL);
+
+       /* send button */
+       button = gtk_button_new_with_mnemonic (_("_Send"));
+       gtk_button_set_image (GTK_BUTTON (button),
+               gtk_image_new_from_icon_name (EMPATHY_IMAGE_DOCUMENT_SEND,
+                                             GTK_ICON_SIZE_BUTTON));
+       gtk_widget_show (button);
+       gtk_dialog_add_action_widget (GTK_DIALOG (widget), button,
+                                     GTK_RESPONSE_OK);
+       GTK_WIDGET_SET_FLAGS (button, GTK_CAN_DEFAULT);
+       gtk_dialog_set_default_response (GTK_DIALOG (widget),
+                                        GTK_RESPONSE_OK);
+
+       g_signal_connect (widget, "response",
+                         G_CALLBACK (file_manager_send_file_response_cb),
+                         contact);
+
+       gtk_widget_show (widget);
+}
+
+typedef struct {
+       EmpathySound sound_id;
+       const char * event_ca_id;
+       const char * event_ca_description;
+       const char * gconf_key;
+} EmpathySoundEntry;
+
+/* NOTE: these entries MUST be in the same order than EmpathySound enum */
+static EmpathySoundEntry sound_entries[LAST_EMPATHY_SOUND] = {
+       { EMPATHY_SOUND_MESSAGE_INCOMING, "message-new-instant",
+         N_("Received an instant message"), EMPATHY_PREFS_SOUNDS_INCOMING_MESSAGE } ,
+       { EMPATHY_SOUND_MESSAGE_OUTGOING, "message-sent-instant",
+         N_("Sent an instant message"), EMPATHY_PREFS_SOUNDS_OUTGOING_MESSAGE } ,
+       { EMPATHY_SOUND_CONVERSATION_NEW, "message-new-instant",
+         N_("Incoming chat request"), EMPATHY_PREFS_SOUNDS_NEW_CONVERSATION },
+       { EMPATHY_SOUND_CONTACT_CONNECTED, "service-login",
+         N_("Contact connected"), EMPATHY_PREFS_SOUNDS_CONTACT_LOGIN },
+       { EMPATHY_SOUND_CONTACT_DISCONNECTED, "service-logout",
+         N_("Contact disconnected"), EMPATHY_PREFS_SOUNDS_CONTACT_LOGOUT },
+       { EMPATHY_SOUND_ACCOUNT_CONNECTED, "service-login",
+         N_("Connected to server"), EMPATHY_PREFS_SOUNDS_SERVICE_LOGIN },
+       { EMPATHY_SOUND_ACCOUNT_DISCONNECTED, "service-logout",
+         N_("Disconnected from server"), EMPATHY_PREFS_SOUNDS_SERVICE_LOGOUT },
+       { EMPATHY_SOUND_PHONE_INCOMING, "phone-incoming-call",
+         N_("Incoming voice call"), NULL },
+       { EMPATHY_SOUND_PHONE_OUTGOING, "phone-outgoing-calling",
+         N_("Outgoing voice call"), NULL },
+       { EMPATHY_SOUND_PHONE_HANGUP, "phone-hangup",
+         N_("Voice call ended"), NULL },
+};
+
+
+static gboolean
+empathy_sound_pref_is_enabled (const char *key)
+{
+       EmpathyConf *conf;
+       gboolean res;
+
+       conf = empathy_conf_get ();
+       res = FALSE;
+
+       empathy_conf_get_bool (conf, EMPATHY_PREFS_SOUNDS_ENABLED, &res);
+
+       if (!res) {
+               return FALSE;
+       }
+
+       if (!empathy_check_available_state ()) {
+               empathy_conf_get_bool (conf, EMPATHY_PREFS_SOUNDS_DISABLED_AWAY,
+                                      &res);
+               if (res) {
+                       return FALSE;
+               }
+       }
+
+       empathy_conf_get_bool (conf, key, &res);
+
+       return res;
+}
+
+void
+empathy_sound_stop (EmpathySound sound_id)
+{
+       EmpathySoundEntry *entry;
+
+       g_return_if_fail (sound_id < LAST_EMPATHY_SOUND);
+
+       entry = &(sound_entries[sound_id]);
+       g_return_if_fail (entry->sound_id == sound_id);
+
+       ca_context_cancel (ca_gtk_context_get (), entry->sound_id);
+}
+
+
+gboolean
+empathy_sound_play_full (GtkWidget *widget, EmpathySound sound_id,
+       ca_finish_callback_t callback, gpointer user_data)
+{
+       EmpathySoundEntry *entry;
+       gboolean should_play = TRUE;
+       ca_proplist *p = NULL;
+       ca_context *c;
+
+       g_return_val_if_fail (sound_id < LAST_EMPATHY_SOUND, FALSE);
+
+       entry = &(sound_entries[sound_id]);
+       g_return_val_if_fail (entry->sound_id == sound_id, FALSE);
+
+       if (entry->gconf_key != NULL) {
+               should_play = empathy_sound_pref_is_enabled (entry->gconf_key);
+       }
+
+       if (!should_play)
+               return FALSE;
+
+       c = ca_gtk_context_get ();
+       ca_context_cancel (c, entry->sound_id);
+
+       DEBUG ("Play sound \"%s\" (%s)",
+              entry->event_ca_id,
+              entry->event_ca_description);
+
+       if (ca_proplist_create(&p) < 0)
+               goto failed;
+
+       if (ca_proplist_sets (p, CA_PROP_EVENT_ID, entry->event_ca_id) < 0)
+               goto failed;
+
+       if (ca_proplist_sets (p, CA_PROP_EVENT_DESCRIPTION,
+                       gettext (entry->event_ca_id)) < 0)
+               goto failed;
+
+       if (ca_gtk_proplist_set_for_widget (p, widget) < 0)
+               goto failed;
+
+       ca_context_play_full (ca_gtk_context_get (), entry->sound_id,
+               p, callback, user_data);
+
+       ca_proplist_destroy (p);
+
+       return TRUE;
+
+failed:
+       if (p != NULL)
+               ca_proplist_destroy (p);
+
+       return FALSE;
+}
+
+void
+empathy_sound_play (GtkWidget *widget, EmpathySound sound_id)
+{
+       empathy_sound_play_full (widget, sound_id, NULL, NULL);
 }