class.ilObjCategory.php

Go to the documentation of this file.

<?php

/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */

require_once "./Services/Container/classes/class.ilContainer.php";


class ilObjCategory extends ilContainer
{
    public function __construct($a_id = 0, $a_call_by_reference = true)
    {
        global $DIC;

        $this->db = $DIC->database();
        $this->app_event_handler = $DIC["ilAppEventHandler"];
        $this->log = $DIC["ilLog"];
        $this->user = $DIC->user();
        $this->type = "cat";
        parent::__construct($a_id, $a_call_by_reference);
    }

    public function delete()
    {
        $ilDB = $this->db;
        $ilAppEventHandler = $this->app_event_handler;
        
        // always call parent delete function first!!
        if (!parent::delete()) {
            return false;
        }
        
        // put here category specific stuff
        include_once('./Services/User/classes/class.ilObjUserFolder.php');
        ilObjUserFolder::_updateUserFolderAssignment($this->ref_id, USER_FOLDER_ID);

        $query = "DELETE FROM object_translation WHERE obj_id = " . $ilDB->quote($this->getId(), 'integer');
        $res = $ilDB->manipulate($query);
        
        // taxonomies
        include_once "Services/Taxonomy/classes/class.ilObjTaxonomy.php";
        foreach (ilObjTaxonomy::getUsageOfObject($this->getId()) as $tax_id) {
            if ($tax_id) {
                $tax = new ilObjTaxonomy($tax_id);
                $tax->delete();
            }
        }
        
        $ilAppEventHandler->raise(
            'Modules/Category',
            'delete',
            array('object' => $this,
                'obj_id' => $this->getId())
        );
        
        return true;
    }
    
    public function getTranslations()
    {
        $ilDB = $this->db;
        
        $q = "SELECT * FROM object_translation WHERE obj_id = " .
            $ilDB->quote($this->getId(), 'integer') . " ORDER BY lang_default DESC";
        $r = $ilDB->query($q);
        
        $num = 0;

        while ($row = $r->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $data["Fobject"][$num]= array("title"       => $row->title,
                                          "desc"        => $row->description,
                                          "lang"        => $row->lang_code
                                          );
            $num++;
        }

        // first entry is always the default language
        $data["default_language"] = 0;

        return $data ? $data : array();
    }
    
    // remove all Translations of current category
    public function removeTranslations()
    {
        $ilDB = $this->db;
        
        $query = "DELETE FROM object_translation WHERE obj_id= " .
            $ilDB->quote($this->getId(), 'integer');
        $res = $ilDB->manipulate($query);
    }

    // remove translations of current category
    public function deleteTranslation($a_lang)
    {
        $ilDB = $this->db;

        $query = "DELETE FROM object_translation WHERE obj_id= " .
            $ilDB->quote($this->getId(), 'integer') . " AND lang_code = " .
            $ilDB->quote($a_lang, 'text');
        $res = $ilDB->manipulate($query);
    }
    
    // add a new translation to current category
    public function addTranslation($a_title, $a_desc, $a_lang, $a_lang_default)
    {
        $ilDB = $this->db;
        
        if (empty($a_title)) {
            $a_title = "NO TITLE";
        }

        $query = "INSERT INTO object_translation " .
             "(obj_id,title,description,lang_code,lang_default) " .
             "VALUES " .
             "(" . $ilDB->quote($this->getId(), 'integer') . "," .
                $ilDB->quote($a_title, 'text') . "," . $ilDB->quote($a_desc, 'text') . "," .
                $ilDB->quote($a_lang, 'text') . "," . $ilDB->quote($a_lang_default, 'integer') . ")";
        $res = $ilDB->manipulate($query);

        return true;
    }
    
    // update a translation to current category
    public function updateTranslation($a_title, $a_desc, $a_lang, $a_lang_default)
    {
        $ilDB = $this->db;
        $ilLog = $this->log;
        
        if (empty($a_title)) {
            $a_title = "NO TITLE";
        }

        $query = "UPDATE object_translation " .
             "SET title = " . $ilDB->quote($a_title, 'text') . "," .
                  "description = " . $ilDB->quote($a_desc, 'text') . "," .
                  "lang_code = " . $ilDB->quote($a_lang, 'text') . "," .
                  "lang_default = " . $ilDB->quote($a_lang_default, 'integer') . " " .
             "WHERE " .
             " obj_id = " . $ilDB->quote($this->getId(), 'integer');
        $res = $ilDB->manipulate($query);

        return true;
    }
    
    public function cloneObject($a_target_id, $a_copy_id = 0, $a_omit_tree = false)
    {
        $new_obj = parent::cloneObject($a_target_id, $a_copy_id, $a_omit_tree);

        include_once("./Services/Object/classes/class.ilObjectTranslation.php");
        $ot = ilObjectTranslation::getInstance($this->getId());
        $ot->copy($new_obj->getId());

        return $new_obj;
    }
    
    public function cloneDependencies($a_target_id, $a_copy_id)
    {
        parent::cloneDependencies($a_target_id, $a_copy_id);
    
                                
        // clone taxonomies
            
        include_once("./Services/Taxonomy/classes/class.ilObjTaxonomy.php");
        $all_tax = ilObjTaxonomy::getUsageOfObject($this->getId());
        if (sizeof($all_tax)) {
            include_once("./Services/Taxonomy/classes/class.ilTaxNodeAssignment.php");
            
            $cwo = ilCopyWizardOptions::_getInstance($a_copy_id);
            $mappings = $cwo->getMappings();
            
            foreach ($all_tax as $old_tax_id) {
                if ($old_tax_id) {
                    // clone it
                    $old_tax = new ilObjTaxonomy($old_tax_id);
                    $new_tax = $old_tax->cloneObject(0, 0, true);
                    $tax_map = $old_tax->getNodeMapping();
                
                    // assign new taxonomy to new category
                    ilObjTaxonomy::saveUsage($new_tax->getId(), ilObject::_lookupObjId($a_target_id));
                                                        
                    // clone assignments (for all sub-items)
                    foreach ($mappings as $old_ref_id => $new_ref_id) {
                        if ($old_ref_id != $new_ref_id) {
                            $old_obj_id = ilObject::_lookupObjId($old_ref_id);
                            $new_obj_id = ilObject::_lookupObjId($new_ref_id);
                            $obj_type = ilObject::_lookupType($old_obj_id);
                                                                    
                            $tax_ass = new ilTaxNodeAssignment($obj_type, $old_obj_id, "obj", $old_tax_id);
                            $assignmts = $tax_ass->getAssignmentsOfItem($old_obj_id);
                            if (sizeof($assignmts)) {
                                $new_tax_ass = new ilTaxNodeAssignment($obj_type, $new_obj_id, "obj", $new_tax->getId());
                                foreach ($assignmts as $a) {
                                    if ($tax_map[$a["node_id"]]) {
                                        $new_tax_ass->addAssignment($tax_map[$a["node_id"]], $new_obj_id);
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
    
    public function addAdditionalSubItemInformation(&$a_item_data)
    {
        include_once './Services/Object/classes/class.ilObjectActivation.php';
        ilObjectActivation::addAdditionalSubItemInformation($a_item_data);
    }
} // END class.ilObjCategory