This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Collaboration diagram for ilBadgeImageTemplate:

Public Member Functions
	__construct (int $a_id=null)

	getId ()

	setTitle (string $a_value)

	getTitle ()

	getTypes ()

	setTypes (array $types=null)

	getImage ()

	uploadImage (array $a_upload_meta)

	getImagePath ()

	create ()

	update ()

	delete ()

Static Public Member Functions
static	getInstances ()

static	getInstancesByType (string $a_type_unique_id)

Protected Member Functions
	setId (int $a_id)

	setImage (string $a_value)

	getFilePath (int $a_id, string $a_subdir=null)
	Init file system storage. More...

	read (int $a_id)

	readTypes (int $a_id)

	importDBRow (array $a_row)

	getPropertiesForStorage ()

	saveTypes ()

Protected Attributes
ilDBInterface	$db

int	$id = 0

string	$title = ""

string	$image = ""

array	$types = null

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Badge Template

Author: Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 24 of file class.ilBadgeImageTemplate.php.

Constructor & Destructor Documentation

◆ __construct()

ilBadgeImageTemplate::__construct ( int $a_id = null )

Definition at line 33 of file class.ilBadgeImageTemplate.php.

    {
        global $DIC;
 
        $this->db = $DIC->database();
        if ($a_id) {
            $this->read($a_id);
        }
    }

References $DIC, and read().

Here is the call graph for this function:

Member Function Documentation

◆ create()

ilBadgeImageTemplate::create ( )

Definition at line 245 of file class.ilBadgeImageTemplate.php.

                            : void
    {
        $ilDB = $this->db;
 
        if ($this->getId()) {
            $this->update();
            return;
        }
 
        $id = $ilDB->nextId("badge_image_template");
        $this->setId($id);
 
        $fields = $this->getPropertiesForStorage();
        $fields["id"] = array("integer", $id);
 
        $ilDB->insert("badge_image_template", $fields);
 
        $this->saveTypes();
    }

References $id, $ilDB, and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

◆ delete()

ilBadgeImageTemplate::delete ( )

Definition at line 285 of file class.ilBadgeImageTemplate.php.

                            : void
    {
        $ilDB = $this->db;
 
        if (!$this->getId()) {
            return;
        }
 
        $path = $this->getFilePath($this->getId());
        ilFileUtils::delDir($path);
 
        $ilDB->manipulate("DELETE FROM badge_image_template" .
            " WHERE id = " . $ilDB->quote($this->getId(), "integer"));
    }

References $ilDB, $path, ilFileUtils\delDir(), and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

◆ getFilePath()

ilBadgeImageTemplate::getFilePath	(	int	$a_id,
		string	$a_subdir = `null`
	)

protected

Init file system storage.

Definition at line 181 of file class.ilBadgeImageTemplate.php.

     : string {
        $storage = new ilFSStorageBadgeImageTemplate($a_id);
        $storage->create();
 
        $path = $storage->getAbsolutePath() . "/";
 
        if ($a_subdir) {
            $path .= $a_subdir . "/";
 
            if (!is_dir($path)) {
                mkdir($path);
            }
        }
 
        return $path;
    }

References $path.

Referenced by getImagePath(), and uploadImage().

Here is the caller graph for this function:

◆ getId()

ilBadgeImageTemplate::getId ( )

Definition at line 100 of file class.ilBadgeImageTemplate.php.

                           : int
    {
        return $this->id;
    }

References $id.

Referenced by getImagePath(), and uploadImage().

Here is the caller graph for this function:

◆ getImage()

ilBadgeImageTemplate::getImage ( )

Definition at line 135 of file class.ilBadgeImageTemplate.php.

                              : string
    {
        return $this->image;
    }

References $image.

Referenced by getImagePath().

Here is the caller graph for this function:

◆ getImagePath()

ilBadgeImageTemplate::getImagePath ( )

Definition at line 164 of file class.ilBadgeImageTemplate.php.

                                  : string
    {
        if ($this->getId()) {
            if (is_file($this->getFilePath($this->getId()) . "img" . $this->getId())) { // formerly (early 5.2 versino), images have been uploaded with no suffix
                return $this->getFilePath($this->getId()) . "img" . $this->getId();
            }
 
            $exp = explode(".", $this->getImage());
            $suffix = strtolower(array_pop($exp));
            return $this->getFilePath($this->getId()) . "img" . $this->getId() . "." . $suffix;
        }
        return "";
    }

References getFilePath(), getId(), and getImage().

Here is the call graph for this function:

◆ getInstances()

static ilBadgeImageTemplate::getInstances ( )

static

Returns: self[]

Definition at line 46 of file class.ilBadgeImageTemplate.php.

                                         : array
    {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $res = array();
 
        $types = array();
        $set = $ilDB->query("SELECT * FROM badge_image_templ_type");
        while ($row = $ilDB->fetchAssoc($set)) {
            $types[$row["tmpl_id"]][] = $row["type_id"];
        }
 
        $set = $ilDB->query("SELECT * FROM badge_image_template" .
            " ORDER BY title");
        while ($row = $ilDB->fetchAssoc($set)) {
            $row["types"] = (array) ($types[$row["id"]] ?? null);
 
            $obj = new self();
            $obj->importDBRow($row);
            $res[] = $obj;
        }
 
        return $res;
    }

References $DIC, $ilDB, $res, and $types.

Referenced by ilBadgeImageTemplateTableGUI\getItems().

Here is the caller graph for this function:

◆ getInstancesByType()

static ilBadgeImageTemplate::getInstancesByType ( string $a_type_unique_id )

static

Parameters

string $a_type_unique_id

Returns: self[]

Definition at line 77 of file class.ilBadgeImageTemplate.php.

                                                                       : array
    {
        $res = [];
 
        foreach (self::getInstances() as $tmpl) {
            if (!count($tmpl->getTypes()) || in_array($a_type_unique_id, $tmpl->getTypes(), true)) {
                $res[] = $tmpl;
            }
        }
 
        return $res;
    }

References $res.

◆ getPropertiesForStorage()

ilBadgeImageTemplate::getPropertiesForStorage ( )

protected

Returns: array<string, array>

Definition at line 303 of file class.ilBadgeImageTemplate.php.

                                                : array
    {
        return [
            "title" => ["text", $this->getTitle()],
            "image" => ["text", $this->getImage()]
        ];
    }

◆ getTitle()

ilBadgeImageTemplate::getTitle ( )

Definition at line 110 of file class.ilBadgeImageTemplate.php.

                              : string
    {
        return $this->title;
    }

References $title.

◆ getTypes()

ilBadgeImageTemplate::getTypes ( )

Returns: string[]

Definition at line 123 of file class.ilBadgeImageTemplate.php.

                              : ?array
    {
        return $this->types;
    }

References $types.

Referenced by ilObjBadgeAdministrationGUI\setImageTemplateFormValues().

Here is the caller graph for this function:

◆ importDBRow()

ilBadgeImageTemplate::importDBRow ( array $a_row )

protected

Definition at line 237 of file class.ilBadgeImageTemplate.php.

                                                : void
    {
        $this->setId($a_row["id"]);
        $this->setTitle($a_row["title"]);
        $this->setImage($a_row["image"]);
        $this->setTypes($a_row["types"]);
    }

◆ read()

ilBadgeImageTemplate::read ( int $a_id )

protected

Definition at line 206 of file class.ilBadgeImageTemplate.php.

                                      : void
    {
        $ilDB = $this->db;
 
        $set = $ilDB->query("SELECT * FROM badge_image_template" .
            " WHERE id = " . $ilDB->quote($a_id, "integer"));
        if ($ilDB->numRows($set)) {
            $row = $ilDB->fetchAssoc($set);
            $row["types"] = $this->readTypes($a_id);
            $this->importDBRow($row);
        }
    }

References $ilDB.

Referenced by __construct().

Here is the caller graph for this function:

◆ readTypes()

ilBadgeImageTemplate::readTypes ( int $a_id )

protected

Definition at line 219 of file class.ilBadgeImageTemplate.php.

                                           : ?array
    {
        $ilDB = $this->db;
 
        $res = array();
 
        $set = $ilDB->query("SELECT * FROM badge_image_templ_type WHERE tmpl_id = " . $ilDB->quote($a_id, "integer"));
        while ($row = $ilDB->fetchAssoc($set)) {
            $res[] = $row["type_id"];
        }
 
        if (!count($res)) {
            $res = null;
        }
 
        return $res;
    }

References $ilDB, and $res.

◆ saveTypes()

ilBadgeImageTemplate::saveTypes ( )

protected

Definition at line 311 of file class.ilBadgeImageTemplate.php.

                                  : void
    {
        $ilDB = $this->db;
 
        if ($this->getId()) {
            $ilDB->manipulate("DELETE FROM badge_image_templ_type" .
                " WHERE tmpl_id = " . $ilDB->quote($this->getId(), "integer"));
 
            if ($this->getTypes()) {
                foreach ($this->getTypes() as $type) {
                    $fields = array(
                        "tmpl_id" => array("integer", $this->getId()),
                        "type_id" => array("text", $type)
                    );
                    $ilDB->insert("badge_image_templ_type", $fields);
                }
            }
        }
    }

References $ilDB, $type, and ILIAS\Survey\Mode\getId().

Here is the call graph for this function:

◆ setId()

ilBadgeImageTemplate::setId ( int $a_id )

protected

Definition at line 95 of file class.ilBadgeImageTemplate.php.

                                       : void
    {
        $this->id = $a_id;
    }

◆ setImage()

ilBadgeImageTemplate::setImage ( string $a_value )

protected

Definition at line 115 of file class.ilBadgeImageTemplate.php.

                                                : void
    {
        $this->image = trim($a_value);
    }

Referenced by uploadImage().

Here is the caller graph for this function:

◆ setTitle()

ilBadgeImageTemplate::setTitle ( string $a_value )

Definition at line 105 of file class.ilBadgeImageTemplate.php.

                                             : void
    {
        $this->title = trim($a_value);
    }

◆ setTypes()

ilBadgeImageTemplate::setTypes ( array $types = null )

Definition at line 128 of file class.ilBadgeImageTemplate.php.

                                                 : void
    {
        $this->types = is_array($types)
            ? array_unique($types)
            : null;
    }

References $types.

◆ update()

ilBadgeImageTemplate::update ( )

Definition at line 265 of file class.ilBadgeImageTemplate.php.

                            : void
    {
        $ilDB = $this->db;
 
        if (!$this->getId()) {
            $this->create();
            return;
        }
 
        $fields = $this->getPropertiesForStorage();
 
        $ilDB->update(
            "badge_image_template",
            $fields,
            array("id" => array("integer", $this->getId()))
        );
 
        $this->saveTypes();
    }

References $ilDB, and ILIAS\Survey\Mode\getId().

Referenced by uploadImage().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ uploadImage()

ilBadgeImageTemplate::uploadImage ( array $a_upload_meta )

Exceptions

ilException
ilFileUtilsException

Definition at line 144 of file class.ilBadgeImageTemplate.php.

                                                     : void
    {
        if ($this->getId() &&
            $a_upload_meta["tmp_name"]) {
            $path = $this->getFilePath($this->getId());
 
 
            $filename = ilFileUtils::getValidFilename($a_upload_meta["name"]);
 
            $exp = explode(".", $filename);
            $suffix = strtolower(array_pop($exp));
            $tgt = $path . "img" . $this->getId() . "." . $suffix;
 
            if (ilFileUtils::moveUploadedFile($a_upload_meta["tmp_name"], "img" . $this->getId() . "." . $suffix, $tgt)) {
                $this->setImage($filename);
                $this->update();
            }
        }
    }

References $filename, $path, getFilePath(), getId(), ilFileUtils\getValidFilename(), ilFileUtils\moveUploadedFile(), setImage(), and update().

Here is the call graph for this function:

Field Documentation

◆ $db

ilDBInterface ilBadgeImageTemplate::$db

protected

Definition at line 26 of file class.ilBadgeImageTemplate.php.

◆ $id

int ilBadgeImageTemplate::$id = 0

protected

Definition at line 27 of file class.ilBadgeImageTemplate.php.

Referenced by getId().

◆ $image

string ilBadgeImageTemplate::$image = ""

protected

Definition at line 29 of file class.ilBadgeImageTemplate.php.

Referenced by getImage().

◆ $title

string ilBadgeImageTemplate::$title = ""

protected

Definition at line 28 of file class.ilBadgeImageTemplate.php.

Referenced by getTitle().

◆ $types

array ilBadgeImageTemplate::$types = null

protected

Definition at line 31 of file class.ilBadgeImageTemplate.php.

Referenced by getInstances(), getTypes(), and setTypes().

The documentation for this class was generated from the following file:

Services/Badge/classes/class.ilBadgeImageTemplate.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ create()

◆ delete()

◆ getFilePath()

◆ getId()

◆ getImage()

◆ getImagePath()

◆ getInstances()

◆ getInstancesByType()

◆ getPropertiesForStorage()

◆ getTitle()

◆ getTypes()

◆ importDBRow()

◆ read()

◆ readTypes()

◆ saveTypes()

◆ setId()

◆ setImage()

◆ setTitle()

◆ setTypes()

◆ update()

◆ uploadImage()

Field Documentation

◆ $db

◆ $id

◆ $image

◆ $title

◆ $types