Sample Plugins demonstrating retrieving/saving preferences

DiapDealer · 02-01-2015, 05:22 PM

Because storing preferences can be important for a Plugin, I have designed a new python launcher preferences class and integrated it right into the *container classes, so persistent preferences storage is easily available for all plugins.

To illustrate how to create and use these settings, I've designed two simple plugins that demonstrate how the interface should be used.

See the attached "PrefsExampleGroups_v0.0.2.zip" and "PrefsExampleSimple_v0.0.2.zip".

Important
In order to use this new preferences interface, you will need to be using Sigil v0.8.3 or greater.

Install them, use them, and inspect the code in plugin.py

In a nutshell:

From within the run method of plugin.py

Code:

# Get preferences from json file  
prefs = bk.getPrefs() # a dictionary

Code:

# Set some defaults (used only when no preferences exist yet--like first run).
prefs.defaults['lastDir'] = os.path.expanduser('~')
prefs.defaults['lastFile'] = ''

Code:

# Use a preference variable
print ('Last directory opened = ', prefs['lastDir'])

Code:

# Set/change preference variable
prefs['lastDir'] = os.path.dirname(inpath)

Code:

# Save prefs back to json file
bk.savePrefs(prefs)

Toxaris · 02-02-2015, 02:53 AM

Where will the JSON file be stored and what will it be called?

DiapDealer · 02-02-2015, 08:18 AM

A "plugins_prefs" directory will be created in the Sigil user preferences folder (use the "Open Preferences Location" button from the Sigil preferences dialog). Each plugin will have it's own subdirectory there (plugin name) and the <plugin name>.json file will be in that subdirectory.

The directory structure won't be there until the plugin saves its preferences for the first time, though.

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Preferences -> Saving books to disk -> Format dates as	steje	Library Management	4	08-15-2011 04:01 PM
Preferences -> Plugins does not exist ??	net-buoy	Plugins	2	02-20-2011 05:49 PM
Preferences - Plugins, Tweaks Missing	Ruffy	Calibre	2	02-16-2011 02:13 AM
Journal Not Saving Writing When Moving to a New Page or Saving it	eberhardt333	enTourage Archive	5	11-24-2010 01:47 AM
Found good blog demonstrating pdf ability of kindle 3	Ncage1974	Amazon Kindle	0	08-31-2010 01:54 AM

02-02-2015, 02:53 AM	#2
Toxaris Wizard Posts: 4,520 Karma: 121692313 Join Date: Oct 2009 Location: Heemskerk, NL Device: PRS-T1, Kobo Touch, Kobo Aura	Where will the JSON file be stored and what will it be called?

02-02-2015, 08:18 AM	#3
DiapDealer Grand Sorcerer Posts: 28,040 Karma: 199464182 Join Date: Jan 2010 Device: Nexus 7, Kindle Fire HD	A "plugins_prefs" directory will be created in the Sigil user preferences folder (use the "Open Preferences Location" button from the Sigil preferences dialog). Each plugin will have it's own subdirectory there (plugin name) and the <plugin name>.json file will be in that subdirectory. The directory structure won't be there until the plugin saves its preferences for the first time, though.

Advert