class EntityUrlFilter in Typed Data API enhancements 8

A data filter that provides the URL of an entity.

Plugin annotation

@DataFilter(
  id = "entity_url",
  label = @Translation("Provides the URL of an entity."),
)

Hierarchy

• class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
  • class \Drupal\typed_data\DataFilterBase implements DataFilterInterface uses StringTranslationTrait, TypedDataTrait
    • class \Drupal\typed_data\Plugin\TypedDataFilter\EntityUrlFilter

File

src/Plugin/TypedDataFilter/EntityUrlFilter.php, line 21

Namespace

Drupal\typed_data\Plugin\TypedDataFilter

class EntityUrlFilter extends DataFilterBase {

  /**
   * {@inheritdoc}
   */
  public function filter(DataDefinitionInterface $definition, $value, array $arguments, BubbleableMetadata $bubbleable_metadata = NULL) {
    assert($value instanceof EntityInterface);

    // EntityInterface::toUrl() does not work properly for File entities; this
    // is evidently "by design" and will not be fixed in core. Thus in order
    // for this filter to work with File entities we must treat them
    // differently, using the FileInterface::createFileUrl() method instead.
    // @see https://www.drupal.org/project/drupal/issues/2402533
    if ($value instanceof FileInterface) {

      // The FALSE argument creates an absolute URL.
      return $value
        ->createFileUrl(FALSE);
    }
    else {
      return $value
        ->toUrl('canonical', [
        'absolute' => TRUE,
      ])
        ->toString();
    }
  }

  /**
   * {@inheritdoc}
   */
  public function canFilter(DataDefinitionInterface $definition) {
    return $definition instanceof EntityDataDefinitionInterface;
  }

  /**
   * {@inheritdoc}
   */
  public function filtersTo(DataDefinitionInterface $definition, array $arguments) {
    return DataDefinition::create('uri');
  }

}

Members

Name	Modifiers	Type	Description	Overrides
DataFilterBase::$filterId	protected	property	The filter id.
DataFilterBase::$pluginDefinition	protected	property	The plugin definition. Overrides PluginBase::$pluginDefinition
DataFilterBase::allowsNullValues	public	function	Defines whether the filter is able to process NULL values. Overrides DataFilterInterface::allowsNullValues	1
DataFilterBase::getNumberOfRequiredArguments	public	function	Gets the number of required arguments. Overrides DataFilterInterface::getNumberOfRequiredArguments	2
DataFilterBase::suggestArgument	public	function	Suggests some possible argument values based on user input. Overrides DataFilterInterface::suggestArgument
DataFilterBase::validateArguments	public	function	Validates the inputted arguments. Overrides DataFilterInterface::validateArguments	3
DataFilterBase::__construct	public	function	Constructs a \Drupal\Component\Plugin\PluginBase object. Overrides PluginBase::__construct	1
EntityUrlFilter::canFilter	public	function	Determines whether data based upon the given definition can be filtered. Overrides DataFilterInterface::canFilter
EntityUrlFilter::filter	public	function	Filters the given data value. Overrides DataFilterInterface::filter
EntityUrlFilter::filtersTo	public	function	Describes the data after applying the filter. Overrides DataFilterInterface::filtersTo
PluginBase::$configuration	protected	property	Configuration information passed into the plugin.	1
PluginBase::$pluginId	protected	property	The plugin_id.
PluginBase::DERIVATIVE_SEPARATOR		constant	A string which is used to separate base plugin IDs from the derivative ID.
PluginBase::getBaseId	public	function	Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface::getBaseId
PluginBase::getDerivativeId	public	function	Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface::getDerivativeId
PluginBase::getPluginDefinition	public	function	Gets the definition of the plugin implementation. Overrides PluginInspectionInterface::getPluginDefinition	3
PluginBase::getPluginId	public	function	Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface::getPluginId
PluginBase::isConfigurable	public	function	Determines if the plugin is configurable.
StringTranslationTrait::$stringTranslation	protected	property	The string translation service.	1
StringTranslationTrait::formatPlural	protected	function	Formats a string containing a count of items.
StringTranslationTrait::getNumberOfPlurals	protected	function	Returns the number of plurals supported by a given language.
StringTranslationTrait::getStringTranslation	protected	function	Gets the string translation service.
StringTranslationTrait::setStringTranslation	public	function	Sets the string translation service to use.	2
StringTranslationTrait::t	protected	function	Translates a string to the current language or to a given language.
TypedDataTrait::$typedDataManager	protected	property	The typed data manager used for creating the data types.
TypedDataTrait::getTypedDataManager	public	function	Gets the typed data manager.	2
TypedDataTrait::setTypedDataManager	public	function	Sets the typed data manager.	2