123456789_123456789_123456789_123456789_123456789_

Class: ActionMailer::Preview

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, ::ActiveSupport::DescendantsTracker
Inherits: Object
Defined in: actionmailer/lib/action_mailer/preview.rb

Class Method Summary

::ActiveSupport::DescendantsTracker - Extended

descendants

Instance Attribute Summary

Constructor Details

.new(params = {}) ⇒ Preview

[ GitHub ] 

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 78



def initialize(params = {})
  @params = params
end


  







Class Method Details



  

    .all  
  



  

    
Returns all mailer preview classes.

  



  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 84



def all
  load_previews if descendants.empty?
  descendants.sort_by { |mailer| mailer.name.titleize }
end


  








  

    .call(email, params = {})  
  



  

    
Returns the mail object for the given email name. The registered preview
interceptors will be informed so that they can transform the message
as they would if the mail was actually being delivered.

  



  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 92



def call(email, params = {})
  preview = new(params)
  message = preview.public_send(email)
  inform_preview_interceptors(message)
  message
end


  








  

    .email_exists?(email)  ⇒ Boolean 
  



  

    
Returns true if the email exists.

  





  


  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 105



def email_exists?(email)
  emails.include?(email)
end


  








  

    .emails  
  



  

    
Returns all of the available email previews.

  



  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 100



def emails
  public_instance_methods(false).map(&:to_s).sort
end


  








  

    .exists?(preview)  ⇒ Boolean 
  



  

    
Returns true if the preview exists.

  





  


  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 110



def exists?(preview)
  all.any? { |p| p.preview_name == preview }
end


  








  

    .find(preview)  
  



  

    
Find a mailer preview by its underscored class name.

  



  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 115



def find(preview)
  all.find { |p| p.preview_name == preview }
end


  








  

    .inform_preview_interceptors(message)   (private)
  

  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 139



def inform_preview_interceptors(message)
  Base.preview_interceptors.each do |interceptor|
    interceptor.previewing_email(message)
  end
end


  








  

    .load_previews   (private)
  

  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 125



def load_previews
  preview_paths.each do |preview_path|
    Dir["#{preview_path}/**/*_preview.rb"].sort.each { |file| require file }
  end
end


  








  

    .preview_name  
  



  

    
Returns the underscored name of the mailer preview without the suffix.

  



  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 120



def preview_name
  name.delete_suffix("Preview").underscore
end


  








  

    .preview_paths   (private)
  

  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 131



def preview_paths
  Base.preview_paths
end


  








  

    .show_previews   (private)
  

  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 135



def show_previews
  Base.show_previews
end


  







Instance Attribute Details



  

    #params   (readonly)
  

  [ GitHub ]


  

  


# File 'actionmailer/lib/action_mailer/preview.rb', line 76



attr_reader :params