Github user riknoll commented on a diff in the pull request:
https://github.com/apache/cordova-docs/pull/489#discussion_r53703389
--- Diff: www/docs/en/dev/guide/appdev/hooks/index.md ---
@@ -115,41 +218,86 @@ As a plugin developer you can define hook scripts
using `<hook>` elements in a `
<hook type="before_plugin_install" src="scripts/beforeInstall.js" />
<hook type="after_build" src="scripts/afterBuild.js" />
- <platform name="wp8">
- <hook type="before_plugin_install"
src="scripts/wp8BeforeInstall.js" />
- <hook type="before_build" src="scripts/wp8BeforeBuild.js" />
+ <platform name="android">
+ <hook type="before_plugin_install"
src="scripts/androidBeforeInstall.js" />
+ <hook type="before_build" src="scripts/androidBeforeBuild.js" />
...
</platform>
-`before_plugin_install`, `after_plugin_install`, `before_plugin_uninstall`
plugin hooks will be fired exclusively for the plugin being
installed/uninstalled.
+`before_plugin_install`, `after_plugin_install`, `before_plugin_uninstall`
plugin hooks will be fired
+exclusively for the plugin being installed/uninstalled.
+
+### Via `/hooks` directory (Deprecated)
+
+To execute custom action when corresponding hook type is fired, use hook
type as a name for a subfolder inside 'hooks' directory and place you script
file here, for example:
+
+ # script file will be automatically executed after each build
+ hooks/after_build/after_build_custom_action.js
+
+When using these hooks, they will always be run as executable files, not
as loadable JavaScript modules.
+
+__Remember__: Make your scripts executable in this case.
+
+__Note__: this method is considered deprecated in favor of the hook
elements in config.xml and plugin.xml.
+
+### Order of Hooks execution
+
+#### Based on Hooks Definition
+
+Hook scripts could be defined by adding them to the special predefined
folder
+(`/hooks`) or via configuration files (`config.xml` and `plugin.xml`) and
run
+serially in the following order:
+
+* Application hooks from `/hooks`;
+* Application hooks from `config.xml`;
+* Plugin hooks from `plugins/.../plugin.xml`.
+
+#### Based on the Internal order of execution
+
+The internal order of execution of hooks is fixed.
+
+##### Example 1
--- End diff --
Make it clear in these examples what Cordova CLI command is being run.
Instead of calling these Example 1 and Example 2, give them more descriptive
headers. A person scrolling through the page should be able to find what they
are looking for.
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
