Module: Marfa::Helpers::Controller

Defined in:
lib/marfa/helpers/controller.rb

Instance Method Summary collapse

Instance Method Details

#csrf_tag ⇒ String

CSRF-tag

Returns:



111
112
113
 
# File 'lib/marfa/helpers/controller.rb', line 111

def csrf_tag
  Rack::Csrf.csrf_tag(env)
end

#csrf_token ⇒ String

Generate CSRF token

Returns:



105
106
107
 
# File 'lib/marfa/helpers/controller.rb', line 105

def csrf_token
  Rack::Csrf.csrf_token(env)
end

#get_cached_content(kind, path, tags = []) ⇒ String, Nil

Render page from cache, store to cache, return html

Examples:

get_cached_content('page', 'index/index', ['tag1', 'tag2'])

Parameters:

  • kind (String) —

    • kind (block, page)

  • path (String) —

    • URL

  • tags (Array) (defaults to: []) —

    • tag list

Returns:

  • (String) —

    data from cache

  • (Nil) 


48
49
50
51
52
 
# File 'lib/marfa/helpers/controller.rb', line 48

def get_cached_content(kind, path, tags = [])
  cache_key = Marfa.cache.create_key(kind, path, tags)
  return Marfa.cache.get(cache_key) if Marfa.cache.exist?(cache_key)
  nil
end

#get_html(options) ⇒ String

Get HTML from cache or render new def get_html(path, tags, data, cache_time = Marfa.config.cache)

Examples:

get_html({ path: 'index', tags: ['tag1', 'tag2'], data: {} })

Parameters:

  • options (Hash) —

    • params

Returns:



121
122
123
124
125
126
127
128
129
130
131
 
# File 'lib/marfa/helpers/controller.rb', line 121

def get_html(options)
  cache_time = options[:cache_time] || Marfa.config.cache[:expiration_time]

  if cache_time > 0
    html = get_cached_content('page', options[:path], options[:tags])
    html = render_page(options) if html.nil?
  else
    html = render_page(options)
  end
  html
end

#render_block(options) ⇒ String Also known as: render_component

Render block from cache, return html

Examples:

render_block({ path: 'index/index', tags: ['tag1', 'tag2'] })

Parameters:

  • options (Hash) —

    • options hash

Returns:



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
 
# File 'lib/marfa/helpers/controller.rb', line 59

def render_block(options)
  # TODO: Improve caching with parameters
  cache_time = options[:cache_time] || Marfa.config.cache[:expiration_time]
  tags = options[:tags] || []

  if cache_time > 0
    content = get_cached_content('block', options[:path], tags)
    return content unless content.nil?
  end

  classname = options[:class_name] || (options[:path].to_class_name + 'Block')
  return unless Object.const_defined?(classname)

  attrs = {
    user_data: @user_data || {},
    query: options[:query] || {}
  }

  block = Object.const_get(classname).new
  data = block.get_data(attrs)
  full_path = Marfa.config.block_templates_path + '/' + options[:path]

  return render_content(full_path, data) if cache_time == 0

  cache_key = Marfa.cache.create_key('block', options[:path], tags)
  render_cached_content(cache_key, full_path, data)
end

#render_cached_content(cache_key, path, data = {}, cache_time = Marfa.config.cache[:expiration_time]) ⇒ String

Rendering cached content

Examples:

render_cached_content('some_key', 'path/url', {})

Parameters:

  • cache_key (String) —

    key

  • path (String) —

    • URL

  • data (Hash) (defaults to: {}) —

    • options hash

Returns:

  • (String) —

    rendered content



18
19
20
21
22
23
 
# File 'lib/marfa/helpers/controller.rb', line 18

def render_cached_content(cache_key, path, data = {}, cache_time = Marfa.config.cache[:expiration_time])
  return Marfa.cache.get(cache_key) if Marfa.cache.exist?(cache_key)
  output = render_content(path, data)
  Marfa.cache.set(cache_key, output, cache_time)
  output
end

#render_content(path, data) ⇒ Object 



7
8
9
 
# File 'lib/marfa/helpers/controller.rb', line 7

def render_content(path, data)
  haml :"#{path}", locals: data
end

#render_page(options) ⇒ String

Render page from cache, return html

Examples:

render_page({ path: 'index', tags: ['tag1', 'tag2'], data: {} })

Parameters:

  • options (Hash) —

    • options hash

Returns:

  • (String) —

    rendered content



30
31
32
33
34
35
36
37
38
 
# File 'lib/marfa/helpers/controller.rb', line 30

def render_page(options)
  cache_time = options[:cache_time] || Marfa.config.cache[:expiration_time]

  full_path = 'pages/' + options[:path]
  return render_content(full_path, options[:data]) if cache_time == 0

  cache_key = Marfa.cache.create_key('page', options[:path], options[:tags])
  render_cached_content(cache_key, full_path, options[:data])
end

#render_static_block(path, data = {}) ⇒ String Also known as: render_static_component

Render block from cache, return html without class eval

Examples:

render_static_block('index/index', ['tag1', 'tag2'])

Parameters:

  • path (String) —

    • URL

  • data (Hash) (defaults to: {}) —

    • data to render

Returns:



93
94
95
96
97
98
99
100
101
 
# File 'lib/marfa/helpers/controller.rb', line 93

def render_static_block(path, data = {})
  content = get_cached_content('block', path)
  return content unless content.nil?

  cache_key = Marfa.cache.create_key('block', path)
  full_path = Marfa.config.block_templates_path + '/' + path

  render_cached_content(cache_key, full_path, data)
end