drupal-media / d8-guide

Definitive guide on how to integrate and develop with Drupal Media.

Drupal 8 Media Guide

##Introduction

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.

We still have a ways to go to achieve that goal, but this guide will help you to understand our Roadmap and Module Status.

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.

Getting Involved

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
• DropzoneJS
• Embed API
• Entity Embed
• Entity Browser
• Fallback Formatter
• Field Formatter
• File Checker
• File Entity
• Flysystem
• Image Effects
• Image Widget Crop
• Media Entity
• Media
• URL Embed

Troubleshooting

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.

Read more about Aaron at his community spotlight and the new Aaron Winborn Award.

You will be missed, friend.

License

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

d8-guide's Issues

How to use not Slick formatter for Gallery (slideshow)?

Hi!
I have a trouble with a Slick gallery jointly CSS Grid Layout (See this issue).

Can I use any other library, like Fotorama?

Thank you!

Add cover.jpg

http://help.gitbook.com/format/cover.html

Explaining the file usage system

• Explain how the file usage system works
• Why and how to change the orphaned file cleanup interval

Managed vs unmanaged files

Document core file and image fields

• Explain what a file field and image fields are, and what data they store
• Review the widgets available to both fields
• Review the formatters available to both fields
• Explain how to pick a file vs image field

Explain the differences between Media entities and File entities

File entity provides interfaces for managing files. It also extends the core file entity, allowing files to be fieldable, grouped into types, viewed (using display modes) and formatted using field formatted.

vs

Media entity provides a 'base' entity for media. This is a very basic entity
which can reference to all kinds of media-objects (local files, YouTube
videos, Tweets, Instagram photos, ...). Media entity provides a relation between
Drupal and the media resource.

From those 2 descriptions from file_entity module and media_entity module, I may be hard for a site builder to decide whether to use a Fieldable entities or Media entities to achieve different use cases.

Take a look to the first 5 minutes of this video https://www.youtube.com/watch?v=vyav4VBuLng for more context.

Is this still maintained?

Saw some really old issues and PRs.

I was just wondering if this repo is still active before opening a PR.

Thanks!