5.40.0 release notes: added late changes
[civicrm-core.git] / release-notes / 5.26.0.md
index 15d2be736eec256e2f3834cb3dc325ae0a5f6b63..fb14636dac58d80bdc36b637f18adc42cf4891c0 100644 (file)
@@ -47,7 +47,7 @@ Administrators should promptly assess and update any external services which sub
   Gives more flexibility about how options are returned from APIv4 and adds
   visibility in the API explorer.
 
-- **APIv4 - how do I interact with option values???
+- **APIv4 - How do I interact with option values?
   ([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
@@ -55,7 +55,7 @@ Administrators should promptly assess and update any external services which sub
 
   Adds support for pseudoconstants to APIv4.
 
-- **Add MessageTemplate api to v4
+- **APIv4 - Add MessageTemplate API
   ([17073](https://github.com/civicrm/civicrm-core/pull/17073))**
 
   Adds new "MessageTemplate" entity to APIv4.
@@ -63,52 +63,43 @@ Administrators should promptly assess and update any external services which sub
 - **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
+- **APIv4 Query Improvements (Work Towards
   [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):
   [17261](https://github.com/civicrm/civicrm-core/pull/17261))**
 
-  Adds a deprecation notice for Systems using MySQL versions before 5.7 and
+  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
+- **Allow inline help text title to be overriden
   ([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. .
+- **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.
+  This updates the help text on CiviMail attachments to specify the maximum size
+  of each attachment.
 
-- **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))**
-
-  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):
@@ -120,19 +111,21 @@ Administrators should promptly assess and update any external services which sub
 - **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))**
@@ -168,13 +161,13 @@ Administrators should promptly assess and update any external services which sub
   Adds the contributor email to the Cancel Recurring Contribution form so it is
   clear who will be notified.
 
-- **add filter and sorting for receipt date in contribution report
+- **Add filter and sorting for receipt date in contribution report
   ([17044](https://github.com/civicrm/civicrm-core/pull/17044) and
   [16994](https://github.com/civicrm/civicrm-core/pull/16994))**
 
   Adds a filter and sorting for "receipt date" to Contribution Reports.
 
-- **Capitalise PAN truncation
+- **Capitalise "PAN Truncation"
   ([16973](https://github.com/civicrm/civicrm-core/pull/16973) and
   [16964](https://github.com/civicrm/civicrm-core/pull/16964))**
 
@@ -202,11 +195,15 @@ Administrators should promptly assess and update any external services which sub
   that can be used to dynamically toggle support for specific events/hooks and
   updates a related test.
 
-- **After core upgrade, extension routes unavailable
+- **After core upgrade, extensions are not fully active
   ([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#1713](https://lab.civicrm.org/dev/core/issues/1713):
   [17126](https://github.com/civicrm/civicrm-core/pull/17126))**
 
+  After performing a core upgrade, some extension functionality (e.g. routing) was
+  temporariliy unavailable - and required a flush. This fix changes the way in which
+  hooks and caches are managed during the upgrade.
+
 - **Report Dev tab display SQL multiple times
   ([dev/core#1673](https://lab.civicrm.org/dev/core/issues/1673):
   [17001](https://github.com/civicrm/civicrm-core/pull/17001))**
@@ -221,13 +218,11 @@ Administrators should promptly assess and update any external services which sub
   ([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):
@@ -284,35 +279,30 @@ Administrators should promptly assess and update any external services which sub
   Fixes a bug whereby the merge script alters non-contact entity tags, changing
   the entity they are related to.
 
-- **show title on status message instead of machine name
+- **Show title on status message instead of machine name
   ([17174](https://github.com/civicrm/civicrm-core/pull/17174))**
 
 - **Do not create smarty cached templates for processed greetings
   ([16733](https://github.com/civicrm/civicrm-core/pull/16733))**
 
-- **Add contribution id as activity source record when downloading or emailing
+- **Add contribution ID as activity source record when downloading or emailing
   invoice ([17165](https://github.com/civicrm/civicrm-core/pull/17165))**
 
   Ensures that the Activity Source ID field is populated correctly for
   Activities of the type "Emailed Invoice" and "Downloaded Invoice".
 
-- **Correct option_group pseudoconstant and regenerate dao
+- **Correct option_group pseudoconstant and regenerate DAO
   ([17166](https://github.com/civicrm/civicrm-core/pull/17166))**
 
   Fixes metadata for option_group pseudoconstant list so that labels are visible
   in the list.
 
-- **Update Colmbra state/province to Coimbra
+- **Update "Colmbra" state/province to "Coimbra"
   ([17106](https://github.com/civicrm/civicrm-core/pull/17106) and
   [17136](https://github.com/civicrm/civicrm-core/pull/17136))**
 
   Fixes up some Portugal Province labels.
 
-- **Archive text ([17074](https://github.com/civicrm/civicrm-core/pull/17074))**
-
-  Updates the intro text to archive contrib.txt in favor of recognizing
-  contributors via the release notes.
-
 - **Fix 'selectedChild' parameter for pages with tabs
   ([17066](https://github.com/civicrm/civicrm-core/pull/17066))**
 
@@ -329,15 +319,17 @@ Administrators should promptly assess and update any external services which sub
 
   Reduces code complexity & locking queries when merging contacts.
 
-- **fixed mapping when using custom field for contact sub type
+- **Fixed mapping when using custom field for contact sub type
   ([16957](https://github.com/civicrm/civicrm-core/pull/16957))**
 
   Ensures import mappings populate contact sub-type custom fields.
 
-- **set is_deceased to not null in schema and upgrade script
+- **Set is_deceased to not null in schema and upgrade script
   ([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))**
 
@@ -364,25 +356,6 @@ Administrators should promptly assess and update any external services which sub
   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
 
-### 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))**
-
 ### CiviCase
 
 - **Invalid and patchy XML encoding causes Case crash if status is not valid XML
@@ -408,6 +381,33 @@ Administrators should promptly assess and update any external services which sub
   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
@@ -421,7 +421,7 @@ Administrators should promptly assess and update any external services which sub
 
 ### CiviMember
 
-- **membership batch entry: fix join date population
+- **Membership batch entry: Fix join date population
   ([dev/core#1718](https://lab.civicrm.org/dev/core/issues/1718):
   [17099](https://github.com/civicrm/civicrm-core/pull/17099))**
 
@@ -479,6 +479,11 @@ Administrators should promptly assess and update any external services which sub
 
 ## <a name="misc"></a>Miscellany
 
+- **CONTRIBUTORS.txt - Explain deprecation/archival ([17074](https://github.com/civicrm/civicrm-core/pull/17074))**
+
+  Contributors are now recognized in release notes. To ensure a full history,
+  the older `CONTRIBUTORS.txt` has been preserved, but it will not be updated for future releases.
+
 - **Use isSerialized function rather guessing from html_type
   ([16979](https://github.com/civicrm/civicrm-core/pull/16979))**
 
@@ -773,7 +778,7 @@ Administrators should promptly assess and update any external services which sub
 This release was developed by the following code authors:
 
 a-n The Artists Information Company - William Mortada; AGH Strategies - Alice
-Frumin, Andrew Hunt; Andrei Mondoc; Christian Wach; Circle Interactive - Dave
+Frumin, Andie Hunt; Andrei Mondoc; Christian Wach; Circle Interactive - Dave
 Jenkins, Pradeep Nayak; CiviCRM - Coleman Watts, Josh Gowans, Tim Otten;
 CiviDesk - Yashodha Chaku; Coop SymbioTIC - Mathieu Lutfy; Dave D; Fuzion -
 Jitendra Purohit; Greenpeace Central and Eastern Europe - Patrick Figel; All In
@@ -790,10 +795,10 @@ 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
 
-These release notes are edited by Alice Frumin and Andrew Hunt.  If you'd like
+These release notes are edited by Alice Frumin and Andie Hunt.  If you'd like
 to provide feedback on them, please log in to https://chat.civicrm.org/civicrm
 and contact `@agh1`.