ADF Release Notes v2.6.3
Overview
The Application Development Framework (ADF) version 2.6.3 release contains enhancements and bug fixes to core ADF 2.6,2 functionality.
Version Compatibility
This 2.6.3 version of the ADF is ONLY compatible with CommonSpot 10.5.2 or 10.6.1 or higher.
If your site is running CommonSpot 10 up to 10.5.1 or 10.6 please use ADF 2.4.x, however we strongly recommend upgrading to CommonSpot 10.7.3, 10.8.2 or 10.9 and ADF 2.6.3!
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.
ADF AjaxProxy CSRF Safe Mode
CommonSpot 10.5.2 and 10.6.1 introduced robust security enhancements to mitigate CSRF vulnerabilities but adding CSRF Token validation to it's form submits as well its internal /loader.cfm requests.
To complement these security enhancements, ADF 2.5 and above and the ADF companion Apps have also be updated to add CSRF validation to its custom forms, internal CommonSpot /loader.cfm requests as well as its own /ajaxProxy.cfm requests.
However, due to the flexibility and customizability of the ADF and the ADF Applications, specifically the powerful ajaxProxy feature, the CSRF attack prevention validation has been disabled by default. It can be enabled when all custom ajaxProxy requests have been updated to take advantage of this security feature.
For more information see the ADF AjaxProxy CSRF Safe Mode documentation regarding enabling the security enhancement.
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.6.3 Upgrade Guide.
If you are upgrading from an earlier release, we strongly recommend that you also read the following:
Notable Enhancements
The ADF 2.6.3 release contains the following significant enhancements.
General
Added the apiSubsite_1_0 to the list of loaded library components.
Extensions
Updated the Custom Element Select Field to remove deprecated jQuery.fn.hover() function call.
Updated with the Bootstrap Glyphicon Select Custom Field Type to use the standand alone Bootstrap 3.4 Glyphicon name list.
Adding the error-page-expired.cfm and the error-page-inactive.cfm template files to the Hooks folder.
Library Components
Added the create and createRemote subsite functions to the apiSubsite component.
Updated the deleteCE() function (for CommonSpot versions before 10.9, 10.8.2, 10.7.3, 10.6.5) to run the pre-delete-fromrecord-hook.cfm and post-delete-fromrecord-hook.cfm files when added to the root of the site. The pre and post hook files will run once for each Global Custom Element (FormID) represented by the provided page IDs.
Added a function splitArrayIntoGroups() that splits the given array into separate arrays based on a max length value.
Added a function to stripWhiteSpace to remove whitespace from a string via RegEx.
Added logic to only allow registerAllScripts.cfm to run on CommonSpot Authoring or Stand-Alone (non-ROPS) servers.
Updated getAllScripts() method in the resourceService_1_0 component to take a scriptsDataVersion parameter.
Updated to better handling for the loading of a local override files. Local file can have a custom name and be a properly formatted JSON file.
Updated allScripts.cfm data file by adding and updating definitions for jQuery 3.6.1, jQueryMigrate 3.4, jQueryMobile 1.4.5, Bootstrap 5.2.1, BootBox 5.5.3, FontAwesome 6.2, FontAwesome 6.1 and jQueryDataTables 1.12.1.
Updated the allScripts.cfm resource loader data file to add the updated jQuery IU.Stars.pt version.
Updated the allScripts.cfm Resource data file list to adding a unique ID to each entry to allow for better resource management.
Added logic to the doDump method to allow the CSS formatting to be added to the dump output when the returnInVar is true.
Added the create and createRemote subsite functions to the apiSubsite component.
ThirdParty
Updated jQuery 3.6.0 to v3.6.1.
Added the v3.4.0 version of jQuery Migrate.
Added FontAwesome 6.1 and 6.2 files.
Updated FontAwesome 6.1 files to v6.1.2.
Added the 1.12.1 version of DataTables.
Added the missing images to the DataTables 1.10 library.
Added the v5.2.0 version of Bootstrap
Updated Bootstrap 5.2 to v5.2.1.
Updated the 5.0.1 version of Bootstrap to v5.0.1.
Updated the 4.6.0 version of Bootstrap to v4.6.2.
Updated the 4.5.2 version of Bootstrap to v4.5.3.
Updated the 1.13.1 version of jQueryUI to v1.13.2.
Updated the 5.5.2 version of Bootbox to v5.5.3.
Updated the PopperJS to v2.9.3
Added the PopperJS v2.10 and v2.11
Created a v3.1.pt version of the UI.Stars 3.0.1 jQueryUI library to remove deprecated functions.
Notable Updates
The following notable updates were in this release:
General
Updated the ADF Build process to allow the cfdump CSS formatting to be added to the ADF error log file output
Extensions
Updated the CCAPI_dump debug custom script to detect if http/https and then set the correct scheme for the webserviceURL.
Resolved an issue with the Custom Element Select Custom Field Type where in some cases the "-- select --" option was displaying at the bottom of the list.
Library Components
Updated the apiRemote_1_0.runCmdApi method to add the cfhttp result's first item in the array (eg. the error message text) to the return structure.
Removed a WriteDump from the apiImage.createFromData component.
Resolved issue in the /data/1.0/allScripts.cfm data file with DataTables 1.10: Bootstrap 3 resource definition listing the CDN JS and CSS resources in the wrong sections.
Resolved an issue in the minimumVersionCheck() function where if the minimumVersionsList has more than 2 versions the lowest version would allow all of the higher versions to return a value of true.
Updated ADF Applications
The following ADF applications were also updated as part of the ADF 2.6.3 release. Please check the release notes for these apps for details.