Post Templates

app/assets/javascripts/markdown.js

@@ -15,6 +15,14 @@ $(() => {
     $field.val(prev.substring(0, $field[0].selectionStart) + text + prev.substring($field[0].selectionEnd));
   };
 
+
+  $('.js-template').on('click', async ev => {
+    const $postField = $('.js-post-field');
+    $tgt = $(ev.target);
+    const content = $(`#template-md-${$tgt.attr('data-template-id')}`).val();
+    replaceSelection($postField, content);
+  });
+
   $(document).on('click', '.js-markdown-tool', ev => {
     const $tgt = $(ev.target);
     const $button = $tgt.is('a') ? $tgt : $tgt.parents('a');

app/assets/stylesheets/application.scss

@@ -133,7 +133,6 @@ hr {
 }
 
 .modal {
-  position: fixed !important;
   z-index: 8998;
 }
 

app/controllers/application_controller.rb

@@ -289,7 +289,7 @@ def pull_pinned_links_and_hot_questions
 
   def pull_categories
     @header_categories = Rails.cache.fetch('header_categories') do
-      Category.all.order(sequence: :asc, id: :asc)
+      Category.where.not(sequence: -1).order(sequence: :asc, id: :asc)
     end
   end
 

app/controllers/posts_controller.rb

@@ -160,7 +160,8 @@ def show
   def edit; end
 
   def update
-    before = { body: @post.body_markdown, title: @post.title, tags: @post.tags.to_a }
+    before = { body: @post.body_markdown, title: @post.title, tags: @post.tags.to_a,
+template_post_type: @post.template_post_type }
     body_rendered = helpers.post_markdown(:post, :body_markdown)
     new_tags_cache = params[:post][:tags_cache]&.reject(&:empty?)
 
@@ -183,7 +184,9 @@ def update
           PostHistory.post_edited(post, current_user, before: before[:body],
                                   after: @post.body_markdown, comment: params[:edit_comment],
                                   before_title: before[:title], after_title: @post.title,
-                                  before_tags: before[:tags], after_tags: @post.tags)
+                                  before_tags: before[:tags], after_tags: @post.tags,
+                                  before_template_post_type: before[:template_post_type],
+                                  after_template_post_type: @post.template_post_type)
         end
         flash[:success] = "#{helpers.pluralize(posts.to_a.size, 'post')} updated."
         redirect_to help_path(slug: @post.doc_slug)
@@ -195,7 +198,9 @@ def update
           PostHistory.post_edited(@post, current_user, before: before[:body],
                                   after: @post.body_markdown, comment: params[:edit_comment],
                                   before_title: before[:title], after_title: @post.title,
-                                  before_tags: before[:tags], after_tags: @post.tags)
+                                  before_tags: before[:tags], after_tags: @post.tags,
+                                  before_template_post_type: before[:template_post_type],
+                                  after_template_post_type: @post.template_post_type)
 
           if params[:redact]
             # Hide all previous history
@@ -540,7 +545,7 @@ def delete_draft
 
   def permitted
     [:post_type_id, :category_id, :parent_id, :title, :body_markdown, :license_id,
-     :doc_slug, :help_category, :help_ordering]
+     :doc_slug, :help_category, :help_ordering, :template_post_type_id]
   end
 
   def post_params

app/models/post.rb

@@ -14,6 +14,7 @@ class Post < ApplicationRecord
   belongs_to :license, optional: true
   belongs_to :close_reason, optional: true
   belongs_to :duplicate_post, class_name: 'Question', optional: true
+  belongs_to :template_post_type, class_name: 'PostType', optional: true
   has_and_belongs_to_many :tags, dependent: :destroy
   has_many :votes, dependent: :destroy
   has_many :comments, dependent: :destroy
@@ -64,7 +65,7 @@ def self.search(term)
 
   # Double-define: initial definitions are less efficient, so if we have a record of the post type we'll
   # override them later with more efficient methods.
-  ['Question', 'Answer', 'PolicyDoc', 'HelpDoc', 'Article'].each do |pt|
+  ['Question', 'Answer', 'PolicyDoc', 'HelpDoc', 'Article', 'PostTemplate'].each do |pt|
     define_method "#{pt.underscore}?" do
       post_type_id == pt.constantize.post_type_id
     end

app/models/post_history.rb

@@ -1,5 +1,7 @@
 class PostHistory < ApplicationRecord
   include PostRelated
+  belongs_to :before_template_post_type, class_name: 'PostType', optional: true
+  belongs_to :after_template_post_type, class_name: 'PostType', optional: true
   belongs_to :post_history_type
   belongs_to :user
   has_many :post_history_tags
@@ -25,7 +27,8 @@ def self.method_missing(name, *args, **opts)
     end
 
     object, user = args
-    fields = [:before, :after, :comment, :before_title, :after_title, :before_tags, :after_tags, :hidden]
+    fields = [:before, :after, :comment, :before_title, :after_title, :before_tags, :after_tags, :hidden,
+              :before_template_post_type, :after_template_post_type]
     values = fields.to_h { |f| [f, nil] }.merge(opts)
 
     history_type_name = name.to_s
@@ -37,7 +40,8 @@ def self.method_missing(name, *args, **opts)
 
     params = { post_history_type: history_type, user: user, post: object, community_id: object.community_id }
     { before: :before_state, after: :after_state, comment: :comment, before_title: :before_title,
-      after_title: :after_title, hidden: :hidden }.each do |arg, attr|
+      after_title: :after_title, hidden: :hidden, before_template_post_type: :before_template_post_type,
+      after_template_post_type: :after_template_post_type }.each do |arg, attr|
       next if values[arg].nil?
 
       params = params.merge(attr => values[arg])

app/models/post_template.rb

@@ -0,0 +1,5 @@
+class PostTemplate < Post
+  def self.post_type_id
+    PostType.mapping['PostTemplate']
+  end
+end

app/models/post_type.rb

@@ -19,6 +19,10 @@ def reactions
     end
   end
 
+  def templates
+    Post.undeleted.where(post_type_id: PostTemplate.post_type_id).where(template_post_type: self).to_a
+  end
+
   def self.mapping
     Rails.cache.fetch 'network/post_types/post_type_ids', include_community: false do
       PostType.all.to_h { |pt| [pt.name, pt.id] }

app/views/categories/_form.html.erb

@@ -141,7 +141,8 @@
       <%= f.label :sequence, class: 'form-element' %>
       <span class="form-caption">
       The order in which this category will appear in the header and on the category list page. Higher numbers
-      appear later.
+      appear later. Set to -1 to prevent the category from being listed. Note that users will still be able
+      to access it even when not listed; to change who can access it, change the minimum trust level instead.
     </span>
       <%= f.number_field :sequence, class: 'form-element' %>
     </div>

app/views/post_history/post.html.erb

@@ -61,5 +61,10 @@
         <em>The detailed changes of this event are hidden because of a redaction.</em>
       </p>
     <% end %>
+    <% if (event.before_template_post_type.present? || event.after_template_post_type.present?) &&
+           event.before_template_post_type != event.after_template_post_type %>
+      <h3><%= t('posts.template_post_type_label') %></h3>
+      <%= render 'diff', before: event.before_template_post_type.name, after: event.after_template_post_type.name, post: @post %>
+    <% end %>
   </details>
 <% end %>

app/views/posts/_form.html.erb

@@ -55,7 +55,7 @@
   <% end %>
 
   <%= render 'shared/body_field', f: f, field_name: :body_markdown, field_label: t('posts.body_label'), post: post,
-             min_length: min_body_length(category), max_length: max_body_length(category) %>
+             min_length: min_body_length(category), max_length: max_body_length(category), post_type: post_type %>
 
   <div class="post-preview"></div>
 
@@ -173,6 +173,14 @@
     <% end %>
   <% end %>
 
+  <% if post_type.id == PostTemplate.post_type_id %>
+    <div class="form-group">
+      <%= f.label :template_post_type_id, t('posts.template_post_type_label'), class: "form-element" %>
+      <%= f.select :template_post_type_id, options_for_select(PostType.all.map { |pt| [pt.name.underscore.humanize, pt.id] },
+                                                              selected: post.template_post_type_id), {}, { class: "form-element" } %>
+    </div>
+  <% end %>
+
   <% if edit_comment %>
     <hr/>
     <div class="form-group">

app/views/posts/new.html.erb

@@ -1,5 +1,5 @@
 <h1 class="has-margin-bottom-2">
-  New Post
+  New <%= @post_type.name.underscore.humanize.titleize %>
   <% if @category.present? %>
     in <%= @category.name %>
   <% end %>

app/views/shared/_body_field.html.erb

@@ -35,7 +35,7 @@
         end[1]
       %>
     <% end %>
-    <%= render 'shared/markdown_tools' %>
+    <%= render 'shared/markdown_tools', post_type: post&.post_type if post.is_a? Post %>
     <%= f.text_area field_name, **({ class: classes, rows: 15, placeholder: 'Start typing your post...' }).merge(value), 
                                 data: { character_count: ".js-character-count-post-body" } %>
     <%= render 'posts/mdhint', min_length: min_length, max_length: max_length %>

app/views/shared/_markdown_tools.html.erb

@@ -22,6 +22,43 @@
 </div>
 
 <div class="markdown-tools widget--header js-markdown-tools">
+  <% templates = post_type&.templates || [] %>
+  <% if templates.any? %>
+    <div class="button-list is-gutterless">
+      <a href="javascript:void(0)" class="button is-outlined is-muted is-icon-only" data-drop="#templates"
+        data-drop-self-class-toggle="is-active" aria-label="Templates" title="Templates" role="button">
+        <i class="fas fa-copy"></i>
+      </a>
+      <div class="droppanel" id="templates">
+        <% templates.each do |template| %>
+          <a href="javascript:void(0)" class="js-template" aria-label="<%= template.title %>"
+            title="<%= template.title %>" role="button" data-template-id="<%= template.id %>">
+            <%= template.title %>
+          </a>
+          <a href="javascript:void(0)" data-modal="#template-<%= template.id %>"><i class="fas fa-fw fa-question-circle"></i></a>
+        <% end %>
+      </div>
+      <% templates.each do |template| %>
+        <div class="modal" id="template-<%= template.id %>">
+          <div class="modal--container">
+            <div class="modal--header">
+              <button class="button is-close-button modal--header-button" data-modal="#template-<%= template.id %>">&times;</button>
+              <%= link_to template.title, generic_share_link(template) %>
+            </div>
+            <div class="modal--body">
+              <textarea disabled id="template-md-<%= template.id %>"
+                class='form-element post-field widget--body h-b-0 h-m-0'><%= template.body_markdown %></textarea>
+              <%= sanitize(template.body) %>        
+            </div>
+            <div class="modal--footer">
+              <a href="javascript:void(0)" class="js-template" aria-label="<%= template.title %>"
+                title="<%= template.title %>" role="button" data-template-id="<%= template.id %>">Apply</a>
+            </div>
+          </div>
+        </div>
+      <% end %>
+    </div>
+  <% end %>
   <div class="button-list is-gutterless">
     <%= md_button action: 'bold', label: 'Bold', class: 'is-icon-only' do %>
       <i class="fas fa-fw fa-bold"></i>

app/views/tour/question2.html.erb

@@ -28,7 +28,7 @@
     <div class="form-group">
       <label for="tour-post-body" class="form-element">Body</label>
       <div class="widget">
-        <%= render 'shared/markdown_tools' %>
+        <%= render 'shared/markdown_tools', post_type: nil %>
         <textarea class="form-element post-field js-post-field widget--body h-b-0 h-m-0" rows=15 placeholder="Start typing your post..." id="tour-post-body"></textarea>
         <%= render 'posts/mdhint' %>
       </div>

config/locales/strings/en.posts.yml

@@ -52,6 +52,8 @@ en:
       Redact original content by hiding the previous versions from history?
     licence_label: >
       License
+    template_post_type_label: >
+      For Post Type
     unsaved_changes_confirmation: >
       Any unsaved changes will be lost. Are you sure?
     category_label: >

db/migrate/20230801014134_add_template_post_type_to_posts.rb

@@ -0,0 +1,5 @@
+class AddTemplatePostTypeToPosts < ActiveRecord::Migration[7.0]
+  def change
+    add_reference :posts, :template_post_type, foreign_key: { to_table: :post_types }
+  end
+end

db/migrate/20230813161623_add_before_and_after_template_post_type_to_post_histories.rb

@@ -0,0 +1,6 @@
+class AddBeforeAndAfterTemplatePostTypeToPostHistories < ActiveRecord::Migration[7.0]
+  def change
+    add_reference :post_histories, :before_template_post_type, foreign_key: { to_table: :post_types }
+    add_reference :post_histories, :after_template_post_type, foreign_key: { to_table: :post_types }
+  end
+end

db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[7.0].define(version: 2023_08_03_191600) do
+ActiveRecord::Schema[7.0].define(version: 2023_08_13_161623) do
   create_table "abilities", charset: "utf8mb4", collation: "utf8mb4_0900_ai_ci", force: :cascade do |t|
     t.bigint "community_id"
     t.string "name"
@@ -111,7 +111,9 @@
     t.boolean "use_for_advertisement", default: true
     t.integer "min_title_length", default: 15, null: false
     t.integer "min_body_length", default: 30, null: false
+    t.bigint "default_filter_id"
     t.index ["community_id"], name: "index_categories_on_community_id"
+    t.index ["default_filter_id"], name: "index_categories_on_default_filter_id"
     t.index ["license_id"], name: "index_categories_on_license_id"
     t.index ["sequence"], name: "index_categories_on_sequence"
     t.index ["tag_set_id"], name: "index_categories_on_tag_set_id"
@@ -386,7 +388,11 @@
     t.bigint "community_id"
     t.string "before_title"
     t.string "after_title"
+    t.bigint "before_template_post_type_id"
+    t.bigint "after_template_post_type_id"
     t.boolean "hidden", default: false, null: false
+    t.index ["after_template_post_type_id"], name: "index_post_histories_on_after_template_post_type_id"
+    t.index ["before_template_post_type_id"], name: "index_post_histories_on_before_template_post_type_id"
     t.index ["community_id"], name: "index_post_histories_on_community_id"
     t.index ["post_history_type_id"], name: "index_post_histories_on_post_history_type_id"
     t.index ["post_id"], name: "index_post_histories_on_post_type_and_post_id"
@@ -425,8 +431,8 @@
     t.boolean "is_top_level", default: false, null: false
     t.boolean "is_freely_editable", default: false, null: false
     t.string "icon_name"
-    t.boolean "has_reactions"
     t.bigint "answer_type_id"
+    t.boolean "has_reactions"
     t.boolean "has_only_specific_reactions"
     t.index ["answer_type_id"], name: "index_post_types_on_answer_type_id"
     t.index ["name"], name: "index_post_types_on_name"
@@ -472,6 +478,7 @@
     t.bigint "locked_by_id"
     t.datetime "locked_at", precision: nil
     t.datetime "locked_until", precision: nil
+    t.bigint "template_post_type_id"
     t.index ["att_source"], name: "index_posts_on_att_source"
     t.index ["body_markdown"], name: "index_posts_on_body_markdown", type: :fulltext
     t.index ["category_id"], name: "index_posts_on_category_id"
@@ -489,6 +496,7 @@
     t.index ["post_type_id"], name: "index_posts_on_post_type_id"
     t.index ["score"], name: "index_posts_on_score"
     t.index ["tags_cache"], name: "index_posts_on_tags_cache"
+    t.index ["template_post_type_id"], name: "index_posts_on_template_post_type_id"
     t.index ["upvote_count"], name: "index_posts_on_upvote_count"
     t.index ["user_id"], name: "index_posts_on_user_id"
   end
@@ -756,15 +764,16 @@
     t.datetime "created_at", precision: nil, null: false
     t.datetime "updated_at", precision: nil, null: false
     t.boolean "read", default: false
-    t.index ["author_id"], name: "index_warnings_on_author_id"
-    t.index ["community_user_id"], name: "index_warnings_on_community_user_id"
+    t.index ["author_id"], name: "index_mod_messages_on_author_id"
+    t.index ["community_user_id"], name: "index_mod_messages_on_community_user_id"
   end
 
   add_foreign_key "abilities", "communities"
   add_foreign_key "active_storage_attachments", "active_storage_blobs", column: "blob_id"
   add_foreign_key "active_storage_variant_records", "active_storage_blobs", column: "blob_id"
   add_foreign_key "audit_logs", "communities"
   add_foreign_key "audit_logs", "users"
+  add_foreign_key "categories", "filters", column: "default_filter_id"
   add_foreign_key "categories", "licenses"
   add_foreign_key "categories", "tag_sets"
   add_foreign_key "category_filter_defaults", "categories"
@@ -791,12 +800,15 @@
   add_foreign_key "pinned_links", "communities"
   add_foreign_key "pinned_links", "posts"
   add_foreign_key "post_histories", "communities"
+  add_foreign_key "post_histories", "post_types", column: "after_template_post_type_id"
+  add_foreign_key "post_histories", "post_types", column: "before_template_post_type_id"
   add_foreign_key "post_history_tags", "post_histories"
   add_foreign_key "post_history_tags", "tags"
   add_foreign_key "post_types", "post_types", column: "answer_type_id"
   add_foreign_key "posts", "close_reasons"
   add_foreign_key "posts", "communities"
   add_foreign_key "posts", "licenses"
+  add_foreign_key "posts", "post_types", column: "template_post_type_id"
   add_foreign_key "posts", "posts", column: "duplicate_post_id"
   add_foreign_key "posts", "users", column: "locked_by_id"
   add_foreign_key "privileges", "communities"