Webskin or View Post Processing

Owned by Geoff Bowers
Last updated: Jun 06, 2014 by Blair McKenzie

View post processing functions were added in the FarCry 6.2.3 release.

 

Easy Embeds for Views

Ever wanted to just add a link to a YouTube or Vimeo video in your content and have the system convert it to the right embed code? How about a Tweet, or a Gist?  If the embed changes (or your design changes!) how cool would it be to just update a central location and have all your embeds update?

Oh, and ever tried to man handle a large embed in a rich text editor like tinyMCE?  It can be more than a bit messy. One seriously cool solution is to post-process your content. Have contributors add URLs into their content and then let the view automatically determine what the right embed should be.

 

Post processing can be added to a webskin using the "postprocess" webskin decorator, and those transformations will be applied before the webskin is cached:

<!--- @@postprocess: youtube(width=720,height=405);gist --->

 

This can be applied more selectively with a function or a tag:

<!--- using a function call --->
<cfset result = application.fc.lib.postprocess.apply(stObj.body,"youtube(width=720,height=405);gist")>
 
<!--- using a custom tag call from the ./tags/webskin library --->
<skin:postprocess functions="youtube(width=720,height=405);gist">#stObj.body#</skin:postprocess>


The function strings must be a semi-colon (;) separated list of functions in the form:

[libraryname.]function[(arg1=val1,arg2=val2)]


With:

  • an optional library name (this is the name of a component in the lib package in core, your project, or any plugin)
  • optional arguments (must be named)

These functions have been included in core by default:

  • youtube([width],[height])
  • vimeo([width],[height])
  • gist
  • twitter
  • vine([width],[height],[type])
  • polldaddy
  • storify
  • removewhitespace
  • rewriteImages

You can add your own project specific post-processing functions by creating a ./packages/lib/postprocess.cfc component and extending ./core/packages/lib/postprocess.cfc from the core framework.

Enjoy!