ioquatix-html_helpers 0.1.0

data/README

@@ -0,0 +1,93 @@
+Copyright (c) 2008 Samuel Williams.
+Development proudly sponsored by Orion Transfer Ltd.
+http://www.oriontransfer.co.nz/
+
+===== HTML Helpers ====
+
+As the name implies, HTML Helpers is a library of helper methods for producing nice HTML.
+
+It is still very basic, but provides three things:
+
+==== Tabular Form Builder ====
+
+The tabular form builder creates a <table> for forms. It's fairly easy to use.
+
+Typically, one creates a form partial
+
+  * users/_form.rhtml
+<code>
+<% f.fieldset do %>
+	<%= f.error_messages %>
+	<%= f.text_field :login %>
+	<%= f.text_field :email %>
+	
+	<%= f.text_field :password %>
+	
+	<%= f.check_box :verified %>
+	<%= f.check_box :deleted %>
+	
+	<%= f.submit %>
+<% end %>
+</code>
+
+  * users/new.rhtml
+<code>
+<h1>New User</h1>
+
+<% table_form_for :user, :url => {:action => :create} do |f| %>
+	<%= f.render_form %>
+<% end %>
+</code>
+
+==== Icon Tag ====
+
+This helper basically is a substitute for image_tag with a very specific purpose: putting icons on the page.
+
+Most people should be familiar with icon sets such as http://www.famfamfam.com/. It is often useful to specify icons
+in a generic way, especially when there are a lot of them.
+
+Icon tag helps to minimize the amount of typing needed to put icons on the page. It also integrates with engines.
+
+For example:
+
+<code>
+	<%= link_if_authorized icon_tag(:edit), edit_user_path(user) %>
+</code>
+
+This searches through a number of different locations. In this case, #{controller} means "users" and #{icon} means :edit. For plugins, it searches:
+
+	- /public/images/#{controller}/#{icon}
+	- /public/plugin_assets/:plugin_name/images/#{controller}/#{icon}
+	- /public/images/default/#{icon}
+	- /public/plugin_assets/:plugin_name/images/default/#{icon}
+
+Icons must be PNG at this time, but this may change in the future.
+
+==== Inside Layout ====
+
+This helper basically allows you to render one layout inside another. For example:
+
+  * layouts/admin.rhtml
+<code>
+<% inside_layout 'application' do %>
+	<h1>Admin Interface</h1>
+	<%= yield %>
+<% end %>
+</code>
+
+===== License =====
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+

data/lib/html_helpers.rb

@@ -0,0 +1,5 @@
+
+require 'html_helpers/tabular_form_builder'
+require 'html_helpers/icons_helper'
+require 'html_helpers/inside_layout'
+require 'html_helpers/form_object'

data/lib/html_helpers/form_object.rb

@@ -0,0 +1,25 @@
+module ApplicationHelper
+  def submit_button(value = "Save changes", url_for_options = {}, options = {}, *parameters_for_url)
+    options.stringify_keys!
+    
+    options["action"]  = url_for(url_for_options, *parameters_for_url) if url_for_options.size != 0
+    
+    if disable_with = options.delete("disable_with")
+      options["onclick"] = "this.disabled=true;this.value='#{disable_with}';this.form.submit();#{options["onclick"]}"
+    end
+    
+    if action = options.delete("action")
+      options["onclick"] = "this.form.action='#{escape_javascript(action)}';#{options['onclick']}"
+    end
+    
+    if method = options.delete("method")
+      options["onclick"] = "this.form.method='#{escape_javascript(method)}';#{options['onclick']}"
+    end
+    
+    if confirm = options.delete("confirm")
+      options["onclick"] = "if (!#{confirm_javascript_function(confirm)}){return false};#{options['onclick']}"
+    end
+      
+    tag :input, { "type" => "submit", "name" => "commit", "value" => value }.update(options.stringify_keys)
+  end
+end

data/lib/html_helpers/icons_helper.rb

@@ -0,0 +1,48 @@
+module IconHelper
+  def self.current_plugin(c = caller)
+    current_file = File.expand_path c[0]
+    Engines.plugins.find do |plugin|
+      current_file.index(File.expand_path(plugin.directory)) == 0
+    end
+  end
+end
+
+module ApplicationHelper
+  
+  DefaultIconCategory = "default"
+  
+  def icon_path(category, icon, root = '')
+    File.join('', root, 'images', category.to_s, icon.to_s + '.png')
+  end
+  
+  def icon_src(category, icon, root = '')
+    paths = []
+    paths << icon_path(category, icon)
+    paths << icon_path(category, icon, root)
+    paths << icon_path(DefaultIconCategory, icon, root)
+    paths << icon_path(DefaultIconCategory, icon)
+    
+    paths.each { |p| $stderr.puts ("Icon Path: " + File.join(RAILS_ROOT, 'public', p)) }
+    return paths.find { |p| File.exist?(File.join(RAILS_ROOT, 'public', p)) }
+  end
+  
+  def icon_tag(icon, options = {})
+    category = options.delete(:controller) || options.delete(:category) || controller.controller_name
+    root = options.delete('root') || ''
+    
+    if defined? Engines.plugins
+      plugin = options.delete(:plugin) || IconHelper::current_plugin(caller)
+      root = File.join("plugin_assets", plugin.name) unless plugin.nil?
+    end
+    
+    css_class = options.delete(:class) || 'icon'
+    
+    src = icon_src(category, icon, root)
+    
+    if src
+      return tag('img', {'class' => css_class, 'src' => src})
+    else
+      return options[:unavailable]
+    end
+  end
+end

data/lib/html_helpers/inside_layout.rb

@@ -0,0 +1,11 @@
+module ApplicationHelper
+  
+  def inside_layout(layout, &block)
+    @template.instance_variable_set("@content_for_layout", capture(&block))
+    
+    layout = layout.include?("/") ? layout : "layouts/#{layout}" if layout
+    buffer = eval("_erbout", block.binding)
+    buffer.concat(@template.render_file(layout, true))
+  end
+  
+end

data/lib/html_helpers/tabular_form_builder.rb

@@ -0,0 +1,123 @@
+# Good
+
+class ActionView::Helpers::FormBuilder
+  def render_form(partial = 'form', args = {})
+    ctr = eval("controller", @proc.binding)
+    ctr.send(:render, :partial => partial, :locals => {:f => self}.merge(args))
+  end
+  
+  ButtonLabels = {'new' => 'Create', 'edit' => 'Update'}
+  
+  def _button_label
+    ctr = eval("controller", @proc.binding)
+    action_name = ctr.action_name
+    return ButtonLabels[action_name] || action_name.camelcase
+  end
+end
+
+#module ApplicationHelper
+
+  class TabularFormBuilder < ActionView::Helpers::FormBuilder
+    ((field_helpers + ["select", "collection_select", "date_select", "time_select", "datetime_select"]) - %w(hidden_field)).each do |selector|
+      src = <<-END_SRC 
+        def #{selector}(*args)
+          generic_form_field(#{selector.dump}, *args) { super(*args) }
+        end
+      END_SRC
+      class_eval src, __FILE__, __LINE__
+    end
+    
+    def comments(text)
+      tr(td('') + td(text))
+    end
+    
+    def submit(text = nil, options = {}, html_options = {})
+      text ||= _button_label
+      generic_field_html(nil, @template.submit_tag(text, html_options), options)
+    end
+    
+    def file_column_field(field, options = {})
+      generic_field(field) { @template.file_column_field(@object_name, field, options) }
+    end
+    
+    def fieldset(new_section_name = nil, &block)
+      s = ("<legend>#{new_section_name}</legend>" if new_section_name) || ""
+      
+      @template.concat("<fieldset>#{s}<table>", block.binding)
+      yield
+      @template.concat("</table></fieldset>", block.binding)
+    end
+    
+    def separator(new_section_name = nil)
+      s = ("<legend>#{new_section_name}</legend>" if new_section_name) || ""
+      
+      @template.concat("</table></fieldset><fieldset>#{s}<table>", block.binding)
+    end
+    
+    def generic_field(field_name, options = {}, &block)
+      field_text = @template.capture(&block)
+      @template.concat(generic_field_html(field_name, field_text, options), block.binding)
+    end
+    
+    protected
+    def generic_field_html(field_name, field_text, options = {})
+      required = options.delete(:required) || false
+      required_text = required ? td('*', :class => 'required_field') : td('')
+      
+      label_text = options.delete(:label) || field_name.to_s.humanize
+      
+      unless label_text.blank?
+        if options[:label] == :after
+          tr(td('') + td(field_text + label(label_text, "#{@object_name}_#{field_name}", true)) + required_text)
+        else
+          tr(
+            td(label(label_text, "#{@object_name}_#{field_name}")) +
+            td(field_text) + required_text
+          ) 
+        end
+      else # No label
+        tr(td(field_text, :colspan => 2, :style => "text-align: right;") + required_text)
+      end
+    end
+
+    protected
+    def generic_form_field(selector, *args, &block)
+      field_name = args[0]
+      field_text = @template.capture(&block)
+      
+      case selector
+        when "check_box": generic_field_html(field_name, field_text, args[1] || {})
+        when "collection_select": generic_field_html(field_name, field_text, args[4] || {})
+        when "country_select": generic_field_html(field_name, field_text, args[2] || {})
+        when "radio_button": generic_field_html(field_name, field_text, args[2] || {})
+        when "select": generic_field_html(field_name, field_text, args[2] || {})
+        when "time_zone_select": generic_field_html(field_name, field_text, args[2] || {})
+        else generic_field_html(field_name, field_text, args[1] || {})
+      end
+    end
+    
+    def tr content, html_options = {}
+      @template.content_tag 'tr', content, html_options
+    end
+    
+    def td content, html_options = {}
+      @template.content_tag 'td', content, html_options
+    end
+    
+    def label text, for_field, after = false
+      @template.content_tag 'label', "#{text}#{after ? '' : ':'}", :for => for_field
+    end
+  end
+
+  def table_form_for(*args, &block)
+    if args.last.is_a? Hash
+      args.last[:builder] = TabularFormBuilder
+    else
+			options = {:builder => TabularFormBuilder}
+			args << options
+		end
+    
+    form_for(*args, &block)
+  end
+
+#end

data/rails/assets/stylesheets/pagination.css

@@ -0,0 +1,54 @@
+
+/*Credits: Dynamic Drive CSS Library */
+/*URL: http://www.dynamicdrive.com/style/ */
+
+.pagination {
+	padding: 2px;
+}
+
+.pagination ul {
+	margin: 0;
+	padding: 0;
+	text-align: left; /*Set to "right" to right align pagination interface*/
+	font-size: 16px;
+}
+
+.pagination li {
+	list-style-type: none;
+	display: inline;
+	padding-bottom: 1px;
+}
+
+.pagination a, .pagination a:visited {
+	padding: 0 5px;
+	border: 1px solid #9aafe5;
+	text-decoration: none; 
+	color: #2e6ab1;
+}
+
+.pagination a:hover, .pagination a:active {
+	border: 1px solid #2b66a5;
+	color: #000;
+	background-color: #ebebeb;
+}
+
+.pagination .currentpage {
+	padding: 0 5px;
+	border: 1px solid #2b66a5;
+	text-decoration: none; 
+	background-color: #2e6ab1;
+	color: #FFF !important;
+	font-weight: bold;
+}
+
+.pagination .disablepage {
+	padding: 0 5px;
+	border: 1px solid #929292;
+	background-color: white;
+	color: #929292;
+	font-weight: ;
+}
+
+.pagination a.prevnext {
+	font-weight: bold;
+}

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: ioquatix-html_helpers
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Samuel Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-24 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ioquatix-engines
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: 
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/html_helpers
+- lib/html_helpers/form_object.rb
+- lib/html_helpers/icons_helper.rb
+- lib/html_helpers/inside_layout.rb
+- lib/html_helpers/tabular_form_builder.rb
+- lib/html_helpers.rb
+- rails/assets
+- rails/assets/stylesheets
+- rails/assets/stylesheets/pagination.css
+- rails/init.rb
+- README
+has_rdoc: false
+homepage: http://wiki.oriontransfer.org/?rails:html_helpers
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: HTML Helpers for Rails. Enhances support for HTML forms, images and layouts.
+test_files: []
+