feature: add bulk update

app/components/avo/fields/select_field/edit_component.html.erb

@@ -1,6 +1,6 @@
 <%= field_wrapper(**field_wrapper_args) do %>
   <%= @form.select @field.id, options_for_select(@field.options_for_select, selected: @field.value), {
-      include_blank: @field.include_blank
+      include_blank: (params[:controller] == "avo/bulk_update") || @field.include_blank
     },
     multiple: @field.multiple,
     aria: {

app/components/avo/resource_component.rb

@@ -146,6 +146,17 @@
     end
   end
 
+  def render_bulk_edit_button(control)
+    a_link bulk_edit_path,
+           style: :primary,
+           color: :primary,
+           icon: "avo/edit",
+           class: "hidden",
+           form_class: "flex flex-col sm:flex-row sm:inline-flex" do
+      control.label
+    end
+  end
+
   def render_actions_list(actions_list)
     return unless can_see_the_actions_button?
 

app/components/avo/views/resource_edit_component.rb

@@ -8,6 +8,7 @@ class Avo::Views::ResourceEditComponent < Avo::ResourceComponent
   prop :actions, default: [].freeze
   prop :view, default: Avo::ViewInquirer.new(:edit).freeze
   prop :display_breadcrumbs, default: true, reader: :public
+  prop :query
 
   def after_initialize
     @display_breadcrumbs = @reflection.blank? && display_breadcrumbs
@@ -77,7 +78,9 @@ def form_method
   end
 
   def form_url
-    if is_edit?
+    if params[:controller] == "avo/bulk_update"
+      helpers.handle_bulk_update_path(resource_name: @resource.name, query: @query)
+    elsif is_edit?
       helpers.resource_path(
         record: @resource.record,
         resource: @resource

app/components/avo/views/resource_index_component.rb

@@ -29,6 +29,20 @@ def title
     end
   end
 
+  def bulk_edit_path
+    # Add the `view` param to let Avo know where to redirect back when the user clicks the `Cancel` button.
+    args = {via_view: "index"}
+
+    if @parent_record.present?
+      args = {
+        via_resource_class: @parent_resource.class.to_s,
+        via_record_id: @parent_record.to_param
+      }
+    end
+
+    helpers.edit_bulk_update_path(resource_name: @resource.name, **args)
+  end
+
   # The Create button is dependent on the new? policy method.
   # The create? should be called only when the user clicks the Save button so the developers gets access to the params from the form.
   def can_see_the_create_button?

app/controllers/avo/base_controller.rb

@@ -8,7 +8,7 @@ class BaseController < ApplicationController
     before_action :set_resource_name
     before_action :set_resource
     before_action :set_applied_filters, only: :index
-    before_action :set_record, only: [:show, :edit, :destroy, :update, :preview]
+    before_action :set_record, only: [:show, :edit, :destroy, :update, :preview], if: -> { controller_name != "bulk_update" }
     before_action :set_record_to_fill, only: [:new, :edit, :create, :update]
     before_action :detect_fields
     before_action :set_edit_title_and_breadcrumbs, only: [:edit, :update]
@@ -406,8 +406,10 @@ def filters_to_be_applied
     end
 
     def set_edit_title_and_breadcrumbs
-      @resource = @resource.hydrate(record: @record, view: Avo::ViewInquirer.new(:edit), user: _current_user)
-      @page_title = @resource.default_panel_name.to_s
+      if params[:controller] != "avo/bulk_update"
+        @resource = @resource.hydrate(record: @record, view: Avo::ViewInquirer.new(:edit), user: _current_user)
+        @page_title = @resource.default_panel_name.to_s
+      end
 
       last_crumb_args = {}
       # If we're accessing this resource via another resource add the parent to the breadcrumbs.
@@ -428,8 +430,16 @@ def set_edit_title_and_breadcrumbs
         add_breadcrumb @resource.plural_name.humanize, resources_path(resource: @resource)
       end
 
-      add_breadcrumb @resource.record_title, resource_path(record: @resource.record, resource: @resource, **last_crumb_args)
-      add_breadcrumb t("avo.edit").humanize
+      help_add_breadcrumb(last_crumb_args)
+    end
+
+    def help_add_breadcrumb(last_crumb_args)
+      if params[:controller] != "avo/bulk_update"
+        add_breadcrumb @resource.record_title, resource_path(record: @resource.record, resource: @resource, **last_crumb_args) if params[:controller] != "avo/bulk_update"
+        add_breadcrumb t("avo.edit").humanize
+      else
+        add_breadcrumb t("avo.bulk_edit")
+      end
     end
 
     def create_success_action

app/controllers/avo/bulk_update_controller.rb

@@ -0,0 +1,87 @@
+module Avo
+  class BulkUpdateController < ResourcesController
+    before_action :set_query, only: [:edit, :handle]
+
+    def edit
+      @resource.hydrate(record: @resource.model_class.new(bulk_values))
+
+      set_component_for :bulk_edit, fallback_view: :edit
+    end
+
+    def handle
+      saved = save_records
+
+      if saved
+        flash[:notice] = t("avo.bulk_update_success")
+      else
+        flash[:error] = t("avo.bulk_update_failure")
+      end
+
+      redirect_to after_bulk_update_path
+    end
+
+    private
+
+    def update_records
+      params_to_apply = params[@resource_name.downcase.to_sym].compact_blank || {}
+
+      @query.each do |record|
+        @resource.fill_record(record, params_to_apply)
+      end
+    end
+
+    def save_records
+      update_records
+
+      all_saved = true
+
+      ActiveRecord::Base.transaction do
+        @query.each do |record|
+          @record = record
+          save_record
+        end
+      rescue ActiveRecord::RecordInvalid => e
+        all_saved = false
+        puts "Failed to save #{record.id}: #{e.message}"
+        raise ActiveRecord::Rollback
+      end
+
+      all_saved
+    end
+
+    # This method returns a hash of the attributes of the model and their values
+    # If all the records have the same value for an attribute, the value is assigned to the attribute, otherwise nil is assigned
+    def bulk_values
+      @resource.model_class.attribute_names.map do |attribute_key|
+        values = @query.map { _1.public_send(attribute_key) }.uniq
+
+        [attribute_key, values.size == 1 ? values.first : nil]
+      end.to_h
+    end
+
+    def set_query
+      @query = if params[:query].present?
+        @resource.find_record(params[:query], params: params)
+      else
+        find_records_by_resource_ids
+      end
+    end
+
+    def find_records_by_resource_ids
+      resource_ids = params[:fields]&.dig(:avo_resource_ids)&.split(",") || []
+      decrypted_query || (resource_ids.any? ? @resource.find_record(resource_ids, params: params) : [])
+    end
+
+    def decrypted_query
+      encrypted_query = params[:fields]&.dig(:avo_selected_query) || params[:query]
+
+      return if encrypted_query.blank?
+
+      Avo::Services::EncryptionService.decrypt(message: encrypted_query, purpose: :select_all, serializer: Marshal)
+    end
+
+    def after_bulk_update_path
+      resources_path(resource: @resource)
+    end
+  end
+end

app/helpers/avo/url_helpers.rb

@@ -44,6 +44,14 @@ def edit_resource_path(resource:, record: nil, resource_id: nil, **args)
       avo.send :"edit_resources_#{resource.singular_route_key}_path", record || resource_id, **args
     end
 
+    def edit_bulk_update_path(resource_name:, id:, **args)
+      avo.send :edit_bulk_update_path, resource_name, id, **args
+    end
+
+    def handle_bulk_update_path(resource_name:, query:, **args)
+      avo.send :handle_bulk_update_path, resource_name, query, **args
+    end
+
     def resource_attach_path(resource, record_id, related_name, related_id = nil)
       helpers.avo.resources_associations_new_path(resource.singular_route_key, record_id, related_name)
     end

app/javascript/js/controllers/item_select_all_controller.js

@@ -71,6 +71,7 @@ export default class extends Controller {
     }
 
     this.updateLinks('resourceIds')
+    this.updateBulkEditLink('resourceIds')
   }
 
   selectAll(event) {
@@ -88,23 +89,43 @@ export default class extends Controller {
   }
 
   updateLinks(param) {
-    const actionButtons = document.querySelectorAll(`a[data-actions-picker-target][data-resource-name="${this.resourceName}"]`)
-    actionButtons.forEach((link) => {
+    this.updateActionLinks(param, '[data-target="actions-list"] > a')
+  }
+
+  updateBulkEditLink(param) {
+    this.updateActionLinks(param, 'a[href*="/admin/bulk_update/edit"]')
+  }
+
+  updateActionLinks(param, selector) {
+    const selectedResourcesArray = JSON.parse(this.element.dataset.selectedResources)
+    const selectedResources = selectedResourcesArray.join(',')
+    const selectedQuery = this.element.dataset.itemSelectAllSelectedAllQueryValue
+
+    document.querySelectorAll(selector).forEach((link) => {
       try {
         const url = new URL(link.href)
 
         Array.from(url.searchParams.keys())
           .filter((key) => key.startsWith('fields['))
           .forEach((key) => url.searchParams.delete(key))
 
+        const isBulkUpdate = url.pathname.includes('/admin/bulk_update/edit')
+        const resourceIdsKey = 'fields[avo_resource_ids]'
+        const selectedQueryKey = isBulkUpdate ? 'fields[avo_selected_query]' : 'fields[avo_index_query]'
+        const selectedAllKey = 'fields[avo_selected_all]'
+
         if (param === 'resourceIds') {
-          const resourceIds = JSON.parse(this.element.dataset.selectedResources).join(',')
-          url.searchParams.set('fields[avo_resource_ids]', resourceIds)
-          url.searchParams.set('fields[avo_selected_all]', 'false')
+          url.searchParams.set(resourceIdsKey, selectedResources)
+          url.searchParams.set(selectedAllKey, 'false')
         } else if (param === 'selectedQuery') {
-          const selectedQuery = this.element.dataset.itemSelectAllSelectedAllQueryValue
-          url.searchParams.set('fields[avo_index_query]', selectedQuery)
-          url.searchParams.set('fields[avo_selected_all]', 'true')
+          url.searchParams.set(selectedQueryKey, selectedQuery)
+          url.searchParams.set(selectedAllKey, 'true')
+        }
+
+        if (selectedResourcesArray.length >= 2  && isBulkUpdate) {
+          link.classList.remove('hidden')
+        } else {
+          link.classList.add('hidden')
         }
 
         link.href = url.toString()

config/routes.rb

@@ -4,6 +4,9 @@
   get "resources", to: redirect(Avo.configuration.root_path), as: :avo_resources_redirect
   get "dashboards", to: redirect(Avo.configuration.root_path), as: :avo_dashboards_redirect
 
+  get "/bulk_update/edit", to: "bulk_update#edit", as: "edit_bulk_update"
+  put "/bulk_update/handle", to: "bulk_update#handle", as: "handle_bulk_update"
+
   resources :media_library, only: [:index, :show, :update, :destroy], path: "media-library"
   get "attach-media", to: "media_library#attach"
 

lib/avo/concerns/has_controls.rb

@@ -21,7 +21,7 @@ def render_edit_controls
       end
 
       def render_index_controls(item:)
-        [BackButton.new, AttachButton.new(item: item), ActionsList.new(as_index_control: true), CreateButton.new(item: item)]
+        [BackButton.new, AttachButton.new(item: item), BulkEditButton.new, ActionsList.new(as_index_control: true), CreateButton.new(item: item)]
       end
 
       def render_row_controls(item:)

lib/avo/resources/controls/bulk_edit_button.rb

@@ -0,0 +1,17 @@
+module Avo
+  module Resources
+    module Controls
+      class BulkEditButton < BaseControl
+        def initialize(**args)
+          super(**args)
+
+          @label = args[:label] || I18n.t("avo.bulk_update").capitalize
+          @title = args[:title] || I18n.t("avo.bulk_update_items").humanize
+          @icon = args[:icon] || "avo/edit"
+          @style = args[:style] || :primary
+          @color = args[:color] || :primary
+        end
+      end
+    end
+  end
+end

lib/generators/avo/templates/locales/avo.ar.yml

@@ -22,6 +22,11 @@ ar:
     attachment_class_detached: "%{attachment_class} تم فصل"
     attachment_destroyed: تم حذف المرفق
     attachment_failed: فشل في إرفاق %{attachment_class}
+    bulk_edit: تحرير جماعي
+    bulk_update: تحديث جماعي
+    bulk_update_failure: فشل في تحديث السجلات.
+    bulk_update_no_records: لا يمكن تنفيذ التحديث الجماعي بدون سجلات.
+    bulk_update_success: تم تنفيذ العملية الجماعية بنجاح.
     cancel: إلغاء
     choose_a_country: اختر دولة
     choose_an_option: اختر خيارًا

lib/generators/avo/templates/locales/avo.de.yml

@@ -16,6 +16,11 @@ de:
     attachment_class_detached: "%{attachment_class} abgehängt."
     attachment_destroyed: Anhang gelöscht
     attachment_failed: "%{attachment_class} konnte nicht angehängt werden"
+    bulk_edit: Massenbearbeitung
+    bulk_update: Massenaktualisierung
+    bulk_update_failure: Aktualisierung der Datensätze fehlgeschlagen.
+    bulk_update_no_records: Bulk-Aktualisierung kann ohne Datensätze nicht durchgeführt werden.
+    bulk_update_success: Massenaktion erfolgreich ausgeführt.
     cancel: Abbrechen
     choose_a_country: Land auswählen
     choose_an_option: Option auswählen

lib/generators/avo/templates/locales/avo.en.yml

@@ -16,6 +16,11 @@ en:
     attachment_class_detached: "%{attachment_class} detached."
     attachment_destroyed: Attachment destroyed
     attachment_failed: Failed to attach %{attachment_class}
+    bulk_edit: Bulk edit
+    bulk_update: Bulk update
+    bulk_update_failure: Failed to update records.
+    bulk_update_no_records: Bulk update cannot be performed without records.
+    bulk_update_success: Bulk action run successfully.
     cancel: Cancel
     choose_a_country: Choose a country
     choose_an_option: Choose an option

lib/generators/avo/templates/locales/avo.es.yml

@@ -18,6 +18,11 @@ es:
     attachment_class_detached: "%{attachment_class} adjuntado/a."
     attachment_destroyed: Adjunto eliminado
     attachment_failed: No se pudo adjuntar %{attachment_class}
+    bulk_edit: Edición masiva
+    bulk_update: Actualización masiva
+    bulk_update_failure: Error al actualizar los registros.
+    bulk_update_no_records: La actualización masiva no se puede realizar sin registros.
+    bulk_update_success: Acción masiva ejecutada con éxito.
     cancel: Cancelar
     choose_a_country: Elige un país
     choose_an_option: Elige una opción

lib/generators/avo/templates/locales/avo.fr.yml

@@ -18,6 +18,11 @@ fr:
     attachment_class_detached: "%{attachment_class} détaché."
     attachment_destroyed: Pièce jointe détruite
     attachment_failed: Échec de l'ajout de %{attachment_class}
+    bulk_edit: Modification en masse
+    bulk_update: Mise à jour en masse
+    bulk_update_failure: Échec de la mise à jour des enregistrements.
+    bulk_update_no_records: La mise à jour en masse ne peut pas être effectuée sans enregistrements.
+    bulk_update_success: Action en masse exécutée avec succès.
     cancel: Annuler
     choose_a_country: Sélectionnez un pays
     choose_an_option: Sélectionnez une option

lib/generators/avo/templates/locales/avo.it.yml

@@ -16,6 +16,11 @@ it:
     attachment_class_detached: "%{attachment_class} staccato."
     attachment_destroyed: Allegato distrutto
     attachment_failed: Impossibile allegare %{attachment_class}
+    bulk_edit: Modifica di massa
+    bulk_update: Aggiornamento di massa
+    bulk_update_failure: Aggiornamento dei record fallito.
+    bulk_update_no_records: L'aggiornamento di massa non può essere eseguito senza record.
+    bulk_update_success: Azione di massa eseguita con successo.
     cancel: Annulla
     choose_a_country: Scegli un paese
     choose_an_option: Scegli un'opzione

lib/generators/avo/templates/locales/avo.ja.yml

@@ -18,6 +18,11 @@ ja:
     attachment_class_detached: "%{attachment_class}をデタッチしました。"
     attachment_destroyed: アタッチは削除されました
     attachment_failed: "%{attachment_class}の添付に失敗しました"
+    bulk_edit: 一括編集
+    bulk_update: 一括更新
+    bulk_update_failure: レコードの更新に失敗しました。
+    bulk_update_no_records: レコードがない場合、バルク更新を実行できません。
+    bulk_update_success: 一括処理が正常に実行されました。
     cancel: キャンセル
     choose_a_country: 国を選択
     choose_an_option: オプションを選択