Drupal 8 Media Guide
This guide provides and overview of the approach to Media in Drupal 8.
The Drupal Media Team has set an ambitious goal of ensuring Drupal offers best media solution available in any web framework.
As discussed in the Roadmap and throughout this Guide, the Media Team has worked collaboratively to separate Media functionality into several independent modules that can be used together based as appropriate. Over time we'll be adding examples of how these modules can be integrated.
We also hope that this guide will help you understand best practices and get started using media in your Drupal 8 project today.
The Drupal Media team is actively seeking contributions and new team members. There are many ways to get involved, including helping with funding, project management communications, documentation, testing and development. Submit edits to this guide at the GitHub repository. Please check out our Contributing page for full details.
Using this Guide
As mentioned above, Media for Drupal 8 is undergoing a re-architecture into individual components. For example, the Media Browser functionality is being developed into the Entity Browser module and embedding media in WYSIWYG is being developed into the Entity Embed module.
While not all of these components are complete you can still do a lot with what's done. This Guide includes a Module Status section which provide an overview of the ecosystem, and then more detailed guides for each of the available modules:
- Crop API
- Embed API
- Entity Embed
- Entity Browser
- Fallback Formatter
- Field Formatter
- File Checker
- File Entity
- Image Effects
- Image Widget Crop
- Media Entity
- URL Embed
If you have trouble understanding any part of the documentation, please notify those of us who work on this section by creating an issue and clearly explain what you don't understand and why - we're happy to hear from you, your contribution helps everyone at Drupal!
Thank You Aaron
Aaron Winborn (aaron) exemplified the best aspect of the Drupal community and open source contribution. Without his kindness, generosity, humility, and dedication, the Media modules and many many others would not have been possible. This module and all Drupal Media team efforts are in dedication to Aaron and all he has done for our community.
You will be missed, friend.
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.