lato_cms 3.1.5 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 335542f7d3246d07af36c41b161ab638d26f9f923823d3bedc255a943bac2197
-  data.tar.gz: a36f8acf15e683688a5344090fc7cc023d12b57371411dcbcfaba436f4f04d1a
+  metadata.gz: 0f9ff4673b5fb6fd0cf73a6cb74878abb42d06e060e54df3f21a969e875afc26
+  data.tar.gz: 5825b755ceef65a720e190d31373a209a43d7620666117faa74d446df7a7668a
 SHA512:
-  metadata.gz: '04776471890c80fc97fb2ff07dd3b27eaffdc54dbe7273ed5ae7f099a7bed4083fa21c26dc96d460a245ce49741b46076c9dd720cbb7516f3edea34521742759'
-  data.tar.gz: 8730a9ead03c286df9540e72c1ea1eb13ac696c536331b5dad038efa26598bacee29ae1d998243f38536b8efadfa97af9db64c6881e1adb74d5524c13a3a62e0
+  metadata.gz: 735617a5f9e02a8f661bb784d4f958bfc7f720837387e6046586738228957d585bdd67ae11481e2613d845aebfc14c7adf8576d94d0f50b98ad113eae4816ecb
+  data.tar.gz: 56fb22fef815efe46da9774ecf9795413543b737264d470d384beac492308692e5ddc836c0f98e4ead2848a199c32e48e1568b918a5a7321d71b219f6dfb9934

data/app/controllers/lato_cms/media_controller.rb

@@ -10,7 +10,7 @@ module LatoCms
         query_media.order(created_at: :desc),
         columns: %i[name media_type actions],
         sortable_columns: %i[name media_type created_at],
-        searchable_columns: %i[name alt_text],
+        searchable_columns: %i[name alt_text title],
         default_sort_by: 'created_at|DESC',
         pagination: 20
       )
@@ -62,27 +62,30 @@ module LatoCms
       end
     end
 
-    # Runs as a Lato::Operation (see GenerateAltTextJob) rather than inline:
-    # an LLM call can take a while, and blocking the request risks timing it
-    # out. The admin instead lands on a live progress page.
-    def regenerate_alt_text_action
+    # Regenerates one translatable attribute (alt_text or title, see the
+    # route constraint) with the LLM. Runs as a Lato::Operation (see
+    # GenerateMediaTextJob) rather than inline: an LLM call can take a while,
+    # and blocking the request risks timing it out. The admin instead lands on
+    # a live progress page.
+    def regenerate_text_action
       @media = query_media.find(params[:id])
+      attribute = params[:attribute].to_s
 
-      unless @media.image? && LatoCms.config.llm_configured?
+      unless @media.image? && LatoCms.config.llm_generates?(attribute)
         respond_to do |format|
-          message = t('lato_cms.media_alt_text_regenerate_unavailable')
+          message = t("lato_cms.media_text_regenerate_unavailable")
           format.html { redirect_to lato_cms.media_update_path(@media), alert: message }
           format.json { render json: { error: message }, status: :unprocessable_entity }
         end
         return
       end
 
-      operation = Lato::Operation.generate('LatoCms::GenerateAltTextJob', { media_id: @media.id }, @session.user_id)
+      operation = Lato::Operation.generate("LatoCms::GenerateMediaTextJob", { media_id: @media.id, attributes: [attribute] }, @session.user_id)
 
       if operation.start
         redirect_to lato.operation_path(operation)
       else
-        redirect_to lato_cms.media_update_path(@media), alert: t('lato_cms.media_alt_text_regenerate_failed')
+        redirect_to lato_cms.media_update_path(@media), alert: t("lato_cms.media_text_regenerate_failed")
       end
     end
 
@@ -106,7 +109,7 @@ module LatoCms
     private
 
     def create_params
-      params.require(:media).permit(:file, :name, :alt_text)
+      params.require(:media).permit(:file, :name, :alt_text, :title)
     end
 
     # :file is intentionally not permitted here: the underlying file is
@@ -114,8 +117,8 @@ module LatoCms
     # many pages, so replacing it in place would silently change what renders
     # everywhere it's referenced). A different file means a new Media.
     def update_params
-      alt_text_keys = LatoCms.config.locales.map { |locale| :"alt_text_#{locale}" }
-      params.require(:media).permit(:name, *alt_text_keys)
+      translation_keys = LatoCms::Media::TRANSLATABLE_ATTRIBUTES.product(LatoCms.config.locales).map { |attribute, locale| :"#{attribute}_#{locale}" }
+      params.require(:media).permit(:name, *translation_keys)
     end
   end
 end

data/app/jobs/lato_cms/generate_media_text_job.rb

@@ -0,0 +1,26 @@
+module LatoCms
+  # Generates alt text and/or title for an image Media via an OpenAI-compatible
+  # LLM, one LLM call per attribute (each has its own prompt, see
+  # LatoCms::Config#llm_prompt). `attributes` defaults to every attribute
+  # enabled in config (the automatic post-upload run); the manual "Regenerate
+  # with AI" buttons pass the single attribute they sit next to.
+  #
+  # Doubles as a plain background job (post-upload call site, see
+  # Media#enqueue_text_generation: fire-and-forget, best effort, never blocks
+  # the upload) and as a Lato::Operation-backed job (the admin actions, see
+  # MediaController#regenerate_text_action: the admin is watching, so failures
+  # should surface instead of being swallowed). Inheriting Lato::ApplicationJob
+  # makes both work from the same perform: `operation?` is only true when a
+  # `_operation_id` was injected by Lato::Operation#start.
+  class GenerateMediaTextJob < Lato::ApplicationJob
+    def perform(params = {})
+      params = params.with_indifferent_access
+      media = LatoCms::Media.find_by(id: params[:media_id])
+      return unless media
+
+      attributes = Array(params[:attributes]).presence || LatoCms.config.llm_media_attributes
+      attributes.each { |attribute| media.generate_text!(attribute, raise_on_error: operation?) }
+      save_operation_output_message(I18n.t("lato_cms.media_text_regenerated")) if operation?
+    end
+  end
+end

data/app/models/lato_cms/media.rb

@@ -10,14 +10,23 @@ module LatoCms
 
     MEDIA_TYPES = %w[image video document file].freeze
 
-    # alt_text is stored as a single JSON-serialized {locale => text} hash in
-    # the `alt_text` column (kept as one column rather than a translations
-    # table since it's the only translatable attribute Media has). `alt_text`
-    # itself is overridden below to read/write the current I18n.locale's
-    # entry; `alt_text_en`, `alt_text_it`, etc. (one per configured locale)
-    # are handled dynamically so forms can render/submit them like any other
-    # attribute without predefining a method per locale.
-    ALT_TEXT_ACCESSOR = /\Aalt_text_(?<locale>[a-z]{2}(?:_[A-Z]{2})?)(?<setter>=)?\z/
+    # alt_text and title are each stored as a single JSON-serialized
+    # {locale => text} hash in their own text column (kept inline rather than
+    # in a translations table since these are Media's only translatable
+    # attributes). `alt_text`/`title` themselves are overridden below to
+    # read/write the current I18n.locale's entry; `alt_text_en`, `title_it`,
+    # etc. (one per configured locale) are handled dynamically so forms can
+    # render/submit them like any other attribute without predefining a
+    # method per locale.
+    TRANSLATABLE_ATTRIBUTES = %w[alt_text title].freeze
+    TRANSLATION_ACCESSOR = /\A(?<attribute>#{TRANSLATABLE_ATTRIBUTES.join("|")})_(?<locale>[a-z]{2}(?:_[A-Z]{2})?)(?<setter>=)?\z/
+
+    TRANSLATABLE_ATTRIBUTES.each do |attribute|
+      define_method(attribute) { |locale = I18n.locale| translations_of(attribute)[locale.to_s].presence }
+      define_method("#{attribute}=") { |value| write_translation(attribute, I18n.locale, value) }
+      define_method("#{attribute}_translations") { translations_of(attribute) }
+      define_method("#{attribute}_translations=") { |hash| self[attribute] = hash.stringify_keys.to_json }
+    end
 
     has_one_attached :file
     has_one_attached :poster_file
@@ -32,7 +41,7 @@ module LatoCms
     before_validation :set_media_type, on: :create
 
     after_create_commit :enqueue_poster_generation, if: :video?
-    after_create_commit :enqueue_alt_text_generation, if: -> { image? && LatoCms.config.llm_configured? }
+    after_create_commit :enqueue_text_generation, if: -> { image? && LatoCms.config.llm_media_attributes.any? }
 
     scope :of_type, ->(type) { where(media_type: type) if type.present? }
 
@@ -73,37 +82,33 @@ module LatoCms
       file.filename.to_s if file.attached?
     end
 
-    def alt_text(locale = I18n.locale)
-      alt_text_translations[locale.to_s].presence
-    end
-
-    def alt_text=(value)
-      self.alt_text_translations = alt_text_translations.merge(I18n.locale.to_s => value)
-    end
-
-    def alt_text_translations
-      JSON.parse(self[:alt_text].presence || '{}')
+    def translations_of(attribute)
+      JSON.parse(self[attribute].presence || "{}")
     rescue JSON::ParserError
       {}
     end
 
-    def alt_text_translations=(hash)
-      self[:alt_text] = hash.stringify_keys.to_json
-    end
-
     def method_missing(name, *args)
-      match = ALT_TEXT_ACCESSOR.match(name.to_s)
+      match = TRANSLATION_ACCESSOR.match(name.to_s)
       return super unless match
 
       if match[:setter]
-        self.alt_text_translations = alt_text_translations.merge(match[:locale] => args.first)
+        write_translation(match[:attribute], match[:locale], args.first)
       else
-        alt_text_translations[match[:locale]].presence
+        translations_of(match[:attribute])[match[:locale]].presence
       end
     end
 
     def respond_to_missing?(name, include_private = false)
-      ALT_TEXT_ACCESSOR.match?(name.to_s) || super
+      TRANSLATION_ACCESSOR.match?(name.to_s) || super
+    end
+
+    # Frontend URLs of the pages using this media through any field: the
+    # absolute URLs handed to the LLM as `{urls}` prompt context, so the model
+    # can see where the image is shown. Pages without a frontend URL are left
+    # out. Empty right after upload, since nothing references a new media yet.
+    def usage_urls
+      LatoCms::Page.where(id: page_fields.select(:page_id)).where.not(frontend_url: [nil, ""]).distinct.order(:frontend_url).pluck(:frontend_url)
     end
 
     def url
@@ -133,29 +138,50 @@ module LatoCms
       Rails.logger.warn("LatoCms: failed to generate video poster for media #{id}: #{e.message}")
     end
 
-    # Asks the configured OpenAI-compatible LLM for alt text in every
-    # configured locale and merges it in (existing translations for locales
-    # the LLM didn't return, or that it's re-run for, are kept/replaced
-    # individually). No-op unless an LLM is configured (see
-    # LatoCms::Config#llm_configured?) and this media is an image.
+    # Asks the configured OpenAI-compatible LLM for `attribute` (alt_text or
+    # title) in every configured locale and merges it in (existing
+    # translations for locales the LLM didn't return are kept, the rest are
+    # replaced individually). No-op unless the LLM is configured and enabled
+    # for that attribute (see LatoCms::Config#llm_generates?) and this media
+    # is an image, since the LLM has to look at the file.
     #
     # Best effort by default (`raise_on_error: false`): any failure is logged
     # and swallowed, since the automatic post-upload call site (see
-    # GenerateAltTextJob) must never break the upload over a flaky LLM. The
-    # manual "Regenerate with AI" action runs as a Lato::Operation the admin
-    # is actively watching, so it passes `raise_on_error: true` to have
+    # GenerateMediaTextJob) must never break the upload over a flaky LLM. The
+    # manual "Regenerate with AI" actions run as a Lato::Operation the admin
+    # is actively watching, so they pass `raise_on_error: true` to have
     # failures surface there instead of disappearing silently.
-    def generate_alt_text!(raise_on_error: false)
-      return unless image? && file.attached? && LatoCms.config.llm_configured?
+    def generate_text!(attribute, raise_on_error: false)
+      attribute = attribute.to_s
+      raise ArgumentError, "unknown translatable attribute: #{attribute}" unless TRANSLATABLE_ATTRIBUTES.include?(attribute)
+      return unless image? && file.attached? && LatoCms.config.llm_generates?(attribute)
+
+      begin
+        translations = parse_translations(request_completion(llm_prompt(attribute)))
+        raise "The LLM returned no usable #{attribute.humanize.downcase}" if translations.blank?
+
+        public_send("#{attribute}_translations=", translations_of(attribute).merge(translations))
+        save!
+      rescue StandardError => e
+        Rails.logger.warn("LatoCms: failed to generate #{attribute} for media #{id}: #{e.message}")
+        raise if raise_on_error
+      end
+    end
 
-      translations = fetch_alt_text_translations
-      raise 'The LLM returned no usable alt text' if translations.blank?
+    # Full prompt sent for `attribute`: the custom-or-default task prompt (see
+    # LatoCms::Config#llm_prompt) with {languages}/{urls} substituted, plus the
+    # engine's fixed response-format contract, appended here rather than left
+    # to the prompt so parsing never depends on how a custom prompt is worded.
+    def llm_prompt(attribute)
+      variables = {
+        "languages" => llm_locales.join(", "),
+        "urls" => usage_urls.presence&.join(", ") || "none"
+      }
+      placeholders = /\{(#{LatoCms::Config::LLM_PROMPT_VARIABLES.join("|")})\}/
+      task = LatoCms.config.llm_prompt(attribute).gsub(placeholders) { variables[Regexp.last_match(1)] }
 
-      self.alt_text_translations = alt_text_translations.merge(translations)
-      save!
-    rescue StandardError => e
-      Rails.logger.warn("LatoCms: failed to generate alt text for media #{id}: #{e.message}")
-      raise if raise_on_error
+      "#{task}\n\nRespond with a single JSON object only, no markdown, no extra text, with exactly these " \
+      "keys: #{llm_locales.join(", ")}. Each value is the text written in that language."
     end
 
     # Fixed small variant used across admin UI (Media index, picker grid, field
@@ -212,6 +238,8 @@ module LatoCms
         name: name,
         alt_text: alt_text,
         alt_text_translations: alt_text_translations,
+        title: title,
+        title_translations: title_translations,
         media_type: media_type,
         filename: filename,
         content_type: file.attached? ? file.content_type : nil,
@@ -243,41 +271,36 @@ module LatoCms
       LatoCms::GenerateVideoPosterJob.perform_later(id)
     end
 
-    def enqueue_alt_text_generation
-      LatoCms::GenerateAltTextJob.perform_later(media_id: id)
+    def enqueue_text_generation
+      LatoCms::GenerateMediaTextJob.perform_later(media_id: id)
     end
 
-    def fetch_alt_text_translations
-      locales = LatoCms.config.locales.map(&:to_s)
-      content = request_alt_text_completion(locales)
-      parse_alt_text_response(content, locales)
+    def write_translation(attribute, locale, value)
+      public_send("#{attribute}_translations=", translations_of(attribute).merge(locale.to_s => value))
+    end
+
+    def llm_locales
+      LatoCms.config.locales.map(&:to_s)
     end
 
     # Sends the image as a base64 data URI rather than a URL: the file may be
     # stored on a service (or behind auth) the LLM can't reach, so this works
     # regardless of storage backend or app visibility settings.
-    def request_alt_text_completion(locales)
+    def request_completion(prompt)
       LatoCms::LlmClient.chat(messages: [{
-        role: 'user',
+        role: "user",
         content: [
-          { type: 'text', text: alt_text_prompt(locales) },
-          { type: 'image_url', image_url: { url: "data:#{file.content_type};base64,#{Base64.strict_encode64(file.download)}" } }
+          { type: "text", text: prompt },
+          { type: "image_url", image_url: { url: "data:#{file.content_type};base64,#{Base64.strict_encode64(file.download)}" } }
         ]
       }])
     end
 
-    def alt_text_prompt(locales)
-      "Write a concise, descriptive alt text for this image, for the HTML <img alt> attribute " \
-      "(accessibility use, not a caption). Respond with a single JSON object only, no markdown, " \
-      "no extra text, with exactly these keys: #{locales.join(', ')}. Each value is the alt text " \
-      "written in that language."
-    end
-
-    def parse_alt_text_response(content, locales)
+    def parse_translations(content)
       return {} if content.blank?
 
       parsed = JSON.parse(content[/\{.*\}/m] || content)
-      parsed.slice(*locales).transform_values(&:to_s)
+      parsed.slice(*llm_locales).transform_values(&:to_s)
     rescue JSON::ParserError
       {}
     end

data/app/models/lato_cms/page_field.rb

@@ -141,6 +141,7 @@ module LatoCms
         media_id: m.id,
         name: m.name,
         alt_text: m.alt_text(page.locale),
+        title: m.title(page.locale),
         filename: m.filename,
         content_type: m.file.attached? ? m.file.content_type : nil,
         byte_size: m.file.attached? ? m.file.byte_size : nil,

data/app/views/lato_cms/media/_form_update.html.erb

@@ -31,42 +31,9 @@
     </div>
 
     <% if media.image? %>
-      <div class="mb-3">
-        <div class="d-flex align-items-center justify-content-between">
-          <label class="form-label mb-0"><%= t('lato_cms.media_alt_text') %></label>
-          <% if LatoCms.config.llm_configured? %>
-            <%= link_to t('lato_cms.media_alt_text_regenerate'), lato_cms.media_regenerate_alt_text_action_path(media),
-              class: 'btn btn-sm btn-outline-secondary',
-              data: {
-                lato_action_target: 'trigger',
-                turbo_method: :post,
-                turbo_frame: 'lato_operation',
-                turbo_confirm: t('lato_cms.media_alt_text_regenerate_confirm'),
-                action_title: t('lato_cms.media_alt_text_regenerate')
-              } %>
-          <% end %>
-        </div>
-
-        <ul class="nav nav-tabs">
-          <% LatoCms.config.locales.each_with_index do |locale, index| %>
-            <li class="nav-item">
-              <button class="nav-link <%= 'active' if index.zero? %>" data-bs-toggle="tab"
-                data-bs-target="#<%= dom_id(media, "alt_text_#{locale}_pane") %>" type="button">
-                <%= locale_to_flag(locale) %> <%= locale.to_s.upcase %>
-              </button>
-            </li>
-          <% end %>
-        </ul>
-
-        <div class="tab-content border border-top-0 rounded-bottom p-3">
-          <% LatoCms.config.locales.each_with_index do |locale, index| %>
-            <div class="tab-pane fade <%= 'show active' if index.zero? %>" id="<%= dom_id(media, "alt_text_#{locale}_pane") %>">
-              <%= lato_form_item_input_text form, :"alt_text_#{locale}" %>
-            </div>
-          <% end %>
-        </div>
-      </div>
+      <%= render "lato_cms/media/translations_field", form: form, media: media, attribute: "alt_text" %>
     <% end %>
+    <%= render "lato_cms/media/translations_field", form: form, media: media, attribute: "title" %>
 
     <div class="d-flex justify-content-end">
       <%= lato_form_submit form, t('lato_cms.cta_update'), class: %w[btn-success] %>

data/app/views/lato_cms/media/_translations_field.html.erb

@@ -0,0 +1,41 @@
+<%# One tab per configured locale for a translatable Media attribute
+    (alt_text/title), with its own "Regenerate with AI" button when the LLM
+    is configured and enabled for that attribute. Images only: the LLM has
+    to look at the file to describe it. %>
+<% label = t("lato_cms.media_#{attribute}") %>
+
+<div class="mb-3">
+  <div class="d-flex align-items-center justify-content-between">
+    <label class="form-label mb-0"><%= label %></label>
+    <% if media.image? && LatoCms.config.llm_generates?(attribute) %>
+      <%= link_to t("lato_cms.media_text_regenerate"), lato_cms.media_regenerate_text_action_path(media, attribute: attribute),
+        class: "btn btn-sm btn-outline-secondary",
+        data: {
+          lato_action_target: "trigger",
+          turbo_method: :post,
+          turbo_frame: "lato_operation",
+          turbo_confirm: t("lato_cms.media_text_regenerate_confirm", field: label.downcase),
+          action_title: "#{t('lato_cms.media_text_regenerate')} - #{label}"
+        } %>
+    <% end %>
+  </div>
+
+  <ul class="nav nav-tabs">
+    <% LatoCms.config.locales.each_with_index do |locale, index| %>
+      <li class="nav-item">
+        <button class="nav-link <%= 'active' if index.zero? %>" data-bs-toggle="tab"
+          data-bs-target="#<%= dom_id(media, "#{attribute}_#{locale}_pane") %>" type="button">
+          <%= locale_to_flag(locale) %> <%= locale.to_s.upcase %>
+        </button>
+      </li>
+    <% end %>
+  </ul>
+
+  <div class="tab-content border border-top-0 rounded-bottom p-3">
+    <% LatoCms.config.locales.each_with_index do |locale, index| %>
+      <div class="tab-pane fade <%= 'show active' if index.zero? %>" id="<%= dom_id(media, "#{attribute}_#{locale}_pane") %>">
+        <%= lato_form_item_input_text form, :"#{attribute}_#{locale}" %>
+      </div>
+    <% end %>
+  </div>
+</div>

data/config/locales/en.yml

@@ -101,11 +101,12 @@ en:
     media_update_title: Edit media
     media_open_original: Open the original file in a new tab
     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_title: Title
+    media_text_regenerate: Regenerate with AI
+    media_text_regenerate_confirm: "This will overwrite the current %{field} in every language with a new AI-generated one. Continue?"
+    media_text_regenerated: Text regenerated
+    media_text_regenerate_unavailable: AI generation is only available for images, and only when an LLM is configured and enabled for this field
+    media_text_regenerate_failed: Failed to start AI generation
     media_created: Media uploaded successfully
     media_updated: Media updated successfully
     media_deleted: Media deleted successfully

data/config/locales/it.yml

@@ -101,11 +101,12 @@ it:
     media_update_title: Modifica media
     media_open_original: Apri il file originale in una nuova scheda
     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_title: Titolo
+    media_text_regenerate: Rigenera con AI
+    media_text_regenerate_confirm: "Il %{field} attuale in ogni lingua verrà sostituito con uno generato dall'AI. Continuare?"
+    media_text_regenerated: Testo rigenerato
+    media_text_regenerate_unavailable: La generazione AI è disponibile solo per le immagini e solo se un LLM è configurato e abilitato per questo campo
+    media_text_regenerate_failed: Impossibile avviare la generazione AI
     media_created: Media caricato con successo
     media_updated: Media aggiornato con successo
     media_deleted: Media eliminato con successo

data/config/routes.rb

@@ -32,7 +32,7 @@ LatoCms::Engine.routes.draw do
     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
+    post ':id/regenerate/:attribute', to: 'media#regenerate_text_action', as: :media_regenerate_text_action, constraints: { attribute: /alt_text|title/ }
     delete ':id', to: 'media#destroy_action', as: :media_destroy_action
   end
 end

data/db/migrate/20260907120000_add_title_to_lato_cms_media.rb

@@ -0,0 +1,6 @@
+class AddTitleToLatoCmsMedia < ActiveRecord::Migration[8.1]
+  def change
+    # JSON-serialized {locale => title} hash, same shape as alt_text.
+    add_column :lato_cms_media, :title, :text
+  end
+end

data/lib/lato_cms/config.rb

@@ -3,11 +3,32 @@ module LatoCms
   # This class contains the default configuration of the engine.
   ##
   class Config
-    attr_accessor :locales, :templates_path, :admin_roles, :llm_api_url, :llm_model, :llm_api_key
+    attr_accessor :locales, :templates_path, :admin_roles, :llm_api_url, :llm_model, :llm_api_key,
+                  :llm_generate_alt_text, :llm_generate_title, :llm_alt_text_prompt, :llm_title_prompt
+
+    # Placeholders substituted at request time in both default and custom LLM
+    # prompts (see LatoCms::Media#llm_prompt):
+    # - {languages}: comma-separated LatoCms.config.locales
+    # - {urls}: comma-separated frontend URLs of the pages using the media, so
+    #   the model can look at where the image is shown ("none" when it isn't
+    #   used anywhere yet, e.g. right after upload)
+    LLM_PROMPT_VARIABLES = %w[languages urls].freeze
+
+    # Task prompts used when the host app sets no custom one. The response
+    # format contract (a JSON object keyed by locale) is appended by the
+    # engine to every prompt, custom ones included, so it's not part of these.
+    DEFAULT_LLM_PROMPTS = {
+      alt_text: "Write a concise, descriptive alt text for this image, for the HTML <img alt> attribute " \
+                "(accessibility use, not a caption). The website is published in these languages: {languages}. " \
+                "The image is used on these pages, use them as context for what it depicts and why: {urls}.",
+      title: "Write a short, human-readable title for this image, for the HTML <img title> attribute " \
+             "(a few words, no trailing period, not a full description). The website is published in these " \
+             "languages: {languages}. The image is used on these pages, use them as context: {urls}."
+    }.freeze
 
     def initialize
       @locales = [:en]
-      @templates_path = 'config/lato_cms'
+      @templates_path = "config/lato_cms"
 
       # Admin roles exposed on Lato::User#lato_cms_admin_role and rendered
       # as a select by lato_users. Ordered map of role key => integer value;
@@ -16,16 +37,44 @@ module LatoCms
       # (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
+      # Optional OpenAI-compatible endpoint used to auto-generate alt text and
+      # title for uploaded images (see LatoCms::Media#generate_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
+
+      # Which Media attributes the LLM generates (post-upload and via the
+      # "Regenerate with AI" buttons). Both on once an LLM is configured;
+      # switch one off to skip it, each costs one LLM call per upload.
+      @llm_generate_alt_text = true
+      @llm_generate_title = true
+
+      # Custom task prompts, nil falls back to DEFAULT_LLM_PROMPTS. May embed
+      # LLM_PROMPT_VARIABLES placeholders.
+      @llm_alt_text_prompt = nil
+      @llm_title_prompt = nil
     end
 
     def llm_configured?
       llm_api_url.present? && llm_model.present? && llm_api_key.present?
     end
+
+    # Media attributes the LLM generates, as configured. Empty unless an LLM
+    # is configured, so callers need a single check.
+    def llm_media_attributes
+      return [] unless llm_configured?
+
+      { alt_text: llm_generate_alt_text, title: llm_generate_title }.select { |_attribute, enabled| enabled }.keys
+    end
+
+    def llm_generates?(attribute)
+      llm_media_attributes.include?(attribute.to_sym)
+    end
+
+    def llm_prompt(attribute)
+      attribute = attribute.to_sym
+      public_send("llm_#{attribute}_prompt").presence || DEFAULT_LLM_PROMPTS.fetch(attribute)
+    end
   end
-end
+end

data/lib/lato_cms/version.rb

@@ -1,3 +1,3 @@
 module LatoCms
-  VERSION = "3.1.5"
+  VERSION = "3.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lato_cms
 version: !ruby/object:Gem::Version
-  version: 3.1.5
+  version: 3.2.0
 platform: ruby
 authors:
 - Gregorio Galante
@@ -128,7 +128,7 @@ files:
 - 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_media_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
@@ -140,6 +140,7 @@ files:
 - 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/_translations_field.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
@@ -185,6 +186,7 @@ files:
 - 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
+- db/migrate/20260907120000_add_title_to_lato_cms_media.rb
 - lib/lato_cms.rb
 - lib/lato_cms/config.rb
 - lib/lato_cms/engine.rb

data/app/jobs/lato_cms/generate_alt_text_job.rb

@@ -1,21 +0,0 @@
-module LatoCms
-  # Generates alt text for an image Media via an OpenAI-compatible LLM.
-  # Doubles as a plain background job (automatic post-upload call site, see
-  # Media#enqueue_alt_text_generation: fire-and-forget, best effort, never
-  # blocks the upload) and as a Lato::Operation-backed job (the "Regenerate
-  # with AI" admin action, see MediaController#regenerate_alt_text_action:
-  # the admin is watching, so failures should surface instead of being
-  # swallowed). Inheriting Lato::ApplicationJob makes both work from the
-  # same perform: `operation?` is only true when a `_operation_id` was
-  # injected by Lato::Operation#start.
-  class GenerateAltTextJob < Lato::ApplicationJob
-    def perform(params = {})
-      params = params.with_indifferent_access
-      media = LatoCms::Media.find_by(id: params[:media_id])
-      return unless media
-
-      media.generate_alt_text!(raise_on_error: operation?)
-      save_operation_output_message(I18n.t('lato_cms.media_alt_text_regenerated')) if operation?
-    end
-  end
-end