ADF Release Notes v2.6.2

Overview

The Application Development Framework (ADF) version 2.6.2 release contains enhancements and bug fixes to core ADF 2.6,1 functionality.

Version Compatibility

This 2.6.2 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.6.4, 10.7.2 or 10.8.1 and ADF 2.6.2!


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.2 Upgrade Guide.

If you are upgrading from an earlier release, we strongly recommend that you also read the following:

2.0.0 Release Notes

2.0.1 Release Notes

2.3.0 Release Notes

2.3.1 Release Notes

2.4.0 Release Notes

2.4.1 Release Notes

2.5.0 Release Notes

2.6.0 Release Notes

2.6.1 Release Notes

Previous ADF version Release Notes

Notable Enhancements

The ADF 2.6.2 release contains the following significant enhancements.

General

  • SiteBase
  • Added outputInstallScripts, doBackup, and verboseOutput arguments to the initADFinstaller function to allow them to pass-through to the registerScripts sub-function call

Library Components

  • csData
  • Added a getCsGroupUsersQry function to return a query of CS User Group Members for all Groups ID in the list Updated the logging for CSFile function to log better information about the arguments used when an error is thrown.

ThirdParty

  • Added Bootbox 5.5 resources

  • Added Bootstrap 5.1.3 resources

  • Added Popper 1.16 and 2.9 resources

  • Added Owl Carousel 2.3 resources

  • Added FontAwesome 5.15 resources

  • Added FontAwesome 6.0.0 resources

  • Added Line Awesome 1.3.0 resources

Notable Updates

The following notable updates were in this release:

Library Components

  • Scripts
  • Updated the allScripts.cfm resource data file with thirdParty resources library updates. Bootstrap 5.1, Bootstrap 5.1 bundle, Popper 2.9, Bootbox 5.5, FontAwesome 6.0 & 5.15, Line Awesome 1.3

  • Utils
  • Converted the CFPDF call in the getThumbnailOfResource function to cfscript for better compatibility with ACF and Lucee

ThirdParty

  • Updated Bootstrap 5.0.1 resources

  • Updated moment.js 2.29.1 resources

Extensions

  • Custom Fields
  • Updated the Custom Element Select Field CFT to handle the selecting of saved items when the option value has commas for both Single and Multi-Select modes.

  • Updated the readme doc files for the FileUploader CFT to better clarify setting up the site level fileUploader custom component.

Updated ADF Applications

The following ADF applications were also updated as part of the ADF 2.6.2 release. Please check the release notes for these apps for details.