Classes and methods changes
The following methods are deprecated in blazy:8.x-2.0 and are removed from blazy:8.x-3.0 for a few reasons such as a transition from Video Embed Field to core Media, clarity, consistency, additional functionality, decluttering particular classes, and reducing irrelevant build prefixes for methods which are mostly designed to modify, not build:
Formatters
| blazy:8.x-2.0 (Before) | Reasons | blazy:8.x-3.0 (After) |
|---|---|---|
| Blazy Image with VEF (deprecated) formatter | Media integration. | Blazy Media formatter, or alternative |
| Blazy Video VEF (deprecated) formatter | Media integration. | Blazy Media formatter, or alternative |
| \Drupal\blazy\Plugin\Field\FieldFormatter\BlazyVideoFormatter | Media integration | \Drupal\blazy\Plugin\Field\FieldFormatter\BlazyMediaFormatter |
| \Drupal\blazy\Dejavu\BlazyVideoBase | Media integration | \Drupal\blazy\Plugin\Field\FieldFormatter\BlazyMediaFormatterBase |
Note: the alternative is relevant till you have time to fully ditch VEF for core media. If you have time, just continue using the old deprecated built-in Blazy VEF, no need for the alternative, and then change it to Blazy Media formatter immediately.
Services, methods
| blazy:8.x-2.0 (Before) | Reasons | blazy:8.x-3.0 (After) |
|---|---|---|
| \Drupal\blazy\BlazyFormatterManager | Consistency | \Drupal\blazy\BlazyFormatter |
| \Drupal::service('blazy') | Irrelevant, never used anywhere due to static methods. | No need a service. Just import \Drupal\blazy\Blazy class directly. |
| \Drupal\blazy\Dejavu\BlazyDefault | Consistency | \Drupal\blazy\BlazyDefault |
| \Drupal\blazy\Dejavu\BlazyVideoTrait | Media integration | \Drupal\blazy\Media\BlazyOEmbed |
| \Drupal\blazy\Dejavu\BlazyVideoTrait::getMediaItem() | Media integration | \Drupal\blazy\Media\BlazyOEmbed::build() |
| \Drupal\blazy\Dejavu\BlazyVideoTrait::buildVideo() | Media integration | \Drupal\blazy\Media\BlazyOEmbed::build() |
| \Drupal\blazy\BlazyManager::getEntityView() | Single responsibility | \Drupal\blazy\BlazyEntity::view() |
| \Drupal\blazy\BlazyManager::getImage() | Irrelevant, poor name | \Drupal\blazy\BlazyManager::getBlazy() |
| \Drupal\blazy\Form\BlazyAdminFormatterBase::settingsSummary() | Simplified | \Drupal\blazy\Form\BlazyAdminFormatterBase::getSettingsSummary() |
CSS classes changes
Changed media--BUNDLE CSS class to media--bundle--BUNDLE to avoid conflict with media--TYPE, where TYPE has been hard-coded since 1.x to very limited video, audio, image which appear to be troublesome given remote_video vs. local video. We had no Media nor Media bundles in core at 1.x.
| blazy:8.x-2.0-rc6 (Before) | blazy:8.x-2.0-rc7+ (After) |
|---|---|
| media--BUNDLE, e.g.: media--remote-video | media--bundle--BUNDLE, e.g.: media--bundle--remote-video |
| media--background | b-bg, to accommodate non-media elements like form items, body, grid, etc. |
Feature changes
The custom breakpoints had been removed here:
#3105243: Shall we keep or drop custom breakpoints? Your vote counts
The replacement for blazy:3+ is core Responsive image.
| blazy:8.x-2.0 (Before) | blazy:8.x-3.0 or sooner (After) |
|---|---|
| \Drupal\blazy\BlazyManagerBase::cleanUpBreakpoints() | |
| \Drupal\blazy\BlazyManagerBase::buildDataBlazy() |
