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 79



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


  







Class Method Details



  

    .all  
  



  

    
Returns all mailer preview classes.

  



  [ GitHub ]


  

  


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



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 93



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 106



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 101



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 111



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 116



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 140



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 126



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 121



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


  








  

    .preview_paths   (private)
  

  [ GitHub ]


  

  


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



def preview_paths
  Base.preview_paths
end


  








  

    .show_previews   (private)
  

  [ GitHub ]


  

  


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



def show_previews
  Base.show_previews
end


  







Instance Attribute Details



  

    #params   (readonly)
  

  [ GitHub ]


  

  


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



attr_reader :params