Module: Devise::Models::Rememberable

Extended by:

ActiveSupport::Concern

Defined in:

lib/devise/models/rememberable.rb

Overview

* +remember_for+: the time you want the user will be remembered without
  asking for credentials. After this time the user will be blocked and
  will have to enter his credentials again. This configuration is also
  used to calculate the expires time for the cookie created to remember
  the user. By default remember_for is 2.weeks.

* +extend_remember_period+: if true, extends the user's remember period
  when remembered via cookie. False by default.

* +rememberable_options+: configuration options passed to the created cookie.

User.find(1).remember_me!  # regenerating the token
User.find(1).forget_me!    # clearing the token

# generating info to put into cookies
User.serialize_into_cookie(user)

# lookup the user based on the incoming cookie information
User.serialize_from_cookie(cookie_string)

Defined Under Namespace

Modules: ClassMethods

Instance Attribute Summary (collapse)

• - (Object) extend_remember_period

  Returns the value of attribute extend_remember_period.

• - (Object) remember_me

  Returns the value of attribute remember_me.

Class Method Summary (collapse)

• + (Object) required_fields(klass)

Instance Method Summary (collapse)

• - (Object) forget_me!

  If the record is persisted, remove the remember token (but only if it exists), and save the record without validations.

• - (Boolean) generate_remember_timestamp?(extend_period) protected

  Generate a timestamp if extend_remember_period is true, if no remember_token exists, or if an existing remember token has expired.

• - (Boolean) generate_remember_token? protected

  :nodoc:.

• - (Boolean) remember_expired?

  Remember token should be expired if expiration time not overpass now.

• - (Object) remember_expires_at

  Remember token expires at created time + remember_for configuration.

• - (Object) remember_me!(extend_period = false)

  Generate a new remember token and save the record without validations unless remember_across_browsers is true and the user already has a valid token.

• - (Object) rememberable_options
• - (Object) rememberable_value

42
43
44

# File 'lib/devise/models/rememberable.rb', line 42

def extend_remember_period
  @extend_remember_period
end

42
43
44

# File 'lib/devise/models/rememberable.rb', line 42

def remember_me
  @remember_me
end

44
45
46

# File 'lib/devise/models/rememberable.rb', line 44

def self.required_fields(klass)
  [:remember_created_at]
end

58
59
60
61
62
63

# File 'lib/devise/models/rememberable.rb', line 58

def forget_me!
  return unless persisted?
  self.remember_token = nil if respond_to?(:remember_token=)
  self.remember_created_at = nil
  save(:validate => false)
end

100
101
102

# File 'lib/devise/models/rememberable.rb', line 100

def generate_remember_timestamp?(extend_period) #:nodoc:
  extend_period || remember_created_at.nil? || remember_expired?
end

94
95
96

# File 'lib/devise/models/rememberable.rb', line 94

def generate_remember_token? #:nodoc:
  respond_to?(:remember_token) && remember_expired?
end

66
67
68

# File 'lib/devise/models/rememberable.rb', line 66

def remember_expired?
  remember_created_at.nil? || (remember_expires_at <= Time.now.utc)
end

71
72
73

# File 'lib/devise/models/rememberable.rb', line 71

def remember_expires_at
  remember_created_at + self.class.remember_for
end

50
51
52
53
54

# File 'lib/devise/models/rememberable.rb', line 50

def remember_me!(extend_period=false)
  self.remember_token = self.class.remember_token if generate_remember_token?
  self.remember_created_at = Time.now.utc if generate_remember_timestamp?(extend_period)
  save(:validate => false) if self.changed?
end

88
89
90

# File 'lib/devise/models/rememberable.rb', line 88

def rememberable_options
  self.class.rememberable_options
end

75
76
77
78
79
80
81
82
83
84
85
86

# File 'lib/devise/models/rememberable.rb', line 75

def rememberable_value
  if respond_to?(:remember_token)
    remember_token
  elsif respond_to?(:authenticatable_salt) && (salt = authenticatable_salt)
    salt
  else
    raise "authenticable_salt returned nil for the #{self.class.name} model. " \
      "In order to use rememberable, you must ensure a password is always set " \
      "or have a remember_token column in your model or implement your own " \
      "rememberable_value in the model with custom logic."
  end
end