module QuietLeightbox::QuietLeightboxHelper

The helper module - methods for use within views.

Public Instance Methods

include_leightbox_if_used( line_prefix = '' ) click to toggle source

Include Leightbox only if used for the current view, according to the Controller. Invoke using “<%= include_quiet_leightbox_if_used -%>” from within the HEAD section of an XHTML view. If you want your HTML output to be nice and tidy in terms of indentation :-) then pass a string in the optional parameter - it will be inserted before each “<script>” tag in the returned HTML fragment.

Note that a trailing newline is output so you can call the helper with the “-%>” closing ERB tag (as shown in the previous paragraph) to avoid inserting a single blank line into your output in the event that the plugin is not used by the current view.

# File lib/quiet_leightbox/quiet_leightbox.rb, line 49
def include_leightbox_if_used( line_prefix = '' )
  return unless using_quiet_leightbox?

  data = ""

  # 2013-07-18 (ADH): Even with appropriate configuration data in
  # "config/application.rb" for the ":defaults" expansion, using it
  # here results in "assets/defaults.js" being generated. Doh. Since
  # code here is evaluated before the application starts, presumably
  # the expansion isn't defined in time. Instead we have to do it
  # the hard way.
  #
  # In addition, cooperate with the "Quiet Prototype" plugin.

  unless ( respond_to?( :using_quiet_prototype? ) && using_quiet_prototype?() )
    data         << javascript_include_tag( 'prototype/prototype' )
    data << "\n" << javascript_include_tag( 'prototype_ujs/rails' )
    data << "\n" << javascript_include_tag( 'scriptaculous/scriptaculous' )
    data << "\n"
  end

  data         << javascript_include_tag( 'leightbox/leightbox' )
  data << "\n" << stylesheet_link_tag( 'leightbox/leightbox' )

  return ( data.gsub( /^/, line_prefix ) + "\n" ).html_safe()
end
using_quiet_leightbox?() click to toggle source

Returns ‘true’ if configured to use the Leightbox library for the view related to the current request. See the “uses_leightbox” class method for more information.

# File lib/quiet_leightbox/quiet_leightbox.rb, line 80
def using_quiet_leightbox?
  ! @uses_leightbox.nil?
end