drupal 8.3.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.

The following important issues are resolved in 8.3.2 (in addition to the dozens of other fixes listed at the end of this post):

• #2867493: Error: Call to a member function getTotalCount() on boolean in statistics_get()
• #2867887: statistics_get() test mashes 0 too much
• #2753971: ContentEntityStorageBase::deleteRevision() function does not remove node_field_revision entries

Update instructions

Beginning with 8.2.3, packaged Drupal releases no longer contain development PHP libraries. See Drupal 8 will no longer include dev dependencies in release packages for more information.

Known issues

There are no known regressions in this release.

There was a temporary problem affecting Drupal 8 sites built with Composer, #2875446: Drupal 8.3.2 installed via composer reports version 8.3.3-dev in UI. If you are affected by this issue, clear the Composer cache and try again.

Updating from versions older than 8.3.0

We've received reports of the following issues with the 8.3.0 release that may affect those updating from older versions of Drupal 8:

• A few sites have reported #2869449: PluginNotFound exception after update to Drupal 8.3 where the plugin name mentioned in the exception may vary. Administrators of affected sites should check the issue queues of contributed modules in use. Comment on #2869449 if necessary.
• Sites that have the HAL module enabled and are upgrading from 8.1.x have encountered #2867444: Configuration schema errors whilst updating to 8.3.0. Possible workarounds include updating to 8.2.7 first and then to 8.3.0, or (for sites using Drush) updating to Drush 8.1.10. (Note that 8.1.x has been end-of-life since September 2016, so we generally do not provide full support for updates that skip minor releases.)

File usage tracking causes unexpected file deletion

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. 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

Search the issue queue for all known issues.

All changes since the last release

Changes since 8.3.1:

• #2871541 by Wim Leers, dagmar, e0ipso: Add API-first initiative to MAINTAINERS.txt
• Revert "Issue #2867700 by erozqba, mondrake, mradcliffe, cilefen: ConnectionUnitTest::testConnectionOpen fails if the driver is not implementing a PDO connection"
• #2867700 by erozqba, mondrake, mradcliffe, cilefen: ConnectionUnitTest::testConnectionOpen fails if the driver is not implementing a PDO connection
• #2868841 by erozqba, Sam152, kristiaanvandeneynde, mikeker: \Drupal\user\Plugin\views\filter\Roles::calculateDependencies breaks when using the empty/not empty operators
• #2844874 by jp.stacey: Improve documentation for ChainedFastBackendFactory
• #2864938 by fenstrat, timmillwood, Sam152: Content moderation form doesn't appear on new entities
• #2855636 by idebr, Pavan B S, chiranjeeb2410, nikunjkotecha, NikitaJain, hugovk, krknth, xjm: Regression: incorrect human-readable name for content type
• Revert "Issue #2868019 by michielnugter, dawehner, Lendude: AssertLegacyTrait field assertions not compatible with Simpletest assertions"
• Revert "Issue #2863416 by zviryatko, michielnugter, Jo Fitzgerald: Convert web tests to browser tests for filter module"
• #2847685 by semiuniversal, tameeshb, benjifisher: Update doc blocks for configureEntityFormDisplay() and configureEntityViewDisplay()
• #2854454 by Maouna, hchonov: EntityReferenceFormatterBase::view() is applying the cacheability metadata but it should be merging it in order to preserve already present cacheability metadata
• #2863416 by zviryatko, michielnugter, Jo Fitzgerald: Convert web tests to browser tests for filter module
• Revert "Issue #2863416 by zviryatko, Jo Fitzgerald, michielnugter: Convert web tests to browser tests for filter module"
• #2872562 by kala4ek, arunkumark, Chi: Drupal\views\Plugin\views\style\StylePluginBase::renderGroupingSets() incorrect documentation
• #2871097 by zaporylie, LoMo: Malformed HTML in translatable string (block_content_help)
• #2868019 by michielnugter, dawehner, Lendude: AssertLegacyTrait field assertions not compatible with Simpletest assertions
• #2863416 by zviryatko, Jo Fitzgerald, michielnugter: Convert web tests to browser tests for filter module
• #2864121 by Lendude, GoZ, dawehner: Convert web tests to browser tests for statistics module
• #2871400 by dagmar: Make ViewsListingTest more readable
• #2782555 by marcoscano, YesCT, Berdir: FileUsageInterface::add() and ::delete() have incorrect param documentation
• #2862625 by Maxfire, tedbow, gaurav.kapoor, drpal, lauriii: Rename offcanvas to two words in code and comments.
• #2843774 by jamesdesq, vaplas: EntityResource: Provide comprehensive test coverage for BlockContentType entity
• #2869904 by tstoeckler: Config schema missing for less common HTTP methods in REST resources configured using 'method' granularity
• #2870410 by tim.plunkett: Field UI should show fields with unknown regions in the "Disabled" section
• #2872793 by peaton, rakesh.gectcr, phenaproxima, heddn, vasi: Create Entity Exists Process Plugin
• #2607210 by malavya, Maninders, jwilson3, prateekS, jordana, ameymudras, Shabbir, Manjit.Singh, Cottser, EdgarPE, Nitesh Pawar, mikeohara, timisoreana, emma.maria, joelpittet, alexpott, kostyashupenko, Vidushi Mehta, jhodgdon: Visual regression: Sidebar menus are missing indentation styles
• #2862752 by Jo Fitzgerald, phenaproxima: Add documentation to PerComponentEntityFormDisplay destination plugin
• #2640668 by sathish.redcrackle, shashikant_chauhan, claudiu.cristea, Goodmood: Fix TermInterface::getVocabularyId() method return type in documentation
• #2620364 by quietone, bburg, Jo Fitzgerald, Yogesh Pawar, amoebanath, phenaproxima, Gábor Hojtsy, catch: Variable to config: theme settings [d7]
• #2845486 by Jo Fitzgerald, quietone, gaurav.kapoor, ohthehugemanatee, heddn, Yogesh Pawar, catch, shabana.navas, phenaproxima, mikeryan: Rename Migration process plugin and add documentation
• #2870146 by droplet, Lendude, michielnugter: Even more random fails in \Drupal\Tests\outside_in\FunctionalJavascript\OutsideInBlockFormTest
• #2824610 by quietone, Jo Fitzgerald, ohthehugemanatee, heddn, catch: Rename DedupeBase/DedupeEntity process plugins to MakeUnique and add documentation
• #2566779 by quietone, hussainweb, keithm, heddn, kekkis, Shawn DeArmond, Jo Fitzgerald, mlbrgl, phenaproxima, mikeryan, 13jupiters, Gábor Hojtsy: Migration D6 > D8 of CCK date fields
• #2837013 by benjifisher, leslieg, alexpott: clean_class Twig filter does not work with Views rewriting
• #2867749 by pfrenssen, claudiu.cristea: Parsing an URL with another URL in the query arguments throws undefined offset notice
• #2665196 by rakesh.gectcr, quietone, Manuel Garcia, Jo Fitzgerald, webflo, mikeryan, phenaproxima, heddn: Migration for email fields is missing
• #2862751 by Jo Fitzgerald, phenaproxima: Add documentation to PerComponentEntityDisplay destination plugin
• #2683435 by quietone, Jo Fitzgerald, hussainweb, mikeryan, Steven Jones, alexpott, phenaproxima, Sam152, Pavan B S, michael_wojcik, Prashant.c, heddn, benjy: CCK does not exist in Drupal 7, rename Migrate's cckfield plugins to field plugins
• #2869570 by AdamPS: Missing dependency of drupal.ckeditor on drupal.displace
• #2685097 by damiankloip, Wim Leers: Fatal error: Call to a member function normalize() on a non-object in XmlEncoder when encoding into xml and there are embedded objects in the response
• Revert "Issue #2665196 by rakesh.gectcr, quietone, Manuel Garcia, Jo Fitzgerald, webflo, mikeryan, phenaproxima, heddn: Migration for email fields is missing"
• #2849861 by masipila, joelpittet, jeffwpetersen, xjm: D6 text area formatting settings not respected when migrating to D8
• #2867340 by Jo Fitzgerald, boaloysius, Cottser: Improve readability of Migration process plugin tests
• #2744069 by kristiaanvandeneynde, achton, dawehner, ohthehugemanatee: views_query_views_alter() does not handle IN queries
• #2753971 by dagmar, alexpott, hampercm, Berdir, generalredneck, xjm, catch: ContentEntityStorageBase::deleteRevision() function does not remove node_field_revision entries
• #2869120 by penyaskito, Mixologic, Berdir: run-tests.sh ignores classes if they have whitespace before the declaration using --directory
• #2781819 by subson, chetan.s: EntityListBuilder::load() doesn't say what the return array is keyed by
• #2869881 by sahilsharma011, quietone: Misnamed migrate test module
• Merged 8.3.1.
• #2843754 by rogierbom, Wim Leers, gaurav.kapoor, vaplas: EntityResource: Provide comprehensive test coverage for Feed entity
• #2333985 by quietone, jarsenx, ultimike, heddn: Migrate menu_default_node_menu setting
• #2850034 by hampercm, dawehner, Wim Leers: CORS allow-origin '*' not possible because of cached headers
• #2724903 by rocketeerbkw, gaurav.kapoor, Jo Fitzgerald, phenaproxima: Migrated custom block body field is hidden on form and display
• #2863996 by nlisgo, Jo Fitzgerald, scuba_fly, dawehner: Convert web tests to browser tests for ckeditor module
• #2869741 by edwardaa: FIx http_middleware priority explanation
• #2786193 by tedbow, gaurav.kapoor, fabian.marz, tkoleary, Bojhan, tim.plunkett, larowlan: Differentiate 2 "Quick edit" links for custom blocks
• #2784567 by tedbow, 20th, dmsmidt, miteshmap, dbjpanda, bendev, crasx, tkoleary: List "Quick edit" before "Configure" in contextual links while in Edit mode
• #2870315 by klausi: Klausi stepping down from all leadership positions
• #2861067 by vaplas: Random fail in Drupal\aggregator\Tests\FeedAdminDisplayTest::testFeedUpdateFields
• #2865537 by nlisgo: Convert web tests to browser tests for minimal profile
• #2863336 by hchonov, tstoeckler, alexpott: Default revision flag doesn't propagate to all entity translation objects
• #2422229 by quietone, ultimike, vprocessor, anish.a, Jo Fitzgerald, phenaproxima: D6->D8 Core block migrations missing settings tests
• #2852886 by Wim Leers, pdenooijer, lauriii: Comment improvement CKEditorPluginButtonsInterface
• #2780063 by mpdonadio, Jo Fitzgerald, GoZ, boaloysius, Lendude, klausi: Convert web tests to browser tests for datetime and datetime_range modules
• #2863268 by nlisgo, Lendude, michielnugter: Convert web tests to browser tests for tracker module
• #2864177 by xjm, droplet: Random failure in FormErrorHandlerCKEditorTest
• #2843763 by arshadcn, Wim Leers: EntityResource: Provide comprehensive test coverage for ContentLanguageSettings entity
• #2843766 by arshadcn: EntityResource: Provide comprehensive test coverage for FieldConfig entity
• #2843773 by Wim Leers: EntityResource: Provide comprehensive test coverage for RestResourceConfig entity
• #2850353 by timmillwood, Pavan B S, Sam152: Test content_moderation with a non-bundleable content entity
• #2864060 by nlisgo, Lendude, alexpott: ModerationStateNodeTypeTest::testEnablingOnExistingContent assertion is misleading
• #2858159 by Artusamak, Lendude: The "User has a revision" views argument handler generates a SQL error
• #2862988 by timmillwood, catch: EntityOperations::entityPresave doesn't always set the correct default revision
• #2359245 by Wim Leers, clemens.tolboom, marthinal, dawehner: REST resource plugin annotation class misses some properties
• #2865295 by JayKandari: $menuLinkManager property on MenuLinkTree is undocumented
• #2862006 by quietone, Jo Fitzgerald, phenaproxima: MigrateSourceTestBase returns false positives for most plugin tests
• #2866656 by alexpott, yoroy, timmillwood: Clicking on "New Draft" tab allows you to archive the content
• #2858607 by c.nish2k3, RenatoG, jhodgdon, yoroy: Non-accessible and D7 link in _update_manager_check_backends()
• #2655154 by generalredneck, claudiu.cristea, gaurav.kapoor, olegel, Jo Fitzgerald, mikeryan, phenaproxima: Optionally log messages for skip_on_empty and skip_row_if_not_set
• #2807913 by quietone, erozqba, Jo Fitzgerald, svendecabooter, phenaproxima: Convert Migrate_drupal's Migrate source tests to new base class
• #2867570 by alexpott: Drupal 8.3.0 is not compatible with Drush <8.1.10 - lets declare that in composer.json
• #2862672 by Jo Fitzgerald, quietone, heddn: Add documentation to EmbeddedDataSource source plugin
• #2820490 by mpdonadio, heddn, Manuel Garcia, Jo Fitzgerald, shabana.navas, mikeryan, tstoeckler, quietone, Grayside, phenaproxima, damondt: FormatDate process plugin
• #2344045 by jhodgdon, EclipseGc, chx, CocoaBean, andrei.dincu, tim.plunkett, fago: ContextInterface needs documentation
• #2108243 by Wim Leers, prics, linclark, YesCT: Document that HAL's RelationLinkManager(Interface) also supports registered link relation types
• #2725081 by quietone: Previous versions of Drupal allow vocabulary machine names longer than 32 characters
• #2701795 by quietone, Jo Fitzgerald, rakesh.gectcr, ifrik, hauruck, yoroy, heddn, mikeryan: Provide menu links for Drupal Upgrade UI pages
• #2826407 by Wim Leers, dawehner, Jo Fitzgerald: PATCH + POST allowed format validation happens in RequestHandler::handle(), rather than in the routing system
• #2868442 by Adita: Wrong namespace in StatisticsSettingsForm constructor docblock
• #2807875 by quietone, Jo Fitzgerald, erozqba, phenaproxima: Convert Comment's Migrate source tests to new base class
• #2782221 by Grimreaper, dawehner, Lendude, alexpott: Result summary Area plugin not displayed when there is no result
• #2845489 by Jo Fitzgerald, quietone, phenaproxima, ultimike: Add documentation to StaticMap process plugin
• #2816307 by GoZ, himanshu-dixit, james.williams, Jo Fitzgerald, dawehner, claudiu.cristea, catch: array_unique notice from List unmet configuration dependencies instead of just failing
• #2851661 by alexpott, dawehner, xjm: Ensure that we're using the right ruleset for coding standards checking
• #2866056 by vaplas, mpdonadio, Wim Leers, dawehner: ResourceTestBase should not have a timeout
• #2864690 by renatog, sandeepscs, cilefen: Fix typos in core README files
• #2867887 by xjm: statistics_get() test mashes 0 too much
• #2867599 by tim.plunkett, DyanneNova: Add DyanneNova to MAINTAINERS.txt for the Layout Initiative
• #2867493 by xjm, alexpott, connectedrobots, webchick: Error: Call to a member function getTotalCount() on boolean in statistics_get()
• #2857681 by Jo Fitzgerald, quietone: Comments not starting with a capital letter in d6_file.yml & d7_file.yml