No jquery.ui for now.

[lhc/web/wiklou.git] / includes / AuthPlugin.php

diff --git a/includes/AuthPlugin.php b/includes/AuthPlugin.php
index f4a4b10..87ac8ad 100644 (file)
--- a/includes/AuthPlugin.php
+++ b/includes/AuthPlugin.php
@@ -63,8 +63,9 @@ class AuthPlugin {
         * Modify options in the login template.
         *
         * @param $template UserLoginTemplate object.
+        * @param $type String 'signup' or 'login'.
         */
-       public function modifyUITemplate( &$template ) {
+       public function modifyUITemplate( &$template, &$type ) {
                # Override this!
                $template->set( 'usedomain', false );
        }
@@ -97,7 +98,7 @@ class AuthPlugin {
         * The User object is passed by reference so it can be modified; don't
         * forget the & on your function declaration.
         *
-        * @param User $user
+        * @param $user User object
         */
        public function updateUser( &$user ) {
                # Override this and do something
@@ -116,46 +117,38 @@ class AuthPlugin {
         *
         * This is just a question, and shouldn't perform any actions.
         *
-        * @return bool
+        * @return Boolean
         */
        public function autoCreate() {
                return false;
        }
 
        /**
-        * Can users change their passwords?
-        *
-        * @return bool
-        */
-       public function allowPasswordChange() {
-               return true;
-       }
-       
-       /**
-        * Can users change their Real Name?
-        *
-        * @return bool
-        */
-       public function allowRealNameChange() {
-               return false;
-       }
-
-       /**
-        * Can users change their email address?
+        * Allow a property change? Properties are the same as preferences
+        * and use the same keys. 'Realname' 'Emailaddress' and 'Nickname'
+        * all reference this.
         *
-        * @return bool
+        * @return Boolean
         */
-       public function allowEmailChange() {
-               return false;
+       public function allowPropChange( $prop = '' ) {
+               if( $prop == 'realname' && is_callable( array( $this, 'allowRealNameChange' ) ) ) {
+                       return $this->allowRealNameChange();
+               } elseif( $prop == 'emailaddress' && is_callable( array( $this, 'allowEmailChange' ) ) ) {
+                       return $this->allowEmailChange();
+               } elseif( $prop == 'nickname' && is_callable( array( $this, 'allowNickChange' ) ) ) {
+                       return $this->allowNickChange();
+               } else {
+                       return true;
+               }
        }
 
        /**
-        * Can users change their Nickname?
+        * Can users change their passwords?
         *
         * @return bool
         */
-       public function allowNickChange() {
-               return false;
+       public function allowPasswordChange() {
+               return true;
        }
 
        /**
@@ -179,7 +172,7 @@ class AuthPlugin {
         * Return true if successful.
         *
         * @param $user User object.
-        * @return bool
+        * @return Boolean
         */
        public function updateExternalDB( $user ) {
                return true;
@@ -188,7 +181,7 @@ class AuthPlugin {
        /**
         * Check to see if external accounts can be created.
         * Return true if external accounts can be created.
-        * @return bool
+        * @return Boolean
         */
        public function canCreateAccounts() {
                return false;
@@ -198,11 +191,11 @@ class AuthPlugin {
         * Add a user to the external authentication database.
         * Return true if successful.
         *
-        * @param User $user - only the name should be assumed valid at this point
-        * @param string $password
-        * @param string $email
-        * @param string $realname
-        * @return bool
+        * @param $user User: only the name should be assumed valid at this point
+        * @param $password String
+        * @param $email String
+        * @param $realname String
+        * @return Boolean
         */
        public function addUser( $user, $password, $email='', $realname='' ) {
                return true;
@@ -215,7 +208,7 @@ class AuthPlugin {
         *
         * This is just a question, and shouldn't perform any actions.
         *
-        * @return bool
+        * @return Boolean
         */
        public function strict() {
                return false;
@@ -226,7 +219,7 @@ class AuthPlugin {
         * If either this or strict() returns true, local authentication is not used.
         *
         * @param $username String: username.
-        * @return bool
+        * @return Boolean
         */
        public function strictUserAuth( $username ) {
                return false;
@@ -241,7 +234,7 @@ class AuthPlugin {
         * forget the & on your function declaration.
         *
         * @param $user User object.
-        * @param $autocreate bool True if user is being autocreated on login
+        * @param $autocreate Boolean: True if user is being autocreated on login
         */
        public function initUser( &$user, $autocreate=false ) {
                # Override this to do something.
@@ -259,7 +252,6 @@ class AuthPlugin {
         * Get an instance of a User object
         *
         * @param $user User
-        * @public
         */
        public function getUserInstance( User &$user ) {
                return new AuthPluginUser( $user );