class UserLoginBlock extends BlockBase implements ContainerFactoryPluginInterface, TrustedCallbackInterface (View source)

Provides a 'User login' block.

Traits

Wrapper methods for the Redirect Destination.

Provides the base implementation of a block plugin.

Provides a trait to add context-aware functionality to plugins.

Handles context assignments for context-aware plugins.

Wrapper methods for \Drupal\Core\StringTranslation\TranslationInterface.

Provides a trait for the messenger service.

Provides a trait with typical behavior for plugins which have forms.

Wrapper methods for \Drupal\Core\StringTranslation\TranslationInterface.

Provides dependency injection friendly methods for serialization.

Provides a trait for the messenger service.

Constants

DERIVATIVE_SEPARATOR

A string which is used to separate base plugin IDs from the derivative ID.

Properties

protected string $pluginId

The plugin_id.

from  PluginBase
protected array $pluginDefinition

The plugin implementation definition.

from  PluginBase
protected array $configuration

Configuration information passed into the plugin.

from  PluginBase
protected TranslationInterface $stringTranslation

The string translation service.

from  StringTranslationTrait
protected array $_serviceIds

An array of service IDs keyed by property name used for serialization.

from  DependencySerializationTrait
protected array $_entityStorages

An array of entity type IDs keyed by the property name of their storages.

from  DependencySerializationTrait
protected MessengerInterface $messenger

The messenger.

from  MessengerTrait
protected TransliterationInterface $transliteration

The transliteration service.

from  BlockPluginTrait
protected ContextInterface[] $context

The data objects representing the context of this plugin.

from  ContextAwarePluginTrait
protected bool internal $initializedContextConfig

Tracks whether the context has been initialized from configuration.

from  ContextAwarePluginTrait
protected RedirectDestinationInterface $redirectDestination

The redirect destination service.

from  RedirectDestinationTrait
protected RouteMatchInterface $routeMatch

The route match.

Methods

__construct(array $configuration, $plugin_id, $plugin_definition, RouteMatchInterface $route_match)

Constructs a new UserLoginBlock instance.

string
getPluginId()

Gets the plugin_id of the plugin instance.

string
getBaseId()

Gets the base_plugin_id of the plugin instance.

string|null
getDerivativeId()

Gets the derivative_id of the plugin instance.

bool
isConfigurable()

Determines if the plugin is configurable.

t(string $string, array $args = [], array $options = [])

Translates a string to the current language or to a given language.

formatPlural($count, $singular, $plural, array $args = [], array $options = [])

Formats a string containing a count of items.

getNumberOfPlurals($langcode = NULL)

Returns the number of plurals supported by a given language.

getStringTranslation()

Gets the string translation service.

$this
setStringTranslation(TranslationInterface $translation)

Sets the string translation service to use.

__sleep()

{@inheritdoc}

__wakeup()

{@inheritdoc}

setMessenger(MessengerInterface $messenger)

Sets the messenger.

messenger()

Gets the messenger.

getFormClass($operation)

Implements \Drupal\Core\Plugin\PluginWithFormsInterface::getFormClass().

hasFormClass($operation)

Implements \Drupal\Core\Plugin\PluginWithFormsInterface::hasFormClass().

label()

{@inheritdoc}

getConfiguration()

{@inheritdoc}

setConfiguration(array $configuration)

{@inheritdoc}

array
baseConfigurationDefaults()

Returns generic default configuration for block plugins.

defaultConfiguration()

{@inheritdoc}

setConfigurationValue($key, $value)

{@inheritdoc}

access(AccountInterface $account, $return_as_object = FALSE)

{@inheritdoc}

blockAccess(AccountInterface $account)

Indicates whether the block should be shown.

buildConfigurationForm(array $form, FormStateInterface $form_state)

{@inheritdoc}

blockForm($form, FormStateInterface $form_state)

{@inheritdoc}

validateConfigurationForm(array $form, FormStateInterface $form_state)

{@inheritdoc}

blockValidate($form, FormStateInterface $form_state)

{@inheritdoc}

submitConfigurationForm(array $form, FormStateInterface $form_state)

{@inheritdoc}

blockSubmit($form, FormStateInterface $form_state)

{@inheritdoc}

transliteration()

Wraps the transliteration service.

setTransliteration(TransliterationInterface $transliteration)

Sets the transliteration service.

getContexts()

{@inheritdoc}

setContext($name, ContextInterface $context)

{@inheritdoc}

getContextValue($name)

{@inheritdoc}

setContextValue($name, $value)

{@inheritdoc}

setContextMapping(array $context_mapping)

{@inheritdoc}

getCacheTags()

{@inheritdoc}

array
addContextAssignmentElement(ContextAwarePluginInterface $plugin, array $contexts)

Builds a form element for assigning a context to a given slot.

array
getDestinationArray()

Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url.

getRedirectDestination()

Returns the redirect destination service.

$this
setRedirectDestination(RedirectDestinationInterface $redirect_destination)

Sets the redirect destination service.

create(ContainerInterface $container, array $configuration, string $plugin_id, mixed $plugin_definition)

Creates an instance of the plugin.

array
build()

Builds and returns the renderable array for this block plugin.

static array
renderPlaceholderFormAction()

lazy_builder callback; renders a form action URL including destination.

static string[]
trustedCallbacks()

Lists the trusted callbacks provided by the implementing class.

Details

__construct(array $configuration, $plugin_id, $plugin_definition, RouteMatchInterface $route_match)

Constructs a new UserLoginBlock instance.

Parameters

array $configuration
$plugin_id
$plugin_definition
RouteMatchInterface $route_match

The route match.

string getPluginId()

Gets the plugin_id of the plugin instance.

Return Value

string

The plugin_id of the plugin instance.

string getBaseId()

Gets the base_plugin_id of the plugin instance.

Return Value

string

The base_plugin_id of the plugin instance.

string|null getDerivativeId()

Gets the derivative_id of the plugin instance.

Return Value

string|null

The derivative_id of the plugin instance NULL otherwise.

abstract protected getPluginDefinition()

{@inheritdoc}

bool isConfigurable()

Determines if the plugin is configurable.

Return Value

bool

A boolean indicating whether the plugin is configurable.

protected TranslatableMarkup t(string $string, array $args = [], array $options = [])

Translates a string to the current language or to a given language.

See \Drupal\Core\StringTranslation\TranslatableMarkup::__construct() for important security information and usage guidelines.

In order for strings to be localized, make them available in one of the ways supported by the

Parameters

string $string

A string containing the English text to translate.

array $args

(optional) An associative array of replacements to make after translation. Based on the first character of the key, the value is escaped and/or themed. See \Drupal\Component\Render\FormattableMarkup::placeholderFormat() for details.

array $options

(optional) An associative array of additional options, with the following elements:

  • 'langcode' (defaults to the current language): A language code, to translate to a language other than what is used to display the page.
  • 'context' (defaults to the empty context): The context the source string belongs to. See the @link i18n Internationalization topic @endlink for more information about string contexts.

Return Value

TranslatableMarkup

An object that, when cast to a string, returns the translated string.

See also

FormattableMarkup::placeholderFormat
TranslatableMarkup::__construct

protected formatPlural($count, $singular, $plural, array $args = [], array $options = [])

Formats a string containing a count of items.

Parameters

$count
$singular
$plural
array $args
array $options

See also

TranslationInterface::formatPlural

protected getNumberOfPlurals($langcode = NULL)

Returns the number of plurals supported by a given language.

Parameters

$langcode

See also

PluralFormulaInterface::getNumberOfPlurals

protected TranslationInterface getStringTranslation()

Gets the string translation service.

Return Value

TranslationInterface

The string translation service.

$this setStringTranslation(TranslationInterface $translation)

Sets the string translation service to use.

Parameters

TranslationInterface $translation

The string translation service.

Return Value

$this

__sleep()

{@inheritdoc}

__wakeup()

{@inheritdoc}

setMessenger(MessengerInterface $messenger)

Sets the messenger.

Parameters

MessengerInterface $messenger

The messenger.

MessengerInterface messenger()

Gets the messenger.

Return Value

MessengerInterface

The messenger.

getFormClass($operation)

Implements \Drupal\Core\Plugin\PluginWithFormsInterface::getFormClass().

Parameters

$operation

hasFormClass($operation)

Implements \Drupal\Core\Plugin\PluginWithFormsInterface::hasFormClass().

Parameters

$operation

label()

{@inheritdoc}

getConfiguration()

{@inheritdoc}

setConfiguration(array $configuration)

{@inheritdoc}

Parameters

array $configuration

protected array baseConfigurationDefaults()

Returns generic default configuration for block plugins.

Return Value

array

An associative array with the default configuration.

defaultConfiguration()

{@inheritdoc}

setConfigurationValue($key, $value)

{@inheritdoc}

Parameters

$key
$value

calculateDependencies()

{@inheritdoc}

access(AccountInterface $account, $return_as_object = FALSE)

{@inheritdoc}

Parameters

AccountInterface $account
$return_as_object

protected AccessResult blockAccess(AccountInterface $account)

Indicates whether the block should be shown.

Blocks with specific access checking should override this method rather than access(), in order to avoid repeating the handling of the $return_as_object argument.

Parameters

AccountInterface $account

The user session for which to check access.

Return Value

AccessResult

The access result.

buildConfigurationForm(array $form, FormStateInterface $form_state)

{@inheritdoc}

Creates a generic configuration form for all block types. Individual block plugins can add elements to this form by overriding BlockBase::blockForm(). Most block plugins should not override this method unless they need to alter the generic form elements.

Parameters

array $form
FormStateInterface $form_state

See also

\Drupal\Core\Block\BlockBase::blockForm()

blockForm($form, FormStateInterface $form_state)

{@inheritdoc}

Parameters

$form
FormStateInterface $form_state

validateConfigurationForm(array $form, FormStateInterface $form_state)

{@inheritdoc}

Most block plugins should not override this method. To add validation for a specific block type, override BlockBase::blockValidate().

Parameters

array $form
FormStateInterface $form_state

See also

\Drupal\Core\Block\BlockBase::blockValidate()

blockValidate($form, FormStateInterface $form_state)

{@inheritdoc}

Parameters

$form
FormStateInterface $form_state

submitConfigurationForm(array $form, FormStateInterface $form_state)

{@inheritdoc}

Most block plugins should not override this method. To add submission handling for a specific block type, override BlockBase::blockSubmit().

Parameters

array $form
FormStateInterface $form_state

See also

\Drupal\Core\Block\BlockBase::blockSubmit()

blockSubmit($form, FormStateInterface $form_state)

{@inheritdoc}

Parameters

$form
FormStateInterface $form_state

getMachineNameSuggestion()

{@inheritdoc}

getPreviewFallbackString()

{@inheritdoc}

protected TransliterationInterface transliteration()

Wraps the transliteration service.

setTransliteration(TransliterationInterface $transliteration)

Sets the transliteration service.

Parameters

TransliterationInterface $transliteration

The transliteration service.

getContexts()

{@inheritdoc}

ContextInterface getContext($name)

{@inheritdoc}

Parameters

$name

Return Value

ContextInterface

The context object.

setContext($name, ContextInterface $context)

{@inheritdoc}

Parameters

$name
ContextInterface $context

getContextValues()

{@inheritdoc}

getContextValue($name)

{@inheritdoc}

Parameters

$name

setContextValue($name, $value)

{@inheritdoc}

Parameters

$name
$value

getContextMapping()

{@inheritdoc}

setContextMapping(array $context_mapping)

{@inheritdoc}

Parameters

array $context_mapping

ContextDefinitionInterface[] getContextDefinitions()

{@inheritdoc}

ContextDefinitionInterface getContextDefinition($name)

{@inheritdoc}

Parameters

$name

Return Value

ContextDefinitionInterface

validateContexts()

{@inheritdoc}

getCacheContexts()

{@inheritdoc}

getCacheTags()

{@inheritdoc}

getCacheMaxAge()

{@inheritdoc}

protected ContextHandlerInterface contextHandler()

Wraps the context handler.

protected array addContextAssignmentElement(ContextAwarePluginInterface $plugin, array $contexts)

Builds a form element for assigning a context to a given slot.

Parameters

ContextAwarePluginInterface $plugin

The context-aware plugin.

array $contexts

An array of contexts.

Return Value

array

A form element for assigning context.

protected array getDestinationArray()

Prepares a 'destination' URL query parameter for use with \Drupal\Core\Url.

Return Value

array

An associative array containing the key:

  • destination: The value of the current request's 'destination' query parameter, if present. This can be either a relative or absolute URL. However, for security, redirection to external URLs is not performed. If the query parameter isn't present, then the URL of the current request is returned.

See also

RedirectDestinationInterface::getAsArray

protected RedirectDestinationInterface getRedirectDestination()

Returns the redirect destination service.

Return Value

RedirectDestinationInterface

The redirect destination helper.

$this setRedirectDestination(RedirectDestinationInterface $redirect_destination)

Sets the redirect destination service.

Parameters

RedirectDestinationInterface $redirect_destination

The redirect destination service.

Return Value

$this

static ContainerFactoryPluginInterface create(ContainerInterface $container, array $configuration, string $plugin_id, mixed $plugin_definition)

Creates an instance of the plugin.

Parameters

ContainerInterface $container

The container to pull out services used in the plugin.

array $configuration

A configuration array containing information about the plugin instance.

string $plugin_id

The plugin ID for the plugin instance.

mixed $plugin_definition

The plugin implementation definition.

Return Value

ContainerFactoryPluginInterface

Returns an instance of this plugin.

array build()

Builds and returns the renderable array for this block plugin.

If a block should not be rendered because it has no content, then this method must also ensure to return no content: it must then only return an empty array, or an empty array with #cache set (with cacheability metadata indicating the circumstances for it being empty).

Return Value

array

A renderable array representing the content of the block.

static array renderPlaceholderFormAction()

lazy_builder callback; renders a form action URL including destination.

Return Value

array

A renderable array representing the form action.

See also

FormBuilder::renderPlaceholderFormAction

static string[] trustedCallbacks()

Lists the trusted callbacks provided by the implementing class.

Trusted callbacks are public methods on the implementing class and can be invoked via \Drupal\Core\Security\DoTrustedCallbackTrait::doTrustedCallback().

Return Value

string[]

List of method names implemented by the class that can be used as trusted callbacks.