shiplog 0.3.2 → 0.4.0

data/app/views/shiplog/admin/entries/edit.html.erb

@@ -20,7 +20,7 @@
         </p>
         <p>
           <%= form.label :body, t("shiplog.admin.entries.fields.body") %>
-          <%= form.text_area :body, rows: 8 %>
+          <%= form.text_area :body, rows: (@entry.announcement? ? 24 : 8) %>
         </p>
         <% if Shiplog::Entry::CHANGELOG_KINDS.include?(@entry.kind) %>
           <p>
@@ -28,6 +28,7 @@
             <%= form.select :changelog_kind, Shiplog::Entry::CHANGELOG_KINDS.map { |kind| [ t("shiplog.admin.entries.category_options.#{kind}"), kind ] } %>
           </p>
         <% end %>
+        <% unless @entry.announcement? %>
         <p>
           <%= form.label :area_id, t("shiplog.admin.entries.fields.area", default: "Area") %>
           <%= form.collection_select :area_id, Shiplog::Area.ordered, :id, :name, include_blank: t("shiplog.admin.entries.no_area", default: "None") %>
@@ -36,6 +37,7 @@
           <%= form.label :released_on, t("shiplog.admin.entries.fields.released_on") %>
           <%= form.date_field :released_on %>
         </p>
+        <% end %>
         <%= form.submit t("shiplog.admin.entries.save"), class: "shiplog-button shiplog-button--primary" %>
       <% end %>
 
@@ -67,11 +69,15 @@
     </aside>
   </div>
 
+  <% if @entry.announcement? %>
+    <%= render "shiplog/admin/entries/announcement", entry: @entry %>
+  <% end %>
+
   <% if Shiplog.config.locales.any? %>
     <%= render "shiplog/admin/entries/translations", entry: @entry %>
   <% end %>
 
-  <% if Shiplog.images? %>
+  <% if Shiplog.images? && !@entry.announcement? %>
     <%= render "shiplog/admin/entries/images", entry: @entry %>
   <% end %>
 

data/app/views/shiplog/admin/entries/index.html.erb

@@ -1,6 +1,14 @@
 <%= render layout: "shiplog/admin/page" do %>
   <h1 class="shiplog-admin__title"><%= t("shiplog.admin.entries.title") %></h1>
 
+  <% if Shiplog.announcements? %>
+    <div class="shiplog-admin-actions">
+      <% Shiplog::Announcements.draftable_months.each do |month| %>
+        <%= button_to t("shiplog.admin.announcements.draft", month: l(month, format: "%B %Y")), announcements_path(month: month.strftime("%Y-%m"), **inbox_filter_params), class: "shiplog-button" %>
+      <% end %>
+    </div>
+  <% end %>
+
   <nav class="shiplog-admin-filters" aria-label="<%= t("shiplog.admin.entries.filters") %>">
     <ul class="shiplog-admin-filters__list">
       <% Shiplog::Entry.statuses.each_key do |status| %>
@@ -12,6 +20,7 @@
       <li><%= link_to t("shiplog.admin.entries.all_kinds"), entries_filter_path(status: @status),
             class: "shiplog-admin-filters__link", "aria-current": (@kind.nil? ? "true" : nil) %></li>
       <% Shiplog::Entry.kinds.each_key do |kind| %>
+        <% next if kind == "announcement" && !Shiplog.announcements? %>
         <li><%= link_to t("shiplog.admin.entries.kinds.#{kind}"), entries_filter_path(status: @status, kind:),
               class: "shiplog-admin-filters__link", "aria-current": (kind == @kind ? "true" : nil) %></li>
       <% end %>

data/app/views/shiplog/admin/entries/newsletters/show.html.erb

@@ -0,0 +1,46 @@
+<%# The confirmation step before sending: the recipients per locale (after deduplication), what was sent already, and the Send button %>
+<%= render layout: "shiplog/admin/page" do %>
+  <h1 class="shiplog-admin__title"><%= t("shiplog.admin.newsletter.confirm_title", title: @entry.title) %></h1>
+
+  <% if @blockers.any? %>
+    <div class="shiplog-admin__flash shiplog-admin__flash--alert" role="alert">
+      <%= t("shiplog.admin.newsletter.send_blocked", reasons: @blockers.map { |blocker| t("shiplog.admin.newsletter.blockers.#{blocker}", locales: Shiplog::Newsletter.missing_locales(@entry).join(", ")) }.join(", ")) %>
+    </div>
+  <% end %>
+
+  <section class="shiplog-admin-panel">
+    <h2><%= t("shiplog.admin.newsletter.recipients") %></h2>
+    <% if @recipients_error %>
+      <p class="shiplog-admin__flash shiplog-admin__flash--alert" role="alert"><%= t("shiplog.admin.newsletter.recipients_error", error: @recipients_error) %></p>
+    <% elsif @counts.empty? %>
+      <p class="shiplog-admin__muted"><%= t("shiplog.admin.newsletter.recipients_none") %></p>
+    <% else %>
+      <table class="shiplog-admin-table shiplog-admin-counts">
+        <thead>
+          <tr>
+            <th scope="col"><%= t("shiplog.admin.newsletter.columns.locale") %></th>
+            <th scope="col"><%= t("shiplog.admin.newsletter.columns.recipients") %></th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @counts.each do |locale, count| %>
+            <tr><td><%= locale %></td><td class="shiplog-admin-counts__number"><%= count %></td></tr>
+          <% end %>
+          <tr><th scope="row"><%= t("shiplog.admin.newsletter.total") %></th><td class="shiplog-admin-counts__number"><%= @counts.values.sum %></td></tr>
+        </tbody>
+      </table>
+    <% end %>
+    <% total = @counts.values.sum %>
+    <% if @progress.values_at(:sent, :failed, :pending).sum.positive? %>
+      <p class="shiplog-admin__muted"><%= t("shiplog.admin.newsletter.progress", **@progress.slice(:sent, :failed, :pending)) %> <%= t("shiplog.admin.newsletter.confirm_resend_help") %></p>
+    <% end %>
+    <p class="shiplog-admin__muted"><%= t("shiplog.admin.newsletter.confirm_help") %></p>
+    <div class="shiplog-admin-actions">
+      <%= shiplog_javascript_tag "once" %>
+      <%= button_to t("shiplog.admin.newsletter.confirm_button", count: total), entry_newsletter_path(@entry, inbox_filter_params), method: :post,
+            class: "shiplog-button shiplog-button--primary", disabled: @blockers.any? || total.zero?, form: { data: { shiplog_once: true } } %>
+    </div>
+  </section>
+
+  <p><%= link_to t("shiplog.admin.newsletter.back"), edit_entry_path(@entry, inbox_filter_params) %></p>
+<% end %>

data/app/views/shiplog/admin/newsletter_subscribers/index.html.erb

@@ -0,0 +1,83 @@
+<%= render layout: "shiplog/admin/page" do %>
+  <h1 class="shiplog-admin__title"><%= t("shiplog.admin.newsletter.title") %></h1>
+  <p class="shiplog-admin__muted"><%= t("shiplog.admin.newsletter.help") %></p>
+
+  <table class="shiplog-admin-table shiplog-admin-counts">
+    <thead>
+      <tr>
+        <th scope="col"><%= t("shiplog.admin.newsletter.columns.locale") %></th>
+        <% Shiplog::NewsletterSubscriber::STATUSES.each do |status| %>
+          <th scope="col"><%= t("shiplog.admin.newsletter.statuses.#{status}") %></th>
+        <% end %>
+      </tr>
+    </thead>
+    <tbody>
+      <% @counts.sort_by { |locale, _| locale }.each do |locale, counts| %>
+        <tr>
+          <td><%= locale %></td>
+          <% Shiplog::NewsletterSubscriber::STATUSES.each do |status| %>
+            <td class="shiplog-admin-counts__number"><%= counts[status] %></td>
+          <% end %>
+        </tr>
+      <% end %>
+      <tr>
+        <th scope="row"><%= t("shiplog.admin.newsletter.total") %></th>
+        <% Shiplog::NewsletterSubscriber::STATUSES.each do |status| %>
+          <td class="shiplog-admin-counts__number"><%= @counts.values.sum { |counts| counts[status] } %></td>
+        <% end %>
+      </tr>
+    </tbody>
+  </table>
+
+  <div class="shiplog-admin-actions">
+    <%= form_with url: newsletter_subscribers_path, method: :get, class: "shiplog-admin-inline-form" do |form| %>
+      <%= form.label :q, t("shiplog.admin.newsletter.search"), class: "shiplog-admin__visually-hidden" %>
+      <%= form.search_field :q, value: @query, placeholder: t("shiplog.admin.newsletter.search_placeholder") %>
+      <%= form.submit t("shiplog.admin.newsletter.search"), class: "shiplog-button" %>
+      <% if @query.present? %>
+        <%= link_to t("shiplog.admin.newsletter.clear"), newsletter_subscribers_path, class: "shiplog-button" %>
+      <% end %>
+    <% end %>
+    <p><%= link_to t("shiplog.admin.newsletter.export"), newsletter_subscribers_path(format: :csv, q: @query.presence), class: "shiplog-button" %></p>
+  </div>
+
+  <% if @subscribers.empty? %>
+    <p class="shiplog-admin__empty"><%= @query.present? ? t("shiplog.admin.newsletter.no_match", query: @query) : t("shiplog.admin.newsletter.empty") %></p>
+  <% else %>
+    <table class="shiplog-admin-table">
+      <thead>
+        <tr>
+          <th scope="col"><%= t("shiplog.admin.newsletter.columns.email") %></th>
+          <th scope="col"><%= t("shiplog.admin.newsletter.columns.locale") %></th>
+          <th scope="col"><%= t("shiplog.admin.newsletter.columns.status") %></th>
+          <th scope="col"><%= t("shiplog.admin.newsletter.columns.source") %></th>
+          <th scope="col"><%= t("shiplog.admin.newsletter.columns.subscribed_at") %></th>
+          <th scope="col"><%= t("shiplog.admin.entries.columns.actions") %></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @subscribers.each do |subscriber| %>
+          <tr id="shiplog-subscriber-<%= subscriber.id %>">
+            <td><%= subscriber.email %></td>
+            <td><%= subscriber.locale %></td>
+            <td><%= t("shiplog.admin.newsletter.statuses.#{subscriber.status}") %></td>
+            <td><%= subscriber.source %></td>
+            <td><%= l(subscriber.created_at, format: :short) %></td>
+            <td class="shiplog-admin-table__actions">
+              <%= button_to t("shiplog.admin.newsletter.remove"), newsletter_subscriber_path(subscriber, q: @query.presence), method: :delete, class: "shiplog-button" %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% end %>
+
+  <nav class="shiplog-admin-pagination" aria-label="<%= t("shiplog.admin.entries.pagination") %>">
+    <% if @page > 1 %>
+      <%= link_to t("shiplog.admin.entries.newer"), newsletter_subscribers_path(q: @query.presence, page: (@page - 1 if @page > 2)), class: "shiplog-admin-pagination__prev" %>
+    <% end %>
+    <% if @more %>
+      <%= link_to t("shiplog.admin.entries.older"), newsletter_subscribers_path(q: @query.presence, page: @page + 1), class: "shiplog-admin-pagination__next" %>
+    <% end %>
+  </nav>
+<% end %>

data/app/views/shiplog/changelog_entries/announcement.html.erb

@@ -0,0 +1,16 @@
+<%# A month's announcement: its title and Markdown body (Shiplog::Markdown, which escapes everything it does not build) %>
+<% content_for :title, t("shiplog.permalink.title", title: @entry.display_title, changelog: t("shiplog.changelog.title", default: "Changelog"), default: "%{title} · %{changelog}") %>
+<% shiplog_head_page :permalink, title: @entry.display_title, entry: @entry, url: shiplog_entry_url(@entry), json_ld: shiplog_article_json_ld(@entry) %>
+<%= render layout: "shiplog/page", locals: { name: "announcement" } do %>
+  <%= render "shiplog/page_header", title: t("shiplog.changelog.title", default: "Changelog"), lede: nil %>
+  <article class="<%= shiplog_class(:announcement) %>">
+    <span class="<%= shiplog_class(:entry_category) %>"><%= t("shiplog.categories.announcement", default: "Monthly update") %></span>
+    <time class="<%= shiplog_class(:entry_date) %>" datetime="<%= @entry.released_on.beginning_of_month.strftime("%Y-%m") %>"><%= l(@entry.released_on, format: "%B %Y") %></time>
+    <h2 class="<%= shiplog_class(:announcement_title) %>"><%= @entry.display_title %></h2>
+    <div class="<%= shiplog_class(:announcement_body) %>"><%= Shiplog::Markdown.to_html(@entry.display_body, heading_offset: 1) %></div>
+  </article>
+  <% if Shiplog.newsletter? %>
+    <%= render "shiplog/newsletter/form", source: request.path %>
+  <% end %>
+  <%= link_to t("shiplog.announcements.back", default: "← Back to the changelog"), changelog_path(anchor: shiplog_month_anchor(@entry.released_on)), class: shiplog_class(:permalink_back) %>
+<% end %>

data/app/views/shiplog/changelogs/_month.html.erb

@@ -1,8 +1,15 @@
-<%# locals: (month:, entries:) %>
-<%# one month of the changelog (month is its first day) and its entries, newest first %>
+<%# locals: (month:, entries:, announcement: nil) %>
+<%# one month of the changelog (month is its first day) and its entries, newest first; a link to the month's
+    announcement under the heading when it has one (see shiplog_announcement_href) %>
 <% heading_id = "shiplog-month-#{month.strftime("%Y-%m")}" %>
+<% month_name = l(month, format: "%B %Y") %>
 <section class="<%= shiplog_class(:month) %>" aria-labelledby="<%= heading_id %>">
-  <h2 class="<%= shiplog_class(:month_title) %>" id="<%= heading_id %>"><%= l(month, format: "%B %Y") %></h2>
+  <h2 class="<%= shiplog_class(:month_title) %>" id="<%= heading_id %>"><%= month_name %></h2>
+  <% if announcement && (href = shiplog_announcement_href(announcement)) %>
+    <p class="<%= shiplog_class(:month_announcement) %>">
+      <%= link_to t("shiplog.announcements.read", month: month_name, default: "Read the %{month} summary"), href, class: shiplog_class(:month_announcement_link) %>
+    </p>
+  <% end %>
   <ul class="<%= shiplog_class(:entries) %>">
     <%= render partial: "shiplog/changelogs/entry", collection: entries, as: :entry %>
   </ul>

data/app/views/shiplog/changelogs/show.html.erb

@@ -17,13 +17,16 @@
   <% else %>
     <div class="<%= shiplog_class(:months) %>">
       <% @months.each do |month, entries| %>
-        <%= render "shiplog/changelogs/month", month:, entries: %>
+        <%= render "shiplog/changelogs/month", month:, entries:, announcement: @announcements[month] %>
       <% end %>
     </div>
   <% end %>
   <%= render "shiplog/pagination",
         newer_path: (changelog_path(area: @area&.slug, page: (@page - 1 if @page > 2), q: @query) if @page > 1),
         older_path: (changelog_path(area: @area&.slug, page: @page + 1, q: @query) if @older) %>
+  <% if Shiplog.newsletter? %>
+    <%= render "shiplog/newsletter/form", source: request.path %>
+  <% end %>
   <p class="<%= shiplog_class(:footnote) %>">
     <%= link_to t("shiplog.feed.subscribe", default: "Subscribe (Atom)"), changelog_feed_path, class: shiplog_class(:footnote_link, :feed) %>
   </p>

data/app/views/shiplog/newsletter/_form.html.erb

@@ -0,0 +1,25 @@
+<%# locals: (source: nil, email: nil, error: nil) %>
+<%# The subscribe form: one email field, a honeypot (bots fill it, people never see it), a plain POST that works
+    without JavaScript. No CSRF token on purpose: the pages carrying it are cached with ETags (see
+    Shiplog::Newsletter::SubscriptionsController). `source` is recorded as the page the visitor subscribed on. %>
+<% if Shiplog.newsletter? %>
+  <section class="<%= shiplog_class(:newsletter) %>" aria-labelledby="shiplog-newsletter-title">
+    <h2 class="<%= shiplog_class(:newsletter_title) %>" id="shiplog-newsletter-title"><%= t("shiplog.newsletter.form.title", default: "Get the monthly summary by email") %></h2>
+    <p class="<%= shiplog_class(:newsletter_hint) %>"><%= t("shiplog.newsletter.form.hint", default: "One email a month, no more. Unsubscribe any time.") %></p>
+    <% if error %>
+      <p class="<%= shiplog_class(:newsletter_notice, :error) %>" role="alert"><%= error %></p>
+    <% end %>
+    <%= form_with url: shiplog_newsletter_subscription_path, method: :post, authenticity_token: false, class: shiplog_class(:newsletter_form), data: { turbo: false } do |form| %>
+      <%= form.hidden_field :source, value: shiplog_newsletter_source(source) %>
+      <%# the honeypot: a name no browser autofills, out of the tab order and of autofill %>
+      <div class="shiplog-newsletter__trap" aria-hidden="true">
+        <%= form.label Shiplog::Newsletter::SubscriptionsController::HONEYPOT, t("shiplog.newsletter.form.trap_label", default: "Leave this field empty"), tabindex: -1 %>
+        <%= form.text_field Shiplog::Newsletter::SubscriptionsController::HONEYPOT, tabindex: -1, autocomplete: "off", "data-1p-ignore": "", "data-lpignore": "true" %>
+      </div>
+      <%= form.label :email, t("shiplog.newsletter.form.email_label", default: "Email address"), class: shiplog_class(:newsletter_label) %>
+      <%= form.email_field :email, value: email, required: true, autocomplete: "email", maxlength: Shiplog::NewsletterSubscriber::EMAIL_MAX_LENGTH,
+            placeholder: t("shiplog.newsletter.form.email_placeholder", default: "you@example.com"), class: shiplog_class(:newsletter_input) %>
+      <%= form.button t("shiplog.newsletter.form.submit", default: "Subscribe"), type: "submit", class: shiplog_class(:newsletter_button) %>
+    <% end %>
+  </section>
+<% end %>

data/app/views/shiplog/newsletter/_page.html.erb

@@ -0,0 +1,14 @@
+<%# locals: (heading:) %>
+<%# rendered with `render layout:`; a newsletter page: the changelog's page chrome, a heading and the block's text %>
+<% content_for :title, t("shiplog.newsletter.title", default: "Newsletter") %>
+<%= render layout: "shiplog/page", locals: { name: "newsletter" } do %>
+  <%= render "shiplog/page_header", title: t("shiplog.newsletter.title", default: "Newsletter"), lede: nil %>
+  <section class="<%= shiplog_class(:newsletter, :page) %>" aria-labelledby="shiplog-newsletter-heading">
+    <h2 class="<%= shiplog_class(:newsletter_title) %>" id="shiplog-newsletter-heading"><%= heading %></h2>
+    <% if notice.present? %><p class="<%= shiplog_class(:newsletter_notice) %>" role="status"><%= notice %></p><% end %>
+    <%= yield %>
+  </section>
+  <p class="<%= shiplog_class(:footnote) %>">
+    <%= link_to t("shiplog.newsletter.back", default: "← Back to the changelog"), changelog_path, class: shiplog_class(:footnote_link) %>
+  </p>
+<% end %>

data/app/views/shiplog/newsletter/confirmations/create.html.erb

@@ -0,0 +1,5 @@
+<%# Rendered by the confirming POST: subscribed, with the way to the preferences page %>
+<%= render layout: "shiplog/newsletter/page", locals: { heading: t("shiplog.newsletter.confirm.done_heading", default: "You're subscribed") } do %>
+  <p><%= t("shiplog.newsletter.confirm.done_text", email: @subscriber.email, default: "The monthly summary will arrive at %{email}. You can change the language or unsubscribe any time from your preferences.") %></p>
+  <p><%= link_to t("shiplog.newsletter.preferences.heading", default: "Your subscription"), newsletter_preferences_path(@subscriber.token), class: shiplog_class(:footnote_link) %></p>
+<% end %>

data/app/views/shiplog/newsletter/confirmations/show.html.erb

@@ -0,0 +1,5 @@
+<%# The confirmation link's page: a button that POSTs (a GET confirms nothing, link scanners prefetch) %>
+<%= render layout: "shiplog/newsletter/page", locals: { heading: t("shiplog.newsletter.confirm.heading", default: "Confirm your subscription") } do %>
+  <p><%= t("shiplog.newsletter.confirm.text", email: @subscriber.email, default: "Click the button to receive the monthly summary at %{email}.") %></p>
+  <%= button_to t("shiplog.newsletter.confirm.button", default: "Confirm"), newsletter_confirmation_path(params[:token]), method: :post, class: shiplog_class(:newsletter_button), form: { data: { turbo: false } } %>
+<% end %>

data/app/views/shiplog/newsletter/invalid.html.erb

@@ -0,0 +1,4 @@
+<%# A link that does not verify: tampered, expired, or its subscriber was deleted (status 404) %>
+<%= render layout: "shiplog/newsletter/page", locals: { heading: t("shiplog.newsletter.invalid.heading", default: "This link is not valid") } do %>
+  <p><%= t("shiplog.newsletter.invalid.text", default: "It may have expired or already been used. Subscribe again from the changelog to get a new one.") %></p>
+<% end %>

data/app/views/shiplog/newsletter/preferences/destroy.html.erb

@@ -0,0 +1,4 @@
+<%# Rendered by "Delete my data": the row is gone %>
+<%= render layout: "shiplog/newsletter/page", locals: { heading: t("shiplog.newsletter.preferences.deleted_heading", default: "Your data was deleted") } do %>
+  <p><%= t("shiplog.newsletter.preferences.deleted_text", default: "Your email address is no longer stored. You can subscribe again from the changelog at any time.") %></p>
+<% end %>

data/app/views/shiplog/newsletter/preferences/show.html.erb

@@ -0,0 +1,23 @@
+<%# A subscriber's preferences (reached through the footer's token): language, unsubscribe or resubscribe, delete %>
+<% path = newsletter_preferences_path(@subscriber.token) %>
+<%= render layout: "shiplog/newsletter/page", locals: { heading: t("shiplog.newsletter.preferences.heading", default: "Your subscription") } do %>
+  <p>
+    <%= t("shiplog.newsletter.preferences.email", default: "Email") %>: <strong><%= @subscriber.email %></strong><br>
+    <%= t("shiplog.newsletter.preferences.status", default: "Status") %>: <%= t("shiplog.newsletter.preferences.statuses.#{@subscriber.status}", default: @subscriber.status) %>
+  </p>
+  <%= form_with url: path, method: :patch, class: shiplog_class(:newsletter_form), data: { turbo: false } do |form| %>
+    <%= form.label :locale, t("shiplog.newsletter.preferences.language", default: "Language"), class: shiplog_class(:newsletter_label) %>
+    <%= form.select :locale, Shiplog::NewsletterSubscriber.allowed_locales.map { |locale| [ Shiplog::Translator.language_name(locale), locale ] },
+          { selected: @subscriber.locale }, class: shiplog_class(:newsletter_input) %>
+    <%= form.button t("shiplog.newsletter.preferences.save", default: "Save"), type: "submit", class: shiplog_class(:newsletter_button) %>
+  <% end %>
+  <div class="shiplog-newsletter__actions">
+    <% if @subscriber.unsubscribed? %>
+      <%= button_to t("shiplog.newsletter.preferences.resubscribe", default: "Resubscribe"), path, method: :patch, params: { subscribed: "1" }, class: shiplog_class(:newsletter_button), form: { data: { turbo: false } } %>
+    <% else %>
+      <%= button_to t("shiplog.newsletter.preferences.unsubscribe", default: "Unsubscribe"), path, method: :patch, params: { subscribed: "0" }, class: shiplog_class(:newsletter_button), form: { data: { turbo: false } } %>
+    <% end %>
+    <%= button_to t("shiplog.newsletter.preferences.delete", default: "Delete my data"), path, method: :delete, class: shiplog_class(:newsletter_button, :secondary), form: { data: { turbo: false } } %>
+  </div>
+  <p class="<%= shiplog_class(:newsletter_hint) %>"><%= t("shiplog.newsletter.preferences.delete_help", default: "Deleting your data removes your address from our records entirely, including the record that you unsubscribed.") %></p>
+<% end %>

data/app/views/shiplog/newsletter/rate_limited.html.erb

@@ -0,0 +1,4 @@
+<%# Too many subscribe attempts from one address or one IP (status 429) %>
+<%= render layout: "shiplog/newsletter/page", locals: { heading: t("shiplog.newsletter.rate_limited.heading", default: "Too many attempts") } do %>
+  <p><%= t("shiplog.newsletter.rate_limited.text", default: "Please try again in an hour.") %></p>
+<% end %>

data/app/views/shiplog/newsletter/subscriptions/show.html.erb

@@ -0,0 +1,16 @@
+<%# "Check your inbox" after the form, the same for every address; with @error (an address that is not an email),
+    the form again (status 422) %>
+<% if @error %>
+  <% content_for :title, t("shiplog.newsletter.title", default: "Newsletter") %>
+  <%= render layout: "shiplog/page", locals: { name: "newsletter" } do %>
+    <%= render "shiplog/page_header", title: t("shiplog.newsletter.title", default: "Newsletter"), lede: nil %>
+    <%= render "shiplog/newsletter/form", email: @email, error: @error, source: params[:source] %>
+    <p class="<%= shiplog_class(:footnote) %>">
+      <%= link_to t("shiplog.newsletter.back", default: "← Back to the changelog"), changelog_path, class: shiplog_class(:footnote_link) %>
+    </p>
+  <% end %>
+<% else %>
+  <%= render layout: "shiplog/newsletter/page", locals: { heading: t("shiplog.newsletter.sent.heading", default: "Check your inbox") } do %>
+    <p><%= t("shiplog.newsletter.sent.text", default: "We sent you a link to confirm your subscription. Open it to start receiving the monthly summary. If nothing arrives within a few minutes, look in your spam folder.") %></p>
+  <% end %>
+<% end %>

data/app/views/shiplog/newsletter/unsubscriptions/create.html.erb

@@ -0,0 +1,4 @@
+<%# Rendered by the unsubscribing POST (the button, or a mail provider's one-click request) %>
+<%= render layout: "shiplog/newsletter/page", locals: { heading: t("shiplog.newsletter.unsubscribe.done_heading", default: "You're unsubscribed") } do %>
+  <p><%= t("shiplog.newsletter.unsubscribe.done_text", email: @email, default: "%{email} will not receive the monthly summary anymore.") %></p>
+<% end %>

data/app/views/shiplog/newsletter/unsubscriptions/show.html.erb

@@ -0,0 +1,5 @@
+<%# The unsubscribe link's page: a button that POSTs (a GET unsubscribes nobody, link scanners prefetch) %>
+<%= render layout: "shiplog/newsletter/page", locals: { heading: t("shiplog.newsletter.unsubscribe.heading", default: "Unsubscribe") } do %>
+  <p><%= t("shiplog.newsletter.unsubscribe.text", email: @email, default: "Stop receiving the monthly summary at %{email}?") %></p>
+  <%= button_to t("shiplog.newsletter.unsubscribe.button", default: "Unsubscribe"), newsletter_unsubscription_path(params[:token]), method: :post, class: shiplog_class(:newsletter_button), form: { data: { turbo: false } } %>
+<% end %>

data/app/views/shiplog/newsletter_mailer/announcement.html.erb

@@ -0,0 +1,113 @@
+<%# The newsletter's HTML part: one 600px table column (fluid below that), every style inline (email clients drop
+    stylesheets), absolute image URLs with a width and an alt text, light colours that hold up when a client inverts
+    them for dark mode. @content is a Shiplog::Newsletter::Content: title, month, intro_html / highlights / rest_html
+    when the split rule applies (see Content), else the whole body as html; @unsubscribe_url and @preferences_url are
+    the recipient's own links. Copy this file into your app to change the design; keep the unsubscribe and preferences
+    links and the postal address (the List-Unsubscribe headers are set by the mailer). %>
+<% palette = shiplog_mail_palette %>
+<% font = shiplog_mail_font %>
+<% accent = @content.accent %>
+<% split = @content.highlights_shown? %>
+<!DOCTYPE html>
+<html lang="<%= I18n.locale %>">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<meta name="supported-color-schemes" content="light dark">
+<title><%= @content.title %></title>
+</head>
+<body style="margin:0;padding:0;background-color:<%= palette[:page] %>;color:<%= palette[:text] %>;font-family:<%= font %>;">
+<div style="display:none;max-height:0;overflow:hidden;font-size:1px;line-height:1px;color:<%= palette[:page] %>;"><%= @content.preheader %></div>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:<%= palette[:page] %>;">
+<tr>
+<td align="center" style="padding:24px 12px;">
+<table role="presentation" width="600" cellpadding="0" cellspacing="0" border="0" style="width:100%;max-width:600px;">
+<tr>
+<td style="padding:0 4px 14px;font-family:<%= font %>;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr>
+<td style="font-family:<%= font %>;font-size:16px;font-weight:700;color:<%= palette[:text] %>;vertical-align:middle;">
+<% if @content.logo_url %>
+<%= image_tag @content.logo_url, alt: @content.product_name, width: 140, style: "display:block;width:140px;max-width:140px;height:auto;border:0;" %>
+<% else %>
+<%= @content.product_name %>
+<% end %>
+</td>
+<% if @content.view_url %>
+<td align="right" style="font-family:<%= font %>;font-size:12px;line-height:1.5;color:<%= palette[:muted] %>;vertical-align:middle;white-space:nowrap;">
+<%= link_to t("shiplog.newsletter.mail.view_in_browser"), @content.view_url, style: "color:#{palette[:muted]};text-decoration:underline;" %>
+</td>
+<% end %>
+</tr>
+</table>
+</td>
+</tr>
+<tr>
+<td style="background-color:<%= palette[:card] %>;border:1px solid <%= palette[:border] %>;border-radius:10px;padding:36px 32px 28px;font-family:<%= font %>;">
+<p style="margin:0 0 10px;font-family:<%= font %>;font-size:12px;line-height:1.5;letter-spacing:0.1em;text-transform:uppercase;font-weight:600;color:<%= accent %>;"><%= t("shiplog.categories.announcement", default: "Monthly update") %> · <%= @content.month %></p>
+<h1 style="margin:0 0 16px;font-family:<%= font %>;font-size:32px;line-height:1.2;font-weight:800;letter-spacing:-0.01em;color:<%= palette[:text] %>;"><%= @content.title %></h1>
+<% if split %>
+<%= @content.intro_html %>
+<% else %>
+<%= @content.html %>
+<%= shiplog_mail_button t("shiplog.newsletter.mail.changelog_button"), @content.changelog_url, accent %>
+<% end %>
+</td>
+</tr>
+<% if split %>
+<% @content.highlights.each do |highlight| %>
+<tr>
+<td style="padding:16px 0 0;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:<%= palette[:card] %>;border:1px solid <%= palette[:border] %>;border-radius:10px;">
+<% if highlight.image? %>
+<tr>
+<td style="padding:0;line-height:0;">
+<%= shiplog_mail_screenshot(highlight) %>
+</td>
+</tr>
+<% end %>
+<tr>
+<td style="padding:24px 28px 26px;font-family:<%= font %>;">
+<h2 style="margin:0 0 8px;font-family:<%= font %>;font-size:21px;line-height:1.3;font-weight:700;color:<%= palette[:text] %>;"><%= link_to highlight.title, highlight.url, style: "color:#{palette[:text]};text-decoration:none;" %></h2>
+<% if highlight.summary.present? %>
+<p style="margin:0;font-family:<%= font %>;font-size:16px;line-height:1.6;color:<%= palette[:muted] %>;"><%= highlight.summary %></p>
+<% end %>
+<%= shiplog_mail_button t("shiplog.newsletter.mail.highlight_button"), highlight.url, accent, margin: "18px 0 0" %>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<% end %>
+<tr>
+<td style="padding:16px 0 0;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:<%= palette[:card] %>;border:1px solid <%= palette[:border] %>;border-radius:10px;">
+<tr>
+<td style="padding:28px 32px 28px;font-family:<%= font %>;">
+<%= @content.rest_html %>
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="margin:24px 0 0;"><tr><td style="border-top:1px solid <%= palette[:border] %>;font-size:0;line-height:0;">&nbsp;</td></tr></table>
+<%= shiplog_mail_button t("shiplog.newsletter.mail.changelog_button"), @content.changelog_url, accent, margin: "20px 0 0" %>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+<% end %>
+<tr>
+<td style="padding:28px 12px 8px;font-family:<%= font %>;font-size:12px;line-height:1.7;color:<%= palette[:muted] %>;text-align:center;">
+<%= t("shiplog.newsletter.mail.reason", product: @content.product_name) %><br>
+<%= link_to t("shiplog.newsletter.mail.unsubscribe"), @unsubscribe_url, style: "color:#{palette[:muted]};text-decoration:underline;" %>
+·
+<%= link_to t("shiplog.newsletter.mail.preferences"), @preferences_url, style: "color:#{palette[:muted]};text-decoration:underline;" %>
+<% if @content.address.present? %>
+<br><%= @content.address %>
+<% end %>
+</td>
+</tr>
+</table>
+</td>
+</tr>
+</table>
+</body>
+</html>

data/app/views/shiplog/newsletter_mailer/announcement.text.erb

@@ -0,0 +1,38 @@
+<%# The newsletter's text part: title, month, the intro, the highlights ("Title — sentence", then the URL) and the rest
+    of the body when the split rule applies (see Shiplog::Newsletter::Content), else the whole body; then the links. %>
+<%= @content.title %>
+<%= t("shiplog.categories.announcement", default: "Monthly update") %> · <%= @content.month %>
+<% if @content.view_url %>
+
+<%= t("shiplog.newsletter.mail.view_in_browser") %>: <%= @content.view_url %>
+<% end %>
+<% if @content.highlights_shown? %>
+<% if @content.intro_text.present? %>
+
+<%= @content.intro_text %>
+<% end %>
+<% @content.highlights.each do |highlight| %>
+
+<%= highlight.title %><% if highlight.summary.present? %> — <%= highlight.summary %><% end %>
+<%= highlight.url %>
+<% end %>
+<% if @content.rest_text.present? %>
+
+<%= @content.rest_text %>
+<% end %>
+<% else %>
+
+<%= @content.text %>
+<% end %>
+<% if @content.changelog_url %>
+
+<%= t("shiplog.newsletter.mail.changelog_button") %>: <%= @content.changelog_url %>
+<% end %>
+
+--
+<%= t("shiplog.newsletter.mail.reason", product: @content.product_name) %>
+<%= t("shiplog.newsletter.mail.unsubscribe") %>: <%= @unsubscribe_url %>
+<%= t("shiplog.newsletter.mail.preferences") %>: <%= @preferences_url %>
+<% if @content.address.present? %>
+<%= @content.address %>
+<% end %>

data/app/views/shiplog/newsletter_mailer/confirmation.html.erb

@@ -0,0 +1,43 @@
+<%# The double opt-in email: a button (and the link as text) the visitor opens to confirm; @subscriber, @confirmation_url
+    and @product_name. The link works for 7 days; a page with a button is what it opens (a POST confirms), so a
+    link scanner that prefetches it confirms nothing. %>
+<% palette = shiplog_mail_palette %>
+<% font = shiplog_mail_font %>
+<% accent = Shiplog.config.newsletter_accent || "#0969da" %>
+<!DOCTYPE html>
+<html lang="<%= I18n.locale %>">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<meta name="supported-color-schemes" content="light dark">
+<title><%= t("shiplog.newsletter.mail.confirm_subject", product: @product_name) %></title>
+</head>
+<body style="margin:0;padding:0;background-color:<%= palette[:page] %>;color:<%= palette[:text] %>;font-family:<%= font %>;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="background-color:<%= palette[:page] %>;">
+<tr>
+<td align="center" style="padding:24px 12px;">
+<table role="presentation" width="600" cellpadding="0" cellspacing="0" border="0" style="width:100%;max-width:600px;">
+<tr>
+<td style="background-color:<%= palette[:card] %>;border-radius:8px;padding:32px;font-family:<%= font %>;">
+<% if Shiplog.config.newsletter_logo_url %>
+<%= image_tag Shiplog.config.newsletter_logo_url, alt: @product_name, width: 140, style: "display:block;width:140px;max-width:140px;height:auto;border:0;margin:0 0 24px;" %>
+<% end %>
+<h1 style="margin:0 0 16px;font-family:<%= font %>;font-size:22px;line-height:1.3;font-weight:700;color:<%= palette[:text] %>;"><%= t("shiplog.newsletter.mail.confirm_heading") %></h1>
+<p style="margin:0 0 12px;font-family:<%= font %>;font-size:16px;line-height:1.6;color:<%= palette[:text] %>;"><%= t("shiplog.newsletter.mail.confirm_intro", product: @product_name, email: @subscriber.email) %></p>
+<%= shiplog_mail_button t("shiplog.newsletter.mail.confirm_button"), @confirmation_url, accent %>
+<p style="margin:24px 0 0;font-family:<%= font %>;font-size:13px;line-height:1.6;color:<%= palette[:muted] %>;"><%= t("shiplog.newsletter.mail.confirm_expiry") %></p>
+<p style="margin:12px 0 0;font-family:<%= font %>;font-size:12px;line-height:1.6;color:<%= palette[:muted] %>;word-break:break-all;"><%= t("shiplog.newsletter.mail.confirm_link_text") %> <%= link_to @confirmation_url, @confirmation_url, style: "color:#{palette[:muted]};" %></p>
+</td>
+</tr>
+<% if Shiplog.config.newsletter_address.present? %>
+<tr>
+<td style="padding:24px 12px;font-family:<%= font %>;font-size:12px;line-height:1.7;color:<%= palette[:muted] %>;text-align:center;"><%= Shiplog.config.newsletter_address %></td>
+</tr>
+<% end %>
+</table>
+</td>
+</tr>
+</table>
+</body>
+</html>

data/app/views/shiplog/newsletter_mailer/confirmation.text.erb

@@ -0,0 +1,12 @@
+<%# The double opt-in email's text part. %>
+<%= t("shiplog.newsletter.mail.confirm_heading") %>
+
+<%= t("shiplog.newsletter.mail.confirm_intro", product: @product_name, email: @subscriber.email) %>
+
+<%= t("shiplog.newsletter.mail.confirm_button") %>: <%= @confirmation_url %>
+
+<%= t("shiplog.newsletter.mail.confirm_expiry") %>
+<% if Shiplog.config.newsletter_address.present? %>
+
+<%= Shiplog.config.newsletter_address %>
+<% end %>