agile_rails 0.0.0.1

data/app/renderers/ar_menu_renderer.rb

@@ -0,0 +1,195 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+
+########################################################################
+# Default menu renderer from ar_menus table. Renderer produces output for
+# rendering menu with (theoretically) infinite level of sub menus. In practice 
+# reasonable maximum level of 4 is advised.
+# 
+# Example (as used in design):
+#    agile_render(:ar_menu, name: 'my_menu')
+#    # when :name option is omitted it will use site document's field menu_name.
+#    agile_render(:ar_menu)
+########################################################################
+class ArMenuRenderer
+
+include AgileApplicationHelper
+include AgileCommonHelper
+
+########################################################################
+# Object initialization. Will also prepare menu record.
+########################################################################
+def initialize( env, opts ) #:nodoc:
+  @env  = env
+  @menu = opts[:name] ? ArMenu.find_by(name: opts[:name].to_s) : ArMenu.find(@env.site.menu_id)
+  @opts = opts
+  self
+end
+
+########################################################################
+# Return selected topmenu level.
+########################################################################
+def find_selected
+  if @env.page.menu_id
+    top_menu_id = @env.page.menu_id
+    top_menu_id = @env.page.menu_id.split(';')[1] if @env.page.menu_id.match(';')
+    ret = @menu.ar_menu_items.find(top_menu_id)
+  end
+  # return first if not found (something is wrong)
+  ret || @menu.ar_menu_items[0]
+end
+
+########################################################################
+# Creates edit link if in edit mode.
+########################################################################
+def link_for_edit(opts) #:nodoc:
+  return '' unless @opts[:edit_mode] > 1
+
+  opts.merge!( { controller: :agile, action: :edit } )
+  title = "#{t('agile.edit')}: "
+  opts[:title] = "#{title} #{opts[:title]}"
+
+  "<li>#{agile_link_for_edit(opts)}</li>\n"
+end
+
+########################################################################
+# Returns html code required to create single link in a menu. Subroutine of do_menu_level.
+########################################################################
+def link_4menu(item, prepend)
+  link = if item.link_to.present?
+              item.link_to
+            else
+              '/' + (prepend + [item.link.delete_prefix('/')]).join('/')
+            end
+  target = item.target.blank? ? nil : item.target
+  # - in first place won't write caption text
+  caption   = item.caption[0] == '-' ? '' : @env.t(item.caption)
+  img_title = item.caption.to_s.sub('-', '')
+  # add picture if picture is not blank
+  html = ''
+  if item.picture.present?
+    if item.picture[0, 3] == 'mi-'
+      # position is delimited with comma
+      icon, position = item.picture.split(',')
+      caption = if position.to_s == 'right'
+                  caption + @env.mi_icon(icon[3..])
+                else
+                  @env.mi_icon(icon[3..]) + caption
+                end
+    else
+      return @env.link_to( @env.image_tag(item.picture), link, { title: img_title, target: target } ) rescue 'ERROR!'
+    end
+  end
+  html = html + @env.link_to(caption.html_safe, link, { target: target} ) if caption.present?
+  html
+end
+
+########################################################################
+# Creates HTML code required for submenu on single level. Subroutine of default.
+########################################################################
+def submenu_do(items, env, prepend)
+  html = '<ul>'
+  items.sort_by(&:order).each do |item|
+    next if item.hidden
+
+    can_view, msg = agile_user_can_view(@env, item)
+    next unless can_view
+
+    if @opts[:edit_mode] > 1
+      options = { table: 'ar_menu;ar_menu_item', form_name: :ar_menu_item, id: item.id, ids: "#{@menu.id};#{env.id}" }
+      html += link_for_edit(options)
+    end
+
+    prepend_path = item.prepend_path ? prepend + [env.link] : []
+    html += %(<li>#{link_4menu(item, prepend_path)}\n)
+    if sub_menus = @menu_items[item.id]
+      html += submenu_do(sub_menus, item, prepend_path)
+    end
+    html += '</li>'
+  end
+  html += '</ul>'
+end
+
+########################################################################
+# Creates HTML code required for submenu on single level. Subroutine of default.
+########################################################################
+def menu_do
+  html = '<ul>'
+  if @opts[:edit_mode] > 1
+    options = { table: :ar_menu, title: @menu.name, id: @menu.id }
+    html += link_for_edit(options)
+  end
+  # read menu into hash
+  @menu_items  = {}
+  ArMenuItem.where(ar_menu_id: @menu.id, active: :true).each do |item|
+    @menu_items[item.parent_id] ||= []
+    @menu_items[item.parent_id] << item
+  end
+  return '' if @menu_items.size == 0
+
+  @menu_items[0].sort_by(&:order).each do |item|
+    next if item.hidden
+
+    # menu can be hidden from user
+    can_view, msg = agile_user_can_view(@env, item)
+    next unless can_view
+
+    selected = 'selected' if @opts[:path]&.first == item.link
+    html += %(<li class="#{selected}">#{link_4menu(item, [])}\n)
+
+    # SUBMENUS
+    if sub_menus = @menu_items[item.id]
+      html += submenu_do(sub_menus, item, [])
+    end
+    html += '</li>'
+  end
+  html += '</ul>'
+end
+
+########################################################################
+# Creates default menu.
+########################################################################
+def default
+  return "(#{@opts[:name]}) menu not found!" if @menu.nil?
+
+  #@selected = find_selected
+  div_name = @menu.div_name.blank? ? 'ar-menu' : @menu.div_name
+  %(<nav class="#{div_name}">\n#{menu_do()}\n</nav>)
+end
+
+########################################################################
+# Renderer dispatcher. Method returns HTML part of code.
+########################################################################
+def render_html
+  method = @opts[:method] || 'default'
+  respond_to?(method) ? send(method) : "Error ArMenu: Method #{method} doesn't exist!"
+end
+
+########################################################################
+# Return CSS part of code.
+########################################################################
+def render_css
+  @menu.css if @menu
+end
+
+end

data/app/renderers/ar_page_renderer.rb

@@ -0,0 +1,147 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+
+########################################################################
+# Page renderer renders data from ar_page collection documents. This renderer will
+# almost certainly be replaced by your own renderer so example here shows just basic code 
+# which just checks if user is allowed to view data and if so returns document body content
+# otherwise returns error message defined in site policy.
+# 
+# Example:
+#    <div id="page">
+#      <%= agile_render(:ar_page, div_class: 'my-pages') %>
+#    </div>
+#
+########################################################################
+class ArPageRenderer
+
+include AgileApplicationHelper
+include  AgileCommonHelper
+
+########################################################################
+# Object initialization.
+########################################################################
+def initialize( env, opts={} ) #:nodoc:
+  @env  = env
+  @opts = opts
+  @page = @env.page
+  @css  = ''
+end
+
+#########################################################################
+# Render IFrame part if defined on page
+# 
+# Parameters forwarded to iframe are defined in if_params field as yaml as:
+#   param_name:
+#     object: internal object name (params, session, site, page)
+#     method: method name (variable) holding the value of parameter
+#     
+#   example: Forward id parameter to iframe 
+#   id:
+#     object: params
+#     method: id
+#     
+#   example: Forward user id and edit_mode to iframe
+#   user_id:
+#     object: session
+#     method: user_id
+#   edit:
+#     object: session
+#     method: edit_mode
+#     
+#########################################################################
+def iframe
+  html =  "\n<iframe"
+  html += " id=\"#{@page.if_id}\"" if @page.if_id.present?
+  html += " class=\"#{@page.if_class}\"" if @page.if_class.present?
+  html += " border=\"#{@page.if_border}\""
+  html += " height=\"#{@page.if_height}\"" if @page.if_height.present?
+  html += " width=\"#{@page.if_width}\"" if @page.if_width.present?
+  html += " scrolling=\"#{@page.if_scroll}\""
+  # Parameters
+  parameters = @page.if_url.match(/\?/) ? '' : '?' 
+  params = YAML.load(@page.if_params) rescue {}
+  params = {} unless params.class == Hash
+  params.each do |key, value|
+    val = @env.ar_internal_var(value['object'], value['method'])
+    parameters += "&#{key}=#{val}" if val # only when not nil
+  end
+  url = @page.if_url + (parameters.size > 1 ? parameters : '')
+  html += "src=\"#{url}\" ></iframe>\n"
+  html
+end
+
+#########################################################################
+#
+#########################################################################
+def poll
+  opts = @opts.merge(poll_id: @page.ar_poll_id, return_to: @env.request.url, method: nil)
+  poll = ArPollRenderer.new(@env, opts)
+  @css += "\n#{poll.render_css}"
+  "<div class='wrap row'>#{poll.render_html}</div>"
+end
+
+#########################################################################
+#
+#########################################################################
+def gallery
+  opts = @opts.merge(doc_id: @page.id, doc_type: @page.class.to_s.underscore, method: nil)
+  gall = ArGalleryRenderer.new(@env, opts)
+  @css += "\n#{gall.render_css}"
+  "<div class='wrap row'>#{gall.render_html}</div>"
+end
+
+#########################################################################
+# Default ArPage render method
+#########################################################################
+def default
+  can_view, msg = agile_user_can_view(@env, @page)
+  return msg unless can_view
+
+  @env.page_title = @page.title.blank? ? @page.subject : @page.title
+  html = "<div class=\"#{@page.div_class} #{@opts[:div_class]}\">"
+  html += agile_page_edit_menu() if @opts[:edit_mode] > 1
+  html += @page.body
+
+  html += poll()    if @page.ar_poll_id.to_i > 0
+  html += gallery() if @page.gallery
+  html += iframe()  if @page.if_url.present?
+  html += '</div>'
+end
+
+#########################################################################
+# Renderer dispatcher. Method returns HTML part of code.
+########################################################################
+def render_html
+  method = @opts[:method] || 'default'
+  respond_to?(method) ? send(method) : "Error ArPage: Method #{method} doesn't exist!"
+end
+
+########################################################################
+# Return CSS part of code.
+########################################################################
+def render_css
+  @css
+end
+
+end

data/app/renderers/ar_part_renderer.rb

@@ -0,0 +1,235 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+
+########################################################################
+# Renders one or multiple parts grouped by div_id field.
+# Parts are scoped from design, page and ar_pieces documents.
+# 
+# Example (as used in design):
+#    <div id='div-main'>
+#      <div id='div-left'> <%= agile_render(:ar_part, position: 'left') %></div>
+#      <div id='page'> <%= agile_render(:ar_page) %></div>
+#      <div id='div-right'>
+#        <%= agile_render(:ar_part, method: 'in_page', name: 'welcome')
+#        <%= agile_render(:ar_part, position: 'right')</div>
+#      </div>
+#    </div>
+#    
+# Main page division in example is divided into 3 divisions. div-left, page and div-right.
+# div-left and div-right are populated with parts containing 'left' and 'right' div_id value. 
+# In addition part with name 'welcome' is located above 'right' parts.
+########################################################################
+class ArPartRenderer
+
+include AgileApplicationHelper
+include  AgileCommonHelper
+
+########################################################################
+# Object initialization.
+########################################################################
+def initialize( env, opts={} ) #:nodoc:
+  @env      = env
+  @opts     = opts
+  @part_css = ''
+  self
+end
+
+########################################################################
+# Method returns output from single part(icle). It checks if policy allows part to 
+# be viewed on page and ads links for editing when in edit mode.
+########################################################################
+def render_particle(particle, opts)
+  # Check if policy allows to view page
+  can_view, msg = agile_user_can_view(@env, particle)
+  return msg unless can_view
+  html = ''
+  if @opts[:edit_mode] > 1
+    opts[:edit_params].merge!(title: "#{t('agile.edit')}: #{particle.name}", controller: :agile)
+    html += agile_link_for_edit( opts[:edit_params] )
+  end
+#
+=begin
+  if particle.piece_id
+    opts[:id] = particle.piece_id
+    piece = ArPieceRenderer.new(@env, opts)
+    html += piece.render_html
+    @part_css += piece.render_css
+  else
+    html += particle.body
+    @part_css += particle.css.to_s
+  end
+=end
+  @part_css += particle.css.to_s
+  html += particle.body
+end
+
+########################################################################
+# Load all parts defined in design, page or piece collection into memory. 
+# Subroutine of default method.
+########################################################################
+def load_parts #:nodoc:
+  @env.parts = []
+# Start with parts in design. Collect to array and add values needed for editing
+  if @env.design
+    @env.design.ar_parts.where(active: true).each do |part|
+      type = decamelize_type(part._type) || 'ar_part'
+      @env.parts += [part, @env.design.id, type, "ar_design;#{type}"]
+    end
+  end
+# add parts in page
+  @env.page.ar_parts.where(active: true).each do |part|
+    type = decamelize_type(part._type) || 'ar_part'
+    @env.parts += [part, @env.page.id, type, "#{@env.site.page_class.underscore};#{type}"]
+  end
+# add parts in site
+  @env.site.ar_parts.where(active: true).each do |part|
+    type = decamelize_type(part._type) || 'ar_part'
+    @env.parts += [part, @env.site.id, type, "ar_site;#{type}"]
+  end
+# add parts belonging to site, defined in ar_pieces
+  ArPiece.where(site_id: @env.site.id, active: true).each do |part|
+    @env.parts += [part, part.id, 'ar_piece', 'ar_piece']
+  end
+end  
+
+########################################################################
+# Default method collects all parts with the div_id field value defined by position option.
+# If more then one parts have same div_id they will be sorted by order field. Method
+# also loads all parts from design, page and pieces collections and cache them for 
+# consecutive calls.
+# 
+# Options: 
+# [position] String. Position (value of div_id) where parts will be rendered.
+# 
+# Example (as used in design):
+#     <div id='div-right'>
+#       <%= agile_render(:ar_part, position: 'right')
+#     </div>
+########################################################################
+def default
+  html = "<div class=\"#{@opts[:div_class]}\">"
+# Load all parts only once per call  
+  load_parts if @env.parts.nil?
+  ar_deprecate ' ArPart: Parameter location will be deprecated! Please use position keyword.' if @opts['location']
+  
+  @opts[:position] ||= @opts['position'] # symbols are not strings. Ensure that it works.
+# Select parts
+  parts = []
+  @env.parts.each { |v| parts << v if v[0].div_id == @opts[:position] }
+# Edit link
+  @opts[:edit_params].merge!( { controller: :agile, action: 'edit' } )
+  if parts.size > 0
+    parts.sort! {|a,b| a[0].order <=> b[0].order }
+  
+    parts.each do |part| 
+      @opts[:edit_params].merge!( id: part[0], ids: "#{part[1]}", form_name: part[2], table: part[3] )
+      html += render_particle(part[0], @opts)
+    end
+  end
+  html += "</div>"
+end
+
+########################################################################
+# This method will search and render single part defined in pages file. Part may
+# be defined in current page document or in any page document found in pages file. Parameters
+# are send through options hash. 
+# 
+# Options: 
+# [name] String. ar_parts name.
+# [page_id] String. Page document id where part document is saved. Defaults to current page.
+# [page_link] String. Page may alternatively be found by link field.
+########################################################################
+def in_page
+# Part is in page with id  
+  page = if @opts[:page_id]
+    pageclass = @env.site.page_klass
+    pageclass.find(@opts[:page_id])
+  # Part is in page with subject link
+  elsif @opts[:page_link]
+    pageclass = @env.site.page_klass
+    @page = pageclass.find_by(ar_site_id: @env.site.id, link: @opts[:page_link])
+  # Part is in current page
+  else
+    @env.page
+  end
+  return "Error ArPart: Page not found!" if page.nil?
+
+  if part = page.ar_parts.find_by(name: @opts[:name])
+    @opts[:edit_params].merge!(id: part, ids: page.id, form_name: 'ar_part', table: "#{@env.site.page_class.underscore};ar_part" )
+    render_particle(part, @opts) 
+  else
+    "Part with name #{@opts[:name]} not found in page!"
+  end
+end
+
+########################################################################
+# Renderer for single datapage kind of sites.
+########################################################################
+def single_sitedoc
+# if div_id option specified search for part with this div_id. 
+# This can be used to render footer or header of site.
+  part = if @opts[:div_id]
+    @env.parts.find_by(div_id: @opts[:div_id])
+  else
+    @env.part
+  end
+# part not found. Render error message.
+  return "Part #{@opts[:div_id]} not found!" if part.nil?
+# prepare edit parameters  
+  @opts[:edit_params].merge!(id: part, ids: @env.site.id, form_name: 'ar_part',
+                            table: "ar_site;ar_part", record_div_id: 'document' )
+  render_particle(part, @opts) 
+end
+
+########################################################################
+# Render menu for single datapage kind of sites.
+########################################################################
+def single_sitedoc_menu
+# prepare div markup
+  menu_div = @opts[:menu_div] ? "id=#{@opts[:menu_div]}" : ''
+  html = "<div #{menu_div}><ul>\n"
+# collect all ar_part documents which make menu
+  @env.parts.where(div_id: 'document').order(:order).each do |part|
+# mark selected item    
+    selected = (part == @env.part) ? 'class="menu-selected"' : ''
+    html += "<li #{selected}>#{ @env.link_to(part.name, part.link ) }</li>\n"
+  end
+  html += "</ul></div>\n"
+end
+
+########################################################################
+# Renderer dispatcher. Method returns HTML part of code.
+########################################################################
+def render_html
+  method = @opts[:method] || 'default'
+  respond_to?(method) ? send(method) : "Error ArPart: Method #{method} doesn't exist!"
+end
+
+########################################################################
+# Return CSS part of code.
+########################################################################
+def render_css
+  @part_css
+end
+
+end

data/app/renderers/ar_piece_renderer.rb

@@ -0,0 +1,119 @@
+#--
+# Copyright (c) 2024+ Damjan Rems
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#+
+
+########################################################################
+# Piece renderer renders data from ar_piece table.
+# 
+# Example:
+#    <div id="page">
+#      <%= agile_render(:ar_piece, :name => 'some_piece') %>
+#    </div>
+#
+########################################################################
+class ArPieceRenderer
+
+include AgileApplicationHelper
+include  AgileCommonHelper
+########################################################################
+# Object initialization. It also loads requested ar_piece document.
+########################################################################
+def initialize( env, opts = {} ) #:nodoc:
+  @env    = env
+  @opts   = opts
+  @piece  = ArPiece.find(opts[:id]) if opts[:id]
+  if @piece.nil? # alternatively find by name
+    name = opts[:name] || opts[:id]
+    @piece = if @opts[:site] 
+      ArPiece.find_by(name: name, site_id: agile_get_site.id)
+    else 
+      ArPiece.find_by(name: name) 
+    end
+  end
+end
+
+#########################################################################
+# Return link code for editing this piece.
+########################################################################
+def link_4edit()
+  html = ''
+  return html if @opts[:edit_mode] < 2
+  @opts[:edit_params].merge!( { table: 'ar_piece', 
+                               form_name: 'ar_piece', 
+                               controller: :agile, 
+                               action: 'edit', 
+                               id: @piece.id,
+                               title: "#{t('agile.edit')}: #{@piece.name}" } )
+  html += agile_link_for_edit( @opts[:edit_params] )
+end
+
+########################################################################
+# Script renderer method expects rails erb code (view) in the script field.
+# Used for designs with common code which can be shared and one part which is different.
+# It's functionality can be replaced with ar_replace_in_design method with 'piece' option 
+# specified.
+# 
+# Example: As used in design. Backslashing < and % is important \<\%
+# <% part = "<div  class='some-class'>\<\%= agile_render(:my_renderer, method: 'render_method') \%\></div>" %>
+# <%= agile_render(:ar_piece, id: 'common', method: 'script', replace: '[main]', with: part) %>
+# 
+# Want to replace more than one part. Use array.
+# <%= agile_render(:ar_piece, id: 'common', method: 'script', replace: ['[part1]','[part2]'], with: [part1, part2]) %>
+########################################################################
+def script
+  s = @piece.script
+  if @opts[:replace]
+# replace more than one part of code
+    if @opts[:replace].class == Array
+      0.upto(@opts[:replace].size - 1) {|i| s.sub!(@opts[:replace][i], @opts[:with][i])}
+    else
+      s.sub!(@opts[:replace], @opts[:with])
+    end
+  end
+  @env.render(inline: s, layout: @opts[:layout])
+end
+
+#########################################################################
+# Default ArPiece render method. 
+########################################################################
+def default
+  html = link_4edit()
+  html += @piece.body
+end
+
+#########################################################################
+# Renderer dispatcher. Method returns HTML part of code.
+########################################################################
+def render_html
+  return " ArPiece #{@opts[:id]} #{@opts[:name]} not found!" unless @piece
+  method = @opts[:method] || 'default'
+  respond_to?(method) ? send(method) : "Error ArPiece: Method #{method} doesn't exist!"
+end
+
+########################################################################
+# Return CSS part of code.
+########################################################################
+def render_css
+  @piece ? "#{@piece.css}" : ''
+end
+
+end