Collaboration diagram for ilTermsOfServiceHelper:

Public Member Functions
	__construct (?ilTermsOfServiceDataGatewayFactory $dataGatewayFactory=null, ?ilTermsOfServiceDocumentEvaluation $termsOfServiceEvaluation=null, ?ilTermsOfServiceCriterionTypeFactoryInterface $criterionTypeFactory=null, ?ilObjTermsOfService $tos=null)

	isGloballyEnabled ()

	deleteAcceptanceHistoryByUser (int $userId)

	getCurrentAcceptanceForUser (ilObjUser $user)

	getById (int $id)

	trackAcceptance (ilObjUser $user, ilTermsOfServiceSignableDocument $document)

	resetAcceptance (ilObjUser $user)

	isIncludedUser (ilObjUser $user)

	hasToResignAcceptance (ilObjUser $user, ilLogger $logger)

Static Public Member Functions
static	isEnabled ()

Protected Attributes
ilTermsOfServiceDataGatewayFactory	$dataGatewayFactory

ilTermsOfServiceDocumentEvaluation	$termsOfServiceEvaluation

ilTermsOfServiceCriterionTypeFactoryInterface	$criterionTypeFactory

ilObjTermsOfService	$tos

Private Member Functions
	getEntityFactory ()

	getDataGatewayFactory ()

Detailed Description

Class ilTermsOfServiceHelper.

Author: Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de

Definition at line 25 of file class.ilTermsOfServiceHelper.php.

Constructor & Destructor Documentation

◆ __construct()

ilTermsOfServiceHelper::__construct	(	?ilTermsOfServiceDataGatewayFactory	$dataGatewayFactory = `null`,
		?ilTermsOfServiceDocumentEvaluation	$termsOfServiceEvaluation = `null`,
		?ilTermsOfServiceCriterionTypeFactoryInterface	$criterionTypeFactory = `null`,
		?ilObjTermsOfService	$tos = `null`
	)

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

      {
        global $DIC;
 
        if (null === $dataGatewayFactory) {
            $dataGatewayFactory = new ilTermsOfServiceDataGatewayFactory();
            $dataGatewayFactory->setDatabaseAdapter($DIC->database());
        }
        $this->dataGatewayFactory = $dataGatewayFactory;
 
        if (null === $termsOfServiceEvaluation) {
            $termsOfServiceEvaluation = $DIC['tos.document.evaluator'];
        }
        $this->termsOfServiceEvaluation = $termsOfServiceEvaluation;
 
        if (null === $criterionTypeFactory) {
            $criterionTypeFactory = $DIC['tos.criteria.type.factory'];
        }
        $this->criterionTypeFactory = $criterionTypeFactory;
 
        if (null === $tos) {
            $tos = new ilObjTermsOfService();
        }
        $this->tos = $tos;
    }

References $criterionTypeFactory, $dataGatewayFactory, $DIC, $termsOfServiceEvaluation, $tos, and ilTermsOfServiceDataGatewayFactory\setDatabaseAdapter().

Here is the call graph for this function:

Member Function Documentation

◆ deleteAcceptanceHistoryByUser()

ilTermsOfServiceHelper::deleteAcceptanceHistoryByUser ( int $userId )

Parameters

int $userId

Exceptions

ilTermsOfServiceMissingDatabaseAdapterException

Definition at line 76 of file class.ilTermsOfServiceHelper.php.

                                                              : void
    {
        $entity = $this->getEntityFactory()->getByName('ilTermsOfServiceAcceptanceEntity');
        $databaseGateway = $this->getDataGatewayFactory()->getByName('ilTermsOfServiceAcceptanceDatabaseGateway');
 
        $databaseGateway->deleteAcceptanceHistoryByUser($entity->withUserId($userId));
    }

References getDataGatewayFactory(), and getEntityFactory().

Here is the call graph for this function:

◆ getById()

ilTermsOfServiceHelper::getById ( int $id )

Parameters

int $id

Returns: ilTermsOfServiceAcceptanceEntity

Exceptions

ilTermsOfServiceMissingDatabaseAdapterException

Definition at line 102 of file class.ilTermsOfServiceHelper.php.

                                    : ilTermsOfServiceAcceptanceEntity
    {
        $entity = $this->getEntityFactory()->getByName('ilTermsOfServiceAcceptanceEntity');
        $databaseGateway = $this->getDataGatewayFactory()->getByName('ilTermsOfServiceAcceptanceDatabaseGateway');
 
        return $databaseGateway->loadById($entity->withId($id));
    }

References $id, getDataGatewayFactory(), and getEntityFactory().

Here is the call graph for this function:

◆ getCurrentAcceptanceForUser()

ilTermsOfServiceHelper::getCurrentAcceptanceForUser ( ilObjUser $user )

Parameters

ilObjUser $user

Returns: ilTermsOfServiceAcceptanceEntity

Exceptions

ilTermsOfServiceMissingDatabaseAdapterException

Definition at line 89 of file class.ilTermsOfServiceHelper.php.

                                                                : ilTermsOfServiceAcceptanceEntity
    {
        $entity = $this->getEntityFactory()->getByName('ilTermsOfServiceAcceptanceEntity');
        $databaseGateway = $this->getDataGatewayFactory()->getByName('ilTermsOfServiceAcceptanceDatabaseGateway');
 
        return $databaseGateway->loadCurrentAcceptanceOfUser($entity->withUserId($user->getId()));
    }

References getDataGatewayFactory(), getEntityFactory(), and ilObject\getId().

Referenced by hasToResignAcceptance().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getDataGatewayFactory()

ilTermsOfServiceHelper::getDataGatewayFactory ( )

private

Definition at line 222 of file class.ilTermsOfServiceHelper.php.

                                            : ilTermsOfServiceDataGatewayFactory
    {
        return $this->dataGatewayFactory;
    }

References $dataGatewayFactory.

Referenced by deleteAcceptanceHistoryByUser(), getById(), getCurrentAcceptanceForUser(), and trackAcceptance().

Here is the caller graph for this function:

◆ getEntityFactory()

ilTermsOfServiceHelper::getEntityFactory ( )

private

Definition at line 217 of file class.ilTermsOfServiceHelper.php.

                                       : ilTermsOfServiceEntityFactory
    {
        return new ilTermsOfServiceEntityFactory();
    }

Referenced by deleteAcceptanceHistoryByUser(), getById(), getCurrentAcceptanceForUser(), and trackAcceptance().

Here is the caller graph for this function:

◆ hasToResignAcceptance()

ilTermsOfServiceHelper::hasToResignAcceptance	(	ilObjUser	$user,
		ilLogger	$logger
	)

Definition at line 163 of file class.ilTermsOfServiceHelper.php.

                                                                            : bool
    {
        $logger->debug(sprintf(
            'Checking reevaluation of Terms of Service for user "%s" (id: %s) ...',
            $user->getLogin(),
            $user->getId()
        ));
 
        if (!$this->isGloballyEnabled()) {
            $logger->debug('Terms of Service disabled, resigning not required ...');
            return false;
        }
 
        if (!$this->isIncludedUser($user)) {
            $logger->debug('User is not included for Terms of Service acceptance, resigning not required ...');
            return false;
        }
 
        if (!$this->tos->shouldReevaluateOnLogin()) {
            $logger->debug('Reevaluation of documents is not enabled, resigning not required ...');
            return false;
        }
 
        if (!$user->getAgreeDate()) {
            $logger->debug('Terms of Service currently not accepted by user, resigning not required ...');
            return false;
        }
 
        $evaluator = $this->termsOfServiceEvaluation->withContextUser($user);
        if (!$evaluator->hasDocument()) {
            $logger->debug('No signable Terms of Service document found, resigning not required ...');
            return false;
        }
 
        $entity = $this->getCurrentAcceptanceForUser($user);
        if (!($entity->getId() > 0)) {
            $logger->debug('No signed Terms of Service document found, resigning not required ...');
            return false;
        }
 
        $historizedDocument = new ilTermsOfServiceHistorizedDocument(
            $entity,
            new ilTermsOfServiceAcceptanceHistoryCriteriaBag($entity->getSerializedCriteria())
        );
 
        if ($evaluator->evaluateDocument($historizedDocument)) {
            $logger->debug('Current user values do still match historized criteria, resigning not required ...');
            return false;
        }
 
        $logger->debug('Current user values do not match historized criteria, resigning required ...');
        return true;
    }

References ilLogger\debug(), ilObjUser\getAgreeDate(), getCurrentAcceptanceForUser(), ilObject\getId(), ilObjUser\getLogin(), isGloballyEnabled(), and isIncludedUser().

Here is the call graph for this function:

◆ isEnabled()

static ilTermsOfServiceHelper::isEnabled ( )

static

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

                                      : bool
    {
        return (new self())->tos->getStatus();
    }

Referenced by ILIAS\Awareness\User\Collector\collectUsers(), ilObjUser\hasToAcceptTermsOfService(), ilAccountRegistrationGUI\initForm(), ilAccountRegistrationGUI\saveForm(), and ilPersonalProfileGUI\showUserAgreement().

Here is the caller graph for this function:

◆ isGloballyEnabled()

ilTermsOfServiceHelper::isGloballyEnabled ( )

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

                                       : bool
    {
        return $this->tos->getStatus();
    }

Referenced by hasToResignAcceptance().

Here is the caller graph for this function:

◆ isIncludedUser()

ilTermsOfServiceHelper::isIncludedUser ( ilObjUser $user )

Definition at line 145 of file class.ilTermsOfServiceHelper.php.

                                                   : bool
    {
        $excluded_roles = [];
        if (defined('ANONYMOUS_USER_ID')) {
            $excluded_roles[] = ANONYMOUS_USER_ID;
        }
        if (defined('SYSTEM_USER_ID')) {
            $excluded_roles[] = SYSTEM_USER_ID;
        }
 
        return (
            'root' !== $user->getLogin() &&
            !in_array($user->getId(), $excluded_roles, true) &&
            !$user->isAnonymous() &&
            $user->getId() > 0
        );
    }

References ANONYMOUS_USER_ID, ilObject\getId(), ilObjUser\getLogin(), ilObjUser\isAnonymous(), and SYSTEM_USER_ID.

Referenced by hasToResignAcceptance().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resetAcceptance()

ilTermsOfServiceHelper::resetAcceptance ( ilObjUser $user )

Definition at line 139 of file class.ilTermsOfServiceHelper.php.

                                                    : void
    {
        $user->setAgreeDate(null);
        $user->update();
    }

References ilObjUser\setAgreeDate(), and ilObjUser\update().

Here is the call graph for this function:

◆ trackAcceptance()

ilTermsOfServiceHelper::trackAcceptance	(	ilObjUser	$user,
		ilTermsOfServiceSignableDocument	$document
	)

Parameters

ilObjUser	$user
ilTermsOfServiceSignableDocument	$document

Exceptions

ilTermsOfServiceMissingDatabaseAdapterException
ilTermsOfServiceUnexpectedCriteriaBagContentException

Definition at line 116 of file class.ilTermsOfServiceHelper.php.

                                                                                                : void
    {
        $entity = $this->getEntityFactory()->getByName('ilTermsOfServiceAcceptanceEntity');
        $databaseGateway = $this->getDataGatewayFactory()->getByName('ilTermsOfServiceAcceptanceDatabaseGateway');
 
        $entity = $entity
            ->withUserId($user->getId())
            ->withTimestamp(time())
            ->withText($document->content())
            ->withHash(md5($document->content()))
            ->withDocumentId($document->id())
            ->withTitle($document->title());
 
        $criteriaBag = new ilTermsOfServiceAcceptanceHistoryCriteriaBag($document->criteria());
        $entity = $entity->withSerializedCriteria($criteriaBag->toJson());
 
        $databaseGateway->trackAcceptance($entity);
 
        $user->writeAccepted();
 
        $user->hasToAcceptTermsOfServiceInSession(false);
    }