trigger.inc

<?php
require_once SQ_INCLUDE_PATH.'/asset.inc';

class Trigger extends Asset
{


    var $tmid = 0;


    function Trigger($tmid=0, $id=0)
    {
        $this->_ser_attrs = TRUE;
        $this->_loadVars();

        // attempt to load trigger from database
        if (!empty($tmid) && !empty($id)) {
            $this->load($tmid, $id);
        }

    }//end constructor


    function setTriggerManager($tmid)
    {
        if (empty($tmid)) return FALSE;

        $tm = $GLOBALS['SQ_SYSTEM']->am->getAsset($tmid, 'trigger_manager');
        if (!is_null($tm)) {
            // this is our new trigger manager
            $this->tmid = $tmid;
            return TRUE;
        }
        return FALSE;

    }//end setTriggerManager()


    function &getTriggerManager()
    {
        $asset = NULL;
        if (isset($this->tmid) && !empty($this->tmid)) {
            $asset = $GLOBALS['SQ_SYSTEM']->am->getAsset($this->tmid, 'trigger_manager');
        }
        return $asset;

    }//end getTriggerManager()


    function load($tmid, $id)
    {
        // is our trigger manager the real thing?
        if (!$this->setTriggerManager($tmid)) return FALSE;
        $tm = $this->getTriggerManager();

        // we use the trigger manager function to load the trigger
        $trigger_info = $tm->_loadTrigger($id);
        if (empty($trigger_info)) return FALSE;

        // trigger exists, so the id is valid
        $this->id = implode(':', Array($tmid, $id));

        $this->name = $trigger_info['name'];
        $this->short_name = $trigger_info['name'];

        // mimic the bridge status
        $this->status = $tm->status;

        // load attributes
        $this->vars['name']['value']        = $trigger_info['name'];
        $this->vars['description']['value'] = $trigger_info['description'];
        $this->vars['events']['value']      = $trigger_info['data']['events'];
        $this->vars['conditions']['value']  = $trigger_info['data']['conditions'];
        $this->vars['actions']['value']     = $trigger_info['data']['actions'];
        $this->vars['active']['value']      = $trigger_info['active'];
        $this->vars['category']['value']    = $trigger_info['category'];
        $this->vars['blocking']['value']    = empty($trigger_info['data']['settings']['blocking']) ? 0 : 1;

        return TRUE;

    }//end load()


    function create(&$link)
    {
        $save_result = $this->saveAttributes();
        if (!$save_result) return $save_result;

        // possibly not the best way to do this, but we need
        // to set our status / name and the trigger manager id
        $this_id = explode(':', $this->id);
        $id = $this_id[1];
        $load_result = $this->load($this->tmid, $id);

        $em = $GLOBALS['SQ_SYSTEM']->getEventManager();
        $tm = $this->getTriggerManager();

        // hopefully the asset map is listening
        $em->broadcastEvent($tm, 'CreateLink', Array('linkid' => $this->id));

        return $save_result && $load_result;

    }//end create()


    function saveAttributes($dont_run_updated=FALSE)
    {
        $trigger_info = Array();

        if (empty($this->tmid)) return FALSE;
        $id_parts = explode(':', $this->id);

        // if we supply an id to the trigger manger, existing
        // trigger will be updated
        $trigger_id = array_get_index($id_parts, 1);
        if (!is_null($trigger_id)) {
            $trigger_info['id'] = $trigger_id;
        }

        // build trigger info from attributes
        $trigger_info['name']                           = $this->attr('name');
        $trigger_info['description']                    = $this->attr('description');
        $trigger_info['data']['events']                 = $this->attr('events');
        $trigger_info['data']['conditions']             = $this->attr('conditions');
        $trigger_info['data']['actions']                = $this->attr('actions');
        $trigger_info['active']                         = $this->attr('active');
        $trigger_info['category']                       = $this->attr('category');
        
        // Name cannot be empty
        if (empty($trigger_info['name'])) {
            trigger_localised_error('TRIG0001', E_USER_NOTICE);
            return FALSE;
        }

        // special condition for blocking
        if ($this->attr('blocking')) {
            $trigger_info['data']['settings']['blocking'] = TRUE;
        }

        // do not perform unnecessary hashing
        if (empty($trigger_info['data']['events']) || empty($trigger_info['data']['actions']) || empty($trigger_info['active'])) {
            $trigger_info['save_hash'] = FALSE;
        }

        $tm = $this->getTriggerManager();
        if (is_null($tm)) return FALSE;

        // use trigger manager to save
        if ($id = $tm->_saveTrigger($trigger_info)) {
            $this->id = implode(':', Array($this->tmid, $id));

            $em = $GLOBALS['SQ_SYSTEM']->getEventManager();
            $em->broadcastEvent($this, 'AssetUpdate', Array('short_name'));

            return TRUE;
        }
        return FALSE;

    }//end saveAttributes()


}//end class

?>