auth:punbb

Differences

This shows you the differences between two versions of the page.

--- auth:punbb [2017-02-07 05:19] – [PunBB or FluxBB Authentication backend] 182.186.153.49
+++ auth:punbb [Unknown date] (current) – removed - external edit (Unknown date) 127.0.0.1
@@ Line 1: / Line 1: @@
-Wretchedness, weight reduction, absence of inspiration, and loss of sex drive can show up quickly and with a retribution. A couple of men never have their hormonal pivot come back to typical subsequent to halting pro shred elite (particularly on the off chance that they were hypogonadal at gauge). Perused more points of interest on this in the segment entitled "HPGA brokenness." Ceasing pro shred elite suddenly because of a disconnected flag: Some of us might take medicines for different conditions alongside pro shred elite. Here and there new pharmaceuticals can expand cholesterol and triglycerides and additionally liver chemicals (I call these "signs").
-http://www.shaperich.com/proshred-elite-review/
-===== Requirements =====
-  * A recent PunBB 1.2.x forum installation (1.3.x support is in beta) / Works also with PunBB's fork: FluxBB 1.2.x and 1.4.rc1
-  * The forum needs to be on the same domain as the wiki
-  * magic_quotes_gpc needs to be **off** ((Either disable in your ''php.ini'' or use ''php_value magic_quotes_gpc off'' in ''.htaccess''))
-===== Configuration =====
-The backend reuses your PunBB configuration. You just need to enable it and set is the ''PUN_ROOT'' define pointing to the installation dir of your PunBB forum. Just add it to your ''conf/local.protected.php'':
-<code php local.protected.php>
-<?php
-  $conf['useacl']  =1;
-  $conf['authtype']='punbb';
-  define('PUN_ROOT','/path/to/punbb/');
-</code>
-This path must be an absolute path, like ''/var/www/free.fr/2/8/mysite/punbb/'' for example and must end with a slash **/**.
-To have your admin users recognized you need to set your [[config:superuser]] option to the name of the PunBB administrator group. How this group is named, varies with the used language of your forum. In a English setup it is usually ''@Administrators'', while French users might need to use ''@Administrateurs''.
-===== Source and Installation with PunBB 1.2.x or FluxBB 1.2.x =====
-Up to DokuWiki 2008-05-05 this backend was included in the DokuWiki install. Newer versions no longer come with this backend.
-To install the backend, create a ''inc/auth/punbb.class.php'' file and copy and paste the following code:
-<code php punbb.class.php>
-<?php
-/**
- * PunBB auth backend
- *
- * Uses external Trust mechanism to check against PunBB's
- * user cookie. PunBB's PUN_ROOT must be defined correctly.
- *
- * @author    Andreas Gohr <andi@splitbrain.org>
- */
-if(!defined('PUN_ROOT')) define('PUN_ROOT', DOKU_INC.'../forum/');
-if(get_magic_quotes_gpc()){
-  nice_die('Sorry the punbb auth backend requires the PHP option
-  <a href="http://www.php.net/manual/en/ref.info.php#ini.magic-quotes-gpc">magic_quotes_gpc</a>
-  to be disabled for proper operation. Either setup your PHP install accordingly or
-  choose a different auth backend.');
-}
-require_once PUN_ROOT.'include/common.php';
-require_once DOKU_INC.'inc/auth/mysql.class.php';
-#dbg($GLOBALS);
-#dbg($pun_user);
-class auth_punbb extends auth_mysql {
-  /**
-   * Constructor.
-   *
-   * Sets additional capabilities and config strings
-   */
-  function auth_punbb(){
-    global $conf;
-    $this->cando['external'] = true;
-    $this->cando['logoff']   = true;
-    // make sure we use a crypt understood by punbb
-    if(function_exists('sha1')){
-      $conf['passcrypt'] = 'sha1';
-    }else{
-      $conf['passcrypt'] = 'md5';
-    }
-    // get global vars from PunBB config
-    global $db_host;
-    global $db_name;
-    global $db_username;
-    global $db_password;
-    global $db_prefix;
-    // now set up the mysql config strings
-    $conf['auth']['mysql']['server']   = $db_host;
-    $conf['auth']['mysql']['user']     = $db_username;
-    $conf['auth']['mysql']['password'] = $db_password;
-    $conf['auth']['mysql']['database'] = $db_name;
-    $conf['auth']['mysql']['checkPass']   = "SELECT u.password AS pass
-                                               FROM ${db_prefix}users AS u, ${db_prefix}groups AS g
-                                              WHERE u.group_id = g.g_id
-                                                AND u.username = '%{user}'
-                                                AND g.g_title   != 'Guest'";
-    $conf['auth']['mysql']['getUserInfo'] = "SELECT password AS pass, realname AS name, email AS mail,
-                                                    id, g_title as `group`
-                                               FROM ${db_prefix}users AS u, ${db_prefix}groups AS g
-                                              WHERE u.group_id = g.g_id
-                                                AND u.username = '%{user}'";
-    $conf['auth']['mysql']['getGroups']   = "SELECT g.g_title as `group`
-                                               FROM ${db_prefix}users AS u, ${db_prefix}groups AS g
-                                              WHERE u.group_id = g.g_id
-                                                AND u.username = '%{user}'";
-    $conf['auth']['mysql']['getUsers']    = "SELECT DISTINCT u.username AS user
-                                               FROM ${db_prefix}users AS u, ${db_prefix}groups AS g
-                                              WHERE u.group_id = g.g_id";
-    $conf['auth']['mysql']['FilterLogin'] = "u.username LIKE '%{user}'";
-    $conf['auth']['mysql']['FilterName']  = "u.realname LIKE '%{name}'";
-    $conf['auth']['mysql']['FilterEmail'] = "u.email    LIKE '%{email}'";
-    $conf['auth']['mysql']['FilterGroup'] = "g.g_title    LIKE '%{group}'";
-    $conf['auth']['mysql']['SortOrder']   = "ORDER BY u.username";
-    $conf['auth']['mysql']['addUser']     = "INSERT INTO ${db_prefix}users
-                                                    (username, password, email, realname)
-                                             VALUES ('%{user}', '%{pass}', '%{email}', '%{name}')";
-    $conf['auth']['mysql']['addGroup']    = "INSERT INTO ${db_prefix}groups (g_title) VALUES ('%{group}')";
-    $conf['auth']['mysql']['addUserGroup']= "UPDATE ${db_prefix}users
-                                                SET group_id=%{gid}
-                                              WHERE id='%{uid}'";
-    $conf['auth']['mysql']['delGroup']    = "DELETE FROM ${db_prefix}groups WHERE g_id='%{gid}'";
-    $conf['auth']['mysql']['getUserID']   = "SELECT id FROM ${db_prefix}users WHERE username='%{user}'";
-    $conf['auth']['mysql']['updateUser']  = "UPDATE ${db_prefix}users SET";
-    $conf['auth']['mysql']['UpdateLogin'] = "username='%{user}'";
-    $conf['auth']['mysql']['UpdatePass']  = "password='%{pass}'";
-    $conf['auth']['mysql']['UpdateEmail'] = "email='%{email}'";
-    $conf['auth']['mysql']['UpdateName']  = "realname='%{name}'";
-    $conf['auth']['mysql']['UpdateTarget']= "WHERE id=%{uid}";
-    $conf['auth']['mysql']['delUserGroup']= "UPDATE ${db_prefix}users SET g_id=4 WHERE id=%{uid}";
-    $conf['auth']['mysql']['getGroupID']  = "SELECT g_id AS id FROM ${db_prefix}groups WHERE g_title='%{group}'";
-    $conf['auth']['mysql']['TablesToLock']= array("${db_prefix}users", "${db_prefix}users AS u",
-                                                  "${db_prefix}groups", "${db_prefix}groups AS g");
-    $conf['auth']['mysql']['debug'] = 1;
-    // call mysql constructor
-    $this->auth_mysql();
-  }
-  /**
-   * Just checks against the $pun_user variable
-   */
-  function trustExternal($user,$pass,$sticky=false){
-    global $USERINFO;
-    global $conf;
-    global $lang;
-    global $pun_user;
-    global $pun_config;
-    $sticky ? $sticky = true : $sticky = false; //sanity check
-    // someone used the login form
-    if(!empty($user)){
-      if($this->checkPass($user,$pass)){
-        $expire = ($sticky) ? time() + 31536000 : 0;
-        $uinfo  = $this->getUserData($user);
-        pun_setcookie($uinfo['id'], auth_cryptPassword($pass), $expire);
-        $pun_user = array();
-        $pun_user['password'] = auth_cryptPassword($pass);
-        $pun_user['username'] = $user;
-        $pun_user['realname'] = $uinfo['name'];
-        $pun_user['email']    = $uinfo['mail'];
-        $pun_user['g_title']  = $uinfo['group'];
-      }else{
-        //invalid credentials - log off
-        msg($lang['badlogin'],-1);
-        auth_logoff();
-        return false;
-      }
-    }
-    if(isset($pun_user) && !$pun_user['is_guest']){
-      // okay we're logged in - set the globals
-      $USERINFO['pass'] = $pun_user['password'];
-      $USERINFO['name'] = $pun_user['realname'];
-      $USERINFO['mail'] = $pun_user['email'];
-      $USERINFO['grps'] = array($pun_user['g_title']);
-      $_SERVER['REMOTE_USER'] = $pun_user['username'];
-      $_SESSION[DOKU_COOKIE]['auth']['user'] = $pun_user['username'];
-      $_SESSION[DOKU_COOKIE]['auth']['info'] = $USERINFO;
-      return true;
-    }
-    // to be sure
-    auth_logoff();
-    return false;
-  }
-  /**
-   * remove punbb cookie on logout
-   */
-  function logOff(){
-    global $pun_user;
-    $pun_user = array();
-    $pun_user['is_guest'] = 1;
-    pun_setcookie(1, random_pass(8), time() + 31536000);
-  }
-}
-//Setup VIM: ex: et ts=2 enc=utf-8 :
-</code>
-===== Source and Installation - punbb 1.3.x =====
-Up to DokuWiki 2008-05-05 this backend was included in the DokuWiki install. Newer versions no longer come with this backend.
-To install the backend, create a ''inc/auth/punbb.class.php'' file and copy and paste the following code:
-<code php punbb.class.php>
-<?php
-/**
- * PunBB 1.3.x auth backend
- *
- * Uses external Trust mechanism to check against PunBB's
- * user cookie. PunBB's FORUM_ROOT must be defined correctly.
- *
- * @author    Andreas Gohr <andi@splitbrain.org>
- */
-// needed if you use URL rewrite in you Wiki and Punbb
-// i.e.: example.com/wiki/article  and  example.com/punbb/topic/1515/subject/
-define('FORUM_IGNORE_REQUEST_URI', 1);
-// do not confirm the action in punbb, usefull for ajax in dokuwiki
-define('FORUM_SKIP_CSRF_CONFIRM', 1);
-if(!defined('FORUM_ROOT')) define('FORUM_ROOT', DOKU_INC.'../forum/');
-if(get_magic_quotes_gpc()){
-  nice_die('Sorry the punbb auth backend requires the PHP option
-  <a href="http://www.php.net/manual/en/ref.info.php#ini.magic-quotes-gpc">magic_quotes_gpc</a>
-  to be disabled for proper operation. Either setup your PHP install accordingly or
-  choose a different auth backend.');
-}
-require_once FORUM_ROOT.'include/common.php';
-require_once DOKU_INC.'inc/auth/mysql.class.php';
-#dbg($GLOBALS);
-#dbg($forum_user);
-class auth_punbb extends auth_mysql {
-  /**
-   * Constructor.
-   *
-   * Sets additional capabilities and config strings
-   */
-  function auth_punbb(){
-    global $conf;
-    $this->cando['external'] = true;
-    $this->cando['logoff']   = true;
-    // make sure we use a crypt understood by punbb
-    if(function_exists('sha1')){
-      $conf['passcrypt'] = 'sha1';
-    }else{
-      $conf['passcrypt'] = 'md5';
-    }
-    // get global vars from PunBB config
-    global $db_host;
-    global $db_name;
-    global $db_username;
-    global $db_password;
-    global $db_prefix;
-    // now set up the mysql config strings
-    $conf['auth']['mysql']['server']   = $db_host;
-    $conf['auth']['mysql']['user']     = $db_username;
-    $conf['auth']['mysql']['password'] = $db_password;
-    $conf['auth']['mysql']['database'] = $db_name;
-    $conf['auth']['mysql']['checkPass']   = "SELECT u.password AS pass
-                                               FROM ${db_prefix}users AS u, ${db_prefix}groups AS g
-                                              WHERE u.group_id = g.g_id
-                                                AND u.username = '%{user}'
-                                                AND g.g_title   != 'Guest'";
-    $conf['auth']['mysql']['getUserInfo'] = "SELECT password AS pass, realname AS name, email AS mail,
-                                                    id, g_title as `group`
-                                               FROM ${db_prefix}users AS u, ${db_prefix}groups AS g
-                                              WHERE u.group_id = g.g_id
-                                                AND u.username = '%{user}'";
-    $conf['auth']['mysql']['getGroups']   = "SELECT g.g_title as `group`
-                                               FROM ${db_prefix}users AS u, ${db_prefix}groups AS g
-                                              WHERE u.group_id = g.g_id
-                                                AND u.username = '%{user}'";
-    $conf['auth']['mysql']['getUsers']    = "SELECT DISTINCT u.username AS user
-                                               FROM ${db_prefix}users AS u, ${db_prefix}groups AS g
-                                              WHERE u.group_id = g.g_id";
-    $conf['auth']['mysql']['FilterLogin'] = "u.username LIKE '%{user}'";
-    $conf['auth']['mysql']['FilterName']  = "u.realname LIKE '%{name}'";
-    $conf['auth']['mysql']['FilterEmail'] = "u.email    LIKE '%{email}'";
-    $conf['auth']['mysql']['FilterGroup'] = "g.g_title    LIKE '%{group}'";
-    $conf['auth']['mysql']['SortOrder']   = "ORDER BY u.username";
-    $conf['auth']['mysql']['addUser']     = "INSERT INTO ${db_prefix}users
-                                                    (username, password, email, realname)
-                                             VALUES ('%{user}', '%{pass}', '%{email}', '%{name}')";
-    $conf['auth']['mysql']['addGroup']    = "INSERT INTO ${db_prefix}groups (g_title) VALUES ('%{group}')";
-    $conf['auth']['mysql']['addUserGroup']= "UPDATE ${db_prefix}users
-                                                SET group_id=%{gid}
-                                              WHERE id='%{uid}'";
-    $conf['auth']['mysql']['delGroup']    = "DELETE FROM ${db_prefix}groups WHERE g_id='%{gid}'";
-    $conf['auth']['mysql']['getUserID']   = "SELECT id FROM ${db_prefix}users WHERE username='%{user}'";
-    $conf['auth']['mysql']['updateUser']  = "UPDATE ${db_prefix}users SET";
-    $conf['auth']['mysql']['UpdateLogin'] = "username='%{user}'";
-    $conf['auth']['mysql']['UpdatePass']  = "password='%{pass}'";
-    $conf['auth']['mysql']['UpdateEmail'] = "email='%{email}'";
-    $conf['auth']['mysql']['UpdateName']  = "realname='%{name}'";
-    $conf['auth']['mysql']['UpdateTarget']= "WHERE id=%{uid}";
-    $conf['auth']['mysql']['delUserGroup']= "UPDATE ${db_prefix}users SET g_id=4 WHERE id=%{uid}";
-    $conf['auth']['mysql']['getGroupID']  = "SELECT g_id AS id FROM ${db_prefix}groups WHERE g_title='%{group}'";
-    $conf['auth']['mysql']['TablesToLock']= array("${db_prefix}users", "${db_prefix}users AS u",
-                                                  "${db_prefix}groups", "${db_prefix}groups AS g");
-    $conf['auth']['mysql']['debug'] = 1;
-    // call mysql constructor
-    $this->auth_mysql();
-  }
-  /**
-   * Just checks against the $forum_user variable
-   */
-  function trustExternal($user,$pass,$sticky=false){
-    global $USERINFO;
-    global $conf;
-    global $lang;
-    global $forum_user;
-    global $pun_config;
-    $sticky ? $sticky = true : $sticky = false; //sanity check
-    // someone used the login form
-    if(!empty($user)){
-      if($this->checkPass($user,$pass)){
-        $expire = ($sticky) ? time() + 31536000 : 0;
-        $uinfo  = $this->getUserData($user);
-        forum_setcookie($uinfo['id'], auth_cryptPassword($pass), $expire);
-        $forum_user = array();
-        $forum_user['password'] = auth_cryptPassword($pass);
-        $forum_user['username'] = $user;
-        $forum_user['realname'] = $uinfo['name'];
-        $forum_user['email']    = $uinfo['mail'];
-        $forum_user['g_title']  = $uinfo['group'];
-      }else{
-        //invalid credentials - log off
-        msg($lang['badlogin'],-1);
-        auth_logoff();
-        return false;
-      }
-    }
-    if(isset($forum_user) && !$forum_user['is_guest']){
-      // okay we're logged in - set the globals
-      $USERINFO['pass'] = $pun_user['password'];
-      $USERINFO['name'] = utf8_encode($forum_user['realname']);
-      $USERINFO['mail'] = $forum_user['email'];
-      $USERINFO['grps'] = array($forum_user['g_title']);
-      $_SERVER['REMOTE_USER'] = utf8_encode($forum_user['username']);
-      $_SESSION[DOKU_COOKIE]['auth']['user'] = utf8_encode($forum_user['username']);
-      $_SESSION[DOKU_COOKIE]['auth']['info'] = $USERINFO;
-      return true;
-    }
-    // to be sure
-    auth_logoff();
-    return false;
-  }
-  /**
-   * remove punbb cookie on logout
-   */
-  function logOff(){
-    global $forum_user;
-    $forum_user = array();
-    $forum_user['is_guest'] = 1;
-    forum_setcookie(1, random_key(8), time() + 31536000);
-  }
-}
-//Setup VIM: ex: et ts=2 enc=utf-8 :
-</code>
-===== Source and Installation - FluxBB 1.4 =====
-Same instructions as with FluxBB 1.2.x, but there are some functions in the file **inc/utf8.php** already defined by FluxBB 1.4 (version 1.4.2), these are:
-  * utf8_strlen
-  * utf8_substr
-  * utf8_ltrim
-  * utf8_rtrim
-  * utf8_trim
-  * utf8_strtolower
-  * utf8_strtoupper
-  * utf8_ucfirst
-  * utf8_strpos
-  * utf8_bad_replace
-Error message: <code>**Fatal error: Cannot redeclare utf8_strlen() (previously declared in ......./inc/utf8.php:132) in ......./include/utf8/mbstring/core.php  on line 28**</code>
-So we need to edit inc/utf8.php in order to only let DokuWiki define these functions if we're not using FluxBB, by adding an check around these function: <code php>if(!defined('PUN_ROOT')) { ... }</code>
-=== Example: utf8_strlen ===
-replace:
-<code php>function utf8_strlen($string){
-  return strlen(utf8_decode($string));
-}</code>
-with:
-<code php>if(!defined('PUN_ROOT')){
-	function utf8_strlen($string){
-	  return strlen(utf8_decode($string));
-	}
-}</code>
-You'll have to apply these modifications 10 times in inc/utf8.php .
-[[oli_v_ier@yahoo.fr|olivier]]
-[[id.2ndr@laposte.net|id2ndr]]
-==== dokuwiki 2010-11-07 "Anteater" ====
-With these version a small modification should be done to avoid the error bellow :
-<file>
-Fatal error: Call to a member function query() on a non-object in /var/www/forum/include/functions.php on line 185
-</file>
-  * Add the line bellow in ''conf/local.protected.php'' (after the definition of PUN_ROOT variable) :<file>include PUN_ROOT.'include/common.php';</file>
-  * Remove the line in ''inc/auth/punbb.class.php'' :<file>require_once PUN_ROOT.'include/common.php';</file>
-=== PunBB CSRF & Ajax problem ===
-If you want to make ajax-quicksearch work, You should define the constant FORUM_SKIP_CSRF_CONFIRM before including any PunBB code
-so, the code above should be like below : <file>define("FORUM_SKIP_CSRF_CONFIRM", 1);
-include PUN_ROOT.'include/common.php';</file>
-==== Dokuwiki 2013-05-10 "Weatherwax" ====
-FIXME **CREATE authplugin for in the repository.**
-  * Configure the auth plugin in conf/local.protected.php :
-    * define('PUN_ROOT','/var/www/pathtotheforum/');
-    * require_once PUN_ROOT.'include/common.php';
-    * $conf['authtype'] = 'authfluxbb';
-  * Create the auth plugin :
-    * **Method 1** (crapy) Adapt from an existing source
-      * Copy the code of [[http://fluxbb.org/forums/viewtopic.php?pid=27043#p27043|this post]] to lib/plugins/authfluxbb/auth.php (authfluxbb/ directory should be created)
-      * Modify some code
-        * Remove <file>require_once DOKU_INC.'inc/auth/mysql.class.php';</file>
-        * Class : <file>class auth_fluxbb_v1_4 extends auth_mysql {</file> become <file>class auth_plugin_authfluxbb extends DokuWiki_Auth_Plugin {</file>
-        * constructor <file>  function auth_fluxbb_v1_4(){</file> become <file>  public function __construct() {
-        parent::__construct();</file>
-    * **Method 2** Put this code in lib/plugins/authfluxbb/auth.php <file php lib/plugins/authfluxbb/auth.php>
-<?php
-/**
- * DokuWiki Plugin authfluxbb (Auth Component)
- *
- * @license GPL 2 http://www.gnu.org/licenses/gpl-2.0.html
- * @author  Id2ndR
- */
-// must be run within Dokuwiki
-if(!defined('DOKU_INC')) die();
-class auth_plugin_authfluxbb extends DokuWiki_Auth_Plugin {
-    /**
-     * Constructor.
-     */
-    public function __construct() {
-        parent::__construct(); // for compatibility
-        // Set capabilities accordingly
-        $this->cando['addUser']     = false; // can Users be created?
-        $this->cando['delUser']     = false; // can Users be deleted?
-        $this->cando['modLogin']    = false; // can login names be changed?
-        $this->cando['modPass']     = false; // can passwords be changed?
-        $this->cando['modName']     = false; // can real names be changed?
-        $this->cando['modMail']     = false; // can emails be changed?
-        $this->cando['modGroups']   = false; // can groups be changed?
-        $this->cando['getUsers']    = false; // can a (filtered) list of users be retrieved?
-        $this->cando['getUserCount']= false; // can the number of users be retrieved?
-        $this->cando['getGroups']   = false; // can a list of available groups be retrieved?
-        $this->cando['external']    = true; // does the module do external auth checking?
-        $this->cando['logout']      = false; // can the user logout again? (eg. not possible with HTTP auth)
-        // FIXME intialize your auth system and set success to true, if successful
-        $this->success = true;
-    }
-    /**
-     * Log off the current user [ OPTIONAL ]
-     */
-    //public function logOff() {
-    //}
-    /**
-     * Do all authentication [ OPTIONAL ]
-     *
-     * @param   string  $user    Username
-     * @param   string  $pass    Cleartext Password
-     * @param   bool    $sticky  Cookie should not expire
-     * @return  bool             true on successful auth
-     */
-    function trustExternal($user,$pass,$sticky=false){
-        global $USERINFO;
-        global $conf;
-        global $lang;
-        global $pun_user;
-        global $pun_config;
-        global $cookie_name;
-        $sticky ? $sticky = true : $sticky = false; //sanity check
-        if(isset($pun_user) && !$pun_user['is_guest']){
-              // okay we're logged in - set the globals
-              $USERINFO['pass'] = $pun_user['password'];
-              $USERINFO['name'] = utf8_encode($pun_user['realname']);
-              $USERINFO['mail'] = $pun_user['email'];
-              $USERINFO['grps'] = array($pun_user['g_title']);
-              if ($pun_user['is_admmod'])
-                $USERINFO['grps'][] = 'admin';
-              $_SERVER['REMOTE_USER'] = utf8_decode($pun_user['username']);
-              $_SESSION[DOKU_COOKIE]['auth']['user'] = $pun_user['username'];
-              $_SESSION[DOKU_COOKIE]['auth']['info'] = $USERINFO;
-              return true;
-        }
-        // to be sure
-        auth_logoff();
-        $USERINFO['grps'] = array();
-        return false;
-    }
-    /**
-     * Check user+password
-     *
-     * May be ommited if trustExternal is used.
-     *
-     * @param   string $user the user name
-     * @param   string $pass the clear text password
-     * @return  bool
-     */
-    public function checkPass($user, $pass) {
-        // FIXME implement password check
-        return false; // return true if okay
-    }
-    /**
-     * Return user info
-     *
-     * Returns info about the given user needs to contain
-     * at least these fields:
-     *
-     * name string  full name of the user
-     * mail string  email addres of the user
-     * grps array   list of groups the user is in
-     *
-     * @param   string $user the user name
-     * @return  array containing user data or false
-     */
-    public function getUserData($user) {
-        // FIXME implement
-        return false;
-    }
-    /**
-     * Create a new User [implement only where required/possible]
-     *
-     * Returns false if the user already exists, null when an error
-     * occurred and true if everything went well.
-     *
-     * The new user HAS TO be added to the default group by this
-     * function!
-     *
-     * Set addUser capability when implemented
-     *
-     * @param  string     $user
-     * @param  string     $pass
-     * @param  string     $name
-     * @param  string     $mail
-     * @param  null|array $grps
-     * @return bool|null
-     */
-    //public function createUser($user, $pass, $name, $mail, $grps = null) {
-        // FIXME implement
-    //    return null;
-    //}
-    /**
-     * Modify user data [implement only where required/possible]
-     *
-     * Set the mod* capabilities according to the implemented features
-     *
-     * @param   string $user    nick of the user to be changed
-     * @param   array  $changes array of field/value pairs to be changed (password will be clear text)
-     * @return  bool
-     */
-    //public function modifyUser($user, $changes) {
-        // FIXME implement
-    //    return false;
-    //}
-    /**
-     * Delete one or more users [implement only where required/possible]
-     *
-     * Set delUser capability when implemented
-     *
-     * @param   array  $users
-     * @return  int    number of users deleted
-     */
-    //public function deleteUsers($users) {
-        // FIXME implement
-    //    return false;
-    //}
-    /**
-     * Bulk retrieval of user data [implement only where required/possible]
-     *
-     * Set getUsers capability when implemented
-     *
-     * @param   int   $start     index of first user to be returned
-     * @param   int   $limit     max number of users to be returned
-     * @param   array $filter    array of field/pattern pairs, null for no filter
-     * @return  array list of userinfo (refer getUserData for internal userinfo details)
-     */
-    //public function retrieveUsers($start = 0, $limit = -1, $filter = null) {
-        // FIXME implement
-    //    return array();
-    //}
-    /**
-     * Return a count of the number of user which meet $filter criteria
-     * [should be implemented whenever retrieveUsers is implemented]
-     *
-     * Set getUserCount capability when implemented
-     *
-     * @param  array $filter array of field/pattern pairs, empty array for no filter
-     * @return int
-     */
-    //public function getUserCount($filter = array()) {
-        // FIXME implement
-    //    return 0;
-    //}
-    /**
-     * Define a group [implement only where required/possible]
-     *
-     * Set addGroup capability when implemented
-     *
-     * @param   string $group
-     * @return  bool
-     */
-    //public function addGroup($group) {
-        // FIXME implement
-    //    return false;
-    //}
-    /**
-     * Retrieve groups [implement only where required/possible]
-     *
-     * Set getGroups capability when implemented
-     *
-     * @param   int $start
-     * @param   int $limit
-     * @return  array
-     */
-    //public function retrieveGroups($start = 0, $limit = 0) {
-        // FIXME implement
-    //    return array();
-    //}
-    /**
-     * Return case sensitivity of the backend
-     *
-     * When your backend is caseinsensitive (eg. you can login with USER and
-     * user) then you need to overwrite this method and return false
-     *
-     * @return bool
-     */
-    public function isCaseSensitive() {
-        return true;
-    }
-    /**
-     * Sanitize a given username
-     *
-     * This function is applied to any user name that is given to
-     * the backend and should also be applied to any user name within
-     * the backend before returning it somewhere.
-     *
-     * This should be used to enforce username restrictions.
-     *
-     * @param string $user username
-     * @return string the cleaned username
-     */
-    public function cleanUser($user) {
-        return $user;
-    }
-    /**
-     * Sanitize a given groupname
-     *
-     * This function is applied to any groupname that is given to
-     * the backend and should also be applied to any groupname within
-     * the backend before returning it somewhere.
-     *
-     * This should be used to enforce groupname restrictions.
-     *
-     * Groupnames are to be passed without a leading '@' here.
-     *
-     * @param  string $group groupname
-     * @return string the cleaned groupname
-     */
-    public function cleanGroup($group) {
-        return $group;
-    }
-    /**
-     * Check Session Cache validity [implement only where required/possible]
-     *
-     * DokuWiki caches user info in the user's session for the timespan defined
-     * in $conf['auth_security_timeout'].
-     *
-     * This makes sure slow authentication backends do not slow down DokuWiki.
-     * This also means that changes to the user database will not be reflected
-     * on currently logged in users.
-     *
-     * To accommodate for this, the user manager plugin will touch a reference
-     * file whenever a change is submitted. This function compares the filetime
-     * of this reference file with the time stored in the session.
-     *
-     * This reference file mechanism does not reflect changes done directly in
-     * the backend's database through other means than the user manager plugin.
-     *
-     * Fast backends might want to return always false, to force rechecks on
-     * each page load. Others might want to use their own checking here. If
-     * unsure, do not override.
-     *
-     * @param  string $user - The username
-     * @return bool
-     */
-    //public function useSessionCache($user) {
-      // FIXME implement
-    //}
-}
-// vim:ts=4:sw=4:et:
-</file>
-===== Discussion =====
-  * Some username are not understand by DokuWiki (Pérot became P�rot or PÃ©rot)
-DokuWiki uses UTF-8 and PunBB ISO8859-1, so this is just a character encoding problem. In order to get the right usernames, open /dokuwiki/inc/auth/punbb.class.php, find (l136 on v. 2007-06-26b) :
-<code php>    if(isset($pun_user) && !$pun_user['is_guest']){
-      // okay we're logged in - set the globals
-      $USERINFO['pass'] = $pun_user['password'];
-      $USERINFO['name'] = $pun_user['realname'];
-      $USERINFO['mail'] = $pun_user['email'];
-      $USERINFO['grps'] = array($pun_user['g_title']);
-      $_SERVER['REMOTE_USER'] = $pun_user['username'];
-      $_SESSION[DOKU_COOKIE]['auth']['user'] = $pun_user['username'];
-      $_SESSION[DOKU_COOKIE]['auth']['info'] = $USERINFO;
-      return true;
-    }</code>
-And replace by :
-<code php>    if(isset($pun_user) && !$pun_user['is_guest']){
-      // okay we're logged in - set the globals
-      $USERINFO['pass'] = $pun_user['password'];
-      $USERINFO['name'] = utf8_encode($pun_user['realname']);
-      $USERINFO['mail'] = $pun_user['email'];
-      $USERINFO['grps'] = array($pun_user['g_title']);
-      $_SERVER['REMOTE_USER'] = utf8_encode($pun_user['username']);
-      $_SESSION[DOKU_COOKIE]['auth']['user'] = utf8_encode($pun_user['username']);
-      $_SESSION[DOKU_COOKIE]['auth']['info'] = $USERINFO;
-      return true;
-    }</code>
-//[[http://www.punbb.fr|Maximilien Thiel]] 2007-11-13 - 11:00 UTC +01:00//
-  * As punbb 1.3 will support utf8, a better patch is :<code php>
-      // okay we're logged in - set the globals
-      $USERINFO['pass'] = $pun_user['password'];
-      $USERINFO['name'] = preg_match('/^1\.2/',$pun_config['o_cur_version']) ? utf8_encode($pun_user['realname']) : $pun_user['realname'];
-      $USERINFO['mail'] = $pun_user['email'];
-      $USERINFO['grps'] = array($pun_user['g_title']);
-</code> (only the $USERINFO['name'] line is changed)\\ [[http://www.zeitoun.net|Stéphane Gully]]
-  * I think there is a problem when you use DokuWiki's ACL : a regular member with appropriate rights under PunBB can not edit a page though ACL seems properly configured (changes forbidden in : but allowed in :help: ). The problem may come from the fact DokuWiki has a "user" group while PunBB has a "members" and this is not *always* correctly seen.
-    * yann: edit the file conf/acl.auth.php, add there the group members (duplicate the line with "user", and replace "user" by "members".
-    * Better yet, use the group Members as is defined in the table groups in the PunBB MySQL database.
-  * With Dokuwiki 2012-10-13 Adora Belle, the auth stoped working with following error:<file>PHP Fatal error:  Call to undefined method auth_punbb::auth_mysql() in [...]/inc/auth/punbb.class.php on line 102, referer: [...]</file>
-  * To fix it, you need to change the line 102 from //$this->auth_mysql();// to //$this->**__construct()**;//.

auth/punbb.1486441199.txt.gz · Last modified: 2017-02-07 05:19 by 182.186.153.49