AO3-5610 notify users when a bookmark or series they have created is hidden

app/mailers/user_mailer.rb

@@ -376,6 +376,30 @@ def admin_deleted_work_notification(user, work)
     end
   end
 
+  def admin_hidden_bookmark_notification(creation_id, user_id)
+    @user = User.find_by(id: user_id)
+    @bookmark = Bookmark.find_by(id: creation_id)
+
+    I18n.with_locale(@user.preference.locale.iso) do
+      mail(
+        to: @user.email,
+        subject: default_i18n_subject(app_name: ArchiveConfig.APP_SHORT_NAME)
+      )
+    end
+  end
+
+  def admin_hidden_series_notification(creation_id, user_id)
+    @user = User.find_by(id: user_id)
+    @series = Series.find_by(id: creation_id)
+
+    I18n.with_locale(@user.preference.locale.iso) do
+      mail(
+        to: @user.email,
+        subject: default_i18n_subject(app_name: ArchiveConfig.APP_SHORT_NAME)
+      )
+    end
+  end
+
   # Sends email to creators when a creation is hidden by an admin
   def admin_hidden_work_notification(creation_id, user_id)
     @user = User.find_by(id: user_id)

app/models/bookmark.rb

@@ -32,6 +32,8 @@ def check_new_external_work
     end
   end
 
+  after_update :admin_hidden_bookmark_notification, if: :hidden_by_admin_changed?
+
   # renaming scope :public -> :is_public because otherwise it overlaps with the "public" keyword
   scope :is_public, -> { where(private: false, hidden_by_admin: false) }
   scope :not_public, -> { where(private: true) }
@@ -213,4 +215,14 @@ def bookmarkable_date
       bookmarkable.updated_at
     end
   end
+
+  private
+
+  def admin_hidden_bookmark_notification
+    return unless hidden_by_admin?
+
+    users.each do |user|
+      UserMailer.send_bookmark_hidden_notification(id, user.id).deliver_later
+    end
+  end
 end

app/models/series.rb

@@ -22,6 +22,8 @@ class Series < ApplicationRecord
     maximum: ArchiveConfig.TITLE_MAX,
     too_long: ts("must be less than %{max} letters long.", max: ArchiveConfig.TITLE_MAX)
 
+  after_update :admin_hidden_series_notification, if: :hidden_by_admin_changed?
+
   # return title.html_safe to overcome escaping done by sanitiser
   def title
     read_attribute(:title).try(:html_safe)
@@ -307,4 +309,14 @@ def creators
   def work_types
     works.map(&:work_types).flatten.uniq
   end
+
+  private
+
+  def admin_hidden_series_notification
+    return unless hidden_by_admin?
+
+    users.each do |user|
+      UserMailer.send_series_hidden_notification(id, user.id).deliver_later
+    end
+  end
 end

app/views/user_mailer/admin_hidden_bookmark_notification.html.erb

@@ -0,0 +1,13 @@
+<% content_for :message do %>
+  <p><%= t("mailer.general.greeting.formal_html", name: style_bold(@user.login)) %></p>
+
+  <p><%= t(".hidden.html", bookmark_url: style_creation_link("bookmark", @bookmark)) %></p>
+
+  <p><%= t(".access") %></p>
+
+  <p><%= t(".check_email") %></p>
+
+  <p><%= t(".tos_violation.html", tos_link: tos_link(t(".tos"))) %></p>
+
+  <p><%= t(".help.html", contact_abuse_link: abuse_link(t(".contact_abuse"))) %></p>
+<% end %>

app/views/user_mailer/admin_hidden_bookmark_notification.text.erb

@@ -0,0 +1,13 @@
+<% content_for :message do %>
+<%= t("mailer.general.greeting.formal_html", name: @user.login) %>
+
+<%= t(".hidden.text", bookmark_url: bookmark_url(@bookmark)) %>
+
+<%= t(".access") %>
+
+<%= t(".check_email") %>
+
+<%= t(".tos_violation.text", tos_url: tos_url) %>
+
+<%= t(".help.text", contact_abuse_url: new_abuse_report_url) %>
+<% end %>

app/views/user_mailer/admin_hidden_series_notification.html.erb

@@ -0,0 +1,13 @@
+<% content_for :message do %>
+  <p><%= t("mailer.general.greeting.formal_html", name: style_bold(@user.login)) %></p>
+
+  <p><%= t(".hidden.html", title: style_creation_link(@series.title, @series)) %></p>
+
+  <p><%= t(".access") %></p>
+
+  <p><%= t(".check_email") %></p>
+
+  <p><%= t(".tos_violation.html", tos_link: tos_link(t(".tos"))) %></p>
+
+  <p><%= t(".help.html", contact_abuse_link: abuse_link(t(".contact_abuse"))) %></p>
+<% end %>

app/views/user_mailer/admin_hidden_series_notification.text.erb

@@ -0,0 +1,13 @@
+<% content_for :message do %>
+<%= t("mailer.general.greeting.formal_html", name: @user.login) %>
+
+<%= t(".hidden.text", title: @series.title, series_url: series_url(@series)) %>
+
+<%= t(".access") %>
+
+<%= t(".check_email") %>
+
+<%= t(".tos_violation.text", tos_url: tos_url) %>
+
+<%= t(".help.text", contact_abuse_url: new_abuse_report_url) %>
+<% end %>

config/locales/mailers/en.yml

@@ -120,6 +120,36 @@ en:
       subject: "[%{app_name}] Your work has been deleted by an admin"
       text:
         tos_violation: If it's possible your work violated the Archive's Terms of Service, please contact our Policy & Abuse team (%{contact_abuse_url}).
+    admin_hidden_bookmark_notification:
+      access: While your bookmark is hidden, you will still be able to access it through the link provided above, but it will not be listed on your bookmarks page, and it won't be available to other users of the Archive.
+      check_email: Please check your email, including your spam folder, as the Policy & Abuse team may have already contacted you explaining why your bookmark was hidden.
+      contact_abuse: contact Policy & Abuse
+      help:
+        html: If you are uncertain why your bookmark was hidden, and you have not received further communication regarding this matter, please %{contact_abuse_link} directly.
+        text: 'If you are uncertain why your bookmark was hidden, and you have not received further communication regarding this matter, please contact Policy & Abuse directly: %{contact_abuse_url}.'
+      hidden:
+        html: Your %{bookmark_url} has been hidden by the Policy & Abuse team and is no longer publicly accessible.
+        text: Your bookmark (%{bookmark_url}) has been hidden by the Policy & Abuse team and is no longer publicly accessible.
+      subject: "[%{app_name}] Your bookmark has been hidden by the Policy & Abuse team"
+      tos: Terms of Service
+      tos_violation:
+        html: If your bookmark was hidden due to being in violation of the Archive of Our Own's %{tos_link}, you will be required to take action to correct the violation. Failure to bring your bookmark into compliance with the Terms of Service may lead to your bookmark being deleted from the Archive.
+        text: If your bookmark was hidden due to being in violation of the Archive of Our Own's Terms of Service (%{tos_url}), you will be required to take action to correct the violation. Failure to bring your bookmark into compliance with the Terms of Service may lead to your bookmark being deleted from the Archive.
+    admin_hidden_series_notification:
+      access: While your series is hidden, you will still be able to access it through the link provided above, but it will not be listed on your series' page, and it won't be available to other users of the Archive.
+      check_email: Please check your email, including your spam folder, as the Policy & Abuse team may have already contacted you explaining why your series was hidden.
+      contact_abuse: contact Policy & Abuse
+      help:
+        html: If you are uncertain why your series was hidden, and you have not received further communication regarding this matter, please %{contact_abuse_link} directly.
+        text: 'If you are uncertain why your series was hidden, and you have not received further communication regarding this matter, please contact Policy & Abuse directly: %{contact_abuse_url}.'
+      hidden:
+        html: Your series %{title} has been hidden by the Policy & Abuse team and is no longer publicly accessible.
+        text: Your series "%{title}" (%{series_url}) has been hidden by the Policy & Abuse team and is no longer publicly accessible.
+      subject: "[%{app_name}] Your series has been hidden by the Policy & Abuse team"
+      tos: Terms of Service
+      tos_violation:
+        html: If your series was hidden due to being in violation of the Archive of Our Own's %{tos_link}, you will be required to take action to correct the violation. Failure to bring your series into compliance with the Terms of Service may lead to your series being deleted from the Archive.
+        text: If your series was hidden due to being in violation of the Archive of Our Own's Terms of Service (%{tos_url}), you will be required to take action to correct the violation. Failure to bring your series into compliance with the Terms of Service may lead to your series being deleted from the Archive.
     admin_hidden_work_notification:
       access: While your work is hidden, you will still be able to access it through the link provided above, but it will not be listed on your works page, and it won't be available to other users of the Archive.
       check_email: Please check your email, including your spam folder, as the Policy & Abuse team may have already contacted you explaining why your work was hidden.

test/mailers/previews/user_mailer_preview.rb

@@ -40,6 +40,18 @@ def claim_notification_registered
     UserMailer.claim_notification(creator_id, [work.id], true)
   end
 
+  def admin_hidden_bookmark_notification
+    bookmark = create(:bookmark)
+    creator_id = bookmark.pseud.user_id
+    UserMailer.admin_hidden_bookmark_notification(bookmark.id, creator_id)
+  end
+
+  def admin_hidden_series_notification
+    series = create(:series)
+    creator_id = series.pseuds.first.user_id
+    UserMailer.admin_hidden_series_notification(series.id, creator_id)
+  end
+
   private
 
   def creatorship_notification_data(creation_type)