frontend-helpers 0.0.1.beta.1

data/Gemfile

@@ -0,0 +1,18 @@
+source "http://rubygems.org"
+
+# Rails so we can extend it
+gem "rails", "~> 3.1.0.rc4"
+
+gem "haml-rails", "~> 0.3.4"
+gem "sass-rails", "~> 3.1.0.rc"
+
+gem "sprockets", "~> 2.0.0.beta.10"
+
+if RUBY_VERSION < "1.9"
+  gem "ruby-debug", ">= 0.10.3"
+end
+
+group :development do
+  # Using jeweler because it's just so easy
+  gem "jeweler", "~> 1.6.4"
+end

data/Gemfile.lock

@@ -0,0 +1,108 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (3.1.0.rc4)
+      actionpack (= 3.1.0.rc4)
+      mail (~> 2.3.0)
+    actionpack (3.1.0.rc4)
+      activemodel (= 3.1.0.rc4)
+      activesupport (= 3.1.0.rc4)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      i18n (~> 0.6)
+      rack (~> 1.3.0)
+      rack-cache (~> 1.0.1)
+      rack-mount (~> 0.8.1)
+      rack-test (~> 0.6.0)
+      sprockets (~> 2.0.0.beta.10)
+      tzinfo (~> 0.3.27)
+    activemodel (3.1.0.rc4)
+      activesupport (= 3.1.0.rc4)
+      bcrypt-ruby (~> 2.1.4)
+      builder (~> 3.0.0)
+      i18n (~> 0.6)
+    activerecord (3.1.0.rc4)
+      activemodel (= 3.1.0.rc4)
+      activesupport (= 3.1.0.rc4)
+      arel (~> 2.1.1)
+      tzinfo (~> 0.3.27)
+    activeresource (3.1.0.rc4)
+      activemodel (= 3.1.0.rc4)
+      activesupport (= 3.1.0.rc4)
+    activesupport (3.1.0.rc4)
+      multi_json (~> 1.0)
+    arel (2.1.3)
+    bcrypt-ruby (2.1.4)
+    builder (3.0.0)
+    erubis (2.7.0)
+    git (1.2.5)
+    haml (3.1.2)
+    haml-rails (0.3.4)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      haml (~> 3.0)
+      railties (~> 3.0)
+    hike (1.1.0)
+    i18n (0.6.0)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    mail (2.3.0)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    multi_json (1.0.3)
+    polyglot (0.3.1)
+    rack (1.3.0)
+    rack-cache (1.0.2)
+      rack (>= 0.4)
+    rack-mount (0.8.1)
+      rack (>= 1.0.0)
+    rack-ssl (1.3.2)
+      rack
+    rack-test (0.6.0)
+      rack (>= 1.0)
+    rails (3.1.0.rc4)
+      actionmailer (= 3.1.0.rc4)
+      actionpack (= 3.1.0.rc4)
+      activerecord (= 3.1.0.rc4)
+      activeresource (= 3.1.0.rc4)
+      activesupport (= 3.1.0.rc4)
+      bundler (~> 1.0)
+      railties (= 3.1.0.rc4)
+    railties (3.1.0.rc4)
+      actionpack (= 3.1.0.rc4)
+      activesupport (= 3.1.0.rc4)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (~> 0.14.6)
+    rake (0.9.2)
+    rdoc (3.8)
+    sass (3.1.4)
+    sass-rails (3.1.0.rc.4)
+      actionpack (~> 3.1.0.rc1)
+      railties (~> 3.1.0.rc1)
+      sass (>= 3.1.4)
+      sprockets (>= 2.0.0.beta.9)
+    sprockets (2.0.0.beta.10)
+      hike (~> 1.0)
+      rack (~> 1.0)
+      tilt (!= 1.3.0, ~> 1.1)
+    thor (0.14.6)
+    tilt (1.3.2)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.29)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  haml-rails (~> 0.3.4)
+  jeweler (~> 1.6.4)
+  rails (~> 3.1.0.rc4)
+  sass-rails (~> 3.1.0.rc)
+  sprockets (~> 2.0.0.beta.10)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Christopher Hein
+
+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/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 YOURNAME
+
+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.md

@@ -0,0 +1,97 @@
+# Frontend Helpers #
+
+This is a collection of Rails 3.1 Helpers that I have compiled together into one nice neat special little gem... it'll handle doing things such as Meta tag creation, Facebook Open Graph Tag Creation, javascript integration for, Google Analytics, Chartbeat, Inspectlet, Mixpanel, Woopra, Kissmetrics, Quantcast, and Olark, as well I've packaged in a few of my favorite/most used javascript libraries for building amazing web apps, and last but not least, added a great `reset.css.sass` file that goes really nicely with my `variables.css.sass` file, for a basic clean view.
+
+Try it on your next project, I'm sure you'll like it.
+
+## Getting Started ##
+
+First in your Rails 3.1 Project start by adding this to your Gemfile:
+
+    gem "frontend-helpers"
+
+Then run `bundle install` to install the gem from RubyGems
+
+## Next Steps ##
+
+If you plan on using the gem for the Rails Helpers, keep reading if you'd only like to use it for the access to the javascript assets & css assets you can skip ahead...
+
+Anyways for the helpers your going to need to generate a few files first to do so run:
+
+    $ rails g frontend:install
+
+This should come up and tell you that it's copying `config/settings.yml`, `config/services.yml` & `app/assets/stylesheets/variables.css.sass`
+
+Then you can start editing them:
+
+### Settings.yml ###
+
+Before you start adding your content to the `settings.yml` you should probably start by including the helper in your `application_controller.rb` add:
+
+    include FrontendHelpers::MetatagHelper
+
+Next where ever you want the metatags to appear use:
+
+    - meta_tags
+
+In the `settings.yml` you'll find a list of tags that can be filled out with your applications information all of these tags will get replicated into meta tags, if you choose not to use one you can either leave it blank or remove it.
+
+Of course just because they are set in this file does not mean you can't change them per page this is how you would do that....
+
+Say for instance you set the key `title`
+
+    :title: "Chris Hein's Site"
+
+And on the homepage you liked that, but maybe on the about page you would like it to say `About Chris Hein` with this plugin that's really simple, in your action for your about page simple add:
+
+    @meta_title = "About Chris Hein"
+
+This will overwrite the current title with whatever you'd like. This is the list of available tags and how to overwrite them:
+
+    title: @meta_title,
+    keywords: @meta_keywords,
+    description: @meta_description,
+    author: @meta_author,
+    email: @meta_email,
+    copyright: @meta_copyright,
+    generator: @meta_generator,
+    rating: @meta_rating,
+    language: @meta_language,
+    distribution: @meta_distribution,
+    robots: @robots,
+    :"fb:app_id" => @meta_fb_app_id,
+    :"og:title" => @meta_og_title,
+    :"og:description" => @meta_og_description,
+    :"og:url" => request.url,
+    :"og:site_name" => @meta_og_site_name,
+    :"og:type" => @meta_og_type,
+    :"og:image" => @meta_og_image,
+    :"og:locality" => @meta_og_locality,
+    :"og:region" => @meta_og_region,
+    :"og:country_name" => @meta_og_country_name,
+    :"og:phone_number" => @meta_og_phone_number
+
+### Services.yml ###
+
+TODO: Write how to use this
+
+
+### Assets ###
+
+TODO: Write how to use this
+
+
+## Contributing to Frontend Helpers ##
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright ##
+
+Copyright (c) 2011 Christopher Hein. See LICENSE.txt for
+further details.

data/Rakefile

@@ -0,0 +1,53 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "frontend-helpers"
+  gem.homepage = "http://github.com/christopherhein/frontend-helpers"
+  gem.license = "MIT"
+  gem.summary = %Q{Collection of useful frontend helpers for Rails 3.1 applications.}
+  gem.description = %Q{Large collection of useful Rails 3.1 helpers for SEO, Metatags, Facebook OG tags, integration for analytics services like google, woopra, olark, mixpanel and much much more...}
+  gem.email = "me@christopherhein.com"
+  gem.authors = ["Christopher Hein"]
+  gem.version = "0.0.1.beta.1"
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "testing-gem #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/config/services.yml

@@ -0,0 +1,95 @@
+:google:
+  :development:
+    :account_id: ""
+    :site_name: ""
+    :maps_api_key: ""
+
+  :test:
+    :account_id: ""
+    :site_name: ""
+    :maps_api_key: ""
+
+  :production:
+    :account_id: ""
+    :site_name: ""
+    :maps_api_key: ""
+
+
+:chartbeat:
+  :development:
+    :uid: ""
+    :domain: ""
+
+  :test:
+    :uid: ""
+    :domain: ""
+
+  :production:
+    :uid: ""
+    :domain: ""
+
+
+:inspectlet:
+  :development:
+    :setup: false
+
+  :test:
+    :setup: false
+
+  :production:
+    :setup: false
+
+
+:mixpanel:
+  :development:
+    :init: ""
+
+  :test:
+    :init: ""
+
+  :production:
+    :init: ""
+
+
+:woopra:
+  :development:
+    :domain: ""
+
+  :test:
+    :domain: ""
+
+  :production:
+    :domain: ""
+
+
+:kissmetrics:
+  :development:
+    :setup: false
+
+  :test:
+    :setup: false
+
+  :production:
+    :setup: false
+
+
+:quantcast:
+  :development:
+    :qacct: ""
+
+  :test:
+    :qacct: ""
+
+  :production:
+    :qacct: ""
+
+
+:olark:
+  :development:
+    :identify: ""
+
+  :test:
+    :identify: ""
+
+  :production:
+    :identify: ""

data/config/settings.yml

@@ -0,0 +1,24 @@
+:site:
+  :title: ""
+  :keywords: ""
+  :description: ""
+  :author: ""
+  :email: ""
+  :copyright: ""
+  :generator: ""
+  :rating: ""
+  :language: ""
+  :distribution: ""
+  :robots: ""
+  :"fb:app_id": ""
+  :"og:title": ""
+  :"og:description": ""
+  :"og:url": ""
+  :"og:site_name": ""
+  :"og:type": ""
+  :"og:image": ""
+  :"og:locality": ""
+  :"og:region": ""
+  :"og:country_name": ""
+  :"og:phone_number": ""
+

data/frontend-helpers.gemspec

@@ -0,0 +1,117 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{frontend-helpers}
+  s.version = "0.0.1.beta.1"
+
+  s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Christopher Hein"]
+  s.date = %q{2011-07-10}
+  s.description = %q{Large collection of useful Rails 3.1 helpers for SEO, Metatags, Facebook OG tags, integration for analytics services like google, woopra, olark, mixpanel and much much more...}
+  s.email = %q{me@christopherhein.com}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "MIT-LICENSE",
+    "README.md",
+    "Rakefile",
+    "config/services.yml",
+    "config/settings.yml",
+    "frontend-helpers.gemspec",
+    "lib/.DS_Store",
+    "lib/asset-helpers/rails.rb",
+    "lib/frontend-helpers.rb",
+    "lib/frontend-helpers/html5_helper.rb",
+    "lib/frontend-helpers/metatag_helper.rb",
+    "lib/frontend-helpers/services_helper.rb",
+    "lib/generators/frontend/install/install_generator.rb",
+    "lib/tasks/frontend-helpers_tasks.rake",
+    "script/rails",
+    "test/dummy/Rakefile",
+    "test/dummy/app/assets/javascripts/application.js",
+    "test/dummy/app/assets/stylesheets/application.css",
+    "test/dummy/app/controllers/application_controller.rb",
+    "test/dummy/app/helpers/application_helper.rb",
+    "test/dummy/app/mailers/.gitkeep",
+    "test/dummy/app/models/.gitkeep",
+    "test/dummy/app/views/layouts/application.html.erb",
+    "test/dummy/config.ru",
+    "test/dummy/config/application.rb",
+    "test/dummy/config/boot.rb",
+    "test/dummy/config/database.yml",
+    "test/dummy/config/environment.rb",
+    "test/dummy/config/environments/development.rb",
+    "test/dummy/config/environments/production.rb",
+    "test/dummy/config/environments/test.rb",
+    "test/dummy/config/initializers/backtrace_silencers.rb",
+    "test/dummy/config/initializers/inflections.rb",
+    "test/dummy/config/initializers/mime_types.rb",
+    "test/dummy/config/initializers/secret_token.rb",
+    "test/dummy/config/initializers/session_store.rb",
+    "test/dummy/config/initializers/wrap_parameters.rb",
+    "test/dummy/config/locales/en.yml",
+    "test/dummy/config/routes.rb",
+    "test/dummy/log/.gitkeep",
+    "test/dummy/public/404.html",
+    "test/dummy/public/422.html",
+    "test/dummy/public/500.html",
+    "test/dummy/public/favicon.ico",
+    "test/dummy/script/rails",
+    "test/frontend-helpers_test.rb",
+    "test/test_helper.rb",
+    "vendor/assets/javascripts/backbone/backbone.js",
+    "vendor/assets/javascripts/backbone/index.js",
+    "vendor/assets/javascripts/backbone/underscore.js",
+    "vendor/assets/javascripts/ie/dd_belatedpng.js",
+    "vendor/assets/javascripts/ie/index.js",
+    "vendor/assets/javascripts/ie/reverse_zindex.js",
+    "vendor/assets/javascripts/jquery.async.js",
+    "vendor/assets/javascripts/jquery.cookie.js",
+    "vendor/assets/javascripts/jquery.lifestream.js",
+    "vendor/assets/javascripts/jquery.validate.js",
+    "vendor/assets/javascripts/log.js",
+    "vendor/assets/javascripts/modernizr.js",
+    "vendor/assets/javascripts/shortcut.js",
+    "vendor/assets/javascripts/swfobject.js",
+    "vendor/assets/stylesheets/reset.css.sass",
+    "vendor/assets/stylesheets/variables.css.sass"
+  ]
+  s.homepage = %q{http://github.com/christopherhein/frontend-helpers}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.6.2}
+  s.summary = %q{Collection of useful frontend helpers for Rails 3.1 applications.}
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rails>, ["~> 3.1.0.rc4"])
+      s.add_runtime_dependency(%q<haml-rails>, ["~> 0.3.4"])
+      s.add_runtime_dependency(%q<sass-rails>, ["~> 3.1.0.rc"])
+      s.add_runtime_dependency(%q<sprockets>, ["~> 2.0.0.beta.10"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+    else
+      s.add_dependency(%q<rails>, ["~> 3.1.0.rc4"])
+      s.add_dependency(%q<haml-rails>, ["~> 0.3.4"])
+      s.add_dependency(%q<sass-rails>, ["~> 3.1.0.rc"])
+      s.add_dependency(%q<sprockets>, ["~> 2.0.0.beta.10"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    end
+  else
+    s.add_dependency(%q<rails>, ["~> 3.1.0.rc4"])
+    s.add_dependency(%q<haml-rails>, ["~> 0.3.4"])
+    s.add_dependency(%q<sass-rails>, ["~> 3.1.0.rc"])
+    s.add_dependency(%q<sprockets>, ["~> 2.0.0.beta.10"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+  end
+end
+

data/lib/asset-helpers/rails.rb

@@ -0,0 +1,4 @@
+module AssetHelpers
+  class Rails < ::Rails::Engine
+  end
+end

data/lib/frontend-helpers/html5_helper.rb

@@ -0,0 +1,19 @@
+module FrontendHelpers
+  module Html5Helper
+
+    def html_tag(attrs = {}, &block)
+      attrs.symbolize_keys!
+      haml_concat "<!--[if lt IE 7]><html class='ie6 no-js'><![endif]-->".html_safe
+      haml_concat "<!--[if IE 7]><html class='ie7 no-js'><![endif]-->".html_safe
+      haml_concat "<!--[if IE 8]><html class='ie8 no-js'><![endif]-->".html_safe
+      haml_concat "<!--[if gt IE 8]><!-->".html_safe
+      haml_tag :html, attrs do
+        haml_concat "<!--<![endif]-->".html_safe
+        block.call
+      end
+    end
+
+  end
+end
+
+ActionView::Base.send :include, FrontendHelpers::Html5Helper

data/lib/frontend-helpers/metatag_helper.rb

@@ -0,0 +1,58 @@
+module FrontendHelpers
+  module MetatagHelper
+
+    def meta_tags
+      options = opts
+      settings[:site].each do |s, k|
+        meta(s, options)
+      end
+    end
+
+  private ##########
+
+    def settings
+      YAML.load_file(File.join(Rails.root, 'config', 'settings.yml')) rescue {}
+    end
+
+    def setting(setting)
+      ENV["SITE_#{setting.to_s.upcase}"] || settings[:site][setting]
+    end
+
+    def meta(name, options)
+      if !name.blank? && !setting(name).blank? || options.include?(name) && options[name]
+        options[:title] = ( options[name].present? ) ? "#{options[name]} #{setting(:title)}" : ""
+        desc = (options.include?(name)) ? options[name] : setting(name)
+        haml_concat "<meta content='#{desc}' name='#{name.to_s}' />"
+      end
+    end
+
+    def opts
+      {
+        title: @meta_title,
+        keywords: @meta_keywords,
+        description: @meta_description,
+        author: @meta_author,
+        email: @meta_email,
+        copyright: @meta_copyright,
+        generator: @meta_generator,
+        rating: @meta_rating,
+        language: @meta_language,
+        distribution: @meta_distribution,
+        robots: @robots,
+        :"fb:app_id" => @meta_fb_app_id,
+        :"og:title" => @meta_og_title,
+        :"og:description" => @meta_og_description,
+        :"og:url" => request.url,
+        :"og:site_name" => @meta_og_site_name,
+        :"og:type" => @meta_og_type,
+        :"og:image" => @meta_og_image,
+        :"og:locality" => @meta_og_locality,
+        :"og:region" => @meta_og_region,
+        :"og:country_name" => @meta_og_country_name,
+        :"og:phone_number" => @meta_og_phone_number
+      }
+    end
+  end
+end
+
+ActionView::Base.send :include, FrontendHelpers::MetatagHelper