Unlike most SkyBlueCanvas Plugins, the Fragmentor Plugin must be installed manually via FTP. If you install this Plugin through the admin console, it will not function properly.
The Fragmentor Plugin allows you to pass a standard query string, similar to a URL query string, to your custom SkyBlueCanvas fragments. A query string is simply a string of key=>value pairs in the format:
key1=value1&key2=value2
The Fragmentor Plugin has 2 reserved keywords:
name tells Fragmentor which Fragment to laod.
view tells Fragmentor which Fragment View to load.
You can use one of or a mix of two call syntaxes to call the Fragmentor Plugin:
<!--fragment(name=fragment_name&view=view_name¶m1=value1)-->
Use this syntax to add Fragmentor calls to your HTML skin templates.
{fragment(name=fragment_name&view=view_name¶m1=value1)}
Use this syntax to add Fragmentor calls in-line in your page article text.
If you are familiar with SkyBlueCanvas Fragments, you know that the default Fragment Plugin attempts to load any data objects associated with the fragment automatically. The plugin determines the data to load based on the name of the fragment. For instance, if you have the Links Manager installed on your SkyBlueCanvas site, and you create a fragment named links, the Fragment Plugin will automatically load the links data objects. The data objects are passed to your fragment in a variable named $data;
Fragmentor maintains this automatic data loading and your data is still passed in the $data variable. Fragmentor, however, adds a new variabled named $params which is a keyed (associative) array corresponding to the key=>value pairs of your query string.
Your query string can contain as many key=>value pairs as you like and your key names can be anything you like. The only limitations are:
Existing SkyBlueCanvas fragments are not currently configured to work with the Fragmentor Plugin. Fragmentor is intended to give you more flexibility in creating your custom plugins. We may eventually merge Fragmentor with the core SkyBlueCanvas code but at the present time it should be considered and treated like any other third-party add-on.