5.26.0 release notes: some final edits
[civicrm-core.git] / release-notes / 5.26.0.md
index 334c10338b7514a36520dd2c83c52fc40fc70ce3..56cf8c2f00b4cf078650508300266713774c849c 100644 (file)
@@ -21,12 +21,18 @@ Released June 3, 2020
 | Introduce features?                                             | **yes** |
 | Fix bugs?                                                       | **yes** |
 
+## NOTICE: WordPress Service URLs
+
+The upcoming release of WordPress 5.5 ([ETA August 2020](https://make.wordpress.org/core/5-5/)) requires changes to several CiviCRM URLs. CiviCRM 5.26+ adopts a new URL convention. For old URLs, there is transitional support that will work for most web-based visitors. However, this may not be sufficient for *external service integrations* (e.g. certain payment processors or email relays which send notifications to CiviCRM).
+
+Administrators should promptly assess and update any external services which submit notifications to their CiviCRM-WordPress sites. For more information, see the blog post [CiviCRM 5.26 and WordPress: Important notice](https://civicrm.org/blog/kcristiano/civicrm-526-and-wordpress-important-notice).
+
 ## <a name="features"></a>Features
 
 ### Core CiviCRM
 
 - **Create nl_BE translation
-  ([dev/translation#4](https://lab.civicrm.org/dev/translation/-/issues/4):
+  ([dev/translation#4](https://lab.civicrm.org/dev/translation/issues/4):
   [17048](https://github.com/civicrm/civicrm-core/pull/17048),
   [17027](https://github.com/civicrm/civicrm-core/pull/17027) and
   [16966](https://github.com/civicrm/civicrm-core/pull/16966))**
@@ -42,7 +48,7 @@ Released June 3, 2020
   visibility in the API explorer.
 
 - **APIv4 - how do I interact with option values???
-  ([dev/core#1705](https://lab.civicrm.org/dev/core/-/issues/1705):
+  ([dev/core#1705](https://lab.civicrm.org/dev/core/issues/1705):
   [17158](https://github.com/civicrm/civicrm-core/pull/17158),
   [17138](https://github.com/civicrm/civicrm-core/pull/17138) and
   [17219](https://github.com/civicrm/civicrm-core/pull/17219))**
@@ -57,55 +63,46 @@ Released June 3, 2020
 - **APIv4 - Add support for HAVING clause
   ([17015](https://github.com/civicrm/civicrm-core/pull/17015))**
 
-  Adds support for using HAVING clauses in APIv4.
+  Adds support for using `HAVING` clauses in APIv4.
 
 - **APIv4 Query Improvements (Work Towards
-  [dev/report#31](https://lab.civicrm.org/dev/report/-/issues/31):
+  [dev/report#31](https://lab.civicrm.org/dev/report/issues/31):
   [17113](https://github.com/civicrm/civicrm-core/pull/17113) and
   [17047](https://github.com/civicrm/civicrm-core/pull/17047))**
 
-  Adds UI support for new APIv4 features specifically, SQL functions and aliases
-  are now available in the API explorer, as is the HAVING clause and GROUP BY
-  clause.
+  This adds UI support for new APIv4 features.  Specifically, SQL functions and
+  aliases are now available in the API explorer, as is the `HAVING` clause and
+  `GROUP BY` clause.
 
 - **End of life planning for MySQL server 5.0 - 5.6 (Work Towards
-  [dev/core#1681](https://lab.civicrm.org/dev/core/-/issues/1681):
+  [dev/core#1681](https://lab.civicrm.org/dev/core/issues/1681):
   [17261](https://github.com/civicrm/civicrm-core/pull/17261))**
 
   Adds a deprecation notice for Systems using MySQL versions before 5.7 and
   requires 5.5 to install.
 
 - **allow inline help text title to be overriden
-  ([dev/core#1693](https://lab.civicrm.org/dev/core/-/issues/1693):
+  ([dev/core#1693](https://lab.civicrm.org/dev/core/issues/1693):
   [16998](https://github.com/civicrm/civicrm-core/pull/16998))**
 
-  Makes it possible to override inline help text titles.
+  This change makes it possible to override inline help text titles in a
+  `.hlp.extra` file.
 
-- **Update attachment message on mailing form. .
-  ([dev/core#1696](https://lab.civicrm.org/dev/core/-/issues/1696):
+- **Update attachment message on mailing form.
+  ([dev/core#1696](https://lab.civicrm.org/dev/core/issues/1696):
   [17024](https://github.com/civicrm/civicrm-core/pull/17024))**
 
-  Adds more help text to the attachment field on the mailing form.
-
-- **Allow override of inherited CMS language when in CiviCRM
-  ([17006](https://github.com/civicrm/civicrm-core/pull/17006))**
-
-  Makes it possible to override the CMS langhage when in CiviCRM.
-
-- **Convert bcc field to use an entity reference.
-  ([17064](https://github.com/civicrm/civicrm-core/pull/17064))**
+  This updates the help text on CiviMail attachments to specify the maximum size
+  of each attachment.
 
-  Changes the bcc field on all email forms to use an entity reference
-  field. This simplifies the code and extends filtering on the field.
+- **Convert CC and BCC fields to use an entity reference.
+  ([17064](https://github.com/civicrm/civicrm-core/pull/17064) and [17129](https://github.com/civicrm/civicrm-core/pull/17129))**
 
-- **Switch cc field on emailTrait to use entity reference
-  ([17129](https://github.com/civicrm/civicrm-core/pull/17129))**
-
-  Changes the cc field on all email forms to use an entity reference
-  field. This simplifies the code and extends filtering on the field.
+  The CC and BCC fields on all email forms are now entity references to the
+  email ID. This simplifies the code and extends filtering on the field.
 
 - **Introduce "civi.dao.preUpdate" and "civi.dao.preInsert" events
-  ([dev/core#1638](https://lab.civicrm.org/dev/core/-/issues/1638):
+  ([dev/core#1638](https://lab.civicrm.org/dev/core/issues/1638):
   [16714](https://github.com/civicrm/civicrm-core/pull/16714))**
 
   Makes it possible to use a hook to inspect the data of an Option Value prior
@@ -114,19 +111,21 @@ Released June 3, 2020
 - **Add ID to custom group/field admin forms
   ([17055](https://github.com/civicrm/civicrm-core/pull/17055))**
 
-  Exposes custom field/group IDs on admin forms.
+  The ID numbers are displayed in the tables of custom fields and groups.
 
 - **Improve AngularJS performance with one-time binding for static strings
   ([17050](https://github.com/civicrm/civicrm-core/pull/17050))**
 
-  Improves performance of AngularJS forms.
+  This improves performance of AngularJS pages and forms by having the
+  translation function only execute once when the translated string is static.
 
 - **Allow setting metadata to use the `table` option. Update example setting
   `default_invoice_page`.
   ([16903](https://github.com/civicrm/civicrm-core/pull/16903))**
 
-  Adds a new option to setting metadata "table" and an example of how tot use
-  it.
+  Setting metadata that refers to an entity can now be defined with reference to
+  a database table, specifying the key and label columns, rather than requiring
+  a pseudoconstant function to populate the options.
 
 - **Add / make fit for purpose email.getlist api call
   ([16993](https://github.com/civicrm/civicrm-core/pull/16993))**
@@ -188,7 +187,7 @@ Released June 3, 2020
 ### Core CiviCRM
 
 - **How best to handle Event Dispatchers during upgrade (Work Towards
-  [dev/core#1460](https://lab.civicrm.org/dev/core/-/issues/1460):
+  [dev/core#1460](https://lab.civicrm.org/dev/core/issues/1460):
   [17127](https://github.com/civicrm/civicrm-core/pull/17127) and
   [17216](https://github.com/civicrm/civicrm-core/pull/17216))**
 
@@ -197,40 +196,54 @@ Released June 3, 2020
   updates a related test.
 
 - **After core upgrade, extension routes unavailable
-  ([dev/core#1460](https://lab.civicrm.org/dev/core/-/issues/1460) and
-  [dev/core#1713](https://lab.civicrm.org/dev/core/-/issues/1713)
+  ([dev/core#1460](https://lab.civicrm.org/dev/core/issues/1460) and
+  [dev/core#1713](https://lab.civicrm.org/dev/core/issues/1713)
   [17126](https://github.com/civicrm/civicrm-core/pull/17126))**
 
 - **Report Dev tab display SQL multiple times
-  ([dev/core#1673](https://lab.civicrm.org/dev/core/-/issues/1673):
+  ([dev/core#1673](https://lab.civicrm.org/dev/core/issues/1673):
   [17001](https://github.com/civicrm/civicrm-core/pull/17001))**
 
 - **Namespaced classes cannot contain an underscore
-  ([dev/core#1684](https://lab.civicrm.org/dev/core/-/issues/1684):
+  ([dev/core#1684](https://lab.civicrm.org/dev/core/issues/1684):
   [17105](https://github.com/civicrm/civicrm-core/pull/17105))**
 
   Allows underscores in class names.
 
 - **Search builder returns DB error on Group => Empty filter
-  ([dev/core#1685](https://lab.civicrm.org/dev/core/-/issues/1685):
+  ([dev/core#1685](https://lab.civicrm.org/dev/core/issues/1685):
   [16953](https://github.com/civicrm/civicrm-core/pull/16953))**
 
-- **Financial ACL Report check always fails
-  ([dev/core#1700](https://lab.civicrm.org/dev/core/-/issues/1700):
-  [17046](https://github.com/civicrm/civicrm-core/pull/17046))**
+- **Allow override of inherited CMS language when in CiviCRM
+  ([17006](https://github.com/civicrm/civicrm-core/pull/17006))**
 
-  Ensures that if Finacial Type ACL's are enabled and the extension
-  `biz.jmaconsulting.financialaclreport` is installed the warning that you need
-  to install the extension is not displayed.
+  This ensures that the language switcher can be used in CiviCRM even when the
+  default language is set to inherit from the user's CMS session.
 
 - **Longitude not checked out of box
-  ([dev/core#1739](https://lab.civicrm.org/dev/core/-/issues/1739):
+  ([dev/core#1739](https://lab.civicrm.org/dev/core/issues/1739):
   [17238](https://github.com/civicrm/civicrm-core/pull/17238))**
 
   Enables the Longitude field on Address Editing by default for new installs.
 
+- **Export selected fields doesn't export related contacts if related info is
+  present in mapping
+  ([dev/core#1780](https://lab.civicrm.org/dev/core/issues/1780):
+  [17462](https://github.com/civicrm/civicrm-core/pull/17462))**
+
+  This fixes a bug where exporting a child and their parent was only resulting
+  in one row being exported when the related contact id was selected.
+
+- **Regression: Fails to create smartgroup or refresh count of group
+  ([dev/core#1747](https://lab.civicrm.org/dev/core/issues/1747):
+  [17438](https://github.com/civicrm/civicrm-core/pull/17438))**
+
+  The temporary table created for smart groups involving the Date Added custom
+  search was removed too aggressively, resulting in database errors when
+  searching or refreshing the smart group count.
+
 - **Contact restore from trash not working
-  ([dev/core#1784](https://lab.civicrm.org/dev/core/-/issues/1784):
+  ([dev/core#1784](https://lab.civicrm.org/dev/core/issues/1784):
   [17418](https://github.com/civicrm/civicrm-core/pull/17418))**
 
 - **[regression] Fix error on no MIME type
@@ -244,7 +257,7 @@ Released June 3, 2020
   ([17262](https://github.com/civicrm/civicrm-core/pull/17262))**
 
 - **API explorer fatal joining to contribution from contact
-  ([dev/core#1563](https://lab.civicrm.org/dev/core/-/issues/1563):
+  ([dev/core#1563](https://lab.civicrm.org/dev/core/issues/1563):
   [17239](https://github.com/civicrm/civicrm-core/pull/17239))**
 
 - **APIv4 - Prevent field alias conflicts.
@@ -313,9 +326,11 @@ Released June 3, 2020
   Ensures import mappings populate contact sub-type custom fields.
 
 - **set is_deceased to not null in schema and upgrade script
-  ([dev/core#1697](https://lab.civicrm.org/dev/core/-/issues/1697):
+  ([dev/core#1697](https://lab.civicrm.org/dev/core/issues/1697):
   [17025](https://github.com/civicrm/civicrm-core/pull/17025))**
 
+  This removes the possibility of having undead contacts.
+
 - **Allow adding variables to CRM.vars in any region
   ([16888](https://github.com/civicrm/civicrm-core/pull/16888))**
 
@@ -336,36 +351,23 @@ Released June 3, 2020
 
   Ensures that the `hook_civicrm_tokenValues` is passed the proper values.
 
-### CiviContribute
-
-- **Contribution Detail Report gives incorrect results when `force=1`
-  ([dev/report#20](https://lab.civicrm.org/dev/report/-/issues/20):
-  [17234](https://github.com/civicrm/civicrm-core/pull/17234))**
-
-- **On Behalf Of fails to populate in Email Receipt
-  ([dev/core#57](https://lab.civicrm.org/dev/core/-/issues/57):
-  [17026](https://github.com/civicrm/civicrm-core/pull/17026))**
-
-  Fixes a bug where the On Behalf Of section was not being included in email
-  receipts.
-
-- **Fixes a regression when cancelling a recurring with no processor_id
-  ([17292](https://github.com/civicrm/civicrm-core/pull/17292))**
-
-- **Fix multiselect/checkbox custom field defaults on contribution online form
-  ([16991](https://github.com/civicrm/civicrm-core/pull/16991))**
+- **Fix slowness in opening the select fields for export screen after an advanced search
+  ([dev/core#1725](ttps://lab.civicrm.org/dev/core/-/issues/1725):
+  [17444](https://github.com/civicrm/civicrm-core/pull/17444))**
+  Fixes a recent regression following the updating of the select fields export UI which on certain
+  sites slowed down the loading of the select fields screen significantly
 
 ### CiviCase
 
 - **Invalid and patchy XML encoding causes Case crash if status is not valid XML
-  ([dev/core#1719](https://lab.civicrm.org/dev/core/-/issues/1719):
+  ([dev/core#1719](https://lab.civicrm.org/dev/core/issues/1719):
   [17100](https://github.com/civicrm/civicrm-core/pull/17100))**
 
   Fixes a bug where CiviCase would fail to fully create a CaseType if a Case
   Status' name was invalid in an XML context.
 
 - **Case.get API returning Case Clients As Part of Related Contacts
-  ([dev/core#1659](https://lab.civicrm.org/dev/core/-/issues/1659):
+  ([dev/core#1659](https://lab.civicrm.org/dev/core/issues/1659):
   [16837](https://github.com/civicrm/civicrm-core/pull/16837))**
 
 - **Convert fatals to statusBounces in case forms
@@ -380,6 +382,33 @@ Released June 3, 2020
   Ensures that the details field value is saved when creating a new case from
   the core form.
 
+### CiviContribute
+
+- **Contribution Detail Report gives incorrect results when `force=1`
+  ([dev/report#20](https://lab.civicrm.org/dev/report/issues/20):
+  [17234](https://github.com/civicrm/civicrm-core/pull/17234))**
+
+- **Financial ACL Report check always fails
+  ([dev/core#1700](https://lab.civicrm.org/dev/core/issues/1700):
+  [17046](https://github.com/civicrm/civicrm-core/pull/17046))**
+
+  Ensures that if Finacial Type ACL's are enabled and the extension
+  `biz.jmaconsulting.financialaclreport` is installed the warning that you need
+  to install the extension is not displayed.
+
+- **On Behalf Of fails to populate in Email Receipt
+  ([dev/core#57](https://lab.civicrm.org/dev/core/issues/57):
+  [17026](https://github.com/civicrm/civicrm-core/pull/17026))**
+
+  Fixes a bug where the On Behalf Of section was not being included in email
+  receipts.
+
+- **Fixes a regression when cancelling a recurring with no processor_id
+  ([17292](https://github.com/civicrm/civicrm-core/pull/17292))**
+
+- **Fix multiselect/checkbox custom field defaults on contribution online form
+  ([16991](https://github.com/civicrm/civicrm-core/pull/16991))**
+
 ### CiviEvent
 
 - **Fix multiselect/checkbox custom field defaults on registration profile
@@ -388,13 +417,13 @@ Released June 3, 2020
 ### CiviMail
 
 - **Mailing Error when civicrm_mailing_group has duplicate entries of recipient
-  groups([dev/mail#62](https://lab.civicrm.org/dev/mail/-/issues/62):
+  groups([dev/mail#62](https://lab.civicrm.org/dev/mail/issues/62):
   [17130](https://github.com/civicrm/civicrm-core/pull/17130))**
 
 ### CiviMember
 
 - **membership batch entry: fix join date population
-  ([dev/core#1718](https://lab.civicrm.org/dev/core/-/issues/1718):
+  ([dev/core#1718](https://lab.civicrm.org/dev/core/issues/1718):
   [17099](https://github.com/civicrm/civicrm-core/pull/17099))**
 
   Ensures that when using the membership batch entry tool the "join date" is
@@ -406,7 +435,7 @@ Released June 3, 2020
 ### Drupal Integration
 
 - **UF Settings page doesn't show CiviCRM database details for Drupal 8 Views
-  ([dev/core#1742](https://lab.civicrm.org/dev/core/-/issues/1742):
+  ([dev/core#1742](https://lab.civicrm.org/dev/core/issues/1742):
   [17232](https://github.com/civicrm/civicrm-core/pull/17232))**
 
 ### WordPress Integration
@@ -419,33 +448,34 @@ Released June 3, 2020
   Ensures clean URLs work in WordPress with Polylang.
 
 - **Fix WordPress support for Get UF Locale
-  ([dev/core#1635](https://lab.civicrm.org/dev/core/-/issues/1635):
+  ([dev/core#1635](https://lab.civicrm.org/dev/core/issues/1635):
   [16700](https://github.com/civicrm/civicrm-core/pull/16700))**
 
   Ensures WordPress front end pages follow the CMS language set in CiviCRM
   instead of using the default CiviCRM language.
 
 - **Styling issues after upgrade to WordPress 5.3
-  ([dev/wordpress#46](https://lab.civicrm.org/dev/wordpress/-/issues/46):
+  ([dev/wordpress#46](https://lab.civicrm.org/dev/wordpress/issues/46):
   [16882](https://github.com/civicrm/civicrm-core/pull/16882))**
 
   Ensures Select fields look like Select2 fields for WordPress users.
 
 - **CiviCRM front end pages broken on WP Latest (master)
-  ([dev/wordpress#49](https://lab.civicrm.org/dev/wordpress/-/issues/49):
+  ([dev/wordpress#49](https://lab.civicrm.org/dev/wordpress/issues/49):
   [17352](https://github.com/civicrm/civicrm-core/pull/17352),
-  [199](https://github.com/civicrm/civicrm-wordpress/pull/199) and
+  [17424](https://github.com/civicrm/civicrm-core/pull/17424),
+  [199](https://github.com/civicrm/civicrm-wordpress/pull/199), and
   [194](https://github.com/civicrm/civicrm-wordpress/pull/194))**
 
   `canonical_redirect()` will strip "page=CiviCRM" from front end pages. These
   changes ensures that CiviCRM plays nicely with this WordPress change.
 
 - **Public mailing URL links are broken after merge of REST API wrapper code
-  ([dev/wordpress#52](https://lab.civicrm.org/dev/wordpress/-/issues/52):
+  ([dev/wordpress#52](https://lab.civicrm.org/dev/wordpress/issues/52):
   [195](https://github.com/civicrm/civicrm-wordpress/pull/195))**
 
 - **CiviMail doesn't send to full recipient list with merge of REST API wrapper
-  code ([dev/wordpress#53](https://lab.civicrm.org/dev/wordpress/-/issues/53):
+  code ([dev/wordpress#53](https://lab.civicrm.org/dev/wordpress/issues/53):
   [196](https://github.com/civicrm/civicrm-wordpress/pull/196))**
 
 ## <a name="misc"></a>Miscellany
@@ -487,7 +517,7 @@ Released June 3, 2020
   ([17227](https://github.com/civicrm/civicrm-core/pull/17227))**
 
 - **Misplaced text in the Additional Details section on New Contribution
-  ([dev/user-interface#19](https://lab.civicrm.org/dev/user-interface/-/issues/19):
+  ([dev/user-interface#19](https://lab.civicrm.org/dev/user-interface/issues/19):
   [17135](https://github.com/civicrm/civicrm-core/pull/17135))**
 
 - **Cleanup and throw exceptions in OpenCase form
@@ -761,7 +791,7 @@ Andrew Cormick-Dockery; Andy Burns; Artful Robot - Rich Lott;  Blackfly
 Solutions - Alan Dixon; CiviCoop - Jaap Jansma; Fuzion - Peter Davis; GMCVO
 Databases - Jade Gaunt; JMA Consulting - Monish Deb; MJCO - Mikey O'Toole;
 Richard van Oosterhout; Squiffle Consulting - Aidan Saunders;
-Tadpole Collective - Kevin Cristiano; Team Expansion - Greg Harris;
+Tadpole Collective - Kevin Cristiano; Team Expansion - Greg Harris
 
 ## <a name="feedback"></a>Feedback