298 Zeilen
9.7 KiB
PHP
298 Zeilen
9.7 KiB
PHP
<?php
|
|
/**
|
|
* Project:
|
|
* Contenido Content Management System
|
|
*
|
|
* Description:
|
|
* Contenido In-Use classes
|
|
*
|
|
* @package Contenido Backend classes
|
|
* @version $Rev$
|
|
* @author Timo A. Hummel
|
|
* @copyright four for business AG <www.4fb.de>
|
|
* @license http://www.contenido.org/license/LIZENZ.txt
|
|
* @link http://www.4fb.de
|
|
* @link http://www.contenido.org
|
|
* @since file available since contenido release <= 4.6
|
|
*
|
|
* $Id$:
|
|
*/
|
|
|
|
if (!defined('CON_FRAMEWORK')) {
|
|
die('Illegal call');
|
|
}
|
|
|
|
/**
|
|
* Class InUse
|
|
* Class for In-Use management
|
|
* @author Timo A. Hummel <Timo.Hummel@4fb.de>
|
|
* @todo Check and probably recode of behaviour with usage of an area-user-pointer or -hook
|
|
* @version 0.1
|
|
* @copyright four for business 2003
|
|
*/
|
|
class InUseCollection extends ItemCollection
|
|
{
|
|
/**
|
|
* Constructor Function
|
|
* @param none
|
|
*/
|
|
public function __construct()
|
|
{
|
|
global $cfg;
|
|
parent::__construct($cfg["tab"]["inuse"], "idinuse");
|
|
$this->_setItemClass("InUseItem");
|
|
}
|
|
|
|
/**
|
|
* Marks a specific object as "in use". Note that
|
|
* items are released when the session is destroyed.
|
|
*
|
|
* Currently, the following types are defined and approved
|
|
* as internal Contenido standard:
|
|
* article
|
|
* module
|
|
* layout
|
|
* template
|
|
*
|
|
* @param $type string Specifies the type to mark.
|
|
* @param $objectid mixed Specifies the object ID
|
|
* @param $session string Specifies the session for which the "in use" mark is valid
|
|
* @param $user string Specifies the user which requested the in-use flag
|
|
*/
|
|
public function markInUse($type, $objectid, $session, $user)
|
|
{
|
|
$type = Contenido_Security::escapeDB($type, null);
|
|
$objectid = Contenido_Security::escapeDB($objectid, null);
|
|
$session = Contenido_Security::escapeDB($session, null);
|
|
$user = Contenido_Security::escapeDB($user, null);
|
|
|
|
if(empty($type)) {
|
|
$type = "unknown";
|
|
}
|
|
|
|
$this->select("type = '".$type."' AND objectid = '".$objectid."'");
|
|
|
|
if (!$this->next()) {
|
|
$newitem = parent::createNewItem();
|
|
$newitem->set("type", $type);
|
|
$newitem->set("objectid", $objectid);
|
|
$newitem->set("session", $session);
|
|
$newitem->set("userid", $user);
|
|
$newitem->store();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Removes the "in use" mark from a specific object.
|
|
*
|
|
* @param $type string Specifies the type to de-mark.
|
|
* @param $objectid mixed Specifies the object ID
|
|
* @param $session string Specifies the session for which the "in use" mark is valid
|
|
*/
|
|
public function removeMark($type, $objectid, $session)
|
|
{
|
|
$type = Contenido_Security::escapeDB($type, null);
|
|
$objectid = Contenido_Security::escapeDB($objectid, null);
|
|
$session = Contenido_Security::escapeDB($session, null);
|
|
|
|
$this->select("type = '".$type."' AND objectid = '".$objectid."' AND session = '".$session."'");
|
|
|
|
if ($obj = $this->next()) {
|
|
// Extract the ID
|
|
$id = $obj->get("idinuse");
|
|
|
|
// Let's save memory
|
|
unset($obj);
|
|
|
|
// Remove entry
|
|
$this->delete($id);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Removes all marks for a specific type and session
|
|
*
|
|
* @param $type string Specifies the type to de-mark.
|
|
* @param $session string Specifies the session for which the "in use" mark is valid
|
|
*/
|
|
public function removeTypeMarks($type, $session)
|
|
{
|
|
$type = Contenido_Security::escapeDB($type, null);
|
|
$session = Contenido_Security::escapeDB($session, null);
|
|
|
|
$this->select("type = '".$type."' AND session = '".$session."'");
|
|
|
|
while ($obj = $this->next()) {
|
|
// Extract the ID
|
|
$id = $obj->get("idinuse");
|
|
|
|
// Let's save memory
|
|
unset($obj);
|
|
|
|
// Remove entry
|
|
$this->delete($id);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Removes the mark for a specific item
|
|
*
|
|
* @param $type string Specifies the type to de-mark.
|
|
* @param $itemid string Specifies the item
|
|
*/
|
|
public function removeItemMarks($type, $itemid)
|
|
{
|
|
$type = Contenido_Security::escapeDB($type, null);
|
|
$itemid = Contenido_Security::escapeDB($itemid, null);
|
|
|
|
$this->select("type = '".$type."' AND objectid = '".$itemid."'");
|
|
|
|
while ($obj = $this->next()) {
|
|
// Extract the ID
|
|
$id = $obj->get("idinuse");
|
|
|
|
// Let's save memory
|
|
unset($obj);
|
|
|
|
// Remove entry
|
|
$this->delete($id);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Removes all in-use marks for a specific session.
|
|
*
|
|
* @param $session string Specifies the session for which the "in use" marks should be removed
|
|
*/
|
|
public function removeSessionMarks($session)
|
|
{
|
|
$session = Contenido_Security::escapeDB($session, null);
|
|
$this->select("session = '".$session."'");
|
|
|
|
while ($obj = $this->next()) {
|
|
// Extract the ID
|
|
$id = $obj->get("idinuse");
|
|
|
|
// Let's save memory
|
|
unset($obj);
|
|
|
|
// Remove entry
|
|
$this->delete($id);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Checks if a specific item is marked
|
|
*
|
|
* @param $type string Specifies the type to de-mark.
|
|
* @param $objectid mixed Specifies the object ID
|
|
* @return int Returns false if it's not in use or returns the object if it is.
|
|
*/
|
|
public function checkMark($type, $objectid) {
|
|
/* @var $sess Contenido_Session */
|
|
global $sess;
|
|
|
|
$type = Contenido_Security::escapeDB($type, null);
|
|
$objectid = Contenido_Security::escapeDB($objectid, null);
|
|
|
|
$this->select("type = '".$type."' AND objectid = '".$objectid."'");
|
|
|
|
if ($obj = $this->next()) {
|
|
if($obj->get('session') != $sess->id) {
|
|
return ($obj);
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Checks and marks if not marked.
|
|
*
|
|
* Example: Check for "idmod", also return a lock message:
|
|
* list($inUse, $message) = $col->checkAndMark("idmod", $idmod, true, i18n("Module is in use by %s (%s)"));
|
|
*
|
|
* Example 2: Check for "idmod", don't return a lock message
|
|
* $inUse = $col->checkAndMark("idmod", $idmod);
|
|
*
|
|
* @param $type string Specifies the type to de-mark.
|
|
* @param $objectid mixed Specifies the object ID
|
|
* @param $returnWarning boolean If true, also returns an error message if in use
|
|
* @param $warningTemplate string String to fill with the template
|
|
* (%s as placeholder, first %s is the username, second is the real name)
|
|
* @param $allowOverride boolean True if the user can override the lock
|
|
* @param $location string Value to append to the override lock button
|
|
* @return mixed If returnWarning is false, returns a boolean value wether the object is locked. If
|
|
* returnWarning is true, returns a 2 item array (boolean inUse, string errormessage).
|
|
*/
|
|
public function checkAndMark($type, $objectid, $returnWarning = false, $warningTemplate = "", $allowOverride = false, $location = "")
|
|
{
|
|
global $sess, $auth, $notification, $area, $frame, $perm;
|
|
|
|
if (($obj = $this->checkMark($type, $objectid)) === false) {
|
|
$this->markInUse($type, $objectid, $sess->id, $auth->auth["uid"]);
|
|
$inUse = false;
|
|
$disabled = "";
|
|
$noti = "";
|
|
} else {
|
|
if ($returnWarning == true) {
|
|
$vuser = new User();
|
|
$vuser->loadUserByUserID($obj->get("userid"));
|
|
$inUseUser = $vuser->getField("username");
|
|
$inUseUserRealName = $vuser->getField("realname");
|
|
|
|
$message = sprintf($warningTemplate, $inUseUser, $inUseUserRealName);
|
|
|
|
if ($allowOverride == true && ($auth->auth["uid"] == $obj->get("userid") || $perm->have_perm())) {
|
|
$alt = i18n("Click here if you want to override the lock");
|
|
|
|
$link = $sess->url($location."&overridetype=".$type."&overrideid=".$objectid);
|
|
|
|
$warnmessage = i18n("Do you really want to override the lock?");
|
|
$script = "javascript:if (window.confirm('".$warnmessage."') == true) { window.location.href = '".$link."';}";
|
|
$override = '<br><br><a alt="'.$alt.'" title="'.$alt.'" href="'.$script.'" class="standard">['.i18n("Override lock").']</a> <a href="javascript://" class="standard" onclick="elem = document.getElementById(\'contenido_notification\'); elem.style.display=\'none\'">['.i18n("Hide notification").']</a>';
|
|
} else {
|
|
$override = "";
|
|
}
|
|
|
|
if (!is_object($notification)) {
|
|
$notification = new Contenido_Notification;
|
|
}
|
|
|
|
$noti = $notification->messageBox("warning", $message.$override, 0);
|
|
$inUse = true;
|
|
}
|
|
}
|
|
|
|
if ($returnWarning == true) {
|
|
return (array($inUse, $noti));
|
|
} else {
|
|
return $inUse;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* Class InUseItem
|
|
* Class for a single in-use item
|
|
* @author Timo A. Hummel <Timo.Hummel@4fb.de>
|
|
* @version 0.1
|
|
* @copyright four for business 2003
|
|
*/
|
|
class InUseItem extends Item
|
|
{
|
|
/**
|
|
* Constructor Function
|
|
* @param mixed $mId Specifies the ID of item to load
|
|
*/
|
|
public function __construct($mId = false)
|
|
{
|
|
global $cfg;
|
|
parent::__construct($cfg["tab"]["inuse"], "idinuse");
|
|
if ($mId !== false) {
|
|
$this->loadByPrimaryKey($mId);
|
|
}
|
|
}
|
|
}
|
|
|
|
?>
|