GUI class to create PDF certificates. More...

Collaboration diagram for ilCertificateGUI:

Public Member Functions
	__construct (ilCertificatePlaceholderDescription $placeholderDescriptionObject, ilCertificatePlaceholderValues $placeholderValuesObject, int $objectId, string $certificatePath, ?ilCertificateFormRepository $settingsFormFactory=null, ?ilCertificateDeleteAction $deleteAction=null, ?ilCertificateTemplateRepository $templateRepository=null, ?ilPageFormats $pageFormats=null, ?ilXlsFoParser $xlsFoParser=null, ?ilCertificateTemplateExportAction $exportAction=null, ?ilCertificateBackgroundImageUpload $upload=null, ?ilCertificateTemplatePreviewAction $previewAction=null, ?FileUpload $fileUpload=null, ?ilSetting $settings=null, ?ilCertificateBackgroundImageDelete $backgroundImageDelete=null, ?Filesystem $fileSystem=null, ?ilCertificateBackgroundImageFileService $imageFileService=null, ?Filesystem $tmp_file_system=null)

	executeCommand ()

	getCommand ($cmd)

	certificateImport ()

	certificatePreview ()

	certificateExportFO ()
	Exports the certificate. More...

	certificateRemoveBackground ()

	certificateDelete ()

	certificateDeleteConfirm ()
	Deletes the certificate and all its data. More...

	certificateSave ()
	Saves the certificate. More...

	certificateUpload ()

Protected Attributes
ilCtrlInterface	$ctrl

ilTree	$tree

ILIAS	$ilias

ilGlobalPageTemplate	$tpl

ilLanguage	$lng

int	$ref_id

ilAccessHandler	$access

ilToolbarGUI	$toolbar

Private Member Functions
	getEditorForm ()

	setTemplateContent (ilCertificateTemplate $certificate, ilPropertyFormGUI $form)

	createFormatArray (ilCertificateTemplate $certificateTemplate)

Detailed Description

GUI class to create PDF certificates.

Author: Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m

Version: $Id$

@ilCtrl_Calls ilCertificateGUI: ilPropertyFormGUI

Definition at line 38 of file class.ilCertificateGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilCertificateGUI::__construct	(	ilCertificatePlaceholderDescription	$placeholderDescriptionObject,
		ilCertificatePlaceholderValues	$placeholderValuesObject,
		int	$objectId,
		string	$certificatePath,
		?ilCertificateFormRepository	$settingsFormFactory = `null`,
		?ilCertificateDeleteAction	$deleteAction = `null`,
		?ilCertificateTemplateRepository	$templateRepository = `null`,
		?ilPageFormats	$pageFormats = `null`,
		?ilXlsFoParser	$xlsFoParser = `null`,
		?ilCertificateTemplateExportAction	$exportAction = `null`,
		?ilCertificateBackgroundImageUpload	$upload = `null`,
		?ilCertificateTemplatePreviewAction	$previewAction = `null`,
		?FileUpload	$fileUpload = `null`,
		?ilSetting	$settings = `null`,
		?ilCertificateBackgroundImageDelete	$backgroundImageDelete = `null`,
		?Filesystem	$fileSystem = `null`,
		?ilCertificateBackgroundImageFileService	$imageFileService = `null`,
		?Filesystem	$tmp_file_system = `null`
	)

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

      {
        global $DIC;
        $this->httpWrapper = $DIC->http()->wrapper();
        $this->refinery = $DIC->refinery();
        $this->lng = $DIC['lng'];
        $this->tpl = $DIC['tpl'];
        $this->ctrl = $DIC['ilCtrl'];
        $this->ilias = $DIC['ilias'];
 
        $this->tree = $DIC['tree'];
        $this->access = $DIC['ilAccess'];
        $this->toolbar = $DIC['ilToolbar'];
 
        $this->global_certificate_settings = new ilObjCertificateSettings();
 
        $this->lng->loadLanguageModule('certificate');
        $this->lng->loadLanguageModule('cert');
        $this->lng->loadLanguageModule("trac");
 
        $this->ref_id = (int) $DIC->http()->wrapper()->query()->retrieve("ref_id", $DIC->refinery()->kindlyTo()->int());
 
        $this->placeholderDescriptionObject = $placeholderDescriptionObject;
 
        $this->objectId = $objectId;
 
        $this->logger = $DIC->logger()->cert();
 
        if (null === $settingsFormFactory) {
            $settingsFormFactory = new ilCertificateSettingsFormRepository(
                $this->objectId,
                $certificatePath,
                $this->lng,
                $this->tpl,
                $this->ctrl,
                $this->access,
                $this->toolbar,
                $placeholderDescriptionObject
            );
        }
        $this->settingsFormFactory = $settingsFormFactory;
 
        if (null === $templateRepository) {
            $templateRepository = new ilCertificateTemplateDatabaseRepository($DIC->database(), $this->logger);
        }
        $this->templateRepository = $templateRepository;
 
        if (null === $deleteAction) {
            $deleteAction = new ilCertificateTemplateDeleteAction($templateRepository);
        }
        $this->deleteAction = $deleteAction;
 
        if (null === $pageFormats) {
            $pageFormats = new ilPageFormats($DIC->language());
        }
        $this->pageFormats = $pageFormats;
 
        if (null === $xlsFoParser) {
            $xlsFoParser = new ilXlsFoParser($DIC->settings(), $pageFormats);
        }
        $this->xlsFoParser = $xlsFoParser;
 
        if (null === $upload) {
            $upload = new ilCertificateBackgroundImageUpload(
                $DIC->upload(),
                $certificatePath,
                $DIC->language(),
                $this->logger
            );
        }
        $this->backgroundImageUpload = $upload;
 
        if (null === $exportAction) {
            $exportAction = new ilCertificateTemplateExportAction(
                $this->objectId,
                $certificatePath,
                $this->templateRepository,
                $DIC->filesystem()->web()
            );
        }
        $this->exportAction = $exportAction;
 
        if (null === $previewAction) {
            $previewAction = new ilCertificateTemplatePreviewAction($templateRepository, $placeholderValuesObject);
        }
        $this->previewAction = $previewAction;
 
        if (null === $fileUpload) {
            global $DIC;
            $fileUpload = $DIC->upload();
        }
        $this->fileUpload = $fileUpload;
 
        $this->certificatePath = $certificatePath;
 
        if (null === $settings) {
            $settings = new ilSetting('certificate');
        }
        $this->settings = $settings;
 
        if (null === $fileSystem) {
            $fileSystem = $DIC->filesystem()->web();
        }
        $this->fileSystem = $fileSystem;
 
        if (null === $imageFileService) {
            $imageFileService = new ilCertificateBackgroundImageFileService(
                $this->certificatePath,
                $this->fileSystem
            );
        }
 
        if (null === $backgroundImageDelete) {
            $backgroundImageDelete = new ilCertificateBackgroundImageDelete(
                $this->certificatePath,
                $imageFileService
            );
        }
        $this->backgroundImageDelete = $backgroundImageDelete;
 
        if (null === $tmp_file_system) {
            $tmp_file_system = $DIC->filesystem()->temp();
        }
        $this->tmp_file_system = $tmp_file_system;
    }

References $backgroundImageDelete, $certificatePath, $deleteAction, $DIC, $exportAction, $fileSystem, $fileUpload, $objectId, $pageFormats, $placeholderDescriptionObject, $previewAction, $settings, $settingsFormFactory, $templateRepository, $tmp_file_system, $xlsFoParser, ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ILIAS\Repository\int(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), ILIAS\Repository\refinery(), ILIAS\Repository\settings(), and ILIAS\Repository\toolbar().

Here is the call graph for this function:

Member Function Documentation

◆ certificateDelete()

ilCertificateGUI::certificateDelete ( )

Definition at line 290 of file class.ilCertificateGUI.php.

                                       : void
    {
        // display confirmation message
        $cgui = new ilConfirmationGUI();
        $cgui->setFormAction($this->ctrl->getFormAction($this, "certificateEditor"));
        $cgui->setHeaderText($this->lng->txt("certificate_confirm_deletion_text"));
        $cgui->setCancel($this->lng->txt("no"), "certificateEditor");
        $cgui->setConfirm($this->lng->txt("yes"), "certificateDeleteConfirm");
 
        $this->tpl->setContent($cgui->getHTML());
    }

References ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ certificateDeleteConfirm()

ilCertificateGUI::certificateDeleteConfirm ( )

Deletes the certificate and all its data.

Definition at line 305 of file class.ilCertificateGUI.php.

                                              : void
    {
        $template = $this->templateRepository->fetchCurrentlyUsedCertificate($this->objectId);
        $templateId = $template->getId();
 
        $this->deleteAction->delete($templateId, $this->objectId);
        $this->ctrl->redirect($this, "certificateEditor");
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ certificateExportFO()

ilCertificateGUI::certificateExportFO ( )

Exports the certificate.

Exceptions

FileAlreadyExistsException
FileNotFoundException
IOException

Definition at line 270 of file class.ilCertificateGUI.php.

                                         : void
    {
        $this->exportAction->export();
    }

◆ certificateImport()

ilCertificateGUI::certificateImport ( )

Definition at line 249 of file class.ilCertificateGUI.php.

                                       : void
    {
        $this->certificateEditor();
    }

◆ certificatePreview()

ilCertificateGUI::certificatePreview ( )

Definition at line 254 of file class.ilCertificateGUI.php.

                                        : void
    {
        try {
            $this->previewAction->createPreviewPdf($this->objectId);
        } catch (Exception $exception) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('error_creating_certificate_pdf'));
            $this->certificateEditor();
        }
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

◆ certificateRemoveBackground()

ilCertificateGUI::certificateRemoveBackground ( )

Exceptions

FileAlreadyExistsException
FileNotFoundException
IOException
ilDatabaseException
ilException
ilObjectNotFoundException
ilWACException

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

                                                 : void
    {
        $this->backgroundImageDelete->deleteBackgroundImage(null);
        $this->certificateEditor();
    }

◆ certificateSave()

ilCertificateGUI::certificateSave ( )

Saves the certificate.

Exceptions

FileAlreadyExistsException
FileNotFoundException
IOException
ilDatabaseException
ilException
ilWACException

Definition at line 323 of file class.ilCertificateGUI.php.

                                     : void
    {
        global $DIC;
 
        $form = $this->settingsFormFactory->createForm(
            $this
        );
 
        $form->setValuesByPost();
 
        $request = $DIC->http()->request();
 
        $formFields = $request->getParsedBody();
 
        $this->tpl->setVariable('ADM_CONTENT', $form->getHTML());
 
        $this->saveCertificate($form, $formFields, $this->objectId);
    }

References $DIC.

◆ certificateUpload()

ilCertificateGUI::certificateUpload ( )

Exceptions

FileAlreadyExistsException
FileNotFoundException
IOException
ilDatabaseException
ilException
ilObjectNotFoundException
ilWACException

Definition at line 351 of file class.ilCertificateGUI.php.

                                       : void
    {
        $this->certificateEditor();
    }

◆ createFormatArray()

ilCertificateGUI::createFormatArray ( ilCertificateTemplate $certificateTemplate )

private

Definition at line 591 of file class.ilCertificateGUI.php.

                                                                                  : array
    {
        if ('' === $certificateTemplate->getCertificateHash()) {
            $format = $this->settings->get('pageformat', '');
            $formats = $this->pageFormats->fetchPageFormats();
 
            return [
                'pageformat' => $format,
                'pagewidth' => $formats['width'] ?? '',
                'pageheight' => $formats['height'] ?? '',
                'margin_body_top' => ilPageFormats::DEFAULT_MARGIN_BODY_TOP,
                'margin_body_right' => ilPageFormats::DEFAULT_MARGIN_BODY_RIGHT,
                'margin_body_bottom' => ilPageFormats::DEFAULT_MARGIN_BODY_BOTTOM,
                'margin_body_left' => ilPageFormats::DEFAULT_MARGIN_BODY_LEFT,
                'certificate_text' => $certificateTemplate->getCertificateContent()
            ];
        }
        return $this->settingsFormFactory->fetchFormFieldData($certificateTemplate->getCertificateContent());
    }

References $format, $formats, ilPageFormats\DEFAULT_MARGIN_BODY_BOTTOM, ilPageFormats\DEFAULT_MARGIN_BODY_LEFT, ilPageFormats\DEFAULT_MARGIN_BODY_RIGHT, ilPageFormats\DEFAULT_MARGIN_BODY_TOP, ilCertificateTemplate\getCertificateContent(), ilCertificateTemplate\getCertificateHash(), and ILIAS\Repository\settings().

Referenced by getEditorForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ executeCommand()

ilCertificateGUI::executeCommand ( )

Returns: mixed|null

Exceptions

FileAlreadyExistsException
FileNotFoundException
IOException
ilCtrlException
ilDatabaseException
ilException
ilWACException

Definition at line 223 of file class.ilCertificateGUI.php.

    {
        $cmd = $this->ctrl->getCmd();
        $next_class = $this->ctrl->getNextClass($this);
 
        $ret = null;
 
        $cmd = $this->getCommand($cmd);
        switch ($next_class) {
            case 'ilpropertyformgui':
                $form = $this->getEditorForm();
                $this->ctrl->forwardCommand($form);
                break;
 
            default:
                $ret = $this->$cmd();
                break;
        }
        return $ret;
    }

References ILIAS\Repository\ctrl(), getCommand(), and getEditorForm().

Here is the call graph for this function:

◆ getCommand()

ilCertificateGUI::getCommand ( $cmd )

Definition at line 244 of file class.ilCertificateGUI.php.

    {
        return $cmd;
    }

Referenced by executeCommand().

Here is the caller graph for this function:

◆ getEditorForm()

ilCertificateGUI::getEditorForm ( )

private

Returns: ilPropertyFormGUI

Exceptions

FileAlreadyExistsException
FileNotFoundException
IOException
ilDatabaseException
ilException
ilWACException

Definition at line 365 of file class.ilCertificateGUI.php.

                                    : ilPropertyFormGUI
    {
        $certificateTemplate = $this->templateRepository->fetchCurrentlyUsedCertificate($this->objectId);
 
        $form = $this->settingsFormFactory->createForm(
            $this
        );
 
        $formFields = $this->createFormatArray($certificateTemplate);
 
        $formFields['active'] = $certificateTemplate->isCurrentlyActive();
 
        $form->setValuesByArray($formFields);
 
        return $form;
    }

References createFormatArray().

Referenced by executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setTemplateContent()

ilCertificateGUI::setTemplateContent	(	ilCertificateTemplate	$certificate,
		ilPropertyFormGUI	$form
	)

private

Definition at line 581 of file class.ilCertificateGUI.php.

                                                                                                    : void
    {
        $form_fields = $this->settingsFormFactory->fetchFormFieldData($certificate->getCertificateContent());
        $form_fields['active'] = $certificate->isCurrentlyActive();
 
        $form->setValuesByArray($form_fields);
 
        $this->tpl->setVariable("ADM_CONTENT", $form->getHTML());
    }

References ilCertificateTemplate\getCertificateContent(), ilPropertyFormGUI\getHTML(), ilCertificateTemplate\isCurrentlyActive(), and ilPropertyFormGUI\setValuesByArray().

Here is the call graph for this function:

Field Documentation

◆ $access

ilAccessHandler ilCertificateGUI::$access

protected

Definition at line 50 of file class.ilCertificateGUI.php.

◆ $backgroundImageDelete

ilCertificateBackgroundImageDelete ilCertificateGUI::$backgroundImageDelete

private

Definition at line 40 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $backgroundImageUpload

ilCertificateBackgroundImageUpload ilCertificateGUI::$backgroundImageUpload

private

Definition at line 59 of file class.ilCertificateGUI.php.

◆ $certificatePath

string ilCertificateGUI::$certificatePath

private

Definition at line 62 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $ctrl

ilCtrlInterface ilCertificateGUI::$ctrl

protected

Definition at line 44 of file class.ilCertificateGUI.php.

◆ $deleteAction

ilCertificateDeleteAction ilCertificateGUI::$deleteAction

private

Definition at line 57 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $exportAction

ilCertificateTemplateExportAction ilCertificateGUI::$exportAction

private

Definition at line 58 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $fileSystem

Filesystem ilCertificateGUI::$fileSystem

private

Definition at line 41 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $fileUpload

FileUpload ilCertificateGUI::$fileUpload

private

Definition at line 61 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $global_certificate_settings

ilObjCertificateSettings ilCertificateGUI::$global_certificate_settings

private

Definition at line 67 of file class.ilCertificateGUI.php.

◆ $httpWrapper

WrapperFactory ilCertificateGUI::$httpWrapper

private

Definition at line 42 of file class.ilCertificateGUI.php.

◆ $ilias

ILIAS ilCertificateGUI::$ilias

protected

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

◆ $lng

ilLanguage ilCertificateGUI::$lng

protected

Definition at line 48 of file class.ilCertificateGUI.php.

◆ $logger

ilLogger ilCertificateGUI::$logger

private

Definition at line 66 of file class.ilCertificateGUI.php.

◆ $objectId

int ilCertificateGUI::$objectId

private

Definition at line 54 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $pageFormats

ilPageFormats ilCertificateGUI::$pageFormats

private

Definition at line 64 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $placeholderDescriptionObject

ilCertificatePlaceholderDescription ilCertificateGUI::$placeholderDescriptionObject

private

Definition at line 53 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $previewAction

ilCertificateTemplatePreviewAction ilCertificateGUI::$previewAction

private

Definition at line 60 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $ref_id

int ilCertificateGUI::$ref_id

protected

Definition at line 49 of file class.ilCertificateGUI.php.

◆ $refinery

Factory ilCertificateGUI::$refinery

private

Definition at line 43 of file class.ilCertificateGUI.php.

◆ $settings

ilSetting ilCertificateGUI::$settings

private

Definition at line 63 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $settingsFormFactory

ilCertificateFormRepository ilCertificateGUI::$settingsFormFactory

private

Definition at line 55 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $templateRepository

ilCertificateTemplateRepository ilCertificateGUI::$templateRepository

private

Definition at line 52 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $tmp_file_system

Filesystem ilCertificateGUI::$tmp_file_system

private

Definition at line 65 of file class.ilCertificateGUI.php.

Referenced by __construct().

◆ $toolbar

ilToolbarGUI ilCertificateGUI::$toolbar

protected

Definition at line 51 of file class.ilCertificateGUI.php.

◆ $tpl

ilGlobalPageTemplate ilCertificateGUI::$tpl

protected

Definition at line 47 of file class.ilCertificateGUI.php.

◆ $tree

ilTree ilCertificateGUI::$tree

protected

Definition at line 45 of file class.ilCertificateGUI.php.

◆ $xlsFoParser

ilXlsFoParser ilCertificateGUI::$xlsFoParser

private

Definition at line 56 of file class.ilCertificateGUI.php.

Referenced by __construct().

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

Services/Certificate/classes/class.ilCertificateGUI.php

Private Attributes
ilCertificateBackgroundImageDelete	$backgroundImageDelete

Filesystem	$fileSystem

WrapperFactory	$httpWrapper

Factory	$refinery

ilCertificateTemplateRepository	$templateRepository

ilCertificatePlaceholderDescription	$placeholderDescriptionObject

int	$objectId

ilCertificateFormRepository	$settingsFormFactory

ilXlsFoParser	$xlsFoParser

ilCertificateDeleteAction	$deleteAction

ilCertificateTemplateExportAction	$exportAction

ilCertificateBackgroundImageUpload	$backgroundImageUpload

ilCertificateTemplatePreviewAction	$previewAction

FileUpload	$fileUpload

string	$certificatePath

ilSetting	$settings

ilPageFormats	$pageFormats

Filesystem	$tmp_file_system

ilLogger	$logger

ilObjCertificateSettings	$global_certificate_settings

Public Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ certificateDelete()

◆ certificateDeleteConfirm()

◆ certificateExportFO()

◆ certificateImport()

◆ certificatePreview()

◆ certificateRemoveBackground()

◆ certificateSave()

◆ certificateUpload()

◆ createFormatArray()

◆ executeCommand()

◆ getCommand()

◆ getEditorForm()

◆ setTemplateContent()

Field Documentation

◆ $access

◆ $backgroundImageDelete

◆ $backgroundImageUpload

◆ $certificatePath

◆ $ctrl

◆ $deleteAction

◆ $exportAction

◆ $fileSystem

◆ $fileUpload

◆ $global_certificate_settings

◆ $httpWrapper

◆ $ilias

◆ $lng

◆ $logger

◆ $objectId

◆ $pageFormats

◆ $placeholderDescriptionObject

◆ $previewAction

◆ $ref_id

◆ $refinery

◆ $settings

◆ $settingsFormFactory

◆ $templateRepository

◆ $tmp_file_system

◆ $toolbar

◆ $tpl

◆ $tree

◆ $xlsFoParser