Difference between revisions of "GEPS 005: Enhanced Plugin Interface"

From Gramps
Jump to: navigation, search
(Details)
m (Details)
Line 19: Line 19:
 
# Update all of the reports to use abstract options ("menu" options) (see discussion here http://www.nabble.com/RFC%3A-Improving-report-options-tf4381788.html#a12491034)
 
# Update all of the reports to use abstract options ("menu" options) (see discussion here http://www.nabble.com/RFC%3A-Improving-report-options-tf4381788.html#a12491034)
 
# Generalize the report dialogs and remove the need for a report plugin to ever need to define or customize a dialog.
 
# Generalize the report dialogs and remove the need for a report plugin to ever need to define or customize a dialog.
 +
# Rethink each plugin type (report, graph, tool, etc) to be a well-defined API
 
# Move each plugin registration and handler from its current specific register_TYPE() to generic register(type=TYPE)
 
# Move each plugin registration and handler from its current specific register_TYPE() to generic register(type=TYPE)
# Rethink each plugin type (report, graph, tool, etc) to be a well-defined API
 
  
 
== Discussion ==
 
== Discussion ==

Revision as of 19:35, 21 October 2007

Proposed changes for enhancing GRAMPS by updating the plugin interface to:

  1. be more flexible for future changes
  2. be more consistent across different types of plugins
  3. be more abstract

Motivation

The current plugin architecture is quite nice, and allows many different types of features to be added by users, or by developers. However, it needs to be updated so that it can support all of the different types of current and future plugins.

Details

There are a fixed number of parameters that one can use in defining each plugin type. Some plugins have had to be adapted to handle additional needs (like user interactions via a GUI). There is a middle layer of code that connects the plugin code with the plugin type. In this code there are places where the args get passed around like (item[0], item[1], item[3], item[10]) depending on the plugin type. In addition, some plugins have to go all the way down to the graphics interface (gtk).

Plan:

  1. Update all of the reports to use abstract options ("menu" options) (see discussion here http://www.nabble.com/RFC%3A-Improving-report-options-tf4381788.html#a12491034)
  2. Generalize the report dialogs and remove the need for a report plugin to ever need to define or customize a dialog.
  3. Rethink each plugin type (report, graph, tool, etc) to be a well-defined API
  4. Move each plugin registration and handler from its current specific register_TYPE() to generic register(type=TYPE)

Discussion

This proposal is discussed here:

http://bugs.gramps-project.org/view.php?id=1310

http://www.nabble.com/Report-vs.-ReportDialog-question-tf4645041.html

If you have ideas, comments, or questions, please note them here.