administrate-field-nested_has_many 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b2336e14b58c19c34cd27e3d18f6a64da56f97e0
+  data.tar.gz: 6638b8ec69dd50bb7bb4c0d0fb1987f314d4d790
+SHA512:
+  metadata.gz: d100590240ed07f092bf2a7d0345fb14a4cf22be1474007e48dd23e680567dc9cd32c72e1d06cfd0cfe4cc23f6f27b5b5813af55c44898133e2412c6fbbff4fe
+  data.tar.gz: 39f13eef2ef5f7017981e7d4bf9dbd0c0b4bd3296cb6d3146e23cc0cdc1bf04538c317c66708b63c8575c61b4a30aa0927f478e77afe921acf2344c17bfe174a

data/README.md

@@ -0,0 +1,37 @@
+# Administrate::Field::NestedHasMany
+
+A plugin for nested has_many forms in [Administrate].
+
+## Usage
+
+Add to your `Gemfile`:
+
+```ruby
+gem "administrate-field-nested_has_many"
+```
+
+Run:
+
+```bash
+$bundle install
+```
+
+Add to your `FooDashboard`:
+```ruby
+ATTRIBUTE_TYPES = [
+  bars: Field::NestedHasMany.with_options(skip: :foo),
+]
+```
+
+The `skip` option takes a single symbol or list of symbols.
+It will prevent the nested form from displaying the fields for those attributes.
+
+If a `Customer` `has_many :orders`,
+and you want to render `orders` as a nested form on the customer edit page,
+then it is generally necessary to add `skip: :customer` to the options
+for the `NestedHasMany` field.
+Otherwise, Administrate will try to render a field
+for the order's `:customer` attribute,
+which breaks the nested form logic.
+
+[Administrate]: https://github.com/thoughtbot/administrate

data/administrate-field-nested_has_many.gemspec

@@ -0,0 +1,22 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+require "administrate/field/nested_has_many"
+
+Gem::Specification.new do |gem|
+  gem.name = "administrate-field-nested_has_many"
+  gem.version = Administrate::Field::NestedHasMany::VERSION
+  gem.authors = ["Grayson Wright"]
+  gem.email = ["wright.grayson@gmail.com"]
+  gem.homepage = "https://github.com/graysonwright/administrate-field-nested_has_many"
+  gem.summary = "Plugin for nested has_many forms in Administrate"
+  gem.description = gem.summary
+  gem.license = "MIT"
+
+  gem.require_paths = ["lib"]
+  gem.files = `git ls-files`.split("\n")
+  gem.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+
+  gem.add_dependency "administrate", "~> 0.2.0"
+  gem.add_dependency "cocoon", "~> 1.2"
+  gem.add_dependency "rails", "~> 4.2"
+end

data/app/assets/javascripts/administrate-field-nested_has_many/application.js

@@ -0,0 +1 @@
+//= require cocoon

data/app/views/fields/nested_has_many/_fields.html.erb

@@ -0,0 +1,11 @@
+<div class="nested-fields" style="width:100%">
+
+  <% field.nested_fields.each do |attribute| -%>
+    <div class="field-unit field-unit--<%= attribute.html_class %>">
+      <%= render_field attribute, f: f %>
+    </div>
+  <% end -%>
+
+  <%# TODO I18n %>
+  <%= link_to_remove_association "Remove #{field.associated_class_name.titleize}", f %>
+</div>

data/app/views/fields/nested_has_many/_form.html.erb

@@ -0,0 +1,23 @@
+<div class="nested-fields" style="width: 40%; margin-left: 20%;">
+
+  <%= f.fields_for field.association_name do |nested_form| %>
+    <%= render(
+      partial: "fields/nested_has_many/fields",
+      locals: {
+        f: nested_form,
+        field: field,
+      },
+    ) %>
+  <% end %>
+
+  <div>
+    <%= link_to_add_association(
+      # TODO I18n
+      "Add #{field.associated_class_name.titleize}",
+      f,
+      field.association_name,
+      partial: "fields/nested_has_many/fields",
+      render_options: { locals: { field: field } },
+    ) %>
+  </div>
+</div>

data/app/views/fields/nested_has_many/_index.html.erb

@@ -0,0 +1,19 @@
+<%#
+# HasMany Index Partial
+
+This partial renders a has_many relationship,
+to be displayed on a resource's index page.
+
+By default, the relationship is rendered
+as a count of how many objects are associated through the relationship.
+
+## Local variables:
+
+- `field`:
+  An instance of [Administrate::Field::HasMany][1].
+  A wrapper around the has_many relationship pulled from the database.
+
+[1]: http://www.rubydoc.info/gems/administrate/Administrate/Field/HasMany
+%>
+
+<%= pluralize(field.data.size, field.attribute.to_s.humanize.downcase) %>

data/app/views/fields/nested_has_many/_show.html.erb

@@ -0,0 +1,40 @@
+<%#
+# HasMany Show Partial
+
+This partial renders a has_many relationship,
+to be displayed on a resource's show page.
+
+By default, the relationship is rendered
+as a table of the first few associated resources.
+The columns of the table are taken
+from the associated resource class's dashboard.
+
+## Local variables:
+
+- `field`:
+  An instance of [Administrate::Field::HasMany][1].
+  Contains methods to help display a table of associated resources.
+
+[1]: http://www.rubydoc.info/gems/administrate/Administrate/Field/HasMany
+%>
+
+<% if field.resources.any? %>
+  <%= render(
+    "collection",
+    collection_presenter: field.associated_collection,
+    resources: field.resources
+  ) %>
+
+  <% if field.more_than_limit? %>
+    <span>
+      <%= t(
+        'administrate.fields.has_many.more',
+        count: field.limit,
+        total_count: field.data.count,
+      ) %>
+    </span>
+  <% end %>
+
+<% else %>
+  <%= t("administrate.fields.has_many.none") %>
+<% end %>

data/lib/administrate/field/nested_has_many.rb

@@ -0,0 +1,60 @@
+require "administrate/field/has_many"
+require "administrate/page/form"
+require "rails"
+
+module Administrate
+  module Field
+    class NestedHasMany < Administrate::Field::HasMany
+      VERSION = "0.0.1"
+
+      class Engine < ::Rails::Engine
+      end
+
+      DEFAULT_ATTRIBUTES = [:id, :_destroy].freeze
+
+      def nested_fields
+        associated_form.attributes.reject do |nested_field|
+          skipped_fields.include?(nested_field.attribute)
+        end
+      end
+
+      def to_s
+        data
+      end
+
+      def self.dashboard_for_resource(resource)
+        "#{resource.to_s.classify}Dashboard".constantize
+      end
+
+      def self.associated_attributes(associated_resource)
+        DEFAULT_ATTRIBUTES +
+          dashboard_for_resource(associated_resource).new.permitted_attributes
+      end
+
+      def self.permitted_attribute(associated_resource)
+        {
+          "#{associated_resource}_attributes".to_sym =>
+          associated_attributes(associated_resource),
+        }
+      end
+
+      def associated_class_name
+        options.fetch(:class_name, attribute.to_s.singularize.camelcase)
+      end
+
+      def association_name
+        associated_class_name.underscore.pluralize
+      end
+
+      def associated_form
+        Administrate::Page::Form.new(associated_dashboard, association_name)
+      end
+
+      private
+
+      def skipped_fields
+        Array(options[:skip])
+      end
+    end
+  end
+end

data/spec/lib/administrate/field/nested_has_many_spec.rb

@@ -0,0 +1,14 @@
+require "administrate/field/nested_has_many"
+
+describe Administrate::Field::NestedHasMany do
+  describe "#to_partial_path" do
+    it "returns a partial based on the page being rendered" do
+      page = :show
+      field = Administrate::Field::NestedHasMany.new(:relation, "/a.jpg", page)
+
+      path = field.to_partial_path
+
+      expect(path).to eq("/fields/nested_has_many/#{page}")
+    end
+  end
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: administrate-field-nested_has_many
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Grayson Wright
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-04-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: administrate
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: cocoon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+description: Plugin for nested has_many forms in Administrate
+email:
+- wright.grayson@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- administrate-field-nested_has_many.gemspec
+- app/assets/javascripts/administrate-field-nested_has_many/application.js
+- app/views/fields/nested_has_many/_fields.html.erb
+- app/views/fields/nested_has_many/_form.html.erb
+- app/views/fields/nested_has_many/_index.html.erb
+- app/views/fields/nested_has_many/_show.html.erb
+- lib/administrate/field/nested_has_many.rb
+- spec/lib/administrate/field/nested_has_many_spec.rb
+homepage: https://github.com/graysonwright/administrate-field-nested_has_many
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Plugin for nested has_many forms in Administrate
+test_files:
+- spec/lib/administrate/field/nested_has_many_spec.rb