Plugin: Help

Name	Help
Files	help.swf help.asul
Related plugins	Navigationbar

This plugin provides a simple help window in which help messages on how to use the engine can be displayed to the actual user.

The language used for the help window is the same as the actual language valid for the book, i.e. either the default language English or the language defined with the lang parameter. The language file of the chosen language must be provided in the megazine/langs/ folder, which in the case of the help plugin is named help.xml.

This plugin strongly depends on the navigationbar plugin, to display the button to open it.

[edit] Settings

openhelp

• Type: {once, always, never}
• Default: once

This determines whether to open the help window automatically when the engine starts up. The possible values are

• once, meaning it will be loaded the first time a user visits a book on one domain, after that a "Flash cookie" will be created to remember it was displayed.
• always, opens the help window whenever the user revisits a book on one domain.
• never, never automatically opens the help window.

[edit] Attributes

[edit] Book

helpmodal

• Type: Boolean
• Default: true
• Version: 2.0.10

This controls whether the help window should behave like a modal window. In that case book interaction will be disabled while the window is opened, meaning it won't be possible to turn pages (neither by clicking, nor via keypresses).

If you prefer the window to not block book interaction, set this to false and make sure to remove the blocker area in the help plugin's ASUL definition.

[edit] Examples

<book plugins="help" openhelp="never">
    <!-- ... -->
</book>