headstart 0.1.0

data/app/models/headstart_mailer.rb

@@ -0,0 +1,28 @@
+class HeadstartMailer
+
+  def self.deliver_change_password(user)
+    if MadMimiMailer.api_settings.present? && MadMimiMailer.api_settings[:username].present? && MadMimiMailer.api_settings[:api_key].present?
+      MimiMailer.deliver_mimi_change_password(user)
+    else
+      GenericMailer.deliver_change_password(user)
+    end
+  end
+  
+  def self.deliver_welcome(user)
+    if MadMimiMailer.api_settings.present? && MadMimiMailer.api_settings[:username].present? && MadMimiMailer.api_settings[:api_key].present?
+      MimiMailer.deliver_welcome(user)
+    else
+      GenericMailer.deliver_welcome(user)
+    end
+  end
+  
+  def self.deliver_confirmation(user)
+    if MadMimiMailer.api_settings.present? && MadMimiMailer.api_settings[:username].present? && MadMimiMailer.api_settings[:api_key].present?
+      MimiMailer.deliver_confirmation(user)
+    else
+      GenericMailer.deliver_confirmation(user)
+    end
+  end
+  
+
+end

data/app/models/impersonation.rb

@@ -0,0 +1,26 @@
+module Impersonation
+  
+  ##
+  # Returns a hash based on the given id.
+  # 
+  def self.hash_for(id)
+    raise(ArgumentError, "Must provide an id") unless id
+    generate_hash(id)
+  end
+  
+  ##
+  # Returns +true+ if the given hash is valid for the given id.
+  # 
+  def self.valid_hash?(id, hash)
+    hash == generate_hash(id)
+  end
+  
+  
+  private
+  
+  
+  def self.generate_hash(id)
+    Digest::MD5.hexdigest("----#{id}-----#{Headstart.configuration.impersonation_hash}-----")
+  end
+  
+end

data/app/models/mimi_mailer.rb

@@ -0,0 +1,30 @@
+class MimiMailer < MadMimiMailer
+  
+  def mimi_change_password(user)
+    from       Headstart.configuration.mailer_sender
+    recipients user.email
+    subject    I18n.t(:change_password,
+                      :scope   => [:headstart, :models, :headstart_mailer],
+                      :default => "Change your password")
+    body       :url => edit_user_password_url(user,
+                       :token  => user.password_reset_token,
+                       :escape => false)
+  end
+
+  def mimi_welcome(user)
+    from       Headstart.configuration.mailer_sender
+    recipients user.email
+    subject    I18n.t(:welcome,
+                      :scope   => [:headstart, :models, :headstart_mailer],
+                      :default => "Welcome")
+  end
+  
+  def confirmation(user)
+    from       Headstart.configuration.mailer_sender
+    recipients user.email
+    subject    I18n.t(:confirmation,
+                      :scope   => [:headstart, :models, :headstart_mailer],
+                      :default => "Account confirmation")
+    body      :user => user
+  end
+end

data/app/views/generic_mailer/change_password.html.erb

@@ -0,0 +1,9 @@
+Someone, hopefully you, has requested that we send you a link to change your password.
+
+Here's the link:
+
+<%= edit_user_password_url(@user,
+      :token  => @user.confirmation_token,
+      :escape => false) %>
+
+If you didn't request this, ignore this email. Don't worry. Your password hasn't been changed.

data/app/views/generic_mailer/confirmation.html.erb

@@ -0,0 +1,5 @@
+
+<%= new_user_confirmation_url(
+      :user_id => @user,
+      :token   => @user.confirmation_token,
+      :encode  => false) %>

data/app/views/generic_mailer/welcome.html.erb

@@ -0,0 +1 @@
+Welcome

data/app/views/impersonations/index.html.erb

@@ -0,0 +1,5 @@
+<ul>
+  <%- @users.each do |user| -%>
+    <li><%=h user.name %> <%= link_to 'Impersonate', impersonation_path(:user_id => user.id), :method => :post, :id => "impersonate_#{user.id}" %></li>
+  <%- end -%>
+</ul>

data/app/views/passwords/edit.html.erb

@@ -0,0 +1,23 @@
+<h2>Change your password</h2>
+
+<p>
+  Your password has been reset. Choose a new password below.
+</p>
+
+<%= error_messages_for :user %>
+
+<% form_for(:user,
+            :url => user_password_path(@user, :token => @user.password_reset_token),
+            :html => { :method => :put }) do |form| %>
+  <div class="password_field">
+    <%= form.label :password, "Choose password" %>
+    <%= form.password_field :password %>
+  </div>
+  <div class="password_field">
+    <%= form.label :password_confirmation, "Confirm password" %>
+    <%= form.password_field :password_confirmation %>
+  </div>
+  <div class="submit_field">
+    <%= form.submit "Save this password", :disable_with => "Please wait..." %>
+  </div>
+<% end %>

data/app/views/passwords/new.html.erb

@@ -0,0 +1,15 @@
+<h2>Change your password</h2>
+
+<p>
+  We will email you a link to change your password.
+</p>
+
+<% form_for :password, :url => passwords_path do |form| %>
+  <div class="text_field">
+    <%= form.label :email, "Email address" %>
+    <%= form.text_field :email %>
+  </div>
+  <div class="submit_field">
+    <%= form.submit "Reset password", :disable_with => "Please wait..." %>
+  </div>
+<% end %>

data/app/views/sessions/new.html.erb

@@ -0,0 +1,48 @@
+<%- if Headstart.configuration.use_facebook_connect -%>
+  <%- if request.ssl? -%>
+    <%= javascript_include_tag 'https://ssl.connect.facebook.com/js/api_lib/v0.4/FeatureLoader.js.php/en_US' %>
+  <%- else -%>
+    <%= javascript_include_tag 'http://static.ak.connect.facebook.com/js/api_lib/v0.4/FeatureLoader.js.php/en_US' %>
+  <%- end -%>
+  <script>
+    function facebook_onlogin() {
+      document.location.href = "<%= fb_connect_path %>";
+    }
+  </script>
+<%- end -%>
+
+<h2>Sign in</h2>
+
+<% form_for :session, :url => session_path do |form| %>
+  <div class="text_field">
+    <%= form.label :email %>
+    <%= form.text_field :email %>
+  </div>
+  <div class="text_field">
+    <%= form.label :password %>
+    <%= form.password_field :password %>
+  </div>
+  <div class="submit_field">
+    <%= form.submit "Sign in", :disable_with => "Please wait..." %>
+    <%- if Headstart.configuration.use_facebook_connect -%>
+      or <fb:login-button onlogin="facebook_onlogin();" length="long" v="2" size="large"></fb:login-button>
+    <%- end -%>
+  </div>
+<% end %>
+
+<ul>
+  <li>
+    <%= link_to "Sign up", sign_up_path %>
+  </li>
+  <li>
+    <%= link_to "Forgot password?", new_password_path %>
+  </li>
+</ul>
+
+<%- if Headstart.configuration.use_facebook_connect -%>
+  <script type="text/javascript">
+    FB.init("<%= Headstart.configuration.facebook_api_key %>", "xd_receiver.html", {
+      permsToRequestOnConnect : "email",
+    });
+  </script>
+<%- end -%>

data/app/views/users/_form.html.erb

@@ -0,0 +1,21 @@
+<%= form.error_messages %>
+<p class="text_field">
+  <%= form.label :email %>
+  <%= form.text_field :email %>
+</p>
+<p class="text_field">
+  <%= form.label :first_name %>
+  <%= form.text_field :first_name %>
+</p>
+<p class="text_field">
+  <%= form.label :last_name %>
+  <%= form.text_field :last_name %>
+</p>
+<p class="password_field">
+  <%= form.label :password %>
+  <%= form.password_field :password %>
+</p>
+<p class="password_field">
+  <%= form.label :password_confirmation, "Confirm password" %>
+  <%= form.password_field :password_confirmation %>
+</p>

data/app/views/users/edit.html.erb

@@ -0,0 +1,6 @@
+<h2>Edit My Profile</h2>
+
+<% form_for @user do |form| %>
+  <%= render :partial => '/users/form', :object => form %>
+  <%= form.submit 'Save', :disable_with => 'Please wait...' %>
+<% end %>

data/app/views/users/new.html.erb

@@ -0,0 +1,6 @@
+<h2>Sign up</h2>
+
+<% form_for @user do |form| %>
+  <%= render :partial => '/users/form', :object => form %>
+  <%= form.submit 'Sign up', :disable_with => 'Please wait...' %>
+<% end %>

data/app/views/users/show.html.erb

@@ -0,0 +1,8 @@
+<h2>My Profile</h2>
+
+<div id="user_profile">
+  <b>First Name:</b> <%=h @user.first_name %><br/>
+  <b>Last Name:</b> <%=h @user.last_name %><br/>
+  <b>Email:</b> <%=h @user.email %><br/>
+  <%= link_to 'Edit', edit_user_path(@user) %>
+</div>

data/generators/headstart/USAGE

@@ -0,0 +1 @@
+script/generate headstart

data/generators/headstart/headstart_generator.rb

@@ -0,0 +1,86 @@
+require File.expand_path(File.dirname(__FILE__) + "/lib/insert_commands.rb")
+require File.expand_path(File.dirname(__FILE__) + "/lib/rake_commands.rb")
+
+class HeadstartGenerator < Rails::Generator::Base
+
+  def manifest
+    record do |m|
+      app_name = File.expand_path(File.dirname(__FILE__)).split("/").last
+      m.directory File.join("config", "initializers")
+      m.file "headstart.rb",  "config/initializers/headstart.rb"
+      m.file "headstart.yml", "config/headstart.yml"
+
+      m.directory File.join("app", "views", "layouts")
+      m.directory File.join("app", "views", "sessions")
+      m.file "application.html.erb", "app/views/layouts/application.html.erb"
+      m.file "app/views/sessions/index.html.erb", "app/views/sessions/index.html.erb"
+
+      m.directory File.join("public", "stylesheets")
+      m.file "style.css", "public/stylesheets/style.css"
+      m.file "reports.css", "public/stylesheets/report.css"
+      m.file "reset.css", "public/stylesheets/reset.css"
+      m.file "text.css", "public/stylesheets/text.css"
+      m.file "layout.css", "public/stylesheets/layout.css"
+
+      m.file "xd_receiver.html", "public/xd_receiver.html"
+      m.file "xd_receiver_ssl.html", "public/xd_receiver_ssl.html"
+      
+      m.file "app/controllers/sessions_controller.rb", "app/controllers/sessions_controller.rb"
+      m.insert_into "app/controllers/application_controller.rb",
+                    "include Headstart::Authentication"
+      
+      user_model = "app/models/user.rb"
+      if File.exists?(user_model)
+        m.insert_into user_model, "include Headstart::User"
+      else
+        m.directory File.join("app", "models")
+        m.file "user.rb", user_model
+      end
+      
+      m.insert_into "config/routes.rb",
+                    "Headstart::Routes.draw(map)"
+
+      m.directory File.join("test", "factories")
+      m.file "factories.rb", "test/factories/user.rb"
+
+      m.migration_template "migrations/#{migration_source_name}.rb",
+                           'db/migrate',
+                           :migration_file_name => "headstart_#{migration_target_name}"
+
+      m.readme "README"
+    end
+  end
+
+  def schema_version_constant
+    if upgrading_headstart_again?
+      "To#{schema_version.gsub('_', '')}"
+    end
+  end
+
+  private
+
+  def migration_source_name
+    if ActiveRecord::Base.connection.table_exists?(:users)
+      'update_users'
+    else
+      'create_users'
+    end
+  end
+
+  def migration_target_name
+    if upgrading_headstart_again?
+      "update_users_to_#{schema_version}"
+    else
+      'create_users'
+    end
+  end
+
+  def schema_version
+    IO.read(File.join(File.dirname(__FILE__), '..', '..', 'VERSION')).strip.gsub(/[^\d]/, '_')
+  end
+
+  def upgrading_headstart_again?
+    ActiveRecord::Base.connection.table_exists?(:users)
+  end
+
+end

data/generators/headstart/lib/insert_commands.rb

@@ -0,0 +1,33 @@
+# Mostly pinched from http://github.com/ryanb/nifty-generators/tree/master
+
+Rails::Generator::Commands::Base.class_eval do
+  def file_contains?(relative_destination, line)
+    File.read(destination_path(relative_destination)).include?(line)
+  end
+end
+
+Rails::Generator::Commands::Create.class_eval do
+  def insert_into(file, line)
+    logger.insert "#{line} into #{file}"
+    unless options[:pretend] || file_contains?(file, line)
+      gsub_file file, /^(class|module|.*Routes).*$/ do |match|
+        "#{match}\n  #{line}"
+      end
+    end
+  end
+end
+
+Rails::Generator::Commands::Destroy.class_eval do
+  def insert_into(file, line)
+    logger.remove "#{line} from #{file}"
+    unless options[:pretend]
+      gsub_file file, "\n  #{line}", ''
+    end
+  end
+end
+
+Rails::Generator::Commands::List.class_eval do
+  def insert_into(file, line)
+    logger.insert "#{line} into #{file}"
+  end
+end

data/generators/headstart/lib/rake_commands.rb

@@ -0,0 +1,22 @@
+Rails::Generator::Commands::Create.class_eval do
+  def rake_db_migrate
+    logger.rake "db:migrate"
+    unless system("rake db:migrate")
+      logger.rake "db:migrate failed. Rolling back"      
+      command(:destroy).invoke!
+    end
+  end
+end
+
+Rails::Generator::Commands::Destroy.class_eval do
+  def rake_db_migrate
+    logger.rake "db:rollback"  
+    system "rake db:rollback"  
+  end
+end
+
+Rails::Generator::Commands::List.class_eval do
+  def rake_db_migrate
+    logger.rake "db:migrate"    
+  end
+end

data/generators/headstart/templates/README

@@ -0,0 +1,20 @@
+
+*******************************************************************************
+
+Next:
+
+1. Configure default url options for the mailer to generate URLs in emails.
+   In production.rb it must be the actual host your application is deployed to.
+   In config/environments/test.rb and config/environments/development.rb:
+
+     config.action_mailer.default_url_options = { :host => 'localhost:3000' }
+
+2. If you haven't already, be sure you have delayed_jobs setup and configured:
+
+     ./script/generate delayed_job
+
+3. Migrate:
+
+     rake db:migrate
+
+*******************************************************************************

data/generators/headstart/templates/app/controllers/sessions_controller.rb

@@ -0,0 +1,6 @@
+class SessionsController < Headstart::SessionsController
+  
+  def index
+    
+  end
+end

data/generators/headstart/templates/app/views/sessions/index.html.erb

@@ -0,0 +1 @@
+Home page

data/generators/headstart/templates/application.html.erb

@@ -0,0 +1,75 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" dir="ltr" xml:lang="en-US" lang="en-US" xmlns:fb="http://www.facebook.com/2008/fbml">
+<head>
+  <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
+  <title><%= yield(:title) %></title>
+  <meta name="description" content="<%= yield(:description) %>" />
+  <meta name="keywords" content="<%= yield(:keywords) %>" />
+  <meta name="robots" content="INDEX,FOLLOW" />
+
+  <%= stylesheet_link_tag "reset", "layout", "text", "style", "report" %>
+
+	<%- if request.ssl? -%>
+	  <%= javascript_include_tag 'https://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js' %>
+	<%- else -%>
+	  <%= javascript_include_tag 'http://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js' %>
+	<%- end -%>
+  <%= javascript_include_tag 'application' %>
+</head>
+<body>
+	
+	<div id="header" class="container_12">
+
+		<div id="title" class="grid_6 ">
+			Default Web App
+		</div>
+
+		<div id="nav" class="grid_6 ">
+			<% if signed_in? %>
+		    <% if impersonating? %>
+		      Impersonating <%= current_user.name %>
+		      | <%= link_to 'Stop impersonating', impersonation_path, :method => :delete %>
+		    <% else %>
+		      Welcome, <%= current_user.name %>
+		      | <%= link_to 'Sign out', sign_out_path %>
+		    <% end %>
+
+		    <% if current_user.admin? %>
+		      | <%= link_to 'Admin', "/admin" %>
+		    <% end %>
+
+		    | <%= link_to 'My Profile', user_path(current_user) %>
+		  <% else %>
+		    <%= link_to 'Sign in', sign_in_path %> |
+		    <%= link_to 'Sign up', sign_up_path %>
+		  <% end %>
+		</div>
+
+	</div>
+
+	<div id="content" class="container_12">
+		<div id="flash">
+	    <%- flash.each do |key, value| -%>
+	      <div class="<%= key %>_flash"><%=h value %></div>
+	    <%- end -%>
+	  </div>
+	  <%= yield %>
+	</div>
+
+
+	<div id="footer" class="container_12">
+
+		<div id="built-by" class="grid_6 ">
+			Built by Brian Burridge, Agile Nomads LLC
+		</div>
+
+		<div id="meta" class="grid_6 ">
+			<% if ENV["RAILS_ENV"] != "production" %><%= ENV["RAILS_ENV"]%><% end %>
+		</div>
+
+	</div>
+	
+  
+
+</body>
+</html>

data/generators/headstart/templates/factories.rb

@@ -0,0 +1,23 @@
+Factory.sequence :email do |n|
+  "user#{n}@example.com"
+end
+
+Factory.sequence :facebook_id do |n|
+  n
+end
+
+Factory.define :user do |user|
+  user.email                 { Factory.next :email }
+  user.first_name            { "Factory" }
+  user.last_name             { "User" }
+  user.password              { "password" }
+  user.password_confirmation { "password" }
+end
+
+Factory.define :admin_user, :parent => :user do |admin|
+  admin.role                 'admin'
+end
+
+Factory.define :facebook_user, :parent => :user do |user|
+  user.facebook_uid           { Factory.next :facebook_id }
+end

data/generators/headstart/templates/headstart.rb

@@ -0,0 +1,25 @@
+require 'yaml'
+
+begin
+  configuration = YAML.load_file("#{Rails.root}/config/headstart.yml")[Rails.env]
+  configuration = HashWithIndifferentAccess.new(configuration)
+  
+  Headstart.configure do |config|
+    config.mailer_sender        = configuration[:mailer_sender]
+    config.impersonation_hash   = configuration[:impersonation_hash]
+    config.use_facebook_connect = configuration[:use_facebook_connect]
+    config.use_delayed_job      = configuration[:use_delayed_job]
+    config.facebook_api_key     = configuration[:facebook_api_key]
+    config.facebook_secret_key  = configuration[:facebook_secret_key]
+  end
+
+  if configuration[:madmimi_username].present? && configuration[:madmimi_api_key].present?
+    MadMimiMailer.api_settings = {
+       :username  => configuration[:madmimi_username],
+       :api_key   => configuration[:madmimi_api_key]
+    }
+  else
+  end
+rescue LoadError
+  puts "The /config/headstart.yml file is missing or broken."
+end

data/generators/headstart/templates/headstart.yml

@@ -0,0 +1,45 @@
+#
+# The mailer_sender is set as the reply address for all notification emails.
+#
+# Set madmimi_username and madmimi_api_key to your MadMimi account username
+# and API key.
+#
+# The impersonation_hash is used to secure user impersonations. Set it to
+# a long, random hash.
+#
+# To turn on Facebook Connect, set use_facebook_connect to true.
+#
+# If you are using Facebook Connect, you'll need to provide your
+# application's API and secret keys from your Facebook application
+# settings at http://facebook.com/developers.
+#
+
+development:
+  mailer_sender: donotreply@example.com
+  madmimi_username: 
+  madmimi_api_key: 
+  impersonation_hash: 
+  use_facebook_connect: false
+  use_delayed_job: $delayed_job
+  facebook_api_key: 
+  facebook_secret_key: 
+
+test:
+  mailer_sender: donotreply@example.com
+  madmimi_username: 
+  madmimi_api_key: 
+  impersonation_hash: 
+  use_facebook_connect: false
+  use_delayed_job: $delayed_job
+  facebook_api_key: 
+  facebook_secret_key: 
+
+production:
+  mailer_sender: donotreply@example.com
+  madmimi_username: 
+  madmimi_api_key: 
+  impersonation_hash: 
+  use_facebook_connect: false
+  use_delayed_job: $delayed_job
+  facebook_api_key: 
+  facebook_secret_key: