ADF Release Notes v2.4.1
Overview
The Application Development Framework (ADF) version 2.4.1 release contains enhancements and bug fixes to core ADF 2.4 functionality.
Version Compatibility
This version of the ADF is compatible with CommonSpot 10 up to 10.5.1, and 10.6
If your site is running CommonSpot 10 or greater and is using a previous build of ADF v2.x, please upgrade to the release version of ADF 2.4.1! If you are upgrading to CommonSpot 10 or greater and have ADF 1.8.x or older installed, at least ADF 2.0 is required, but upgrading to ADF 2.4.1 is recommended.
ADF 1.8.x and older versions of the ADF are not compatible with CommonSpot 10.x. Please note if your site is running CommonSpot 9 or older you will need to use the ADF 1.8.1 release or 1.8.2 development builds.
Field Type CFCs
CommonSpot 10 and above, requires that all Custom Field Type Render modules be converted to be a CFC versus a CFM module. See the ADF 2.0 release notes for more information regarding CFC render modules built for the ADF 2.x releases.
Resource Loading
CommonSpot 10 introduces a new Resource Loading Framework to help efficiently load JavaScript and CSS resources. See the
ADF 2.0 release notes for more information regarding using CommonSpot Resource Loading with ADF 2.x releases.
For detailed information about the Resource Loading Framework, see the CommonSpot Developer's Guide.
Installation/Upgrade
For detailed instructions for installing the ADF, see the ADF Installation Guide.
For detailed instructions for upgrading from a previous version of the ADF, see the
ADF v2.4.1 Upgrade Guide.
If you are upgrading from an earlier release, we strongly recommend that you also read the following:
Notable Enhancements
The ADF 2.4.1 release contains the following significant enhancements.
General
- Updated to harden security for lib functions that use form, url and request.params variables.
Library Components
- Added a new pass-through function data_2_0.filterInternationalChars for data_1_2.filterInternationlChars with new parameters replaceSpaces, replaceSpaceChar, replaceQuotes and replaceQuoteChar.
- Updated the data_2_0.trimStringByWordCount function to remove HTML tags before counting and trimming the string.
- Updated data_1_0.trimStringByWordCount to add a parameter to remove html tags from string before counting and trimming.
- Updated csData_2_0.parseCSExtURLProps to use the updated CommonSpot JavaScript new window function csExtendedWindow().
- Updated csData_1_2.createUniquePageInfofromPageTitle to add a parameter to define a custom title suffix for the first unique title attempt.
- Updated the forms_1_0.renderAddEditForm ceData call to use variables.ceData.
- Updated forms_1_1.verifyCFFormProtect local function call to call directly instead of via application.ADF.forms.
- Updated ceData_2_0.buildCEDataArrayFromQuery to move the getCEFieldNameData call from forms_1_0 to the local ceData_1_0.
- Updated the utils_2_0.doSimpleDump function to handle additional data types.
Custom Field Types
- Added an install script to register the required resources for Custom Element DataManager CFT.
Notable Updates
The following notable updates were in this release:
Library Components
- Fixed issue with the taxonomy_1_1.getTopTermsQueryForFacet function by updating the getTopTerms query to return the correct results.
- Updated csData_1_0.serializedFormStringToStruct to use ceData_1_0.getCEFieldNameData instead of the form_1_0 version to fix issues with circular references with the Forms and ceData components.
Updated ADF Applications
The following ADF applications were also updated as part of the ADF 2.4.1 release. Please check the release notes for these apps for details.