2 * Copyright (C) 2005-2007 Imendio AB
3 * Copyright (C) 2007-2008, 2010 Collabora Ltd.
5 * This program is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU General Public License as
7 * published by the Free Software Foundation; either version 2 of the
8 * License, or (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 GNU
13 * General Public License for more details.
15 * You should have received a copy of the GNU General Public
16 * License along with this program; if not, write to the
17 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
18 * Boston, MA 02110-1301 USA
20 * Authors: Mikael Hallendal <micke@imendio.com>
21 * Martyn Russell <martyn@imendio.com>
22 * Xavier Claessens <xclaesse@gmail.com>
23 * Philip Withnall <philip.withnall@collabora.co.uk>
25 * Based off EmpathyContactListStore.
33 #include <glib/gi18n-lib.h>
36 #include <telepathy-glib/util.h>
38 #include <folks/folks.h>
39 #include <folks/folks-telepathy.h>
41 #include <libempathy/empathy-utils.h>
43 #include "empathy-persona-store.h"
44 #include "empathy-gtk-enum-types.h"
45 #include "empathy-ui-utils.h"
47 #define DEBUG_FLAG EMPATHY_DEBUG_CONTACT
48 #include <libempathy/empathy-debug.h>
50 /* Active users are those which have recently changed state
51 * (e.g. online, offline or from normal to a busy state). */
53 /* Time in seconds user is shown as active */
54 #define ACTIVE_USER_SHOW_TIME 7
56 /* Time in seconds after connecting which we wait before active users are
58 #define ACTIVE_USER_WAIT_TO_ENABLE_TIME 5
60 static void add_persona (EmpathyPersonaStore *self,
61 FolksPersona *persona);
62 static GtkTreePath * find_persona (EmpathyPersonaStore *self,
63 FolksPersona *persona);
64 static void update_persona (EmpathyPersonaStore *self,
65 FolksPersona *persona);
66 static void remove_persona (EmpathyPersonaStore *self,
67 FolksPersona *persona);
69 #define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyPersonaStore)
73 FolksIndividual *individual; /* owned */
74 GHashTable *personas; /* owned Persona -> owned GtkTreeRowReference */
76 gboolean show_avatars;
77 gboolean show_protocols;
79 EmpathyPersonaStoreSort sort_criterion;
84 GHashTable *status_icons; /* owned icon name -> owned GdkPixbuf */
85 } EmpathyPersonaStorePriv;
95 G_DEFINE_TYPE (EmpathyPersonaStore, empathy_persona_store, GTK_TYPE_LIST_STORE);
98 inhibit_active_cb (EmpathyPersonaStore *store)
100 EmpathyPersonaStorePriv *priv;
102 priv = GET_PRIV (store);
104 priv->show_active = TRUE;
105 priv->inhibit_active = 0;
111 EmpathyPersonaStore *store;
112 FolksPersona *persona;
117 static void persona_active_free (ShowActiveData *data);
120 persona_active_invalidated (ShowActiveData *data,
123 /* Remove the timeout and free the struct, since the persona or persona
124 * store has disappeared. */
125 g_source_remove (data->timeout);
127 if (old_object == (GObject *) data->store)
129 else if (old_object == (GObject *) data->persona)
130 data->persona = NULL;
132 g_assert_not_reached ();
134 persona_active_free (data);
137 static ShowActiveData *
138 persona_active_new (EmpathyPersonaStore *self,
139 FolksPersona *persona,
142 ShowActiveData *data;
144 DEBUG ("Contact:'%s' now active, and %s be removed",
145 folks_alias_details_get_alias (FOLKS_ALIAS_DETAILS (persona)),
146 remove_ ? "WILL" : "WILL NOT");
148 data = g_slice_new0 (ShowActiveData);
150 /* We don't actually want to force either the PersonaStore or the
151 * Persona to stay alive, since the user could quit Empathy or disable
152 * the account before the persona_active timeout is fired. */
153 g_object_weak_ref (G_OBJECT (self),
154 (GWeakNotify) persona_active_invalidated, data);
155 g_object_weak_ref (G_OBJECT (persona),
156 (GWeakNotify) persona_active_invalidated, data);
159 data->persona = persona;
160 data->remove = remove_;
166 persona_active_free (ShowActiveData *data)
168 if (data->store != NULL)
170 g_object_weak_unref (G_OBJECT (data->store),
171 (GWeakNotify) persona_active_invalidated, data);
174 if (data->persona != NULL)
176 g_object_weak_unref (G_OBJECT (data->persona),
177 (GWeakNotify) persona_active_invalidated, data);
180 g_slice_free (ShowActiveData, data);
184 persona_set_active (EmpathyPersonaStore *self,
185 FolksPersona *persona,
187 gboolean set_changed)
192 path = find_persona (self, persona);
196 gtk_tree_model_get_iter (GTK_TREE_MODEL (self), &iter, path);
197 gtk_list_store_set (GTK_LIST_STORE (self), &iter,
198 EMPATHY_PERSONA_STORE_COL_IS_ACTIVE, active,
201 DEBUG ("Set item %s", active ? "active" : "inactive");
204 gtk_tree_model_row_changed (GTK_TREE_MODEL (self), path, &iter);
206 gtk_tree_path_free (path);
210 persona_active_cb (ShowActiveData *data)
213 folks_alias_details_get_alias (FOLKS_ALIAS_DETAILS (data->persona));
217 DEBUG ("Contact:'%s' active timeout, removing item", alias);
218 remove_persona (data->store, data->persona);
221 DEBUG ("Contact:'%s' no longer active", alias);
222 persona_set_active (data->store, data->persona, FALSE, TRUE);
224 persona_active_free (data);
230 persona_updated_cb (FolksPersona *persona,
232 EmpathyPersonaStore *self)
234 DEBUG ("Contact:'%s' updated, checking roster is in sync...",
235 folks_alias_details_get_alias (FOLKS_ALIAS_DETAILS (persona)));
237 update_persona (self, persona);
241 add_persona_and_connect (EmpathyPersonaStore *self,
242 FolksPersona *persona)
244 /* We don't want any non-Telepathy personas */
245 if (!TPF_IS_PERSONA (persona))
248 g_signal_connect (persona, "notify::presence",
249 (GCallback) persona_updated_cb, self);
250 g_signal_connect (persona, "notify::presence-message",
251 (GCallback) persona_updated_cb, self);
252 g_signal_connect (persona, "notify::alias",
253 (GCallback) persona_updated_cb, self);
254 g_signal_connect (persona, "notify::avatar",
255 (GCallback) persona_updated_cb, self);
257 add_persona (self, persona);
261 remove_persona_and_disconnect (EmpathyPersonaStore *self,
262 FolksPersona *persona)
264 if (!TPF_IS_PERSONA (persona))
267 g_signal_handlers_disconnect_by_func (persona,
268 (GCallback) persona_updated_cb, self);
270 remove_persona (self, persona);
274 add_persona (EmpathyPersonaStore *self,
275 FolksPersona *persona)
277 EmpathyPersonaStorePriv *priv;
280 FolksPersonaStore *store;
281 TpContact *tp_contact;
282 EmpathyContact *contact;
285 if (!TPF_IS_PERSONA (persona))
288 priv = GET_PRIV (self);
290 alias = folks_alias_details_get_alias (FOLKS_ALIAS_DETAILS (persona));
291 if (EMP_STR_EMPTY (alias))
294 tp_contact = tpf_persona_get_contact (TPF_PERSONA (persona));
295 if (tp_contact == NULL)
298 contact = empathy_contact_dup_from_tp_contact (tp_contact);
299 store = folks_persona_get_store (persona);
301 gtk_list_store_insert_with_values (GTK_LIST_STORE (self), &iter, 0,
302 EMPATHY_PERSONA_STORE_COL_NAME, alias,
303 EMPATHY_PERSONA_STORE_COL_ACCOUNT_NAME,
304 folks_persona_store_get_display_name (store),
305 EMPATHY_PERSONA_STORE_COL_DISPLAY_ID,
306 folks_persona_get_display_id (persona),
307 EMPATHY_PERSONA_STORE_COL_PERSONA, persona,
308 EMPATHY_PERSONA_STORE_COL_CAN_AUDIO_CALL,
309 empathy_contact_get_capabilities (contact) &
310 EMPATHY_CAPABILITIES_AUDIO,
311 EMPATHY_PERSONA_STORE_COL_CAN_VIDEO_CALL,
312 empathy_contact_get_capabilities (contact) &
313 EMPATHY_CAPABILITIES_VIDEO,
316 g_object_unref (contact);
318 path = gtk_tree_model_get_path (GTK_TREE_MODEL (self), &iter);
319 g_hash_table_replace (priv->personas, g_object_ref (persona),
320 gtk_tree_row_reference_new (GTK_TREE_MODEL (self), path));
321 gtk_tree_path_free (path);
323 update_persona (self, persona);
327 remove_persona (EmpathyPersonaStore *self,
328 FolksPersona *persona)
330 EmpathyPersonaStorePriv *priv;
334 if (!TPF_IS_PERSONA (persona))
337 priv = GET_PRIV (self);
339 path = find_persona (self, persona);
343 g_hash_table_remove (priv->personas, persona);
345 gtk_tree_model_get_iter (GTK_TREE_MODEL (self), &iter, path);
346 gtk_list_store_remove (GTK_LIST_STORE (self), &iter);
347 gtk_tree_path_free (path);
351 get_persona_status_icon (EmpathyPersonaStore *self,
352 FolksPersona *persona)
354 EmpathyPersonaStorePriv *priv = GET_PRIV (self);
355 TpContact *tp_contact;
356 EmpathyContact *contact;
357 const gchar *protocol_name = NULL;
358 gchar *icon_name = NULL;
359 GdkPixbuf *pixbuf_status = NULL;
360 const gchar *status_icon_name = NULL;
362 tp_contact = tpf_persona_get_contact (TPF_PERSONA (persona));
363 if (tp_contact == NULL)
366 contact = empathy_contact_dup_from_tp_contact (tp_contact);
368 status_icon_name = empathy_icon_name_for_contact (contact);
369 if (status_icon_name == NULL)
371 g_object_unref (contact);
375 if (priv->show_protocols)
377 protocol_name = empathy_protocol_name_for_contact (contact);
378 icon_name = g_strdup_printf ("%s-%s", status_icon_name, protocol_name);
382 icon_name = g_strdup_printf ("%s", status_icon_name);
385 pixbuf_status = g_hash_table_lookup (priv->status_icons, icon_name);
387 if (pixbuf_status == NULL)
389 pixbuf_status = empathy_pixbuf_contact_status_icon_with_icon_name (
390 contact, status_icon_name, priv->show_protocols);
392 if (pixbuf_status != NULL)
394 g_hash_table_insert (priv->status_icons, g_strdup (icon_name),
399 g_object_unref (contact);
402 return pixbuf_status;
406 update_persona (EmpathyPersonaStore *self,
407 FolksPersona *persona)
409 EmpathyPersonaStorePriv *priv = GET_PRIV (self);
411 gboolean do_set_active = FALSE;
412 gboolean do_set_refresh = FALSE;
415 path = find_persona (self, persona);
416 alias = folks_alias_details_get_alias (FOLKS_ALIAS_DETAILS (persona));
420 DEBUG ("Contact:'%s' in list:NO, should be:YES", alias);
422 add_persona (self, persona);
424 if (priv->show_active)
426 do_set_active = TRUE;
427 DEBUG ("Set active (contact added)");
432 FolksPersonaStore *store;
433 TpContact *tp_contact;
434 EmpathyContact *contact;
436 GdkPixbuf *pixbuf_avatar = NULL;
437 GdkPixbuf *pixbuf_status;
438 gboolean now_online = FALSE;
439 gboolean was_online = TRUE;
441 DEBUG ("Contact:'%s' in list:YES, should be:YES", alias);
443 gtk_tree_model_get_iter (GTK_TREE_MODEL (self), &iter, path);
444 gtk_tree_path_free (path);
446 /* Get online state now. */
447 now_online = folks_presence_details_is_online (
448 FOLKS_PRESENCE_DETAILS (persona));
450 /* Get online state before. */
451 gtk_tree_model_get (GTK_TREE_MODEL (self), &iter,
452 EMPATHY_PERSONA_STORE_COL_IS_ONLINE, &was_online,
455 /* Is this really an update or an online/offline. */
456 if (priv->show_active)
458 if (was_online != now_online)
460 do_set_active = TRUE;
461 do_set_refresh = TRUE;
463 DEBUG ("Set active (contact updated %s)",
464 was_online ? "online -> offline" : "offline -> online");
468 /* Was TRUE for presence updates. */
469 /* do_set_active = FALSE; */
470 do_set_refresh = TRUE;
471 DEBUG ("Set active (contact updated)");
475 /* We still need to use EmpathyContact for the capabilities stuff */
476 tp_contact = tpf_persona_get_contact (TPF_PERSONA (persona));
477 if (tp_contact != NULL)
479 contact = empathy_contact_dup_from_tp_contact (tp_contact);
480 store = folks_persona_get_store (persona);
482 pixbuf_avatar = empathy_pixbuf_avatar_from_contact_scaled (contact,
484 pixbuf_status = get_persona_status_icon (self, persona);
486 gtk_list_store_set (GTK_LIST_STORE (self), &iter,
487 EMPATHY_PERSONA_STORE_COL_ICON_STATUS, pixbuf_status,
488 EMPATHY_PERSONA_STORE_COL_PIXBUF_AVATAR, pixbuf_avatar,
489 EMPATHY_PERSONA_STORE_COL_PIXBUF_AVATAR_VISIBLE,
491 EMPATHY_PERSONA_STORE_COL_NAME, alias,
492 EMPATHY_PERSONA_STORE_COL_ACCOUNT_NAME,
493 folks_persona_store_get_display_name (store),
494 EMPATHY_PERSONA_STORE_COL_DISPLAY_ID,
495 folks_persona_get_display_id (persona),
496 EMPATHY_PERSONA_STORE_COL_PRESENCE_TYPE,
497 folks_presence_details_get_presence_type (
498 FOLKS_PRESENCE_DETAILS (persona)),
499 EMPATHY_PERSONA_STORE_COL_STATUS,
500 folks_presence_details_get_presence_message (
501 FOLKS_PRESENCE_DETAILS (persona)),
502 EMPATHY_PERSONA_STORE_COL_IS_ONLINE, now_online,
503 EMPATHY_PERSONA_STORE_COL_CAN_AUDIO_CALL,
504 empathy_contact_get_capabilities (contact) &
505 EMPATHY_CAPABILITIES_AUDIO,
506 EMPATHY_PERSONA_STORE_COL_CAN_VIDEO_CALL,
507 empathy_contact_get_capabilities (contact) &
508 EMPATHY_CAPABILITIES_VIDEO,
511 g_object_unref (contact);
515 g_object_unref (pixbuf_avatar);
518 if (priv->show_active && do_set_active)
520 persona_set_active (self, persona, do_set_active, do_set_refresh);
524 ShowActiveData *data;
526 data = persona_active_new (self, persona, FALSE);
527 data->timeout = g_timeout_add_seconds (ACTIVE_USER_SHOW_TIME,
528 (GSourceFunc) persona_active_cb,
533 /* FIXME: when someone goes online then offline quickly, the
534 * first timeout sets the user to be inactive and the second
535 * timeout removes the user from the contact list, really we
536 * should remove the first timeout.
541 individual_personas_changed_cb (GObject *object,
544 EmpathyPersonaStore *self)
548 /* One of the personas' row references might hold the last reference to the
549 * PersonaStore, so we need to keep a reference ourselves so we don't get
553 /* Remove the old personas. */
554 iter = gee_iterable_iterator (GEE_ITERABLE (removed));
555 while (gee_iterator_next (iter))
557 FolksPersona *persona = gee_iterator_get (iter);
558 remove_persona_and_disconnect (self, persona);
559 g_clear_object (&persona);
561 g_clear_object (&iter);
563 /* Add each of the new personas to the tree model */
564 iter = gee_iterable_iterator (GEE_ITERABLE (added));
565 while (gee_iterator_next (iter))
567 FolksPersona *persona = gee_iterator_get (iter);
568 add_persona_and_connect (self, persona);
569 g_clear_object (&persona);
571 g_clear_object (&iter);
573 g_object_unref (self);
577 sort_personas (FolksPersona *persona_a,
578 FolksPersona *persona_b)
580 EmpathyContact *contact;
581 TpAccount *account_a, *account_b;
582 TpContact *tp_contact_a, *tp_contact_b;
585 g_return_val_if_fail (persona_a != NULL || persona_b != NULL, 0);
588 ret_val = g_utf8_collate (
589 folks_alias_details_get_alias (FOLKS_ALIAS_DETAILS (persona_a)),
590 folks_alias_details_get_alias (FOLKS_ALIAS_DETAILS (persona_b)));
596 ret_val = g_utf8_collate (folks_persona_get_display_id (persona_a),
597 folks_persona_get_display_id (persona_b));
602 tp_contact_a = tpf_persona_get_contact (TPF_PERSONA (persona_a));
603 tp_contact_b = tpf_persona_get_contact (TPF_PERSONA (persona_b));
605 /* handle the case that one or more of these personas are from the cache */
606 if (tp_contact_a == NULL || tp_contact_b == NULL)
608 ret_val = (tp_contact_a != NULL ? 1 : -1);
612 contact = empathy_contact_dup_from_tp_contact (tp_contact_a);
613 account_a = empathy_contact_get_account (contact);
614 g_object_unref (contact);
616 contact = empathy_contact_dup_from_tp_contact (tp_contact_b);
617 account_b = empathy_contact_get_account (contact);
618 g_object_unref (contact);
621 ret_val = strcmp (tp_account_get_protocol (account_a),
622 tp_account_get_protocol (account_b));
628 ret_val = strcmp (tp_proxy_get_object_path (account_a),
629 tp_proxy_get_object_path (account_b));
636 state_sort_func (GtkTreeModel *model,
642 gchar *name_a, *name_b;
643 FolksPersona *persona_a, *persona_b;
645 gtk_tree_model_get (model, iter_a,
646 EMPATHY_PERSONA_STORE_COL_NAME, &name_a,
647 EMPATHY_PERSONA_STORE_COL_PERSONA, &persona_a,
649 gtk_tree_model_get (model, iter_b,
650 EMPATHY_PERSONA_STORE_COL_NAME, &name_b,
651 EMPATHY_PERSONA_STORE_COL_PERSONA, &persona_b,
654 if (persona_a == NULL || persona_b == NULL) {
659 /* If we managed to get this far, we can start looking at
662 ret_val = -tp_connection_presence_type_cmp_availability (
663 folks_presence_details_get_presence_type (
664 FOLKS_PRESENCE_DETAILS (persona_a)),
665 folks_presence_details_get_presence_type (
666 FOLKS_PRESENCE_DETAILS (persona_b)));
669 /* Fallback: compare by name et al. */
670 ret_val = sort_personas (persona_a, persona_b);
677 tp_clear_object (&persona_a);
678 tp_clear_object (&persona_b);
684 name_sort_func (GtkTreeModel *model,
689 gchar *name_a, *name_b;
690 FolksPersona *persona_a, *persona_b;
693 gtk_tree_model_get (model, iter_a,
694 EMPATHY_PERSONA_STORE_COL_NAME, &name_a,
695 EMPATHY_PERSONA_STORE_COL_PERSONA, &persona_a,
697 gtk_tree_model_get (model, iter_b,
698 EMPATHY_PERSONA_STORE_COL_NAME, &name_b,
699 EMPATHY_PERSONA_STORE_COL_PERSONA, &persona_b,
702 if (persona_a == NULL || persona_b == NULL)
705 ret_val = sort_personas (persona_a, persona_b);
707 tp_clear_object (&persona_a);
708 tp_clear_object (&persona_b);
714 find_persona (EmpathyPersonaStore *self,
715 FolksPersona *persona)
717 EmpathyPersonaStorePriv *priv = GET_PRIV (self);
718 GtkTreeRowReference *row;
720 row = g_hash_table_lookup (priv->personas, persona);
724 return gtk_tree_row_reference_get_path (row);
728 update_list_mode_foreach (GtkTreeModel *model,
731 EmpathyPersonaStore *self)
733 EmpathyPersonaStorePriv *priv;
734 FolksPersona *persona;
735 GdkPixbuf *pixbuf_status;
737 priv = GET_PRIV (self);
739 gtk_tree_model_get (model, iter,
740 EMPATHY_PERSONA_STORE_COL_PERSONA, &persona,
746 /* get icon from hash_table */
747 pixbuf_status = get_persona_status_icon (self, persona);
749 gtk_list_store_set (GTK_LIST_STORE (self), iter,
750 EMPATHY_PERSONA_STORE_COL_ICON_STATUS, pixbuf_status,
751 EMPATHY_PERSONA_STORE_COL_PIXBUF_AVATAR_VISIBLE, priv->show_avatars,
754 tp_clear_object (&persona);
760 set_up (EmpathyPersonaStore *self)
762 EmpathyPersonaStorePriv *priv;
764 GDK_TYPE_PIXBUF, /* Status pixbuf */
765 GDK_TYPE_PIXBUF, /* Avatar pixbuf */
766 G_TYPE_BOOLEAN, /* Avatar pixbuf visible */
767 G_TYPE_STRING, /* Name */
768 G_TYPE_STRING, /* Account name */
769 G_TYPE_STRING, /* Display ID */
770 G_TYPE_UINT, /* Presence type */
771 G_TYPE_STRING, /* Status string */
772 FOLKS_TYPE_PERSONA, /* Persona */
773 G_TYPE_BOOLEAN, /* Is active */
774 G_TYPE_BOOLEAN, /* Is online */
775 G_TYPE_BOOLEAN, /* Can make audio calls */
776 G_TYPE_BOOLEAN, /* Can make video calls */
779 priv = GET_PRIV (self);
781 gtk_list_store_set_column_types (GTK_LIST_STORE (self),
782 EMPATHY_PERSONA_STORE_COL_COUNT, types);
785 gtk_tree_sortable_set_sort_func (GTK_TREE_SORTABLE (self),
786 EMPATHY_PERSONA_STORE_COL_NAME, name_sort_func, self, NULL);
787 gtk_tree_sortable_set_sort_func (GTK_TREE_SORTABLE (self),
788 EMPATHY_PERSONA_STORE_COL_STATUS, state_sort_func, self, NULL);
790 priv->sort_criterion = EMPATHY_PERSONA_STORE_SORT_NAME;
791 empathy_persona_store_set_sort_criterion (self, priv->sort_criterion);
795 empathy_persona_store_init (EmpathyPersonaStore *self)
797 EmpathyPersonaStorePriv *priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
798 EMPATHY_TYPE_PERSONA_STORE, EmpathyPersonaStorePriv);
802 priv->show_avatars = TRUE;
803 priv->show_protocols = FALSE;
804 priv->inhibit_active = g_timeout_add_seconds (ACTIVE_USER_WAIT_TO_ENABLE_TIME,
805 (GSourceFunc) inhibit_active_cb, self);
807 priv->status_icons = g_hash_table_new_full (g_str_hash, g_str_equal, g_free,
809 priv->personas = g_hash_table_new_full (g_direct_hash, g_direct_equal,
810 g_object_unref, (GDestroyNotify) gtk_tree_row_reference_free);
816 get_property (GObject *object,
821 EmpathyPersonaStorePriv *priv = GET_PRIV (object);
825 case PROP_INDIVIDUAL:
826 g_value_set_object (value, priv->individual);
828 case PROP_SHOW_AVATARS:
829 g_value_set_boolean (value, priv->show_avatars);
831 case PROP_SHOW_PROTOCOLS:
832 g_value_set_boolean (value, priv->show_protocols);
834 case PROP_SORT_CRITERION:
835 g_value_set_enum (value, priv->sort_criterion);
838 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
844 set_property (GObject *object,
849 EmpathyPersonaStore *self = EMPATHY_PERSONA_STORE (object);
853 case PROP_INDIVIDUAL:
854 empathy_persona_store_set_individual (self, g_value_get_object (value));
856 case PROP_SHOW_AVATARS:
857 empathy_persona_store_set_show_avatars (self,
858 g_value_get_boolean (value));
860 case PROP_SHOW_PROTOCOLS:
861 empathy_persona_store_set_show_protocols (self,
862 g_value_get_boolean (value));
864 case PROP_SORT_CRITERION:
865 empathy_persona_store_set_sort_criterion (self,
866 g_value_get_enum (value));
869 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
875 dispose (GObject *object)
877 EmpathyPersonaStorePriv *priv = GET_PRIV (object);
879 empathy_persona_store_set_individual (EMPATHY_PERSONA_STORE (object), NULL);
881 if (priv->inhibit_active != 0)
883 g_source_remove (priv->inhibit_active);
884 priv->inhibit_active = 0;
887 if (priv->setup_idle_id != 0)
889 g_source_remove (priv->setup_idle_id);
890 priv->setup_idle_id = 0;
893 G_OBJECT_CLASS (empathy_persona_store_parent_class)->dispose (object);
897 finalize (GObject *object)
899 EmpathyPersonaStorePriv *priv = GET_PRIV (object);
901 g_hash_table_unref (priv->status_icons);
902 g_hash_table_unref (priv->personas);
904 G_OBJECT_CLASS (empathy_persona_store_parent_class)->finalize (object);
908 empathy_persona_store_class_init (EmpathyPersonaStoreClass *klass)
910 GObjectClass *object_class = G_OBJECT_CLASS (klass);
912 object_class->get_property = get_property;
913 object_class->set_property = set_property;
914 object_class->dispose = dispose;
915 object_class->finalize = finalize;
918 * EmpathyPersonaStore:individual:
920 * The #FolksIndividual whose personas should be listed by the store. This
921 * may be %NULL, which results in an empty store.
923 g_object_class_install_property (object_class, PROP_INDIVIDUAL,
924 g_param_spec_object ("individual",
926 "The FolksIndividual whose Personas should be listed by the store.",
927 FOLKS_TYPE_INDIVIDUAL,
928 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
931 * EmpathyPersonaStore:show-avatars:
933 * Whether the store should display avatars for personas. This is a property
934 * of the store rather than of #EmpathyPersonaView for efficiency reasons.
936 g_object_class_install_property (object_class, PROP_SHOW_AVATARS,
937 g_param_spec_boolean ("show-avatars",
939 "Whether the store should display avatars for personas.",
941 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
944 * EmpathyPersonaStore:show-protocols:
946 * Whether the store should display protocol icons for personas. This is a
947 * property of the store rather than of #EmpathyPersonaView because it is
948 * closely tied in with #EmpathyPersonaStore:show-avatars.
950 g_object_class_install_property (object_class, PROP_SHOW_PROTOCOLS,
951 g_param_spec_boolean ("show-protocols",
953 "Whether the store should display protocol icons for personas.",
955 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
958 * EmpathyPersonaStore:sort-criterion:
960 * The criterion used to sort the personas in the store.
962 g_object_class_install_property (object_class, PROP_SORT_CRITERION,
963 g_param_spec_enum ("sort-criterion",
965 "The sort criterion to use for sorting the persona list",
966 EMPATHY_TYPE_PERSONA_STORE_SORT,
967 EMPATHY_PERSONA_STORE_SORT_NAME,
968 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
970 g_type_class_add_private (object_class, sizeof (EmpathyPersonaStorePriv));
974 * empathy_persona_store_new:
975 * @individual: the #FolksIndividual whose personas should be used in the store,
978 * Create a new #EmpathyPersonaStore with the personas from the given
981 * Return value: a new #EmpathyPersonaStore
983 EmpathyPersonaStore *
984 empathy_persona_store_new (FolksIndividual *individual)
986 g_return_val_if_fail (individual == NULL || FOLKS_IS_INDIVIDUAL (individual),
989 return g_object_new (EMPATHY_TYPE_PERSONA_STORE,
990 "individual", individual, NULL);
994 * empathy_persona_store_get_individual:
995 * @self: an #EmpathyPersonaStore
997 * Get the value of #EmpathyPersonaStore:individual.
999 * Return value: the individual being displayed by the store, or %NULL
1002 empathy_persona_store_get_individual (EmpathyPersonaStore *self)
1004 g_return_val_if_fail (EMPATHY_IS_PERSONA_STORE (self), NULL);
1006 return GET_PRIV (self)->individual;
1010 * empathy_persona_store_set_individual:
1011 * @self: an #EmpathyPersonaStore
1012 * @individual: the new individual to display in the store, or %NULL
1014 * Set #EmpathyPersonaStore:individual to @individual, replacing the personas
1015 * which were in the store with the personas belonging to @individual, or with
1016 * nothing if @individual is %NULL.
1019 empathy_persona_store_set_individual (EmpathyPersonaStore *self,
1020 FolksIndividual *individual)
1022 EmpathyPersonaStorePriv *priv;
1024 g_return_if_fail (EMPATHY_IS_PERSONA_STORE (self));
1025 g_return_if_fail (individual == NULL || FOLKS_IS_INDIVIDUAL (individual));
1027 priv = GET_PRIV (self);
1029 /* Remove the old individual */
1030 if (priv->individual != NULL)
1035 g_signal_handlers_disconnect_by_func (priv->individual,
1036 (GCallback) individual_personas_changed_cb, self);
1038 /* Disconnect from and remove all personas belonging to this individual */
1039 personas = folks_individual_get_personas (priv->individual);
1040 iter = gee_iterable_iterator (GEE_ITERABLE (personas));
1041 while (gee_iterator_next (iter))
1043 FolksPersona *persona = gee_iterator_get (iter);
1044 remove_persona_and_disconnect (self, persona);
1045 g_clear_object (&persona);
1047 g_clear_object (&iter);
1049 g_object_unref (priv->individual);
1052 priv->individual = individual;
1054 /* Add the new individual */
1055 if (individual != NULL)
1060 g_object_ref (individual);
1062 g_signal_connect (individual, "personas-changed",
1063 (GCallback) individual_personas_changed_cb, self);
1065 /* Add pre-existing Personas */
1067 personas = folks_individual_get_personas (individual);
1068 iter = gee_iterable_iterator (GEE_ITERABLE (personas));
1069 while (gee_iterator_next (iter))
1071 FolksPersona *persona = gee_iterator_get (iter);
1072 add_persona_and_connect (self, persona);
1073 g_clear_object (&persona);
1075 g_clear_object (&iter);
1078 g_object_notify (G_OBJECT (self), "individual");
1082 * empathy_persona_store_get_show_avatars:
1083 * @self: an #EmpathyPersonaStore
1085 * Get the value of #EmpathyPersonaStore:show-avatars.
1087 * Return value: %TRUE if avatars are made available by the store, %FALSE
1091 empathy_persona_store_get_show_avatars (EmpathyPersonaStore *self)
1093 g_return_val_if_fail (EMPATHY_IS_PERSONA_STORE (self), TRUE);
1095 return GET_PRIV (self)->show_avatars;
1099 * empathy_persona_store_set_show_avatars:
1100 * @self: an #EmpathyPersonaStore
1101 * @show_avatars: %TRUE to make avatars available through the store, %FALSE
1104 * Set #EmpathyPersonaStore:show-avatars to @show_avatars.
1107 empathy_persona_store_set_show_avatars (EmpathyPersonaStore *self,
1108 gboolean show_avatars)
1110 EmpathyPersonaStorePriv *priv;
1112 g_return_if_fail (EMPATHY_IS_PERSONA_STORE (self));
1114 priv = GET_PRIV (self);
1115 priv->show_avatars = show_avatars;
1117 gtk_tree_model_foreach (GTK_TREE_MODEL (self),
1118 (GtkTreeModelForeachFunc) update_list_mode_foreach, self);
1120 g_object_notify (G_OBJECT (self), "show-avatars");
1124 * empathy_persona_store_get_show_protocols:
1125 * @self: an #EmpathyPersonaStore
1127 * Get the value of #EmpathyPersonaStore:show-protocols.
1129 * Return value: %TRUE if protocol images are made available by the store,
1133 empathy_persona_store_get_show_protocols (EmpathyPersonaStore *self)
1135 g_return_val_if_fail (EMPATHY_IS_PERSONA_STORE (self), TRUE);
1137 return GET_PRIV (self)->show_protocols;
1141 * empathy_persona_store_set_show_protocols:
1142 * @self: an #EmpathyPersonaStore
1143 * @show_protocols: %TRUE to make protocol images available through the store,
1146 * Set #EmpathyPersonaStore:show-protocols to @show_protocols.
1149 empathy_persona_store_set_show_protocols (EmpathyPersonaStore *self,
1150 gboolean show_protocols)
1152 EmpathyPersonaStorePriv *priv;
1154 g_return_if_fail (EMPATHY_IS_PERSONA_STORE (self));
1156 priv = GET_PRIV (self);
1157 priv->show_protocols = show_protocols;
1159 gtk_tree_model_foreach (GTK_TREE_MODEL (self),
1160 (GtkTreeModelForeachFunc) update_list_mode_foreach, self);
1162 g_object_notify (G_OBJECT (self), "show-protocols");
1166 * empathy_persona_store_get_sort_criterion:
1167 * @self: an #EmpathyPersonaStore
1169 * Get the value of #EmpathyPersonaStore:sort-criterion.
1171 * Return value: the criterion used to sort the personas in the store
1173 EmpathyPersonaStoreSort
1174 empathy_persona_store_get_sort_criterion (EmpathyPersonaStore *self)
1176 g_return_val_if_fail (EMPATHY_IS_PERSONA_STORE (self), 0);
1178 return GET_PRIV (self)->sort_criterion;
1182 * empathy_persona_store_set_sort_criterion:
1183 * @self: an #EmpathyPersonaStore
1184 * @show_avatars: a criterion to be used to sort personas in the store
1186 * Set #EmpathyPersonaStore:sort-criterion to @sort_criterion.
1189 empathy_persona_store_set_sort_criterion (EmpathyPersonaStore *self,
1190 EmpathyPersonaStoreSort sort_criterion)
1192 EmpathyPersonaStorePriv *priv;
1194 g_return_if_fail (EMPATHY_IS_PERSONA_STORE (self));
1196 priv = GET_PRIV (self);
1197 priv->sort_criterion = sort_criterion;
1199 switch (sort_criterion)
1201 case EMPATHY_PERSONA_STORE_SORT_STATE:
1202 gtk_tree_sortable_set_sort_column_id (GTK_TREE_SORTABLE (self),
1203 EMPATHY_PERSONA_STORE_COL_STATUS, GTK_SORT_ASCENDING);
1205 case EMPATHY_PERSONA_STORE_SORT_NAME:
1206 gtk_tree_sortable_set_sort_column_id (GTK_TREE_SORTABLE (self),
1207 EMPATHY_PERSONA_STORE_COL_NAME, GTK_SORT_ASCENDING);
1210 g_assert_not_reached ();
1214 g_object_notify (G_OBJECT (self), "sort-criterion");