* Fixes to touch selector usage of new pickers.
[modest] / src / hildon2 / modest-provider-picker.c
1 /* Copyright (c) 2006, 2008 Nokia Corporation
2  * All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *
8  * * Redistributions of source code must retain the above copyright
9  *   notice, this list of conditions and the following disclaimer.
10  * * Redistributions in binary form must reproduce the above copyright
11  *   notice, this list of conditions and the following disclaimer in the
12  *   documentation and/or other materials provided with the distribution.
13  * * Neither the name of the Nokia Corporation nor the names of its
14  *   contributors may be used to endorse or promote products derived from
15  *   this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
18  * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
19  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
20  * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
21  * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
22  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
23  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
24  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
25  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
26  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29
30 #include "modest-provider-picker.h"
31 #include <gtk/gtkliststore.h>
32 #include <gtk/gtkcelllayout.h>
33 #include <gtk/gtkcellrenderertext.h>
34 #include <glib/gi18n.h>
35 #include <modest-text-utils.h>
36 #include "modest-protocol-registry.h"
37 #include "modest-runtime.h"
38
39 #include <stdlib.h>
40 #include <string.h> /* For memcpy() */
41
42 /* Include config.h so that _() works: */
43 #ifdef HAVE_CONFIG_H
44 #include <config.h>
45 #endif
46
47 G_DEFINE_TYPE (ModestProviderPicker, modest_provider_picker, HILDON_TYPE_PICKER_BUTTON);
48
49 #define MODEST_PROVIDER_PICKER_GET_PRIVATE(o) \
50         (G_TYPE_INSTANCE_GET_PRIVATE ((o), MODEST_TYPE_PROVIDER_PICKER, ModestProviderPickerPrivate))
51
52 typedef struct _ModestProviderPickerPrivate ModestProviderPickerPrivate;
53
54 struct _ModestProviderPickerPrivate
55 {
56         GtkTreeModel *model;
57 };
58 static void
59 modest_provider_picker_finalize (GObject *object)
60 {
61         ModestProviderPickerPrivate *priv = MODEST_PROVIDER_PICKER_GET_PRIVATE (object);
62
63         g_object_unref (G_OBJECT (priv->model));
64
65         G_OBJECT_CLASS (modest_provider_picker_parent_class)->finalize (object);
66 }
67
68 static void
69 modest_provider_picker_class_init (ModestProviderPickerClass *klass)
70 {
71         GObjectClass *object_class = G_OBJECT_CLASS (klass);
72
73         g_type_class_add_private (klass, sizeof (ModestProviderPickerPrivate));
74
75         object_class->finalize = modest_provider_picker_finalize;
76 }
77
78 enum MODEL_COLS {
79         MODEL_COL_ID, /* a string, not an int. */
80         MODEL_COL_NAME,
81         MODEL_COL_ID_TYPE
82 };
83
84
85 /*
86  * strictly, we should sort providers with mcc=0 after the other ones.... but, we don't have
87  * that info here, so ignoring for now.
88  */
89 static gint
90 provider_sort_func (GtkTreeModel *model, GtkTreeIter *iter1, GtkTreeIter *iter2, gpointer user_data)
91 {
92         gchar *prov1, *prov2;
93         gint retval;
94         
95         gtk_tree_model_get (model, iter1, MODEL_COL_NAME, &prov1, -1);
96         gtk_tree_model_get (model, iter2, MODEL_COL_NAME, &prov2, -1);
97
98         if (strcmp (prov1, prov2) == 0) 
99                 retval = 0;
100         else if (strcmp (_("mcen_va_serviceprovider_other"), prov1) == 0)
101                 retval = -1;
102         else if (strcmp (_("mcen_va_serviceprovider_other"), prov2) == 0)
103                 retval = 1;
104         else
105                 retval = modest_text_utils_utf8_strcmp (prov1, prov2, TRUE);
106         
107         g_free (prov1);
108         g_free (prov2);
109
110         return retval;
111 }
112
113 static gchar *
114 touch_selector_print_func (HildonTouchSelector *selector)
115 {
116         GtkTreeIter iter;
117         if (hildon_touch_selector_get_selected (HILDON_TOUCH_SELECTOR (selector), 0, &iter)) {
118                 GtkTreeModel *model;
119                 GValue value = {0,};
120                 
121                 model = hildon_touch_selector_get_model (HILDON_TOUCH_SELECTOR (selector), 0);
122                 gtk_tree_model_get_value (model, &iter, MODEL_COL_NAME, &value);
123                 return g_value_dup_string (&value);
124         }
125         return NULL;
126 }
127
128
129 static void
130 modest_provider_picker_init (ModestProviderPicker *self)
131 {
132         ModestProviderPickerPrivate *priv;
133
134         priv = MODEST_PROVIDER_PICKER_GET_PRIVATE (self);
135         priv->model = NULL;
136 }
137
138 ModestProviderPicker*
139 modest_provider_picker_new (void)
140 {
141         ModestProviderPickerPrivate *priv;
142         ModestProviderPicker *self;
143         GtkCellRenderer *renderer;
144         GtkWidget *selector;
145
146         self = g_object_new (MODEST_TYPE_PROVIDER_PICKER, 
147                              "arrangement", HILDON_BUTTON_ARRANGEMENT_VERTICAL,
148                              "size", HILDON_SIZE_AUTO,
149                              NULL);
150         priv = MODEST_PROVIDER_PICKER_GET_PRIVATE (self);
151
152         /* Create the tree model for the selector,
153          * with a string for the name, and a string for the ID (e.g. "vodafone.it"), and the mcc
154          * This must match our MODEL_COLS enum constants.
155          */
156         priv->model = GTK_TREE_MODEL (gtk_list_store_new (3, G_TYPE_STRING, G_TYPE_STRING, G_TYPE_INT));
157         gtk_tree_sortable_set_sort_column_id (GTK_TREE_SORTABLE(priv->model),
158                                               MODEL_COL_NAME, GTK_SORT_ASCENDING);
159         gtk_tree_sortable_set_sort_func (GTK_TREE_SORTABLE(priv->model),
160                                           MODEL_COL_NAME,
161                                           (GtkTreeIterCompareFunc)provider_sort_func,
162                                           NULL, NULL);
163
164         renderer = gtk_cell_renderer_text_new ();
165         g_object_set (G_OBJECT (renderer), "ellipsize", PANGO_ELLIPSIZE_END, NULL);
166
167         selector = hildon_touch_selector_new ();
168         hildon_touch_selector_append_column (HILDON_TOUCH_SELECTOR (selector), GTK_TREE_MODEL (priv->model),
169                                              renderer, "text", MODEL_COL_NAME, NULL);
170
171         hildon_touch_selector_set_model (HILDON_TOUCH_SELECTOR (selector), 0, GTK_TREE_MODEL (priv->model));
172         hildon_touch_selector_set_print_func (HILDON_TOUCH_SELECTOR (selector), touch_selector_print_func);
173
174         hildon_picker_button_set_selector (HILDON_PICKER_BUTTON (self), HILDON_TOUCH_SELECTOR (selector));
175         modest_provider_picker_set_others_provider (MODEST_PROVIDER_PICKER (self));
176
177         return self;
178 }
179
180 void
181 modest_provider_picker_fill (ModestProviderPicker *self, 
182                              ModestPresets *presets,
183                              gint mcc)
184 {       
185         GtkTreeIter other_iter;
186         ModestProviderPickerPrivate *priv;
187         GtkListStore *liststore;        
188         GSList *provider_ids_used_already = NULL, *provider_protos, *tmp;
189         gchar ** provider_ids = NULL;
190         gchar ** provider_names;        
191         gchar ** iter_provider_names;
192         gchar ** iter_provider_ids;
193         ModestProtocolRegistry *registry;
194         GtkWidget *selector;
195
196         g_return_if_fail (MODEST_IS_PROVIDER_PICKER(self));
197
198         priv = MODEST_PROVIDER_PICKER_GET_PRIVATE (self);
199         liststore = GTK_LIST_STORE (priv->model);
200         gtk_list_store_clear (liststore);
201         provider_names = modest_presets_get_providers (presets, mcc, TRUE, &provider_ids);
202
203         iter_provider_names = provider_names;
204         iter_provider_ids = provider_ids;
205
206         while(iter_provider_names && *iter_provider_names && iter_provider_ids && *iter_provider_ids) {
207                 const gchar* provider_name = *iter_provider_names;
208                 const gchar* provider_id = *iter_provider_ids;
209
210                 /* Prevent duplicate providers: */
211                 if (g_slist_find_custom (provider_ids_used_already, 
212                                          provider_id, (GCompareFunc)strcmp) == NULL) {
213                         /* printf("debug: provider_name=%s\n", provider_name); */
214
215                         /* Add the row: */
216                         GtkTreeIter iter;
217                         gtk_list_store_append (liststore, &iter);
218                         
219                         gtk_list_store_set(liststore, &iter, 
220                                            MODEL_COL_ID, provider_id, 
221                                            MODEL_COL_NAME, provider_name, 
222                                            MODEL_COL_ID_TYPE, MODEST_PROVIDER_PICKER_ID_PROVIDER,
223                                            -1);
224                         
225                         provider_ids_used_already = g_slist_prepend (
226                                 provider_ids_used_already, (gpointer)g_strdup (provider_id));
227                 }
228                 
229                 ++iter_provider_names;
230                 ++iter_provider_ids;
231         }
232         
233         /* Free the result of modest_presets_get_providers()
234          * as specified by its documentation: */
235         g_strfreev (provider_names);
236         g_strfreev (provider_ids);
237
238         /* Add the provider protocols */
239         registry = modest_runtime_get_protocol_registry ();
240         provider_protos = modest_protocol_registry_get_by_tag (registry, 
241                                                                MODEST_PROTOCOL_REGISTRY_PROVIDER_PROTOCOLS);
242         tmp = provider_protos;
243         while (tmp) {
244                 GtkTreeIter iter;
245                 ModestProtocol *proto = MODEST_PROTOCOL (tmp->data);
246                 const gchar *name = modest_protocol_get_display_name (proto);
247
248                 /* only add store protocols, no need to duplicate them */
249                 if (modest_protocol_registry_protocol_type_has_tag (registry, 
250                                                                     modest_protocol_get_type_id (proto),
251                                                                     MODEST_PROTOCOL_REGISTRY_STORE_PROTOCOLS)) {
252                         gtk_list_store_append (liststore, &iter);
253                         gtk_list_store_set (liststore, &iter,
254                                             MODEL_COL_ID, modest_protocol_get_name (proto),
255                                             MODEL_COL_NAME, name,
256                                             MODEL_COL_ID_TYPE, MODEST_PROVIDER_PICKER_ID_PLUGIN_PROTOCOL,
257                                             -1);
258                 }
259                 tmp = g_slist_next (tmp);
260         }
261         g_slist_free (provider_protos);
262         
263         g_slist_foreach (provider_ids_used_already, (GFunc)g_free, NULL);
264         g_slist_free (provider_ids_used_already);
265
266         /* Add the "Other" item: */
267         /* Note that ID 0 means "Other" for us: */
268         gtk_list_store_prepend (liststore, &other_iter);
269         gtk_list_store_set (liststore, &other_iter,
270                             MODEL_COL_ID, 0,
271                             MODEL_COL_NAME, _("mcen_va_serviceprovider_other"),
272                             MODEL_COL_ID_TYPE, MODEST_PROVIDER_PICKER_ID_OTHER,
273                             -1);
274
275         /* Select the "Other" item: */
276         selector = GTK_WIDGET (hildon_picker_button_get_selector (HILDON_PICKER_BUTTON (self)));
277         hildon_touch_selector_select_iter (HILDON_TOUCH_SELECTOR (selector), 0, &other_iter, TRUE);
278         hildon_button_set_value (HILDON_BUTTON (self),
279                                  hildon_touch_selector_get_current_text (HILDON_TOUCH_SELECTOR (selector)));
280         
281 }
282
283 /**
284  * Returns the MCC number of the selected provider, 
285  * or NULL if no provider was selected, or "Other" was selected. 
286  */
287 gchar*
288 modest_provider_picker_get_active_provider_id (ModestProviderPicker *self)
289 {
290         GtkTreeIter active;
291         gboolean found;
292         GtkWidget *selector;
293
294         g_return_val_if_fail (MODEST_IS_PROVIDER_PICKER(self), NULL);
295
296         selector = GTK_WIDGET (hildon_picker_button_get_selector (HILDON_PICKER_BUTTON (self)));
297         found = hildon_touch_selector_get_selected (HILDON_TOUCH_SELECTOR (selector), 0, &active);
298         if (found) {
299                 ModestProviderPickerPrivate *priv = MODEST_PROVIDER_PICKER_GET_PRIVATE (self);
300
301                 gchar *id = NULL;
302                 gtk_tree_model_get (priv->model, &active, MODEL_COL_ID, &id, -1);
303                 return g_strdup(id);    
304         }
305
306         return NULL; /* Failed. */
307 }
308
309 void 
310 modest_provider_picker_set_others_provider (ModestProviderPicker *self)
311 {
312         GtkTreeModel *model;
313         GtkTreeIter others_iter;
314         GtkWidget *selector;
315
316         g_return_if_fail (MODEST_IS_PROVIDER_PICKER(self));
317         
318         selector = GTK_WIDGET (hildon_picker_button_get_selector (HILDON_PICKER_BUTTON (self)));
319         model = hildon_touch_selector_get_model (HILDON_TOUCH_SELECTOR (selector), 0);
320         
321         if (gtk_tree_model_get_iter_first (model, &others_iter)) {
322                 hildon_touch_selector_select_iter (HILDON_TOUCH_SELECTOR (selector), 0, &others_iter, TRUE);
323                 hildon_button_set_value (HILDON_BUTTON (self),
324                                          hildon_touch_selector_get_current_text (HILDON_TOUCH_SELECTOR (selector)));
325         }
326 }
327
328 ModestProviderPickerIdType 
329 modest_provider_picker_get_active_id_type (ModestProviderPicker *self)
330 {
331         GtkTreeIter active;
332         GtkWidget *selector;
333
334         g_return_val_if_fail (MODEST_IS_PROVIDER_PICKER (self), 
335                               MODEST_PROVIDER_PICKER_ID_OTHER);
336
337         selector = GTK_WIDGET (hildon_picker_button_get_selector (HILDON_PICKER_BUTTON(self)));
338
339         if (hildon_touch_selector_get_selected (HILDON_TOUCH_SELECTOR (selector), 0, &active)) {
340                 ModestProviderPickerPrivate *priv = MODEST_PROVIDER_PICKER_GET_PRIVATE (self);
341                 ModestProviderPickerIdType id_type;
342
343                 gtk_tree_model_get (priv->model, &active, MODEL_COL_ID_TYPE, &id_type, -1);
344                 return id_type; 
345         } else {
346                 /* Fallback to other */
347                 return MODEST_PROVIDER_PICKER_ID_OTHER;
348         }
349 }