drupal 8.2.2

This is a patch release of Drupal 8 and is ready for use on production sites. See the CHANGELOG.txt for a summary of changes and improvements since the last minor release. Learn more about Drupal 8.

This release only contains bug fixes, along with documentation and testing improvements.

This release includes an API addition to the taxonomy module to support improved testing: TAXONOMY_HIERARCHY_(DISABLED|SINGLE|MULTIPLE) constants deprecated, use corresponding constants on VocabularyInterface. (All change records for this release)

Known issues

There are no known regressions in this release.

Drupal 8 currently has a number of known issues related to incorrect tracking of file usage, which can result in files being unexpectedly deleted from a site. (These issues also existed in 8.0.x and 8.1.x but have been recently discovered.) Site owners experiencing unexplained file loss should consider setting "Delete orphaned files" to "Never" on /admin/config/media/file-system until these issues are resolved, and note the following issues:

• #2801777: Give users the option to prevent Drupal from automatically marking unused files as temporary
• #2708411: File usage not incremented when adding new translation
• #1239558: Deleting a node with revisions does not release file usage
• #2666700: User profile images unexpectedly deleted
• #2810355: Images lost when changing node language

The following issues may affect people running this release on specific hosting environments:

• Windows/IIS environments may encounter site errors due to #2606772: Long Twig cache directories can cause failures on Windows
• Particular Apache configurations may have issues with serving public file assets. Issue: #2619250: Disabling -MultiViews in .htaccess can cause 500 errors

Search the issue queue for all known issues.

All changes since the last release

• #2374301 by DuaelFr, YesCT, lomasr: Cannot predict the order of results in taxonomy autocompletion
• #2783715 by claudiu.cristea, chx, mikeryan, heddn, phenaproxima: Entity destination ID schema should match entity ID definition
• #2802593 by arunkumark, er.pushpinderrana, karlosgliberal, joachim: incorrect param for EntityController::loadBundleDescriptions()
• Revert "Issue #2783715 by claudiu.cristea, chx, mikeryan, heddn, phenaproxima: Entity destination ID schema should match entity ID definition"
• #2632434 by yongt9412, EclipseGc, ivanjaros, Berdir: Conditions are not limited by available contexts
• #2788521 by david.gil, SteffenR: hook_options_list_alter sample fails on 8.1.8
• #2669978 by Jo Fitzgerald, arturs.v, phenaproxima: Migrate D7 Menu Links
• #2822757: Remove Scott Reeves (Cottser) from the theme system/theme API maintainers
• #2822665 by martin107: LibraryDiscoveryParserTest::testBuilldByExtensionSimple() passes an unwanted parameter
• #2678612 by Jo Fitzgerald, phenaproxima, benjy: D7 link field instance settings not migrating
• #2804639 by tedbow, drpal, catch: Offcanvas dialog width not respected
• #2675156 by maijs, rocketeerbkw, mitrpaka, quietone: Pipeline using explode and extract fails
• #2811725 by mpdonadio, paulanders, jhedstrom: Error when render Datetime Range field: Error: Unsupported operand types
• #2610436 by Gábor Hojtsy, Cottser, joelpittet, pp, xjm, alexpott: Twig templates incorrectly use % trans % with arbitrary filters
• #2806285 by maxocub, Gábor Hojtsy, quietone, catch: If the default language is not set, the migration log show an error
• #2549839 by quietone, mikeryan, benjy: Removed unused variables from D6 search settings migration
• #2207247 by larowlan, sasanikolic, olli, s_leu, Berdir, joelpittet, mrjmd, rpayanm, dawehner, Truptti, nod_, alexpott, Wim Leers: Dialog titles double escaped for views handlers and delete forms
• #2645164 by kekkis, quietone, heddn, Lars Toomre: Fix use of $sourceValues and $destinationValues local variables
• #2778445 by neclimdul, anish.a, Charlotte17, arturs.v, iMiksu, heddn, mikeryan: Add migration message property to migrate executable
• #2796151 by mpdonadio, jhedstrom, myLies, vijaycs85, lomasr, alexpott, Gábor Hojtsy, penyaskito, catch, xjm: Date range separator should be translatable
• #2783075 by claudiu.cristea: Followup: Add a "download" process plugin, remove remote capability from FileCopy
• Revert "Issue #2745911 by tim.plunkett, pwolanin: Block add links should respect destination"
• #2783075 by phenaproxima, claudiu.cristea, ohthehugemanatee, chx, mikeryan: Add a "download" process plugin, remove remote capability from FileCopy
• #2821709 by tedbow, drpal: Allow links to open content in Offcanvas tray without edit mode being enabled
• #2814141 by tbonomelli, Berdir, Ginovski, tduong: Auto-reply mail attempts to send a mail to an empty e-mail if the e-mail field is not shown
• #2812625 by quietone: contact_category should dedupe contact_form not user_role
• #2785133 by tedbow, effulgentsia: Simplify OpenOffCanvasDialogCommand
• #2621500 by quietone, mikeryan, phenaproxima, chx: Configuration source plugin
• #2820079 by michielnugter, claudiu.cristea, droplet, dawehner, pfrenssen: Convert \Drupal\book\Tests\BookTest::testBookOrdering() to a JavascriptTestBase test
• #2819879 by mikeryan, quietone: Add quietone to MAINTAINERS.txt for Migrate and Migrate (Drupal) subsystems
• #2818031 by phenaproxima, Berdir, alexpott: Trailing slashes can cause FileSystem::mkdir() to return a false negative
• #2820442 by klausi: SimpleTestBrowserTest has random fails when BrowserTestBaseTest gets larger
• #2821497 by felribeiro, joelpittet, JJmonterey: html.html.twig docblock typo
• #2810083 by Mile23, dawehner, Mixologic: Duplicate test results per fail/exception
• #2803923 by gianani, shashikant_chauhan, joachim: Table render element docs don't explain how to do colspan
• #2795601 by jhedstrom, mpdonadio: Convert \Drupal\Tests\system\Functional\Common\FormatDateTest mostly to a kernel test
• #2801409 by jp.stacey, dawehner, tstoeckler: Entity routing via YAML or via a routing provider is ambiguous in docs
• #2811065 by webflo, klausi, anavarre, tstoeckler, rfay: Fix docs around --printer option in phpunit.xml.dist
• #2813971 by cilefen: Remove cilefen from core mentoring coordinators
• #2821774 by tim.plunkett: MigrateUpgradeForm incorrectly using form values for multistep management
• #2821113 by alexpott: eslint 'use strict' rule wrong
• #2819479 by shashikant_chauhan, joachim: Fully qualify the FieldItemListInterface class name in its docs so it links
• #2791375 by shashikant_chauhan: Fix $tableInformation documentation in pgsql and mysql schema.php
• #2821320 by michielnugter, droplet, Lendude: Add test coverage for machine-name.js
• #2819593 by dawehner, webflo: Link title double escaping in Link::preRenderLink
• #2807879 by peaton, phenaproxima, alexpott: Convert Contact's Migrate source tests to new base class
• #2807889 by chipway, phenaproxima, svendecabooter, quietone: Convert File's Migrate source tests to new base class
• #2820875 by chrisfree: Typo within Responsive Image module
• #2807947 by maijs, svendecabooter, quietone: Convert User's Migrate source tests to new base class
• #2807941 by svendecabooter: Convert Taxonomy's Migrate source tests to new base class
• #2807937 by erozqba, svendecabooter, phenaproxima: Convert Shortcut's Migrate source tests to new base class
• #2798941 by mikeryan: Remove dead code in MigratePluginManager
• #2807919 by maijs, svendecabooter: Convert Path's Migrate source tests to new base class
• #2807885 by phenaproxima, svendecabooter: Convert Field's Migrate source tests to new base class
• #2807917 by svendecabooter: Convert Node's Migrate source tests to new base class
• #2818347 by tstoeckler: Make tstoeckler a maintainer of Entity API
• #2815063 by leeotzu, shruti1803, minakshiPh, lomasr, Yogesh Pawar, Chi: Typo in EntityResource::delete()
• #2716133 by quietone, kevinquillen, phenaproxima, mikeryan, Charlotte17: Roles are duplicated instead of updated existing roles
• #2807863 by quietone, phenaproxima: Convert Block_content's Migrate source tests to new base class
• #2798521 by jamesrward, Manuel Garcia, mikeker, Lendude, przemek_leczycki, aklump, dawehner: Views result summary returns float number when using the mini pager
• #2810547 by corbacho, tedbow: Twig spaceless tag is removing whitespace padding from many elements
• #2752463 by tstoeckler: EntityResolverManager::setParametersFromEntityInformation() sets parameter info for non-existing parameters
• #2818871 by claudiu.cristea, mikeryan: Allow logging skip row exception messages
• #2640842 by heddn, quietone, juancasantito, JoshOrndorff: Make related file migration ID configurable in d6_cck_file
• #2818799 by claudiu.cristea: MigrateSkipRowException being TRUE, does not skip silently as should
• #2784951 by Shashwat Purav, er.pushpinderrana: Comment contains a reference to a function that doesn't exist anymore
• #2807939 by erozqba, svendecabooter: Convert System's Migrate source tests to new base class
• #2807871 by phenaproxima, svendecabooter: Convert Book's Migrate source tests to new base class
• #2807855 by phenaproxima, maijs, svendecabooter: Convert Block's Migrate source tests to new base class
• #2807891 by svendecabooter: Convert Filter's Migrate source tests to new base class
• #2807509 by phenaproxima, quietone: Convert Aggregator's Migrate source tests to new base class
• #2807893 by svendecabooter: Convert Image's Migrate source tests to new base class
• #2807943 by phenaproxima, erozqba: Convert Tracker's Migrate source tests to new base class
• #2807845 by quietone: Convert Ban's Migrate source tests to new base class
• #2807905 by svendecabooter: Convert Menu_link_content's Migrate source tests to new base class
• #2784357 by alexpott: Remove ModerationInformationInterface::loadBundleEntity()
• #2810071 by mikeryan: d6_profile_field_values processes rows multiple times
• #2811133 by cilefen, Wim Leers, neclimdul, dawehner: Confusing error response set by ContentTypeHeaderMatcher when forgetting the Content-Type request header
• #2807109 by phenaproxima: Convert Action's Migrate source tests to new base class
• #2817565 by Sam152: Bugs in ModerationStateFieldItemList mean it can never be used with a field formatter
• #2753741 by Wim Leers, dawehner, znerol: Page Cache caches all safe HTTP methods (GET+HEAD), but generates the same cache ID for either: add test coverage to prove this is correct
• #2527324 by Kartagis, naveenvalecha: The install message referencing insufficient PDO drivers links to the wrong documentation page
• #2808123 by dawehner, klausi, xjm: Add a Testing framework component to MAINTAINERS.txt
• #2815497 by andypost: Fix @see references in ListItemBase
• #2814971 by phenaproxima: Remove redundant configuration in d6_field migration
• #2807331 by xjm: Add plach as an Entity API maintainer
• #2806733 by joelpittet: testMultipleLibrariesAreNotLoaded is not asserting anything
• #2795395 by Yogesh Pawar, tresti88, marvin_B8, shashikant_chauhan, tstoeckler, dawehner: PathRootsSubscriber breaks if there are no routes
• #2409453 by quietone, phenaproxima, hussainweb, vprocessor, hosef, chx: Variable to config: statistics.settings [d7]
• #2575829 by znerol: Hash session id before using it as a cache context
• #2815063 by minakshiPh: Typo in EntityResource::delete()
• #2806249 by Pol: Small typo error in the method headers of NegotiationUrlForm
• #2702969 by andrewmacpherson: Module filter does not announce number of results for screenreader when Toolbar module is disabled
• #2702891 by sjsneve: Internet Explorer adds excessive padding to body when toolbar present and page resized after scroll
• #2795539 by Shashwat Purav, shashikant_chauhan: Punctuation issue for Place block module in hook_help
• #2809115 by petiar, Yogesh Pawar, maxocub: When migrating a multilingual D6 site, the overview page says that the translation upgrade path is missing
• #2672668 by jibran, malavya, msankhala, archunan, Wim Leers, willzyx, lokapujya: Page title with HTML tags shows HTML tags in shortcut label in the shortcut toolbar tray
• #2808329 by quietone, phenaproxima: Add default values to Row constructor
• Revert "Issue #2609252 by eiriksm, lokapujya, toncic92, Arla, chx, Berdir: Boolean field with #access FALSE cause EntityStorageException"
• #2798981 by dawehner, Sam152: ListNormalizer fails to pass on context variable to field items
• #2767125 by hchonov, amateescu: EntityFormDisplay::validateFormValues sets form state errors by empty name string instead using the provided form element
• #2664530 by Lendude, slasher13, catch, alexpott, andrew.trebble: Views Combined fields filter with Contains
• #2751223 by maxocub, jeroenbegyn, Gábor Hojtsy, Jo Fitzgerald: D6 & D7 users are migrated into D8 with incorrect langcode
• #2773085 by Sam152, Wim Leers: CKEditor doesn't show elements in the styles dropdown if an input filter alters them
• #2699489 by catch, tim.plunkett: FormBuilder $ajax_form_request check does not check which AJAX form is being requested
• #2810057 by arijits.drush, Lendude: WSOD after renaming and deleting a views display
• #2813661 by evaldask: A fatal error occurred: Field changed is unknown
• #2807263 by Wim Leers: Impossible to write unit tests involving Vocabulary, because TAXONOMY_HIERARCHY_(DISABLED|SINGLE|MULTIPLE) are defined in taxonomy.module instead of VocabularyInterface
• Revert "Issue #2683435 by hussainweb, mikeryan, quietone, alexpott, michael_wojcik, phenaproxima, benjy: Consider renaming Migrate's cckfield plugins"
• #2743183 by szato, nielsvandermolen: Fatal error in Book navigation block for unpublished parent book item
• #2683435 by hussainweb, mikeryan, quietone, alexpott, michael_wojcik, phenaproxima, benjy: Consider renaming Migrate's cckfield plugins
• #2795965 by Wim Leers, neclimdul: REST requests with invalid X-CSRF-Token header get "missing " mesage
• #2788209 by amateescu, Berdir: Entity reference field "Autocomplete matching: Starts with" option does not work
• #2795967 by daffie, Katiemouse: A query with a fetchAll(\PDO::FETCH_COLUMN) will fail for SQLite
• #2804595 by dagmar, Berdir: Sample values for entity references cause Fatal error: Allowed memory
• #2630692 by Lendude, arunkumark: Fatal error when creating taxonomy term glossary view
• #2792205 by fago: Denormalization of entities with translations fails
• #2609252 by eiriksm, lokapujya, toncic92, Arla, chx, Berdir: Boolean field with #access FALSE cause EntityStorageException
• #2806205 by Prashant.c, markdorison: Remove reference to old ListTextItem
• #2672888 by fago: BrowserTestBase fails when the webserver runs as another user
• #2791727 by bhide.nishad, chishah92, tresti88, Chi: Wrong links in tours (eg. Language and Locale)
• #2800799 by aronne, Lendude: Views throws InvalidArgumentException in More Link with external URLs
• #2647916 by Lendude, Wim Leers, dawehner: Views ajax modals stop working in certain scenarios: due to JS settings caching, AJAX responses may set wrong ajaxPageState.libraries, causing problems for subsequent AJAX requests/responses
• #2744517 by webflo: Twig template link() call to accept markup
• #2804375 by Lendude, dawehner: Exception thrown when using [view:url] token when there is no display with a URL in the view
• #2778083 by mpdonadio, YesCT: Default value for Date-Only fields is broken when UTC date is different than user current date
• #2504849 by Berdir, catch, alexpott: User::getAnonymousUser() takes 13ms due to ContentEntityBase::setDefaultLangcode()
• #2608408 by nlisgo, dagmar, aleevas, neclimdul, BR0kEN, gaydabura, pfrenssen, zuuperman: Call to a member function getPath() when installing Profiles with unknown modules as requirement
• #2744197 by Boobaa, Wim Leers, alexpott: Proper private file support for images uploaded via EditorImageDialog
• #2600804 by Lendude, D4K0, dawehner, droplet: AJAXified glossary view arguments fail when Language URL detection enabled
• #2774195 by lauriii, claudiu.cristea: Passing attributes to field element label is not possible
• #2797213 by Simon Georges: Strange useless code in Component/Utility/Random.php
• #2797967 by tim.plunkett: Field UI needlessly resaves each enabled entity display
• #2794089 by Wim Leers, yobottehg, slashrsm: SessionManager::destroy() is incompatible with streamed responses: tries to send response header after headers have already been sent, causing watchdog to fill up with PHP warnings
• #2796329 by Wim Leers: \Drupal\Core\File\MimeType\ExtensionMimeTypeGuesser maps the 'js' extension to the 'application/x-javascript' MIME type instead of 'application/javascript'