Documentation

Reminder
in package
implements ActionInterface Uses BackwardCompatibility

Handle sending out reminders, and checking the secret answer and question.

Table of Contents

Interfaces

ActionInterface
Interface for all action classes.

Properties

$member  : object
$subaction  : string
$subactions  : array<string|int, mixed>
$obj  : object
$backcompat  : array<string|int, mixed>

Methods

call()  : void
Convenience method to load() and execute() an instance of this class.
execute()  : void
Dispatcher to whichever sub-action method is necessary.
exportStatic()  : void
Provides a way to export a class's public static properties and methods to global namespace.
load()  : object
Static wrapper for constructor.
main()  : mixed
Just shows the main template to ask for a more specific sub-action.
pickType()  : mixed
Allows the user to pick how they wish to be reminded.
secretAnswer2()  : mixed
Validates the secret answer input by the user.
secretAnswerInput()  : mixed
Allows the user to enter their secret answer.
setPassword()  : mixed
Allows the user to set their new password.
setPassword2()  : mixed
Actually sets the new password.
__construct()  : mixed
Constructor. Protected to force instantiation via self::load().
loadMember()  : mixed
Loads the requested member.

Properties

$member

public object $member

SMF\User object for the member.

$subaction

public string $subaction = 'main'

The requested sub-action. This should be set by the constructor.

$subactions

public static array<string|int, mixed> $subactions = ['main' => 'main', 'picktype' => 'pickType', 'secret2' => 'secretAnswer2', 'setpassword' => 'setPassword', 'setpassword2' => 'setPassword2']

Available sub-actions.

$obj

protected static object $obj

An instance of this class. This is used by the load() method to prevent mulitple instantiations.

$backcompat

private static array<string|int, mixed> $backcompat = ['func_names' => ['call' => 'RemindMe']]

BackwardCompatibility settings for this class.

Methods

call()

Convenience method to load() and execute() an instance of this class.

public static call() : void

execute()

Dispatcher to whichever sub-action method is necessary.

public execute() : void

exportStatic()

Provides a way to export a class's public static properties and methods to global namespace.

public static exportStatic() : void

To do so:

  1. Use this trait in the class.
  2. At the END of the class's file, call its exportStatic() method.

Although it might not seem that way at first glance, this approach conforms to section 2.3 of PSR 1, since executing this method is simply a dynamic means of declaring functions when the file is included; it has no other side effects.

Regarding the $backcompat items:

A class's static properties are not exported to global variables unless explicitly included in $backcompat['prop_names']. Likewise, a class's static methods are not exported as global functions unless explicitly included in $backcompat['func_names'].

$backcompat['prop_names'] is a simple array where the keys are the names of one or more of a class's static properties, and the values are the names of global variables. In each case, the global variable will be set to a reference to the static property. Static properties that are not named in this array will not be exported.

$backcompat['func_names'] is a simple array where the keys are the names of one or more of a class's static methods, and the values are the names that should be used for global functions that will encapsulate those methods. Methods that are not named in this array will not be exported.

Adding non-static properties or methods to the $backcompat arrays will produce runtime errors. It is the responsibility of the developer to make sure not to do this.

load()

Static wrapper for constructor.

public static load() : object
Return values
object

An instance of this class.

main()

Just shows the main template to ask for a more specific sub-action.

public main() : mixed

pickType()

Allows the user to pick how they wish to be reminded.

public pickType() : mixed

secretAnswer2()

Validates the secret answer input by the user.

public secretAnswer2() : mixed

secretAnswerInput()

Allows the user to enter their secret answer.

public secretAnswerInput() : mixed

setPassword()

Allows the user to set their new password.

public setPassword() : mixed

setPassword2()

Actually sets the new password.

public setPassword2() : mixed

__construct()

Constructor. Protected to force instantiation via self::load().

protected __construct() : mixed

loadMember()

Loads the requested member.

protected loadMember() : mixed

        
On this page

Search results