ilDefaultPlaceholderValues Class Reference

Collection of basic placeholder values that can be used. More...

Inheritance diagram for ilDefaultPlaceholderValues:

Collaboration diagram for ilDefaultPlaceholderValues:

Public Member Functions
	__construct (?ilCertificateObjectHelper $objectHelper=null, ?ilCertificateDateHelper $dateHelper=null, ?int $dateFormat=null, ?ilLanguage $language=null, ?ilCertificateUtilHelper $utilHelper=null, ?ilUserDefinedFieldsPlaceholderValues $userDefinedFieldsPlaceholderValues=null, private readonly int $birthdayDateFormat=IL_CAL_DATE)
	getPlaceholderValuesForPreview (int $userId, int $objId)
	This method is different then the 'getPlaceholderValues' method, this method is used to create a placeholder value array containing dummy values that is used to create a preview certificate. More...
	setUserLanguage (ilLanguage $language)
Public Member Functions inherited from ilCertificatePlaceholderValues
	getPlaceholderValues (int $userId, int $objId)
	This method MUST return an array that contains the actual data for the given user of the given object. More...

Private Member Functions
	getUserLanguage (ilObjUser $user)

Private Attributes
readonly array	$placeholder
readonly ilCertificateObjectHelper	$objectHelper
readonly ilCertificateDateHelper	$dateHelper
readonly int	$dateFormat
readonly ilLanguage	$language
readonly ilCertificateUtilHelper	$utilHelper
readonly ilUserDefinedFieldsPlaceholderValues	$userDefinedFieldsPlaceholderValues
ilLanguage	$user_language = null

Detailed Description

Collection of basic placeholder values that can be used.

Author

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

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

Constructor & Destructor Documentation

__construct()

ilDefaultPlaceholderValues::__construct	(	?ilCertificateObjectHelper	$objectHelper = null,
		?ilCertificateDateHelper	$dateHelper = null,
		?int	$dateFormat = null,
		?ilLanguage	$language = null,
		?ilCertificateUtilHelper	$utilHelper = null,
		?ilUserDefinedFieldsPlaceholderValues	$userDefinedFieldsPlaceholderValues = null,
		private readonly int	$birthdayDateFormat = IL_CAL_DATE
	)

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

References $dateFormat, $dateHelper, $DIC, $language, $objectHelper, $objId, $placeholder, $userDefinedFieldsPlaceholderValues, $utilHelper, ilCertificatePlaceholderValues\getPlaceholderValues(), getUserLanguage(), IL_CAL_UNIX, and ILIAS\UI\examples\Symbol\Glyph\Language\language().

      {
        if (null === $objectHelper) {
            $objectHelper = new ilCertificateObjectHelper();
        }
        $this->objectHelper = $objectHelper;

        if (null === $dateHelper) {
            $dateHelper = new ilCertificateDateHelper();
        }
        $this->dateHelper = $dateHelper;

        if (null === $dateFormat) {
            $dateFormat = IL_CAL_UNIX;
        }
        $this->dateFormat = $dateFormat;

        if (null === $language) {
            global $DIC;
            $language = $DIC->language();
            $language->loadLanguageModule('certificate');
        }
        $this->language = $language;

        if (null === $utilHelper) {
            $utilHelper = new ilCertificateUtilHelper();
        }
        $this->utilHelper = $utilHelper;

        if (null === $userDefinedFieldsPlaceholderValues) {
            $userDefinedFieldsPlaceholderValues = new ilUserDefinedFieldsPlaceholderValues();
        }
        $this->userDefinedFieldsPlaceholderValues = $userDefinedFieldsPlaceholderValues;

        $this->placeholder = [
            'USER_LOGIN' => '',
            'USER_FULLNAME' => '',
            'USER_FIRSTNAME' => '',
            'USER_LASTNAME' => '',
            'USER_TITLE' => '',
            'USER_SALUTATION' => '',
            'USER_BIRTHDAY' => '',
            'USER_INSTITUTION' => '',
            'USER_DEPARTMENT' => '',
            'USER_STREET' => '',
            'USER_CITY' => '',
            'USER_ZIPCODE' => '',
            'USER_COUNTRY' => '',
            'USER_MATRICULATION' => '',
            'DATE' => '',
            'DATETIME' => '',
            'DATE_COMPLETED' => '',
            'DATETIME_COMPLETED' => '',
        ];
    }

Here is the call graph for this function:

Member Function Documentation

getPlaceholderValuesForPreview()

ilDefaultPlaceholderValues::getPlaceholderValuesForPreview	(	int	$userId,
		int	$objId
	)

This method is different then the 'getPlaceholderValues' method, this method is used to create a placeholder value array containing dummy values that is used to create a preview certificate.

Due the fact that this is a class to create default values the placeholder values will be identical to the description

Exceptions

ilDateTimeException
ilException

Implements ilCertificatePlaceholderValues.

Definition at line 170 of file class.ilDefaultPlaceholderValues.php.

References ILIAS\UI\examples\Symbol\Glyph\Language\language().

                                                                           : array
    {
        $previewPlacholderValues = [
            "USER_LOGIN" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_login")),
            "USER_FULLNAME" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_fullname")),
            "USER_FIRSTNAME" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_firstname")),
            "USER_LASTNAME" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_lastname")),
            "USER_TITLE" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_title")),
            "USER_SALUTATION" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_salutation")),
            "USER_BIRTHDAY" => $this->utilHelper->prepareFormOutput((trim($this->dateHelper->formatDate(
                time(),
                $this->dateFormat
            )))),
            "USER_INSTITUTION" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_institution")),
            "USER_DEPARTMENT" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_department")),
            "USER_STREET" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_street")),
            "USER_CITY" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_city")),
            "USER_ZIPCODE" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_zipcode")),
            "USER_COUNTRY" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_country")),
            "USER_MATRICULATION" => $this->utilHelper->prepareFormOutput($this->language->txt("certificate_var_user_matriculation")),
            'DATE' => $this->utilHelper->prepareFormOutput((trim($this->dateHelper->formatDate(
                time(),
                $this->dateFormat
            )))),
            'DATETIME' => $this->utilHelper->prepareFormOutput((trim($this->dateHelper->formatDateTime(
                time(),
                $this->dateFormat
            )))),
            'DATE_COMPLETED' => $this->utilHelper->prepareFormOutput((trim($this->dateHelper->formatDate(
                time(),
                $this->dateFormat
            )))),
            'DATETIME_COMPLETED' => $this->utilHelper->prepareFormOutput((trim($this->dateHelper->formatDateTime(
                time(),
                $this->dateFormat
            ))))
        ];

        return array_merge(
            $previewPlacholderValues,
            $this->userDefinedFieldsPlaceholderValues->getPlaceholderValuesForPreview($userId, $objId)
        );
    }

Here is the call graph for this function:

getUserLanguage()

ilDefaultPlaceholderValues::getUserLanguage ( ilObjUser  $user )

private

Definition at line 214 of file class.ilDefaultPlaceholderValues.php.

References $language, $user_language, ilObjUser\getLanguage(), and ilLanguage\loadLanguageModule().

Referenced by __construct().

                                                     : ilLanguage
    {
        if ($this->user_language instanceof ilLanguage) {
            return $this->user_language;
        }
        $language = new ilLanguage($user->getLanguage());
        $language->loadLanguageModule('certificate');
        $this->user_language = $language;
        return $language;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setUserLanguage()

ilDefaultPlaceholderValues::setUserLanguage

(

ilLanguage

$language

)

Definition at line 228 of file class.ilDefaultPlaceholderValues.php.

References $language.

                                                         : void
    {
        $this->user_language = $language;
    }

Field Documentation

$dateFormat

readonly int ilDefaultPlaceholderValues::$dateFormat

private

Definition at line 32 of file class.ilDefaultPlaceholderValues.php.

Referenced by __construct().

$dateHelper

readonly ilCertificateDateHelper ilDefaultPlaceholderValues::$dateHelper

private

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

Referenced by __construct().

$language

readonly ilLanguage ilDefaultPlaceholderValues::$language

private

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

Referenced by __construct(), getUserLanguage(), and setUserLanguage().

$objectHelper

readonly ilCertificateObjectHelper ilDefaultPlaceholderValues::$objectHelper

private

Definition at line 30 of file class.ilDefaultPlaceholderValues.php.

Referenced by __construct().

$placeholder

readonly array ilDefaultPlaceholderValues::$placeholder

private

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

Referenced by __construct().

$user_language

ilLanguage ilDefaultPlaceholderValues::$user_language = null

private

Definition at line 36 of file class.ilDefaultPlaceholderValues.php.

Referenced by getUserLanguage().

$userDefinedFieldsPlaceholderValues

readonly ilUserDefinedFieldsPlaceholderValues ilDefaultPlaceholderValues::$userDefinedFieldsPlaceholderValues

private

Definition at line 35 of file class.ilDefaultPlaceholderValues.php.

Referenced by __construct().

$utilHelper

readonly ilCertificateUtilHelper ilDefaultPlaceholderValues::$utilHelper

private

Definition at line 34 of file class.ilDefaultPlaceholderValues.php.

Referenced by __construct().

---

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

• Services/Certificate/classes/Placeholder/Values/class.ilDefaultPlaceholderValues.php