neorails-view_fu 0.1.20080705

data/MIT-LICENSE

@@ -0,0 +1,40 @@
+ViewFu - Copyright (c) 2008 NeoRails.com 
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Original Plugins (Styler, Javascripter, Headliner) - Copyright (c) 2007 Patrick Crowley, the.railsi.st
+	
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README

@@ -0,0 +1,133 @@
+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.
+
+
+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
+
+
+
+
+
+
+Copyright (c) 2008 NeoRails.com, released under the MIT license

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the view_fu plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the view_fu plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ViewFu'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/init.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + "/rails/init"

data/lib/browser_detect/helper.rb

@@ -0,0 +1,45 @@
+module BrowserDetect::Helper
+  
+  # check the current browser (via user agent) for the following:
+  # :mozilla
+  # :ie6
+  # :ie7
+  # :ie
+  # :safari
+  def browser_is? name
+
+    name = name.to_s.strip
+
+    return true if browser_name == name
+    return true if name == 'mozilla' && browser_name == 'gecko'
+    return true if name == 'ie6' && browser_name.index('ie6')
+    return true if name == 'ie7' && browser_name.index('ie7')
+    return true if name == 'ie' && browser_name.index('ie')
+    return true if name == 'webkit' && browser_name == 'safari'
+
+  end
+  
+  # find the current browser name
+  def browser_name
+    @browser_name ||= begin
+
+      ua = request.env['HTTP_USER_AGENT'].to_s.downcase
+
+      if ua.index('msie') && !ua.index('opera') && !ua.index('webtv')
+        'ie'+ua[ua.index('msie')+5].chr
+      elsif ua.index('gecko/') 
+        'gecko'
+      elsif ua.index('opera')
+        'opera'
+      elsif ua.index('konqueror') 
+        'konqueror'
+      elsif ua.index('applewebkit/')
+        'safari'
+      elsif ua.index('mozilla/')
+        'gecko'
+      else
+        ""
+      end
+    end
+  end
+end

data/lib/headliner/README

@@ -0,0 +1,118 @@
+=========
+Headliner
+=========
+
+Headliner DRYs up your page titles.
+
+
+Background
+==========
+
+Normally, if your Rails application has lots of actions and a shared
+layout, you might find yourself setting custom page title names in your
+controllers.
+
+Here's an example:
+
+class PagesController < ApplicationController
+  def about
+    @title = "About us"
+  end
+end
+
+Then, in your main layout, you might have something like this:
+
+<head>
+<title>My website<% if @title %>: <%= @title %><% end %></title>
+</head
+
+This works okay... but page titles don't really belong in controllers, do
+they?
+
+So, by moving these titles into your views, we can DRY things up a bit and
+reinforce the MVC design pattern that's so fundamental to Ruby on Rails.
+
+
+Usage
+=====
+
+First, add this code to your main layout:
+
+<head>
+<%= title :site => "My website" %>
+</head>
+
+Then, to set the page title, add this to each of your views:
+
+<h1><%= title "My page title" %></h1>
+
+When views are rendered, the page title will be included in the right
+spots:
+
+<head>
+<title>My website | My page title</title>
+</head>
+<body>
+<h1>My page title</h1>
+</body>
+
+
+Options
+=======
+
+Use these options to customize the title format:
+
+:prefix (text between site name and separator)
+:separator (text used to separate website name from page title)
+:suffix (text between separator and page title)
+:lowercase (when true, the page name will be lowercase)
+:reverse (when true, the page and site names will be reversed)
+
+And here are a few examples to give you ideas.
+
+<%= title :separator => "&mdash;" %>
+<%= title :prefix => false, :separator => ":" %>
+<%= title :lowercase => true %>
+<%= title :reverse => true, :prefix => false %>
+
+
+Dealing with special pages
+==========================
+
+How do you set the page title without showing it in the view?
+
+<% title "My page title" %>
+
+What if your view headline is different from your page title?
+
+<%= title "My page title", "My headline" %>
+
+
+Mr. T says, ‘Use my method, fool!’
+==================================
+
+Just like ERB's HTML safe method, you can invoke Headliner with a single
+letter alias.
+
+<h1><%=t "My page title" %></h1>
+
+
+How does it work?
+=================
+
+Ruby on Rails renders actions *before* inserting them into layouts. So, if 
+you set a variable in your view, it will be accessible in your layout. But, 
+at first glance, it looks like you're using a variable (in the head)
+before it's been assigned a value (in the body). Cool, huh?
+
+
+Credits
+=======
+
+Special thanks to Nick Zadrozny and Jordan Fowler for their input.
+
+
+Feedback
+========
+
+Comments, bug reports, and svn diffs welcome at http://the.railsi.st.

data/lib/headliner/helper.rb

@@ -0,0 +1,65 @@
+module Headliner
+  module Helper
+    def title(options, headline='')
+      if options.is_a? String
+        save_title(options, headline)
+      else
+        display_title(options)
+      end
+    end
+
+    def save_title(title, headline)
+      @title = title.gsub(/<\/?[^>]*>/, '')
+      headline.blank? ? title : headline
+    end
+
+    def display_title(options)
+      # Prefix (leading space)
+      if options[:prefix]
+        prefix = options[:prefix]
+      elsif options[:prefix] == false
+        prefix = ''
+      else
+        prefix = ' '
+      end
+
+      # Separator
+      unless options[:separator].blank?
+        separator = options[:separator]
+      else
+        separator = '|'
+      end
+
+      # Suffix (trailing space)
+      if options[:suffix]
+        suffix = options[:suffix]
+      elsif options[:suffix] == false
+        suffix = ''
+      else
+        suffix = ' '
+      end
+
+      # Lowercase title?
+      if options[:lowercase] == true
+        @title = @title.downcase unless @title.blank?
+      end
+
+      # Set website/page order
+      unless @title.blank?
+        if options[:reverse] == true
+          # Reverse order => "Page : Website"
+          return content_tag(:title, @title + prefix + separator + suffix + options[:site])
+        else
+          # Standard order => "Website : Page"
+          return content_tag(:title, options[:site] + prefix + separator + suffix + @title)
+        end
+      end
+  
+      # If title is blank, return only website name
+      content_tag :title, options[:site]
+    end
+
+    # Mr. T says, "Use my method, fool!"
+    alias t title
+  end
+end

data/lib/javascripter/README

@@ -0,0 +1,87 @@
+======
+Javascripter
+======
+
+Javascripter is designed to DRY up the process of including and generating
+javascripts, so you can think less about javascript configuration and more
+about scripting.
+
+
+Usage
+=====
+
+To use Javascripter, just update your layout(s) with this code:
+
+<head>
+<title>the.rails.ist</title>
+<%= javascripts %>
+</head>
+
+Javascripter will then include your javascripts automatically:
+
+<head>
+	<title>the.rails.ist</title>
+	<link href="/javascripts/application.js?1170968897" />
+</head>
+
+Javascripter will also dynamically include javascripts for each of your
+controllers (if such javascripts are present), so you can keep your scripts
+organized into logical sections.
+
+
+Organize your javascripts
+=========================
+
+Javascripter uses a simple set of conventions:
+
+- Javascripts for your entire application should be stored in application.js
+- Javascripts for specific controllers should be stored in controller.js
+- Javascripts for specific actions should be stored in controller_action.js
+
+When used in combination, these conventions can scale up to support pretty
+big applications.
+
+
+Include additional javascripts
+==============================
+
+Conventions are great, but need to add your own javascripts?
+
+<%= javascripts :include => "reset" %>
+<%= javascripts :include => ["reset", "fonts"] %>
+
+
+Use nested javascripts (optional)
+=================================
+
+For bigger projects, you might wish to break your javascripts into separate 
+directories.
+
+To use nested javascripts, just create subdirectories in public/javascripts 
+for each of your controllers, and then add javascripts for individual 
+actions you wish to script.
+
+- Javascripts for an entire controller should be stored in controller.js
+- Javascripts for specific actions should be stored in controller/action.js
+
+
+Generator
+=========
+
+Javascripter also includes a generator that will create a default set of
+javascripts (application.js) and a separate
+javascript for each controller in your application.
+
+To use the generator, run this command in your terminal:
+
+script/generate javascripts
+
+If you add a new controller, just run the generator again and a new
+javascript for the controller will be created. (Javascripter will safely ignore
+any existing javascripts.)
+
+
+Feedback
+========
+
+Comments, bug reports, and svn diffs welcome at http://the.railsi.st.

data/lib/javascripter/helper.rb

@@ -0,0 +1,106 @@
+module Javascripter
+  module Helper
+
+    # alias for javascript_include_tag
+    def javascript(*input)
+      input = [input].flatten
+    
+      javascript_include_tag(*input)
+    end
+  
+    # Override this if needed
+    def javascripts(options={})
+      [
+        page_javascripts(options),
+        javascript("application")
+      ].join("\n")
+    end
+  
+    # returns an entire directory of javascripts recursively
+    def javascript_folder(path)
+      if use_cache? 
+        return stylesheet "min/#{path}.js"
+      else
+        result = []
+        Dir["#{Rails.public_path}/javascripts/#{path}/**/*.js"].each do |item|
+          result << item.gsub("#{Rails.public_path}/javascripts/", "")
+        end
+        return stylesheet result
+      end
+    end
+  
+    # Include Javascripts on the page 
+    # options[:include] to an array of strings for javascripts to include
+    # options[:exclude] sets an array of strings for javascripts to exclude
+    # options[:cache] sets the cache option to javascript_include_tag (only for nonconditional items)
+    #
+    # Automatically includes javascripts (if they exist on filesystem)
+    # - javascripts for [controller]/[controller].js and [controller]/[action].js
+    #
+    def page_javascripts(options={})
+    
+      # initialize collection
+      javascripts = []
+      conditional_scripts = []
+      @javascripts_add ||= []
+      @javascripts_ignore ||= []
+    
+      # Additional scripts (if requested)
+      if options[:include]
+        @javascripts_add = [options[:include]].flatten + @javascripts_add
+      end
+    
+      # Exclude scripts (if requested)
+      if options[:exclude]
+        @javascripts_ignore = [options[:exclude]].flatten + @javascripts_ignore
+      end
+
+      # Add more scripts
+      @javascripts_add.each do |javascript|
+        javascripts << javascript
+      end
+    
+      # Ignore scripts
+      @javascripts_ignore.each do |javascript|
+        javascripts.delete(javascript)
+      end
+    
+      # dedup javascript array
+      javascripts.uniq!
+    
+      # Build Output
+      html_output = javascript_include_tag(*javascripts)
+    
+      # Controller/action scripts
+      conditional_scripts << "#{controller.controller_name}"
+      conditional_scripts << "#{controller.controller_name}/#{controller.action_name}"
+      
+      # only add conditional scripts if they exist on disk
+      conditional_scripts.each do |javascript|
+        if File.exist?("#{RAILS_ROOT}/public/javascripts/#{javascript}.js")
+          html_output << "\n"
+          html_output << javascript_include_tag(javascript)
+        end
+      end
+    
+      # return output
+      return html_output
+    end
+  
+    # add a javascript to the include list
+    def add_javascript(*javascripts)
+      @javascripts_add ||= []
+      javascripts.each do |javascript|
+        @javascripts_add << javascript
+      end
+    end
+  
+    # ignore a javascript
+    def ignore_javascript(*javascripts)
+      @javascripts_ignore ||= []
+      javascripts.each do |javascript|
+        @javascripts_ignore << javascript
+      end
+    end
+  end
+end

data/lib/styler/README

@@ -0,0 +1,95 @@
+======
+Styler
+======
+
+Styler is designed to DRY up the process of including and generating
+stylesheets, so you can think less about stylesheet configuration and more
+about styling.
+
+
+Usage
+=====
+
+To use Styler, just update your layout(s) with this code:
+
+<head>
+<title>the.rails.ist</title>
+<%= stylesheets %>
+</head>
+
+Styler will then include your stylesheets automatically:
+
+<head>
+<title>the.rails.ist</title>
+<link href="/stylesheets/application.css?1170968897" />
+<!--[if IE 7]>
+<link href="/stylesheets/ie7.css?1170968897" />
+<![endif]-->
+<!--[if IE 6]>
+<link href="/stylesheets/ie6.css?1170968897" />
+<![endif]-->
+</head>
+
+Styler will also dynamically include stylesheets for each of your
+controllers (if such stylesheets are present), so you can keep your styles
+organized into logical sections.
+
+
+Organize your stylesheets
+=========================
+
+Styler uses a simple set of conventions:
+
+- Styles for your entire application should be stored in application.css
+- Styles for specific controllers should be stored in controller.css
+- Styles for specific actions should be stored in controller_action.css
+- Styles for Internet Explorer 7 should be stored in ie7.css
+- Styles for Internet Explorer 6 should be stored in ie6.css
+
+When used in combination, these conventions can scale up to support pretty
+big applications.
+
+
+Include additional stylesheets
+==============================
+
+Conventions are great, but need to add your own stylesheets?
+
+<%= stylesheets :include => "reset" %>
+<%= stylesheets :include => ["reset", "fonts"] %>
+
+
+Use nested stylesheets (optional)
+=================================
+
+For bigger projects, you might wish to break your stylesheets into separate 
+directories.
+
+To use nested stylesheets, just create subdirectories in public/stylesheets 
+for each of your controllers, and then add stylesheets for individual 
+actions you wish to style.
+
+- Styles for an entire controller should be stored in controller.css
+- Styles for specific actions should be stored in controller/action.css
+
+
+Generator
+=========
+
+Styler also includes a generator that will create a default set of
+stylesheets (application.css, ie7.css, and ie6.css) and a separate
+stylesheet for each controller in your application.
+
+To use the generator, run this command in your terminal:
+
+script/generate stylesheets
+
+If you add a new controller, just run the generator again and a new
+stylesheet for the controller will be created. (Styler will safely ignore
+any existing stylesheets.)
+
+
+Feedback
+========
+
+Comments, bug reports, and svn diffs welcome at http://the.railsi.st.

data/lib/styler/helper.rb

@@ -0,0 +1,117 @@
+module Styler
+  module Helper
+    # alias for stylesheet_link_tag
+    def stylesheet(*input)
+      input = [input].flatten
+      stylesheet_link_tag(*input)
+    end
+    
+    # override this in your application_helper to clean it up
+    def stylesheets(options = {})
+      [stylesheet(:defaults), page_stylesheets(options)].join("\n")
+    end
+  
+    # returns an entire directory of stylesheets recursively
+    def stylesheet_folder(path)
+      if use_cache? # or browser_is? :ie
+        return stylesheet "min/#{path}.css"
+      else
+        result = []
+        Dir["#{Rails.public_path}/stylesheets/#{path}/**/*.css"].each do |css|
+          result << css.gsub("#{Rails.public_path}/stylesheets/", "")
+        end
+        return stylesheet result
+      end
+    end
+  
+    # Include Stylesheets on the page 
+    # options[:include] to an array of strings for stylesheets to include
+    # options[:exclude] sets an array of strings for stylesheets to exclude
+    #
+    # Automatically includes stylesheets (if they exist on filesystem)
+    # - stylesheets for [controller]/[controller].css and [controller]/[action].css
+    # - stylesheets for browser overrides (ie6.css, ie7.css, safari.css)
+    #
+    def page_stylesheets(options={})
+
+      # set default values
+      stylesheets = []
+      @stylesheets_add ||= []
+      @stylesheets_ignore ||= []
+
+      # Include sheets from options
+      if options[:include]
+        @stylesheets_add = [options[:include]].flatten + @stylesheets_add
+      end
+    
+      # Exclude sheets from options
+      if options[:exclude]
+        @stylesheets_ignore = [options[:exclude]].flatten + @stylesheets_ignore
+      end
+    
+      # Add all sheets from instance variable
+      @stylesheets_add.each do |stylesheet|
+        stylesheets << stylesheet
+      end
+    
+      # Ignore all sheets from instance variable
+      @stylesheets_ignore.each do |stylesheet|
+        stylesheets.delete(stylesheet)
+      end
+    
+      # dedupe stylesheets array
+      stylesheets.uniq!
+    
+      # Build Initial Output
+      html_output = stylesheet_link_tag(*stylesheets)
+    
+      # Build conditional stylesheets (we need to check these on the filesystem before including)
+      conditional_stylesheets = []
+    
+      # Controller/action sheets
+      conditional_stylesheets << "pages/#{controller.controller_name}"
+      conditional_stylesheets << "pages/#{controller.controller_name}/#{controller.action_name}"
+        
+      # IE6
+      if browser_is?(:ie6)
+        conditional_stylesheets << "ie6"
+      end
+    
+      # IE7
+      if browser_is?(:ie7)
+        conditional_stylesheets << "ie7"
+      end
+  
+      # Safari
+      if browser_is?(:safari) and 
+        conditional_stylesheets << "safari"
+      end  
+    
+      # only add conditional stylesheets if they exist on disk
+      conditional_stylesheets.each do |stylesheet|
+        if File.exist?("#{RAILS_ROOT}/public/stylesheets/#{stylesheet}.css")
+          html_output << "\n"
+          html_output << stylesheet_link_tag(stylesheet)
+        end
+      end        
+    
+      return html_output
+    end
+  
+    # Allows individual views to customize the stylesheet list
+    def add_stylesheet(*stylesheets)
+      @stylesheets_add ||= []
+      stylesheets.each do |stylesheet|
+        @stylesheets_add << stylesheet
+      end
+    end
+  
+    # Allows individual views to customize the stylesheet list
+    def ignore_stylesheet(*stylesheets)
+      @stylesheets_ignore ||= []
+      stylesheets.each do |stylesheet|
+        @stylesheets_ignore << stylesheet
+      end
+    end
+  end
+end

data/lib/view_fu.rb

@@ -0,0 +1,16 @@
+require "view_fu/tag_helper"
+require "view_fu/meta_helper"
+ActionView::Base.send :include, ViewFu::TagHelper
+ActionView::Base.send :include, ViewFu::MetaHelper
+
+require "browser_detect/helper"
+ActionView::Base.send :include, BrowserDetect::Helper
+
+require "headliner/helper"
+ActionView::Base.send :include, Headliner::Helper
+
+require "javascripter/helper"
+ActionView::Base.send :include, Javascripter::Helper
+
+require "styler/helper"
+ActionView::Base.send :include, Styler::Helper

data/lib/view_fu/meta_helper.rb

@@ -0,0 +1,51 @@
+module ViewFu
+  module MetaHelper
+    # Output the current page's meta tags
+    def meta_tags
+      %(
+        <meta name="keywords" content="#{meta_keywords}" />
+        <meta name="description" content="#{meta_description}" />
+      )
+    end
+
+    # Get/Set Meta Keywords
+    def meta_keywords(meta_keywords = nil)
+      if meta_keywords
+        @__meta_keywords = meta_keywords
+      else
+        @__meta_keywords ||= ""
+      
+        # Check if we have AppConfig to use for default
+        if defined? AppConfig
+          default_meta_keywords = AppConfig.default_meta_keywords 
+        else
+          default_meta_keywords = ""
+        end
+      
+        # set the default if meta_keywords is blank
+        @__meta_keywords = default_meta_keywords if @__meta_keywords.blank?
+      end
+      return @__meta_keywords
+    end
+
+    # Get/Set Meta Description
+    def meta_description(meta_description = nil)
+      if meta_description
+        @__meta_description = meta_description
+      else
+        @__meta_description ||= ""
+      
+        # Check if we have AppConfig to use for default
+        if defined? AppConfig
+          default_meta_description = AppConfig.default_meta_description 
+        else
+          default_meta_description = ""
+        end
+      
+        # set the default if meta_description is blank
+        @__meta_description = default_meta_description if @__meta_description.blank?
+      end
+      return @__meta_description
+    end
+  end
+end

data/lib/view_fu/tag_helper.rb

@@ -0,0 +1,134 @@
+module ViewFu
+  module TagHelper
+    
+    # Writes a br tag
+    def br
+      "<br />"
+    end
+
+    # Writes an hr tag
+    def hr
+      "<hr />"
+    end
+    
+    # Writes an hr space tag
+    def space
+      "<hr class='space' />"
+    end
+    
+    # Writes an anchor tag
+    def anchor(anchor_name)
+      "<a name='#{anchor_name}'></a>"
+    end
+    
+    # Writes a clear tag
+    def clear_tag(tag, direction = nil)
+      if tag == :br
+        "<br class=\"clear#{direction}\" />"
+      else
+        "<#{tag} class=\"clear#{direction}\"></#{tag}>"
+      end
+    end
+  
+    # Writes a clear div tag
+    def clear(direction = nil)
+      clear_tag(:div, direction)
+    end
+  
+    # Return some lorem text
+    def lorem
+      "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
+    end
+  
+    # Return a hidden attribute hash (useful in Haml tags - %div{hidden})
+    def hidden
+      {:style => "display:none"}
+    end
+    
+    # Easily link to an image
+    def link_to_image(image_path, label, url, options={})
+      # setup vertical alignment
+      vert_align = options.delete(:vert)
+      if vert_align.nil?
+        vert_style = "vertical-align: middle"
+      elsif vert_align.blank?
+        vert_style = ""
+      else
+        vert_style = "vertical-align: #{vert_align.to_i}px"
+      end
+
+      link_to(image_tag(image_path, :class => "vert-middle", :style => "#{vert_style}"), url, options)+"&nbsp;"+
+      link_to(label, url, options)
+    end
+
+  
+    # Return a hidden attribute hash if a condition evaluates to true
+    def hide_if(condition)
+      if condition
+        hidden
+      else
+        {}
+      end
+    end
+  
+    # Return a hidden attribute hash if a condition evaluates to false
+    def hide_unless(condition)
+      if !condition
+        hidden
+      else
+        {}
+      end
+    end
+  
+    # Wrap a delete link
+    def delete_link(*args)
+      options = {:method => :delete, :confirm => "Are you sure you want to delete this?"}.merge(args.extract_options!)
+      args << options
+      link_to(*args)
+    end
+  
+    # Wrap a block with a link
+    def link_to_block(*args, &block)
+      content = capture_haml(&block)
+      return link_to(content, *args)
+    end
+  
+    # Check if we're on production environment
+    def production?
+      Rails.env == "production"
+    end
+  
+    # Check if we're on New or Create actions
+    def is_new?
+      action = params[:action]
+      action == "new" || action == "create"
+    end
+
+    # Check if we're on Edit or Update actions
+    def is_edit?
+      action = params[:action]
+      action == "edit" || action == "update"
+    end
+  
+    # Whether or not to use caching
+    def use_cache?
+      ActionController::Base.perform_caching
+    end
+  
+    # Display will_paginate paging links
+    def paging(page_data, style = :sabros)
+      return unless page_data.class == WillPaginate::Collection    
+      will_paginate(page_data, :class => "pagination #{style}", :inner_window => 3)
+    end
+
+    # clearbit icons
+    def clearbit_icon(icon, color, options = {})
+      image_tag "clearbits/#{icon}.gif", {:class => "clearbits #{color}", :alt => icon}.merge(options)
+    end
+
+    # pixel spacing helper
+    def pixel(options = {})
+      image_tag "pixel.png", options
+    end
+  end
+end

data/rails/init.rb

@@ -0,0 +1 @@
+require 'view_fu'

data/test/browser_detect_test.rb

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'test/unit'
+require 'browser_detect/helper'
+
+class BrowserDetectTest < Test::Unit::TestCase
+
+  include ActionView::Helpers::TagHelper
+  include BrowserDetect::Helper
+  
+  def test_truth
+    assert true
+  end
+
+end

data/test/headliner_test.rb

@@ -0,0 +1,106 @@
+require 'rubygems'
+require 'test/unit'
+require 'headliner/helper'
+
+class HeadlinerTest < Test::Unit::TestCase
+
+  include ActionView::Helpers::TagHelper
+  include Headliner::Helper
+
+  # Make the blank? method available without loading Rails
+  Object.class_eval do   
+    def blank?
+      if respond_to?(:empty?) && respond_to?(:strip)
+        empty? or strip.empty?
+      elsif respond_to?(:empty?)
+        empty?
+      else
+        !self
+      end
+    end 
+  end
+
+  def test_title_is_saved
+    title "Headliner", ""
+    assert_equal "Headliner", @title
+  end
+
+  def test_title_is_saved_with_headline
+    headline = save_title "Headliner", "Headliner: a plugin for setting page titles"
+    assert_equal "Headliner", @title
+    assert_equal "Headliner: a plugin for setting page titles", headline
+  end
+  
+  def test_title_is_site_when_empty
+    title :site => "the.railsi.st"
+    assert_equal nil, @title
+  end
+
+  def test_title_removes_all_tags
+    title 'Headliner is <strong class="underline">cool</strong>'
+    assert_equal "Headliner is cool", @title
+  end
+
+  def test_title_removes_all_tags_but_displays_tags_in_views
+    original_title = save_title 'Headliner is <strong class="underline">cool</strong>', ''
+    assert_equal "Headliner is cool", @title
+    assert_equal 'Headliner is <strong class="underline">cool</strong>', original_title
+  end
+
+  def test_title_is_lowercase
+    @title = "Headliner"
+    full_title = display_title :site => "the.railsi.st", :lowercase => true
+    assert_equal "<title>the.railsi.st | headliner</title>", full_title
+  end
+  
+  def test_title_is_reversed
+    @title = "Headliner"
+    full_title = display_title :site => "the.railsi.st", :reverse => true
+    assert_equal "<title>Headliner | the.railsi.st</title>", full_title
+  end
+  
+  def test_title_has_custom_separator
+    @title = "Headliner"
+    full_title = display_title :site => "the.railsi.st", :separator => "&mdash;"
+    assert_equal "<title>the.railsi.st &mdash; Headliner</title>", full_title
+  end
+
+  def test_title_has_custom_prefix_and_suffix
+    @title = "Headliner"
+    full_title = display_title :site => "the.railsi.st", :prefix => "  ", :suffix => "  "
+    assert_equal "<title>the.railsi.st  |  Headliner</title>", full_title
+  end
+
+  def test_title_has_no_prefix_and_has_custom_separator
+    @title = "Headliner"
+    full_title = display_title :site => "the.railsi.st", :prefix => false, :separator => ":"
+    assert_equal "<title>the.railsi.st: Headliner</title>", full_title
+  end
+
+  def test_title_has_no_suffix_and_has_custom_separator
+    @title = "Headliner"
+    full_title = display_title :site => "the.railsi.st", :suffix => false, :separator => "~"
+    assert_equal "<title>the.railsi.st ~Headliner</title>", full_title
+  end
+
+  def test_title_has_no_prefix_and_suffix_and_has_custom_separator
+    @title = "Headliner"
+    full_title = display_title :site => "the.railsi.st", 
+                               :prefix => false, 
+                               :suffix => false, 
+                               :separator => "&mdash;"
+    assert_equal "<title>the.railsi.st&mdash;Headliner</title>", full_title
+  end
+
+  def test_title_has_all_custom_options
+    @title = "Headliner"
+    full_title = display_title :site => "the.railsi.st", 
+                               :prefix => " ", 
+                               :suffix => " ", 
+                               :separator => ".:.",
+                               :lowercase => true,
+                               :reverse => true
+    assert_equal "<title>headliner .:. the.railsi.st</title>", full_title
+  end
+
+end

data/test/styler_test.rb

@@ -0,0 +1,14 @@
+require 'rubygems'
+require 'test/unit'
+require 'styler/helper'
+
+class StylerTest < Test::Unit::TestCase
+
+  include ActionView::Helpers::TagHelper
+  include Styler::Helper
+  
+  def test_truth
+    assert true
+  end
+
+end

data/test/view_fu_test.rb

@@ -0,0 +1,16 @@
+require 'rubygems'
+require 'test/unit'
+require 'view_fu/meta_helper'
+require 'view_fu/tag_helper'
+
+class ViewFuTest < Test::Unit::TestCase
+
+  include ActionView::Helpers::TagHelper
+  include ViewFu::TagHelper
+  include ViewFu::MetaHelper
+  
+  def test_truth
+    assert true
+  end
+
+end

data/view_fu.gemspec

@@ -0,0 +1,41 @@
+Gem::Specification.new do |s|
+  s.name = 'view_fu'
+  s.version = '0.1.20080705'
+  s.date = '2008-07-05'
+  
+  s.summary = "Lots of handy Rails View helpers. Includes the functionality of Headliner, Styler, and Javascripter"
+  s.description = "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."
+  
+  s.authors = ['Tyler Crocker', 'Patrick Crowley']
+  s.email = 'neorails@gmail.com'
+  s.homepage = 'http://github.com/neorails/view_fu'
+  
+  s.has_rdoc = true
+  s.rdoc_options = ["--main", "README"]
+  s.extra_rdoc_files = ["README"]
+
+  s.add_dependency 'rails', ['>= 2.1']
+  
+  s.files = ["MIT-LICENSE",
+             "README",
+             "Rakefile",
+             "init.rb",
+             "lib/browser_detect/helper.rb",
+             "lib/headliner/helper.rb",
+             "lib/headliner/README",
+             "lib/javascripter/helper.rb",
+             "lib/javascripter/README",
+             "lib/styler/helper.rb",
+             "lib/styler/README",
+             "lib/view_fu/meta_helper.rb",
+             "lib/view_fu/tag_helper.rb",
+             "lib/view_fu.rb",
+             "rails/init.rb",
+             "view_fu.gemspec"]
+  
+  s.test_files = ["test/browser_detect_test.rb",
+                  "test/headliner_test.rb",
+                  "test/styler_test.rb",
+                  "test/view_fu_test.rb"]
+
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification 
+name: neorails-view_fu
+version: !ruby/object:Gem::Version 
+  version: 0.1.20080705
+platform: ruby
+authors: 
+- Tyler Crocker
+- Patrick Crowley
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-07-05 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "2.1"
+    version: 
+description: 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.
+email: neorails@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- MIT-LICENSE
+- README
+- Rakefile
+- init.rb
+- lib/browser_detect/helper.rb
+- lib/headliner/helper.rb
+- lib/headliner/README
+- lib/javascripter/helper.rb
+- lib/javascripter/README
+- lib/styler/helper.rb
+- lib/styler/README
+- lib/view_fu/meta_helper.rb
+- lib/view_fu/tag_helper.rb
+- lib/view_fu.rb
+- rails/init.rb
+- view_fu.gemspec
+has_rdoc: true
+homepage: http://github.com/neorails/view_fu
+post_install_message: 
+rdoc_options: 
+- --main
+- README
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Lots of handy Rails View helpers. Includes the functionality of Headliner, Styler, and Javascripter
+test_files: 
+- test/browser_detect_test.rb
+- test/headliner_test.rb
+- test/styler_test.rb
+- test/view_fu_test.rb