Add EmpathyIndividualWidget

This displays details for a single Individual, in much the same way that
EmpathyContactWidget displays the details of a single Persona.

3 files changed, 365 insertions, 0 deletions

diff --git a/libempathy-gtk/Makefile.am b/libempathy-gtk/Makefile.am
index b45fc6e74..ff571c161 100644
--- a/libempathy-gtk/Makefile.am
+++ b/libempathy-gtk/Makefile.am
@@ -56,6 +56,7 @@ libempathy_gtk_handwritten_source =            	\
 	empathy-individual-menu.c		\
 	empathy-individual-store.c		\
 	empathy-individual-view.c		\
+	empathy-individual-widget.c		\
 	empathy-irc-network-dialog.c		\
 	empathy-kludge-label.c			\
 	empathy-log-window.c			\
@@ -109,6 +110,7 @@ libempathy_gtk_headers =			\
 	empathy-individual-menu.h		\
 	empathy-individual-store.h		\
 	empathy-individual-view.h		\
+	empathy-individual-widget.h		\
 	empathy-irc-network-dialog.h		\
 	empathy-kludge-label.h			\
 	empathy-log-window.h			\
diff --git a/libempathy-gtk/empathy-individual-widget.c b/libempathy-gtk/empathy-individual-widget.c
new file mode 100644
index 000000000..2d2e9af7d
--- /dev/null
+++ b/libempathy-gtk/empathy-individual-widget.c
@@ -0,0 +1,257 @@
+/*
+ * Copyright (C) 2010 Collabora Ltd.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ * Authors: Philip Withnall <philip.withnall@collabora.co.uk>
+ */
+
+#include <config.h>
+
+#include <string.h>
+#include <stdlib.h>
+
+#include <gtk/gtk.h>
+#include <glib/gi18n-lib.h>
+
+#include <telepathy-glib/util.h>
+
+#include <libempathy/empathy-utils.h>
+
+#include <folks/folks-telepathy.h>
+
+#include "empathy-individual-widget.h"
+#include "empathy-gtk-enum-types.h"
+
+/**
+ * SECTION:empathy-individual-widget
+ * @title:EmpathyIndividualWidget
+ * @short_description: A widget used to display and edit details about an
+ * individual
+ * @include: libempathy-empathy-individual-widget.h
+ *
+ * #EmpathyIndividualWidget is a widget which displays appropriate widgets
+ * with details about an individual, also allowing changing these details,
+ * if desired.
+ */
+
+/**
+ * EmpathyIndividualWidget:
+ * @parent: parent object
+ *
+ * Widget which displays appropriate widgets with details about an individual,
+ * also allowing changing these details, if desired.
+ *
+ * Currently, it's just a thin wrapper around #EmpathyContactWidget, and
+ * displays the details of the first eligible persona found in the individual.
+ */
+
+#define GET_PRIV(obj) EMPATHY_GET_PRIV (obj, EmpathyIndividualWidget)
+
+typedef struct {
+  FolksIndividual *individual;
+  EmpathyIndividualWidgetFlags flags;
+} EmpathyIndividualWidgetPriv;
+
+G_DEFINE_TYPE (EmpathyIndividualWidget, empathy_individual_widget,
+    GTK_TYPE_BOX);
+
+enum {
+  PROP_INDIVIDUAL = 1,
+  PROP_FLAGS
+};
+
+static void
+empathy_individual_widget_init (EmpathyIndividualWidget *self)
+{
+  self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self,
+      EMPATHY_TYPE_INDIVIDUAL_WIDGET, EmpathyIndividualWidgetPriv);
+
+  gtk_orientable_set_orientation (GTK_ORIENTABLE (self),
+      GTK_ORIENTATION_VERTICAL);
+}
+
+static void
+get_property (GObject *object,
+    guint param_id,
+    GValue *value,
+    GParamSpec *pspec)
+{
+  EmpathyIndividualWidgetPriv *priv = GET_PRIV (object);
+
+  switch (param_id)
+    {
+      case PROP_INDIVIDUAL:
+        g_value_set_object (value, priv->individual);
+        break;
+      case PROP_FLAGS:
+        g_value_set_flags (value, priv->flags);
+        break;
+      default:
+        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
+        break;
+    }
+}
+
+static void
+set_property (GObject *object,
+    guint param_id,
+    const GValue *value,
+    GParamSpec *pspec)
+{
+  EmpathyIndividualWidgetPriv *priv = GET_PRIV (object);
+
+  switch (param_id)
+    {
+      case PROP_INDIVIDUAL:
+        empathy_individual_widget_set_individual (
+            EMPATHY_INDIVIDUAL_WIDGET (object), g_value_get_object (value));
+        break;
+      case PROP_FLAGS:
+        priv->flags = g_value_get_flags (value);
+        break;
+      default:
+        G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
+        break;
+    }
+}
+
+static void
+dispose (GObject *object)
+{
+  EmpathyIndividualWidgetPriv *priv = GET_PRIV (object);
+
+  tp_clear_object (&priv->individual);
+
+  G_OBJECT_CLASS (empathy_individual_widget_parent_class)->dispose (object);
+}
+
+static void
+empathy_individual_widget_class_init (EmpathyIndividualWidgetClass *klass)
+{
+  GObjectClass *object_class = G_OBJECT_CLASS (klass);
+
+  object_class->get_property = get_property;
+  object_class->set_property = set_property;
+  object_class->dispose = dispose;
+
+  /**
+   * EmpathyIndividualWidget:individual:
+   *
+   * The #FolksIndividual to display in the widget.
+   */
+  g_object_class_install_property (object_class, PROP_INDIVIDUAL,
+      g_param_spec_object ("individual",
+          "Individual",
+          "The #FolksIndividual to display in the widget.",
+          FOLKS_TYPE_INDIVIDUAL,
+          G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
+
+  /**
+   * EmpathyIndividualWidget:flags:
+   *
+   * A set of flags which affect the widget's behaviour.
+   */
+  g_object_class_install_property (object_class, PROP_FLAGS,
+      g_param_spec_flags ("flags",
+          "Flags",
+          "A set of flags which affect the widget's behaviour.",
+          EMPATHY_TYPE_INDIVIDUAL_WIDGET_FLAGS,
+          EMPATHY_INDIVIDUAL_WIDGET_EDIT_NONE,
+          G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY));
+
+  g_type_class_add_private (object_class, sizeof (EmpathyIndividualWidgetPriv));
+}
+
+/**
+ * empathy_individual_widget_new:
+ * @individual: the #FolksIndividual to display
+ * @flags: flags affecting how the widget behaves and what it displays
+ *
+ * Creates a new #EmpathyIndividualWidget.
+ *
+ * Return value: a new #EmpathyIndividualWidget
+ */
+GtkWidget *
+empathy_individual_widget_new (FolksIndividual *individual,
+    EmpathyIndividualWidgetFlags flags)
+{
+  g_return_val_if_fail (individual == NULL || FOLKS_IS_INDIVIDUAL (individual),
+      NULL);
+
+  return g_object_new (EMPATHY_TYPE_INDIVIDUAL_WIDGET,
+      "individual", individual, "flags", flags, NULL);
+}
+
+FolksIndividual *
+empathy_individual_widget_get_individual (EmpathyIndividualWidget *self)
+{
+  g_return_val_if_fail (EMPATHY_IS_INDIVIDUAL_WIDGET (self), NULL);
+
+  return GET_PRIV (self)->individual;
+}
+
+void
+empathy_individual_widget_set_individual (EmpathyIndividualWidget *self,
+    FolksIndividual *individual)
+{
+  EmpathyIndividualWidgetPriv *priv;
+  GList *personas = NULL, *l;
+
+  g_return_if_fail (EMPATHY_IS_INDIVIDUAL_WIDGET (self));
+  g_return_if_fail (individual == NULL || FOLKS_IS_INDIVIDUAL (individual));
+
+  priv = GET_PRIV (self);
+
+  /* Out with the old… */
+  gtk_container_foreach (GTK_CONTAINER (self), (GtkCallback) gtk_widget_destroy,
+      NULL);
+  tp_clear_object (&priv->individual);
+
+  /* …and in with the new. */
+  priv->individual = individual;
+  if (individual != NULL)
+    {
+      g_object_ref (individual);
+      personas = folks_individual_get_personas (individual);
+    }
+
+  for (l = personas; l != NULL; l = l->next)
+    {
+      GtkWidget *contact_widget;
+      TpContact *tp_contact;
+      EmpathyContact *contact;
+      TpfPersona *persona = l->data;
+
+      if (!TPF_IS_PERSONA (persona))
+        continue;
+
+      tp_contact = tpf_persona_get_contact (persona);
+      contact = empathy_contact_dup_from_tp_contact (tp_contact);
+
+      /* Contact info widget */
+      contact_widget = empathy_contact_widget_new (contact, priv->flags);
+      gtk_container_set_border_width (GTK_CONTAINER (contact_widget), 8);
+      gtk_box_pack_start (GTK_BOX (self), contact_widget, TRUE, TRUE, 0);
+      gtk_widget_show (contact_widget);
+
+      g_object_unref (contact);
+
+      /* If we're not meant to display all of the personas, bail after the first
+       * one. */
+      if (!(priv->flags & EMPATHY_INDIVIDUAL_WIDGET_SHOW_PERSONAS))
+        break;
+    }
+}
diff --git a/libempathy-gtk/empathy-individual-widget.h b/libempathy-gtk/empathy-individual-widget.h
new file mode 100644
index 000000000..89066f60d
--- /dev/null
+++ b/libempathy-gtk/empathy-individual-widget.h
@@ -0,0 +1,106 @@
+/*
+ * Copyright (C) 2010 Collabora Ltd.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2.1 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+ *
+ * Authors: Philip Withnall <philip.withnall@collabora.co.uk>
+ */
+
+#ifndef __EMPATHY_INDIVIDUAL_WIDGET_H__
+#define __EMPATHY_INDIVIDUAL_WIDGET_H__
+
+#include <gtk/gtk.h>
+
+#include <folks/folks.h>
+
+#include "empathy-contact-widget.h"
+
+G_BEGIN_DECLS
+
+/**
+ * EmpathyIndividualWidgetFlags:
+ * @EMPATHY_INDIVIDUAL_WIDGET_EDIT_NONE: Don't show any widgets to edit any
+ * details of the individual. This should be the option for widgets that merely
+ * display information about an individual.
+ * @EMPATHY_INDIVIDUAL_WIDGET_EDIT_ALIAS: Show a #GtkEntry allowing changes to
+ * the individual's alias.
+ * @EMPATHY_INDIVIDUAL_WIDGET_EDIT_AVATAR: Show an #EmpathyAvatarChooser
+ * allowing changes to the individual's avatar.
+ * @EMPATHY_INDIVIDUAL_WIDGET_EDIT_ACCOUNT: Show an #EmpathyAccountChooser
+ * allowing changes to the individual's account.
+ * @EMPATHY_INDIVIDUAL_WIDGET_EDIT_ID: Show a #GtkEntry allowing changes to the
+ * individual's identifier.
+ * @EMPATHY_INDIVIDUAL_WIDGET_EDIT_GROUPS: Show a widget to change the groups
+ * the individual is in.
+ * @EMPATHY_INDIVIDUAL_WIDGET_FOR_TOOLTIP: Make widgets more designed for a
+ * tooltip. For example, make widgets not selectable.
+ *
+ * Flags used when creating an #EmpathyIndividualWidget to specify which
+ * features should be available.
+ */
+typedef enum
+{
+  EMPATHY_INDIVIDUAL_WIDGET_EDIT_NONE    = 0,
+  EMPATHY_INDIVIDUAL_WIDGET_EDIT_ALIAS   = 1 << 0,
+  EMPATHY_INDIVIDUAL_WIDGET_EDIT_AVATAR  = 1 << 1,
+  EMPATHY_INDIVIDUAL_WIDGET_EDIT_ACCOUNT = 1 << 2,
+  EMPATHY_INDIVIDUAL_WIDGET_EDIT_ID      = 1 << 3,
+  EMPATHY_INDIVIDUAL_WIDGET_EDIT_GROUPS  = 1 << 4,
+  EMPATHY_INDIVIDUAL_WIDGET_FOR_TOOLTIP  = 1 << 5,
+  EMPATHY_INDIVIDUAL_WIDGET_SHOW_LOCATION  = 1 << 6,
+  EMPATHY_INDIVIDUAL_WIDGET_NO_SET_ALIAS = 1 << 7,
+  EMPATHY_INDIVIDUAL_WIDGET_EDIT_FAVOURITE = 1 << 8,
+  EMPATHY_INDIVIDUAL_WIDGET_SHOW_DETAILS = 1 << 9,
+  EMPATHY_INDIVIDUAL_WIDGET_EDIT_DETAILS = 1 << 10,
+  EMPATHY_INDIVIDUAL_WIDGET_SHOW_PERSONAS = 1 << 11,
+} EmpathyIndividualWidgetFlags;
+
+#define EMPATHY_TYPE_INDIVIDUAL_WIDGET (empathy_individual_widget_get_type ())
+#define EMPATHY_INDIVIDUAL_WIDGET(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), \
+    EMPATHY_TYPE_INDIVIDUAL_WIDGET, EmpathyIndividualWidget))
+#define EMPATHY_INDIVIDUAL_WIDGET_CLASS(k) (G_TYPE_CHECK_CLASS_CAST ((k), \
+    EMPATHY_TYPE_INDIVIDUAL_WIDGET, EmpathyIndividualWidgetClass))
+#define EMPATHY_IS_INDIVIDUAL_WIDGET(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), \
+    EMPATHY_TYPE_INDIVIDUAL_WIDGET))
+#define EMPATHY_IS_INDIVIDUAL_WIDGET_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), \
+    EMPATHY_TYPE_INDIVIDUAL_WIDGET))
+#define EMPATHY_INDIVIDUAL_WIDGET_GET_CLASS(o) ( \
+    G_TYPE_INSTANCE_GET_CLASS ((o), EMPATHY_TYPE_INDIVIDUAL_WIDGET, \
+        EmpathyIndividualWidgetClass))
+
+typedef struct {
+	GtkBox parent;
+
+	/*<private>*/
+	gpointer priv;
+} EmpathyIndividualWidget;
+
+typedef struct {
+	GtkBoxClass parent_class;
+} EmpathyIndividualWidgetClass;
+
+GType empathy_individual_widget_get_type (void) G_GNUC_CONST;
+
+GtkWidget * empathy_individual_widget_new (FolksIndividual *individual,
+    EmpathyIndividualWidgetFlags flags);
+
+FolksIndividual * empathy_individual_widget_get_individual (
+    EmpathyIndividualWidget *self);
+void empathy_individual_widget_set_individual (EmpathyIndividualWidget *self,
+    FolksIndividual *individual);
+
+G_END_DECLS
+
+#endif /*  __EMPATHY_INDIVIDUAL_WIDGET_H__ */