+ /** Return an array associating pathes to the corresponding hook.
+ * array( '/my/path' => make_hook(...),
+ * ...);
+ * @ref make_hook
+ */
+ abstract public function handlers();
+
+ /** Register a hook
+ * @param fun name of the handler (the exact name will be handler_$fun)
+ * @param auth authentification level of needed to run this handler
+ * @param perms permission required to run this handler
+ * @param type additionnal flags
+ *
+ * Perms syntax is the following:
+ * perms = rights(,rights)*
+ * rights = right(:right)*
+ * right is an atomic right permission (like 'admin', 'user', 'groupadmin', 'groupmember'...)
+ *
+ * If type is set to NO_AUTH, the system will return 403 instead of asking auth data
+ * this is useful for Ajax handler
+ * If type is not set to NO_SKIN, the system will consider redirecting the user to https
+ */
+ public function make_hook($fun, $auth, $perms = 'user', $type = DO_AUTH)
+ {
+ return new PlStdHook(array($this, 'handler_' . $fun),
+ $auth, $perms, $type);
+ }
+
+ /** Register a hook that points to a wiki page.
+ */
+ public function make_wiki_hook($auth = AUTH_PUBLIC, $perms = 'user', $type = DO_AUTH)
+ {
+ return new PlWikiHook($auth, $perms, $type);
+ }
+
+ /** Include a 'module-specific' file.
+ * Module specific includes must be in the in the path modules/{modulename}.
+ */
+ public function load($file)