[maemo-developers] [Fremantle] Best Way To Present Settings/Options For Home Plugin

[From: Graham Cobb]

On Monday 07 September 2009 22:52:14 Brent Chiodo wrote:
> I'm developing a Desktop plugin for Fremantle and have a question about how
> to present plugin Options/Settings.

I have just done this for GPE.

The documentation in the libhildondesktop Reference Manual 
(http://maemo.org/api_refs/5.0/beta/libhildondesktop/HDHomePluginItem.html) 
is quite "light" (look at the section for HDHomePluginItem).  Basically you 
have to set the "settings" property to tell the desktop you support settings 
and then connect to the "show-settings" signal.

The example home applet in maemo-examples doesn't show this, unfortunately.  
Feel free to look at the code in the GPE homepage applet which may not be 
ideal but which does work (at least in the scratchbox environment).  You can 
get it by doing:

svn export http://projects.linuxtogo.org/svn/gpe/trunk/extra/gpe-summary

(projects.linuxtogo.org has been down all day but I hope it will be back 
soon).

Look towards the end of gpesummary.c to see the Fremantle code I have added, 
which includes invoking the settings dialog.

Graham