aboutsummaryrefslogtreecommitdiffstats
path: root/phpBB/includes/auth/provider_interface.php
diff options
context:
space:
mode:
Diffstat (limited to 'phpBB/includes/auth/provider_interface.php')
-rw-r--r--phpBB/includes/auth/provider_interface.php32
1 files changed, 31 insertions, 1 deletions
diff --git a/phpBB/includes/auth/provider_interface.php b/phpBB/includes/auth/provider_interface.php
index ac7bb311a3..8d966d8b3e 100644
--- a/phpBB/includes/auth/provider_interface.php
+++ b/phpBB/includes/auth/provider_interface.php
@@ -22,11 +22,41 @@ if (!defined('IN_PHPBB'))
*/
class phpbb_auth_provider_interface
{
+ /**
+ * Checks whether the user is currently identified to the authentication
+ * provider.
+ * Called in acp_board while setting authentication plugins.
+ *
+ * @return boolean|string False if the user is identified, otherwise an
+ * error message.
+ */
public function init();
- public function login();
+ /**
+ * Performs login.
+ *
+ * @param $username string The name of the user being authenticated.
+ * @param $password string The password of the user.
+ * @return array An associative array of the format:
+ * array(
+ * 'status' => status constant
+ * 'error_msg' => string
+ * 'user_row' => array
+ * )
+ */
+ public function login($username, $password);
+ /**
+ * Autologin function
+ *
+ * @return array containing the user row or empty if no auto login should
+ * take place
+ */
public function autologin();
+ /**
+ * This function is used to output any required fields in the authentication
+ * admin panel. It also defines any required configuration table fields.
+ */
public function acp();
}