Feature request #2562
Two fixes to utils.py
Status: | Closed | ||
---|---|---|---|
Priority: | Low | ||
Assignee: | |||
Category: | Python plugins | ||
Pull Request or Patch supplied: | Resolution: | fixed | |
Easy fix?: | No | Copied to github as #: | 12622 |
Description
This patch makes two changes to utils.py.
1) updates the canUninstallPlugin function to provide a bit more robustness, in particular to allow the plugin to be uninstalled if its canBeUninstalled function throws an exception.
2) adds a new function showPluginHelp. This is designed to be called from a plugin, using
from qgis import utils
utils.showPluginHelp()
This will open a help file in the plugin directory in the users browser. It will first look for index-ll.html, where ll is the major locale, and if it doesn't find that, will try index.html. This allows for multiple language versions of the help file. It has optional parameters to replace "index" with an alternative helpfile name, and to append an html anchor to the url to jump to directly to a section of the helpfile.
The function can also be called specifying a package name, e.g.
utils.showPluginHelp("MyFavouritePlugin")
The intention of this is to provide a simple common way for python plugins to supply documentation
History
#1
Updated by Borys Jurgiel over 14 years ago
- Resolution set to fixed
- Status changed from Open to Closed
Implemented in and e5fb2d37 (SVN r13101). The utils.showPluginHelp() looks for the help file in the following order:
1. index-ll_CC.html
2. index-ll.html
3. index-en.html
4. index-en_US.html