VarMiddleware
extends AbstractTemplateMiddleware
in package
Middleware to replace `{{var:my_var}}` from variable consumer in all string properties of the template.
Table of Contents
Constants
- REGEXP = '/{{var:([^}=]+)(?:=([^}]*))?}}/m'
- Regular expression to get variable name and default value.
Properties
- $consumer : mixed
- $suspended : mixed
Methods
- __construct() : mixed
- C'tor.
- beforePersistTemplate() : void
- Before persisting the template instance to the storage we can modify it.
- beforeRetrievingTemplate() : void
- Before the template got read through `retrieve` or `retrieveBy`.
- beforeUsingTemplate() : void
- Before using the template (e.g. expose it to the frontend UI form) we can modify it.
- createScriptNonce() : mixed
- E.g. Facebook uses a random generated script nonce for caching purposes.
- getConsumer() : mixed
- Getter.
- getVariableResolver() : mixed
- Getter.
- isSuspended() : mixed
- Check if the middleware is suspended.
- suspend() : mixed
- Allows to suspend or resume the middleware to take effect. This is efficient if a middleware could be called recursively.
- applyAcknowledgementMode() : mixed
- Disallow the creation of a service in the scanner. Additionally, you can add a message to the consumer data which is shown to the user. The user can only acknowledge to the message and not create the service.
Constants
REGEXP
Regular expression to get variable name and default value.
public
mixed
REGEXP
= '/{{var:([^}=]+)(?:=([^}]*))?}}/m'
Tags
Properties
$consumer
private
mixed
$consumer
$suspended
private
mixed
$suspended
= false
Methods
__construct()
C'tor.
public
__construct(ServiceCloudConsumer $consumer) : mixed
Parameters
- $consumer : ServiceCloudConsumer
beforePersistTemplate()
Before persisting the template instance to the storage we can modify it.
public
beforePersistTemplate(mixed $template, mixed &$allTemplates) : void
Example: Calculate recommendedWhenOneOf.
Parameters
- $template : mixed
- $allTemplates : mixed
beforeRetrievingTemplate()
Before the template got read through `retrieve` or `retrieveBy`.
public
beforeRetrievingTemplate(AbstractTemplate $template) : void
Parameters
- $template : AbstractTemplate
beforeUsingTemplate()
Before using the template (e.g. expose it to the frontend UI form) we can modify it.
public
beforeUsingTemplate(mixed $template) : void
Example: Replace variables with values.
Parameters
- $template : mixed
createScriptNonce()
E.g. Facebook uses a random generated script nonce for caching purposes.
public
static createScriptNonce([int $nonceLength = 8 ]) : mixed
Parameters
- $nonceLength : int = 8
getConsumer()
Getter.
public
getConsumer() : mixed
Tags
getVariableResolver()
Getter.
public
getVariableResolver() : mixed
Tags
isSuspended()
Check if the middleware is suspended.
public
isSuspended() : mixed
suspend()
Allows to suspend or resume the middleware to take effect. This is efficient if a middleware could be called recursively.
public
suspend(bool $state) : mixed
Parameters
- $state : bool
applyAcknowledgementMode()
Disallow the creation of a service in the scanner. Additionally, you can add a message to the consumer data which is shown to the user. The user can only acknowledge to the message and not create the service.
protected
applyAcknowledgementMode(AbstractTemplate $template[, array<string|int, string> $paragraphs = [] ][, array<string|int, string> $accordion = null ][, string $buttonLabel = null ][, string $buttonAction = null ]) : mixed
Parameters
- $template : AbstractTemplate
- $paragraphs : array<string|int, string> = []
- $accordion : array<string|int, string> = null
-
A list of accordions with key as headline and value as message.
- $buttonLabel : string = null
-
The label of the button.
- $buttonAction : string = null
-
The action of the button, can be "ignore", "create" or "close".