23 Dec 2011

Hinting at the upcoming dynamic caching model for FarCry

Eri (former Daemonite) and Jason (Daemonite in charge of Development) talk Varnish Cache.  Then Jason goes onto sneak a few interesting comments about ongoing development of our new dynamic caching model for FarCry framework.

Now we have 1 single cache which does both objects and html snippets and it dynamically resizes itself depending on what’s going..

Enjoy! 
29 Nov 2011

Webskin Tracer: FarCry Developer Tool

The "tray" that appears at the bottom of the website when you are logged in, contains a marvellous developer utility called the "Webskin Tracer". You can activate it for any page by simply selecting the webskin tracer option. The entire page's composite of views is laid bare; highlighting each webskin executed for the page. Select a specific view and the HTML fragment is highlighted, with a tooltip detailing exactly where the webskin template can be found.

Tracer01
Tracer02

You can turn on the webskin tracer without being logged in by using your project's "secret key" on the URL: 
http://localhost:8888/index.cfm?objectid=E689D721-B6C9-605B-DE1D813E4CDA3339&tracewebskins=secretkey

29 Nov 2011

FarCry COAPI Helicopter View

Mockup_mvc-diagram

The FarCry framework is based on a variation of the classic Model-View-Controller pattern. The COAPI (or Content Object API) is a high level name for the MVC engine inside FarCry. Without getting bogged down in the details of the framework, its good to have a high level or "helicopter" view of how things work under the hood. We expand on these themes gradually as you go through the FarCry developer course.

Requests from users are processed by FarCry's built-in "smart controller" which automatically determines wiring based on the URL convention or the friendly URL sub-system. The COAPI always ends up calling a principal content type (a special type of class) that manages how we interact with the model and view. When thinking of views (or webskins) its important to realise that they are always executed in the context of a specific content type.

It's not at all important for developers to understand how the COAPI works, but hey, for those that want the details we're adding some advanced info boxes to the course where relevant. If you have more specific questions let me know -- always looking at ways to make the developer documentation clearer.

28 Nov 2011

Great FarCry Learning Resources

There's a bunch of great resources for FarCry developers online.  Thought I might put together a quick hit-list of my favourites.

FarCry Cheat Sheet
Get the FarCry developer cheat sheet, print it out and set it beside your keyboard. It will be a great help in getting to grips with FarCry Core

FarCry Custom Google Index
We have a custom search index for all the sites, blogs, and docs from the FarCry community.  Use this search to focus your results (and avoid all those troublesome hits for that first person shooter of a similar name ;)

FarCry Developer Forums
Google group forum for the FarCry developer community

FarCry Developer WIKI
The home of this course, references, tutorials, sample code and the FarCry Contributor Guide

FarCry Core Auto-Docs
Automatically generated docs from the FarCry code base (great for tag, formtool and FAPI options) plus the CFEclipse dictionary for FarCry code

FarCry Committers Blog
Tips and tricks from the FarCry Core development team (you are already here!)

Enjoy!
28 Nov 2011

Fandango Source Available

Fandango

Just a quick heads up that the Fandango source is up and available:

In addition to the great looking theme templates, Fandango includes a bunch of best practice examples of customisations to the FarCry Core.  If you just want a sticky beak, then your best bet's the FarCry Express download rather than wrestling with a standard install.

25 Nov 2011

FarCry Express: Ready to Run Install

Farcry-usb

FarCry Express is a "ready to run" installation of the latest FarCry 6.1 code base and the brand spanking new Fandango theme. So now you have no excuse for not checking out the latest FarCry code base!

Express is not a production ready environment, but its a lot of fun to get a handle on the FarCry caper, run a few tests, do some training or just toy with an idea.  The install runs a Railo Express instance from the folder -- everything is contained in the one little directory branch. To uninstall or start a-fresh, just delete the folder and you're done. It even works on a USB!

Am working on a massive revamp of the FarCry Developer Course, and its going to be cool to distribute the courseware as a little "ready to run" install, complete with solution.  Plus we'll be releasing regular alpha's for the upcoming 6.2 so more folks can give us much needed feedback without having to maintain their own local installation.

Enjoy!
25 Nov 2011

Google Analytics v2.0 Released

Big, albeit subtle, update to the popular Google Analytics plugin for version 2.0. We're now leveraging the latest GA asynch code placed in the page HEAD, rather than the foot before </BODY>.

Latest Release Google Analytics 2.0.0 (as at 21-Nov-2011)
Latest milestone build: milestone-2-0-0
SVN: https://farcry.jira.com/svn/GA/tags/milestone-2-0-0/
ZIP: https://farcry.jira.com/source/browse/~tarball=zip/GA/tags/milestone-2-0-0/milestone-2-0-0.zip
Certified for versions of 6.0.15+
 
No real changes needed for those upgrading, though you might want to remove the GA tag from your footers. Be sure to double check your config.

Not using the GA plugin??  Get it installed -- it's awesome :)
16 Nov 2011

FarCry Developer Cheat Sheet v0.1

Click here to download:
farcry6-cheat-sheet.pdf (1.81 MB)
(download)

Blair and the Daemonite team have rustled up a simple two page "cheat sheet" for FarCry developers, highlighting commonly used tags, functions and decorators. It's only a first stab, so let us know what's missing and what you might find useful.

Enjoy!
18 Oct 2011

Google Site Search Plugin

The Daemonites have released the Google Site Search Plugin under LGPL (free for all basically).

GSS Plugin provides close integration for FarCry projects with the Google Site Search service. Google Custom Search enables you to create a search engine for your website, your blog, or a collection of websites.

You can see it in action here on the Australian Olympics website:
http://london2012.olympics.com.au/search?q=100m+gold&s=aocMedia (with a filter for a specific content type)

Note this is the Google Site Search (not Custom Search Engine CSE) and is a paid service with Google.  We need this in order to get access to the XML/JSON API.

Enjoy!

(download)

18 Oct 2011

FarCry Plugins Directory

Have rustled up a plugin directory for the FarCry community -- built on FarCry and Twitter Bootstrap ;)  It's early days. Not all the plugins are up there, and the look will change but its a good start. Ultimately, we'll use this to provide an API service for the FarCry webtop to search, download and install plugins directly through the admin interface -- that's a ways off yet.

For now, I give you "Plugins":

If you have a plugin you want to add to the directory just send me an email with the details and I'll add it straight away :)

(download)

Core Team's Space

The FarCry Core committers; a team of dedicated Daemonites and other ring-ins.

Contributors

mattyb Geoff Bowers