class.ilAdvancedMDSubstitution.php

Go to the documentation of this file.

<?php
/*
    +-----------------------------------------------------------------------------+
    | ILIAS open source                                                           |
    +-----------------------------------------------------------------------------+
    | Copyright (c) 1998-2006 ILIAS open source, University of Cologne            |
    |                                                                             |
    | This program is free software; you can redistribute it and/or               |
    | modify it under the terms of the GNU General Public License                 |
    | as published by the Free Software Foundation; either version 2              |
    | of the License, or (at your option) any later version.                      |
    |                                                                             |
    | This program is distributed in the hope that it will be useful,             |
    | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
    | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
    | GNU General Public License for more details.                                |
    |                                                                             |
    | You should have received a copy of the GNU General Public License           |
    | along with this program; if not, write to the Free Software                 |
    | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
    +-----------------------------------------------------------------------------+
*/

class ilAdvancedMDSubstitution
{
    private static $instances = null;
    private static $mappings = null;

    protected $db;
    
    protected $type;
    protected $substitutions;
    protected $bold = array();
    protected $newline = array();
    
    protected $enabled_desc = true;
    protected $enabled_field_names = true;
    protected $active = false;
    protected $date_fields = array();
    protected $datetime_fields = array();
    protected $active_fields = array();
    
    
    /*
     * Singleton class
     * Use _getInstance
     * @access private
     * @param
     */
    private function __construct($a_type)
    {
        global $ilDB;
        
        $this->db = $ilDB;
        $this->type = $a_type;
        
        $this->initECSMappings();
        $this->read();
    }
    
    public static function _getInstanceByObjectType($a_type)
    {
        if (isset(self::$instances[$a_type])) {
            return self::$instances[$a_type];
        }
        return self::$instances[$a_type] = new ilAdvancedMDSubstitution($a_type);
    }
    
    public function sortDefinitions($a_definitions)
    {
        $sorted = array();
        foreach ($this->substitutions as $field_id) {
            if (isset($a_definitions[$field_id])) {
                $sorted[$field_id] = $a_definitions[$field_id];
                unset($a_definitions[$field_id]);
            }
        }
        return array_merge($sorted, $a_definitions);
    }
    
    public function isActive()
    {
        return $this->active;
    }
    
    public function isDescriptionEnabled()
    {
        return (bool) $this->enabled_desc;
    }
    
    public function enableDescription($a_status)
    {
        $this->enabled_desc = $a_status;
    }
    
    public function enabledFieldNames()
    {
        return (bool) $this->enabled_field_names;
    }
    
    public function enableFieldNames($a_status)
    {
        $this->enabled_field_names = $a_status;
    }
    
    public function getParsedSubstitutions($a_ref_id, $a_obj_id)
    {
        if (!count($this->getSubstitutions())) {
            return array();
        }
        
        include_once('Services/AdvancedMetaData/classes/class.ilAdvancedMDValues.php');
        $values_records = ilAdvancedMDValues::preloadedRead($this->type, $a_obj_id);
                
        $counter = 0;
        foreach ($this->getSubstitutions() as $field_id) {
            if (!isset($this->active_fields[$field_id])) {
                continue;
            }
            
            $value = $this->parseValue($field_id, $values_records);
            
            if ($value === null) {
                if ($this->hasNewline($field_id) and $counter) {
                    $substituted[$counter-1]['newline'] = true;
                }
                continue;
            }
                            
            $substituted[$counter]['name'] = $this->active_fields[$field_id];
            $substituted[$counter]['value'] = $value;
            $substituted[$counter]['bold'] = $this->isBold($field_id);
            if ($this->hasNewline($field_id)) {
                $substituted[$counter]['newline'] = true;
            } else {
                $substituted[$counter]['newline'] = false;
            }
            $substituted[$counter]['show_field'] = $this->enabledFieldNames();
            $counter++;
        }
        
        return $substituted ? $substituted : array();
    }
    
    private function parseValue($a_field_id, $a_values_records)
    {
        global $ilUser;
        
        if ($this->type == 'crs' or $this->type == 'rcrs') {
            // Special handling for ECS fields
            // @FIXME
            /*
            if($a_field_id == self::$mappings->getMappingByECSName('begin') and
                $end = self::$mappings->getMappingByECSName('end'))
            {
                // Parse a duration
                $start = in_array($a_field_id,$this->date_fields) ?
                    new ilDate($a_values[$a_field_id],IL_CAL_UNIX) :
                    new ilDateTime($a_values[$a_field_id],IL_CAL_UNIX);
                $end = in_array($end,$this->date_fields) ?
                    new ilDate($a_values[$end],IL_CAL_UNIX) :
                    new ilDateTime($a_values[$end],IL_CAL_UNIX);

                include_once('./Services/Calendar/classes/class.ilCalendarUtil.php');
                $weekday = ilCalendarUtil::_numericDayToString($start->get(IL_CAL_FKT_DATE,'w',$ilUser->getTimeZone()),false);

                ilDatePresentation::setUseRelativeDates(false);
                $value = ilDatePresentation::formatPeriod($start,$end);
                ilDatePresentation::setUseRelativeDates(true);
                return $weekday.', '.$value;
            }
            */
        }
        
        foreach ($a_values_records as $a_values) {
            if ($a_values->getADTGroup()->hasElement($a_field_id)) {
                $element = $a_values->getADTGroup()->getElement($a_field_id);
                if (!$element->isNull()) {
                    return ilADTFactory::getInstance()->getPresentationBridgeForInstance($element)->getList();
                }
            }
        }
    }
    
    
    public function resetSubstitutions()
    {
        $this->substitutions = array();
        $this->bold = array();
        $this->newline = array();
    }
    
    public function appendSubstitution($a_field_id, $a_bold = false, $a_newline = false)
    {
        $this->substitutions[] = $a_field_id;
        if ($a_bold) {
            $this->bold[] = $a_field_id;
        }
        if ($a_newline) {
            $this->newline[] = $a_field_id;
        }
    }
    
    public function getSubstitutions()
    {
        return $this->substitutions ? $this->substitutions : array();
    }
    
    public function isSubstituted($a_field_id)
    {
        return in_array($a_field_id, $this->getSubstitutions());
    }
    
    public function isBold($a_field_id)
    {
        #var_dump("<pre>",$this->bold,$a_field_id,"</pre>");
        
        return in_array($a_field_id, $this->bold);
    }
    
    public function hasNewline($a_field_id)
    {
        return in_array($a_field_id, $this->newline);
    }
    public function update()
    {
        global $ilDB;
        
        $counter = 0;
        $substitutions = array();
    
        foreach ($this->substitutions as $field_id) {
            $substitutions[$counter]['field_id'] = $field_id;
            $substitutions[$counter]['bold'] = $this->isBold($field_id);
            $substitutions[$counter]['newline'] = $this->hasNewline($field_id);
            $counter++;
        }
        
        $query = "DELETE FROM adv_md_substitutions WHERE obj_type = " . $ilDB->quote($this->type, 'text');
        $res = $ilDB->manipulate($query);
            
        
        $values = array(
            'obj_type'                  => array('text',$this->type),
            'substitution'              => array('clob',serialize($substitutions)),
            'hide_description'  => array('integer',!$this->isDescriptionEnabled()),
            'hide_field_names'  => array('integer',!$this->enabledFieldNames())
            );
        $ilDB->insert('adv_md_substitutions', $values);
    }
    
    private function read()
    {
        global $ilDB;
             
        // Check active status
        $query = "SELECT active,field_id,amfd.title FROM adv_md_record amr " .
            "JOIN adv_md_record_objs amro ON amr.record_id = amro.record_id " .
            "JOIN adv_mdf_definition amfd ON amr.record_id = amfd.record_id " .
            "WHERE active = 1 " .
            "AND obj_type = " . $this->db->quote($this->type, 'text') . " ";
        $res = $this->db->query($query);
        $this->active = $res->numRows() ? true : false;
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $this->active_fields[$row->field_id] = $row->title;
        }
            
        $query = "SELECT * FROM adv_md_substitutions " .
            "WHERE obj_type = " . $this->db->quote($this->type, 'text') . " ";
        $res = $this->db->query($query);
        $this->substitutions = array();
        $this->bold = array();
        $this->newline = array();
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $tmp_substitutions = unserialize($row->substitution);
            if (is_array($tmp_substitutions)) {
                foreach ($tmp_substitutions as $substitution) {
                    if ($substitution['field_id']) {
                        $this->substitutions[] = $substitution['field_id'];
                    }
                    if ($substitution['bold']) {
                        $this->bold[] = $substitution['field_id'];
                    }
                    if ($substitution['newline']) {
                        $this->newline[] = $substitution['field_id'];
                    }
                }
            }
            $this->enabled_desc = !$row->hide_description;
            $this->enabled_field_names = !$row->hide_field_names;
        }

        if ($this->type == 'crs' or $this->type == 'rcrs') {
            // Handle ECS substitutions
            /*
             if($begin = self::$mappings->getMappingByECSName('begin') and
                 $end = self::$mappings->getMappingByECSName('end'))
             {
                 // Show something like 'Monday, 30.12.2008 9:00 - 12:00'
                 unset($this->active_fields[$end]);
             }
            */
        }
    }
    
    private function initECSMappings()
    {
        return true;

        include_once('./Services/WebServices/ECS/classes/class.ilECSDataMappingSettings.php');
        
        if (isset(self::$mappings) and is_object(self::$mappings)) {
            return true;
        }
        self::$mappings = ilECSDataMappingSettings::_getInstance();
        return true;
    }
}