TranslationsMiddleware
extends AbstractTemplateMiddleware
in package
Template middleware that automatically creates a list of available translations to consumer data.
Table of Contents
Properties
- $prefetchedTranslations : array<string|int, array<string|int, array<string|int, mixed>>>
- Prefetched translations by identifier.
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.
- beforeUsingTemplates() : void
- Before using templates (e.g. expose them to the frontend UI form) we can modify them in batch.
- fetchTranslations() : array<string|int, array<string|int, array<string|int, mixed>>>
- Fetch available translations for templates with the following array scheme:
- 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.
Properties
$prefetchedTranslations
Prefetched translations by identifier.
private
array<string|int, array<string|int, array<string|int, mixed>>>
$prefetchedTranslations
= []
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
beforeUsingTemplates()
Before using templates (e.g. expose them to the frontend UI form) we can modify them in batch.
public
beforeUsingTemplates(mixed &$templates) : void
Parameters
- $templates : mixed
fetchTranslations()
Fetch available translations for templates with the following array scheme:
public
abstract fetchTranslations(array<string|int, AbstractTemplate> $templates) : array<string|int, array<string|int, array<string|int, mixed>>>
[
'identifier' => [
['isUntranslated' => false, 'machineTranslationStatus' => 'no-translation' | 'full' | 'partly', 'language' => 'de_DE', 'name' => 'German', 'flag' => false],
...
],
...
]
name can be optional.
Parameters
- $templates : array<string|int, AbstractTemplate>
Return values
array<string|int, array<string|int, array<string|int, mixed>>> —Map of identifier => translations
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".