asset_status.inc

<?php
class Asset_Status extends MySource_Object
{

    var $status_tag = 0;

    var $owner = null;


    function Asset_Status($owner)
    {
        $this->owner = $owner;
        $this->MySource_Object();

    }//end constructor


    public static function getDescription()
    {
        return 'Unknown Status';

    }//end getDescription()


    function getAvailableStatii()
    {
        return Array();

    }//end getAvailableStatii()


    function getStatusChangeMessage()
    {
        return NULL;

    }//end getStatusChangeMessage()


    function processStatusChange($new_status, $update_parent=true)
    {
        // we need write access to do any changes
        if (!$this->owner->readAccess()) {
            trigger_localised_error('SYS0309', E_USER_WARNING, $this->owner->name, $this->owner->id);
            return false;
        }

        // if the new status is the same as our status, we can handle this
        if ($new_status == $this->status_tag) return true;

        // do we need to check if the new status is valid?
        if ($GLOBALS['SQ_SYSTEM']->runLevelEnables(SQ_SECURITY_STATUS_INTEGRITY)) {

            // make sure we can actually set this status
            $valid_statii = $this->getAvailableStatii();
            if (!isset($valid_statii[$new_status])) {
                require_once SQ_INCLUDE_PATH.'/general_occasional.inc';

                $code = strtolower((string)get_bit_names('SQ_STATUS_', $new_status));
                $status_code = 'asset_status_'.$code;
                require_once SQ_INCLUDE_PATH.'/asset_status/'.$status_code.'.inc';
                eval('$desc = '.$status_code.'::getDescription();');

                trigger_localised_error('SYS0250', E_USER_WARNING, $desc, $this->owner->name, $GLOBALS['SQ_SYSTEM']->am->getTypeInfo($this->owner->type(), 'name'), $this->owner->id, $this->getDescription(), $GLOBALS['SQ_SYSTEM']->user->name, $GLOBALS['SQ_SYSTEM']->user->id);

                return false;
            }
        }

        // we are now certain that we will be changing the status that we were asked to
        // lets fire the trigger event 'trigger_event_before_status_change' to the triggers
        // know we will next be changing the status. Last chance to stop before we GO GO GO !!
        $event_data = Array(
                        'old_status'            => $this->status_tag,
                        'new_status'            => $new_status,
                        'allow_unrestricted'    => isset($this->owner->_tmp['allow_unrestricted']) ? $this->owner->_tmp['allow_unrestricted'] : NULL,
                      );

        // if the broadcast returns FALSE, dont go ahead with changing the status
        // NOTE : it is likely to return FALSE only if the trigger is blocking
        // in other cases the asset status change will still go ahead in full swing
        if (!$GLOBALS['SQ_SYSTEM']->broadcastTriggerEvent('trigger_event_before_status_change', $this->owner, $event_data)) {
            return FALSE;
        }

        return TRUE;

    }//end processStatusChange()


}//end class

?>