LogoLogo
SourceSupportTraining
v3.x
v3.x
  • Introduction
  • Intro
    • Introduction
      • What's New With 3.7.0
      • What's New With 3.6.0
      • What's New With 3.5.0
      • What's New With 3.1.0
      • What's New With 3.0.0
        • Architecture
        • Administrator
        • Themes
        • Front End
        • Upgrading to 3.0.0
      • About This Book
      • Author
  • Getting Started
    • Installation
      • System Requirements
      • CommandBox Installation
      • Source Installation
      • WAR Installation
      • Express Installation
      • Existing ColdBox Application
      • Upgrading ContentBox
      • Docker
    • Quick Guide
  • Usage
    • Using ContentBox
      • Content
        • Publish Content
          • Blog
          • Sitemap
          • Content Editing Tips
            • Editor Features
            • Dynamic Variable Output
            • Markdown Support
            • Scheduled Content
        • Consume Content
          • Content Store
          • Categories
          • Media Manager
          • Menu Manager
      • Comments
        • Inbox
        • Settings
      • Look & Feel
        • Active Theme
        • Global HTML
        • Themes
        • Widgets
          • Inserting a Simple Widget
      • Modules
        • Installing Modules
        • Managing Modules
      • Users
        • Manage
        • Permissions
        • Roles
      • Tools
        • Import
        • Export
        • Static Site Generation
      • System
        • Auth Logs
        • Geek Settings
        • Settings
          • Site Options
          • Admin Options
          • Security Options
          • Login Options
          • Content Options
          • Editor Options
          • Media Manager Options
          • Gravatars
          • Notifications
          • Mail Server
          • Search Options
          • Login Options
        • Security Rules
        • Updates
  • Developing
    • Developing For ContentBox
      • Front-End Development
        • File Structure
        • Theme Development
          • Theme Settings
          • Theme UDFs
          • Theme Templates
          • Theme Layouts
          • Theme Views
          • Theme SEO Functionality
        • The Content Store
        • Customizing Views
        • Customizing Layouts
        • Managing Assets
        • Customizing Navigation
        • Global Variables
        • Template Variables
      • Back-End Development
        • Overriding ContentBox Settings
        • Modules
          • Installing a Module
          • Using a Module
          • Module Locations and Conventions
          • Build a Module
          • Scaffold a Module
          • Theme your Module
          • Build an Admin Module
          • Adding Admin Menus to your Module
          • Adding Meta to your Modules
        • Widgets
          • Simple Widget
          • Widgets with Arguments
          • Multiple Render Function Widgets
        • JS and CSS Assets
        • Interceptors
        • Accessing Logged in User
        • Customizing the Admin
        • Staying on the Upgrade Path
Powered by GitBook
On this page
  • Upgrading to 3.1.0
  • Travis Integration
  • Updated JDK/JRE + Lucee Engines
  • Easily Render Captcha Images
  • SEO Enhancements
  • Title Discovery
  • Description Discovery
  • Keywords Discovery
  • SEO Module Overrides
  • Static Site Generator
  • Module Enhancements
  • Author Object Availability
  • File Manager UI Updates
  • Release Notes
  • Bug
  • New Feature
  • Improvement

Was this helpful?

Edit on Git
Export as PDF
  1. Intro
  2. Introduction

What's New With 3.1.0

Last updated 7 years ago

Was this helpful?

ContentBox 3.1.0 is a minor release with over 40 issues, improvements and new features addressed. Below you will find the detailed release notes about this release but also the major areas of improvement and new features introduced. Enjoy!

Upgrading to 3.1.0

Travis Integration

Travis is now building and publishing ContentBox to ForgeBox.io. We will also be able to accept pull requests with satisfaction that they do not break the builds. So pull away my friends!

Updated JDK/JRE + Lucee Engines

All express versions have been updated with the latest JRE/JDKs and Lucee CFML engines.

Easily Render Captcha Images

ContentBox supports native captcha support and now your themes can render out a nice captcha image by using the new ContentBox helper method: cb.renderCaptcha() method.

SEO Enhancements

We have also devoted time to enhance the SEO capabilities of ContentBox not only in the ContentBox helper object but in the updated default theme. The new helper methods are:

  • getContentTitle() : Retrieve the assigned title for a rendered page

  • getContentDescription() : Retrieve the assigned description for a rendered page

  • getContentKeywords() : Retrieve the assigned keywords for a rendered page

Title Discovery

Please note that the title for a page now comes in the following discovery hiearchy:

  1. Override set by custom modules

  2. SEO Panel title

  3. Page name

Description Discovery

Please note that the description for a page now comes in the following discovery hiearchy:

  1. Override set by custom modules

  2. SEO Panel description

  3. Excerpt

  4. Dynamic Excerpt (160 characters) from content

Keywords Discovery

Please note that the keywords for a page now comes in the following discovery hiearchy:

  1. Override set by custom modules

  2. SEO Panel keywords

  3. Global Site Keywords

SEO Module Overrides

If you are building custom modules with views that render in a site's theme, you can now also set SEO content for title, description and keywords by leveraging the following methods in the ContentBox Helper:

  • setMetaTitle()

  • setMetaDescription()

  • setMetaKeywords()

Static Site Generator

ContentBox 3.1 now supports the generation of static sites from your content and even your blog. This is a great addition to ContentBox as now you can produce static versions and workflows, deploy to CDN networks, secure your content and much more. Once you click on the Start Generation button, ContentBox will go over your entire site and produce a static archive for you in the associated theme. It will also announce two interception points for you during the process:

  • cbadmin_preStaticSiteExport : Receives all the export options in the intercept data so you can alter the export behavior.

  • cbadmin_postStaticSiteExport : Receives all the export options and also a results structure with the following keys: exportLog:builder, exportDirectory, exportArchive. This is a great way to listen for the export and send to S3 for archiving, etc.

Warning Dynamic elements like commenting, searching, etc must require a JavaScript implementation. So make sure you have a static export strategy in place.

Module Enhancements

This release sports many enhancements to support module development authors in order for them to seamlessly build high impact applications using ContentBox.

Author Object Availability

The logged in (or not) author/user of ContentBox is now globally available in the ColdBox private request collection as prc.oCurrentAuthor. This will allow module developers to have easy access to the current object that would represent a logged in Author or User of the ContentBox instance.

File Manager UI Updates

The File Manager / Media Manager is an important part of a Content Management System, and we have fixed several UI bugs, and added a few smaller features. The Context Menus are more accurate, and function on the selected item. The file location breadcrumb is now clickable, to allow you to move about your file structure easier.

Release Notes

Bug

New Feature

Improvement

The easiest way to upgrade your ContentBox installation is to use the auto updater located in the system > updates panel. Just make sure you please backup your database and source code as this release includes a major framework update and you will most likely need to reboot your engine or server. Go to our for much more information about upgrading ContentBox.

[] - If admin is in SSL mode, then previews should trigger ssl as well

[] - BaseWidget not providing a default logging class 'log' as it did in ContentBox 2

[] - Admin Layout - loop through jsFullAppendList uses the wrong src base

[] - background color indicators for drafts, published future and expired content is not showing up

[] - PermissionService, RoleService missing date util injection

[] - exclude pages,entries on author mementos, they are not treated for export/import

[] - Importer not importing correct custom modules if coming from windows

[] - Blog excerpt not rendering ContentStore objects

[] - Adobe Compilation error due to ColdBox 4.3 updates

[] - Cascading issue on deletion of one-to-one relationship between base content and its stats

[] - Incorrect title on snapshots data table

[] - i18n properties out of sync with the US file

[] - Installer doesn't work without rewrites

[] - Blog Paging in front end works correctly but display is incorrect

[] - Blog Paging uses Javascript:null which errors in Firefox

[] - Blog Pagination - If you hit a page over total it shows up blank

[] - Content Subscriptions

[] - Update express editions to use latest JDK

[] - Update lucee to latest stable in 4.5 series for Express/War Editions

[] - New CBHelper method: renderCaptcha() to easily render the img tag

[] - Static Site Generator

[] - prc.oCurrentAuthor is now set and available globally by the UI prepare request interceptor

[] - Travis integration

[] - edge case exception when a content object has no active content versions on ACF

[] - new cbhelper seo method: getContentTitle() that retrieves the content title according to discovery rules

[] - new cbhelper seo method: getContentDescription() that retrieves the metadata according to discover rules

[] - new cbhelper seo method: getContentKeywords() that retrieves the metadata according to discover rules

[] - Auto-fill Name/E-mail and skip captcha on comments if logged in

[] - Add image resizing/cropping to filebrowser

[] - Update site maintenance feature to have admin still view site but it's down for everyone else

[] - SEO Convention for passing title, keywords, description to theme from modules

[] - Convention for Module Based Security Rules

[] - Admin Layout - loop through jsFullAppendList and cssFullAppendList expects no extension

[] - CBHelper now accounts for ssl via request context on all link building operations

[] - cbhelper isprintFormat not accounting for html formats

[] - CommentForm widget standardizes to default bootstrap themes

[] - Search Form Widget standardized to bootstrap

[] - Updated all box dependencies to latest releases

[] - Update mobile detector to latest incoming script

[] - Add more documentation options for theme elements and groups

[] - Filebrowser - Download a folder gives confusing error message

[] - FileBrowser - Right click doesn't select object when showing Context Menu

[] - FileBrowser - Format the timestamp in the status bar to be more user friendly

[] - FileBrowser - Make Location Breadcrumbs clickable

[] - FileBrowser - Excluded Items not removed from Item count in Status Bar

[] - FileBrowser - In grid view - the selection area isn't the full thumb square

[] - FileBrowser - Update Message to include Settings

[] - Widgets - Widgets loaded from Themes are still marked as Layouts

upgrading guide
CONTENTBOX-762
CONTENTBOX-766
CONTENTBOX-767
CONTENTBOX-771
CONTENTBOX-776
CONTENTBOX-777
CONTENTBOX-778
CONTENTBOX-780
CONTENTBOX-800
CONTENTBOX-803
CONTENTBOX-808
CONTENTBOX-809
CONTENTBOX-815
CONTENTBOX-816
CONTENTBOX-817
CONTENTBOX-818
CONTENTBOX-514
CONTENTBOX-760
CONTENTBOX-761
CONTENTBOX-765
CONTENTBOX-783
CONTENTBOX-796
CONTENTBOX-801
CONTENTBOX-802
CONTENTBOX-805
CONTENTBOX-806
CONTENTBOX-807
CONTENTBOX-573
CONTENTBOX-641
CONTENTBOX-740
CONTENTBOX-756
CONTENTBOX-759
CONTENTBOX-768
CONTENTBOX-779
CONTENTBOX-785
CONTENTBOX-797
CONTENTBOX-798
CONTENTBOX-799
CONTENTBOX-804
CONTENTBOX-811
CONTENTBOX-819
CONTENTBOX-820
CONTENTBOX-821
CONTENTBOX-822
CONTENTBOX-823
CONTENTBOX-824
CONTENTBOX-825
CONTENTBOX-828