administrate-field-jsonb 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 74b6d21a2f93c23b057e873aaad220655c3c817d
-  data.tar.gz: 606946be845f50d6b98b5553c5148c812ddad650
+  metadata.gz: d7434f7a732965280d6da5120b27bbdb159387f6
+  data.tar.gz: 75a9f459a5f3f84c115986436ca8b8b84a14dc3a
 SHA512:
-  metadata.gz: 3eba72e6e53ec34666eb55b23884d9a9f41f41ed112e82fbb06e16c3d1e6c8083474d476e11b4800b2ed10e09b10788d61724b277178cce6b03837ecadc7fdbf
-  data.tar.gz: 22faae00b2abff4c56d1a4e538ddb4a7213c0d83831e2a2987bf0c4ecc7dce6ac79243b6768131d1a88b76113f462cbd9b2ad79042e7c1a39770c3a9a4305826
+  metadata.gz: ae8a41eac399b3d9a60c4e852688ac481c8a78a79b7117e35e339dcc687f9aaca05a9c2ec9e514838a970b169d7397bc026442ea865c1127ebc6bc7d5a5d73b0
+  data.tar.gz: 94e48d3d6dcf04e7b409cfe8381500f45c8525af0f37aa703df4567011d0916697a30c3ff27284b59e3dbd0459ae8180b48051e5180f86489f3f5cc671a14152

data/.gitignore

@@ -1,3 +1,9 @@
+!.keep
+*.DS_Store
+*.swo
+*.swp
+/.bundle
+/.env
 /.bundle/
 /.yardoc
 /_yardoc/
@@ -6,6 +12,6 @@
 /pkg/
 /spec/reports/
 /tmp/
-
-# rspec failure tracking
+/.idea
+.byebug_history
 .rspec_status

data/README.md

@@ -1,8 +1,8 @@
 # Administrate::Field::Jsonb
 
-A plugin to show and edit JSON objects within [Administrate](https://github.com/thoughtbot/administrate). inspired by [Administrate::Field::JSON](https://github.com/eddietejeda/administrate-field-json)
+A plugin to show and edit JSON objects within [Administrate](https://github.com/thoughtbot/administrate). inspired by [Administrate::Field::JSON](https://github.com/eddietejeda/administrate-field-json).
 
-This gem uses [jsoneditor](https://github.com/josdejong/jsoneditor)
+This gem uses [jsoneditor](https://github.com/josdejong/jsoneditor).
 
 ## Installation
 
@@ -23,7 +23,7 @@ bundle
 ```ruby
 ATTRIBUTE_TYPES = {
   # ...
-  data: Field::JSONB
+  details: Field::JSONB
 }.freeze
 ```
 
@@ -32,12 +32,34 @@ If you have some kind of serialization, you can call methods on your object with
 ```ruby
 ATTRIBUTE_TYPES = {
   # ...
-  data: Field::JSONB.with_options(
-    transform: %w[to_h]
+  details: Field::JSONB.with_options(
+    transform: %w[to_h symbolize_keys]
   )
 }.freeze
 ```
 
+If you want to edit json displaying on `show` page, you can use `advanced_view` option (both JSON and arrays are supported).
+
+```ruby
+ATTRIBUTE_TYPES = {
+  # ...
+  details: Field::JSONB.with_options(transform: %i[to_h symbolize_keys], advanced_view: {
+    company:  Field::String,
+    position: Field::String,
+    skills: Field::JSONB.with_options(advanced_view: {
+      'name'  => Field::String,
+      'years' => Field::Number.with_options(suffix: ' years')
+    })
+  }),
+  languages: Field::JSONB.with_options(advanced_view: {
+    'title' => Field::String,
+    'code'  => Field::String,
+  })
+}.freeze
+```
+
+NOTE: don't define `advanced_view` option if you want to display you JSON with the [jsoneditor](https://github.com/josdejong/jsoneditor).
+
 ## How it looks like
 
 ### Form
@@ -48,16 +70,65 @@ ATTRIBUTE_TYPES = {
 
 ### Show
 
+#### jsoneditor mode
+
 <p align="center">
- <img src="docs/images/show.png">
+ <img src="docs/images/show_jsoneditor.png">
 </p>
 
-### Index
+#### advanced_view mode
 
 <p align="center">
- <img src="docs/images/index.png">
+ <img src="docs/images/advanced_view_full.png">
 </p>
 
+#### advanced_view object
+
+<p align="center">
+ <img src="docs/images/advanced_view_object.png">
+</p>
+
+#### advanced_view array
+
+<p align="center">
+ <img src="docs/images/advanced_view_array.png">
+</p>
+
+## Recipes
+
+If you want to store your JSON in hash format and not a string add this to your model.
+
+```ruby
+def your_field_name=(value)
+  self[:your_field_name] = value.is_a?(String) ? JSON.parse(value) : value
+end
+```
+
+Example:
+
+```ruby
+def details=(value)
+  self[:details] = value.is_a?(String) ? JSON.parse(value) : value
+end
+```
+
+<hr>
+
+If you don't see details in `advanced_view`, try to add this
+
+```ruby
+transform: %i[to_h symbolize_keys]
+```
+
+or use string keys.
+
+```ruby
+languages: Field::JSONB.with_options(advanced_view: {
+  'title' => Field::String,
+  'code'  => Field::String,
+})
+```
+
 ## License
 
 Copyright © 2015-2019 Codica. It is released under the [MIT License](https://opensource.org/licenses/MIT).

data/administrate-field-jsonb.gemspec

@@ -2,7 +2,7 @@ $LOAD_PATH.push File.expand_path('lib', __dir__)
 
 Gem::Specification.new do |gem|
   gem.name = 'administrate-field-jsonb'
-  gem.version = '0.1.0'
+  gem.version = '0.2.0'
   gem.authors = ['Sergey Volkov', 'Codica']
   gem.email = ['sergvolkov.codica@gmail.com']
   gem.homepage = 'https://github.com/codica2/administrate-field-jsonb'

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

@@ -11,4 +11,4 @@
 // GO AFTER THE REQUIRES BELOW.
 //
 //= require jsoneditor-minimalist.min
-//= require_tree .
+//= require_tree .

data/app/assets/javascripts/administrate-field-jsonb/components/accordion.js

@@ -0,0 +1,7 @@
+$(function () {
+  $(".administrate-field-jsonb-accordion").each(function () {
+    $(this).click(function() {
+      $(this).toggleClass("administrate-field-jsonb-active").next().toggle();
+    });
+  });
+});

data/app/assets/javascripts/administrate-field-jsonb/components/editor.js

@@ -29,4 +29,4 @@ $(function () {
 
     editor.set(JSON.parse($current.val()));
   });
-});
+});

data/app/assets/javascripts/administrate-field-jsonb/components/viewer.js

@@ -17,4 +17,4 @@ $(function () {
 
     viewer.set(JSON.parse($current.val()));
   });
-});
+});

data/app/assets/stylesheets/administrate-field-jsonb/accordion.css

@@ -0,0 +1,36 @@
+.administrate-field-jsonb-accordion {
+  --margin: calc(15% - .5rem);
+  background-color: #eee;
+  color: #444;
+  cursor: pointer;
+  padding: 18px;
+  width: calc(100% - var(--margin));
+  text-align: left;
+  border: none;
+  outline: none;
+  transition: 0.4s;
+  margin-left: calc(var(--margin));
+}
+
+.administrate-field-jsonb-active, .administrate-field-jsonb-accordion:hover {
+  background-color: #ccc;
+}
+
+.administrate-field-jsonb-panel {
+  padding: 0 18px;
+  background-color: white;
+  display: none;
+  overflow: hidden;
+}
+
+.administrate-field-jsonb-accordion:after {
+  content: '\02795'; /* Unicode character for "plus" sign (+) */
+  font-size: 13px;
+  color: #777;
+  float: right;
+  margin-left: 5px;
+}
+
+.administrate-field-jsonb-active:after {
+  content: "\2796"; /* Unicode character for "minus" sign (-) */
+}

data/app/assets/stylesheets/administrate-field-jsonb/application.css

@@ -2,4 +2,4 @@
 *= require_self
 *= require jsoneditor.min
 *= require_tree .
-*/
+*/

data/app/assets/stylesheets/administrate-field-jsonb/editor.css

@@ -21,4 +21,4 @@ textarea.jsoneditor-text {
 
 table.jsoneditor-values tbody > tr {
   border: none;
-}
+}

data/app/views/fields/jsonb/_array.html.erb

@@ -0,0 +1,8 @@
+<% data.each.with_index(1) do |d, index| %>
+  <dt class='attribute-label administrate-field-jsonb-accordion'><%= "#{field.attribute.to_s.singularize.titleize} - #{index}" %></dt>
+  <dd class='administrate-field-jsonb-panel'>
+    <dl>
+      <%= render field.to_partial_path('hash'), field: field, structure: structure, data: d %>
+    <dl>
+  </dd>
+<% end %>

data/app/views/fields/jsonb/_field.html.erb

@@ -0,0 +1,9 @@
+<% field = type.new(key, value, :show) %>
+<dt class='attribute-label'><%= t(
+    "helpers.label.#{resource_name}.#{key}",
+    default: key.to_s.titleize,
+  ) %>
+</dt>
+<dd class='attribute-data'>
+  <%= render_field field, page: :show %>
+</dd>

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

@@ -1,13 +1,7 @@
-
-<%#
-  # JSONB Form Partial
-  This partial renders an JSON database into structured form
-%>
-
 <div class="field-unit__label">
   <%= f.label field.attribute %>
 </div>
 
 <div class="field-unit__field administrate-jsoneditor">
-  <%= f.text_area field.attribute, value: field.data.to_json.html_safe.squish %>
+  <%= f.text_area field.attribute, value: field.transform.to_json.html_safe.squish %>
 </div>

data/app/views/fields/jsonb/_hash.html.erb

@@ -0,0 +1,12 @@
+<% structure.each do |sk, sv| %>
+  <% if sv.is_a?(Hash) %>
+    <dt class='attribute-label administrate-field-jsonb-accordion'><%= sk.to_s.titleize %></dt>
+    <dd class='administrate-field-jsonb-panel'>
+      <dl>
+        <%= render field.to_partial_path('hash'), field: field, structure: structure[sk], data: data[sk] %>
+      <dl>
+    </dd>
+  <% else %>
+    <%= render field.to_partial_path('field'), type: sv, key: sk, value: data[sk] %>
+  <% end %>
+<% end %>

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

@@ -1 +1 @@
-<%= JSON.pretty_generate field.transform %>
+<%= JSON.pretty_generate field.transform %>

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

@@ -1,3 +1,16 @@
-<div class="administrate-jsoneditor-viewer">
-  <%= text_area_tag field.attribute, field.transform.to_json.html_safe.squish %>
-</div>
+<% if field.advanced_view? %>
+  <% if field.array? %>
+    <%= render field.to_partial_path('array'), field: field, structure: field.advanced_view, data: field.transform %>
+  <% else %>
+    <dt class='attribute-label administrate-field-jsonb-accordion'><%= field.attribute.to_s.titleize %></dt>
+    <dd class='administrate-field-jsonb-panel'>
+      <dl>
+         <%= render field.to_partial_path('hash'), field: field, structure: field.advanced_view, data: field.transform %>
+      <dl>
+    </dd>
+  <% end %>
+<% else %>
+  <div class='administrate-jsoneditor-viewer'>
+    <p><%= text_area_tag field.attribute, field.transform.to_json.html_safe.squish %></p>
+  </div>
+<% end %>

data/lib/administrate/field/jsonb.rb

@@ -13,11 +13,27 @@ module Administrate
 
         result = data
         options[:transform].each do |method|
-          result = data.public_send(method)
+          result = result.is_a?(Array) ? result.map(&method) : result.public_send(method)
         end
         result
       end
 
+      def array?
+        transform.is_a?(Array)
+      end
+
+      def advanced_view?
+        advanced_view.present? && advanced_view.is_a?(Hash)
+      end
+
+      def advanced_view
+        options[:advanced_view]
+      end
+
+      def to_partial_path(partial = page)
+        "/fields/jsonb/#{partial}"
+      end
+
       class Engine < ::Rails::Engine
 
         Administrate::Engine.add_javascript 'administrate-field-jsonb/application'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: administrate-field-jsonb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Sergey Volkov
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-09-27 00:00:00.000000000 Z
+date: 2019-10-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: administrate
@@ -73,18 +73,24 @@ files:
 - README.md
 - administrate-field-jsonb.gemspec
 - app/assets/javascripts/administrate-field-jsonb/application.js
+- app/assets/javascripts/administrate-field-jsonb/components/accordion.js
 - app/assets/javascripts/administrate-field-jsonb/components/editor.js
 - app/assets/javascripts/administrate-field-jsonb/components/viewer.js
+- app/assets/stylesheets/administrate-field-jsonb/accordion.css
 - app/assets/stylesheets/administrate-field-jsonb/application.css
 - app/assets/stylesheets/administrate-field-jsonb/editor.css
+- app/views/fields/jsonb/_array.html.erb
+- app/views/fields/jsonb/_field.html.erb
 - app/views/fields/jsonb/_form.html.erb
+- app/views/fields/jsonb/_hash.html.erb
 - app/views/fields/jsonb/_index.html.erb
 - app/views/fields/jsonb/_show.html.erb
+- docs/images/advanced_view_array.png
+- docs/images/advanced_view_full.png
+- docs/images/advanced_view_object.png
 - docs/images/form.png
-- docs/images/index.png
-- docs/images/show.png
+- docs/images/show_jsoneditor.png
 - lib/administrate/field/jsonb.rb
-- vendor/assets/.DS_Store
 - vendor/assets/images/jsoneditor-icons.svg
 - vendor/assets/javascripts/jsoneditor-minimalist.min.js
 - vendor/assets/stylesheets/jsoneditor.min.css