improved search bar
[meabook] / ui / hildon_ui.py
1 """
2 Hildon UI for Meabook
3 """
4
5 import gtk
6 import pango
7 import hildon
8 import gobject
9 from gettext import gettext as _
10 from meabook.constants import *
11 from meabook.ui.ui import MeabookUI
12
13
14 def create_button(title, value):
15     """Creates HildonButton."""
16
17     button = hildon.Button(gtk.HILDON_SIZE_AUTO | \
18         gtk.HILDON_SIZE_FINGER_HEIGHT, \
19         hildon.BUTTON_ARRANGEMENT_VERTICAL, title, value)
20     button.set_style(hildon.BUTTON_STYLE_PICKER)
21     button.set_alignment(0, 0, 0, 0)
22     return button
23
24
25 def create_menu_button(title):
26     """Creates Hildon menu button."""
27
28     return hildon.Button(gtk.HILDON_SIZE_AUTO, \
29         hildon.BUTTON_ARRANGEMENT_HORIZONTAL, title)
30
31
32 class HildonMeabook(MeabookUI):
33     def __init__(self, controller, renderer, config):
34         MeabookUI.__init__(self, controller, renderer, config)
35         self.handler = None
36         self.window = hildon.StackableWindow()
37         self.window.set_title(_('Meabook'))
38         self.window.connect('destroy', self.exit)
39
40         # create menu buttons
41         self.menu = hildon.AppMenu()
42         settings_button = create_menu_button(_('Settings'))
43         about_button = create_menu_button(_('About'))
44         import_button = create_menu_button(_('Import'))
45
46         # create filter widgets and connect signals
47         self.level1_filter = gtk.RadioButton(None, _('level1'))
48         self.level2_filter = gtk.RadioButton(self.level1_filter, _('level2'))
49         self.level3_filter = gtk.RadioButton(self.level2_filter, _('level3'))
50         for filter_widget in [self.level1_filter, self.level2_filter, \
51             self.level3_filter]:
52             filter_widget.set_mode(False)
53             filter_widget.connect('toggled', self.apply_filter_cb)
54
55         # create items list
56         self.selector = hildon.TouchSelector()
57
58         widgets_box = gtk.VBox()
59         self.search_widgets_box = gtk.HBox()
60         self.search_entry = hildon.Entry(gtk.HILDON_SIZE_AUTO)
61         clear_search_entry_container = gtk.EventBox()
62         clear_search_entry_image = gtk.image_new_from_icon_name( \
63             'general_delete', gtk.HILDON_SIZE_FINGER_HEIGHT)
64
65
66         # connect signals
67         settings_button.connect('clicked', self.show_settings_dialog_cb)
68         about_button.connect('clicked', self.show_about_dialog_cb)
69         import_button.connect('clicked', self.show_import_dialog_cb)
70         self.handler = self.selector.connect('changed', self.select_item_cb)
71         self.search_entry.connect('key-release-event', self.search_item_cb)
72         clear_search_entry_container.connect('button-press-event', \
73             self.clear_search_entry_cb)
74
75         # packing widgets
76         clear_search_entry_container.add(clear_search_entry_image)
77         self.search_widgets_box.pack_start(self.search_entry, expand=True)
78         self.search_widgets_box.pack_start(clear_search_entry_container, \
79             expand=False, padding=24)
80         widgets_box.pack_start(self.selector, expand=True)
81         widgets_box.pack_end(self.search_widgets_box, expand=False)
82         self.window.add(widgets_box)
83         self.menu.add_filter(self.level1_filter)
84         self.menu.add_filter(self.level2_filter)
85         self.menu.add_filter(self.level3_filter)
86         self.menu.append(settings_button)
87         self.menu.append(import_button)
88         self.menu.append(about_button)
89         self.menu.show_all()
90         self.window.set_app_menu(self.menu)
91         self.window.show_all()
92
93     def _unfreeze_ui(self):
94         while gtk.events_pending():
95             gtk.main_iteration(False)
96
97     def _update_title(self, title):
98         """Set window title text."""
99
100         if title is not None:
101             self.window.set_title(title)
102
103     def _set_selector_content(self, selector, handler, items=[]):
104         """Updates selector content."""
105
106         # temporary block handler
107         selector.handler_block(handler)
108
109         # setting new content
110         # model: name, internal_name, type
111         model = gtk.ListStore(gobject.TYPE_STRING, gobject.TYPE_INT, \
112             gobject.TYPE_STRING)
113         for item in items:
114             model.append(item)
115         if selector.get_num_columns():
116             selector.remove_column(0)
117         selector.append_text_column(model, False)
118         selector.unselect_all(0)
119
120         # reconnect callback
121         selector.handler_unblock(handler)
122
123
124     def _show_items_dialog(self, title, items):
125         """Creates dialog with items."""
126
127         selector = hildon.TouchSelector()
128         window = hildon.StackableWindow()
129         window.set_title(title)
130         window.add(selector)
131         handler = selector.connect('changed', self.select_item_cb)
132         self._set_selector_content(selector, handler, items)
133         window.show_all()
134
135     def _show_item_dialog(self, title, entry_id):
136         """Shows detailed item information."""
137
138         def show_settings_dialog(widget, parent, func1, func2, entry_id):
139             dialog = ConfigurationDialog(self.controller, self.config)
140             response = getattr(dialog, func1)(None, parent)
141             if response == gtk.RESPONSE_OK:
142                 func2(parent, entry_id)
143
144         def update_entry(window, entry_id):
145             # create widgets
146             entry = self.controller.get_item(entry_id)
147             widgets_table = gtk.Table(rows=1, columns=1)
148             info_box = gtk.VBox()
149             image_box = gtk.VBox()
150             pannable_area = hildon.PannableArea()
151             pannable_area.set_property('mov-mode', hildon.MOVEMENT_MODE_BOTH)
152             image = self.renderer.render_image(dict(entry))
153             for fname, fvalue in entry:
154                 if fname == 'image':
155                     continue
156                 button = self.renderer.render_button(_(fname) , fvalue, fname)
157                 info_box.pack_start(button, expand=False)
158             # pack widgets
159             image_box.pack_start(image, expand=False)
160             widgets_table.attach(image_box, 0, 1, 0, 1, xoptions=gtk.SHRINK, \
161                 yoptions=gtk.FILL, xpadding=4, ypadding=8)
162             pannable_area.add_with_viewport(info_box)
163             widgets_table.attach(pannable_area, 1, 2, 0, 1, ypadding=8)
164             child = window.get_child()
165             if child:
166                 child.destroy()
167             window.add(widgets_table)
168             widgets_table.show_all()
169
170
171         # create widgets
172         window = hildon.StackableWindow()
173         window.set_title(title)
174         menu = hildon.AppMenu()
175         fields_button = create_menu_button(_('Fields to show'))
176         order_button = create_menu_button(_('Fields order'))
177         fields_button.connect('clicked', show_settings_dialog, window, \
178             'show_fields_settings_cb', update_entry, entry_id)
179         order_button.connect('clicked', show_settings_dialog, window, \
180             'show_order_settings_cb', update_entry, entry_id)
181         menu.append(fields_button)
182         menu.append(order_button)
183
184         update_entry(window, entry_id)
185         window.set_app_menu(menu)
186         menu.show_all()
187         window.show_all()
188
189
190     # Implementation of Base UI interface
191     def start(self):
192         self.apply_filter_cb(self.level1_filter)
193         gtk.main()
194
195     def exit(self, event):
196         gtk.main_quit()
197         self.controller.stop()
198
199     def create_information_dialog(self, title, message):
200         dialog = hildon.Dialog()
201         dialog.set_title(title)
202         label = gtk.Label(message)
203         dialog.vbox.add(label)
204         dialog.vbox.show_all()
205         dialog.run()
206         dialog.destroy()
207
208     def create_about_dialog(self):
209         from meabook.version import version
210         dialog = hildon.Dialog()
211         dialog.set_title(_('About'))
212         info_label = gtk.Label()
213         info_label.set_use_markup(True)
214         info_label.set_justify(gtk.JUSTIFY_CENTER)
215         info_label.set_markup("<span foreground='white' size='medium'><b>" \
216             "Meabook</b></span><span foreground='white' size='small'> - " \
217             "Enterprise address book</span>\n<span foreground='white' " \
218             "size='small'>Version %s</span>\n\n\n<span foreground='white'" \
219             "size='small'><b>Developers:</b></span>\n<span foreground=" \
220             "'white' size='small'>Tanya Makova | </span><span foreground=" \
221             "'#299BFC' size='small'>tanyshk@gmail.com</span>\n<span " \
222             "foreground='white' size='small'>Max Usachev | </span><span " \
223             "foreground='#299BFC' size='small'>maxusachev@gmail.com</span>" \
224             "\n" % version)
225         dialog.vbox.add(info_label)
226         dialog.vbox.show_all()
227         dialog.run()
228         dialog.destroy()
229
230     def create_import_dialog(self):
231         chooser = gobject.new(hildon.FileChooserDialog, \
232             action=gtk.FILE_CHOOSER_ACTION_OPEN)
233         chooser.set_property('show-files', True)
234         chooser.run()
235         path = chooser.get_filename()
236         chooser.destroy()
237         return path
238
239     def create_progress_dialog(self, title=None):
240         self._update_title(title)
241         self.selector.hide()
242         hildon.hildon_gtk_window_set_progress_indicator(self.window, 1)
243         self._unfreeze_ui()
244
245     def create_configuration_dialog(self, controller, config):
246         dialog = ConfigurationDialog(controller, config)
247         dialog.run()
248
249
250     # Hildon UI callbacks
251     def show_about_dialog_cb(self, widget):
252         """Shows About Dialog."""
253
254         self.controller.show_about_dialog()
255
256     def show_import_dialog_cb(self, widget):
257         """Shows Import Dialog."""
258
259         if self.controller.show_import_dialog():
260             self.apply_filter_cb(self.level1_filter)
261             self.selector.show_all()
262         hildon.hildon_gtk_window_set_progress_indicator(self.window, 0)
263
264     def show_settings_dialog_cb(self, widget):
265         """Shows Config dialog."""
266
267         self.controller.show_configuration_dialog()
268
269     def apply_filter_cb(self, widget):
270         """Updates toplevel selector with different level items."""
271
272         if not widget.get_active():
273             return
274
275         self._update_title(' - '.join([_('Meabook'), widget.get_label()]))
276         self.search_widgets_box.hide()
277
278         if widget == self.level1_filter:
279             self._set_selector_content(self.selector, self.handler, \
280                 self.controller.get_all_folders())
281         elif widget == self.level2_filter:
282             self._set_selector_content(self.selector, self.handler, \
283                 self.controller.get_all_subfolders())
284         else:
285             self.search_entry.set_text('')
286             self.search_entry.set_placeholder(_('Enter search text here'))
287             self.search_widgets_box.show()
288             self._set_selector_content(self.selector, self.handler)
289
290     def select_item_cb(self, widget, column):
291         """
292         Emits when changes selector content.
293         Opens new StackableWindow with new content.
294         """
295
296         item_name, internal_name, item_type = \
297             widget.get_model(0)[widget.get_active(0)]
298         if item_type == TYPE_DIRECTORY:
299             self._show_items_dialog(item_name, self.controller.get_items( \
300                 internal_name))
301         else:
302             self._show_item_dialog(item_name, internal_name)
303
304     def search_item_cb(self, widget, event):
305         """Search items from database."""
306
307         self._set_selector_content(self.selector, self.handler, \
308             self.controller.get_all_files_by_pattern(widget.get_text()))
309         widget.grab_focus()
310
311     def clear_search_entry_cb(self, widget, event):
312         """Clears search entry content."""
313
314         self.search_entry.set_text('')
315
316
317
318
319 class ConfigurationDialog:
320     """Configuration dialog"""
321
322     def __init__(self, controller, config):
323         self.config = config
324         self.controller = controller
325
326     def run(self):
327         dialog = hildon.Dialog()
328         dialog.set_title(_('Settings'))
329
330         button_order = create_button(_('Fields order'), self._update_value( \
331             None, self.config.get_order()))
332         button_order.connect('clicked', self.show_order_settings_cb, dialog)
333         button_fields = create_button(_('Fields to show'), self._update_value( \
334             None, self.config.get_fields()))
335         button_fields.connect('clicked', self.show_fields_settings_cb, dialog)
336
337         dialog.vbox.pack_start(button_fields, expand=False)
338         dialog.vbox.pack_start(button_order, expand=False)
339         dialog.vbox.show_all()
340         dialog.run()
341         dialog.destroy()
342
343     def _update_value(self, widget, fields):
344         """Updates widget title."""
345
346         value = ', '.join([_(field) for field in fields])
347         if widget is not None:
348             widget.set_value(value)
349         return value
350
351     def show_fields_settings_cb(self, widget, parent):
352         """Shows dialog for selecting fields to show."""
353
354         dialog = hildon.PickerDialog(parent)
355         dialog.set_title(_('Fields to show'))
356         selector = hildon.TouchSelector(text=True)
357
358         fields = self.controller.get_fields()
359         # fill items list
360         for field in fields:
361             selector.append_text(_(field))
362
363         selector.set_column_selection_mode( \
364             hildon.TOUCH_SELECTOR_SELECTION_MODE_MULTIPLE)
365         selector.unselect_all(0)
366
367         # mark necessary fields
368         fields_to_select = self.config.get_fields()
369         model = selector.get_model(0)
370         for index, field in enumerate(fields):
371             if field in fields_to_select:
372                 selector.select_iter(0, model.get_iter(index), False)
373
374         dialog.set_selector(selector)
375         response = dialog.run()
376         if response == gtk.RESPONSE_OK:
377             model = selector.get_model(0)
378             selected_item_indexes = [index for index in [item[0] for item \
379                 in selector.get_selected_rows(0)]]
380             selected_fields = [fields[index] for index in selected_item_indexes]
381             self.config.set_fields(selected_fields)
382             self._update_value(widget, selected_fields)
383         dialog.destroy()
384         return response
385
386     def show_order_settings_cb(self, widget, parent):
387         """Shows dialog for setting fields order."""
388
389
390         def show_fields_chooser(widget, parent):
391             """Shows dialog to select field from fields list."""
392
393             dialog = hildon.PickerDialog(parent)
394             dialog.set_title(_('Fields'))
395             selector = hildon.TouchSelector(text=True)
396             dialog.set_selector(selector)
397             selector.set_column_selection_mode( \
398                 hildon.TOUCH_SELECTOR_SELECTION_MODE_SINGLE)
399             # fill fields list
400             for field in self.controller.get_fields():
401                 selector.append_text(_(field))
402             dialog.run()
403             widget.set_value(selector.get_current_text())
404             dialog.destroy()
405
406
407         dialog = hildon.Dialog()
408         dialog.set_title(_('Fields order'))
409         pannable_area = hildon.PannableArea()
410         pannable_area.set_size_request_policy(hildon.SIZE_REQUEST_CHILDREN)
411
412         vbox = gtk.VBox()
413         for index, field in enumerate(self.config.get_order()):
414             button = create_button(' '.join([_('Position'), str(index)]), \
415                 _(field))
416             button.connect('clicked', show_fields_chooser, dialog)
417             vbox.pack_start(button, expand=False)
418         pannable_area.add_with_viewport(vbox)
419         dialog.add_button(_('Done'), gtk.RESPONSE_OK)
420         dialog.vbox.pack_start(pannable_area)
421         dialog.vbox.show_all()
422         response = dialog.run()
423         if response == gtk.RESPONSE_OK:
424             fields_dict = dict([(_(field).decode('utf-8'), field) for field \
425                 in self.controller.get_fields()])
426             new_ordered_fields = [fields_dict[button.get_value().decode( \
427                 'utf-8')] for button in vbox.get_children()]
428             self.config.set_order(new_ordered_fields)
429             self._update_value(widget, new_ordered_fields)
430         dialog.destroy()
431         return response