lato_cms 3.0.13 → 3.1.1

data/app/views/lato_cms/pages/fields/_image.html.erb

@@ -1,68 +1,4 @@
-<% label = field_config['name'] || field_id.humanize %>
-<% required = field_config['required'] == true %>
-<% settings = field_config['settings'] || {} %>
-<% accept = settings['accept'] || 'image/*' %>
-<% current_file = page_field&.files&.attached? ? page_field.files.first : nil %>
-<% files_input_name = lato_cms_field_input_name(field_id, 'files', input_name_prefix: local_assigns[:input_name_prefix], multiple: true) %>
-<% remove_input_name = lato_cms_field_input_name(field_id, 'remove_file_ids', input_name_prefix: local_assigns[:input_name_prefix], multiple: true) %>
-<% input_id = lato_cms_field_dom_id(field_id, 'files', dom_id_prefix: local_assigns[:dom_id_prefix]) %>
-
-<label class="form-label">
-  <%= label %><%= ' *' if required %>
-</label>
-
-<div data-controller="lato-cms-image-field"
-     data-field-id="<%= field_id %>"
-     data-field-required="<%= required %>"
-     data-new-badge-label="<%= t('lato_cms.field_image_new_badge') %>"
-     data-remove-label="<%= t('lato_cms.field_image_remove') %>"
-     data-remove-pending-label="<%= t('lato_cms.field_image_remove_pending') %>"
-     data-undo-label="<%= t('lato_cms.field_file_remove_undo') %>">
-  <% if current_file %>
-    <div class="lato-cms-file-field__item lato-cms-image-field__item" data-lato-cms-image-field-target="currentContainer" data-attachment-id="<%= current_file.id %>">
-      <div class="lato-cms-image-field__preview">
-        <img src="<%= lato_cms_attachment_path(current_file) %>" class="lato-cms-image-field__thumb" data-lato-cms-image-field-target="currentImage" alt="<%= current_file.filename %>">
-      </div>
-      <div class="lato-cms-file-field__info">
-        <i class="bi bi-image"></i>
-        <span><%= current_file.blob.filename %></span>
-        <span class="text-muted small">(<%= number_to_human_size(current_file.blob.byte_size) %>)</span>
-      </div>
-      <button type="button" class="lato-cms-attachment-field__remove" title="<%= t('lato_cms.field_image_remove') %>" aria-label="<%= t('lato_cms.field_image_remove') %>" data-action="lato-cms-image-field#remove">
-        <i class="bi bi-trash"></i>
-      </button>
-      <div class="lato-cms-file-field__removed d-none" data-lato-cms-image-field-target="removedNotice">
-        <span class="text-danger small">
-          <i class="bi bi-trash me-1"></i><%= t('lato_cms.field_image_remove_pending') %>
-        </span>
-        <button type="button" class="btn btn-link btn-sm p-0" data-action="lato-cms-image-field#undo">
-          <%= t('lato_cms.field_file_remove_undo') %>
-        </button>
-      </div>
-    </div>
-  <% end %>
-
-  <div class="lato-cms-file-field__item lato-cms-file-field__item--new lato-cms-image-field__item d-none" data-lato-cms-image-field-target="newPreviewContainer">
-    <div class="lato-cms-image-field__preview">
-      <img src="" class="lato-cms-image-field__thumb" data-lato-cms-image-field-target="newPreview" alt="">
-    </div>
-    <div class="lato-cms-file-field__info">
-      <i class="bi bi-image"></i>
-      <span data-lato-cms-image-field-target="newPreviewName"></span>
-      <span class="text-muted small" data-lato-cms-image-field-target="newPreviewSize"></span>
-      <span class="badge bg-success"><%= t('lato_cms.field_image_new_badge') %></span>
-    </div>
-    <button type="button" class="lato-cms-attachment-field__remove" title="<%= t('lato_cms.field_image_remove') %>" aria-label="<%= t('lato_cms.field_image_remove') %>" data-action="lato-cms-image-field#removeNew">
-      <i class="bi bi-trash"></i>
-    </button>
-  </div>
-
-  <input type="file"
-    class="form-control"
-    name="<%= files_input_name %>"
-    id="<%= input_id %>"
-    accept="<%= accept %>"
-    data-lato-cms-image-field-target="input"
-    data-action="change->lato-cms-image-field#preview"
-    <%= 'required' if required && !current_file %>>
-</div>
+<%= render partial: 'lato_cms/pages/fields/media_field', locals: {
+  field_id: field_id, field_config: field_config, page_field: page_field, kind: 'image', multiple: false,
+  input_name_prefix: local_assigns[:input_name_prefix], dom_id_prefix: local_assigns[:dom_id_prefix]
+} %>

data/app/views/lato_cms/pages/fields/_media_field.html.erb

@@ -0,0 +1,62 @@
+<%# Shared markup for image/video/file/gallery fields. Rendered by the 4
+    type-specific partials with `kind` ('image'/'video'/'file') and `multiple`
+    locals — differences between them are otherwise just presentation. %>
+<% label = field_config['name'] || field_id.humanize %>
+<% required = field_config['required'] == true %>
+<% current_media = page_field ? page_field.media.to_a : [] %>
+<% dom_id = lato_cms_field_dom_id(field_id, 'media_picker', dom_id_prefix: local_assigns[:dom_id_prefix]) %>
+<% frame_id = "media_picker_#{dom_id}" %>
+<% hidden_name = multiple ?
+     lato_cms_field_input_name(field_id, 'media_ids', input_name_prefix: local_assigns[:input_name_prefix], multiple: true) :
+     lato_cms_field_input_name(field_id, 'media_id', input_name_prefix: local_assigns[:input_name_prefix]) %>
+<% picker_type = kind == 'file' ? nil : kind %>
+
+<label class="form-label">
+  <%= label %><%= ' *' if required %>
+</label>
+
+<div data-controller="lato-cms-media-field<%= ' lato-cms-media-reorder' if multiple %>"
+     data-lato-cms-media-field-kind-value="<%= kind %>"
+     data-lato-cms-media-field-multiple-value="<%= multiple %>"
+     data-lato-cms-media-field-frame-id-value="<%= frame_id %>"
+     data-lato-cms-media-field-hidden-name-value="<%= hidden_name %>"
+     data-lato-cms-media-field-field-id-value="<%= field_id %>"
+     data-field-required="<%= required %>">
+
+  <div class="lato-cms-media-field__grid mb-2"
+       data-lato-cms-media-field-target="grid"
+       data-lato-cms-media-reorder-target="grid"
+       <% if multiple %>data-action="dragover->lato-cms-media-reorder#onGridDragOver drop->lato-cms-media-reorder#onGridDrop"<% end %>>
+    <% current_media.each do |m| %>
+      <%= render partial: 'lato_cms/pages/fields/media_item', locals: { media: m, kind: kind, hidden_name: hidden_name, multiple: multiple } %>
+    <% end %>
+
+    <%# The empty state AND the "add more" affordance for multi-value fields —
+        a single dashed tile living inside the grid, hidden (not removed) for
+        single-value fields once something is selected, so the field-side JS
+        only ever has to toggle a class rather than rebuild this node. %>
+    <%# Deliberately NOT using the shared `lato-action` trigger convention here:
+        it opens frames by hoping Turbo's own click handling notices a
+        just-inserted <turbo-frame> before driving a full-page visit, which
+        loses that race for this link. `openPicker` below prevents the
+        default navigation itself and sets the frame's `src` explicitly
+        (Turbo's documented, non-racy way to trigger a frame-scoped fetch). %>
+    <%= link_to lato_cms.media_picker_action_path(frame_id: frame_id, multiple: multiple, type: picker_type),
+          class: "lato-cms-media-field__tile lato-cms-media-field__tile--add#{' d-none' if !multiple && current_media.any?}",
+          data: {
+            lato_cms_media_field_target: 'addTile',
+            action: 'click->lato-cms-media-field#openPicker',
+            action_title: t('lato_cms.media_picker_title'), action_size: 'lg'
+          } do %>
+      <i class="bi bi-images"></i>
+      <span><%= t('lato_cms.media_choose_from_library') %></span>
+    <% end %>
+  </div>
+
+  <%# Real-but-hidden input anchors the browser's native required-validation
+      bubble (a display:none required input fails silently as "not
+      focusable"). Kept in sync with selection state by the Stimulus controller. %>
+  <input type="text" class="visually-hidden" value="<%= current_media.first&.id %>"
+    data-lato-cms-media-field-target="validationAnchor"
+    <%= 'required' if required && current_media.empty? %>>
+</div>

data/app/views/lato_cms/pages/fields/_media_item.html.erb

@@ -0,0 +1,27 @@
+<div class="lato-cms-media-field__tile lato-cms-media-field__item"
+     data-media-id="<%= media.id %>"
+     data-lato-cms-media-field-target="item"
+     <% if multiple %>
+       data-lato-cms-media-reorder-target="item"
+       draggable="true"
+       data-action="dragstart->lato-cms-media-reorder#onDragStart dragend->lato-cms-media-reorder#onDragEnd"
+     <% end %>>
+  <% if kind == 'video' %>
+    <video muted preload="metadata" class="lato-cms-media-field__player" src="<%= media.url %>"></video>
+    <i class="bi bi-play-circle-fill lato-cms-media-field__badge"></i>
+  <% elsif media.thumbnail_url %>
+    <img src="<%= media.thumbnail_url %>" class="lato-cms-media-field__thumb" alt="<%= media.alt_text %>">
+  <% else %>
+    <div class="lato-cms-media-field__icon"><i class="bi bi-paperclip"></i></div>
+  <% end %>
+
+  <div class="lato-cms-media-field__overlay">
+    <span class="lato-cms-media-field__name"><%= media.name %></span>
+  </div>
+
+  <button type="button" class="lato-cms-media-field__remove" title="<%= t('lato_cms.field_file_remove') %>" aria-label="<%= t('lato_cms.field_file_remove') %>" data-action="lato-cms-media-field#remove">
+    <i class="bi bi-x-lg"></i>
+  </button>
+
+  <input type="hidden" name="<%= hidden_name %>" value="<%= media.id %>" data-lato-cms-media-field-target="hiddenInput">
+</div>

data/app/views/lato_cms/pages/fields/_video.html.erb

@@ -1,69 +1,4 @@
-<% label = field_config['name'] || field_id.humanize %>
-<% required = field_config['required'] == true %>
-<% settings = field_config['settings'] || {} %>
-<% accept = settings['accept'] || 'video/*' %>
-<% current_file = page_field&.video_attachment %>
-<% poster_file = page_field&.poster_attachment %>
-<% files_input_name = lato_cms_field_input_name(field_id, 'files', input_name_prefix: local_assigns[:input_name_prefix], multiple: true) %>
-<% remove_input_name = lato_cms_field_input_name(field_id, 'remove_file_ids', input_name_prefix: local_assigns[:input_name_prefix], multiple: true) %>
-<% input_id = lato_cms_field_dom_id(field_id, 'files', dom_id_prefix: local_assigns[:dom_id_prefix]) %>
-
-<label class="form-label">
-  <%= label %><%= ' *' if required %>
-</label>
-
-<div data-controller="lato-cms-video-field"
-     data-field-id="<%= field_id %>"
-     data-field-required="<%= required %>"
-     data-new-badge-label="<%= t('lato_cms.field_video_new_badge') %>"
-     data-remove-label="<%= t('lato_cms.field_video_remove') %>"
-     data-remove-pending-label="<%= t('lato_cms.field_video_remove_pending') %>"
-     data-undo-label="<%= t('lato_cms.field_file_remove_undo') %>">
-  <% if current_file %>
-    <div class="lato-cms-file-field__item lato-cms-video-field__item" data-lato-cms-video-field-target="currentContainer" data-attachment-id="<%= current_file.id %>">
-      <div class="lato-cms-video-field__preview">
-        <video controls preload="metadata" class="lato-cms-video-field__player" src="<%= lato_cms_attachment_path(current_file) %>" <% if poster_file %>poster="<%= lato_cms_attachment_path(poster_file) %>"<% end %> data-lato-cms-video-field-target="currentVideo"></video>
-      </div>
-      <div class="lato-cms-file-field__info">
-        <i class="bi bi-film"></i>
-        <span><%= current_file.blob.filename %></span>
-        <span class="text-muted small">(<%= number_to_human_size(current_file.blob.byte_size) %>)</span>
-      </div>
-      <button type="button" class="lato-cms-attachment-field__remove" title="<%= t('lato_cms.field_video_remove') %>" aria-label="<%= t('lato_cms.field_video_remove') %>" data-action="lato-cms-video-field#remove">
-        <i class="bi bi-trash"></i>
-      </button>
-      <div class="lato-cms-file-field__removed d-none" data-lato-cms-video-field-target="removedNotice">
-        <span class="text-danger small">
-          <i class="bi bi-trash me-1"></i><%= t('lato_cms.field_video_remove_pending') %>
-        </span>
-        <button type="button" class="btn btn-link btn-sm p-0" data-action="lato-cms-video-field#undo">
-          <%= t('lato_cms.field_file_remove_undo') %>
-        </button>
-      </div>
-    </div>
-  <% end %>
-
-  <div class="lato-cms-file-field__item lato-cms-file-field__item--new lato-cms-video-field__item d-none" data-lato-cms-video-field-target="newPreviewContainer">
-    <div class="lato-cms-video-field__preview">
-      <video controls preload="metadata" class="lato-cms-video-field__player" data-lato-cms-video-field-target="newPreview"></video>
-    </div>
-    <div class="lato-cms-file-field__info">
-      <i class="bi bi-film"></i>
-      <span data-lato-cms-video-field-target="newPreviewName"></span>
-      <span class="text-muted small" data-lato-cms-video-field-target="newPreviewSize"></span>
-      <span class="badge bg-success"><%= t('lato_cms.field_video_new_badge') %></span>
-    </div>
-    <button type="button" class="lato-cms-attachment-field__remove" title="<%= t('lato_cms.field_video_remove') %>" aria-label="<%= t('lato_cms.field_video_remove') %>" data-action="lato-cms-video-field#removeNew">
-      <i class="bi bi-trash"></i>
-    </button>
-  </div>
-
-  <input type="file"
-    class="form-control"
-    name="<%= files_input_name %>"
-    id="<%= input_id %>"
-    accept="<%= accept %>"
-    data-lato-cms-video-field-target="input"
-    data-action="change->lato-cms-video-field#preview"
-    <%= 'required' if required && !current_file %>>
-</div>
+<%= render partial: 'lato_cms/pages/fields/media_field', locals: {
+  field_id: field_id, field_config: field_config, page_field: page_field, kind: 'video', multiple: false,
+  input_name_prefix: local_assigns[:input_name_prefix], dom_id_prefix: local_assigns[:dom_id_prefix]
+} %>

data/app/views/lato_cms/pages/index.html.erb

@@ -10,6 +10,23 @@
         <%= locale_to_flag(locale) %> <%= locale.to_s.upcase %>
       <% end %>
     <% end %>
+
+    <div class="dropdown ms-auto" title="<%= t('lato_cms.cta_actions') %>" data-controller="lato-tooltip">
+      <button type="button" class="btn btn-sm btn-outline-secondary dropdown-toggle" data-bs-toggle="dropdown">
+        <i class="bi bi-three-dots"></i>
+      </button>
+      <ul class="dropdown-menu dropdown-menu-end">
+        <li>
+          <%= link_to t('lato_cms.sitemap_export_cta'), lato_cms.pages_sitemap_export_action_path, class: 'dropdown-item',
+            data: {
+              lato_action_target: 'trigger',
+              turbo_method: :post,
+              turbo_frame: 'lato_operation',
+              action_title: t('lato_cms.sitemap_export_title')
+            } %>
+        </li>
+      </ul>
+    </div>
   </div>
   <div class="card-body">
     <%= lato_index @pages,

data/app/views/lato_cms/pages/show.html.erb

@@ -70,7 +70,8 @@
     </div>
 
     <%# ── Editor column ──────────────────────────────────────────────────── %>
-    <div class="col-12 col-lg-6 mb-4 lato-cms-advanced-editor__editor-col" data-lato-cms-advanced-editor-target="editorCol">
+    <div class="col-12 col-lg-6 mb-4 lato-cms-advanced-editor__editor-col" data-lato-cms-advanced-editor-target="editorCol"
+         data-controller="lato-cms-reload-on-modal-close">
       <div class="card h-100">
         <div class="card-header d-flex justify-content-between align-items-center">
           <h2 class="fs-5 mb-0"><%= t('lato_cms.show_editor_title') %></h2>

data/config/locales/en.yml

@@ -33,6 +33,10 @@ en:
     form_template_unavailable: "The template \"%{template_id}\" is no longer available. Please select a different template."
     action_view_frontend: View
     cta_actions: Actions
+    sitemap_export_cta: Export sitemap (CSV)
+    sitemap_export_title: Sitemap CSV export
+    sitemap_export_message: "%{count} pages exported"
+    sitemap_export_failed: Failed to start sitemap export
     translations_title: Translations
     translation_no_other_locales: No other locales are configured.
     translation_link_cta: Link
@@ -70,8 +74,12 @@ en:
     component_clone_cta: Clone
     component_clone_from: "Clone from %{lang}"
     component_clone_confirm: "Replace this component's fields with the ones from the %{lang} page?"
+    component_clone_translate_from: "Clone & translate from %{lang}"
+    component_clone_translate_confirm: "Replace this component's fields with translated copies from the %{lang} page?"
     component_cloned: Component cloned successfully
     component_clone_failed: Failed to clone component
+    component_clone_translate_failed: Fields were cloned, but failed to start translation
+    component_clone_translated: Fields translated successfully
     component_state_saving: Updating...
     component_state_saved: State updated
     component_state_save_error: Failed to update state
@@ -86,19 +94,35 @@ en:
     fields_component_missing_alert_html: "Component <strong>%{component_id}</strong> not found. The component configuration may have been removed."
     fields_previously_saved_data: "Previously saved data:"
     field_file_remove: Remove
-    field_file_remove_pending: File will be removed on save
-    field_file_remove_undo: Undo
-    field_file_new_badge: New
-    field_gallery_empty: No images yet. Add images below.
-    field_gallery_add_images: Add images
-    field_gallery_drag_to_reorder: Drag to reorder
-    field_image_remove: Remove
-    field_image_remove_pending: Image will be removed on save
-    field_image_new_badge: New
-    field_video_remove: Remove
-    field_video_remove_pending: Video will be removed on save
-    field_video_new_badge: New
     field_multiselect_hint: Hold Ctrl/Cmd to select multiple
+    media_index_title: Media
+    media_create_title: Upload media
+    media_create_cta: Upload
+    media_update_title: Edit media
+    media_alt_text: Alt text
+    media_alt_text_regenerate: Regenerate with AI
+    media_alt_text_regenerate_confirm: "This will overwrite the current alt text in every language with a new AI-generated one. Continue?"
+    media_alt_text_regenerated: Alt text regenerated
+    media_alt_text_regenerate_unavailable: Alt text can only be regenerated for images, and only when an LLM is configured
+    media_alt_text_regenerate_failed: Failed to start alt text regeneration
+    media_created: Media uploaded successfully
+    media_updated: Media updated successfully
+    media_deleted: Media deleted successfully
+    media_delete_in_use: "Cannot delete: used in %{count} place(s)"
+    media_delete_failed: Failed to delete media
+    media_choose_from_library: Choose from library
+    media_picker_title: Media library
+    media_picker_tab_browse: Browse library
+    media_picker_tab_upload: Upload new
+    media_picker_empty: No media found.
+    media_picker_confirm: Confirm selection
+    media_picker_selected_label: selected
+    media_search_placeholder: Search media...
+    media_upload_cta: Upload
+    media_type_all: All
+    media_type_image: Images
+    media_type_video: Videos
+    media_type_file: Files
     field_select_placeholder: "-- Select --"
     field_text_toolbar_bold: Bold
     field_text_toolbar_italic: Italic

data/config/locales/it.yml

@@ -33,6 +33,10 @@ it:
     form_template_unavailable: "Il template \"%{template_id}\" non e piu disponibile. Seleziona un template diverso."
     action_view_frontend: Anteprima
     cta_actions: Azioni
+    sitemap_export_cta: Esporta sitemap (CSV)
+    sitemap_export_title: Esportazione sitemap CSV
+    sitemap_export_message: "%{count} pagine esportate"
+    sitemap_export_failed: Impossibile avviare l'esportazione della sitemap
     translations_title: Traduzioni
     translation_no_other_locales: Nessuna altra lingua configurata.
     translation_link_cta: Collega
@@ -70,8 +74,12 @@ it:
     component_clone_cta: Clona
     component_clone_from: "Clona da %{lang}"
     component_clone_confirm: "Sostituire i campi di questa componente con quelli della pagina in %{lang}?"
+    component_clone_translate_from: "Clona e traduci da %{lang}"
+    component_clone_translate_confirm: "Sostituire i campi di questa componente con copie tradotte dalla pagina in %{lang}?"
     component_cloned: Componente clonata con successo
     component_clone_failed: Impossibile clonare la componente
+    component_clone_translate_failed: I campi sono stati clonati, ma non è stato possibile avviare la traduzione
+    component_clone_translated: Campi tradotti con successo
     component_state_saving: Aggiornamento in corso...
     component_state_saved: Stato aggiornato
     component_state_save_error: Errore durante aggiornamento stato
@@ -86,19 +94,35 @@ it:
     fields_component_missing_alert_html: "Componente <strong>%{component_id}</strong> non trovato. La configurazione del componente potrebbe essere stata rimossa."
     fields_previously_saved_data: "Dati salvati in precedenza:"
     field_file_remove: Rimuovi
-    field_file_remove_pending: Il file verra rimosso al salvataggio
-    field_file_remove_undo: Annulla
-    field_file_new_badge: Nuovo
-    field_gallery_empty: Nessuna immagine presente. Aggiungi immagini qui sotto.
-    field_gallery_add_images: Aggiungi immagini
-    field_gallery_drag_to_reorder: Trascina per riordinare
-    field_image_remove: Rimuovi
-    field_image_remove_pending: L'immagine verra rimossa al salvataggio
-    field_image_new_badge: Nuovo
-    field_video_remove: Rimuovi
-    field_video_remove_pending: Il video verra rimosso al salvataggio
-    field_video_new_badge: Nuovo
     field_multiselect_hint: Tieni premuto Ctrl/Cmd per selezionare piu opzioni
+    media_index_title: Media
+    media_create_title: Carica media
+    media_create_cta: Carica
+    media_update_title: Modifica media
+    media_alt_text: Testo alternativo
+    media_alt_text_regenerate: Rigenera con AI
+    media_alt_text_regenerate_confirm: "Il testo alternativo attuale in ogni lingua verrà sostituito con uno generato dall'AI. Continuare?"
+    media_alt_text_regenerated: Testo alternativo rigenerato
+    media_alt_text_regenerate_unavailable: Il testo alternativo può essere rigenerato solo per le immagini e solo se è configurato un LLM
+    media_alt_text_regenerate_failed: Impossibile avviare la rigenerazione del testo alternativo
+    media_created: Media caricato con successo
+    media_updated: Media aggiornato con successo
+    media_deleted: Media eliminato con successo
+    media_delete_in_use: "Impossibile eliminare: usato in %{count} punto/i"
+    media_delete_failed: Impossibile eliminare il media
+    media_choose_from_library: Scegli dalla libreria
+    media_picker_title: Libreria media
+    media_picker_tab_browse: Sfoglia libreria
+    media_picker_tab_upload: Carica nuovo
+    media_picker_empty: Nessun media trovato.
+    media_picker_confirm: Conferma selezione
+    media_picker_selected_label: selezionati
+    media_search_placeholder: Cerca media...
+    media_upload_cta: Carica
+    media_type_all: Tutti
+    media_type_image: Immagini
+    media_type_video: Video
+    media_type_file: File
     field_select_placeholder: "-- Seleziona --"
     field_text_toolbar_bold: Grassetto
     field_text_toolbar_italic: Corsivo

data/config/routes.rb

@@ -10,6 +10,7 @@ LatoCms::Engine.routes.draw do
 
   scope :pages do
     get '', to: 'pages#index', as: :pages
+    post 'sitemap-export', to: 'pages#sitemap_export_action', as: :pages_sitemap_export_action
     get 'create', to: 'pages#create', as: :pages_create
     post 'create', to: 'pages#create_action', as: :pages_create_action
     get ':id', to: 'pages#show', as: :pages_show
@@ -23,4 +24,15 @@ LatoCms::Engine.routes.draw do
     delete ':id/translations', to: 'pages#unlink_translation_action', as: :pages_unlink_translation_action
     delete ':id', to: 'pages#destroy_action', as: :pages_destroy_action
   end
+
+  scope :media do
+    get '', to: 'media#index', as: :media
+    get 'picker', to: 'media#picker_action', as: :media_picker_action
+    get 'create', to: 'media#create', as: :media_create
+    post 'create', to: 'media#create_action', as: :media_create_action
+    get ':id/update', to: 'media#update', as: :media_update
+    patch ':id/update', to: 'media#update_action', as: :media_update_action
+    post ':id/regenerate-alt-text', to: 'media#regenerate_alt_text_action', as: :media_regenerate_alt_text_action
+    delete ':id', to: 'media#destroy_action', as: :media_destroy_action
+  end
 end

data/db/migrate/20260728175413_create_lato_cms_media.rb

@@ -0,0 +1,11 @@
+class CreateLatoCmsMedia < ActiveRecord::Migration[8.1]
+  def change
+    create_table :lato_cms_media do |t|
+      t.string :name, null: false
+      t.string :alt_text
+      t.string :media_type, null: false, default: 'file'
+      t.timestamps
+    end
+    add_index :lato_cms_media, :media_type
+  end
+end

data/db/migrate/20260728175414_create_lato_cms_page_field_media.rb

@@ -0,0 +1,12 @@
+class CreateLatoCmsPageFieldMedia < ActiveRecord::Migration[8.1]
+  def change
+    create_table :lato_cms_page_field_media do |t|
+      t.references :page_field, null: false, foreign_key: { to_table: :lato_cms_page_fields }
+      t.references :media, null: false, foreign_key: { to_table: :lato_cms_media }
+      t.integer :position, null: false, default: 0
+      t.timestamps
+    end
+    add_index :lato_cms_page_field_media, [:page_field_id, :media_id], unique: true
+    add_index :lato_cms_page_field_media, [:page_field_id, :position]
+  end
+end

data/db/migrate/20260729120000_change_lato_cms_media_alt_text_to_translations.rb

@@ -0,0 +1,25 @@
+class ChangeLatoCmsMediaAltTextToTranslations < ActiveRecord::Migration[8.1]
+  class MigrationMedia < ActiveRecord::Base
+    self.table_name = 'lato_cms_media'
+  end
+
+  def up
+    change_column :lato_cms_media, :alt_text, :text
+    MigrationMedia.reset_column_information
+
+    locale = (LatoCms.config.locales.first || :en).to_s
+    MigrationMedia.where.not(alt_text: [nil, '']).find_each do |media|
+      media.update_column(:alt_text, { locale => media.alt_text }.to_json)
+    end
+  end
+
+  def down
+    MigrationMedia.reset_column_information
+
+    MigrationMedia.find_each do |media|
+      translations = JSON.parse(media.alt_text.presence || '{}') rescue {}
+      media.update_column(:alt_text, translations.values.compact.first)
+    end
+    change_column :lato_cms_media, :alt_text, :string
+  end
+end

data/lib/lato_cms/config.rb

@@ -3,7 +3,7 @@ module LatoCms
   # This class contains the default configuration of the engine.
   ##
   class Config
-    attr_accessor :locales, :templates_path, :admin_roles
+    attr_accessor :locales, :templates_path, :admin_roles, :llm_api_url, :llm_model, :llm_api_key
 
     def initialize
       @locales = [:en]
@@ -15,6 +15,17 @@ module LatoCms
       # `operator` has read/edit access; `admin` also manages pages
       # (create, update, delete) and translation links.
       @admin_roles = { none: 0, operator: 1, admin: 2 }
+
+      # Optional OpenAI-compatible endpoint used to auto-generate alt text
+      # for uploaded images (see LatoCms::Media#generate_alt_text!). All
+      # three must be set for the feature to activate; unset by default.
+      @llm_api_url = nil
+      @llm_model = nil
+      @llm_api_key = nil
+    end
+
+    def llm_configured?
+      llm_api_url.present? && llm_model.present? && llm_api_key.present?
     end
   end
 end

data/lib/lato_cms/version.rb

@@ -1,3 +1,3 @@
 module LatoCms
-  VERSION = "3.0.13"
+  VERSION = "3.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lato_cms
 version: !ruby/object:Gem::Version
-  version: 3.0.13
+  version: 3.1.1
 platform: ruby
 authors:
 - Gregorio Galante
@@ -79,6 +79,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: ruby-vips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 description: A Rails engine to manage application users on Lato projects!
 email:
 - me@gregoriogalante.com
@@ -96,26 +110,40 @@ files:
 - app/assets/javascripts/lato_cms/controllers/lato_cms_component_accordion_controller.js
 - app/assets/javascripts/lato_cms/controllers/lato_cms_component_form_controller.js
 - app/assets/javascripts/lato_cms/controllers/lato_cms_component_toggle_controller.js
-- app/assets/javascripts/lato_cms/controllers/lato_cms_file_field_controller.js
-- app/assets/javascripts/lato_cms/controllers/lato_cms_gallery_field_controller.js
-- app/assets/javascripts/lato_cms/controllers/lato_cms_image_field_controller.js
 - app/assets/javascripts/lato_cms/controllers/lato_cms_json_field_controller.js
+- app/assets/javascripts/lato_cms/controllers/lato_cms_media_field_controller.js
+- app/assets/javascripts/lato_cms/controllers/lato_cms_media_picker_controller.js
+- app/assets/javascripts/lato_cms/controllers/lato_cms_media_reorder_controller.js
 - app/assets/javascripts/lato_cms/controllers/lato_cms_page_preview_controller.js
+- app/assets/javascripts/lato_cms/controllers/lato_cms_reload_on_modal_close_controller.js
 - app/assets/javascripts/lato_cms/controllers/lato_cms_repeater_controller.js
 - app/assets/javascripts/lato_cms/controllers/lato_cms_text_field_controller.js
-- app/assets/javascripts/lato_cms/controllers/lato_cms_video_field_controller.js
 - app/assets/stylesheets/lato_cms/application.scss
 - app/controllers/lato_cms/api/pages_controller.rb
 - app/controllers/lato_cms/application_controller.rb
+- app/controllers/lato_cms/media_controller.rb
 - app/controllers/lato_cms/pages_controller.rb
 - app/helpers/lato_cms/application_helper.rb
+- app/helpers/lato_cms/media_helper.rb
 - app/helpers/lato_cms/pages_helper.rb
 - app/jobs/lato_cms/application_job.rb
+- app/jobs/lato_cms/export_sitemap_csv_job.rb
+- app/jobs/lato_cms/generate_alt_text_job.rb
 - app/jobs/lato_cms/generate_video_poster_job.rb
+- app/jobs/lato_cms/translate_component_fields_job.rb
 - app/mailers/lato_cms/application_mailer.rb
+- app/models/lato_cms/llm_client.rb
+- app/models/lato_cms/media.rb
 - app/models/lato_cms/page.rb
 - app/models/lato_cms/page_field.rb
+- app/models/lato_cms/page_field_media.rb
 - app/models/lato_cms/template_manager.rb
+- app/views/lato_cms/media/_form_create.html.erb
+- app/views/lato_cms/media/_form_update.html.erb
+- app/views/lato_cms/media/create.html.erb
+- app/views/lato_cms/media/index.html.erb
+- app/views/lato_cms/media/picker_action.html.erb
+- app/views/lato_cms/media/update.html.erb
 - app/views/lato_cms/pages/_component_accordion.html.erb
 - app/views/lato_cms/pages/_fields_editor.html.erb
 - app/views/lato_cms/pages/_form_create.html.erb
@@ -132,6 +160,8 @@ files:
 - app/views/lato_cms/pages/fields/_gallery.html.erb
 - app/views/lato_cms/pages/fields/_image.html.erb
 - app/views/lato_cms/pages/fields/_json.html.erb
+- app/views/lato_cms/pages/fields/_media_field.html.erb
+- app/views/lato_cms/pages/fields/_media_item.html.erb
 - app/views/lato_cms/pages/fields/_multiselect.html.erb
 - app/views/lato_cms/pages/fields/_number.html.erb
 - app/views/lato_cms/pages/fields/_select.html.erb
@@ -152,6 +182,9 @@ files:
 - db/migrate/20260323171241_create_lato_cms_page_fields.rb
 - db/migrate/20260705000000_add_translation_group_id_to_lato_cms_pages.rb
 - db/migrate/20260712092241_change_lato_cms_admin_to_lato_cms_admin_role_on_lato_user.rb
+- db/migrate/20260728175413_create_lato_cms_media.rb
+- db/migrate/20260728175414_create_lato_cms_page_field_media.rb
+- db/migrate/20260729120000_change_lato_cms_media_alt_text_to_translations.rb
 - lib/lato_cms.rb
 - lib/lato_cms/config.rb
 - lib/lato_cms/engine.rb