class.ilAdvancedMDFieldDefinitionText.php

Go to the documentation of this file.

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

require_once "Services/AdvancedMetaData/classes/class.ilAdvancedMDFieldDefinition.php";

class ilAdvancedMDFieldDefinitionText extends ilAdvancedMDFieldDefinitionGroupBased
{
    const XML_SEPARATOR_TRANSLATIONS = "~|~";
    const XML_SEPARATOR_TRANSLATION = '~+~';

    protected $max_length;
    protected $multi;
    
    
    //
    // generic types
    //
    
    public function getType()
    {
        return self::TYPE_TEXT;
    }


    public function getADTGroup()
    {
        return $this->getADTDefinition();
    }

    public function getTitles()
    {
        return [];
    }

    public function hasComplexOptions()
    {
        return false;
    }

    protected function initADTDefinition()
    {
        $field_translations = ilAdvancedMDFieldTranslations::getInstanceByRecordId($this->getRecordId());

        $definition = ilADTFactory::getInstance()->getDefinitionInstanceByType(ilADTFactory::TYPE_LOCALIZED_TEXT);
        $definition->setMaxLength((int) $this->getMaxLength());
        $definition->setActiveLanguages($field_translations->getActivatedLanguages($this->getFieldId(), true));
        $definition->setDefaultLanguage($field_translations->getDefaultLanguage());
        return $definition;
    }

    
    //
    // properties
    //
    
    public function setMaxLength($a_value)
    {
        if ($a_value !== null) {
            $a_value = (int) $a_value;
        }
        $this->max_length = $a_value;
    }

    public function getMaxLength()
    {
        return $this->max_length;
    }
    
    public function setMulti($a_value)
    {
        $this->multi = (bool) $a_value;
    }

    public function isMulti()
    {
        return $this->multi;
    }
    
    
    //
    // definition (NOT ADT-based)
    //
    
    protected function importFieldDefinition(array $a_def)
    {
        $this->setMaxLength($a_def["max"]);
        $this->setMulti($a_def["multi"]);
    }
    
    protected function getFieldDefinition()
    {
        return array(
            "max" => $this->getMaxLength(),
            "multi" => $this->isMulti()
        );
    }
    
    public function getFieldDefinitionForTableGUI(string $content_language)
    {
        global $DIC;

        $lng = $DIC['lng'];
    
        $res = array();
        
        if ($this->getMaxLength() !== null) {
            $res[$lng->txt("md_adv_text_max_length")] = $this->getMaxLength();
        }
        if ($this->isMulti()) {
            $res[$lng->txt("md_adv_text_multi")] = $lng->txt("yes");
        }
        
        return $res;
    }

    public function addCustomFieldToDefinitionForm(ilPropertyFormGUI $a_form, $a_disabled = false, string $language = '')
    {
        global $DIC;

        $lng = $DIC['lng'];
        
        $max = new ilNumberInputGUI($lng->txt("md_adv_text_max_length"), "max");
        $max->setValue($this->getMaxLength());
        $max->setSize(10);
        $max->setSuffix($lng->txt("characters"));
        $max->setMinValue(1);
        $max->setMaxValue(4000); // DB limit
        $a_form->addItem($max);
        
        $multi = new ilCheckboxInputGUI($lng->txt("md_adv_text_multi"), "multi");
        $multi->setValue(1);
        $multi->setChecked($this->isMulti());
        $a_form->addItem($multi);
                
        if ($a_disabled) {
            $max->setDisabled(true);
            $multi->setDisabled(true);
        }
    }

    public function importCustomDefinitionFormPostValues(ilPropertyFormGUI $a_form, string $language = '')
    {
        $max = $a_form->getInput("max");
        $this->setMaxLength(($max !== "") ? $max : null);
        
        $this->setMulti($a_form->getInput("multi"));
    }
    
    //
    // import/export
    //
    
    protected function addPropertiesToXML(ilXmlWriter $a_writer)
    {
        $a_writer->xmlElement('FieldValue', array("id" => "max"), $this->getMaxLength());
        $a_writer->xmlElement('FieldValue', array("id" => "multi"), $this->isMulti());
    }
    
    public function importXMLProperty($a_key, $a_value)
    {
        if ($a_key == "max") {
            $this->setMaxLength($a_value != "" ? $a_value : null);
        }
        if ($a_key == "multi") {
            $this->setMulti($a_value != "" ? $a_value : null);
        }
    }
    
    public function getValueForXML(ilADT $element)
    {
        $translations = $element->getTranslations();
        $serialized_values = [];
        foreach ($translations as $lang_key => $translation) {
            $serialized_values[] = $lang_key . self::XML_SEPARATOR_TRANSLATION . $translation;
        }
        return implode(self::XML_SEPARATOR_TRANSLATIONS, $serialized_values);
    }

    public function importValueFromXML($a_cdata)
    {
        // an import from release < 7
        if (strpos($a_cdata, self::XML_SEPARATOR_TRANSLATION) === false) {
            $this->getADT()->setText($a_cdata);
            return;
        }

        $translations = explode(self::XML_SEPARATOR_TRANSLATIONS, $a_cdata);
        foreach ($translations as $translation) {
            $parts = explode(self::XML_SEPARATOR_TRANSLATION, $translation);
            if ($parts === false) {
                continue;
            }
            $this->getADT()->setTranslation((string) $parts[0], (string) $parts[1]);
        }
    }
    
    public function importFromECS($a_ecs_type, $a_value, $a_sub_id)
    {
        switch ($a_ecs_type) {
            case ilECSUtils::TYPE_ARRAY:
                $value = implode(',', (array) $a_value);
                break;

            case ilECSUtils::TYPE_INT:
                $value = (int) $a_value;
                break;

            case ilECSUtils::TYPE_STRING:
                $value = (string) $a_value;
                break;

            case ilECSUtils::TYPE_TIMEPLACE:
                if ($a_value instanceof ilECSTimePlace) {
                    $value = $a_value->{'get' . ucfirst($a_sub_id)}();
                }
                break;
        }
        
        if (trim($value)) {
            $this->getADT()->setText($value);
            return true;
        }
        return false;
    }

    public function prepareElementForEditor(ilADTFormBridge $form)
    {
        if (!$form instanceof ilADTLocalizedTextFormBridge) {
            $this->logger->warning('Passed ' . get_class($form));
            return;
        }
        $form->setMulti($this->isMulti());
    }
    
    
    public function getSearchQueryParserValue(ilADTSearchBridge $a_adt_search)
    {
        return $a_adt_search->getADT()->getText();
    }
    
    protected function parseSearchObjects(array $a_records, array $a_object_types)
    {
        global $DIC;

        $ilDB = $DIC['ilDB'];
        
        $res = array();
        
        $obj_ids = array();
        foreach ($a_records as $record) {
            if ($record["sub_type"] == "-") {
                // keep found information
                $obj_ids[$record["obj_id"]] = $record;
            }
        }
        
        $sql = "SELECT obj_id,type" .
            " FROM object_data" .
            " WHERE " . $ilDB->in("obj_id", array_keys($obj_ids), "", "integer") .
            " AND " . $ilDB->in("type", $a_object_types, "", "text");
        $set = $ilDB->query($sql);
        while ($row = $ilDB->fetchAssoc($set)) {
            $row["found"] = array();
            foreach ($obj_ids[$row["obj_id"]] as $field => $value) {
                if (substr($field, 0, 5) == "found") {
                    $row["found"][$field] = $value;
                }
            }
            $res[] = $row;
        }
        
        return $res;
    }
    
    public function searchObjects(ilADTSearchBridge $a_adt_search, ilQueryParser $a_parser, array $a_object_types, $a_locate, $a_search_type)
    {
        // :TODO: search type (like, fulltext)

        include_once('Services/ADT/classes/ActiveRecord/class.ilADTActiveRecordByType.php');
        $condition = $a_adt_search->getSQLCondition(
            ilADTActiveRecordByType::SINGLE_COLUMN_NAME,
            ilADTTextSearchBridgeSingle::SQL_LIKE,
            $a_parser->getQuotedWords()
        );
        if ($condition) {
            $objects = ilADTActiveRecordByType::find(
                'adv_md_values',
                $this->getADT()->getType(),
                $this->getFieldId(),
                $condition,
                $a_locate);
            if (isset($objects) && count($objects)) {
                return $this->parseSearchObjects($objects, $a_object_types);
            }
            return [];
        }
    }
}