Bristol SU Support Package
Public Member Functions | Private Attributes | List of all members
BristolSU\Support\Completion\Contracts\CompletionCondition Class Reference
Inheritance diagram for BristolSU\Support\Completion\Contracts\CompletionCondition:
Inheritance graph
[legend]
Collaboration diagram for BristolSU\Support\Completion\Contracts\CompletionCondition:
Collaboration graph
[legend]

Public Member Functions

 __construct (string $moduleAlias)
 
 moduleAlias ()
 
 percentage ($settings, ActivityInstance $activityInstance, ModuleInstance $moduleInstance)
 
 isComplete ($settings, ActivityInstance $activityInstance, ModuleInstance $moduleInstance)
 
 options ()
 
 name ()
 
 description ()
 
 alias ()
 
 toJson ($options=0)
 
 toArray ()
 

Private Attributes

 $moduleAlias
 

Detailed Description

Completion Condition class

Definition at line 15 of file CompletionCondition.php.

Constructor & Destructor Documentation

◆ __construct()

BristolSU\Support\Completion\Contracts\CompletionCondition::__construct ( string  $moduleAlias)

Initialise the condition

Parameters
string$moduleAliasThe module alias of the condition. This is passed in so that a condition can be made exclusive to a module, or can be a global condition which changes its behaviour depending on the module.

Definition at line 30 of file CompletionCondition.php.

References BristolSU\Support\Completion\Contracts\CompletionCondition\$moduleAlias, and BristolSU\Support\Completion\Contracts\CompletionCondition\moduleAlias().

Member Function Documentation

◆ alias()

BristolSU\Support\Completion\Contracts\CompletionCondition::alias ( )
abstract

◆ description()

BristolSU\Support\Completion\Contracts\CompletionCondition::description ( )
abstract

◆ isComplete()

BristolSU\Support\Completion\Contracts\CompletionCondition::isComplete (   $settings,
ActivityInstance  $activityInstance,
ModuleInstance  $moduleInstance 
)
abstract

Is the condition fully complete?

Parameters
array$settingsSettings of the completion condition
ActivityInstance$activityInstanceActivity instance to test
ModuleInstance$moduleInstanceModule instance to test
Returns
bool If the condition is complete

Referenced by BristolSU\Support\Completion\Contracts\CompletionCondition\percentage().

◆ moduleAlias()

BristolSU\Support\Completion\Contracts\CompletionCondition::moduleAlias ( )

◆ name()

BristolSU\Support\Completion\Contracts\CompletionCondition::name ( )
abstract

◆ options()

BristolSU\Support\Completion\Contracts\CompletionCondition::options ( )
abstract

Options required by the completion condition.

This allows for you to get user input to modify the behaviour of this class. For example, you could give an option of a 'number of files' to be approved before the condition is complete.

Any settings requested in here will be passed into the percentage or isComplete methods.

Returns
Form

Referenced by BristolSU\Support\Completion\Contracts\CompletionCondition\percentage(), and BristolSU\Support\Completion\Contracts\CompletionCondition\toArray().

◆ percentage()

BristolSU\Support\Completion\Contracts\CompletionCondition::percentage (   $settings,
ActivityInstance  $activityInstance,
ModuleInstance  $moduleInstance 
)

Return the percentage completion of the module

By default, this function returns 0 if the condition is not complete, or 100 if the condition is complete. You may override this method to provide more granular percentage settings

Parameters
array$settingsSettings of the completion condition
ActivityInstance$activityInstanceThe activity instance being tested
ModuleInstance$moduleInstanceThe module instance being tested
Returns
int Percentage complete.

Definition at line 56 of file CompletionCondition.php.

References BristolSU\Support\Completion\Contracts\CompletionCondition\alias(), BristolSU\Support\Completion\Contracts\CompletionCondition\description(), BristolSU\Support\Completion\Contracts\CompletionCondition\isComplete(), BristolSU\Support\Completion\Contracts\CompletionCondition\name(), and BristolSU\Support\Completion\Contracts\CompletionCondition\options().

◆ toArray()

BristolSU\Support\Completion\Contracts\CompletionCondition::toArray ( )

◆ toJson()

BristolSU\Support\Completion\Contracts\CompletionCondition::toJson (   $options = 0)

Member Data Documentation

◆ $moduleAlias

BristolSU\Support\Completion\Contracts\CompletionCondition::$moduleAlias
private

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