Blog

Luis Majano

July 08, 2016

Spread the word


Share your thoughts

 

ContentBox has what we call, a Global HTML manager. This manager allows you to seamlessly drop in JavaScript/CSS/HTML to specific theme and UI presentation life-cycle events.

Please note that the active theme must implement the life-cycle events in order for the Global HTML output to happen.

Purpose

The purpose of the Global HTML manager is to allow the integration of third-party scripts, CSS or HTML integrations easily without altering code or programming it in the theme. This allows for cross-theme output in a manageable manager.

Event Sections

The following are the sections where you can intercept and put data for output:

  • Global Layout
  • Blog Entries
  • Comments
  • Pages

You can add custom markup for any of the interception points show in this section, from after any content, before any comment, after any blog entry, etc.

Theme implementation

Implementing these events are super easy. All you have to do is announce the event using the ContentBox helper class's method: event() anywhere you want the content to output. Here is an example:




    #cb.event( "cbui_beforeHeadEnd" )#

The many events you can announce are:

"cbui_beforeHeadEnd",
"cbui_afterBodyStart",
"cbui_beforeBodyEnd",
"cbui_footer",
"cbui_beforeContent",
"cbui_afterContent",
"cbui_beforeSideBar",
"cbui_afterSideBar",
"cbui_preEntryDisplay",
"cbui_postEntryDisplay",
"cbui_preIndexDisplay",
"cbui_postIndexDisplay",
"cbui_preCommentForm",
"cbui_postCommentForm",
"cbui_prePageDisplay",
"cbui_postPageDisplay",
"cbui_preArchivesDisplay",
"cbui_postArchivesDisplay"

Summary

Hopefully now you can see how easy it is to output custom HTML, JavaScript, CSS or whatever you like in specific execution points of your theme. This allows you to easily integrate with things like social sharing, Google Analytics and much more.

Add Your Comment

(1)

Aug 10, 2016 09:26:32 UTC

by Dan OKeefe

What would be the approach to implement a theme based on bootstrap such as https://wrapbootstrap.com/theme/ace-responsive-admin-template-WB0B30DGR? Would I use globalHTML like I would a layout? Or are layouts still respected? I am wondering if I have to pick a theme at all and still use contentbox to manage the site (module).

Recent Entries

Ortus Content Digest for week of August 12th

Ortus Content Digest for week of August 12th

It's August 12th... what has Ortus been publishing this week? We have the CFML News Podcast, some CFCasts and YouTube Videos, lots of Ortus and ITB Blog Posts. We have a lot more planned for next week as well.

Gavin Pickin
Gavin Pickin
August 12, 2022
Want native Redis Support in Lucee/CFML? Ortus Redis Extension v2.0.0 Released!

Want native Redis Support in Lucee/CFML? Ortus Redis Extension v2.0.0 Released!

We are very excited to bring you another release for our Redis Lucee Extension. This is a major release spawning research of over 9 months. We have done great strides in this new extension to not only bring you the best scaling capabilities via Redis, but also now to introduce to the CFML world: Real-Time messaging with Redis Pub/Sub! Here is our full release notes in our brand new documentation book: What's New With 2.0.0!

Luis Majano
Luis Majano
August 05, 2022