b4um_generators 0.2.10 → 0.2.14

data/lib/generators/b4um/authentication/authentication_generator.rb

@@ -149,6 +149,69 @@ module B4um
         end
       end
 
+      def update_in_place_helper
+        helper_path = "app/helpers/b4um_in_place_helper.rb"
+
+        full_helper_path = File.join(
+          destination_root,
+          helper_path
+        )
+
+        return unless File.exist?(full_helper_path)
+
+        helper = File.read(full_helper_path)
+
+        return if helper.include?(
+          "def b4um_in_place_editing_allowed?\n    logged_in?"
+        )
+
+        gsub_file(
+          helper_path,
+          "def b4um_in_place_editing_allowed?\n    true",
+          "def b4um_in_place_editing_allowed?\n    logged_in?"
+        )
+      end
+
+      def protect_in_place_controllers
+        controllers_path = File.join(
+          destination_root,
+          "app/controllers"
+        )
+
+        return unless Dir.exist?(controllers_path)
+
+        Dir.glob(
+          File.join(controllers_path, "*_controller.rb")
+        ).each do |full_controller_path|
+          controller = File.read(full_controller_path)
+
+          next unless controller.include?("IN_PLACE_FIELDS")
+
+          controller_name =
+            File
+            .basename(full_controller_path, "_controller.rb")
+
+          protect_index_actions_for(controller_name)
+          protect_show_actions_for(controller_name)
+
+          callback =
+            "before_action :require_login, except: [:index, :show]"
+
+          next if controller.include?(callback)
+
+          controller_path = full_controller_path.delete_prefix(
+            "#{destination_root}/"
+          )
+
+          inject_into_file(
+            controller_path,
+            after: /^class .*Controller < ApplicationController\s*$/
+          ) do
+            "\n  #{callback}"
+          end
+        end
+      end
+
       def add_session_routes
         routes_path = "config/routes.rb"
         full_routes_path = File.join(destination_root, routes_path)

data/lib/generators/b4um/help/help_generator.rb

@@ -362,6 +362,8 @@ module B4um
             - b4um index, show, new and edit views
             - Bento index layout by default
             - Optional table index layout
+            - Select fields with custom labels
+            - Radio fields with custom labels
             - Automatic navigation entry
             - Active navigation state
             - Form validation errors
@@ -369,6 +371,34 @@ module B4um
             - Password field support
             - Optional readable URL parameters
 
+          Select fields can be generated with:
+
+            --select='FIELD:VALUE=LABEL,VALUE=LABEL'
+
+          Example:
+
+            bin/rails generate b4um:scaffold Product name:string status:string --select='status:Active=Aktiv,Inactive=Inaktiv'
+
+          Radio fields use the same value and label syntax:
+
+            --radio='FIELD:VALUE=LABEL,VALUE=LABEL'
+
+          Example:
+
+            bin/rails generate b4um:scaffold Product name:string condition:string --radio='condition:new=Neu,used=Gebraucht,refurbished=Generalüberholt'
+
+          The configured values are stored in the database. The labels
+          are displayed in forms, resource views and table layouts.
+
+          Select and radio options can be used together for different
+          fields.
+
+          Example:
+
+            bin/rails generate b4um:scaffold Product name:string status:string condition:string --select='status:Active=Aktiv,Inactive=Inaktiv' --radio='condition:new=Neu,used=Gebraucht'
+
+          The same field cannot use both --select and --radio.
+
           The default index uses the b4um Bento card layout.
 
           To generate a table index instead, use:
@@ -905,6 +935,67 @@ module B4um
           the generator to stop with an error.
 
 
+          IN-PLACE EDITING
+
+            bin/rails generate b4um:in_place MODEL FIELD [FIELD ...]
+
+          Adds in-place editing to fields of an existing b4um resource.
+
+          Examples:
+
+            bin/rails generate b4um:in_place Product name
+            bin/rails generate b4um:in_place Product name price status
+
+          The model, controller and resource routes must already exist.
+
+          The generator detects the field type automatically and creates
+          the appropriate in-place editor.
+
+          Supported fields include:
+
+            - String and text fields
+            - Numeric and decimal fields
+            - Boolean fields
+            - Action Text rich text fields
+            - Active Storage single image attachments
+            - Active Storage multiple image attachments
+
+          Select fields can be configured with --select:
+
+            bin/rails generate b4um:in_place Product status --select='status:Active=Aktiv,Inactive=Inaktiv'
+
+          Radio buttons can be configured with --radio:
+
+            bin/rails generate b4um:in_place Product condition --radio='condition:new=Neu,used=Gebraucht,refurbished=Generalüberholt'
+
+          The value before "=" is stored in the database.
+          The optional value after "=" is used as the displayed label.
+
+          In-place editing features:
+
+            - Turbo Frame based editing without an additional in-place gem
+            - Click a displayed field to edit it in place
+            - Text and rich text fields save when clicking outside
+            - Select, radio, and boolean fields save immediately
+            - Single and multiple image attachment editing
+            - Existing attachments can be removed
+            - Validation errors remain visible inside the editor
+            - Successful updates can refresh the flash message immediately
+            - Existing resource layout remains in place while editing
+            - Multiple fields can be added in one generator run
+            - Additional fields can be added in later generator runs
+            - Safe repeated generator runs
+
+          In-place editing also integrates with b4um authentication.
+
+          Without authentication, generated in-place fields are editable.
+          When b4um authentication is installed, editing is restricted to
+          logged-in users and the affected controller actions are protected.
+
+          Authentication can be installed before or after in-place editing.
+          The generators update the integration automatically in either order.
+
+
           TRIX / RICH TEXT
 
             bin/rails generate b4um:trix MODEL ATTRIBUTE
@@ -915,21 +1006,27 @@ module B4um
 
             bin/rails generate b4um:trix Article content
 
-          The model and form must already exist.
+          The model and b4um form must already exist. The selected
+          attribute does not need to be present in the form yet.
 
           The generator adds:
 
             has_rich_text :content
 
-          and replaces the selected form field with a rich text editor:
+          and adds or replaces the selected form field with a rich
+          text editor:
 
             form.rich_text_area :content
 
+          The corresponding b4um resource field is also added when
+          it does not already exist.
+
           Trix / Rich Text features:
 
             - Installs Action Text automatically when necessary
             - Adds the rich text association to the model
-            - Replaces only the selected form field
+            - Adds or replaces the selected form field
+            - Adds the rich text field to the b4um resource when necessary
             - Preserves compact Bento text using plain text
             - Image lightbox for images inside rich text
             - Previous / next image navigation