merb-auth-slice-password-reset 1.1.0

data/.gitignore

@@ -0,0 +1,15 @@
+*.gemspec
+pkg
+pkg/*
+*/pkg/*
+*.log
+log
+!log*.rb
+*/log
+log/*
+*/log/*
+coverage
+*/coverage
+bundle
+*.DS_Store
+*.tmproj

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Daniel Neighman, Christian Kebekus
+
+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.textile

@@ -0,0 +1,219 @@
+h3. Fork Info
+
+The behavior of this fork is different from its parent.  Instead of auto-generating a password
+on the reset action of the Passwords controller a form is sent that asks the user to create a new
+password.  The default is for a :password and :password_confirmation field to be sent, but you
+could override that in your own app.
+
+h3. MerbAuthSlicePasswordReset
+
+This slice provides a way for users to reset their forgotten password. Passwords are mailed to them and they can then use the form provided to reset them.
+ 
+<pre><code>
+class User
+  include DataMapper::Resource
+  include Merb::Authentication::Mixins::SenileUser
+
+  property :id,    Serial
+end
+</code></pre>
+
+The mixin provides a number of methods.  The most common are: 
+
+<pre><code>
+  @user.activate    # activates (and saves) the user
+  @user.activated?  # Returns the "active" status of the user
+  @user.active?     # Alias for activated?
+</pre></code>
+
+h3. Migration Requirements
+
+The mixin requires some fields to be in-place on your model.  Where needed include these in your migrations.
+
+<pre><code>
+  :password_reset_code, String
+</code></pre>
+
+h3. Mailers
+
+The slice contains 2 mailing actions that are setup as callback hooks on the model.  When the model is created
+a "signup" email is sent with the link to follow to activate the account.  Also an activation acknowledgment 
+email.
+
+h3. Configuration Options
+
+These options may be declared in your @init.rb@ or @environment/*.rb@ files
+
+Use the standard slice configuration hash to set these up @Merb::Slices::config[:merb_auth_slice_password_reset]@
+
+
+h4. Required
+
+:from_email                 # The email account to send the email from
+:password_reset_host        # The host to go to for activation.  This is used to construct the 
+                            # activation link.  Symbol, String or Procs are available.
+                            # Procs will have the @user@ object passed in
+
+h4. Optional
+
+:password_reset_subject     # The subject of the email to send after activation (Welcome)
+
+h3. Customizing the emails
+
+To customize your emails, rake the slices stubs
+
+<pre><code>
+	$ rake slices:merb_auth_slice_password_reset:stubs
+</code></pre>
+
+This will create stubs of the views in @slices/merb_auth_slice_password_reset/app/mailers/views/@
+
+To create HTML emails just add an html template like @signup.html.erb@
+
+h3. Customize the Redirect after activation
+
+rake the slices stubs as above. There is an @activations.rb@ controller in the
+@slices/merb_auth_slice_password_reset/app/controllers@ directory.  You can overwrite the stubbed 
+method in there to have it change it's redirection behavior.
+
+
+# Rake tasks to package/install the gem - edit this to modify the manifest.
+# The slice application: controllers, models, helpers, views.
+# The default layout, as specified in @Merb::Slices::config[:merb_auth_slice_password_reset][:layout]@ change this to :application to use the app's layout.
+# Standard rake tasks available to your application.
+# Your custom application rake tasks.
+# The main slice file - contains all slice setup @logic/config@.
+# Public assets you (optionally) install using @rake slices:merb_auth_slice_password_reset:install@
+# Specs for basis slice behaviour - you usually adapt these for your slice.
+# Stubs of classes/views/files for the end-user to override - usually these mimic the files in @app/@ and/or @public/@; use @rake slices:merb_auth_slice_password_reset:stubs@ to get started with the override stubs. Also, @rake slices:merb_auth_slice_password_reset:patch@ will copy over views to override in addition to the files found in /stubs.
+   
+
+To see all available tasks for MerbAuthSliceActivation run:
+
+<pre><code>
+	$ rake -T slices:merb_auth_slice_password_reset
+</code></pre>
+
+
+h3. Instructions for installation:
+
+h4. @Gemfile@
+
+Add the slice as a regular dependency
+
+<pre><code>
+	gem "merb-auth-slice-password-reset"
+</code></pre>
+
+h4. @config/init.rb@
+
+If needed, configure which slices to load and in which order
+
+<pre><code>
+	Merb::Plugins.config[:merb_slices] = { :queue => ["MerbAuthSlicePasswordReset", ...] }
+</code></pre>
+
+Optionally configure the plugins in a before_app_loads callback
+
+<pre><code>
+	Merb::BootLoader.before_app_loads do
+
+	  Merb::Slices::config[:merb_auth_slice_password_reset][:option] = value
+
+	end
+</code></pre>
+
+h4. @config/router.rb@
+
+Example: /merb_auth_slice_password_reset/:controller/:action/:id
+
+<pre><code>
+	add_slice(:MerbAuthSlicePasswordReset)
+</code></pre>
+
+Example: /foo/:controller/:action/:id
+
+<pre><code>
+	add_slice(:MerbAuthSlicePasswordReset, 'foo') # same as :path => 'foo'
+</code></pre>
+
+Example: /:lang/:controller/:action/:id
+
+<pre><code>
+	add_slice(:MerbAuthSlicePasswordReset, :path => ':lang')
+</code></pre>
+
+Example: /:controller/:action/:id
+
+<pre><code>
+	slice(:MerbAuthSlicePasswordReset)
+</code></pre>
+
+Normally you should also run the following rake task:
+
+<pre><code>
+	$ rake slices:merb_auth_slice_password_reset:install
+</code></pre>
+
+h4. Overrides
+
+You can put your application-level overrides in:
+
+host-app/slices/merb-auth-slice-password-reset/app - controllers, models, views ...
+
+Templates are located in this order:
+
+# host-app/slices/merb-auth-slice-password-reset/app/views/*
+# gems/merb-auth-slice-password-reset/app/views/*
+# host-app/app/views/*
+
+You can use the host application's layout by configuring the
+merb-auth-slice-password-reset slice in a before_app_loads block:
+
+<pre><code>
+	Merb::Slices.config[:merb_auth_slice_password_reset] = { :layout => :application }
+</code></pre>
+
+By default :merb_auth_slice_password_reset is used. If you need to override
+stylesheets or javascripts, just specify your own files in your layout
+instead/in addition to the ones supplied (if any) in 
+host-app/public/slices/merb-auth-slice-password-reset.
+
+In any case don't edit those files directly as they may be clobbered any time
+rake merb_auth_slice_password_reset:install is run.
+
+
+h3. About Slices
+
+Merb-Slices is a Merb plugin for using and creating application 'slices' which
+help you modularize your application. Usually these are reuseable extractions
+from your main app. In effect, a Slice is just like a regular Merb MVC
+application, both in functionality as well as in structure.
+
+When you generate a Slice stub structure, a module is setup to serve as a
+namespace for your controller, models, helpers etc. This ensures maximum
+encapsulation. You could say a Slice is a mixture between a Merb plugin (a
+Gem) and a Merb application, reaping the benefits of both.
+
+A host application can 'mount' a Slice inside the router, which means you have
+full over control how it integrates. By default a Slice's routes are prefixed
+by its name (a router :namespace), but you can easily provide your own prefix
+or leave it out, mounting it at the root of your url-schema. You can even
+mount a Slice multiple times and give extra parameters to customize an
+instance's behaviour.
+
+A Slice's Application controller uses controller_for_slice to setup slice
+specific behaviour, which mainly affects cascaded view handling. Additionaly,
+this method is available to any kind of controller, so it can be used for
+Merb Mailer too for example.
+
+There are many ways which let you customize a Slice's functionality and
+appearance without ever touching the Gem-level code itself. It's not only easy
+to add template/layout overrides, you can also add/modify controllers, models
+and other runtime code from within the host application.
+
+To create your own Slice run this (somewhere outside of your merb app):
+
+<pre><code>
+	$ merb-gen slice <your-lowercase-slice-name>
+</code></pre>

data/Rakefile

@@ -0,0 +1,41 @@
+require 'rubygems'
+require 'rake'
+
+# Assume a typical dev checkout to fetch the current merb-core version
+require 'merb-core/version'
+
+begin
+
+  require 'jeweler'
+
+  Jeweler::Tasks.new do |gemspec|
+
+    gemspec.version     = '1.1.0'
+
+    gemspec.name        = "merb-auth-slice-password-reset"
+    gemspec.description = "Merb Slice for password-reset functionality"
+    gemspec.summary     = "Merb Slice that adds basic password-reset functionality to merb-auth-based merb applications."
+
+    gemspec.authors     = [ "Daniel Neighman", "Christian Kebekus" ]
+    gemspec.email       = "has.sox@gmail.com"
+    gemspec.homepage    = "http://merbivore.com/"
+
+    # Runtime dependencies
+    gemspec.add_dependency 'merb-slices', '~> 1.1.0'
+    gemspec.add_dependency 'merb-auth-core', '~> 1.1.0'
+    gemspec.add_dependency 'merb-auth-more', '~> 1.1.0'
+    gemspec.add_dependency 'merb-mailer', '~> 1.1.0'
+
+  end
+
+  Jeweler::GemcutterTasks.new
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+
+require 'spec/rake/spectask'
+require 'merb-core/test/tasks/spectasks'
+desc 'Default: run spec examples'
+task :default => 'spec'

data/TODO

@@ -0,0 +1,2 @@
+TODO:
+

data/app/controllers/application.rb

@@ -0,0 +1,5 @@
+class MerbAuthSlicePasswordReset::Application < Merb::Controller
+  
+  controller_for_slice
+  
+end

data/app/controllers/passwords.rb

@@ -0,0 +1,49 @@
+class MerbAuthSlicePasswordReset::Passwords <  MerbAuthSlicePasswordReset::Application
+
+  def forgot_password
+    @login_param_name = Merb::Authentication::Strategies::Basic::Base.login_param
+    render
+  end
+  
+  def send_confirmation
+    @login_param_name = Merb::Authentication::Strategies::Basic::Base.login_param
+    @user = Merb::Authentication.user_class.find_with_login_param(@login_param_name, params[@login_param_name])
+    if @user
+      @user.send_password_reset_notification
+      redirect_after_sending_confirmation
+    else
+      message[:error] = "User with #{@login_param_name} \"%s\" not found".t(params[@login_param_name].freeze)
+      render :forgot_password
+    end
+  end
+
+  def reset
+    @user = Merb::Authentication.user_class.find_with_password_reset_code(params[:password_reset_code])
+    raise NotFound if @user.nil?
+    render
+  end
+
+  def reset_check
+    @user = Merb::Authentication.user_class.find_with_password_reset_code(params[:password_reset_code])
+    # FIXME: This only works for DataMapper right now.  I assume that the ActiveORM abstraction
+    #        will have a method that works for all ORMs.
+    raise NotFound if @user.nil?
+    if @user.update(params[:user])
+      redirect_after_password_reset
+    else
+      message[:error] = @user.errors.map { |e| e.to_s }.join(" and ") if @user.errors
+      render :reset
+    end
+  end
+
+  private
+
+  def redirect_after_password_reset
+    redirect "/", :message => {:notice => "Your password has been changed".t}
+  end
+  
+  def redirect_after_sending_confirmation
+    redirect "/", :message => {:notice => "Password reset confirmation sent".t}
+  end
+
+end # MerbAuthSlicePasswordReset::Passwords

data/app/helpers/application_helper.rb

@@ -0,0 +1,64 @@
+module Merb
+  module MerbAuthSlicePasswordReset
+    module ApplicationHelper
+      
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path relative to the public directory, with added segments.
+      def image_path(*segments)
+        public_path_for(:image, *segments)
+      end
+      
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path relative to the public directory, with added segments.
+      def javascript_path(*segments)
+        public_path_for(:javascript, *segments)
+      end
+      
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path relative to the public directory, with added segments.
+      def stylesheet_path(*segments)
+        public_path_for(:stylesheet, *segments)
+      end
+      
+      # Construct a path relative to the public directory
+      # 
+      # @param <Symbol> The type of component.
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path relative to the public directory, with added segments.
+      def public_path_for(type, *segments)
+        ::MerbAuthSlicePasswordReset.public_path_for(type, *segments)
+      end
+      
+      # Construct an app-level path.
+      # 
+      # @param <Symbol> The type of component.
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path within the host application, with added segments.
+      def app_path_for(type, *segments)
+        ::MerbAuthSlicePasswordReset.app_path_for(type, *segments)
+      end
+      
+      # Construct a slice-level path.
+      # 
+      # @param <Symbol> The type of component.
+      # @param *segments<Array[#to_s]> Path segments to append.
+      #
+      # @return <String> 
+      #  A path within the slice source (Gem), with added segments.
+      def slice_path_for(type, *segments)
+        ::MerbAuthSlicePasswordReset.slice_path_for(type, *segments)
+      end
+      
+    end
+  end
+end

data/app/helpers/mailer_helper.rb

@@ -0,0 +1,28 @@
+module Merb
+  module MerbAuthSlicePasswordReset
+    module MailerHelper
+
+      def password_reset_url(user)
+        @password_reset_host      ||= MaSPR[:password_reset_host] || MaSPR[:default_password_reset_host]
+        @password_reset_protocol  ||= MaSPR[:password_reset_protocol] || "http"
+
+        if base_controller # Rendering from a web controller
+          @password_reset_host      ||= base_controller.request.host
+          @password_reset_protocol  ||= "http"
+        end
+
+        @password_reset_host ||= case @password_reset_host
+        when Proc
+          @password_reset_host.call(user)
+        when String
+          @password_reset_host
+        end
+
+        raise  "There is no host set for the password-reset email. Set Merb::Slices::config[:merb_auth_slice_password_reset][:password_reset_host]" unless @password_reset_host
+
+        "#{@password_reset_protocol}://#{@password_reset_host}#{slice_url(:reset_password, :password_reset_code => user.password_reset_code)}"
+      end
+
+    end # MailerHelper
+  end # MerbAuthSlicePasswordReset
+end # Merb