Changes between Version 2 and Version 3 of GuardPlugin

Timestamp:

2010-08-19T18:30:17Z (14 years ago)

Author:

Pan Luo

Comment:

--

GuardPlugin

@@ -53 +53 @@
 Some of the AuthComponent properties can be override through the configuration file.
 
-== Using Existing Authentication Modules ==
+== Using Existing Modules ==
 Currently, the authentication modules that come with the plugin are:
 
@@ -85 +85 @@
 * loginError: The error message when user logged in successfully through Shibboleth but do not have an valid account or permission in the application. This is an example to override the [http://api13.cakephp.org/class/auth-component AuthComponent] properties. 
 
-== Developing New Authentication Module ==
+
+== Customize Modules ==
+
+By default, the existing modules come with a simple login template under app/plugins/guard/views/guard. Each module has its own element for the login template under app/plugins/guard/views/elements, e.g. text input for Default and login button for Shibboleth. 
+
+If you want to customize the template or elements:
+ * Create app/views/plugins/guard/guard/login.ctp for template
+ * Create app/views/plugins/guard/elements/login_MODULENAME.ctp for elemets
+ * The MODULENAME is the authentication module you want to customize, e.g. Shibboleth or Default
+ * Now CakePHP will render your template or elements instead of default ones
+
+
+== Developing New Module ==
 All the authentication modules extend !AuthModule, which provides some default properties and methods required by the authentication module. 
 Every authentication must implement  authenticate() method to verify the user. The authentication module should like look this:
@@ -102 +114 @@
  * $hasLoginForm: If this module has login form
 
+The new module should be placed in app/libs with the name like: MODULENAME_module.php