meta-tags 1.1.0

data/.gitignore

@@ -0,0 +1,3 @@
+rdoc
+doc
+pkg

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Dmytro Shteflyuk
+
+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.rdoc

@@ -0,0 +1,195 @@
+= MetaTags
+
+Search Engine Optimization (SEO) plugin for Ruby on Rails applications.
+
+== Installation
+
+There are two options when approaching meta-tags installation:
+
+* using the gem (recommended)
+* install as a Rails plugin
+
+To install as a gem, add this to your environment.rb:
+
+  config.gem 'meta-tags', :lib => 'meta_tags', :source => 'http://gemcutter.org'
+
+And then run the command:
+
+  sudo rake gems:install
+
+To install meta-tags as a Rails plugin use this:
+
+  script/plugin install git://github.com/kpumuk/meta-tags.git
+
+== Titles
+
+Page titles are very important for Search engines. The titles in the
+browser are displayed in the title bar. The search engines would look at
+the this title bar to determine what the page is all about.
+
+  <title>Some Page Title</title>
+  <title>Page Title | Site Title</title>
+
+Recommended title tag length: up to <b>70 characters</b>, <b>10 words</b>.
+
+== Description
+
+Description tags are called meta tags as they are not displayed by the
+browsers as that of titles. But these descriptions may be displayed by
+some search engines. They are used to describe the contents of a page in
+2 or 3 sentences.
+
+  <meta name="description" content="All text about keywords, other keywords" />
+
+Recommended description tag length: up to <b>160 characters</b>.
+
+== Keywords
+
+Meta keywords tag are used to place your keywords that you think a
+surfer would search in Search engines. Repeating keywords unnecessarily
+would be considered spam and you may get permanently banned from SERP's
+
+  <meta name="keywords" content="keyword1, keyword2, keyword3" />
+
+Recommended keywords tag length: up to <b>255 characters</b>, <b>20 words</b>.
+
+== Noindex
+
+By using the noindex meta tag, you can signal to search engines to not 
+include specific pages in their indexes.
+
+  <meta name="robots" content="noindex">
+  <meta name="googlebot" content="noindex">
+
+This is useful for pages like login, password reset, privacy policy, etc.  
+
+Further reading:
+* Blocking Google http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=93708
+* Using meta tags to block access to your site http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=93710
+
+== Nofollow
+
+Nofollow meta tag tells a search engine not to follow the links on a specific
+page. It's entirely likely that a robot might find the same links on some
+other page without a nofollow (perhaps on some other site), and so
+still arrives at your undesired page.
+
+  <meta name="robots" content="nofollow">
+  <meta name="googlebot" content="nofollow">
+
+Further reading:
+* About rel="nofollow" http://www.google.com/support/webmasters/bin/answer.py?answer=96569
+* Meta tags http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=79812
+
+== MetaTags Usage
+
+First, add this code to your main layout:
+
+  <head>
+    <%= display_meta_tags :site => 'My website' %>
+  </head>
+
+Then, to set the page title, add this to each of your views (see below for other options):
+
+  <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>
+
+You can find allowed options for +display_meta_tags+ method below.
+
+=== Using MetaTags in controller
+
+You can define following instance variables:
+
+  @page_title = 'Member Login'
+  @page_description = 'Member login page.'
+  @page_keywords = 'Site, Login, Members'
+  
+Also you could use +set_meta_tags+ method to define all meta tags simultaneously:
+  
+  set_meta_tags :title => 'Member Login',
+                :description => 'Member login page.',
+                :keywords => 'Site, Login, Members'
+
+You can find allowed options for +set_meta_tags+ method below.
+
+=== Using MetaTags in view
+
+To set meta tags you can use following methods:
+
+  <% title 'Member Login' %>
+  <% description 'Member login page.' %>
+  <% keywords 'Member login page.' %>
+
+Also there is +set_meta_tags+ method exists:
+
+  <% set_meta_tags :title => 'Member Login',
+                   :description => 'Member login page.',
+                   :keywords => 'Site, Login, Members' %>
+
+The +title+ methods returns title itself, so you can use it to show the title
+somewhere on the page:
+
+  <h1><%= title 'Member Login' %></h1>
+
+If you want to set the title and display another text, use this:
+
+  <h1><%= title 'Member Login', 'Here you can login to the site:' %></h1>
+
+=== Allowed options for +display_meta_tags+ and +set_meta_tags+ methods
+
+Use these options to customize the title format:
+
+* <tt>:site</tt> -- site title;
+* <tt>:title</tt> -- page title;
+* <tt>:description</tt> -- page description;
+* <tt>:keywords</tt> -- page keywords;
+* <tt>:prefix</tt> -- text between site name and separator;
+* <tt>:separator</tt> -- text used to separate website name from page title;
+* <tt>:suffix</tt> -- text between separator and page title;
+* <tt>:lowercase</tt> -- when true, the page name will be lowercase;
+* <tt>:reverse</tt> -- when true, the page and site names will be reversed;
+* <tt>:noindex</tt> -- add noindex meta tag; when true, 'robots' will be used, otherwise the string will be used;
+* <tt>:nofollow</tt> -- add nofollow meta tag; when true, 'robots' will be used, otherwise the string will be used.
+
+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 %>
+
+=== Allowed values
+
+You can specify +title+ as a string or array:
+
+  set_meta_tags :title => ['part1', 'part2'], :site => 'site'
+  # site | part1 | part2
+  set_meta_tags :title => ['part1', 'part2'], :reverse => true, :site => 'site'
+  # part2 | part1 | site
+
+Keywords can be passed as string of comma-separated values, or as an array:
+
+  set_meta_tags :keywords => ['tag1', 'tag2']
+  # tag1, tag2
+
+Description is a string (HTML will be stripped from output string).
+
+== Alternatives
+
+There are several plugins influenced me to create this one:
+
+* Headliner: http://github.com/mokolabs/headliner
+* meta_on_rals: http://github.com/ashchan/meta_on_rails
+
+== Credits
+
+* Dmytro Shteflyuk (author) <kpumuk@kpumuk.info> http://kpumuk.info
+* Morgan Roderick (contributor) <morgan@roderick.dk> http://roderick.dk

data/Rakefile

@@ -0,0 +1,38 @@
+require 'rake'
+require 'spec/rake/spectask'
+require 'rake/rdoctask'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name        = 'meta-tags'
+    gemspec.summary     = 'Collection of SEO helpers for Ruby on Rails'
+    gemspec.description = 'Search Engine Optimization (SEO) plugin for Ruby on Rails applications.'
+    gemspec.email       = 'kpumuk@kpumuk.info'
+    gemspec.homepage    = 'http://github.com/kpumuk/meta-tags'
+    gemspec.authors     = ['Dmytro Shteflyuk']
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts 'Jeweler not available. Install it with: sudo gem install jeweler'
+end
+
+desc 'Default: run unit tests.'
+task :default => :spec
+
+desc 'Test the meta-tags plugin.'
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs << 'lib'
+  t.pattern = 'spec/**/*_spec.rb'
+  t.verbose = true
+  t.spec_opts = ['-cfs']
+end
+
+desc 'Generate documentation for the meta-tags plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'MetaTags'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.rdoc')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 1
+:minor: 1
+:patch: 0

data/init.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + '/lib/meta_tags'

data/lib/meta_tags.rb

@@ -0,0 +1,8 @@
+module MetaTags
+end
+
+require File.dirname(__FILE__) + '/meta_tags/view_helper'
+require File.dirname(__FILE__) + '/meta_tags/controller_helper'
+
+ActionView::Base.send :include, MetaTags::ViewHelper
+ActionController::Base.send :include, MetaTags::ControllerHelper

data/lib/meta_tags/controller_helper.rb

@@ -0,0 +1,43 @@
+# Contains methods to use in controllers.
+#
+# You can define several instance variables to set meta tags:
+#   @page_title = 'Member Login'
+#   @page_description = 'Member login page.'
+#   @page_keywords = 'Site, Login, Members'
+#
+# Also you can use +set_meta_tags+ method, that have the same parameters
+# as <tt>MetaTags.set_meta_tags</tt>.
+module MetaTags
+  module ControllerHelper
+    def self.included(base)
+      base.send :include, InstanceMethods
+      base.class_eval do
+        alias_method_chain :render, :meta_tags
+      end
+    end
+
+    module InstanceMethods
+      protected
+
+        # Processes the <tt>@page_title</tt>, <tt>@page_keywords</tt>, and
+        # <tt>@page_description</tt> instance variables and calls +render+.
+        def render_with_meta_tags(options = nil, extra_options = {}, &block)
+          meta_tags = {}
+          meta_tags[:title] = @page_title if @page_title
+          meta_tags[:keywords] = @page_keywords if @page_keywords
+          meta_tags[:description] = @page_description if @page_description
+          set_meta_tags(meta_tags)
+
+          render_without_meta_tags(options, extra_options, &block)
+        end
+      
+        # Set meta tags for the page.
+        #
+        # See <tt>MetaTags.set_meta_tags</tt> for details.
+        def set_meta_tags(meta_tags)
+          @meta_tags ||= {}
+          @meta_tags.merge!(meta_tags || {})
+        end
+    end
+  end
+end

data/lib/meta_tags/view_helper.rb

@@ -0,0 +1,199 @@
+# Contains methods to use in views and helpers.
+module MetaTags
+  module ViewHelper
+    # Set meta tags for the page.
+    #
+    # Method could be used several times, and all options passed will
+    # be merged. If you will set the same property several times, last one
+    # will take precedence.
+    #
+    # Examples:
+    #   set_meta_tags :title => 'Login Page', :description => 'Here you can login'
+    #   set_meta_tags :keywords => 'authorization, login'
+    #
+    # Usually you will not call this method directly. Use +title+, +keywords+,
+    # +description+ for your daily tasks.
+    #
+    # See +display_meta_tags+ for allowed options.
+    def set_meta_tags(meta_tags = {})
+      @meta_tags ||= {}
+      @meta_tags.merge!(meta_tags || {})
+    end
+  
+    # Set the page title and return it back.
+    #
+    # This method is best suited for use in helpers. It sets the page title
+    # and returns it (or +headline+ if specified).
+    #
+    # Examples:
+    #   <%= title 'Login Page' %> => title='Login Page', return='Login Page'
+    #   <%= title 'Login Page', 'Please login' %> => title='Login Page', return='Please Login'
+    #
+    # You can specify +title+ as a string or array:
+    #   title :title => ['part1', 'part2']
+    #   # part1 | part2
+    def title(title, headline = '')
+      set_meta_tags(:title => title)
+      headline.blank? ? title : headline
+    end
+  
+    # Set the page keywords.
+    #
+    # Keywords can be passed as string of comma-separated values, or as an array:
+    #
+    #   set_meta_tags :keywords => ['tag1', 'tag2']
+    #   # tag1, tag2
+    #
+    # Examples:
+    #   <% keywords 'keyword1, keyword2' %>
+    #   <% keywords %w(keyword1 keyword2) %>
+    def keywords(keywords)
+      set_meta_tags(:keywords => keywords)
+      keywords
+    end
+  
+    # Set the page description.
+    #
+    # Description is a string (HTML will be stripped from output string).
+    #
+    # Examples:
+    #   <% description 'This is login page' %>
+    def description(description)
+      set_meta_tags(:description => description)
+      description
+    end
+
+    # Set the noindex meta tag
+    #
+    # You can specify noindex as a boolean or string 
+    #
+    # Examples:
+    #   <% noindex true %>
+    #   <% noindex 'googlebot' %>
+    def noindex(noindex)
+      set_meta_tags(:noindex => noindex)
+      noindex
+    end
+
+    # Set the nofollow meta tag
+    #
+    # You can specify nofollow as a boolean or string 
+    #
+    # Examples:
+    #   <% nofollow true %>
+    #   <% nofollow 'googlebot' %>
+    def nofollow(nofollow)
+      set_meta_tags(:nofollow => nofollow)
+      nofollow
+    end
+  
+    # Set default meta tag values and display meta tags.
+    #
+    # This method should be used in layout file.
+    #
+    # Examples:
+    #   <head>
+    #     <%= display_meta_tags :site => 'My website' %>
+    #   </head>
+    #
+    # Allowed options:
+    # * <tt>:site</tt> -- site title;
+    # * <tt>:title</tt> -- page title;
+    # * <tt>:description</tt> -- page description;
+    # * <tt>:keywords</tt> -- page keywords;
+    # * <tt>:prefix</tt> -- text between site name and separator;
+    # * <tt>:separator</tt> -- text used to separate website name from page title;
+    # * <tt>:suffix</tt> -- text between separator and page title;
+    # * <tt>:lowercase</tt> -- when true, the page name will be lowercase;
+    # * <tt>:reverse</tt> -- when true, the page and site names will be reversed;
+    # * <tt>:noindex</tt> -- add noindex meta tag; when true, 'robots' will be used, otherwise the string will be used;
+    # * <tt>:nofollow</tt> -- add nofollow meta tag; when true, 'robots' will be used, otherwise the string will be used.
+    def display_meta_tags(default = {})
+      meta_tags = (default || {}).merge(@meta_tags || {})
+
+      # Prefix (leading space)
+      if meta_tags[:prefix]
+        prefix = meta_tags[:prefix]
+      elsif meta_tags[:prefix] === false
+        prefix = ''
+      else
+        prefix = ' '
+      end
+    
+      # Separator
+      unless meta_tags[:separator].blank?
+        separator = meta_tags[:separator]
+      else
+        separator = '|'
+      end
+    
+      # Suffix (trailing space)
+      if meta_tags[:suffix]
+        suffix = meta_tags[:suffix]
+      elsif meta_tags[:suffix] === false
+        suffix = ''
+      else
+        suffix = ' '
+      end
+    
+      # Title
+      title = meta_tags[:title]
+      if meta_tags[:lowercase] === true
+        title = title.downcase unless title.blank?
+      end
+    
+      # title
+      if title.blank?
+        result = content_tag :title, meta_tags[:site]
+      else
+        title = normalize_title(title)
+        title = [meta_tags[:site]] + title
+        title.reverse! if meta_tags[:reverse] === true
+        sep = prefix + separator + suffix
+        result = content_tag(:title, title.join(sep))
+      end
+
+      # description
+      description = normalize_description(meta_tags[:description])
+      result << "\n" + tag(:meta, :name => :description, :content => description) unless description.blank?
+    
+      # keywords
+      keywords = normalize_keywords(meta_tags[:keywords])
+      result << "\n" + tag(:meta, :name => :keywords, :content => keywords) unless keywords.blank?
+
+      # noindex & nofollow
+      noindex_name = meta_tags[:noindex].is_a?(String) ? meta_tags[:noindex] : 'robots'
+      nofollow_name = meta_tags[:nofollow].is_a?(String) ? meta_tags[:nofollow] : 'robots'
+  
+      if noindex_name == nofollow_name
+        content = [(meta_tags[:noindex] ? 'noindex' : nil), (meta_tags[:nofollow] ? 'nofollow' : nil)].compact.join(', ')
+        result << "\n" + tag(:meta, :name => noindex_name, :content => content) unless content.blank?
+      else
+        result << "\n" + tag(:meta, :name => noindex_name, :content => 'noindex') if meta_tags[:noindex]
+        result << "\n" + tag(:meta, :name => nofollow_name, :content => 'nofollow') if meta_tags[:nofollow]
+      end
+
+      return result
+    end
+  
+    private
+  
+      def normalize_title(title)
+        if title.is_a? String
+          title = [title]
+        end
+        title.map { |t| h(strip_tags(t)) }
+      end
+    
+      def normalize_description(description)
+        return '' unless description
+        truncate(strip_tags(description).gsub(/\s+/, ' '), :length => 200)
+      end
+    
+      def normalize_keywords(keywords)
+        return '' unless keywords
+        keywords = keywords.flatten.join(', ') if keywords.is_a?(Array)
+        strip_tags(keywords).mb_chars.downcase
+      end
+  end
+end

data/meta-tags.gemspec

@@ -0,0 +1,52 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{meta-tags}
+  s.version = "1.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dmytro Shteflyuk"]
+  s.date = %q{2009-11-05}
+  s.description = %q{Search Engine Optimization (SEO) plugin for Ruby on Rails applications.}
+  s.email = %q{kpumuk@kpumuk.info}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "MIT-LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "init.rb",
+     "lib/meta_tags.rb",
+     "lib/meta_tags/controller_helper.rb",
+     "lib/meta_tags/view_helper.rb",
+     "meta-tags.gemspec",
+     "spec/meta_tags_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/kpumuk/meta-tags}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Collection of SEO helpers for Ruby on Rails}
+  s.test_files = [
+    "spec/meta_tags_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/spec/meta_tags_spec.rb

@@ -0,0 +1,278 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe MetaTags::ViewHelper do
+  before :each do
+    @view = ActionView::Base.new
+  end
+  
+  context 'module' do
+    it 'should be mixed into ActionView::Base' do
+      ActionView::Base.included_modules.should include(MetaTags::ViewHelper)
+    end
+    
+    it 'should respond to "title" helper' do
+      @view.should respond_to(:title)
+    end
+    
+    it 'should respond to "description" helper' do
+      @view.should respond_to(:description)
+    end
+    
+    it 'should respond to "keywords" helper' do
+      @view.should respond_to(:keywords)
+    end
+
+    it 'should respond to "noindex" helper' do
+      @view.should respond_to(:noindex)
+    end
+
+    it 'should respond to "nofollow" helper' do
+      @view.should respond_to(:nofollow)
+    end
+
+    it 'should respond to "set_meta_tags" helper' do
+      @view.should respond_to(:set_meta_tags)
+    end
+
+    it 'should respond to "display_meta_tags" helper' do
+      @view.should respond_to(:display_meta_tags)
+    end
+  end
+  
+  context 'returning values' do
+    it 'should return title' do
+      @view.title('some-title').should == 'some-title'
+    end
+
+    it 'should return headline if specified' do
+      @view.title('some-title', 'some-headline').should == 'some-headline'
+    end
+    
+    it 'should return description' do
+      @view.description('some-description').should == 'some-description'
+    end
+
+    it 'should return keywords' do
+      @view.keywords('some-keywords').should == 'some-keywords'
+    end
+
+    it 'should return noindex' do
+      @view.noindex('some-noindex').should == 'some-noindex'
+    end
+
+    it 'should return nofollow' do
+      @view.noindex('some-nofollow').should == 'some-nofollow'
+    end
+  end
+  
+  context 'title' do
+    it 'should use website name if title is empty' do
+      @view.display_meta_tags(:site => 'someSite').should == '<title>someSite</title>'
+    end
+    
+    it 'should display title when "title" used' do
+      @view.title('someTitle')
+      @view.display_meta_tags(:site => 'someSite').should == '<title>someSite | someTitle</title>'
+    end
+
+    it 'should display title when "set_meta_tags" used' do
+      @view.set_meta_tags(:title => 'someTitle')
+      @view.display_meta_tags(:site => 'someSite').should == '<title>someSite | someTitle</title>'
+    end
+
+    it 'should display custom title if given' do
+      @view.title('someTitle')
+      @view.display_meta_tags(:site => 'someSite', :title => 'defaultTitle').should == '<title>someSite | someTitle</title>'
+    end
+
+    it 'should use website before page by default' do
+      @view.display_meta_tags(:site => 'someSite', :title => 'someTitle').should == '<title>someSite | someTitle</title>'
+    end
+
+    it 'should only use markup in titles in the view' do
+      @view.title('<b>someTitle</b>').should == '<b>someTitle</b>'
+      @view.display_meta_tags(:site => 'someSite').should == '<title>someSite | someTitle</title>'
+    end
+
+    it 'should use page before website if :reverse' do
+      @view.display_meta_tags(:site => 'someSite', :title => 'someTitle', :reverse => true).should == '<title>someTitle | someSite</title>'
+    end
+
+    it 'should be lowercase if :lowercase' do
+      @view.display_meta_tags(:site => 'someSite', :title => 'someTitle', :lowercase => true).should == '<title>someSite | sometitle</title>'
+    end
+
+    it 'should use custom separator if :separator' do
+      @view.title('someTitle')
+      @view.display_meta_tags(:site => 'someSite', :separator => '-').should == '<title>someSite - someTitle</title>'
+      @view.display_meta_tags(:site => 'someSite', :separator => ':').should == '<title>someSite : someTitle</title>'
+      @view.display_meta_tags(:site => 'someSite', :separator => '&mdash;').should == '<title>someSite &mdash; someTitle</title>'
+    end
+
+    it 'should use custom prefix and suffix if available' do
+      @view.display_meta_tags(:site => 'someSite', :title => 'someTitle', :prefix => ' -', :suffix => '- ').should == '<title>someSite -|- someTitle</title>'
+    end
+
+    it 'should collapse prefix if false' do
+      @view.display_meta_tags(:site => 'someSite', :title => 'someTitle', :prefix => false).should == '<title>someSite| someTitle</title>'
+    end
+
+    it 'should collapse suffix if false' do
+      @view.display_meta_tags(:site => 'someSite', :title => 'someTitle', :suffix => false).should == '<title>someSite |someTitle</title>'
+    end
+
+    it 'should use all custom options if available' do
+      @view.display_meta_tags(:site => 'someSite',
+                              :title => 'someTitle',
+                              :prefix => ' -',
+                              :suffix => '+ ',
+                              :separator => ':',
+                              :lowercase => true,
+                              :reverse => true).should == '<title>sometitle -:+ someSite</title>'
+    end
+    
+    it 'shold allow Arrays in title' do
+      @view.display_meta_tags(:site => 'someSite', :title => ['someTitle', 'anotherTitle']).should == '<title>someSite | someTitle | anotherTitle</title>'
+    end
+
+    it 'shold build title in reverse order if :reverse' do
+      @view.display_meta_tags(:site => 'someSite',
+                              :title => ['someTitle', 'anotherTitle'],
+                              :prefix => ' -',
+                              :suffix => '+ ',
+                              :separator => ':',
+                              :reverse => true).should == '<title>anotherTitle -:+ someTitle -:+ someSite</title>'
+    end
+  end
+  
+  context 'displaying description' do
+    it 'should display description when "description" used' do
+      @view.description('someDescription')
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="someDescription" name="description" />')
+    end
+
+    it 'should display description when "set_meta_tags" used' do
+      @view.set_meta_tags(:description => 'someDescription')
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="someDescription" name="description" />')
+    end
+
+    it 'should display default description' do
+      @view.display_meta_tags(:site => 'someSite', :description => 'someDescription').should include('<meta content="someDescription" name="description" />')
+    end
+
+    it 'should use custom description if given' do
+      @view.description('someDescription')
+      @view.display_meta_tags(:site => 'someSite', :description => 'defaultDescription').should include('<meta content="someDescription" name="description" />')
+    end
+
+    it 'should strip multiple spaces' do
+      @view.display_meta_tags(:site => 'someSite', :description => "some \n\r\t description").should include('<meta content="some description" name="description" />')
+    end
+
+    it 'should strip HTML' do
+      @view.display_meta_tags(:site => 'someSite', :description => "<p>some <b>description</b></p>").should include('<meta content="some description" name="description" />')
+    end
+  end
+  
+  context 'displaying keywords' do
+    it 'should display keywords when "keywords" used' do
+      @view.keywords('some-keywords')
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="some-keywords" name="keywords" />')
+    end
+
+    it 'should display keywords when "set_meta_tags" used' do
+      @view.set_meta_tags(:keywords => 'some-keywords')
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="some-keywords" name="keywords" />')
+    end
+
+    it 'should display default keywords' do
+      @view.display_meta_tags(:site => 'someSite', :keywords => 'some-keywords').should include('<meta content="some-keywords" name="keywords" />')
+    end
+
+    it 'should use custom keywords if given' do
+      @view.keywords('some-keywords')
+      @view.display_meta_tags(:site => 'someSite', :keywords => 'default_keywords').should include('<meta content="some-keywords" name="keywords" />')
+    end
+
+    it 'should lowercase keywords' do
+      @view.display_meta_tags(:site => 'someSite', :keywords => 'someKeywords').should include('<meta content="somekeywords" name="keywords" />')
+    end
+
+    it 'should join keywords from Array' do
+      @view.display_meta_tags(:site => 'someSite', :keywords => %w(keyword1 keyword2)).should include('<meta content="keyword1, keyword2" name="keywords" />')
+    end
+
+    it 'should join keywords from nested Arrays' do
+      @view.display_meta_tags(:site => 'someSite', :keywords => [%w(keyword1 keyword2), 'keyword3']).should include('<meta content="keyword1, keyword2, keyword3" name="keywords" />')
+    end
+  end
+  
+  context 'displaying noindex' do
+    it 'should display noindex when "noindex" used' do
+      @view.noindex(true)
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="noindex" name="robots" />')
+    end
+
+    it 'should display noindex when "set_meta_tags" used' do
+      @view.set_meta_tags(:noindex => true)
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="noindex" name="robots" />')
+    end
+
+    it 'should use custom noindex if given' do
+      @view.noindex('some-noindex')
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="noindex" name="some-noindex" />')
+    end
+
+    it 'should display nothing by default' do
+      @view.display_meta_tags(:site => 'someSite').should_not include('<meta content="noindex"')
+    end
+  end
+
+  context 'displaying nofollow' do
+    it 'should display nofollow when "nofollow" used' do
+      @view.nofollow(true)
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="nofollow" name="robots" />')
+    end
+
+    it 'should display nofollow when "set_meta_tags" used' do
+      @view.set_meta_tags(:nofollow => true)
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="nofollow" name="robots" />')
+    end
+
+    it 'should use custom nofollow if given' do
+      @view.nofollow('some-nofollow')
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="nofollow" name="some-nofollow" />')
+    end
+
+    it 'should display nothing by default' do
+      @view.display_meta_tags(:site => 'someSite').should_not include('<meta content="nofollow"')
+    end
+  end
+  
+  context 'displaying both nofollow and noindex' do
+    it 'should be displayed when set using helpers' do
+      @view.noindex(true)
+      @view.nofollow(true)
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="noindex, nofollow" name="robots" />')
+    end
+
+    it 'should be displayed when "set_meta_tags" used' do
+      @view.set_meta_tags(:nofollow => true, :noindex => true)
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="noindex, nofollow" name="robots" />')
+    end
+
+    it 'should use custom name if string is used' do
+      @view.noindex('some-name')
+      @view.nofollow('some-name')
+      @view.display_meta_tags(:site => 'someSite').should include('<meta content="noindex, nofollow" name="some-name" />')
+    end
+
+    it 'should display two meta tags when different names used' do
+      @view.noindex('some-noindex')
+      @view.nofollow('some-nofollow')
+      content = @view.display_meta_tags(:site => 'someSite')
+      content.should include('<meta content="noindex" name="some-noindex" />')
+      content.should include('<meta content="nofollow" name="some-nofollow" />')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+require 'rubygems'
+require 'action_controller'
+require 'action_view'
+
+require File.join(File.dirname(__FILE__), "../init")

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+name: meta-tags
+version: !ruby/object:Gem::Version 
+  version: 1.1.0
+platform: ruby
+authors: 
+- Dmytro Shteflyuk
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-05 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Search Engine Optimization (SEO) plugin for Ruby on Rails applications.
+email: kpumuk@kpumuk.info
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- init.rb
+- lib/meta_tags.rb
+- lib/meta_tags/controller_helper.rb
+- lib/meta_tags/view_helper.rb
+- meta-tags.gemspec
+- spec/meta_tags_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/kpumuk/meta-tags
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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.3.5
+signing_key: 
+specification_version: 3
+summary: Collection of SEO helpers for Ruby on Rails
+test_files: 
+- spec/meta_tags_spec.rb
+- spec/spec_helper.rb