Existing ColdBox Application
If you already have a ColdBox application and you wish to install ContentBox into it, you most definitely can.
System Requirements
Please note that ContentBox 4.x requires ColdBox 5.x
Step 1 : Dependencies
Since version 3.5.0, you can now simply issue a command in CommandBox to install the ContentBox module into an existing ColdBox application. Just open a box
shell in the root of your ColdBox application and use the following command:
This will install the ContentBox module with all of its dependencies under the /modules/contentbox
and the ContentBox installer module under /modules/contentbox-installer
.
Step 2 : Application.cfc
Updates
Application.cfc
UpdatesNow open your Application.cfc
and you will add the following updates:
Mappings
ORM Settings
Step 3 : ColdBox.cfc
Settings
ColdBox.cfc
SettingsOpen your application's ColdBox.cfc
and you will add the following settings:
That's it! Once all those settings, mappings and module installations are done you can now visit the installer module to continue with the installation process: http://localhost/index.cfm/cbinstaller
Danger Make sure you have the datasource created in your ColdFusion administrator or inline in your Application.cfc
Step 4: CacheBox.cfc
Settings
CacheBox.cfc
SettingsOpen your CacheBox configuration file: config/CacheBox.cfc and add the following cache declarations:
Once these updates are done, then you can start up the server and visit the installer URL: http://localhost:port/cbInstaller
Step 5 (Optional) : UI Route
By default ContentBox is in take over mode. Meaning that the UI module will intercept all calls made to the application and process them as pages or blog entries. If you DO NOT want this to happen, then you can segregate the UI module into a single entry point URL like blog
or site
or pages
. You can do this by opening the following file: modules/contentbox-ui/ModuleConfig.cfc
and looking for the following code:
Now update the this.entryPoint
to whatever you like the entry point URL to be. Restart the application and voila!
Last updated