interface ProviderPluginInterface in Video Embed Field 8

Providers an interface for embed providers.

Hierarchy

• interface \Drupal\Component\Plugin\PluginInspectionInterface
  • interface \Drupal\video_embed_field\ProviderPluginInterface

2 files declare their use of ProviderPluginInterface

MockProvider.php in tests/modules/video_embed_field_mock_provider/src/Plugin/video_embed_field/Provider/MockProvider.php

VideoEmbedDialog.php in modules/video_embed_wysiwyg/src/Form/VideoEmbedDialog.php

File

src/ProviderPluginInterface.php, line 9

Namespace

Drupal\video_embed_field

interface ProviderPluginInterface extends PluginInspectionInterface {

  /**
   * Check if the plugin is applicable to the user input.
   *
   * @param string $input
   *   User input to check if it's a URL for the given provider.
   *
   * @return bool
   *   If the plugin works for the given URL.
   */
  public static function isApplicable($input);

  /**
   * Render a thumbnail.
   *
   * @param string $image_style
   *   The quality of the thumbnail to render.
   * @param string $link_url
   *   Where the thumbnail should be linked to.
   *
   * @return array
   *   A renderable array of a thumbnail.
   */
  public function renderThumbnail($image_style, $link_url);

  /**
   * Get the URL of the remote thumbnail.
   *
   * This is used to download the remote thumbnail and place it on the local
   * file system so that it can be rendered with image styles. This is only
   * called if no existing file is found for the thumbnail and should not be
   * called unnecessarily, as it might query APIs for video thumbnail
   * information.
   *
   * @return string
   *   The URL to the remote thumbnail file.
   */
  public function getRemoteThumbnailUrl();

  /**
   * Get the URL to the local thumbnail.
   *
   * This method does not gartunee that the file will exist, only that it will
   * be the location of the thumbnail after the download thumbnail method has
   * been called.
   *
   * @return string
   *   The URI for the local thumbnail.
   */
  public function getLocalThumbnailUri();

  /**
   * Download the remote thumbnail URL to the local thumbnail URI.
   */
  public function downloadThumbnail();

  /**
   * Render embed code.
   *
   * @param string $width
   *   The width of the video player.
   * @param string $height
   *   The height of the video player.
   * @param bool $autoplay
   *   If the video should autoplay.
   *
   * @return mixed
   *   A renderable array of the embed code.
   */
  public function renderEmbedCode($width, $height, $autoplay);

  /**
   * Get the ID of the video from user input.
   *
   * @param string $input
   *   Input a user would enter into a video field.
   *
   * @return string
   *   The ID in whatever format makes sense for the provider.
   */
  public static function getIdFromInput($input);

  /**
   * Get the name of the video.
   *
   * @return string
   *   A name to represent the video for the given plugin.
   */
  public function getName();

}

Members

Name	Modifiers	Type	Description	Overrides
PluginInspectionInterface::getPluginDefinition	public	function	Gets the definition of the plugin implementation.	4
PluginInspectionInterface::getPluginId	public	function	Gets the plugin_id of the plugin instance.	2
ProviderPluginInterface::downloadThumbnail	public	function	Download the remote thumbnail URL to the local thumbnail URI.	2
ProviderPluginInterface::getIdFromInput	public static	function	Get the ID of the video from user input.	4
ProviderPluginInterface::getLocalThumbnailUri	public	function	Get the URL to the local thumbnail.	2
ProviderPluginInterface::getName	public	function	Get the name of the video.	2
ProviderPluginInterface::getRemoteThumbnailUrl	public	function	Get the URL of the remote thumbnail.	4
ProviderPluginInterface::isApplicable	public static	function	Check if the plugin is applicable to the user input.	2
ProviderPluginInterface::renderEmbedCode	public	function	Render embed code.	4
ProviderPluginInterface::renderThumbnail	public	function	Render a thumbnail.	2