# Formatter Suite Release Notes

## 8.x-1.3.0, 7/17/2020

Requires PHP 7.2+ and Drupal 8.8+

Administrator features

#### Updates:

Drupal 8.8 minimum.
  The module now uses new info.yml syntax that requires Drupal 8.8 and later.
Drupal 9 support.
  The module supports Drupal 9. It passes all tests by Drupal Upgrade Rector and Upgrade Status modules used to check for Drupal 9 issues. (see Issue 3147592.)
Include files moved and consolidated
  A legacy organization of include files for help, theme, and update functions has been updated to current style recommendations. This has no functional impact. (see Issue 3158013.)

Formatters

#### Bugs fixed:

The "Text with expand/collapse buttons" formatter does not suppress the default button action, which scrolls the page inappropriately.
  Fixed. The default action of these button links is now suppressed. They no longer cause page scrolling. (see Issue 3048494.)
The "Text with expand/collapse buttons" formatter does not translate text for the two buttons.
  Fixed. Language translation tables are built by Drupal.org scanners that look through module code for literal strings. Since text entered by admin for a specific site is not visible to Drupal.org code scanners, it is not automatically added to translation tables. This normally makes such text untranslatable. However, if a site admin manually enters the text in the site's own translation tables, and provides translations, this module's formatter will now pick that up. (see Issue 3048501.)
The "General Number with Bar Indicator" formatter's bars do not work with some themes.
  Fixed. The formatter's bars are images and some theme CSS could interfere with the proper bar width and height. This has been fixed by changing the way bar images are created and by adding module CSS that prevents themes from adding unexpected margins, padding, borders, and shadows.
The "General Number with Bar Indicator" formatter's bars can be exceed the range 0% to 100% of the field.
  Fixed. The math used to calculate the presented bar length did not check for edge cases where a field's value was smaller or larger than the field definition's minimum or maximum. This could produce bar lengths that were negative or excessive.
The "field.html.twig" template in the module is not used.
  Fixed. The extra template file has been removed. This has no functional impact.
Formatter UI inputs for classes, separators, colors, and other technical text should not be spell checked.
  Fixed. Spell checking, auto-correcting, auto-completing, and auto-capitalilzing are now disabled for all non-word input fields. This may not work identically for all browsers.
Formatter UIs show some odd layout and styling.
  Fixed. Styling of the UIs has been updated. This remains dependent upon the site's administrator pages theme.
Image formatters do not show default images for fields.
  Fixed. When an entity has an empty image field and a default image is defined, the image is now shown.

#### New features:

New "General User Reference" formatter for user entity references.
  The formatter shows one or more of the user's account name, display name, ID, last-login date, creation date, email address, etc. Custom text with token replacement can create additional combinations.
Updated "General Entity Reference" to use token replacement.
  The formatter now has more options for showing an entity's title, author, ID, update date, creation date, etc. Custom text with token replacement can create additional combinations.

#### Deprecation:

The "General Entity Reference List" formatter was been removed.
  The formatter was marked deprecated in version 1.2 in early 2019. It has now been removed. Use "General Entity Reference" instead, which supports the same reference list features.
The "General Email List" and "General Number List" formatters are now marked deprecated.
  These were previously marked with a deprecation warning, but not formally deprecated. They remain in the module but will be removed in the next release. Use "General Email" and "General Number" instead, both of which support the same list features.

## 8.x-1.2.0, 3/27/2019

Requires PHP 7.2+ and Drupal 8.7+

Administrator features

#### Updates:

UI text and styling updated.
  Minor updates have been made to the UI for all formatters. The updates reduce the UI size and simplify text.
Help updates.
  When the core Help module is enabled, the module's help page has been updated and now includes images of all formatters.
Module dependencies reduced.
  The module now only depends upon the Drupal core Field module. If a site includes the core Datetime, Email, File, Link, Image, and Text modules, then this module's relevant formatters are automatically available.

Formatters

#### Bugs fixed:

The "General Entity Reference" formatter crashes if the link title is set to an entity ID.
  Fixed. The entity ID is now properly handled.
For formatters showing lists, the item separator is shown even when the list style is bulleted or numbered.
  Fixed. The item separator is only shown between items on the same line.

#### New features:

New "General Link" formatter.
  The formatter works with link fields, showing a link and its title. The formatter supports HTML5 link annotation, including "rel", "target", "download", and the link topic. The formatter also supports special "noreferrer", "noopener", and "nofollow" annotation for search engines and spiders, and values that trigger a link to download or open a new tab.
New "General File Link" formatter.
  The formatter works with file fields, showing a link to the file. The formatter supports a file-relevant subset of the HTML5 link annotation features found in the "General Link" formatter.
New "General Image" formatter.
  The formatter works with image fields, showing an image and link to the image or entity. An image style may be selected to transform the image (e.g. to create a thumbnail). An optional caption can be added above or below the image. The formatter supports a file-relevant subset of the HTML5 link annotation features found in the "General Link" formatter.
The "General Entity Reference" formatter supports link annotation.
  The formatter supports a relevant subset of the HTML5 link annotation features found in the "General Link" formatter.
The "General Entity Reference", "General Email", and "General Number" formatters now support multi-value fields.
  When a field has multiple values, the values are shown in a configurable list that can place values on a single row with a separator (such as a comma), or arrange them as a bullet list, numbered list, or stacked set of <div> blocks.

#### Deprecation:

The "General Entity Reference List", "General Email List", and "General Number List" formatters are deprecated.
  These formatters are all redundant. The corresponding "General Entity Reference", "General Email", and "General Number" formatters handle value lists themselves. The list-specific formatters will be removed in a future release.

## 8.x-1.1.0, 11/28/2018

Requires PHP 7.2+ and Drupal 8.7+

Formatters

#### Bugs fixed:

The "General Number" formatter shows the ceiling instead of rounding floating point numbers.
  Fixed. Truncated floating-point numbers are now rounded up or down instead of showing the ceiling. (see Issue 3010979.)
The "General Number" formatter shows log entries about an undefined index "numeralBase".
  Fixed. A field name was corrected.
The "Image Embed Data" formatter logs error messages about an invalid theme.
  Fixed. An incorrect theme include was corrected.
Translation calls should be avoided in classes.
  Fixed. Style checker complaints are now addressed. This has no functional impact. (see Issue 3011438.)

## 8.x-1.0, 9/24/2018

Initial release.

Requires PHP 7.2+ and Drupal 8.6+