Module: ComfortableMexicanSofa::RenderMethods

Defined in:
lib/comfortable_mexican_sofa/render_methods.rb

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(base) ⇒ Object 



3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
 
# File 'lib/comfortable_mexican_sofa/render_methods.rb', line 3

def self.included(base)
  
  # If application controller doesn't have template associated with it
  # CMS will attempt to find one. This is so you don't have to explicitly
  # call render :cms_page => '/something'
  base.rescue_from 'ActionView::MissingTemplate' do |e|
    begin
      render :cms_page => request.path
    rescue ComfortableMexicanSofa::MissingPage
      raise e
    end
  end
  
  # Now you can render cms_page simply by calling:
  #   render :cms_page => '/path/to/page'
  # This way application controllers can use CMS content while populating
  # instance variables that can be used in partials (that are included by
  # by the cms page and/or layout)
  #
  # Or how about not worrying about setting up CMS pages and rendering 
  # application view using a CMS layout?
  #   render :cms_layout => 'layout_slug', :cms_blocks => {
  #     :block_label_a => 'content text',
  #     :block_label_b => { :template => 'path/to/template' },
  #     :block_label_c => { :partial  => 'path/to/partial' }
  #   }
  #
  # This way you are populating page block content and rendering
  # an instantialized CMS page.
  #
  # Site is loaded automatically based on the request. However you can force
  # it by passing :cms_site parameter with site's slug. For example:
  #   render :cms_page => '/path/to/page', :cms_site => 'default'
  # 
  def render(options = {}, locals = {}, &block)
    
    if options.is_a?(Hash) && identifier = options.delete(:cms_site)
      unless @cms_site = Cms::Site.find_by_identifier(identifier)
        raise ComfortableMexicanSofa::MissingSite.new(identifier)
      end
    end
    
    if options.is_a?(Hash) && path = options.delete(:cms_page)
      @cms_site ||= Cms::Site.find_site(request.host.downcase, request.fullpath)
      path.gsub!(/^\/#{@cms_site.path}/, '') if @cms_site && @cms_site.path.present?
      
      if @cms_page = @cms_site && @cms_site.pages.find_by_full_path(path)
        @cms_layout = @cms_page.layout
        if (cms_blocks = options.delete(:cms_blocks)).present?
          cms_blocks.each do |identifier, value|
            content = if value.is_a?(Hash)
              render_to_string(value.keys.first.to_sym => value[value.keys.first], :layout => false)
            else
              value.to_s
            end
            page_block = @cms_page.blocks.detect{|b| b.identifier == identifier.to_s} ||
              @cms_page.blocks.build(:identifier => identifier.to_s)
            page_block.content = content
          end
        end
        cms_app_layout = @cms_layout.try(:app_layout)
        options[:layout] ||= cms_app_layout.blank?? nil : cms_app_layout
        options[:inline] = @cms_page.render
        super(options, locals, &block)
      else
        raise ComfortableMexicanSofa::MissingPage.new(path)
      end
      
    elsif options.is_a?(Hash) && identifier = options.delete(:cms_layout)
      @cms_site ||= Cms::Site.find_site(request.host.downcase, request.fullpath)
      if @cms_layout = @cms_site && @cms_site.layouts.find_by_identifier(identifier)
        cms_app_layout = @cms_layout.try(:app_layout)
        cms_page = @cms_site.pages.build(:layout => @cms_layout)
        cms_blocks = options.delete(:cms_blocks) || { :content => render_to_string({ :layout => false }.merge(options)) }
        cms_blocks.each do |identifier, value|
          content = if value.is_a?(Hash)
            render_to_string(value.keys.first.to_sym => value[value.keys.first], :layout => false)
          else
            value.to_s
          end
          cms_page.blocks.build(:identifier => identifier.to_s, :content => content)
        end
        options[:layout] ||= cms_app_layout.blank?? nil : cms_app_layout
        options[:inline] = cms_page.render
        super(options, locals, &block)
      else
        raise ComfortableMexicanSofa::MissingLayout.new(identifier)
      end
      
    else
      super(options, locals, &block)
    end
  end
end

Instance Method Details

#render(options = {}, locals = {}, &block) ⇒ Object

Now you can render cms_page simply by calling:

render :cms_page => '/path/to/page'

This way application controllers can use CMS content while populating instance variables that can be used in partials (that are included by by the cms page and/or layout)

Or how about not worrying about setting up CMS pages and rendering application view using a CMS layout?

render :cms_layout => 'layout_slug', :cms_blocks => {
  :block_label_a => 'content text',
  :block_label_b => { :template => 'path/to/template' },
  :block_label_c => { :partial  => 'path/to/partial' }
}

This way you are populating page block content and rendering an instantialized CMS page.

Site is loaded automatically based on the request. However you can force it by passing :cms_site parameter with site’s slug. For example:

render :cms_page => '/path/to/page', :cms_site => 'default'



37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
 
# File 'lib/comfortable_mexican_sofa/render_methods.rb', line 37

def render(options = {}, locals = {}, &block)
  
  if options.is_a?(Hash) && identifier = options.delete(:cms_site)
    unless @cms_site = Cms::Site.find_by_identifier(identifier)
      raise ComfortableMexicanSofa::MissingSite.new(identifier)
    end
  end
  
  if options.is_a?(Hash) && path = options.delete(:cms_page)
    @cms_site ||= Cms::Site.find_site(request.host.downcase, request.fullpath)
    path.gsub!(/^\/#{@cms_site.path}/, '') if @cms_site && @cms_site.path.present?
    
    if @cms_page = @cms_site && @cms_site.pages.find_by_full_path(path)
      @cms_layout = @cms_page.layout
      if (cms_blocks = options.delete(:cms_blocks)).present?
        cms_blocks.each do |identifier, value|
          content = if value.is_a?(Hash)
            render_to_string(value.keys.first.to_sym => value[value.keys.first], :layout => false)
          else
            value.to_s
          end
          page_block = @cms_page.blocks.detect{|b| b.identifier == identifier.to_s} ||
            @cms_page.blocks.build(:identifier => identifier.to_s)
          page_block.content = content
        end
      end
      cms_app_layout = @cms_layout.try(:app_layout)
      options[:layout] ||= cms_app_layout.blank?? nil : cms_app_layout
      options[:inline] = @cms_page.render
      super(options, locals, &block)
    else
      raise ComfortableMexicanSofa::MissingPage.new(path)
    end
    
  elsif options.is_a?(Hash) && identifier = options.delete(:cms_layout)
    @cms_site ||= Cms::Site.find_site(request.host.downcase, request.fullpath)
    if @cms_layout = @cms_site && @cms_site.layouts.find_by_identifier(identifier)
      cms_app_layout = @cms_layout.try(:app_layout)
      cms_page = @cms_site.pages.build(:layout => @cms_layout)
      cms_blocks = options.delete(:cms_blocks) || { :content => render_to_string({ :layout => false }.merge(options)) }
      cms_blocks.each do |identifier, value|
        content = if value.is_a?(Hash)
          render_to_string(value.keys.first.to_sym => value[value.keys.first], :layout => false)
        else
          value.to_s
        end
        cms_page.blocks.build(:identifier => identifier.to_s, :content => content)
      end
      options[:layout] ||= cms_app_layout.blank?? nil : cms_app_layout
      options[:inline] = cms_page.render
      super(options, locals, &block)
    else
      raise ComfortableMexicanSofa::MissingLayout.new(identifier)
    end
    
  else
    super(options, locals, &block)
  end
end