Class: CommunicationsController

Inherits:
CrmController show all
Includes:
Controllers::Attachable, Controllers::Destroyable, Controllers::Showable, Controllers::Workflowable
Defined in:
app/controllers/communications_controller.rb

Constant Summary

Constants included from Controllers::Attachable

Controllers::Attachable::PUBLICATIONS_PER_PAGE

Constants included from Controllers::ReferenceFindable

Controllers::ReferenceFindable::ID_EMBEDDED_PATTERNS

Constants included from Controllers::AnalyticsEvents

Controllers::AnalyticsEvents::MAX_QUEUED_EVENTS, Controllers::AnalyticsEvents::SESSION_KEY

Constants included from Controllers::ErrorRendering

Controllers::ErrorRendering::NON_CONTENT_PATH_PREFIXES

Constants included from Www::SeoHelper

Www::SeoHelper::AWARDS, Www::SeoHelper::CA_ADDRESS, Www::SeoHelper::CA_BUSINESS_HOURS, Www::SeoHelper::CA_CONTACT_POINT, Www::SeoHelper::CA_CURRENCIES, Www::SeoHelper::CA_DESCRIPTION, Www::SeoHelper::CA_FOUNDING_DATE, Www::SeoHelper::CA_GLOBAL_LOCATION_NUMBER, Www::SeoHelper::CA_LEGAL_NAME, Www::SeoHelper::CA_LOCAL_BUSINESS, Www::SeoHelper::CA_ONLINE_STORE, Www::SeoHelper::CA_RETURN_POLICY, Www::SeoHelper::CA_SALES_DEPARTMENT, Www::SeoHelper::CA_SERVICE_AREA, Www::SeoHelper::CA_URL, Www::SeoHelper::CA_VAT_ID, Www::SeoHelper::CA_WAREHOUSE_DEPARTMENT, Www::SeoHelper::CA_WAREHOUSE_HOURS, Www::SeoHelper::COMPANY_EMAIL, Www::SeoHelper::COMPANY_LOGO, Www::SeoHelper::COMPANY_NAME, Www::SeoHelper::COMPANY_SLOGAN, Www::SeoHelper::EXPERTISE, Www::SeoHelper::FAX_NUMBER, Www::SeoHelper::GS1_COMPANY_PREFIX, Www::SeoHelper::ISO6523_CODE, Www::SeoHelper::PAYMENT_METHODS, Www::SeoHelper::PHONE_NUMBER, Www::SeoHelper::PRIMARY_NAICS, Www::SeoHelper::REFUND_TYPE, Www::SeoHelper::RETURN_FEES, Www::SeoHelper::RETURN_METHOD, Www::SeoHelper::RETURN_POLICY_CATEGORY, Www::SeoHelper::SECONDARY_NAICS, Www::SeoHelper::SOCIAL_PROFILES, Www::SeoHelper::US_ADDRESS, Www::SeoHelper::US_BUSINESS_HOURS, Www::SeoHelper::US_CONTACT_POINT, Www::SeoHelper::US_CURRENCIES, Www::SeoHelper::US_DESCRIPTION, Www::SeoHelper::US_FOUNDING_DATE, Www::SeoHelper::US_GLOBAL_LOCATION_NUMBER, Www::SeoHelper::US_IMAGE, Www::SeoHelper::US_LEGAL_NAME, Www::SeoHelper::US_LOCAL_BUSINESS, Www::SeoHelper::US_ONLINE_STORE, Www::SeoHelper::US_RETURN_POLICY, Www::SeoHelper::US_SALES_DEPARTMENT, Www::SeoHelper::US_SERVICE_AREA, Www::SeoHelper::US_TAX_ID, Www::SeoHelper::US_URL, Www::SeoHelper::US_WAREHOUSE_DEPARTMENT, Www::SeoHelper::US_WAREHOUSE_HOURS

Constants included from IconHelper

IconHelper::CUSTOM_ICON_MAP, IconHelper::CUSTOM_SVG_DIR, IconHelper::DEFAULT_FAMILY

Instance Method Summary collapse

Methods included from Controllers::Workflowable

#render_workflow_error_stream, #render_workflow_success_stream, #workflow_action, #workflow_action_complete

Methods included from Controllers::Showable

#perform_show

Methods included from Controllers::Destroyable

#destroy, #perform_destroy

Methods included from Controllers::Attachable

#attach, #publication_modal, #remove_attachment, #search_library

Methods inherited from CrmController

#access_denied, #context_id, #context_object, #crm_home_path, #current_ability, #default_url_options, #download_temp, #get_tempfile_path_for_download, #initialize_crm_lazy_chunks, #record_not_found, #redirect_to_job_or_fallback, #render_edit_action, #set_context, #set_download_path, #stash_file_for_temp_download

Methods inherited from ApplicationController

#account_impersonated?, #add_to_flash, #append_token, #bypass_forgery_protection?, #chat_enabled?, #cloudflare_cleared?, #default_catalog, #default_url_options, #enable_turbo_frames, #find_publication, #fix_invalid_accept_header, #init_js_utils, #is_globals_call?, #layout_by_resource, #locale_store, #redirect_to, #require_employee_for_crm, #set_base_host, #set_real_ip, #set_report_errors_for, #should_render_layout?, #stamp_impersonation_context, #warmlyyours_canada_ip?, #warmlyyours_ip?, #y

Methods included from Controllers::ReturnPathHandling

#check_for_return_path, #redirect_to_return_path_or_default

Methods included from Controllers::AnalyticsEvents

#consume_queued_analytics_events, #track_event

Methods included from Controllers::DeviceDetection

#device_detector, #is_ie?

Methods included from Controllers::SubdomainDetection

#is_crm_request?, #is_www_request?, #json_request?

Methods included from Controllers::TrackingDetection

#bot_request?, #gdpr_country?, #gdpr_country_data, #prevent_bots, #set_tracking_cookie, #track_visitor?

Methods included from Controllers::AcceleratedFileSending

#send_file_accelerated, #send_upload_accelerated

Methods included from Controllers::ErrorRendering

#excp_string, #mail_to_for_error_reporting, #render_400, #render_404, #render_406, #render_410, #render_500, #render_invalid_authenticity_token, #render_ip_spoof_error, #safe_referer_or_fallback

Methods included from Controllers::TurnstileVerification

#load_turnstile_script_tag, #turnstile_lazy_widget, #turnstile_script_tag, #turnstile_widget, #validate_turnstile!

Methods included from Controllers::CloudflareCaching

edge_cached, #edge_cached_action?, #reset_cloudflare_cache, #set_cloudflare_cache, #skip_session

Methods included from Controllers::Webpackable

#preload_webpack_fonts, #webpack_css_include, #webpack_css_url, #webpack_js_include, #wpd_is_running?

Methods included from Controllers::Localizable

#cloudflare_country_locale, #determine_request_locale, #geocoder_locale, #guest_user_locale_check, #locale_optional_www_auth_path?, #param_locale, #set_locale, #set_request_locale, #skip_localization?, #warmlyyours_ip_locale

Methods included from Controllers::Authenticable

#access_denied, #authenticate_account, #authenticate_account!, #authenticate_account_from_login_token!, #authenticate_account_from_token!, #check_is_a_manager, #check_is_a_sales_manager, #check_is_an_admin, #check_is_an_employee, #check_party, #clear_mismatched_guest_user, #create_guest_user, #credentials?, #current_or_guest_user, #current_or_guest_user_id_read_only, #current_user, #devise_mapping, #fully_logged_in?, #generate_bot_id, #guest_user, #identifiable?, #init_current_user, #initialize_guest, #load_context_user, #logging_in, #resource, #resource_name, #restrict_access_for_non_employees, #scrubbed_request_path, #user_object, #warn_on_session_guest_id_leak

Methods included from ApplicationHelper

#better_number_to_currency, #check_force_logout, #check_or_cross, #check_or_times, #error_messages, #general_disclaimer_on_product_installation_and_local_codes, #gridjs_from_html_table, #gridjs_table, #is_wy_ip, #line_break, #parent_layout, #pass_or_fail, #render_error_messages_list, #render_video_card, #resolved_auth_form_turbo_frame, #return_path_or, #safe_css_color, #set_return_path_if_present, #set_section_if_present, #tab_frame_id, #to_underscore, #track_page?, #turbo_section_wrapper, #turbo_tabs_request?, #url_on_same_domain_as_request, #widget_index_daily_focus_index_path, #working_hours?, #yes_or_no, #yes_or_no_highlighted, #yes_or_no_with_check_or_cross, #youtube_video

Methods included from UppyUploaderHelper

#file_uploader, #image_uploader, #large_file_uploader_s3, #lead_sketch_uploader, #rma_image_uploader, #rma_image_uploader_s3, #uppy_uploader, #video_uploader

Methods included from Www::ImagesHelper

#image_asset_tag, #image_asset_url

Methods included from Www::SeoHelper

#add_page_schema, #canada?, #company_social_links, #ensure_context_json, #json_ld_script_tag, #local_business_schema, #online_store_id, #online_store_schema, #page_main_entity, #page_main_entity_json, #render_auto_collection_page_schema, #render_collection_page_schema, #render_local_business_schema, #render_online_store_schema, #render_page_schemas, #render_page_video_schemas, #render_webpage_schema, #render_webpage_schema_with_collections, #usa?

Methods included from UrlsHelper

#catalog_breadcrumb_links, #catalog_link, #catalog_link_for_product_line, #catalog_link_for_sku, #cms_link, #delocalized_path, #path_to_sales_product_sku, #path_to_sales_product_sku_for_product_line, #path_to_sales_product_sku_for_product_line_slug, #product_line_from_catalog_link, #protocol_neutral_url, #sanitize_external_url, #valid_external_url?

Methods included from IconHelper

#account_nav_icon, #fa_icon, #star_rating_html

Instance Method Details

#address_book ⇒ Object 



240
241
242
243
244
245
246
247
 
# File 'app/controllers/communications_controller.rb', line 240

def address_book
  @communication = Communication.new(recipient_party_id: params[:party_id])
  resource = params[:resource_type].present? && params[:resource_id].present? ? params[:resource_type].constantize.find_by(id: params[:resource_id]) : nil
  @contact_points = contact_points_for_party_id(params[:party_id], resource:)
  respond_to do |format|
    format.turbo_stream
  end
end

#allowed_senders(communication) ⇒ Object 



285
286
287
288
289
290
291
292
293
294
295
296
297
 
# File 'app/controllers/communications_controller.rb', line 285

def allowed_senders(communication)
  list = []
  list << [communication.sender_party.full_name, communication.sender_party.id] if communication.sender_party
  if communication.recipient_party && sales_rep = begin
    communication.recipient_party.primary_sales_rep
  rescue StandardError
    nil
  end
    list << [sales_rep.full_name, sales_rep.id]
  end
  list << [current_user.full_name, current_user.id]
  list.uniq
end

#body ⇒ Object 



90
91
92
93
94
95
 
# File 'app/controllers/communications_controller.rb', line 90

def body
  @communication = Communication.find(params[:id])
  authorize! :read, @communication
  prepare_email_render(@communication)
  render template: "/communication_mailer/#{@communication.template_for_email}", layout: false
end

#contact_points_for_party_id(party_id, resource: nil) ⇒ Object 



268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
 
# File 'app/controllers/communications_controller.rb', line 268

def contact_points_for_party_id(party_id, resource: nil)
  if party_id.present? && (party = Party.find(party_id))
    party_ids = party.try(:customer).try(:all_my_active_party_ids) || [party.id]
    party_ids = Array(party_ids)

    # Include contact points from all SupportCase participants when resource is a SupportCase
    if resource.is_a?(SupportCase)
      participant_party_ids = resource.support_case_participants.with_party.pluck(:party_id)
      party_ids = (party_ids + participant_party_ids).compact.uniq
    end

    ContactPoint.transmittable.where(party_id: party_ids).order(Arel.sql("contact_points.party_id <> #{party_id}, contact_points.party_id, contact_points.category, contact_points.detail"))
  else
    ContactPoint.none
  end
end

#copy ⇒ Object 



97
98
99
100
101
102
103
104
105
106
107
108
109
110
 
# File 'app/controllers/communications_controller.rb', line 97

def copy
  old_com = Communication.find(params[:id])
  @communication = old_com.deep_dup
  @communication.resource_type = nil
  @communication.resource_id = nil
  authorize! :create, @communication
  if @communication.save
    flash[:info] = 'Communication copied successfully.'
    redirect_to_return_path_or_default edit_communication_path(@communication)
  else
    flash[:error] = "Could not copy communication: #{@communication.errors_to_s}"
    redirect_to_return_path_or_default old_com
  end
end

#create ⇒ Object 



62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'app/controllers/communications_controller.rb', line 62

def create
  @communication = Communication.new(communication_params)
  @communication.check_subscription_preferences = true
  authorize! :create, @communication
  @sender_party = @communication.sender_party || current_user
  if @communication.save
    handle_communication_action
    return_path = edit_communication_path(@communication) if params[:commit] == 'Apply'
  end
  respond_to do |format|
    format.html do
      if @communication.new_record?
        render action: :new, status: :unprocessable_entity
      else
        if @communication.resource
          return_path ||= begin
            polymorphic_path(@communication.resource)
          rescue StandardError
            nil
          end
        end
        return_path ||= communication_path(@communication)
        redirect_to_return_path_or_default return_path
      end
    end
  end
end

#edit ⇒ Object 



48
49
50
51
52
53
54
55
56
57
58
59
60
 
# File 'app/controllers/communications_controller.rb', line 48

def edit
  @communication = Communication.find(params[:id])
  unless @communication.can_be_edited?
    flash[:warning] = "This communication cannot be edited because it has already been #{@communication.state}."
    redirect_to @communication and return
  end
  # Populates the address book lookup
  @recipient_party = begin
    @communication.communication_recipients.first.contact_point.party
  rescue StandardError
    nil
  end
end

#email_preview ⇒ Object 



318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
 
# File 'app/controllers/communications_controller.rb', line 318

def email_preview
  @context_obj = params[:context].classify.constantize.where(id: params[:id]).first
  render(text: "Unable to find #{params[:context]} with id: #{params[:id]}") && return if @context_obj.nil?

  if params[:context] == 'email_template'
    cb = CommunicationBuilder.new(
      sender_party_id: params[:sender_party_id],
      recipient_party_id: params[:recipient_party_id],
      resource_id: params[:resource_id],
      resource_type: params[:resource_type],
      email_template: @context_obj,
      merge_options: { ignore_errors: params[:ignore_errors].to_b }
    )
    # Support preview_v4 param to preview v4 content before it's marked ready
    if params[:preview_v4].to_b && @context_obj.respond_to?(:render_body_v4) && @context_obj.body_v4_email.present?
      @email_message = @body = @context_obj.render_body_v4(cb.merge_options)
    else
      @email_message = @body = @context_obj.render_body(cb.merge_options) # body
    end
  else
    @email_message = @body = @context_obj.send(params[:method]) # body
  end
  @subject = @context_obj.subject if @context_obj.respond_to?(:subject)

  # For Redactor 4 preview, the body_v4_email is a complete HTML document
  # with inline styles - render it directly without any wrapping.
  # The HTML should have background: #ffffff baked into .email-content
  # (fixed at save time by JavaScript capture or model callback).
  if params[:preview_v4].to_b && @email_message.present?
    render html: @email_message.html_safe, layout: false
    return
  end

  # Use effective_css for Redactor 4 support (falls back to css for v3)
  @inline_stylesheet = if @context_obj.respond_to?(:effective_css)
                         @context_obj.effective_css
                       elsif @context_obj.respond_to?(:css)
                         @context_obj.css
                       end
  # Load external stylesheet - default to 'default' if not specified
  stylesheet = @context_obj.stylesheet if @context_obj.respond_to?(:stylesheet)
  stylesheet = 'default' if stylesheet.blank?
  @external_stylesheet = "emails/#{stylesheet}"

  # Use effective_template for Redactor 4 support:
  # - R4-ready templates return 'v4' which renders body directly (complete HTML document)
  # - Legacy templates return their configured template (simple, email, etc.)
  template_name = if @context_obj.respond_to?(:effective_template)
                    @context_obj.effective_template
                  elsif @context_obj.respond_to?(:template)
                    @context_obj.template
                  end

  if template_name.present?
    render "communication_mailer/#{template_name}", layout: false
  else
    render layout: false
  end
end

#events ⇒ Object 



192
193
194
 
# File 'app/controllers/communications_controller.rb', line 192

def events
  @communication = Communication.find(params[:id])
end

#index ⇒ Object 



20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'app/controllers/communications_controller.rb', line 20

def index
  @q = if context_object
           (context_object.try(:all_related_communications) || context_object.communications).ransack(params[:q])
         else
           Communication.ransack(params[:q])
         end
  @q.sorts = 'created_at desc' if @q.sorts.blank?

  # Eager load associations to avoid N+1 queries in communication_tree partial
  # countless skips the COUNT(*) query — table has 8M+ rows and exact totals are not needed
  @pagy, @communications = pagy(:countless, @q.result.includes(:uploads, :communication_recipients, :sender_party))

  # Preload CampaignDelivery resources with their campaign_email->campaign chain
  # to avoid N+1 when calling resource.to_s in the view
  preload_campaign_delivery_resources(@communications)
  @sender_filter_list = Employee.all.sorted
  @context_object = context_object
  respond_to do |format|
    format.html { render layout: should_render_layout? }
    format.turbo_stream
  end
end

#new ⇒ Object 



43
44
45
46
 
# File 'app/controllers/communications_controller.rb', line 43

def new
  @communication = CommunicationBuilder.new(params.merge(current_user: current_user, for_editor: true)).build
  @sender_party = @communication.sender_party || current_user
end

#reply ⇒ Object 



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
 
# File 'app/controllers/communications_controller.rb', line 125

def reply
  @communication = Communication.find(params[:id])
  # tracking_email = nil
  # tracking_email = @communication.tracking_email_address

  # Format sender email with name if available
  sender_formatted = if @communication.reply_to_full_name.present? && @communication.sender.present?
                       address = Mail::Address.new(@communication.sender)
                       address.display_name = @communication.reply_to_full_name
                       address.format
                     else
                       @communication.sender
                     end

  resource = resolve_reply_resource(@communication)
  comm_params = CommunicationBuilder.new(resource:,
                                         recipient_name: @communication.reply_to_full_name,
                                         skip_attachments: true,
                                         template: EmailTemplate.find_by(system_code: 'BLANK_REPLY')).to_params
  redirect_to new_communication_path(comm_params.merge(subject: "RE: #{@communication.subject}",
                                                       emails: sender_formatted,
                                                       cc: @communication.cc,
                                                       recipient_name: @communication.reply_to_full_name,
                                                       #  reply_to: tracking_email,
                                                       skip_attachments: true,
                                                       reply_to_parent_id: @communication.id))
end

#reply_all ⇒ Object 



153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
 
# File 'app/controllers/communications_controller.rb', line 153

def reply_all
  @communication = Communication.find(params[:id])

  # Collect all recipients for reply all:
  # - Original sender becomes primary recipient (TO)
  # - Original "to" recipients (excluding current user's email) go to CC
  # - Original CC recipients also stay in CC
  current_user_emails = current_user.contact_points.emails.pluck(:detail).map(&:downcase)

  # Build CC list from original TO and CC recipients, excluding current user
  # The Communication#to and #cc methods return formatted "Name <email>" strings
  cc_recipients = @communication.communication_recipients.reject do |cr|
    cr.email_method == 'bcc' || current_user_emails.include?(cr.detail&.downcase)
  end

  # Format recipients with names preserved
  cc_emails = cc_recipients.map do |cr|
    if cr.name.present?
      address = Mail::Address.new(cr.detail)
      address.display_name = cr.name
      address.format
    else
      cr.detail
    end
  end

  resource = resolve_reply_resource(@communication)
  comm_params = CommunicationBuilder.new(resource:,
                                         recipient_name: @communication.reply_to_full_name,
                                         skip_attachments: true,
                                         template: EmailTemplate.find_by(system_code: 'BLANK_REPLY')).to_params
  redirect_to new_communication_path(comm_params.merge(subject: "RE: #{@communication.subject}",
                                                       emails: @communication.sender,
                                                       cc: cc_emails.join(','),
                                                       recipient_name: @communication.reply_to_full_name,
                                                       skip_attachments: true,
                                                       reply_to_parent_id: @communication.id))
end

#resend ⇒ Object 



299
300
301
302
303
 
# File 'app/controllers/communications_controller.rb', line 299

def resend
  @communication = Communication.find(params[:id])
  @communication.resend
  redirect_to @communication
end

#resend_email ⇒ Object 



112
113
114
115
116
117
118
119
120
121
122
123
 
# File 'app/controllers/communications_controller.rb', line 112

def resend_email
  # This should only be for outbound emails
  old_com = Communication.direction_outbound.find(params[:id])
  @communication = old_com.deep_dup
  authorize! :create, @communication
  if @communication.save
    redirect_to_return_path_or_default edit_communication_path(@communication)
  else
    flash[:error] = "Could not copy communication: #{@communication.errors_to_s}"
    redirect_to_return_path_or_default old_com
  end
end

#resources ⇒ Object

Pulls a list of resources for activities form



306
307
308
309
310
311
312
313
314
315
316
 
# File 'app/controllers/communications_controller.rb', line 306

def resources
  @communication = Communication.find(params[:communication_id]) if params[:communication_id].present?
  @party = @communication&.recipient_party
  @party ||= Party.find(params[:party_id]) if params[:party_id].present?
  if @party.respond_to?(:resources_for_select)
    results = @party.resources_for_select(page: params[:page],
                                          query: params[:q])
  end
  results ||= {}
  render json: results
end

#send_now ⇒ Object 



230
231
232
233
234
235
236
237
238
 
# File 'app/controllers/communications_controller.rb', line 230

def send_now
  @communication = Communication.find(params[:id])
  @communication.check_subscription_preferences = true
  if @communication.release
    redirect_to @communication
  else
    render action: :edit, status: :unprocessable_entity
  end
end

#show ⇒ Object 



9
10
11
12
13
14
15
16
17
18
 
# File 'app/controllers/communications_controller.rb', line 9

def show
  @communication = Communication.find(params[:id])
  @email_preview_html = build_email_preview_html(@communication)
  @thread_communications = load_thread_communications(@communication)
  respond_to do |format|
    format.html
    format.xml { head :ok }
    format.json { head :no_content }
  end
end

#template ⇒ Object 



249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
 
# File 'app/controllers/communications_controller.rb', line 249

def template
  # Instatiate a communication with for_editor: true to use body_v4 (editable content)
  options = params.merge(current_user: current_user, for_editor: true)
  if params[:communication_id] and existing_communication = Communication.where(id: params[:communication_id]).first and existing_communication.template_merge_options
    options[:merge_options] ||= {}
    options[:merge_options] = options[:merge_options].merge(existing_communication.template_merge_options)
  end
  @communication = CommunicationBuilder.new(options).build
  render json: {
    subject: @communication.subject,
    body: @communication.body,
    css: @communication&.email_template&.effective_css,
    redactor_4_ready: @communication&.email_template&.redactor_4_ready?
  }
rescue StandardError => e
  Rails.logger.error "Error loading template: #{e.message}\n#{e.backtrace.first(5).join("\n")}"
  render json: { error: e.message }, status: :unprocessable_entity
end

#update ⇒ Object 



196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
 
# File 'app/controllers/communications_controller.rb', line 196

def update
  @communication = Communication.find(params[:id])
  @communication.check_subscription_preferences = true
  unless @communication.can_be_edited?
    flash[:warning] = "This communication cannot be edited because it has already been #{@communication.state}."
    redirect_to @communication and return
  end
  if @communication.update(communication_params)
    handle_communication_action
    return_path = edit_communication_path(@communication) if params[:commit] == 'Apply'
  end
  respond_to do |format|
    format.html do
      # Send button can succeed at validation but still fail to actually
      # release/queue (left in draft or suppressed). Treat that as a Hotwire
      # validation failure so the editor stays on screen.
      send_failed = params[:button] == 'send' && (@communication.draft? || @communication.suppressed?)
      if @communication.errors.present? || send_failed
        # Promote any flash[:error] set by handle_communication_flash into
        # flash.now so it shows on the re-rendered edit form (a redirect
        # won't happen).
        if flash[:error].present?
          flash.now[:error] = flash[:error]
          flash.delete(:error)
        end
        render action: :edit, status: :unprocessable_entity
      else
        return_path ||= communication_path(@communication)
        redirect_to_return_path_or_default(return_path)
      end
    end
  end
end