ADF Release Notes v2.6.1

Overview

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

Version Compatibility

This 2.6.1 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.3, 10.7.1 or 10.8 and ADF 2.6.1!


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.1 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

Previous ADF version Release Notes

Notable Enhancements

The ADF 2.6 release contains the following significant enhancements.

General

  • In ajaxProxy and lightboxProxy added the subsiteID parameter so the subsiteURL can be determined to load the lightbox in the subsite's application context.

Library Components

  • Added the castQueryColumn method() to data_2_0.

  • Added a metadataConvertImageFieldValueToImageID() function to csData_2_0 to convert custom metadata CS image path to the imageID for re-saving back to the page's custom metadata

  • Updated the csData_1_3.getCSObjectType method to return 'subsite' as a object type

  • Added getSubsiteMetadata method to csData_1_3.

  • Added getSubsiteMetadataByCsPageID method to csData_1_3.

  • Added a version parameter to resourceService_1_0.getAllScriptsData method.

  • Added the countDown method to date_2_0.

  • Added countDownText method to date_2_0.

  • Added the safeUrlRedirect method to utils_2_0

Extensions

  • Updated the Custom Element Select field properties dialog, field selection lists to display the field name in absence of a field label for selecting a display and value field.

  • Updated the Custom Element Select field properties dialog, for the display and value field selection lists, added the field type to the element field names when the field is some type of hidden field.

ThirdParty

  • Added ThirdParty Resources:

    • jQuery 3.6.0

    • Bootstrap 4.6.0

    • Bootstrap 5.0.0

    • Font Awesome 5.15.3

    • jQueryUI 1.12 (for jQuery 3.5.1 and above)

Notable Updates

The following notable updates were in this release:

Library Components

  • Updated parseCSURL() method in csData_1_2 to handle the changed data struct that returns from CS 10.7. A jump link (e.g. #internallink) can now be part of the data and we check to see if it exists and handle it accordingly
  • Updated the listRemoveDuplicates() in data_1_0 to be a pass-through function since both ACF 10+ and Lucee 4.5+ have a listRemoveDuplicates function (with a new ignoreCase parameter defaulting to true)
  • Added encodeForHTML() around the output of the data values in the ceData_3_0.formatDataForGceArchivePostImport method.

Extensions

  • Removed the Grid and Reboot files from the Bootstrap 4.5 folder.
  • Removed the 'themeName=inputParameters.uiTheme' parameter from the loadJQueryUI() calls in the date_picker, file_uploader, general_chooser, object_list_builder, star_rating, subsite_select, and time_picker CFTs since UI theme loading is no longer be controlled by the CFT properties.

Updated ADF Applications

The following ADF application was also updated as part of the ADF 2.6.1 release. Please check the release notes for these apps for details.