Code Coverage for /Users/ericduran/Sites/drupal/drupal/core/modules/file/src/FileAccessFormatterControlHandlerInterface.php

1	<?php
2
3	/**
4	* @file
5	* Contains \Drupal\file\FileAccessFormatterControlHandlerInterface.
6	*/
7
8	namespace Drupal\file;
9
10	use Drupal\Core\Entity\EntityAccessControlHandlerInterface;
11
12	/**
13	* Defines an interface for file access handlers that need to run on file formatters.
14	*
15	* \Drupal\Core\Field\Plugin\Field\FieldFormatter\EntityReferenceFormatterBase,
16	* which file and image formatters extend, checks 'view' access on the
17	* referenced files before displaying them. That check would be useless and
18	* costly with Core's default access control implementation for files
19	* (\Drupal\file\FileAccessControlHandler grants access based on whether
20	* there are existing entities with granted access that reference the file). But
21	* it might be needed if a different access control handler with different logic
22	* is swapped in.
23	*
24	* \Drupal\file\Plugin\Field\FieldFormatter\FileFormatterBase thus adjusts that
25	* behavior, and only checks access if the access control handler in use for
26	* files opts in by implementing this interface.
27	*
28	* @see \Drupal\file\Plugin\Field\FieldFormatter\FileFormatterBase::needsAccessCheck()
29	*/
30	interface FileAccessFormatterControlHandlerInterface extends EntityAccessControlHandlerInterface { }