The Ortus BlogBox

"Ortus: A rise, beginning, coming into being, born, the origin!"

 

ColdBox Debugger Mini-APM v3 Launched!

Luis Majano
Apr 07, 2021

 

We are so excited to bring about a major release for the ColdBox Debugger project: v3.0.0. However, what in the world is the ColdBox Debugger module? I am glad you asked:

What is the ColdBox Debugger?

The ColdBox Debugger module is a lightweight performance monitor and profiling tool for ColdBox applications. It can generate a nice debugging panel on every rendered page or a dedicated visualizer to make your ColdBox application development nicer, funner and greater! Yes, funner is a word!

Debugger Request Visualizer

ColdBox MVC, ColdFusion, News, Releases 0

CommandBox Docker v3.3.0 Images Released

Jon Clausen
Mar 24, 2021

 

Today we are pleased to announce the release of version 3.3.0 of our CommandBox Docker images. This release contains a number of enhancements for multi-architecture support, Adobe Coldfusion 2021 compatibility, and security.

Of note, and a potentially breaking change for some, is that the base ortussolutions/commandbox:latest tag is now based on OpenJDK11 rather than OpenJDK8. Those who require the Use of JDK8 should pin their builds to the ortussolutions/commandbox:jdk8 tag. This decision was made because there is now only one JDK8 image that is currently being built - :adobe2016 .

This version also adds support for Adobe Coldfusion 20201 Package Control Manager with new environment variable support.

Best of all, we are now publishing multi-architecture builds. All of the base tags are now available in both amd64 and arm64 architecture - the latter, which is used increasingly on AWS and Apple's M1 processors. This opens up the door for additional architectures, in the future, including Windows.

1

DocBox 3.0 Released

Michael Born
Mar 15, 2021

 

DocBox

Say hello to DocBox 3.0! This new version adds JSON output format, multiple strategy support, and a raft of improvements across the board. Check it out by running box install docbox@3 to install the new version.

What Is DocBox?

DocBox is a CFML library that converts CFML component metadata and comment blocks into documentation. You can choose from three documentation formats - HTML, JSON, or an XMI file for generating UML diagrams - and generate docs from the CommandBox CLI or from your application.

In other words, DocBox takes you from code comments to delicious documentation in a matter of minutes.

Why Is DocBox?

DocBox exists to fill the gap between hand-written documentation (such as coldbox.ortusbooks.com ) and no documentation whatsoever. DocBox is especially handy for public libraries, as it makes it simple for consumers to see the available classes and method signatures without needing to manually read or search the source code.

Installing DocBox

There are two main ways to generate app documentation using DocBox:

  1. From the CommandBox CLI, with DocBox Commands
  2. From your CFML app, with the DocBox library

From CommandBox

To use DocBox within CommandBox, you'll want to run install commandbox-docbox and follow that with docbox help to see the available commands and syntax.

Just as an example, here's a typical command to generate documentation for a Coldbox application:

docbox generate source=./ mapping=app excludes=tests|coldbox|testbox|modules strategy-outputDir=./tmp strategy-projectTitle=""

For more examples and documentation, check out the DocBox Commands project on Forgebox.

From Your CFML App

For generating documentation from your CFML application, run install docbox within Commandbox to install the docbox library.

Now you can create a CFML file to instantiate the Docbox class, configure a few settings, and run the documentation generator:

new docbox.DocBox( "HTML", {
        projectTitle : "CommandBox",
        outputDir : expandPath( './docs' )
    } )
    .generate(
       source = expandPath( "/app" ),
       mapping = "app",
       excludes="(coldbox)"
    );

Check out the Docbox documentation for configuration help.

CFCasts Series

Are you interested in using DocBox for your projects? We are working on a "Using DocBox" CFCasts series for those devs who need a bit more help getting started. If you like the idea of automated documentation but don't know where to start, you'll love this new series on CFCasts. Using DocBox will be available in the coming weeks.

Release Notes

3.0.0

Added

  • New json output strategy for machine-readable documentation.
  • New addStrategy() method for generating multiple documentation formats simultaneously.
  • New documentation site hosted at docbox.ortusbooks.com
  • New TestBox suite of tests ensuring CF2018, CF2016 and Lucee compatibility on every output strategy.

Changed

  • Can configure strategy with "alias" name, like strategy="HTML".

Removed

  • Removed HTML as the default strategy. You will need to explicitly pass this to the constructor or to docbox.addStrategy( "HTML", props ) to set your desired output format.
0

ContentBox v5.0.0 Beta Released

Luis Majano
Mar 11, 2021

 


Today is a majestic day! A day that brings the release of our very first beta for ContentBox 5! This release has been in development for over 6 months and its a major architectural shift from our previous versions; multi-site support. You can now migrate over your Mura CMS applications with ease to ContentBox knowing that multi-tenant support is now available for all, for FREE, FOREVER!

Here is our what's new guide with our full release notes: https://contentbox.ortusbooks.com/intro/release-history/whats-new-with-5.0.0

I will be covering the major features in this introductory blog post.

ColdFusion, ContentBox CMS, Releases 3

ColdBox 6.3.0 Released

Luis Majano
Mar 10, 2021

 

 

Today we released ColdBox v6.3.0 as a minor release with some major bug squashing and some major performance improvements. Please update if you are affected by the issues shown in the release notes.

update coldbox

# If you are using standalone libraries, then update those
update wirebox
update cachebox
update logbox

Release Notes

ColdBox HMVC Core

Bug

  • [COLDBOX-890] - Renderer methods assume the module exists and throws exception when sending invalid url data
  • [COLDBOX-914] - Can no longer have duplicate routes with different conditions
  • [COLDBOX-935] - Colon (:) in URL Path Causes Exception Error
  • [COLDBOX-964] - invalidEventHandler does not work when calling invalid action on valid handler
  • [COLDBOX-967] - autowire annotation for test cases is not working as it should
  • [COLDBOX-968] - Fix declaring multiple resources at once
  • [COLDBOX-978] - AsyncManager threads don't release DB connections to pool for Adobe CF

New Feature

  • [COLDBOX-973] - Add new exception type catch for the RestHandler: PermissionDenied to trap in valid authorizations

Improvement

  • [COLDBOX-965] - Content type http header bypasses requestContext with render data - set explicit http header via request context
  • [COLDBOX-971] - Implement caching strategy for application helper lookups into the template cache
  • [COLDBOX-972] - Coldbox DataMarshaller Throws Error with Lucee-Light Engine
  • [COLDBOX-974] - Have the html helper manifests in local memory instead of the template cache to avoid cleanup issues
  • [COLDBOX-975] - Remove unnecessary locks for view path setups in the renderer
  • [COLDBOX-976] - Remove unnecessary lock in the bootstrap to get the controller reference, it's already there for the reload checks
  • [COLDBOX-979] - Moudle service now profiles registration and activation into the logs with the version and path of a module

WireBox

Improvement

  • [WIREBOX-111] - Refactor the way cffeed is used so that ACF 2021 doesn't choke on first startups, only when used

CacheBox

Bug

  • [CACHEBOX-67] - getStoreMetadataReport() - wrong order of the reduce() parameters
CacheBox, ColdBox MVC, ColdFusion, LogBox, News, Releases, WireBox 0

New FORGEBOX® Pricing for 2021+

Paulina Lainez
Mar 03, 2021

 

A new year means focusing on new priorities and projects. With that in mind, we wanted to give FORGEBOX® the spotlight it deserves. Our goal is to make your job and your life easier, that’s why we have decided to bring down our pricing considerably!

ForgeBox 0

First Workshop of the Year Announced: Up and Running with Quick

Paulina Lainez
Feb 16, 2021

 

On our first workshop of the year (March 11 - 12) we will get Up and Running with Quick. For those of you unfamiliar with the topic, Quick is an ORM (Object Relational Mapper) written in CFML for CFML.With it you can map database tables to entities (CFCs), create relationships between entities,query and manipulate data, and persist all your changes to your database. Quick helps you give relevant names to important bits of SQL code, compose queries at runtime to get exactly the data you want in the most efficient way, and gets out of your way when you need or want to write barebones SQL.

1

ColdBox Elixir v3 Security Update

Eric Peterson
Jan 22, 2021

 

On January 12, 2021 we became aware of a security vulnerability in ColdBox Elixir. Read the details of what happened, how it may affect you, and how to mitigate the vulnerability.

0

Introducing the New Ortus Community

Brad Wood
Jan 21, 2021

 

Hi everyone, great news! Ortus is rolling out our new Ortus Community site to help consolidate all of our community support and interaction. As part of that effort, all our Google Group threads have been imported to the new Ortus Community and effective immediately, our Google Groups are closed for further posting.

CFConfig, ColdBox MVC, ColdFusion, CommandBox, Community, ContentBox CMS, Couchbase, DataBoss, ForgeBox, Lucee Extensions, Modules, News, TestBox 2

ColdBox i18n Localization Module v2 Released

Luis Majano
Jan 19, 2021

 

After many many months of development, testing and waiting, we are finally able to release a major major update to our localization and internationalization library for ColdBox: cbi18n version 2.x. This release is a huuuge advancement for building localized applications and websites and partly thanks to Mr Wil de Bruin (shiftinsert.nl). This release introduces the ability to use json resource bundles, multiple bundles per module, cbStorages for tracking locales, property inheritance and so much more! There are a few compatiblity issues, so make sure you read them to upgrade to version 2.x if not you can easily update using CommandBox

install cbi18n
update cbi18n
ColdBox MVC, Modules, News, Releases 0