Merge lp:~bellini666/stoq/help_button_on_dialogs into lp:~stoq-dev/stoq/master

[Thiago Bellini]

Add support for showing help button on dialogs.

With this change, the 'Plugins Dialog' will show the help button, that is already working to show it's help. Other dialogs can do the same by just adding "help_section = 'page_name'", just like other editors and wizards.

pyflakes and pep8 tests passed.

=== modified file 'stoqlib/gui/base/dialogs.py'
--- stoqlib/gui/base/dialogs.py	2011-11-30 17:51:25 +0000
+++ stoqlib/gui/base/dialogs.py	2012-01-25 19:12:24 +0000
@@ -105,6 +105,7 @@
 class AbstractDialog(GladeDelegate, RunnableView):
     """Abstract Dialog class that defines a simple run API."""
     gladefile = None
+    help_section = None
 
     def __init__(self, delete_handler=None):
         if not delete_handler:
@@ -115,9 +116,32 @@
                                delete_handler=delete_handler,
                                keyactions=self.keyactions)
 
+        if self.help_section:
+            self._add_help_button(self.help_section)
+
+    #
+    #  Public API
+    #
+
     def setup_keyactions(self):
         self.keyactions = {}
 
+    #
+    #  Private
+    #
+
+    def _add_help_button(self, section):
+        def on_help__clicked(button):
+            from stoqlib.gui.help import show_section
+            show_section(section)
+
+        self.action_area.set_layout(gtk.BUTTONBOX_END)
+        button = gtk.Button(stock=gtk.STOCK_HELP)
+        button.connect('clicked', on_help__clicked)
+        self.action_area.add(button)
+        self.action_area.set_child_secondary(button, True)
+        button.show()
+
 #
 # Special note for BasicDialog and BasicPluggableDialog: if you inherit
 # from this class, you *must* call Basic*Dialog._initialize() right after