Collaboration diagram for ilCertificateBackgroundImageUpload:

Public Member Functions
	__construct (\ILIAS\FileUpload\FileUpload $fileUpload, string $certificatePath, ilLanguage $language, ilLogger $logger, \ILIAS\Filesystem\Filesystem $fileSystem=null, ilCertificateUtilHelper $utilHelper=null, ilCertificateFileUtilsHelper $certificateFileUtilsHelper=null, LegacyPathHelperHelper $legacyPathHelper=null, string $rootDirectory=CLIENT_WEB_DIR, string $clientID=CLIENT_ID, \ILIAS\Filesystem\Filesystem $tmp_file_system=null)

	uploadBackgroundImage (string $imageTempFilename, int $version, ?array $pending_file=null)
	Uploads a background image for the certificate. More...

Data Fields
const	BACKGROUND_IMAGE_NAME = 'background.jpg'

const	BACKGROUND_THUMBNAIL_IMAGE_NAME = 'background.jpg.thumb.jpg'

const	BACKGROUND_TEMPORARY_FILENAME = 'background_upload.tmp'

Private Member Functions
	getTargetFilesystem (string $target)

	getTargetDir (string $target)

	createBackgroundImageTempfilePath ()
	Returns the filesystem path of the background image temp file during upload. More...

	createBackgroundImageThumbPath ()
	Returns the filesystem path of the background image thumbnail. More...

Private Attributes
	$fileUpload

	$certificatePath

	$language

	$rootDirectory

	$fileSystem

	$utilHelper

	$fileUtilsHelper

	$clientId

	$legacyPathHelper

	$logger

	$tmp_file_system

Detailed Description

Author: Niels Theen nthee.nosp@m.n@da.nosp@m.tabay.nosp@m..de

Definition at line 11 of file class.ilCertificateBackgroundImageUpload.php.

Constructor & Destructor Documentation

◆ __construct()

ilCertificateBackgroundImageUpload::__construct	(	\ILIAS\FileUpload\FileUpload	$fileUpload,
		string	$certificatePath,
		ilLanguage	$language,
		ilLogger	$logger,
		\ILIAS\Filesystem\Filesystem	$fileSystem = `null`,
		ilCertificateUtilHelper	$utilHelper = `null`,
		ilCertificateFileUtilsHelper	$certificateFileUtilsHelper = `null`,
		LegacyPathHelperHelper	$legacyPathHelper = `null`,
		string	$rootDirectory = `CLIENT_WEB_DIR`,
		string	$clientID = `CLIENT_ID`,
		\ILIAS\Filesystem\Filesystem	$tmp_file_system = `null`
	)

Definition at line 69 of file class.ilCertificateBackgroundImageUpload.php.

      {
        $this->fileUpload = $fileUpload;
        $this->certificatePath = $certificatePath;
        $this->language = $language;
        $this->logger = $logger;
        $this->rootDirectory = $rootDirectory;
 
        if (null === $fileSystem) {
            global $DIC;
            $fileSystem = $DIC->filesystem()->web();
        }
        $this->fileSystem = $fileSystem;
 
        if (null === $utilHelper) {
            $utilHelper = new ilCertificateUtilHelper();
        }
        $this->utilHelper = $utilHelper;
 
        if (null === $certificateFileUtilsHelper) {
            $certificateFileUtilsHelper = new ilCertificateFileUtilsHelper();
        }
        $this->fileUtilsHelper = $certificateFileUtilsHelper;
 
        if (null === $legacyPathHelper) {
            $legacyPathHelper = new LegacyPathHelperHelper();
        }
        $this->legacyPathHelper = $legacyPathHelper;
 
        $this->clientId = $clientID;
 
        if (null === $tmp_file_system) {
            global $DIC;
            $tmp_file_system = $DIC->filesystem()->temp();
        }
        $this->tmp_file_system = $tmp_file_system;
    }

References $certificatePath, $DIC, $fileSystem, $fileUpload, $language, $legacyPathHelper, $logger, $rootDirectory, $tmp_file_system, $utilHelper, and language().

Here is the call graph for this function:

Member Function Documentation

◆ createBackgroundImageTempfilePath()

ilCertificateBackgroundImageUpload::createBackgroundImageTempfilePath ( )

private

Returns the filesystem path of the background image temp file during upload.

Returns: string The filesystem path of the background image temp file

Definition at line 274 of file class.ilCertificateBackgroundImageUpload.php.

    {
        return $this->rootDirectory . $this->certificatePath . self::BACKGROUND_TEMPORARY_FILENAME;
    }

References BACKGROUND_TEMPORARY_FILENAME.

Referenced by uploadBackgroundImage().

Here is the caller graph for this function:

◆ createBackgroundImageThumbPath()

ilCertificateBackgroundImageUpload::createBackgroundImageThumbPath ( )

private

Returns the filesystem path of the background image thumbnail.

Returns: string The filesystem path of the background image thumbnail

Definition at line 284 of file class.ilCertificateBackgroundImageUpload.php.

    {
        return $this->rootDirectory . $this->certificatePath . self::BACKGROUND_THUMBNAIL_IMAGE_NAME;
    }

References BACKGROUND_THUMBNAIL_IMAGE_NAME.

Referenced by uploadBackgroundImage().

Here is the caller graph for this function:

◆ getTargetDir()

ilCertificateBackgroundImageUpload::getTargetDir ( string $target )

private

Parameters

$target

Returns: array

Definition at line 261 of file class.ilCertificateBackgroundImageUpload.php.

    {
        $absTargetDir = dirname($target);
        $targetDir = $this->legacyPathHelper->createRelativePath($absTargetDir);
 
        return  $targetDir;
    }

◆ getTargetFilesystem()

ilCertificateBackgroundImageUpload::getTargetFilesystem ( string $target )

private

Parameters

string $target

Returns: int

Definition at line 233 of file class.ilCertificateBackgroundImageUpload.php.

    {
        switch (true) {
            case strpos($target, $this->rootDirectory . '/' . $this->clientId) === 0:
            case strpos($target, './' . $this->rootDirectory . '/' . $this->clientId) === 0:
            case strpos($target, $this->rootDirectory) === 0:
                $targetFilesystem = \ILIAS\FileUpload\Location::WEB;
                break;
            case strpos($target, CLIENT_DATA_DIR . "/temp") === 0:
                $targetFilesystem = \ILIAS\FileUpload\Location::TEMPORARY;
                break;
            case strpos($target, CLIENT_DATA_DIR) === 0:
                $targetFilesystem = \ILIAS\FileUpload\Location::STORAGE;
                break;
            case strpos($target, ILIAS_ABSOLUTE_PATH . '/Customizing') === 0:
                $targetFilesystem = \ILIAS\FileUpload\Location::CUSTOMIZING;
                break;
            default:
                throw new InvalidArgumentException("Can not move files to \"$target\" because path can not be mapped to web, storage or customizing location.");
        }
 
        return $targetFilesystem;
    }

References CLIENT_DATA_DIR, ILIAS\FileUpload\Location\CUSTOMIZING, ILIAS\FileUpload\Location\STORAGE, ILIAS\FileUpload\Location\TEMPORARY, and ILIAS\FileUpload\Location\WEB.

◆ uploadBackgroundImage()

ilCertificateBackgroundImageUpload::uploadBackgroundImage	(	string	$imageTempFilename,
		int	$version,
		?array	$pending_file = `null`
	)

Uploads a background image for the certificate.

Creates a new directory for the certificate if needed. Removes an existing certificate image if necessary

Parameters

string	$imageTempFilename	Name of the temporary uploaded image file
int	$version	- Version of the current certifcate template
array \| null	$pending_file

Returns: integer An errorcode if the image upload fails, 0 otherwise

Exceptions

ILIAS\FileUpload\Exception\IllegalStateException

Exceptions

ILIAS\Filesystem\Exception\FileNotFoundException

Exceptions

ILIAS\Filesystem\Exception\IOException

Exceptions

ilException
ilFileUtilsException

Definition at line 132 of file class.ilCertificateBackgroundImageUpload.php.

    {
        $imagepath = $this->rootDirectory . $this->certificatePath;
 
        if (!$this->fileSystem->hasDir($imagepath)) {
            ilUtil::makeDirParents($imagepath);
        }
 
        $backgroundImageTempFilePath = $this->createBackgroundImageTempfilePath();
 
        $this->uploadFile($imageTempFilename, $backgroundImageTempFilePath, $pending_file);
 
        $backgroundImagePath = $this->certificatePath . 'background_' . $version . '.jpg';
 
        $this->utilHelper->convertImage(
            $backgroundImageTempFilePath,
            $this->rootDirectory . $backgroundImagePath,
            'JPEG'
        );
 
        $backgroundImageThumbnailPath = $this->createBackgroundImageThumbPath();
 
        $this->utilHelper->convertImage(
            $backgroundImageTempFilePath,
            $backgroundImageThumbnailPath,
            'JPEG',
            100
        );
 
        $convert_filename = self::BACKGROUND_IMAGE_NAME;
 
        if (!$this->fileSystem->has($backgroundImagePath)) {
            // something went wrong converting the file. use the original file and hope, that PDF can work with it
            if (!ilUtil::moveUploadedFile($backgroundImageTempFilePath, $convert_filename, $this->rootDirectory . $backgroundImagePath)) {
                throw new ilException('Unable to convert the file and the original file');
            }
        }
 
        $this->fileSystem->delete($this->certificatePath . self::BACKGROUND_TEMPORARY_FILENAME);
 
        if ($this->fileSystem->has($backgroundImagePath)) {
            return $this->certificatePath . 'background_' . $version . '.jpg';
        }
 
        throw new ilException('The given temporary filename is empty');
    }