agile_rails 0.0.0.1

data/app/renderers/ar_poll_renderer.rb

@@ -0,0 +1,272 @@
+#--
+# 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 code for displaying a poll. Polls may replace forms when user interaction
+# is required in browser.
+########################################################################
+class ArPollRenderer
+  
+include  AgileCommonHelper
+include AgileApplicationHelper
+include ActionView::Helpers::FormHelper # for form helpers
+include ActionView::Helpers::FormOptionsHelper # for select helper
+
+########################################################################
+# Object initialization.
+########################################################################
+def initialize( env, opts = {} ) #:nodoc:
+  @env      = env
+  @opts     = opts
+  @part_css = ''
+  @part_js  = ''
+  self
+end
+
+########################################################################
+# Dummy params method for accesing environment params object from form.
+########################################################################
+def params
+  @env.params
+end
+
+########################################################################
+# Outputs code required for poll item. Subroutine of default method.
+########################################################################
+def do_one_item(poll, yaml)
+  html = ''
+  yaml['separator'] ||= ''
+  yaml['text']      ||= ''
+  # label
+  text = yaml['text'].match(/\./) ? t(yaml['text']) : yaml['text']
+  if yaml['mandatory']
+    text += ( poll.display == 'in' ? ' *' : '<span class="required"> *</span>' )
+    yaml['html'] ||= {}
+    yaml['html']['required'] = true
+  else
+    text += " &nbsp;" if poll.display == 'lr' and !yaml['type'].match(/submit_tag|link_to/)
+  end
+
+  # Just add text if comment and go to next one
+  if yaml['type'] == 'comment'
+    html += if poll.display == 'lr'
+      "<div class='row-div'><div class='ar-form-label poll-data-text comment'>#{text}</div></div>"
+    else
+      "<div class='poll-data-text comment'>#{text}</div>"
+    end
+    return html
+  end
+
+  # Set default value, if not already set
+  if yaml['default']
+    if yaml['default'].match('eval')
+      e = yaml['default'].match(/\((.*?)\)/)[1]
+      yaml['default'] = eval e
+    elsif yaml['default'].match('params')
+      param_name = yaml['default'].split(/\.|\ |\,/)[1]
+      yaml['default'] = @env.params[param_name]
+    end
+    key = "p_#{yaml['name']}"
+    params[key] = yaml['default'] unless params[key]
+  end
+  # Label as placeholder
+  if poll.display == 'in'
+    yaml['html'] ||= {}
+    yaml['html']['placeholder'] = text
+  end
+  # create form_field object and retrieve html code
+  clas_string = yaml['type'].camelize
+  field_html = if AgileFormFields.const_defined?(clas_string)
+    clas = AgileFormFields.const_get(clas_string)
+    field = clas.new(@env, @record, yaml).render
+    @part_js += field.js
+    field.html
+  else # error string
+    "Error: Code for field type #{yaml['type']} not defined!"
+  end
+
+  if yaml['type'].match(/submit_tag|link_to/)
+    # There can be more than one links on form. End the data at first link or submit.
+    if !@end_of_data
+      html += (poll.display == 'lr' ? "</div><br>\n" : "</div>\n")
+      # captcha
+      if poll.captcha_type.to_s.size > 1
+        @opts.merge!(:captcha_type => poll.captcha_type)
+        captcha = ArCaptchaRenderer.new(@env, @opts)
+        html += captcha.render_html
+        @part_css = captcha.render_css
+      end
+      @end_of_data = true
+    end
+    # submit and link tag
+    clas = yaml['type'].match(/submit_tag/) ? '' : 'ar-link-submit'
+    html += "<span class='#{clas}'>#{field_html}#{yaml['separator']}</span>"
+  # other fields
+  else
+    html += case
+      when poll.display == 'lr' then
+      "<div class='row-div'><div class='ar-form-label poll-data-text lr #{yaml['class']}'>#{text}</div><div class='poll-data-field td #{yaml['class']}'>#{field_html}</div></div>\n"
+      when poll.display == 'td' then
+      "<div class='poll-data-text td #{yaml['class']}'>#{text}</div><div class='poll-data-field td #{yaml['class']}'>#{field_html}#{yaml['separator']}</div>\n"
+      else
+      "<div class='poll-data-field in #{yaml['class']}'>#{field_html}#{yaml['separator']}</div>\n"
+    end
+  end
+end
+
+########################################################################
+# Call method before poll is displayed. Usefull for filling predefined values into flash[:record][value]
+# Method cane be defined as ClassName.method or only method.
+# If only method is defined then method name must exist in helpers.
+#
+# Called method must return at least one result if process can continue.
+########################################################################
+def eval_pre_display(code)
+  a = code.strip.split('.')
+  if a.size == 1
+    continue, message = @env.send(a.first)
+  else
+    klass = a.first.classify.constantize
+    continue, message = klass.send(a.last,@env)
+  end
+  [continue, message]
+end
+
+########################################################################
+# Default poll renderer method. Renders data for specified pool.
+########################################################################
+def default
+  # poll_id may be defined in params or opts
+  poll_id = @opts[:poll_id] || @env.params[:poll_id]
+  return '<br>Poll id is not defined?<br>' if poll_id.nil?
+
+  poll = ArPoll.find_by(id: poll_id) || ArPoll.find_by(name: poll_id)
+  return %(<div class="ar-form-error">Invalid Poll id #{poll_id}</div>) if poll.nil?
+
+  # If env cant be seen. so cant be polls
+  can_view, message = agile_user_can_view(@env, @env.page)
+  return %(<div class="ar-form-error">#{message}</div>) unless can_view
+
+  html = @opts[:div] ? %(<div id="#{@opts[:div]}"'>) : ''
+  html += '<a name="poll-top"></a>'
+  if poll.pre_display.present?
+    begin
+      continue, message = eval_pre_display(poll.pre_display)
+    rescue Exception => e
+      return %(<div class="ar-form-error">Error! Poll pre display. Error: #{e.message}</div>)
+    end
+    return message unless continue
+
+    html += message if message
+  end
+  # there might be more than one poll displayed on page. Check if messages and values are for me
+  if @env.flash[:poll_id].nil? || @env.flash[:poll_id].to_s == poll_id.to_s
+    # If flash[:record] is present copy content to params record hash
+    @env.flash[:record].each {|k,v| @env.params["p_#{k}"] = v } if @env.flash[:record]
+    # Error during procesing request
+    html += %(<div class="ar-form-error">#{@env.flash[:error]}</div>\n) if @env.flash[:error].to_s.size > 0
+    html += %(<div class="ar-form-info">#{@env.flash[:info]}</div>\n) if @env.flash[:info]
+  end
+  # div and form tag
+  html +=  %(<div class="poll-div">\n)
+  # edit link
+  if @opts[:edit_mode] > 1
+    @opts[:edit_params].merge!( controller: :agile, action: :edit, id: poll.id, table: 'ar_poll', form_name: 'ar_poll' )
+    @opts[:edit_params].merge!(title: "#{t('agile.edit')}: #{poll.name}")
+    @opts[:edit_params].delete(:ids) # this is from page, but it gets in a way
+    html += agile_link_for_edit( @opts[:edit_params] )
+  end
+
+  html += case
+  when poll.operation == 'poll_submit' then
+    @env.form_tag(action: poll.operation, method: :put)
+  when poll.operation == 'link' then
+    @env.form_tag( poll.parameters, method: :put)
+  end
+  # header, - on first position will not display title
+  html += %(<div class="poll-title">#{poll.title}</div>) unless poll.title[0] == '-'
+  html += %(<div class="poll-text">#{poll.sub_text}</div>)
+  html += if poll.display == 'lr'
+            %(\n<div class="poll-data-table">)
+          else
+            %(<div class="poll-data-div">\n)
+          end
+  # items. Convert each item to yaml
+  @end_od_data = false
+  if poll.form.to_s.size < 10
+    poll.ar_poll_items.order(order: 'asc').each do |item|
+      next unless item.active # disabled items
+      # convert options to yaml
+      begin
+        yaml = YAML.load(item.options) || {}
+        yaml = {} if yaml.class == String
+      rescue Exception => e
+        html += %(<div class="ar-form-error">Item #{item.name}! Error: #{e.message}</div>)
+        next
+      end
+
+      yaml['name'] = item.name
+      yaml['html'] ||= {}
+      yaml['html']['size'] = item.size
+      (yaml['html']['class'] ||= 'ra-submit') if item.field_type == 'submit_tag'
+      yaml['text']      = item.text
+      yaml['mandatory'] = item.mandatory
+      yaml['type']      = item.field_type
+
+      html += do_one_item(poll, yaml)
+    end
+  else
+    yaml = YAML.load(poll.form.gsub('&nbsp;', ' ')) # very annoying. They come with copy&paste ;-)
+    # if entered without numbering yaml is returned as Hash otherwise as Array
+    yaml.each { |i| html += do_one_item(poll, (i.class == Hash ? i : i.last)) }
+  end
+  # hide some fields usefull as parameters
+  html += @env.hidden_field_tag('return_to', @opts[:return_to] || @env.params[:return_to] || @env.request.url)
+  html += @env.hidden_field_tag('return_to_error', @env.request.url )
+  html += @env.hidden_field_tag('poll_id', poll_id )
+  html += @env.hidden_field_tag('page_id', @env.page.id )
+  # Add javascript code
+  html += @env.javascript_tag(@part_js + poll.js.to_s)
+  html += "</form></div>"
+  html += '</div>' if @opts[:div]
+  
+  @part_css = poll.css
+  html
+end
+
+########################################################################
+# Renderer dispatcher. Method returns HTML part of code.
+########################################################################
+def render_html
+  method = @opts[:method] || 'default'
+  respond_to?(method) ? send(method) : "Error ArPoll: Method #{method} doesn't exist!"
+end
+
+########################################################################
+# Return CSS part of code.
+########################################################################
+def render_css
+  @part_css
+end
+
+end

data/app/views/agile/_edit_stuff.html.erb

@@ -0,0 +1,57 @@
+<div id="agile-div">
+  <button class="cms-toggle mode-<%= session[:edit_mode] %>" title="<%= t('agile.toggle_cms')%>"></button>
+
+  <% if session[:edit_mode] > 1 %>
+    <div class="agile-top">
+      <div id="cms-top-menu">
+
+        <% if @page %>
+          <%= link_to( mi_icon('description-o', title: "#{t('agile.edit_page')}"),
+              { controller: :agile, action: :edit, table: @site.page_class, id: @page.id }, target: :iframe_cms) %>
+        <% end %>
+
+        <% if @design %>
+          <%= link_to( mi_icon('web', title: "#{t('agile.edit_design')}"),
+              { controller: :agile, action: :edit, table: :ar_design, id: @design.id }, target: :iframe_cms) %>
+        <% end %>
+
+        <% if @site %>
+          <%= link_to( mi_icon('public', title: "#{t('agile.edit_site')}"),
+              { controller: :agile, action: :edit, table: :ar_site, id: @site.id }, target: :iframe_cms) %>
+        <% end %>
+        <span>|</span>
+        
+        <%= link_to( mi_icon('compress', title: t('agile.minimize')), '#',
+            onclick: "$('#iframe_cms').height(1); return false;" ) %>
+
+        <%= link_to( mi_icon('expand', title: t('agile.maximize')), '#',
+            onclick: "$('#iframe_cms').height( $('#iframe_cms').height() + 500); return false;")  %>
+
+        <%= link_to( mi_icon('refresh', title: t('agile.reload')), '#',
+            onclick: "document.location.reload(true); return false;")  %>
+        <span>|</span>
+
+        <%= link_to( mi_icon('content_paste-o', title: t('agile.rpaste_title')),
+            { controller: :agile_common, action: :paste_clipboard }, target: :iframe_cms) %>
+
+        <%#= AgileFormFields::Elfinder.file_manager_url(self) %>
+
+      </div>
+    </div>
+<% if false %>
+    <div id="menu-hamburger"><%= mi_icon('bars') %></div>
+<% end %>
+    <div class="agile-container">
+      <div id="cms-menu">
+        <%= agile_application_menu %>
+      </div>
+
+      <div class="agile-iframe" style="width: 99%;">
+        <iframe id="iframe_cms" name="iframe_cms"></iframe>
+      </div>
+      <div style="clear: both;"></div>
+
+    </div>
+  
+  <% end %>
+</div>

data/app/views/agile/_form.html.erb

@@ -0,0 +1,24 @@
+<div id="ar-form-container">
+  <div id="ar-form-left">
+    <%= agile_form_left %>
+  </div>
+
+  <div id="ar-form-right">
+    <%= agile_flash_messages %>
+    <%= agile_error_messages_for @record %>
+    <%= agile_warning_messages_for @record %>
+
+    <div class="ar-form-frame">
+    <% fields = agile_fields_for_form %>
+    <%= agile_actions_for_form 'top' %>
+
+    <%= fields %>
+    <%= agile_document_statistics %>
+
+    <%= agile_actions_for_form 'bottom' %>
+    </div>
+
+    <%= javascript_tag(@js)  unless @js.blank? %>
+    <% if @css.present? %><style><%= @css %></style><% end %>
+  </div>
+</div>

data/app/views/agile/_result.html.erb

@@ -0,0 +1,28 @@
+
+<div class="ar-table-frame">
+
+  <% if @form['index']['data_set']['type'] == 'method' %>
+    <%= agile_process_data_set_method %>
+  <% elsif @records %>
+    <%= agile_background_for_dataset(:start) %>
+    <%= agile_header_for_dataset %>
+
+    <% @records.each do |record| %>
+      <%= agile_row_for_dataset(record) %>
+      <%= agile_actions_for_dataset(record) %>
+      <%= agile_columns_for_dataset(record) %>
+      </div>
+    <% end %>
+
+    <% if @footer_record %>
+      <div class="ar-result-data footer">
+      <%= agile_dataset_actions_for_footer() %>
+      <%= agile_columns_for_dataset(@footer_record) %>
+      </div>
+    <% end %>
+
+    <%= agile_background_for_dataset(:end) %>
+  <% end %>
+  <%= agile_filter_popup() %>
+  
+</div>

data/app/views/agile/edit.html.erb

@@ -0,0 +1,13 @@
+<% agile_update_form %>
+
+<div <%= agile_form_id %>>
+  <%= agile_head_for_form %>
+  <%= agile_dialog_title agile_edit_title() %>
+
+  <%= form_tag( @form_params, method: :put, id: AgileHelper.form_param(params) || AgileHelper.table_param(params),
+                class: 'agile_form', multipart: @form['form']['multipart'], window_close: params[:window_close] ) do %>
+    <%= render partial: 'form' %>
+  <% end %>
+</div>
+
+<div id="popup" style="display: none;"></div>

data/app/views/agile/error.html.erb

@@ -0,0 +1,2 @@
+
+<div class="ar-form-error"><%= error %></div>

data/app/views/agile/index.html.erb

@@ -0,0 +1,14 @@
+<% agile_update_form %>
+
+<div <%= agile_form_id %> class="ar-form-frame">
+  <%= agile_title_for_index @records %>
+
+  <%= agile_actions_for_index %>
+  <%= agile_div_filter %>
+  <%= agile_flash_messages %>
+  <div id="result"> <%= render partial: 'result' %></div>
+</div>
+
+<%= javascript_tag(@js) unless @js.blank? %>
+<% unless @css.blank? %><style><%= @css %></style><% end %>
+<div id="popup" style="display: none;"></div>

data/app/views/agile/login.html.erb

@@ -0,0 +1,19 @@
+<% if session[:edit_mode]&.to_i > 0 %>
+  <%= render partial: 'edit_stuff' %>
+<% else %>
+  <div id="ar-login">
+    <h2><%= t('agile.login') %></h2>
+    <%= agile_flash_messages %>
+    <%= form_tag controller: 'agile_common', action: 'process_login', return_to: '/', method: :put do %>
+      <div class="label"><%= t('agile.username') %></div>
+      <div class="input"><%= text_field('record', 'username') %></div>
+
+      <div class="label"><%= t('agile.password') %></div>
+      <div class="input"><%= password_field('record', 'password') %></div>
+      
+      <div class="label"></div>
+      <div class="input"><%= submit_tag t('agile.login'), class: 'ar-submit' %></div>
+      <%= hidden_field_tag('return_to_error', request.url ) %>
+    <% end %>
+  </div>
+<% end %>

data/app/views/agile/new.html.erb

@@ -0,0 +1,12 @@
+<% agile_update_form %>
+
+<div <%= agile_form_id %>>
+  <%= agile_dialog_title agile_new_title %>
+
+  <%= form_tag(@form_params, method: :post, id: AgileHelper.form_param(params) || AgileHelper.table_param(params),
+               class: 'agile_form', multipart: @form['form']['multipart']) do %>
+    <%= render partial: 'form' %>
+  <% end %>
+</div>
+
+<div id="popup" style="display: none;"></div>

data/app/views/agile_common/_help.html.erb

@@ -0,0 +1,18 @@
+
+<div class="ar-help"><a id="help-top"></a>
+  <h1><%= t('agile.ar_help.help') %>: <%= agile_form_title %></h1>
+  <div class="help-buttons">
+    <% if params[:type] == 'form' %>
+      <button onclick="location.href='#fields'; return false;"><%= t('agile.ar_help.fields_button') %></button>
+    <% end %>
+    <% if @commnets %>
+      <button onclick="location.href='#comments'; return false;"><%= t('agile.ar_help.comments_button') %></button>
+    <% end %>
+    <div class="close"><%= mi_icon('close', class: 'ar-link') %></div>
+  </div>
+
+  <div class="help-body"><%= agile_help_body if @help %></div>
+  <div class="help-fields"><%= agile_help_fields if params[:type] == 'form' %></div>
+
+  <div class="help-top" onclick="location.href='#help-top'; return false;"><%= mi_icon('arrow-up') %></div>
+</div>

data/app/views/agile_common/_iframe_edit.html.erb

@@ -0,0 +1,2 @@
+
+<%= iframe_edit1() %>

data/app/views/agile_common/paste_clipboard.html.erb

@@ -0,0 +1,17 @@
+
+<%= agile_dialog_title t('agile.paste_title') %>
+
+<div class="ar-form-frame"><br>
+  <span class="ar-link-ajax" data-request="post" title="<%= t('agile.paste_clipboard') %>"
+        data-url="<%= url_for(controller: 'agile', action: 'paste_clipboard') %>"><%= t('agile.paste_clipboard') %>
+  </span>
+  
+  <hr><br>
+  <div id="result"></div>
+  <%= form_tag do %>
+    <label><b><%= t('agile.paste_update') %>:</b></label><%= check_box('', 'do_update') %><br><br>
+
+    <label><b>Data:</b></label><br>
+  <%= text_area('', 'data',{size: '150x40'}) %><br>
+  <% end %>
+</div>

data/app/views/layouts/agile.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title><%= @page_title %></title>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+  <%= stylesheet_link_tag "application", media: 'all' %>
+  <%= javascript_include_tag "application" %>
+  <%= csrf_meta_tags %>
+</head>
+
+<body id="body-cms">
+<%= yield %>
+</body>
+
+</html>

data/app/views/layouts/content.html.erb

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title><%= @page_title %></title>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <%= @site&.header&.html_safe %>
+
+  <%= stylesheet_link_tag "application", media: 'all' %>
+  <style media="all"><%= "#{@site&.css}#{@design&.css}\n#{@page&.css}".html_safe %></style>
+
+  <%= javascript_include_tag "application" %>
+  <%= csrf_meta_tags %>
+</head>
+
+<body>
+<%= yield %>
+</body>
+
+</html>

data/app/views/models/dump_models.html.erb

@@ -0,0 +1,47 @@
+<style>
+.hidden {display: none;}
+.model { font-size: 1.2em; width: 952px;}
+.model .col1 {padding: 3px; width: 150px; background-color: #ddd; float: left;}
+.model .col2 {padding: 3px; width: 790px; background-color: #eee; float: left;}
+.fields { 
+font-size: 1.1em; width: 952px; color: #669; 
+background-color: #f8f8f8; border: 1px solid #ddd;margin: 2px;
+}
+/*.fields {background-color: #f8f8f8;}*/
+.fields .col1 {background-color: #ddd;  float: left; font-weight: bold; width: 150px;padding:2px;}
+.fields .col2 {padding: 4px; width: 150px;  float: left;}
+.fields .col3 {width: 150px;  float: left;}
+.fields .col4 {width: 600px;  float: left;}
+</style>
+
+<% for description in descriptions; collection = description.first; fields = description.last %>
+<div class="model">
+  <div class="col1" data-model="<%= collection['id'] %>" > <%= collection['id'] %></div>
+  <div class="col2" data-model="<%= collection['id'] %>" > <%= collection['description'] %></div>
+  <div style="clear:both;"></div>
+</div>
+
+<div id="<%= collection['id'] %>" class="fields hidden">
+  <div class="col1">Field name</div>
+  <div class="col1">Field type</div>
+  <div class="col1">Description</div>
+  <div style="clear:both;"></div>
+  <div style="clear:both;"></div>
+  <% for field in fields %>
+    <div class="col2"><%= field['field'] %></div>
+    <div class="col3"><%= field['type'] %></div>
+    <div class="col4"><%= field['description'] %></div>
+    <div style="clear:both;"></div>
+  <% end %>
+</div>
+
+<% end %>
+
+<%= javascript_tag do %>
+$(document).ready( function() {
+  $('.model').on('click',function(e) {
+    div_id = e.target.getAttribute("data-model");
+    $('#'+div_id).toggleClass('hidden');
+  });
+});
+<% end %>

data/config/initializers/kaminari_patch.rb

@@ -0,0 +1,56 @@
+#--
+# Copyright (c) 2023+ 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.
+#++
+
+###########################################################################
+# This patch adds page param to url when page one is choosed. This is needed
+# for paging to work as expected.
+# 
+# Since Kaminari 1.0 functionality can be set by Kaminari.configure.
+###########################################################################
+
+begin
+# Kaminari >= 1.0
+Kaminari.configure do |config|
+  # config.default_per_page = 25
+  # config.max_per_page = nil
+  # config.window = 4
+  # config.outer_window = 0
+  # config.left = 0
+  # config.right = 0
+  # config.page_method_name = :page
+  # config.param_name = :page
+  config.params_on_first_page = true
+end 
+# Kaminari = 0.17
+rescue Exception => e
+  module Kaminari #:nodoc:
+    module Helpers #:nodoc:
+      class Tag #:nodoc:
+        def page_url_for(page)
+          @template.url_for @params.merge(@param_name => (page < 1 ? 1 : page))
+        end
+      end
+    end
+  end
+  
+end