doucmentation: http://www.jeffdepascale.com/documentation/tabulate

Thanks for taking the time to check out the framework, get in touch and let me know how it is working out for you.

For those of you reaching my blog from that article, Fosfr is available on google code by clicking the link in the sidebar or following this link: fosfr on googlecode

and documentation is available here: http://www.jeffdepascale.com/documentation/fosfr

All questions and comments are very welcome as this is still a work in progress, please feel free to contact me directly.

Lots of additional features planned here, including incorporation into Fosfr after the 1.0 release of that. Currently Tabulate is a 1.0 alpha with no docs since it is all likely to change.

http://tabulate.googlecode.com

EDIT - Documentation, sample files, and example site have all been released using .8 BETA.

Notable changes include (there were alot of additional small fixes in there too):

1. loadSubSWF method now contains the parameter 'deepLink' as the second parameter. deeplink values throughout fosfr are now arrays, allowing for unlimited depth on deeplink foldering via swfaddress.
2. new top level method 'setSubLink', to match up to handleSubLink. Shortcuts to swfaddresshandler.setaddress() method. similarly to handleSubLink, the paramter is an array representing the deeplink folder structure.
3. SWFfAddressHandler model rebuilt, new methods detailed in documentation.
4. Custom error and notification handling, with the ability to trap errors to the debug panel. Debug panel highlights errors in red.
5. new property 'available' in both loader classes, specifies that the loader is available for use.
6. new method in navigation, 'initialSubload()'. If autosubload is false, call this method instead of loadSubSWF to ensure any stray deeplinks from the intial load are processed through.
7. JSONHandler bug fixed where the ...rest statement was improperly passing values as a single array instead of individual unique parameters.
8. Changes to tracking package: new property, 'trackAllMethods', specifies whether all methods instantiated for tracking receive the tag specified in the 'track' method. If true, every method will fire for each tag. If false, only the default (the first) method specified will fire. Using specific methods can now be acheived using the second parameter of the 'track' method, 'forceMethod'. This is a string value from the new 'TrackingMethods' class in the tracking package, specifying the name of the method to fire. If trackAllMethods is true, specifying a name here will force only that method to be used.
9. new flashvars parameter, 'checkDeeplink', gets around the '#' issue with SWFAddress links. Addresses can be written instead as 'http://www.domain.com/?deeplink=subpage/sublink' and it will be converted on load to: 'http://www.domain.com/#/subpage/sublink'for proper swfaddress formatting.
10. Fixed numerous glitches in FosfrLiteSWF.
11. SubSWF files are now not required and Main/Shell only implementations can now be created. Config files need not include the navigation node in this use case.
12. Bug fix in SWFAddressHandler, addressed improper handling of 'showProjectInTitle' property.
13. Bug fix in SWFAddressHandler addressing false dispatches of an empty array for sublinks when a deeplink is cached on load, subLinks is now defaulted to null at all times.
14. Bug fix in SWFAddressHandler addressing unrequested dispatch of a change event when sub link is set via setSubLink().

Changes in this revision:

- Revamp of navigation.loaders package - New properties include: 'preloadSkipped', specifying whether the preload action was skipped for the load, 'pauseBeforePreload' replaces deprecated 'autoPreload' property, 'pauseAfterPreload' replaces deprecated 'autoLoadAfterPreload' property. New method 'advanceLoader()' replaces deprecated 'beginPreload()' and 'finalizeLoad()' methods, determines on its own what step to advance to, if loader is running. Errors out if not. New property 'loaderState' defines a value from the new 'LoaderState' class (see below). Specifies what the current state of the loader is.

- New class in navigation.loader package, 'LoaderState', defines the possible states of the loader: IDLE, INITIALIZING, PRELOADING, FINALIZING, and, if the loader is told to pause, PAUSED_BEFORE_PRELOAD and PAUSED_AFTER_PRELOAD.

- Document classes 'FosfrLiteSWF', 'FosfrMainSWF', 'FosfrShellSWF', and 'FosfrSubSWF' have all been made into dynamic classes. Fixes a bug where references to fosfr.mainSWF, fosfr.shellSWF, or fosfr.subSWF would not allow access to public methods and properties.

- Graphical nav now locks out user interactions while the loader is in a processing state.

- New package in the utils folder, 'externalClasses'. Extend these classes for classes classes within the Fosfr framework outside of the Document classes. Instantiate the class and pass an instance of fosfr via the 'attachFosfr' method. Class features all the methods present in the Doc classes for the Fosfr framework. 'FosfrExternalClass' is a low weight base class providing access to fosfr and the top level methods, 'FosfrExternalMCClass' can be used as a base class for MovieClips.

- GraphicalNav now features the new property 'numberList', an optional string value specifying the numerical values of the nav buttons to tie to the graphicalNav. If left null, all items specified in the subSWF list in the config file are actively tied to nav items with associated values. If for example numberList is set to "0,3,4,5", only the items in those positions in the subSWF list are attached to movieclip instances with corresponding name values.

- GraphicalNav properties 'navName' and 'nav_mc' renamed to 'navNamingConvention' and 'navHolderName', respectively. both of these are strign values.

- GraphicalNav now features the new method 'redrawNavState' which reactivates all nav movieclips to their proper state based on the current nav status.

- Activation of current nav items is now tied via event changes to subSWFloads in the navigation class.

- NavArray now extends Array directly, acquiring all of the properties and methods inherited.

- GraphicalNav public properties now also accessible via the config XML file, under the node navigation.graphicNav.

- Both SWFAddressHandler and GraphicalNav lock their functionality while the files are mid load process - SWFAddress locks the address to the name of the subSWF being loaded, graphicalNav does not change visual display until the load has completed.

- Various bug fixes.

EDIT - I did it already, couldn't stand it: http://www.jeffdepascale.com/blog/examples/fosfrFullSite

And most importantly...a fancy new logo

Fosfr Logo

...and Prequel got one too in the process...

Prequel Logo

Changes in the .702 Beta release:

-QueryString removed from utils package, url and queryString removed as parameters from ForsfrBaseClass (appeared in both Fosfr and FosfrLite classes). Replaced by URLInfo class in core package, accessible via fosfr.urlInfo in both Fosfr and FosfrLite implementations. 'url' is now a property of this class.

-All classes and packages in the utils package are now never preinstantiated by Fosfr itself, and are either static classes or standalone packages that can be implemented within a Fosfr project.

-New in the utils package, 'JSONHandler'. Simplifies data transfers to and from JSON requests through ExternalInterface calls. Methods allow access to the call function, and a custom event returns data from the callback specified. The property 'callbackAccessible', optionally disables the callback event from dispatching if set to false. All methods wrap ExternalInterface calls in error trapping that provides detailed error information to the fosfr debug instance.

-the 'displayObj' property of Fosfr has been renamed to 'mainSWF' in Fosfr projects and 'liteSWF' in FosfrLite projects. Additionally for Fosfr projects, the 'shell' and 'subSWF' properties of the navigation class have been moved to the Fosfr class itself and renamed 'shellSWF' and 'subSWF', respectively.

-new custom event for navigation loaders, NavLoaderEvent, in the navigation.loaders package. All Event types carry the 'id' property, specifying the uint value of the subSWF cued for load. in the case of ShellLoader, this always returns null. Loaders all return LoaderEvents INIT, PRELOAD_INIT, PRELOAD_COMPLETE, and COMPLETE.

-Revamp of NavLoaderPrototype and in turn ShellLoader and SubLoader, adding additional public property 'autoPreload' and public method 'beginPreload'. Defaults to true, if set to false, allows for actions to be performed before showing the loader. Listen for fosfr.navigation.[loader].INIT, where [loader] is either shellLoader or subLoader. Call in the same object the new beginPreload() method when the actions are complete to start the preload process, which is normally automatically called.

-A number of events have been moved and updated in the Navigation package. NAvigationEvent now only defines two types, SUB_SWF_LOADED and SHELL_LOADED. UNLOAD and UNLOAD_COMPLETE have been moved to the new NavLoaderEvent class, and are exclusively used within the SubLoader class as before. SUB_LINK has also been moved more appropriately to the SWFAddressHandlerEvent class. Both the CHANGE event and SUB_LINK event now pass the property 'address' for the swfAddress data.

-Preliminary documentation at package level, documentation of tracking package.

-Added string constant 'VERSION', specifying Fosfr release number and BETA if applicable. Accessible in Fosfr and FosfrLite projects by referencing Fosfr.VERSION. An automatic debug line also now appears as the first item in Fosfr projects specifying this version information.

-Added new method to Debug, 'setSubHeadText()', which allows for a second line of text below the project name and version on the Debug panel. In Fosfr projects, this line is autopopulated with the Fosfr version information.

-All public properties of debug, tracking, navigation, navigation.subLoader, navigation.shellLoader, and navigation.swfAddressHandler are now editable via attributes of their related XMLnodes, if included in the XML file.

-Additional try/catch statements added to the SubLoader class and ConfigLoader class to transfer error messaging to the debug panel.

-Various minor bug fixes.

-config xml nodes now reflect enabling/disabling functionality based on presence, attributes correlate to most public properties of associated classes. Next release will provide access to all public properties.

-loadSubSWF and shellLoader both allow for the addition of other files to the preload for that file. See Prequel documentation for proper formatting of the preloadArray parameter.

-new properties in the Navigation class: autoShellLoad, preloadInitialSubSWFWithShell

-new property in the SubLoader and ShellLoader classes: autoLoadAfterPreload. Both are addressable from the config file by the navigation attributes autoSubSWFLoadAfterPreload and autoShellSWFLoadAfterPreload, respectively.

-XMLListToArray in the fosfr.core package has been replaced and updated with XMLListTools, a more substantial class used internally by Fosfr for parsing the configuration xml file and passing the values to the appropriate classes

-changes to the datatypes of some properties throughout the framework to more strictly define values to the Fosfr core classes.

-fixed some issues with the fosfr.local property not properly disabling all web-enabled functionalities. Now, if local is set to true (through the flashvars), it disables SWFAddress, Tracking, The QueryString Object property of Fosfr, and nulls the url property of Fosfr as well.

-documentation updated for typos and errors.

-other minor revisions throughout the framework, fixing bugs and optimizing functionality.
Also scheduled for this evening is the asdoc revision of documentation for Prequel and ResizeToolkit and a new navigation structure for the documentation section.