onokazu
onoka****@users*****
2005年 6月 28日 (火) 16:45:06 JST
Index: xoops2jp/html/kernel/member.php diff -u xoops2jp/html/kernel/member.php:1.2 xoops2jp/html/kernel/member.php:1.3 --- xoops2jp/html/kernel/member.php:1.2 Fri Mar 18 21:52:14 2005 +++ xoops2jp/html/kernel/member.php Tue Jun 28 16:45:06 2005 @@ -1,418 +1,418 @@ -<?php -// $Id: member.php,v 1.2 2005/03/18 12:52:14 onokazu Exp $ -// ------------------------------------------------------------------------ // -// XOOPS - PHP Content Management System // -// Copyright (c) 2000 XOOPS.org // -// <http://www.xoops.org/> // -// ------------------------------------------------------------------------ // -// This program is free software; you can redistribute it and/or modify // -// it under the terms of the GNU General Public License as published by // -// the Free Software Foundation; either version 2 of the License, or // -// (at your option) any later version. // -// // -// You may not change or alter any portion of this comment or credits // -// of supporting developers from this source code or any supporting // -// source code which is considered copyrighted (c) material of the // -// original comment or credit authors. // -// // -// This program is distributed in the hope that it will be useful, // -// but WITHOUT ANY WARRANTY; without even the implied warranty of // -// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // -// GNU General Public License for more details. // -// // -// You should have received a copy of the GNU General Public License // -// along with this program; if not, write to the Free Software // -// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA // -// ------------------------------------------------------------------------ // -// Author: Kazumi Ono (AKA onokazu) // -// URL: http://www.myweb.ne.jp/, http://www.xoops.org/, http://jp.xoops.org/ // -// Project: The XOOPS Project // -// ------------------------------------------------------------------------- // - -if (!defined('XOOPS_ROOT_PATH')) { - exit(); -} -require_once XOOPS_ROOT_PATH.'/kernel/user.php'; -require_once XOOPS_ROOT_PATH.'/kernel/group.php'; - -/** -* XOOPS member handler class. -* This class provides simple interface (a facade class) for handling groups/users/ -* membership data. -* -* -* @author Kazumi Ono <onoka****@xoops*****> -* @copyright copyright (c) 2000-2003 XOOPS.org -* @package kernel -*/ - -class XoopsMemberHandler{ - - /**#@+ - * holds reference to group handler(DAO) class - * @access private - */ - var $_gHandler; - - /** - * holds reference to user handler(DAO) class - */ - var $_uHandler; - - /** - * holds reference to membership handler(DAO) class - */ - var $_mHandler; - - /** - * holds temporary user objects - */ - var $_members = array(); - /**#@-*/ - - /** - * constructor - * - */ - function XoopsMemberHandler(&$db) - { - $this->_gHandler = new XoopsGroupHandler($db); - $this->_uHandler = new XoopsUserHandler($db); - $this->_mHandler = new XoopsMembershipHandler($db); - } - - /** - * create a new group - * - * @return object XoopsGroup reference to the new group - */ - function &createGroup() - { - return $this->_gHandler->create(); - } - - /** - * create a new user - * - * @return object XoopsUser reference to the new user - */ - function &createUser() - { - return $this->_uHandler->create(); - } - - /** - * retrieve a group - * - * @param int $id ID for the group - * @return object XoopsGroup reference to the group - */ - function getGroup($id) - { - return $this->_gHandler->get($id); - } - - /** - * retrieve a user - * - * @param int $id ID for the user - * @return object XoopsUser reference to the user - */ - function &getUser($id) - { - if (!isset($this->_members[$id])) { - $this->_members[$id] =& $this->_uHandler->get($id); - } - return $this->_members[$id]; - } - - /** - * delete a group - * - * @param object $group reference to the group to delete - * @return bool FALSE if failed - */ - function deleteGroup(&$group) - { - $this->_gHandler->delete($group); - $this->_mHandler->deleteAll(new Criteria('groupid', $group->getVar('groupid'))); - return true; - } - - /** - * delete a user - * - * @param object $user reference to the user to delete - * @return bool FALSE if failed - */ - function deleteUser(&$user) - { - $this->_uHandler->delete($user); - $this->_mHandler->deleteAll(new Criteria('uid', $user->getVar('uid'))); - return true; - } - - /** - * insert a group into the database - * - * @param object $group reference to the group to insert - * @return bool TRUE if already in database and unchanged - * FALSE on failure - */ - function insertGroup(&$group) - { - return $this->_gHandler->insert($group); - } - - /** - * insert a user into the database - * - * @param object $user reference to the user to insert - * @return bool TRUE if already in database and unchanged - * FALSE on failure - */ - function insertUser(&$user, $force = false) - { - return $this->_uHandler->insert($user, $force); - } - - /** - * retrieve groups from the database - * - * @param object $criteria {@link CriteriaElement} - * @param bool $id_as_key use the group's ID as key for the array? - * @return array array of {@link XoopsGroup} objects - */ - function getGroups($criteria = null, $id_as_key = false) - { - return $this->_gHandler->getObjects($criteria, $id_as_key); - } - - /** - * retrieve users from the database - * - * @param object $criteria {@link CriteriaElement} - * @param bool $id_as_key use the group's ID as key for the array? - * @return array array of {@link XoopsUser} objects - */ - function getUsers($criteria = null, $id_as_key = false) - { - return $this->_uHandler->getObjects($criteria, $id_as_key); - } - - /** - * get a list of groupnames and their IDs - * - * @param object $criteria {@link CriteriaElement} object - * @return array associative array of group-IDs and names - */ - function &getGroupList($criteria = null) - { - $groups =& $this->_gHandler->getObjects($criteria, true); - $ret = array(); - foreach (array_keys($groups) as $i) { - $ret[$i] = $groups[$i]->getVar('name'); - } - return $ret; - } - - /** - * get a list of usernames and their IDs - * - * @param object $criteria {@link CriteriaElement} object - * @return array associative array of user-IDs and names - */ - function getUserList($criteria = null) - { - $users =& $this->_uHandler->getObjects($criteria, true); - $ret = array(); - foreach (array_keys($users) as $i) { - $ret[$i] = $users[$i]->getVar('uname'); - } - return $ret; - } - - /** - * add a user to a group - * - * @param int $group_id ID of the group - * @param int $user_id ID of the user - * @return object XoopsMembership - */ - function addUserToGroup($group_id, $user_id) - { - $mship =& $this->_mHandler->create(); - $mship->setVar('groupid', $group_id); - $mship->setVar('uid', $user_id); - return $this->_mHandler->insert($mship); - } - - /** - * remove a list of users from a group - * - * @param int $group_id ID of the group - * @param array $user_ids array of user-IDs - * @return bool success? - */ - function removeUsersFromGroup($group_id, $user_ids = array()) - { - $criteria = new CriteriaCompo(); - $criteria->add(new Criteria('groupid', $group_id)); - $criteria2 = new CriteriaCompo(); - foreach ($user_ids as $uid) { - $criteria2->add(new Criteria('uid', $uid), 'OR'); - } - $criteria->add($criteria2); - return $this->_mHandler->deleteAll($criteria); - } - - /** - * get a list of users belonging to a group - * - * @param int $group_id ID of the group - * @param bool $asobject return the users as objects? - * @param int $limit number of users to return - * @param int $start index of the first user to return - * @return array Array of {@link XoopsUser} objects (if $asobject is TRUE) - * or of associative arrays matching the record structure in the database. - */ - function getUsersByGroup($group_id, $asobject = false, $limit = 0, $start = 0) - { - $user_ids =& $this->_mHandler->getUsersByGroup($group_id, $limit, $start); - if (!$asobject) { - return $user_ids; - } else { - $ret = array(); - foreach ($user_ids as $u_id) { - $user =& $this->getUser($u_id); - if (is_object($user)) { - $ret[] =& $user; - } - unset($user); - } - return $ret; - } - } - - /** - * get a list of groups that a user is member of - * - * @param int $user_id ID of the user - * @param bool $asobject return groups as {@link XoopsGroup} objects or arrays? - * @return array array of objects or arrays - */ - function getGroupsByUser($user_id, $asobject = false) - { - $group_ids =& $this->_mHandler->getGroupsByUser($user_id); - if (!$asobject) { - return $group_ids; - } else { - foreach ($group_ids as $g_id) { - $ret[] =& $this->getGroup($g_id); - } - return $ret; - } - } - - /** - * log in a user - * - * @param string $uname username as entered in the login form - * @param string $pwd password entered in the login form - * @return object XoopsUser reference to the logged in user. FALSE if failed to log in - */ - function &loginUser($uname, $pwd) - { - $criteria = new CriteriaCompo(new Criteria('uname', $uname)); - $criteria->add(new Criteria('pass', md5($pwd))); - $user =& $this->_uHandler->getObjects($criteria, false); - if (!$user || count($user) != 1) { - return false; - } - return $user[0]; - } - - /** - * logs in a user with an nd5 encrypted password - * - * @param string $uname username - * @param string $md5pwd password encrypted with md5 - * @return object XoopsUser reference to the logged in user. FALSE if failed to log in - */ - function &loginUserMd5($uname, $md5pwd) - { - $criteria = new CriteriaCompo(new Criteria('uname', $uname)); - $criteria->add(new Criteria('pass', $md5pwd)); - $user =& $this->_uHandler->getObjects($criteria, false); - if (!$user || count($user) != 1) { - return false; - } - return $user[0]; - } - - /** - * count users matching certain conditions - * - * @param object $criteria {@link CriteriaElement} object - * @return int - */ - function getUserCount($criteria = null) - { - return $this->_uHandler->getCount($criteria); - } - - /** - * count users belonging to a group - * - * @param int $group_id ID of the group - * @return int - */ - function getUserCountByGroup($group_id) - { - return $this->_mHandler->getCount(new Criteria('groupid', $group_id)); - } - - /** - * updates a single field in a users record - * - * @param object $user reference to the {@link XoopsUser} object - * @param string $fieldName name of the field to update - * @param string $fieldValue updated value for the field - * @return bool TRUE if success or unchanged, FALSE on failure - */ - function updateUserByField(&$user, $fieldName, $fieldValue) - { - $user->setVar($fieldName, $fieldValue); - return $this->insertUser($user); - } - - /** - * updates a single field in a users record - * - * @param string $fieldName name of the field to update - * @param string $fieldValue updated value for the field - * @param object $criteria {@link CriteriaElement} object - * @return bool TRUE if success or unchanged, FALSE on failure - */ - function updateUsersByField($fieldName, $fieldValue, $criteria = null) - { - return $this->_uHandler->updateAll($fieldName, $fieldValue, $criteria); - } - - /** - * activate a user - * - * @param object $user reference to the {@link XoopsUser} object - * @return bool successful? - */ - function activateUser(&$user) - { - if ($user->getVar('level') != 0) { - return true; - } - $user->setVar('level', 1); - return $this->_uHandler->insert($user, true); - } - -} -?> +<?php +// $Id: member.php,v 1.3 2005/06/28 07:45:06 onokazu Exp $ +// ------------------------------------------------------------------------ // +// XOOPS - PHP Content Management System // +// Copyright (c) 2000 XOOPS.org // +// <http://www.xoops.org/> // +// ------------------------------------------------------------------------ // +// This program is free software; you can redistribute it and/or modify // +// it under the terms of the GNU General Public License as published by // +// the Free Software Foundation; either version 2 of the License, or // +// (at your option) any later version. // +// // +// You may not change or alter any portion of this comment or credits // +// of supporting developers from this source code or any supporting // +// source code which is considered copyrighted (c) material of the // +// original comment or credit authors. // +// // +// This program is distributed in the hope that it will be useful, // +// but WITHOUT ANY WARRANTY; without even the implied warranty of // +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // +// GNU General Public License for more details. // +// // +// You should have received a copy of the GNU General Public License // +// along with this program; if not, write to the Free Software // +// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA // +// ------------------------------------------------------------------------ // +// Author: Kazumi Ono (AKA onokazu) // +// URL: http://www.myweb.ne.jp/, http://www.xoops.org/, http://jp.xoops.org/ // +// Project: The XOOPS Project // +// ------------------------------------------------------------------------- // + +if (!defined('XOOPS_ROOT_PATH')) { + exit(); +} +require_once XOOPS_ROOT_PATH.'/kernel/user.php'; +require_once XOOPS_ROOT_PATH.'/kernel/group.php'; + +/** +* XOOPS member handler class. +* This class provides simple interface (a facade class) for handling groups/users/ +* membership data. +* +* +* @author Kazumi Ono <onoka****@xoops*****> +* @copyright copyright (c) 2000-2003 XOOPS.org +* @package kernel +*/ + +class XoopsMemberHandler{ + + /**#@+ + * holds reference to group handler(DAO) class + * @access private + */ + var $_gHandler; + + /** + * holds reference to user handler(DAO) class + */ + var $_uHandler; + + /** + * holds reference to membership handler(DAO) class + */ + var $_mHandler; + + /** + * holds temporary user objects + */ + var $_members = array(); + /**#@-*/ + + /** + * constructor + * + */ + function XoopsMemberHandler(&$db) + { + $this->_gHandler = new XoopsGroupHandler($db); + $this->_uHandler = new XoopsUserHandler($db); + $this->_mHandler = new XoopsMembershipHandler($db); + } + + /** + * create a new group + * + * @return object XoopsGroup reference to the new group + */ + function &createGroup() + { + return $this->_gHandler->create(); + } + + /** + * create a new user + * + * @return object XoopsUser reference to the new user + */ + function &createUser() + { + return $this->_uHandler->create(); + } + + /** + * retrieve a group + * + * @param int $id ID for the group + * @return object XoopsGroup reference to the group + */ + function getGroup($id) + { + return $this->_gHandler->get($id); + } + + /** + * retrieve a user + * + * @param int $id ID for the user + * @return object XoopsUser reference to the user + */ + function &getUser($id) + { + if (!isset($this->_members[$id])) { + $this->_members[$id] =& $this->_uHandler->get($id); + } + return $this->_members[$id]; + } + + /** + * delete a group + * + * @param object $group reference to the group to delete + * @return bool FALSE if failed + */ + function deleteGroup(&$group) + { + $this->_gHandler->delete($group); + $this->_mHandler->deleteAll(new Criteria('groupid', $group->getVar('groupid'))); + return true; + } + + /** + * delete a user + * + * @param object $user reference to the user to delete + * @return bool FALSE if failed + */ + function deleteUser(&$user) + { + $this->_uHandler->delete($user); + $this->_mHandler->deleteAll(new Criteria('uid', $user->getVar('uid'))); + return true; + } + + /** + * insert a group into the database + * + * @param object $group reference to the group to insert + * @return bool TRUE if already in database and unchanged + * FALSE on failure + */ + function insertGroup(&$group) + { + return $this->_gHandler->insert($group); + } + + /** + * insert a user into the database + * + * @param object $user reference to the user to insert + * @return bool TRUE if already in database and unchanged + * FALSE on failure + */ + function insertUser(&$user, $force = false) + { + return $this->_uHandler->insert($user, $force); + } + + /** + * retrieve groups from the database + * + * @param object $criteria {@link CriteriaElement} + * @param bool $id_as_key use the group's ID as key for the array? + * @return array array of {@link XoopsGroup} objects + */ + function getGroups($criteria = null, $id_as_key = false) + { + return $this->_gHandler->getObjects($criteria, $id_as_key); + } + + /** + * retrieve users from the database + * + * @param object $criteria {@link CriteriaElement} + * @param bool $id_as_key use the group's ID as key for the array? + * @return array array of {@link XoopsUser} objects + */ + function getUsers($criteria = null, $id_as_key = false) + { + return $this->_uHandler->getObjects($criteria, $id_as_key); + } + + /** + * get a list of groupnames and their IDs + * + * @param object $criteria {@link CriteriaElement} object + * @return array associative array of group-IDs and names + */ + function &getGroupList($criteria = null) + { + $groups =& $this->_gHandler->getObjects($criteria, true); + $ret = array(); + foreach (array_keys($groups) as $i) { + $ret[$i] = $groups[$i]->getVar('name'); + } + return $ret; + } + + /** + * get a list of usernames and their IDs + * + * @param object $criteria {@link CriteriaElement} object + * @return array associative array of user-IDs and names + */ + function getUserList($criteria = null) + { + $users =& $this->_uHandler->getObjects($criteria, true); + $ret = array(); + foreach (array_keys($users) as $i) { + $ret[$i] = $users[$i]->getVar('uname'); + } + return $ret; + } + + /** + * add a user to a group + * + * @param int $group_id ID of the group + * @param int $user_id ID of the user + * @return object XoopsMembership + */ + function addUserToGroup($group_id, $user_id) + { + $mship =& $this->_mHandler->create(); + $mship->setVar('groupid', $group_id); + $mship->setVar('uid', $user_id); + return $this->_mHandler->insert($mship); + } + + /** + * remove a list of users from a group + * + * @param int $group_id ID of the group + * @param array $user_ids array of user-IDs + * @return bool success? + */ + function removeUsersFromGroup($group_id, $user_ids = array()) + { + $criteria = new CriteriaCompo(); + $criteria->add(new Criteria('groupid', $group_id)); + $criteria2 = new CriteriaCompo(); + foreach ($user_ids as $uid) { + $criteria2->add(new Criteria('uid', $uid), 'OR'); + } + $criteria->add($criteria2); + return $this->_mHandler->deleteAll($criteria); + } + + /** + * get a list of users belonging to a group + * + * @param int $group_id ID of the group + * @param bool $asobject return the users as objects? + * @param int $limit number of users to return + * @param int $start index of the first user to return + * @return array Array of {@link XoopsUser} objects (if $asobject is TRUE) + * or of associative arrays matching the record structure in the database. + */ + function getUsersByGroup($group_id, $asobject = false, $limit = 0, $start = 0) + { + $user_ids =& $this->_mHandler->getUsersByGroup($group_id, $limit, $start); + if (!$asobject) { + return $user_ids; + } else { + $ret = array(); + foreach ($user_ids as $u_id) { + $user =& $this->getUser($u_id); + if (is_object($user)) { + $ret[] =& $user; + } + unset($user); + } + return $ret; + } + } + + /** + * get a list of groups that a user is member of + * + * @param int $user_id ID of the user + * @param bool $asobject return groups as {@link XoopsGroup} objects or arrays? + * @return array array of objects or arrays + */ + function getGroupsByUser($user_id, $asobject = false) + { + $group_ids =& $this->_mHandler->getGroupsByUser($user_id); + if (!$asobject) { + return $group_ids; + } else { + foreach ($group_ids as $g_id) { + $ret[] =& $this->getGroup($g_id); + } + return $ret; + } + } + + /** + * log in a user + * + * @param string $uname username as entered in the login form + * @param string $pwd password entered in the login form + * @return object XoopsUser reference to the logged in user. FALSE if failed to log in + */ + function &loginUser($uname, $pwd) + { + $criteria = new CriteriaCompo(new CriteriaString('uname', $uname)); + $criteria->add(new CriteriaString('pass', md5($pwd))); + $user =& $this->_uHandler->getObjects($criteria, false); + if (!$user || count($user) != 1) { + return false; + } + return $user[0]; + } + + /** + * logs in a user with an nd5 encrypted password + * + * @param string $uname username + * @param string $md5pwd password encrypted with md5 + * @return object XoopsUser reference to the logged in user. FALSE if failed to log in + */ + function &loginUserMd5($uname, $md5pwd) + { + $criteria = new CriteriaCompo(new CriteriaString('uname', $uname)); + $criteria->add(new CriteriaString('pass', $md5pwd)); + $user =& $this->_uHandler->getObjects($criteria, false); + if (!$user || count($user) != 1) { + return false; + } + return $user[0]; + } + + /** + * count users matching certain conditions + * + * @param object $criteria {@link CriteriaElement} object + * @return int + */ + function getUserCount($criteria = null) + { + return $this->_uHandler->getCount($criteria); + } + + /** + * count users belonging to a group + * + * @param int $group_id ID of the group + * @return int + */ + function getUserCountByGroup($group_id) + { + return $this->_mHandler->getCount(new Criteria('groupid', $group_id)); + } + + /** + * updates a single field in a users record + * + * @param object $user reference to the {@link XoopsUser} object + * @param string $fieldName name of the field to update + * @param string $fieldValue updated value for the field + * @return bool TRUE if success or unchanged, FALSE on failure + */ + function updateUserByField(&$user, $fieldName, $fieldValue) + { + $user->setVar($fieldName, $fieldValue); + return $this->insertUser($user); + } + + /** + * updates a single field in a users record + * + * @param string $fieldName name of the field to update + * @param string $fieldValue updated value for the field + * @param object $criteria {@link CriteriaElement} object + * @return bool TRUE if success or unchanged, FALSE on failure + */ + function updateUsersByField($fieldName, $fieldValue, $criteria = null) + { + return $this->_uHandler->updateAll($fieldName, $fieldValue, $criteria); + } + + /** + * activate a user + * + * @param object $user reference to the {@link XoopsUser} object + * @return bool successful? + */ + function activateUser(&$user) + { + if ($user->getVar('level') != 0) { + return true; + } + $user->setVar('level', 1); + return $this->_uHandler->insert($user, true); + } + +} +?>
