interface MediaLibraryOpenerInterface

Same name in other branches
  1. 9 core/modules/media_library/src/MediaLibraryOpenerInterface.php \Drupal\media_library\MediaLibraryOpenerInterface
  2. 8.9.x core/modules/media_library/src/MediaLibraryOpenerInterface.php \Drupal\media_library\MediaLibraryOpenerInterface
  3. 11.x core/modules/media_library/src/MediaLibraryOpenerInterface.php \Drupal\media_library\MediaLibraryOpenerInterface

Defines an interface for media library openers.

Media library opener services allow modules to check access to the media library selection dialog and respond to selections. Example use cases that require different handling:

  • when used in an entity reference field widget;
  • when used in a text editor.

Openers that require additional parameters or metadata should retrieve them from the MediaLibraryState object.

Hierarchy

Expanded class hierarchy of MediaLibraryOpenerInterface

All classes that implement MediaLibraryOpenerInterface

See also

\Drupal\media_library\MediaLibraryState

\Drupal\media_library\MediaLibraryState::getOpenerParameters()

File

core/modules/media_library/src/MediaLibraryOpenerInterface.php, line 22

Namespace

Drupal\media_library
View source
interface MediaLibraryOpenerInterface {
    
    /**
     * Checks media library access.
     *
     * @param \Drupal\media_library\MediaLibraryState $state
     *   The media library.
     * @param \Drupal\Core\Session\AccountInterface $account
     *   The user for which to check access.
     *
     * @return \Drupal\Core\Access\AccessResultInterface
     *   The access result.
     *
     * @see https://www.drupal.org/project/drupal/issues/3038254
     */
    public function checkAccess(MediaLibraryState $state, AccountInterface $account);
    
    /**
     * Generates a response after selecting media items in the media library.
     *
     * @param \Drupal\media_library\MediaLibraryState $state
     *   The state the media library was in at the time of selection, allowing the
     *   response to be customized based on that state.
     * @param int[] $selected_ids
     *   The IDs of the selected media items.
     *
     * @return \Drupal\Core\Ajax\AjaxResponse
     *   The response to update the page after selecting media.
     */
    public function getSelectionResponse(MediaLibraryState $state, array $selected_ids);

}

Members

Title Sort descending Modifiers Object type Summary Overrides
MediaLibraryOpenerInterface::checkAccess public function Checks media library access. 2
MediaLibraryOpenerInterface::getSelectionResponse public function Generates a response after selecting media items in the media library. 2

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.