Contents

module Devise
  module Models
    # Verifiable is responsible to add a second step to user sign up process.
    # This module is used when extra information is needed at sign up, e.g.
    # full name, address, documents, etc. Since this adds a second step, the
    # user will be able to finish the registration afterwards.
    #
    #
    # == Options
    #
    # Verifiable adds the following options to +devise+:
    #
    #   * +fields_for_verification+: A list of fields which have to be filled
    #     in the second step of the registration process by the user. These
    #     fields will be used to build the form in the second screen.
    #
    # == Examples
    #
    #   User.find(1).verified?   # true/false
    #
    module Verifiable
      extend ActiveSupport::Concern

      def self.required_fields(klass)
        klass.fields_for_verification
      end

      # Determine if the user filled the fields required in the second sign up
      # step
      def verified?
        self.class.fields_for_verification.all? { |field| send("#{field}?") }
      end

      def valid_for_verification?
        self.class.fields_for_verification.each do |field|
          validate_for_verification(field)
        end
        errors.empty?
      end

      protected

      def validate_for_verification(field)
        errors.add(field, I18n.t('errors.messages.blank')) if send(field).blank?
      end

      module ClassMethods
        Devise::Models.config(self, :fields_for_verification)


        def verify_fields(*fields)
          self.fields_for_verification = fields
        end
      end
    end
  end
end

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
devise-verifiable-1.0.0	lib/devise/models/verifiable.rb
devise-verifiable-0.0.3	lib/devise/models/verifiable.rb
devise-verifiable-0.0.2	lib/devise/models/verifiable.rb
devise-verifiable-0.0.1	lib/devise/models/verifiable.rb