Interface ilTermsOfServiceSequentialDocumentEvaluation. More...

Inheritance diagram for ilTermsOfServiceSequentialDocumentEvaluation:

Collaboration diagram for ilTermsOfServiceSequentialDocumentEvaluation:

Public Member Functions
	__construct (ilTermsOfServiceDocumentCriteriaEvaluation $evaluation, ilObjUser $user, ilLogger $log, array $possibleDocuments)

	withContextUser (ilObjUser $user)
	Returns an evaluator like this with the passed context user. More...

	evaluateDocument (ilTermsOfServiceSignableDocument $document)
	Evaluates the passed document for the context given in the concrete implementation. More...

	document ()
	Determines a document based on the context of the concrete implementation. More...

	hasDocument ()

Protected Member Functions
	getMatchingDocuments ()

Protected Attributes
ilTermsOfServiceDocumentCriteriaEvaluation	$evaluation

ilObjUser	$user

array	$matchingDocumentsByUser = []

array	$possibleDocuments = []

ilLogger	$log

Detailed Description

Interface ilTermsOfServiceSequentialDocumentEvaluation.

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

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

Constructor & Destructor Documentation

◆ __construct()

ilTermsOfServiceSequentialDocumentEvaluation::__construct	(	ilTermsOfServiceDocumentCriteriaEvaluation	$evaluation,
		ilObjUser	$user,
		ilLogger	$log,
		array	$possibleDocuments
	)

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

References $evaluation, $log, $possibleDocuments, $user, and ILIAS\Repository\user().

       {
         $this->evaluation = $evaluation;
         $this->user = $user;
         $this->log = $log;
         $this->possibleDocuments = $possibleDocuments;
     }

Here is the call graph for this function:

Member Function Documentation

◆ document()

ilTermsOfServiceSequentialDocumentEvaluation::document ( )

Determines a document based on the context of the concrete implementation.

Returns: ilTermsOfServiceSignableDocument

Exceptions

ilTermsOfServiceNoSignableDocumentFoundException

Implements ilTermsOfServiceDocumentEvaluation.

Definition at line 90 of file class.ilTermsOfServiceSequentialDocumentEvaluation.php.

References getMatchingDocuments(), and ILIAS\Repository\user().

                               : ilTermsOfServiceSignableDocument
     {
         $matchingDocuments = $this->getMatchingDocuments();
         if (count($matchingDocuments) > 0) {
             return $matchingDocuments[0];
         }
 
         throw new ilTermsOfServiceNoSignableDocumentFoundException(sprintf(
             'Could not find any terms of service document for the passed user (id: %s|login: %s)',
             $this->user->getId(),
             $this->user->getLogin()
         ));
     }

Here is the call graph for this function:

◆ evaluateDocument()

ilTermsOfServiceSequentialDocumentEvaluation::evaluateDocument ( ilTermsOfServiceSignableDocument $document )

Evaluates the passed document for the context given in the concrete implementation.

Parameters

ilTermsOfServiceSignableDocument $document

Returns: bool

Implements ilTermsOfServiceDocumentEvaluation.

Definition at line 85 of file class.ilTermsOfServiceSequentialDocumentEvaluation.php.

Referenced by getMatchingDocuments().

                                                                                 : bool
     {
         return $this->evaluation->evaluate($document);
     }

Here is the caller graph for this function:

◆ getMatchingDocuments()

ilTermsOfServiceSequentialDocumentEvaluation::getMatchingDocuments ( )

protected

Returns: ilTermsOfServiceSignableDocument[]

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

References $matchingDocumentsByUser, evaluateDocument(), and ILIAS\Repository\user().

Referenced by document(), and hasDocument().

                                              : array
     {
         if (!array_key_exists($this->user->getId(), $this->matchingDocumentsByUser)) {
             $this->matchingDocumentsByUser[$this->user->getId()] = [];
 
             $this->log->debug(sprintf(
                 'Evaluating document for user "%s" (id: %s) ...',
                 $this->user->getLogin(),
                 $this->user->getId()
             ));
 
             foreach ($this->possibleDocuments as $document) {
                 if ($this->evaluateDocument($document)) {
                     $this->matchingDocumentsByUser[$this->user->getId()][] = $document;
                 }
             }
 
             $this->log->debug(sprintf(
                 '%s matching document(s) found',
                 count($this->matchingDocumentsByUser[$this->user->getId()])
             ));
         }
 
         return $this->matchingDocumentsByUser[$this->user->getId()];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hasDocument()

ilTermsOfServiceSequentialDocumentEvaluation::hasDocument ( )

Implements ilTermsOfServiceDocumentEvaluation.

Definition at line 104 of file class.ilTermsOfServiceSequentialDocumentEvaluation.php.

References getMatchingDocuments().

                                  : bool
     {
         return count($this->getMatchingDocuments()) > 0;
     }

Here is the call graph for this function:

◆ withContextUser()

ilTermsOfServiceSequentialDocumentEvaluation::withContextUser ( ilObjUser $user )

Returns an evaluator like this with the passed context user.

Parameters

ilObjUser $user

Returns: ilTermsOfServiceDocumentEvaluation

Implements ilTermsOfServiceDocumentEvaluation.

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

References $user.

                                                     : ilTermsOfServiceDocumentEvaluation
     {
         $clone = clone $this;
         $clone->user = $user;
         $clone->evaluation = $clone->evaluation->withContextUser($user);
 
         return $clone;
     }