1.x.x -> 2.x.x
) will most likely contain breaking changes which will require evaluation of your codebase. Minor version changes (e.g, 1.3.x->1.4.x
) will often contain new functionality, but in a backwards-compatible manner, and maintenance releases (e.g 1.4.4 -> 1.4.5
) will just be trying to fix bugs.wheels
folder, especially for those small maintenance releases: however, there are usually exceptions in minor point releases (i.e, 1.1
to 1.3
required replacing other files outside the wheels
folder). The notes below detail those changes.wheels
folder with the new one from the 2.3.0 download.wheels
folder with the new one from the 2.2.0 download.wheels
folder with the new one from the 2.1.0 download.findLast()
to findLastOne()
/events/onabort.cfm
to support the onAbort
methodwheels
folder with the new one from the 2.0 download.events/functions.cfm
file has been moved to global/functions.cfm
.models/Model.cfc
file should extend wheels.Model
instead of Wheels
(models/Wheels.cfc
can be deleted).controllers/Controller.cfc
file should extend wheels.Controller
instead of Wheels
(controllers/Wheels.cfc
can be deleted).init
function of controllers and models must be renamed to config
.modelRequireInit
has been renamed to modelRequireConfig
.cacheControllerInitialization
has been renamed to cacheControllerConfig
.cacheModelInitialization
has been renamed to cacheModelConfig
.clearServerCache
has been renamed to clearTemplateCache
.updateProperties()
method has been removed, use update()
instead.confirm
and disable
have been removed from the link and form helper functions (use the JS Confirm and JS Disable plugins to reinstate the old behaviour).renderPage
function has been renamed to renderView
includePartial()
now requires the partial
and query
arguments to be set (if using a query)[controller]/[action]/[key]
) is available as [controller]/[action]
) if you use the new wildcard() mapper method:GET
requests for security reasons.POST
data to your application to pass the authenticityToken
from the <meta>
tags generated by csrfMetaTags() as an X-CSRF-TOKEN
HTTP header.get
, post
, patch
, delete
, etc.)POST
ing data to the actions that require post
, patch
, and delete
verbs./db/migrate/
should now be moved to /migrator/migrations
and extend wheels.migrator.Migration
, not plugins.dbmigrate.Migration
which can be changed with a simple find and replace. Note: Oracle is not currently supported for Migrator.wheels
folder with the new one from the 1.4 download..htaccess
, web.config
, IsapiRewrite.ini
wheels
folder with the new one from the 1.3 download.root.cfm
file with the new one from the 1.3 download.<cfheader>
calls from the following files:events/onerror.cfm
events/onmaintenance.cfm
events/onmissingtemplate.cfm