thesaurus_term.inc

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


class Thesaurus_Term extends Asset
{

    var $_thesaurus;

    var $_termid;


    function Thesaurus_Term($asset_id=0)
    {
        if (empty($asset_id)) {
            $this->_loadVars();
            return;
        }
        if (strpos($asset_id, ':') === FALSE) return;

        list($thesaurus_id, $termid) = explode(':', $asset_id);

        $this->_thesaurus = $GLOBALS['SQ_SYSTEM']->am->getAsset($thesaurus_id);

        $term = $this->_thesaurus->getTermById($termid);
        if (is_null($term)) return;

        $this->id = $asset_id;
        $this->_termid = $termid;
        $this->_loadVars();

        $this->name = $term['term'];
        $this->short_name = $this->name;
        $this->status = $this->_thesaurus->status;

        $this->setAttrValue('name', $term['term']);

    }//end constructor


    function create(&$link)
    {
        $em = $GLOBALS['SQ_SYSTEM']->getEventManager();
        $this->name = $this->attr('name');
        if (empty($this->name)) return FALSE;

        $majorid = NULL;

        if ($link['asset'] instanceof Thesaurus) {
            $this->_thesaurus =& $link['asset'];
        } else if ($link['asset'] instanceof Thesaurus_Term) {
            $this->_thesaurus =& $link['asset']->_thesaurus;
            $majorid = $link['asset']->_termid;
        } else {
            $type = method_exists($link['asset'], 'type') ? $link['asset']->type() : '';
            trigger_localised_error('CORE0236', E_USER_WARNING, $type);
            return FALSE;
        }

        // see if a term with this name already exists under this parent with this particular relation
        $term = $this->attr('name');
        $relation = isset($this->_tmp['relation']) ? $this->_tmp['relation'] : $link['value'];

        $relation = trim($relation);

        $created = FALSE;

        $GLOBALS['SQ_SYSTEM']->changeDatabaseConnection('db2');
        $GLOBALS['SQ_SYSTEM']->doTransaction('BEGIN');

        // check if this term already exists, if it does, then we just link
        $termid = $this->_thesaurus->getTermIdByName($term);
        if (is_null($termid)) {
            $termid = $this->_thesaurus->_addTerm($term);
            if (is_null($termid)) {
                $GLOBALS['SQ_SYSTEM']->doTransaction('ROLLBACK');
                $GLOBALS['SQ_SYSTEM']->restoreDatabaseConnection();
                trigger_error('Unknown error. Cannot add.');
                return FALSE;
            }
            $created = TRUE;
        }

        $this->id = $this->_thesaurus->id.':'.$termid;
        $this->_termid = $termid;

        // if we're adding a top level term it's a stray term - not linked to anything
        if (is_null($majorid)) {
            $GLOBALS['SQ_SYSTEM']->doTransaction('COMMIT');
            if ($created) {
                $em->broadcastEvent($this, 'AssetCreate', Array('name','assetid'));
            }
            $em->broadcastEvent($this->_thesaurus, 'CreateLink', Array());
            $GLOBALS['SQ_SYSTEM']->restoreDatabaseConnection();
            return $this->_thesaurus->id.':atoz:'.$termid;
        }

        $existing_link = $this->_thesaurus->getTermLinkByTermids($termid, $majorid, $relation);
        if (!empty($existing_link)) {
            $GLOBALS['SQ_SYSTEM']->doTransaction('COMMIT');
            $GLOBALS['SQ_SYSTEM']->restoreDatabaseConnection();
            return $this->_thesaurus->id.':'.$existing_link['linkid'];
        }

        $linkid = $this->_thesaurus->linkTerms($termid, $majorid, $relation);
        if (is_null($linkid)) {
            $GLOBALS['SQ_SYSTEM']->doTransaction('ROLLBACK');
            $GLOBALS['SQ_SYSTEM']->restoreDatabaseConnection();
            trigger_localised_error('CORE0237', E_USER_WARNING);
            return FALSE;
        }

        $this->_thesaurus->markContentsChanged();
        $GLOBALS['SQ_SYSTEM']->doTransaction('COMMIT');
        $GLOBALS['SQ_SYSTEM']->restoreDatabaseConnection();

        if ($created) {
            $em->broadcastEvent($this, 'AssetCreate', Array('name','assetid'));
        }

        return $this->_thesaurus->id.':'.$linkid;

    }//end create()


    function getAssetMapLinks()
    {
        $links = Array();

        if (isset($this->_termid)) {
            $links = $this->_thesaurus->_getShadowAssetMapLinks($this->_termid);
        }

        return $links;

    }//end getAssetMapLinks()


    function _getAllowedLinks()
    {
        return Array(
                SQ_LINK_TYPE_1  => Array(
                                    'thesaurus_term'    => Array(
                                                            'card'      => 'M',
                                                            'exclusive' => FALSE,
                                                           ),
                                   ),
                SQ_LINK_TYPE_2  => Array(
                                    'thesaurus_term'    => Array(
                                                            'card'      => 'M',
                                                            'exclusive' => FALSE,
                                                           ),
                                   ),
                SQ_LINK_TYPE_3  => Array(),
               );

    }//end _getAllowedLinks()


    function saveAttributes()
    {
        if (empty($this->_thesaurus)) return TRUE;

        $name = $this->attr('name');

        // If the name is updated, we are going to update the name of this object so when it broadcasts an
        // even, the new name is used instead. In particular it is
        if ($this->name != $this->attr('name')) {
            $this->name = $name;
        }//end if

        $success = $this->_thesaurus->updateTerm($this->_termid, $name);//, $notes);

        if ($success) {
            $this->_thesaurus->saveAttributes();

            if (!empty($this->_tmp['vars_set'])) {
                // prepare to broadcast the attributes_changed
                foreach ($this->_tmp['vars_set'] as $attr => $details) {
                    $changed_vars[$attr] = Array(
                                            'type'      => $this->vars[$attr]['type'],
                                            'old_value' => $details['old_value'],
                                            'new_value' => $this->attr($attr),
                                           );
                }
                $GLOBALS['SQ_SYSTEM']->broadcastTriggerEvent('trigger_event_attributes_changed', $this, $changed_vars);
            }

            unset($this->_tmp['vars_set']);
            $em = $GLOBALS['SQ_SYSTEM']->getEventManager();
            $em->broadcastEvent($this, 'AssetUpdate', Array('name'));
            $GLOBALS['SQ_SYSTEM']->broadcastTriggerEvent('trigger_event_attributes_saved', $this);
        }
        return $success;

    }//end saveAttributes()


    function createAssetLink($major, $minor)
    {

    }//end createAssetLink()


    function canMoveLink(&$minor, &$old_major, $link_type)
    {
        return $this->canCreateLink($minor, $link_type, 0);

    }//end canMoveLink()


    function canCreateLink(&$minor, $link_type, $exclusive)
    {
        $create_link = FALSE;

        if (($minor instanceof Thesaurus_Term) && ($exclusive == 0)) {
            $create_link = (($link_type == SQ_LINK_TYPE_1) || ($link_type == SQ_LINK_TYPE_2));
        }

        return $create_link;

    }//end canCreateLink()


    function addTermNote($name, $note)
    {
        $this->_thesaurus->addTermNote($this->_termid, $name, $note);

    }//end addTermNote()


    function deleteTermNotes()
    {
        $this->_thesaurus->deleteTermNotes($this->_termid);

    }//end deleteTermNotes()


    function getTermNotes()
    {
        return $this->_thesaurus->getTermNotes($this->_termid);

    }//end getTermNotes()

}//end class
?>