ViewFu
======

ViewFu is a Rails plugin that provides all the miscellaneous View tasks. It's a combination of the functionality of Styler, Javascripter, and Headline (from Patrick Crowley, the.railsi.st) - along with additional tweaks such as providing commonly used View Helpers Methods.


Maintainer Info
======

Tyler Crocker
NeoRails.com

Looking for *the one* awesome rails developer to add to your project? I may be available to help out. Contact me at neorails@gmail.com. 


ViewFu HTML Helpers
=======
ViewFu provides helpers for commonly used html elements

br #=> <br />
hr #=> <hr />
anchor("posts") #=> <a name='posts'></a>
clear #=> <div class="clear"></div>
clear(:left) #=> <div class="clearleft"></div>
clear_tag(:br) #=> <br class="clear" />
lorem #=> Lorem ipsum dolor...


ViewFu Helper Queries
=======
production? #=> returns true if Rails.env == "production"
is_new? #=> returns true is we're on a "new" or "create" action
is_edit? #=> returns true is we're on an "edit" or "update" action
use_cache? #=> returns true if perform_caching is turned on


ViewFu Misc Helpers
=======
paging(@array) #=> display a will_paginate paging links (only if the array is a valid paging collection)
paging(@array, :sabros) #=> wrap the paging links with a class "sabros"


Haml Specific Helpers
=======
Haml allows you to pash a hash of attributes. ViewFu assists this by providing a simple "hidden" helper that allows you to conditionally hide page elements.

%div{hidden} #=> <div style="display:none">
%div.posts{hidden_if(@posts.empty?)} #=> hide the .posts div if the array is empty
%p.empty{hidden_unless(@posts.empty?)} #=> hide the empty posts message if the array has elements


Stylesheets
=======
ViewFu allows you to add a dynamic stylesheets collection to the top of your page. If you have any partials that depend on a stylesheet, they just need to call add_stylesheet(path) and the styles will be available on the page. 

You'll just need to add a call *stylesheets* somewhere your page header. 

stylesheets
writes the stylesheet collection to html

stylesheet
alias around stylesheet_link_tag

stylesheet_folder(path) 
lets you include a recursive folder of stylesheets

page_stylesheets
output stylesheets specific to a page

add_stylesheet(path)
adds a stylesheet to the collection to be included on the page

ignore_stylesheet(path)
removes a stylesheet from the collection to be included on the page

See lib/stylesheet/README for more details


Javascripts
=======
ViewFu allows you to add a dynamic javascript collection to the top(or bottom) of your page. Now, if you have a partial that depends on a javascript library, you can just include it via add_javascript(path) and it will appear on the top of your page.

You'll just need add a call to *javascripts* to your layout and the javascripts you included an all your partials will appear.

javascripts
writes the javascript collection to html

javascript
alias around javascript_include_tag

javascript_folder(path) 
lets you include a recursive folder of javascripts

page_javascripts
output javascripts specific to a page

add_javascript(path)
adds a javascript to the collection to be included on the page

ignore_javascript(path)
removes a javascript from the collection to be included on the page

See lib/javascripter/README for more details

Page Titles
=======
ViewFu allows you to easily set the current page title from anywhere on your views

title
Displays the current page title

title(new_title)
Sets the page title

See lib/headliner/README for more details


Meta Tags
=======
ViewFu allows you to set meta tags on your page header from anywhere. Just add a call to meta_tags somewhere in your page header.

meta_tags
output all the html meta tags currently on the page

meta_keywords
output the meta keywords tag

meta_keywords(val)
set the page meta keywords

meta_description
output the meta description tag

meta_description(val)
set the page meta description


More Plugins
======

If you like ViewFu, you'll *love* FormFu. It provides a beautiful way to generate tableless Rails html forms. Works just like form_for, except it'll generate the entire XHTML (label, wrapper, validation message, etc). 
https://github.com/neorails/form_fu


Copyright (c) 2008 NeoRails.com, released under the MIT license