Media Library Form API Element

  • Écrit le 22 juin 2023 par admin
Module Drupal Illustration Voir sur Drupal.org
Nb téléchargements : 30621

Components

  • Code
  • Documentation
  • Miscellaneous
  • User interface

Ecosystem

Licence

http://www.gnu.org/licenses/old-licenses/gpl-2.0.html

permet d'ajouter un élément dans l'API Form pour sélectionner une entité media de la librairie des medias.

Release

Status : Published
Projects : Modules
Maintenance status : Actively maintained
Development status : Under active development
Supported Branches : 2.0., 2.1.
shield Stable releases for this project are covered by the security advisory policy.

2.1.1 Stable release covered by the Drupal Security Team released 26 August 2024
Works with Drupal: ^10.3 || ^11
Install:
composer require 'drupal/media_library_form_element:^2.1'

Covered by Drupal's security advisory policy

Release type : New features


2.0.6 Stable release covered by the Drupal Security Team released 18 January 2023
Works with Drupal: ^9.2 || ^10
Install:
composer require 'drupal/media_library_form_element:^2.0'

Covered by Drupal's security advisory policy

Release type : Security update


8.x-1.3 Stable release covered by the Drupal Security Team released 15 December 2020
Works with Drupal: ^8 || ^9
Install:
composer require 'drupal/media_library_form_element:^1.3'

Covered by Drupal's security advisory policy

Release type : Bug fixes

Description

This module provides a Form API element to select a Media entity from the Media Library. This element can be used in all standalone forms. I'm currently using this in a Paragraphs behavior form to select a background image with crop-support, but you can use it in a Layout builder form, or a configuration form under "Settings"...

The implementation is borrowed from the Media Library widget and follows its user interface as well as its possibilities:

  • You can limit the allowed media types by passing the machine names of those media types
  • The default value is either:
    • Empty: NULL
    • a single Media entity's ID: (int) 1
    • multiple Media entity ID's separated by comma as a string: (string) 1,2,3,4
$form['image'] = [
  '#type' => 'media_library',
  '#allowed_bundles' => ['image'],
  '#title' => t('Upload your image'),
  '#default_value' => NULL|1|'1,2,3',
  '#description' => t('Upload or select your profile image.'),
];

I chose to release this as a standalone module so anyone can review / contribute / fork / ... without having to wait on the official core patch (https://www.drupal.org/project/drupal/issues/3065677).

Feel free to test-drive, suggest improvements or post bug reports should you encounter any!

All features have been implemented thus far, so if anyone lacks something, feel free to create an issue!



Toutes les informations proviennent du site drupal.org