hot-glue 0.6.30 → 0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7eb77747230d52128ce322520c8c208c5e235cb27cca4042c99a0ce0e910382b
-  data.tar.gz: 9ba630157d1335f28acb15c7342f2d3489e63358ad38fd4d19185162fceb6895
+  metadata.gz: c823d274b52531414bbf843d1f44ccd364400ab9c736405a74b1cc5793774b48
+  data.tar.gz: 52d175d729d5b57c063da43bb7b7cb2940ea334be16e99637ade700ddaa2593a
 SHA512:
-  metadata.gz: 990d8138a2916b7599ea831b8c2d09d70b5df653a0ec8b2f88632eae696c21ecd24406ec1d0b8ea180ffdc2fe1401a2030672d6e7c5695693e2c86d1222a01e5
-  data.tar.gz: c396428e8d84b06fe05483add1a9d89ea7149e303efef49d14cccafe3ce25312440b8620db4a5d79fe0bd9e4876b71e98bbac895a540a24cdd7f1b752afb2711
+  metadata.gz: a1c8b8309b61f0ddbb1f27ca3a73bde4e8349f13fb114c6f3f5dcc15343dcc597fa4fbdd11476c1456d38c772cfe29b61d7ca4bee7d79ad421592227cf305d49
+  data.tar.gz: 9b915be8972458f2fee1163e00c9f6c58a6ddf74ec829da2449989f3a5640597d16efb93c5ede4ea449bc786714997f511d3830a584029ff33222c6cef4d626e

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    hot-glue (0.6.29)
+    hot-glue (0.7)
       ffaker (~> 2.16)
       rails (> 5.1)
 

data/README.md

@@ -655,7 +655,16 @@ If you specify an include list, it will be treated as a whitelist: no fields wil
 
 You may not specify both include and exclude.
 
-Include setting is affected by both specified grouping mode and smart layouts, explained below.
+Many options allow you to specify fields in multiple modes:
+• Standard
+• Smart layout
+• Specified grouping
+
+see "Layout & Manipulation features" for details on how to build your `--include` statement, including how to use `:` and `,` 
+
+Also review Omitted Fields (`-` and `=`), Dynamic Blocks (`**`), Omitted Dynamic Blocks (`**-` and `**=`)
+
+Also see Set Column Widths ( `(` ... `)` ) to set the column widths explicitly in your `--include`
 
 
 ### `--exclude=`
@@ -665,7 +674,6 @@ By default, all fields are included unless they are on the default exclude list.
 
 If you specify any exclude list, those excluded **and** the default exclude list will be excluded. (If you need any of the fields on the default exclude list, you must use `--include` instead.)
 
-
 `./bin/rails generate hot_glue:scaffold Account --exclude=password`
 
 
@@ -1059,10 +1067,72 @@ This is what would happen if 9 fields, specified in the order A,B,C,D,E,F,G,H,I,
 (If you had a number of fields that wasn't easily divisible by the number of columns, it would leave the final column one or a few fields short of the others.)
 
 
-### `--new-button-position` (above, below; default: above)
-Show the new button above or below the list.
 
+### Omitted fields
+
+Note that these additions all affect how you write your `--include` setting, but they operate in addition to all of the field visibility rules above. Notice that omitting a form means we by design omit it on both the new and edit actions. If you want to determine if it shows up on new vs. edit granularly, use a different approach.
+
+Generally, you will only omit a field in special cases. To omit a field, prefix either `-` (omit on list) or `=` to omit on form (new & edit), like so :
+
+`--include=-abd,=dfg`
+
+Here, the abc field will be omitted on the list and the dfg will be omitted on the form (new & edit)
+
+
+This works for any include setting type, whether the grouping mode is specified or not.
+
+`--include=-abd,=dfg`  
+`--include=-abd:=dfg` # same as above but builder will use specified grouping mode
+
+### Dynamic Blocks
+
+Next, you can now dynamically pull any partials from the view folder (of the name of your choosing) into your object's field display- before, between, or after any part of the column groupings using the `:` and `,` characters. (Review specified grouping mode in "Layout & Manipulation Features.")
+
+You simply make up any partial name, treat it as if it is one of the fields in the field list, and prefix it with `**`. (When specified, don't use `_` but remember to use the `_` in the file name.)
+
+It looks like this (let's assume I've made an arbitrary partial called `_jello.erb` in my build folder, which expects to be passed a `thing` local variable)
+
+`rails generate hot_glue:scaffold Thing --include='**jello:name:birthday:gender'`
+
+Here, you'll get four columns:
+
+The first column will pull a partial from the same folder being built. You build this partial, not Hot Glue.
+
+```
+<%= render partial: 'jello', locals: {thing: thing } %>
+```
+
+(Remember, the partial file name begins with `_` but is referenced without the underscore)
 
+Because you separated that first column using `:` from the other three, the partial will take up the whole column.
+The next 3 columns will contain name, birthday & gender, respectively.
+
+If you specify it this way:
+rails generate hot_glue:scaffold Thing --include='**jello,name:birthday:gender'
+
+Notice that between **jello and name is now a comma, putting the jello partial and name into the  same column. Now the partial will be displayed before the name in that column.
+
+You can mix & match any number of partials inserted anywhere into the field layout.
+
+
+### Omitted Dynamic Blocks
+
+Dynamic blocks respond to the new `-` and `=` settings for omitting fields the same way fields do. Prefixing a dynamic partial with `**-` will mean it will be omitted from the list, and `**=` will omit it from the form (new & edit)
+
+This way, the omitted syntax is parallel to the dynamic block structure. No other tye-in is made with the other field visibility settings.
+
+
+### Set Column Widths
+
+In other modes, Hot Glue decides how many bootstrap columns each column should span, defaulting to 2 unless using `--smart-layout`, in which case it ranges from 2 to 5 depending on how many fields you have. Generally, I start my scaffolds using either standard or smart, but soon, I'm often upgrading to specified grouping mode for fine-grained control.
+
+When using specified group mode (activated when a `:` character appears in the `--include` list), you can append to the end of EACH COLUMN (not each field) a parenthetical setting for the number of bootstrap columns.
+
+(When the setting includes this special character, you'll need  `'` to wrap the entire setting for `--include` on the command line.)
+
+
+### `--new-button-position` (above, below; default: above)
+Show the new button above or below the list.
 
 ### `--button-icons` (default is no icons)
 You can specify this either as builder flag or as a config setting (in `config/hot_glue.yml`)
@@ -1075,8 +1145,6 @@ Can also be specified globally in `config/hot_glue.yml`
 
 
 ### `--modify=field1{...},field2{...}`
-
-
 You can apply modification to the viewable (non-edit) display of field using the `--modify` switch.
 
 The syntax is `--modify=cost{$},price{$}`
@@ -1086,9 +1154,11 @@ Here, the `cost` and `price` fields will be displayed as wrapped in `number_to_c
 You can also use a binary modifier, which can apply to booleans, datetimes, times, dates or anything else. When using the binary modify, a specific value is displayed if the field is truthy and another one is display if the field is falsy.
 You specify it using a pipe | character like so:
 
+Example binary modification: 
+
 `--modify=paid_at{paid|unpaid}`
 
-here, even though `paid_at` is a datetime field, it will display as-if it is a binary -- showing either the truthy 
+Here, even though `paid_at` is a datetime field, it will display as-if it is a binary -- showing either the truthy 
 label or the falsy label depending on if `paid_at` is or is not null in the database.  
 For all fields except booleans, this affects only the viewable output — 
 what you see on the list page and on the edit page for show-only fields.  
@@ -1099,20 +1169,25 @@ You will need to separately specify them as show-only if you want them to be non
 
 Notice that each modifiers can be used with specific field types. 
 
-| user modifier                 | what it does                                                                                                                                                         | Field types                       |   |   |
-|-------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------|---|---|
-| $                             | wraps output in `number_to_currency()`                                                                                                                               | floats and integers               |   |   |
+| user modifier                 | what it does                                                                                                                                                         | Field types                       |   |    |
+|-------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------|---|----|
+| $                             | wraps output in `number_to_currency()`                                                                                                                               | floats and integers               |   |    |
 | (truthy label)\|(falsy label) | specify a binary switch with a pipe (\|) character if the value is truthy, it will display as "truthy label" if the value is falsy, it will display as "falsy label" | booleans, datetimes, dates, times |   |    |
-| partials                      | applies to enums only, you must have a partial whose name matches each enum type                                                                                     | enums only                        |   |   |
-| tinymce                       | applies to text fields only, be sure to setup TineMCE globally                                                                                                       | text fields only                  |    |   |
-| typeahead                     | turns a foreign key (only) into a searchable typeahead field                                                                                                         | foreign keys only                 |   |   |
-| timezone                      | turns a string (varchar) into a drop down of timezones                                                                                                               | foreign keys only                 |   |   |
-| include_blank                 | special modifier for association fields, adds include_blank to the created dropdown                                                                                   |                                   |
+| partials                      | applies to enums only, you must have a partial whose name matches each enum type                                                                                     | enums only                        |   |    |
+| tinymce                       | applies to text fields only, be sure to setup TineMCE globally                                                                                                       | text fields only                  |   |    |
+| typeahead                     | turns a foreign key (only) into a searchable typeahead field                                                                                                         | foreign keys only                 |   |    |
+| timezone                      | turns a string (varchar) into a drop down of timezones                                                                                                               | foreign keys only                 |   |    |
+| include_blank                 | special modifier for association fields, adds include_blank to the created dropdown                                                                                  |                                   |
+| urlwrap                       | wrap this field in a URL                                                                                                                                             | any printable field               |   |    |
 | none                          | special modifier for using badges                                                                                                                                    |
 
 Except for "(truthy label)" and "(falsy label)" which use the special syntax, use the modifier _exactly_ as it is named.
 
-apply badge behavior using `[` and `]` markers after the modification marker. 
+Some modifiers take a 3rd parameter in `[` and `]` markers after the modification marker. The 3rd parameters function depends on which modifier you are using. 
+
+
+#### Binary (use | to separate "true value" from "false value")
+Can take a bootstrap badge name as 3rd parameter
 
 `--modify=opened_at{opened|closed}[bg-primary|bg-secondary]`
 Applies a badge `bg-primary` to rows with opened_at truthy and `bg-secondary` to rows with opened_at falsy.
@@ -1120,10 +1195,50 @@ Applies a badge `bg-primary` to rows with opened_at truthy and `bg-secondary` to
 to display a badge on everything, use the `none` modifier with the
 `--modify=opened_at{none}[bg-dark]`
 
+#### $
 For the `$` modifier only, if the field name ends with `_cents`, the modifier will automatically divide the field by 100 before displaying it.
-
 (This is consistent with Stripe'e paradigm to always store money in cents, and this way I force myself to put `_cents` on the end of my field names to remind myself that they are in cents.)
 
+
+#### Typeahead
+3rd parameter (in `[...]`) used to specify the nested set IF the typeahead itself is nested (optional)
+- see the typeahead section for details
+
+#### urlwrap
+
+Use to wrap the field contents in a clickable link.
+
+`rails generate hot_glue:scaffold BskyUser --gd --modify='handle{urlwrap}[bsky_url]'`
+
+Here, we are telling Hot Glue that we want to modify the field called `handle` to be wrapped in a URL.
+We form that URL but calling the helper method `bsky_url` (must be defined in your helpers)
+
+When we do make that call, notice that we pass two arguments to bsky_url (not seen):
+1) the field we are modifying
+2) the object
+
+
+`bsky_url(bsky_user.handle, bsky_user)`
+
+(`bsky_user.handle` is the field to be modified, what will become the link text. `bsky_user` is the instance of the model
+object as it is displayed to the screen)
+
+its implementation might look like this:
+
+```
+module BskyUserHelper
+
+  def bsky_url(link_text, bsky_user)
+    link_to link_text, "https://#{bsky_user.handle}", target: "_blank"
+  end
+end
+```
+In this case I happen to be turning piece of text _that is the link itself_ into a link,
+which is why you see `"https://#{bsky_user.handle}"` in the URL being generated, but this is arbitrary.
+You can make any piece of text into a link, the helper method is only used to construct the link.
+
+
+
 ### `--alt-foreign-key-lookup=`
 
 Use for a join table to specify that a field should be looked up by a different field. For example, when you want to lookup a user by a (complete) email address.
@@ -1132,7 +1247,7 @@ In these contexts, the lookup must be exact match to the text entered (no partia
 
 Use `+` to map to the `find_or_create_by` method. (Without `+` it will use `find_by`.)
 
-This is accomlished using a little magic of a lookup field called `__lookup_X_Y` passed in the form parameters.
+This is accomplished using a little magic of a lookup field called `__lookup_X_Y` passed in the form parameters.
 
 The lookup field is used to look up the associated record, then deleted from the params.
 
@@ -1396,10 +1511,15 @@ As shown in the method `name_able?` of the example ThingPolicy above, if this fi
 ### `--hidden=` (affects both create + update actions)
 ### `--create-hidden=`
 ### `--update-hidden=`
-TODO: RENAME ME TO INVISIBLE 
 Separate list of fields. 
 
-These fields will exist on the create or update form exist as hidden_field, and so the update will still work._
+These fields will exist on the create or update form exist as `<input type='hidden'>` (html) field and so the *actual update or create action will continue to expect data from the front end.**
+
+(The data, being in a hidden field, is not visible to the user but it is in the browser's form, available to a hacker, and passed to the back-end for updating.)
+
+You do your own javascript here to insert/set the value programmatically. The example below uses a library called EditorView to create a HTML editor. 
+
+The dynamic interface's value from the edited html gets stuffed back into the form by Javascript before the form is updated
 
 
 EXAMPLE:
@@ -1492,10 +1612,9 @@ Like show only, these will check for `*_able?` methods on the object or Policy a
 
 It will also block the field from being updated on the backend, so don't use this if you want to create a hidden_field tag but still allow the controller to update it. (For that, see `--hidden=`.)
 
-
 Like show-only, note special behavior with pundit.
 
-A field can be marked invisible and show-only, in which case the invisible rule take prescedence when the access control is denied (field removed from form) but th show-only rule takes prescedance when the access control is granted,
+A field can be marked invisible and show-only, in which case the invisible rule take precedence when the access control is denied (field removed from form) but the show-only rule takes precedence when the access control is granted.
 
 Hidden can be used with invisible. In this case, the access control will be applied to the field. When editable, the hidden field output will be used.
 
@@ -1551,6 +1670,12 @@ If thing is not a Thing, then it is active relation (so this applies to the colu
 Remember, since the `_able?` methods are not otherwise called during Pundit's index cycle, this applies only to the list column headings and has no bearing on create, update, read, delete for which the access control can be anything you want that is available to the Poilcy. 
 
 
+###
+
+
+
+
+
 
 ## Code Insertion Features
 '
@@ -2284,6 +2409,57 @@ These automatic pickups for partials are detected at build time. This means that
 
 # VERSION HISTORY
 
+#### 2025-11-05 - v0.7
+
+Hot Glue already has a robust set of tools to provide field-by-field access control, hiding or turning visible-only fields by multiple methods, described under Access Control & Field Visibility Features.
+
+Remember that Hot Glue's opinionated design has two ways a field is displayed: show (which appears on the list view and is always just viewable), and form (which is usees by both the new and edit actions to display a form). Within the `form` output, the form might be used for either new or edit, and further refinements can be applied to new or edit.
+
+Here's a quick review those methods now:
+
+--pundit 	
+• No distinction is made between the new and edit contexts
+• If policy says not able (_able? method returns false), the field is shown as viewable-only. That is, a user with access to the controller but not the field-level access granted by Pundit will see the field's value but cannot edit it. If you want instead the Policy to determine if the field is editable or completely invisible (not shown to the user), use invible below
+
+--show-only=
+• Turns fields on this list viewable only for both create & edit actions
+• overrides what's on the policy, but asks the policy if not on this list
+
+--update-show-only=
+• Turns fields on this list viewable only for the edit action
+• overrides what's on the policy, but asks the policy if not on this list
+
+
+--hidden=,  --create-hidden=,  --update-hidden=
+• Creates <input type='hidden'> fields on the form, not seen by the user but available to a hacker in the browser, and submitted to the back end.
+
+--invisible=,  --create-invisible=,  --update-invisible=
+• Must be used with Pundit.
+• If policy returns true, the field is viewable on list & editable as normal.
+• If the policy return false, the field is taken away (invisible) for that user
+
+
+
+Today, with v0.7 of this gem, I'm introducing three more features that are all available from within the `--include` setting.
+
+• Omitted fields:  using `-` is omit on list & show;  use  `=` to omit the field on the form (new & edit)
+• Dynamic blocks (which can also be omitted using
+• Set column widths when using specified grouping made (--include contains `:`)
+
+For details, see "Layout & Manipulation Features"
+
+
+
+
+#### 2025-10-28 - v0.6.31
+
+- new modification directive: `urlwrap`: use to wrap the field contents in a clickable link.
+See docs for "urlwrap" in the `--modify=` section above
+
+- Fixes for typeaheads: corrects search url when the typeahead is built against a two-word model name
+
+- Fixes for source reflection on has_many associations
+
 #### 2025-10-19 - v0.6.30
 - fixes references from search typeaheads to a typeahead controller which is nested
 - `--nested` can now take square braces if the relationship from child to parent (belongs_to) uses a non-standard association name; @downnest_object fix for data array; changes to object_scope to accomodate new paradigm

data/lib/generators/hot_glue/fields/association_field.rb

@@ -103,8 +103,7 @@ class AssociationField < Field
 
       search_url  = "#{namespace ? namespace + "_" : ""}" +
         modify_as[:nested].join("_") + ( modify_as[:nested].any? ? "_" : "") +
-        + "#{assoc.class_name.downcase.pluralize}_typeahead_index_url"
-
+        + "#{assoc.name.to_s.pluralize}_typeahead_index_url"
 
       if @modify_as[:nested].any?
         search_url  << "(" + modify_as[:nested].collect{|x| "#{x}"}.join(",") + ")"
@@ -204,7 +203,10 @@ class AssociationField < Field
     assoc_name = name.to_s.gsub("_id","")
     assoc = eval("#{class_name}.reflect_on_association(:#{assoc_name})")
     if modify_as && modify_as[:typeahead]
-      search_url  = "#{namespace ? namespace + "_" : ""}#{modify_as[:nested] ? modify_as[:nested][0] + "_" : ""}#{assoc.class_name.downcase.pluralize}_typeahead_index_url"
+
+
+      search_url  = "#{namespace ? namespace + "_" : ""}#{ modify_as[:nested][0] ? modify_as[:nested][0] + "_" : ""}#{assoc.name.to_s.pluralize}_typeahead_index_url"
+
 
       # \"q[0][#{name}_search]\"
       # @q['0']['#{name}_search']
@@ -217,7 +219,7 @@ class AssociationField < Field
                      autofocus: true,
                      autocomplete: 'off',
                      value: @q['0']['#{name}'].present? ? #{assoc.class_name}.find(@q['0']['#{name}']).try(:name) : \"\"  %>
-      <%= f.hidden_field \'q[0][#{name}]\', value: @q['0']['#{name}_search'].try(:id), 'data-typeahead-target': 'hiddenFormValue' %>
+      <%= f.hidden_field \'q[0][#{name}]\', value: @q['0']['#{name}'], 'data-typeahead-target': 'hiddenFormValue' %>
       <div data-typeahead-target='results'></div>
       <div data-typeahead-target='classIdentifier' data-id=\"typeahead--q_0_#{name}_search\"></div>
       </div>"

data/lib/generators/hot_glue/fields/field.rb

@@ -146,7 +146,13 @@ class Field
 
     elsif modify_as[:timezone]
       res += "<%= #{singular}.#{name} %>"
+    elsif modify_as[:urlwrap]
+      # helper_method =  modify_as[:helper_method].split(" ")[0]
+      # param = modify_as[:helper_method].split(" ")[1]
+
+      res += "<%= #{modify_as[:helper_method]}(#{singular}.#{name}, #{singular})  %>"
     elsif modify_as[:enum]
+
     elsif modify_as[:none]
         field_view_output
       # res += "<%= render partial: #{singular}.#{name}, locals: {#{singular}: #{singular}} %>"

data/lib/generators/hot_glue/layout/builder.rb

@@ -11,8 +11,8 @@ module HotGlue
                   :stacked_downnesting, :bootstrap_column_width
 
       def initialize(generator: ,
-                     include_setting: ,
-                     buttons_width:  )
+                     include_setting:,
+                     buttons_width: )
 
 
         @generator = generator
@@ -41,7 +41,11 @@ module HotGlue
           columns: {
             size_each: smart_layout ? bootstrap_column_width : (specified_grouping_mode ? nil : 1),
             container: [] , # array of arrays,
-            bootstrap_column_width: []
+            bootstrap_column_width: [],
+            column_custom_widths: [],
+            fields: {
+
+            }, # hash of fields
           },
           portals:  {
 
@@ -103,15 +107,21 @@ module HotGlue
             }
             layout_object[:columns][:container] = (0..available_columns-1).collect { |x|  [columns[x]] }
             layout_object[:columns][:container].reject!{|x| x == [nil]}
-            # layout_object[:columns][:size_each] = bootstrap_column_width
+
           end
+
         elsif ! specified_grouping_mode
           # not smart and no specified grouping
           layout_object[:columns][:button_columns] = bootstrap_column_width
 
           layout_object[:columns][:container] = columns.collect{|col| [col]}
 
-        else # specified grouping mode -- the builder is given control
+          if include_setting.split(",").any?{|col| col.include?("(")}
+            raise "Your include list has a ( character; to specify a column width, use specified grouping mode only"
+          end
+
+
+        else # specified grouping mode -- the builder is given control unless a column width is explicitly set using (..)
           layout_object[:columns][:button_columns] = bootstrap_column_width
 
           (0..available_columns-1).each do |int|
@@ -121,16 +131,22 @@ module HotGlue
           # input control
 
           user_layout_columns = @include_setting.split(":")
+          fixed_widths = {}
+
+          user_layout_columns.each_with_index do |column_data,i |
+            if column_data.include?("(")
+              column_data =~ /(.*)\((.*)\)/
+              column_fields = $1
+              fixed_col_width = $2
+              fixed_widths[i] = fixed_col_width
+            else
+              column_fields = column_data
+            end
+            user_layout_columns[i] = column_fields
+          end
 
-          extra_columns = available_columns - user_layout_columns.size
-          # size_each = (bootstrap_columns / user_layout_columns.count).floor # this is the bootstrap size
-          #
-          # layout_object[:columns][:size_each] = size_each
-
-          # if user_layout_columns.size > available_columns
-          #   raise "Your include statement #{@include_setting } has #{user_layout_columns.size} columns, but I can only construct up to #{available_columns}"
-          # end
 
+          extra_columns = available_columns - user_layout_columns.size
 
           columns_to_work_with =  (12 - @buttons_width)
 
@@ -142,10 +158,17 @@ module HotGlue
           extra_columns = columns_to_work_with % user_layout_columns.size
 
 
-          user_layout_columns.each_with_index  do |column,i|
-            layout_object[:columns][:container][i] = column.split(",").collect(&:to_sym)
-            layout_object[:columns][:bootstrap_column_width][i] = target_col_size
-            if i < extra_columns
+          user_layout_columns.each_with_index  do |column, i|
+
+            layout_object[:columns][:container][i] = column.split(",").collect{|x|
+              x.gsub("-","").gsub("=","")
+            }.collect(&:to_sym)
+
+
+
+            layout_object[:columns][:bootstrap_column_width][i] = fixed_widths[i] || target_col_size
+
+            if i < extra_columns && ! fixed_widths[i]
               layout_object[:columns][:bootstrap_column_width][i] += 1
             end
           end
@@ -153,14 +176,46 @@ module HotGlue
           if user_layout_columns.size < layout_object[:columns][:container].size
             layout_object[:columns][:container].reject!{|x| x == []}
           end
+        end
 
+        # go through the columns and build the split visibility (show / form)
+
+        columns.each do |col|
+          layout_object[:columns][:fields][col] = {show: true, form: true}
         end
 
+        @include_setting.split(":").collect { |column_list|
+          column_list.split(",").collect do |field|
+            if field.include?("(")
+              field =~ /(.*)\((.*)\)/
+              field_short = $1
+            else
+              field_short = field
+            end
+
+            field_short =  field_short.gsub("-", "").gsub("=", "")
+
+            layout_object[:columns][:fields][field_short.to_sym] = {
+              show: true,
+              form: true
+            }
 
-        puts "*** constructed smart layout columns #{layout_object.inspect}"
+            if field.starts_with?("**")
+              nil
+            end
+
+            if field.include?("-")
+              layout_object[:columns][:fields][field_short.to_sym][:show] = false;
+            end
+            if field.include?("=")
+              layout_object[:columns][:fields][field_short.to_sym][:form] = false;
+            end
+
+          end
+        }
+        puts "*** SPECIFIED GROUPING SETTINGS: #{layout_object.inspect}"
         layout_object
       end
-
     end
   end
 end

data/lib/generators/hot_glue/markup_templates/erb.rb

@@ -98,11 +98,15 @@ module  HotGlue
         size = layout_object[:columns][:bootstrap_column_width][i]
         "<div class='#{layout_strategy.column_classes_for_column_headings(size)} hg-heading-row heading--#{singular}--#{column.join("-")}' " + col_style + ">" +
           column.map(&:to_s).map{|col_name|
-            the_output = "#{col_name.humanize}"
+            unless col_name.starts_with?("**")
+              the_output = "#{col_name.humanize}"
+            else
+              the_output = ""
+            end
             if invisible_update.include?(col_name.to_sym)
               if_statements = []
               if_statements << "false" if invisible_update.include?(col_name.to_sym)
-              # if_statements << "@action == 'new'" if invisible_create.include?(col_name.to_sym)
+
               the_output = "<% if ( " +  if_statements.join(" || ") + " || policy(#{@plural}).#{col_name}_able? ) %>" +
                 +  the_output + "<% end %>"
 
@@ -158,7 +162,7 @@ module  HotGlue
           dom_label = choice[:label].downcase.gsub(" ","_")
           if data[:type] == "radio"
             res << "\n<input type='radio'
-                            id='#{search_field}_search__#{dom_label}}'
+                            id='#{search_field}_search__#{dom_label}'
                             name='q[0][#{search_field}_search]' value='#{dom_label}'
            <%= 'checked' if  @q['0'][:#{search_field}_search] == \"#{dom_label}\" %> />"
           elsif data[:type] == "checkboxes"
@@ -196,65 +200,71 @@ module  HotGlue
 
         "  <div class='#{layout_strategy.column_classes_for_form_fields(size)} cell--#{singular}--#{column.join("-")}' >" +
           column.map { |col|
+            if col.to_s.starts_with?("**") && layout_object[:columns][:fields][col][:form]
+              the_output = "<%= render partial: '#{col.to_s.gsub!("**","")}', locals: {#{singular}: #{singular} } %>"
+            elsif ! layout_object[:columns][:fields][col][:form]
+              # omit from show action
+            else
 
-            field_error_name = columns_map[col].field_error_name
+              field_error_name = columns_map[col].field_error_name
 
-            label_class = columns_map[col].label_class
-            label_for = columns_map[col].label_for
+              label_class = columns_map[col].label_class
+              label_for = columns_map[col].label_for
 
-            the_label = "\n<label class='#{label_class}' for='#{label_for}'>#{col.to_s.humanize}</label>"
-
-
-            field_result =
-              if show_only.include?(col)
-                columns_map[col].form_show_only_output
-              elsif update_show_only.include?(col) && !@pundit
-                "<% if @action == 'edit' %>" + columns_map[col].form_show_only_output + "<% else %>" + columns_map[col].form_field_output + "<% end %>"
-              elsif update_show_only.include?(col) && @pundit && eval("defined? #{singular_class}Policy") && eval("#{singular_class}Policy").instance_methods.include?("#{col}_able?".to_sym)
-                "<% if @action == 'new' && policy(@#{singular}).#{col}_able? %>" + columns_map[col].form_field_output + "<% else %>" + columns_map[col].form_show_only_output + "<% end %>"
-                 # show only on the update action overrides any pundit policy
-              elsif @pundit && eval("defined? #{singular_class}Policy") && eval("#{singular_class}Policy").instance_methods.include?("#{col}_able?".to_sym)
-                "<% if policy(@#{singular}).#{col}_able? %>" + columns_map[col].form_field_output + "<% else %>" + columns_map[col].form_show_only_output  + "<% end %>"
-              elsif update_show_only.include?(col)
-                "<% if @action == 'edit' %>" + columns_map[col].form_show_only_output + "<% else %>" + columns_map[col].form_field_output + "<% end %>"
-              else
-                columns_map[col].form_field_output
-              end
+              the_label = "\n<label class='#{label_class}' for='#{label_for}'>#{col.to_s.humanize}</label>"
 
 
-            @tinymce_stimulus_controller = (columns_map[col].modify_as == {tinymce: 1} ?  "data-controller='tiny-mce' " : "")
+              field_result =
+                if show_only.include?(col)
+                  columns_map[col].form_show_only_output
+                elsif update_show_only.include?(col) && !@pundit
+                  "<% if @action == 'edit' %>" + columns_map[col].form_show_only_output + "<% else %>" + columns_map[col].form_field_output + "<% end %>"
+                elsif update_show_only.include?(col) && @pundit && eval("defined? #{singular_class}Policy") && eval("#{singular_class}Policy").instance_methods.include?("#{col}_able?".to_sym)
+                  "<% if @action == 'new' && policy(@#{singular}).#{col}_able? %>" + columns_map[col].form_field_output + "<% else %>" + columns_map[col].form_show_only_output + "<% end %>"
+                   # show only on the update action overrides any pundit policy
+                elsif @pundit && eval("defined? #{singular_class}Policy") && eval("#{singular_class}Policy").instance_methods.include?("#{col}_able?".to_sym)
+                  "<% if policy(@#{singular}).#{col}_able? %>" + columns_map[col].form_field_output + "<% else %>" + columns_map[col].form_show_only_output  + "<% end %>"
+                elsif update_show_only.include?(col)
+                  "<% if @action == 'edit' %>" + columns_map[col].form_show_only_output + "<% else %>" + columns_map[col].form_field_output + "<% end %>"
+                else
+                  columns_map[col].form_field_output
+                end
 
-            if @stimmify
-              col_target = HotGlue.to_camel_case(col.to_s.gsub("_", " "))
-              data_attr = " data-#{@stimmify}-target='#{col_target}Wrapper'"
-            end
 
+              @tinymce_stimulus_controller = (columns_map[col].modify_as == {tinymce: 1} ?  "data-controller='tiny-mce' " : "")
 
-            the_output =   add_spaces_each_line( "\n  <div #{@tinymce_stimulus_controller}class='<%= \"alert alert-danger\" if #{singular}.errors.details.keys.include?(:#{field_error_name}) %>' #{data_attr} >\n" +
-                                                             add_spaces_each_line( (form_labels_position == 'before' ? (the_label || "") + "<br />\n"  : "") +
-                                                                                     +  field_result +
-                                                                                     (form_labels_position == 'after' ? (  columns_map[col].newline_after_field? ? "<br />\n" : "") + (the_label || "") : "")  , 4) +
-                                                             "\n  </div>\n ", 2)
+              if @stimmify
+                col_target = HotGlue.to_camel_case(col.to_s.gsub("_", " "))
+                data_attr = " data-#{@stimmify}-target='#{col_target}Wrapper'"
+              end
 
 
-            if hidden_create.include?(col.to_sym) || hidden_update.include?(col.to_sym)
-              if_statements = []
-              if_statements << "@action == 'edit'" if hidden_update.include?(col.to_sym)
-              if_statements << "@action == 'new'" if hidden_create.include?(col.to_sym)
+              the_output =   add_spaces_each_line( "\n  <div #{@tinymce_stimulus_controller}class='<%= \"alert alert-danger\" if #{singular}.errors.details.keys.include?(:#{field_error_name}) %>' #{data_attr} >\n" +
+                                                               add_spaces_each_line( (form_labels_position == 'before' ? (the_label || "") + "<br />\n"  : "") +
+                                                                                       +  field_result +
+                                                                                       (form_labels_position == 'after' ? (  columns_map[col].newline_after_field? ? "<br />\n" : "") + (the_label || "") : "")  , 4) +
+                                                               "\n  </div>\n ", 2)
 
-              the_output = "<% if " + if_statements.join(" || ") + " %>" +
-                columns_map[col].hidden_output + "<% else %>" +  the_output + "<% end %>"
-            end
 
-            if invisible_create.include?(col) || invisible_update.include?(col)
-              if_statements = []
-              if_statements << "@action == 'edit'" if invisible_update.include?(col.to_sym)
-              if_statements << "@action == 'new'" if invisible_create.include?(col.to_sym)
+              if hidden_create.include?(col.to_sym) || hidden_update.include?(col.to_sym)
+                if_statements = []
+                if_statements << "@action == 'edit'" if hidden_update.include?(col.to_sym)
+                if_statements << "@action == 'new'" if hidden_create.include?(col.to_sym)
 
-              the_output = "<% if !(" + if_statements.join(" || ") + ") || policy(@#{singular}).#{col}_able? %>" +
-                +  the_output + "<% end %>"
-            end
+                the_output = "<% if " + if_statements.join(" || ") + " %>" +
+                  columns_map[col].hidden_output + "<% else %>" +  the_output + "<% end %>"
+              end
+
+              if invisible_create.include?(col) || invisible_update.include?(col)
+                if_statements = []
+                if_statements << "@action == 'edit'" if invisible_update.include?(col.to_sym)
+                if_statements << "@action == 'new'" if invisible_create.include?(col.to_sym)
 
+                the_output = "<% if !(" + if_statements.join(" || ") + ") || policy(@#{singular}).#{col}_able? %>" +
+                  +  the_output + "<% end %>"
+              end
+
+            end # end of if col.to_s.starts_with?("**")
 
 
             the_output
@@ -298,35 +308,39 @@ module  HotGlue
       style_with_flex_basis = layout_strategy.style_with_flex_basis(perc_width)
 
       result = columns.map.with_index{ |column,i|
-
         size = layout_object[:columns][:bootstrap_column_width][i]
-
         "<div class='hg-col #{layout_strategy.column_classes_for_line_fields(size)} #{singular}--#{column.join("-")}'#{style_with_flex_basis}> " +
         column.map { |col|
-          if eval("#{singular_class}.columns_hash['#{col}']").nil? && !attachments.keys.include?(col) && !related_sets.include?(col)
+          if col.starts_with?("**") && layout_object[:columns][:fields][col][:show]
+            the_output = "<%= render partial: '#{col.to_s.gsub!("**","")}', locals: {#{singular}: #{singular} } %>"
+          elsif ! layout_object[:columns][:fields][col][:show]
+            the_output = ""
+          elsif eval("#{singular_class}.columns_hash['#{col}']").nil? && !attachments.keys.include?(col) && !related_sets.include?(col)
             raise "Can't find column '#{col}' on #{singular_class}, are you sure that is the column name?"
-          end
+            # omit from show action
+          else
 
-          field_output = columns_map[col].line_field_output
-          
-          label = "<label class='small form-text text-muted'>#{col.to_s.humanize}</label>"
+            field_output = columns_map[col].line_field_output
 
-          the_output = "#{inline_list_labels == 'before' ? label + "<br/>" : ''}#{field_output}#{inline_list_labels == 'after' ? "<br/>" + label : ''}"
-          if invisible_create.include?(col) || invisible_update.include?(col)
-            if_statements = []
-            if invisible_update.include?(col.to_sym) && invisible_create.include?(col.to_sym)
-            # elsif invisible_create.include?(col.to_sym)
-            #   if_statements << "!(@action == 'new')"
-            else
-              if_statements << "@action == 'edit'"
-            end
+            label = "<label class='small form-text text-muted'>#{col.to_s.humanize}</label>"
 
-            if_statements << " policy(#{singular}).#{col}_able?"
-            the_output = "<% if  " +  if_statements.join(" || ") + " %>" +
-              +  the_output + "<% end %>"
+            the_output = "#{inline_list_labels == 'before' ? label + "<br/>" : ''}#{field_output}#{inline_list_labels == 'after' ? "<br/>" + label : ''}"
+            the_output += "\n"
+            if invisible_create.include?(col) || invisible_update.include?(col)
+              if_statements = []
+              if invisible_update.include?(col.to_sym) && invisible_create.include?(col.to_sym)
+              else
+                if_statements << "@action == 'edit'"
+              end
+
+              if_statements << " policy(#{singular}).#{col}_able?"
+              the_output = "<% if  " +  if_statements.join(" || ") + " %>" +
+                +  the_output + "<% end %>"
+            end
           end
+
           the_output
-        }.join(  "<br />") + "</div>"
+        }.join(  "<br />\n") + "</div>"
       }.join("\n")
       return result
 

data/lib/generators/hot_glue/scaffold_generator.rb

@@ -256,11 +256,26 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
       @include_fields = []
 
       # semicolon to denote layout columns; commas separate fields
-      @include_fields += options['include'].split(":").collect { |x| x.split(",") }.flatten.collect(&:to_sym)
+      #
+      @include_fields += options['include'].split(":").collect { |column_list|
+        column_list.split(",").collect do |field|
+          if field.include?("(")
+            field =~ /(.*)\((.*)\)/
+            field_short = $1
+          else
+            field_short = field
+          end
+          if field_short.starts_with?("**")
+            nil
+          else
+            field_short.gsub("-", "").gsub("=", "")
+          end
+        end
+      }.flatten.compact.collect(&:to_sym)
+      puts "INCLUDED FIELDS: #{@include_fields}"
     end
 
 
-
     @show_only = options['show_only'].split(",").collect(&:to_sym)
     if @show_only.any?
       puts "show only field #{@show_only}}"
@@ -300,6 +315,7 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
           setting =~ /(.*){(.*)}/
           key, lookup_as = $1, $2
         end
+
         if ["$"].include?($2)
           @modify_as[key.to_sym] =  {cast: $2, badges: $3}
         elsif $2.include?("|")
@@ -322,6 +338,10 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
           @modify_as[key.to_sym] =  {timezone: 1, badges: $3}
         elsif $2 == "include_blank"
           @modify_as[key.to_sym] =  {include_blank: true}
+        elsif $2 == "urlwrap"
+          helper_method = $3
+          @modify_as[key.to_sym] = { urlwrap: true,
+                                     helper_method: helper_method }
         elsif $2 == "none"
           @modify_as[key.to_sym] =  {none: 1, badges: $3}
         else
@@ -1079,6 +1099,19 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
     end
   end
 
+  # def omit_fields_show
+  #
+  #   layout_object[:columns][:fields].each { |key, value|
+  #     value[:show] == false
+  #   }.reduce(:&)
+  # end
+
+  def omit_fields_form
+    layout_object[:columns][:fields].collect { |key, value| value[:form] == false ?  key : nil }.compact.reject!{|x| x.starts_with?("**")} || []
+  end
+
+
+
   def check_if_sample_file_is_present
     if sample_file_path.nil?
       puts "you have no sample file path set in config/hot_glue.yml"
@@ -1443,15 +1476,15 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
                                         .to_a.find{|x|
 
           if x.source_reflection
-            x.foreign_key == foreign_key
-
-            # raise "#{singular_class} class declaration is missing source reflection for the `has_many :#{x.name}` association"
+            x.table_name == plural
           end
       }.plural_name
+
     else
       association = plural
     end
 
+
     if @auth && !@god
       if @nested_set.none?
         @auth + ".#{association}"
@@ -1851,7 +1884,7 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
     else
       if !@self_auth
 
-        res << spaces(4) + "@#{ plural_name } = #{ object_scope.gsub("@",'') }#{ n_plus_one_includes }#{record_scope}#{".all" if n_plus_one_includes.blank? && record_scope.blank? }"
+        res << spaces(4) + "@#{ plural_name } = #{ object_scope.gsub("@",'') }#{record_scope}#{ n_plus_one_includes }#{".all" if n_plus_one_includes.blank? && record_scope.blank? }"
 
         if @search_fields
           res << @search_fields.collect{ |field|
@@ -1887,7 +1920,7 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
       if phantom_data[:type] == "radio"
         phantom_data[:choices].each do |choice|
           unless choice[:scope] == ".all"
-            res << "\n    @#{plural} = @#{plural}#{choice[:scope]} if @q['0'][:#{phantom_key}_search] == \"#{choice[:label]}\""
+            res << "\n    @#{plural} = @#{plural}#{choice[:scope]} if @q['0'][:#{phantom_key}_search] == \"#{choice[:label].downcase.gsub(" ","_")}\""
           end
         end
       elsif phantom_data[:type] == "checkboxes"
@@ -1898,7 +1931,7 @@ class HotGlue::ScaffoldGenerator < Erb::Generators::ScaffoldGenerator
             res << "\n    @#{plural} = @#{plural}#{choice[:scope]} if @q['0'][:#{phantom_key}_search__#{choice[:label].gsub(" ", "_").downcase}] == \"1\""
           end
           unless choice[:scope_negative] == ".all"
-            res << "\n    @#{plural} = @#{plural}#{choice[:scope_negative]} if @q['0'][:#{phantom_key}_search___#{choice[:label].gsub(" ", "_").downcase}] != \"1\""
+            res << "\n    @#{plural} = @#{plural}#{choice[:scope_negative]} if @q['0'][:#{phantom_key}_search__#{choice[:label].gsub(" ", "_").downcase}] != \"1\""
           end
         end
       end

data/lib/generators/hot_glue/templates/controller.rb.erb

@@ -288,13 +288,13 @@ class <%= controller_class_name %> < <%= controller_descends_from %>
   end<% end %><% end %>
 
   def <%=singular_name%>_params
-    fields = <%= ((fields_filtered_for_strong_params - @show_only) + @magic_buttons.collect{|x| "__#{x}"}  + @phantom_create_params.split(",")).collect{|sym| ":#{sym}"}.join(", ") %><%= ", " + @related_sets.collect{|key, rs| "{#{rs[:association_ids_method]}: []}"}.join(", ") if @related_sets.any? %><%= ", " +  @alt_lookups.collect{|k,v|  ":__lookup_#{v[:assoc].downcase}_#{v[:lookup_as]}"  }.join(", ") if @alt_lookups.any? %>
+    fields = <%= ((fields_filtered_for_strong_params - @show_only - omit_fields_form) + @magic_buttons.collect{|x| "__#{x}"}  + @phantom_create_params.split(",")).collect{|sym| ":#{sym}"}.join(", ") %><%= ", " + @related_sets.collect{|key, rs| "{#{rs[:association_ids_method]}: []}"}.join(", ") if @related_sets.any? %><%= ", " +  @alt_lookups.collect{|k,v|  ":__lookup_#{v[:assoc].downcase}_#{v[:lookup_as]}"  }.join(", ") if @alt_lookups.any? %>
     params.require(:<%= testing_name %>).permit(fields)
   end<% if @update_show_only %>
 
   <% unless @no_edit %>
   def update_<%=singular_name%>_params
-    fields = <%= ((fields_filtered_for_strong_params - @update_show_only)  + @magic_buttons.collect{|x| "__#{x}"} +  @phantom_update_params.split(",")).collect{|sym| ":#{sym}"}.join(", ") %><%= ", " + @related_sets.collect{|key, rs| "{#{rs[:association_ids_method]}: []}"}.join(", ") if @related_sets.any? %><%=  ", " + @alt_lookups.collect{|k,v|  ":__lookup_#{v[:assoc].downcase}_#{v[:lookup_as]}"  }.join(", ") if @alt_lookups.any?  %>
+    fields = <%= ((fields_filtered_for_strong_params - @update_show_only - omit_fields_form)  + @magic_buttons.collect{|x| "__#{x}"} +  @phantom_update_params.split(",")).collect{|sym| ":#{sym}"}.join(", ") %><%= ", " + @related_sets.collect{|key, rs| "{#{rs[:association_ids_method]}: []}"}.join(", ") if @related_sets.any? %><%=  ", " + @alt_lookups.collect{|k,v|  ":__lookup_#{v[:assoc].downcase}_#{v[:lookup_as]}"  }.join(", ") if @alt_lookups.any?  %>
     <%= (fields_filtered_for_strong_params - @update_show_only).collect{|col|
     # TODO : fields not on show only also not invisible should be checked here
     # for _able? methods and added only when able

data/lib/hotglue/version.rb

@@ -1,5 +1,5 @@
 module HotGlue
   class Version
-    CURRENT = '0.6.30'
+    CURRENT = '0.7'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hot-glue
 version: !ruby/object:Gem::Version
-  version: 0.6.30
+  version: '0.7'
 platform: ruby
 authors:
 - Jason Fleetwood-Boldt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-19 00:00:00.000000000 Z
+date: 2025-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails