quo_vadis 2.1.8 → 2.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d11498bfa66e0397304c2d9a0f8ac504037f97beac4fd039fe6c8d0299696531
-  data.tar.gz: 2d1e267c7b55740c72087e297960ff6ececb1caee45a17eb588bf7e44ba64d31
+  metadata.gz: 3776f82ebb4987586131a44692de5891ec821e7e82a1de249fc3d8905ef551d8
+  data.tar.gz: 6914f2e05d50ffbd9451d6e50484674d7bb775d2d871922749cc4be1553e35a6
 SHA512:
-  metadata.gz: e4e7c7bb2996556b35b153c56916aef9834dcac2abea08ede8becc14e030d8f4ea1444f9286c1ca9b728c1a13c16d8d9b2e701255d57b769c7dc9abefa84a976
-  data.tar.gz: f466404a5ba44bfd506cbcd2fdc7b2f2d142ecab419363e3c368bb5eca67cfc78829afa698b8b0dc1cc76210b531a32a44c3bfdcd1ae709cf9eafe740861f089
+  metadata.gz: 5229c567fe09a76fad025b0dea0fc36192defd24e04077374816cfb99414b6a9cc3213e8410f5ee23fedb297d1b157d64345c317d646d1226655c5e60e50c1ac
+  data.tar.gz: 0ace7c8c5c1075eec8a54aa31ba01564a8a9ff0fec23387650a00a1721affca7c9326e083ac9f26a8afdd04bee6f6e8a748ae1c9bbf5b4e9d3b005804362afe6

data/CHANGELOG.md

@@ -4,6 +4,11 @@
 ## HEAD
 
 
+## 2.1.9 (13 September 2022)
+
+* Enable code to be run after sign up.
+
+
 ## 2.1.8 (18 June 2022)
 
 * Extract convenience method for has authentication account.
@@ -35,7 +40,7 @@
 
 ## 2.1.3 (30 September 2021)
 
-* Pass IP and timestamp as paramenters to mailer.
+* Pass IP and timestamp as parameters to mailer.
 
 
 ## 2.1.2 (30 September 2021)

data/README.md

@@ -177,7 +177,7 @@ Your new user sign-up form ([example](https://github.com/airblade/quo_vadis/blob
 
 In your controller, use the `#login` method to log in your new user.  The optional second argument sets the length of the session (defaults to the browser session) - see the description above in the Controllers section).
 
-After logging in the user, redirect them to `qv.path_after_authentication` which resolves to a route named `:after_login`, if you have one, or your root route.
+After logging in the user, redirect them wherever you like.  You can use `qv.path_after_signup` which resolves to the first of these routes that exists: `:after_signup`, `:after_login`, the root route.
 
 ```ruby
 class UsersController < ApplicationController
@@ -185,7 +185,7 @@ class UsersController < ApplicationController
     @user = User.new user_params
     if @user.save
       login @user
-      redirect_to qv.path_after_authentication
+      redirect_to qv.path_after_signup
     else
       # ...
     end
@@ -258,10 +258,7 @@ Next, write the page where the user can amend their email address if they made a
 
 Finally, write the page where people can put in their identifier (not their email, unless the identifier is email) again to request another confirmation email ([example](https://github.com/airblade/quo_vadis/blob/master/app/views/quo_vadis/confirmations/new.html.erb)).  It must be in `app/views/quo_vadis/confirmations/new.html.:format`.
 
-After the user has confirmed their account, they will be logged in and redirected to the first of these that exists:
-
-- a route named `:after_login`;
-- your root route.
+After the user has confirmed their account, they will be logged in and redirected to `qv.path_after_signup` which resolves to the first of these routes that exists: `:after_signup`, `:after_login`, the root route.
 
 So add whichever works best for you.
 
@@ -518,12 +515,13 @@ end
 
 __Routes__
 
-You can set up your post-authentication and post-password-change routes.  If you don't, you must have a root route.  For example:
+You can set up your post-signup, post-authentication, and post-password-change routes.  If you don't, you must have a root route.  For example:
 
 ```ruby
 # config/routes.rb
-get '/dashboard', to: 'dashboards#show', as: 'after_login'
-get '/profile',   to: 'profiles#show',   as: 'after_password_change'
+get '/signups/confirmed', to: 'dashboards#show', as: 'after_signup'
+get '/dashboard',         to: 'dashboards#show', as: 'after_login'
+get '/profile',           to: 'profiles#show',   as: 'after_password_change'
 ```
 
 ### I18n

data/app/controllers/quo_vadis/confirmations_controller.rb

@@ -51,7 +51,7 @@ module QuoVadis
       session.delete :account_pending_confirmation
 
       login account.model, true
-      redirect_to qv.path_after_authentication, notice: QuoVadis.translate('flash.confirmation.confirmed')
+      redirect_to qv.path_after_signup, notice: QuoVadis.translate('flash.confirmation.confirmed')
     end
 
 

data/lib/quo_vadis/controller.rb

@@ -192,6 +192,13 @@ module QuoVadis
         Log.create account: account, action: action, ip: request.remote_ip, metadata: metadata
       end
 
+      def path_after_signup
+        return main_app.after_signup_path if main_app.respond_to?(:after_signup_path)
+        return main_app.after_login_path  if main_app.respond_to?(:after_login_path)
+        return main_app.root_path         if main_app.respond_to?(:root_path)
+        raise RuntimeError, 'Missing routes: after_signup_path, after_login_path, root_path; define at least one of them.'
+      end
+
       def path_after_authentication
         if (bookmark = rails_session[:qv_bookmark])
           rails_session.delete :qv_bookmark

data/lib/quo_vadis/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module QuoVadis
-  VERSION = '2.1.8'
+  VERSION = '2.1.9'
 end

data/test/dummy/app/controllers/sign_ups_controller.rb

@@ -26,6 +26,11 @@ class SignUpsController < ApplicationController
     @user = User.find params[:id]
   end
 
+  def confirmed
+    # Here we could send an email.
+    redirect_to after_login_path
+  end
+
   private
 
   def user_params

data/test/dummy/config/routes.rb

@@ -1,5 +1,6 @@
 Rails.application.routes.draw do
   resources :users
+  get '/sign_ups/confirmed', to: 'sign_ups#confirmed', as: 'after_signup'
   resources :sign_ups
   resources :articles do
     collection do

data/test/integration/account_confirmation_test.rb

@@ -33,6 +33,8 @@ class AccountConfirmationTest < IntegrationTest
     put action_path
 
     # verify logged in
+    assert_redirected_to '/sign_ups/confirmed'
+    follow_redirect!
     assert_redirected_to '/articles/secret'
     assert_equal 'Thanks for confirming your account.  You are now logged in.', flash[:notice]
     assert controller.logged_in?
@@ -101,6 +103,8 @@ class AccountConfirmationTest < IntegrationTest
 
     put extract_path_from_email
 
+    assert_redirected_to '/sign_ups/confirmed'
+    follow_redirect!
     assert_redirected_to '/articles/secret'
     assert_equal 'Thanks for confirming your account.  You are now logged in.', flash[:notice]
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: quo_vadis
 version: !ruby/object:Gem::Version
-  version: 2.1.8
+  version: 2.1.9
 platform: ruby
 authors:
 - Andy Stewart
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-06-18 00:00:00.000000000 Z
+date: 2022-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -224,7 +224,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.2.33
 signing_key:
 specification_version: 4
 summary: Multifactor authentication for Rails 6 and 7.