action_links 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in action_links.gemspec
+gemspec

data/README.rdoc

@@ -0,0 +1,45 @@
+== Action_Links
+
+Action_Links automatically includes action links (show, edit, destroy) based on the current page and user roles/permissions.
+
+
+== Installation
+
+Action_Links has been tested through Rails 3.0.10.
+
+Add the following to your Gemfile
+ 
+  gem "action_links"
+  
+From the command line
+
+  > bundle install
+  
+
+Appdoc uses {declarative_autorization}[https://github.com/stffn/declarative_authorization] for role based permissions. Otherwise you will have to manually implement the method 
+
+  permitted_to? :show, @user
+
+
+== Usage
+
+* Basic Usage
+
+    =action_links @user
+
+* Include actions
+  
+    =action_links @user, :include => [:download]
+  
+* Exclude actions
+
+    =action_links @user, :exclude => [:edit, :destroy]
+
+* Pass in block
+
+    =action_links @user do
+      =link_to "Hello World", dashboard_path
+    
+* Namespaced objects
+
+    =action_links [:manage, @product]

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/action_links.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "action_links/version"
+
+Gem::Specification.new do |s|
+  s.name        = "action_links"
+  s.version     = ActionLinks::VERSION
+  s.authors     = ["Adam Crownoble", "Ryan Hall"]
+  s.email       = ["adam@obledesign.com"]
+  s.homepage    = "https://github.com/halloffame/action_links"
+  s.summary     = %q{Quick and painless action links}
+  s.description = %q{Automatically includes action links (show, edit, destroy) based on the current page and user roles/permissions}
+
+  s.rubyforge_project = "action_links"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/action_links.rb

@@ -0,0 +1,78 @@
+require "action_links/version"
+
+module ActionLinks
+  require 'action_links/engine' if defined?(Rails)
+  
+  # for easy configuration
+  def self.config
+    yield self
+  end
+  
+  
+  # A helper that renders the action links. 
+  # Automatically renders :show, :edit, and :destroy if user has permissions to those actions
+  #
+  #   <%= action_links @articles %>
+  #
+  def action_links(object_or_array, options={}, &block)
+    implicit_route_actions = [:show, :destroy]
+  
+    # TODO: move default actions into a config file
+    defaults = {
+      :actions => [:show, :edit, :destroy],
+      :include => [],
+      :exclude => [],
+      :controller_name => nil,
+      :remote => [],
+      :list_wrapper => :ul,
+      :list_wrapper_class => :actions,
+      :link_wrapper => :li,
+      :link_wrapper_class => nil
+    }
+    
+    options.reverse_merge! defaults
+    options.each { |key,val| options[key] = Array(val) if defaults[key].is_a? Array }
+    actions = (options[:actions] - options[:exclude]) + options[:include]
+    links = []
+    
+    object_array = Array(object_or_array)
+    object = object_array.last
+    object_name = object.class.model_name.human
+    namespaces = object_array.select{ |obj| obj.is_a? Symbol }
+    options[:controller_name] ||= [*namespaces, object.class.model_name.plural].compact.join('/')
+    controller = "#{options[:controller_name]}_controller".classify.constantize.new
+
+    links = actions.map do |action|
+      permission_passed = false
+      if respond_to? :permitted_to?
+        permission_passed = permitted_to?(action, object)
+      else
+        permission_passed = true
+      end
+      if controller.respond_to?(action) && permission_passed
+        url_array = implicit_route_actions.include?(action) ? object_array : [action, *object_array]
+        unless current_page?(url_array) && action != :destroy
+          title = I18n.t(action, :scope=>'action_links', :default=>action.to_s.humanize)
+          html_options = { :class=>action.to_s.parameterize, :title=>"#{title} #{object_name}" }
+          html_options[:remote] = true if options[:remote].include? action
+          
+          if action == :destroy
+            html_options.merge! :method=>:delete, :confirm=>I18n.t(:confirm_delete, :scope=>'action_links', :default=>'Are you sure?')
+          end
+          
+          link_to(title, url_array, html_options)
+        end
+      end
+    end
+
+    links << capture(&block) if block_given?
+
+    return content_tag(options[:list_wrapper], :class=>:actions) do
+      links.compact.map { |link|
+        content_tag(options[:link_wrapper], link, :class=>options[:link_wrapper_class])
+      }.join("\n").html_safe
+    end
+  end
+  
+  ActionView::Base.send :include, ActionLinks
+end

data/lib/action_links/engine.rb

@@ -0,0 +1,7 @@
+require 'action_links'
+require 'rails'
+
+module ActionLinks
+  class Engine < Rails::Engine
+  end
+end

data/lib/action_links/version.rb

@@ -0,0 +1,3 @@
+module ActionLinks
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: action_links
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Adam Crownoble
+- Ryan Hall
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-27 00:00:00.000000000Z
+dependencies: []
+description: Automatically includes action links (show, edit, destroy) based on the
+  current page and user roles/permissions
+email:
+- adam@obledesign.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.rdoc
+- Rakefile
+- action_links.gemspec
+- lib/action_links.rb
+- lib/action_links/engine.rb
+- lib/action_links/version.rb
+homepage: https://github.com/halloffame/action_links
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: action_links
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Quick and painless action links
+test_files: []