Feature/posts (#1050)

## Pull Request #1050: Feature/posts

### Overview
- Base branch: main
- Feature branch: feature/posts
- Commits: 20 (all on August 19, 2025)
- File changes: 28 files changed (+368 / −95)

### Key Highlights by File

1. .env.dev
   - Changed Elasticsearch port from 9201 to 9200.

2. app/builders/better_together/agreement_builder.rb
- Removed logic that links agreements to existing Privacy Policy, Terms
of Service, or Code of Conduct pages.

3. app/controllers/better_together/pages_controller.rb
- Removed :author_ids from permitted parameters for page
creation/updating.

4. app/models/better_together/page.rb
- Added rich text support with `translates :content, backend:
:action_text`.

5. app/models/better_together/post.rb
   - Added rich text content using Action Text.
   - Added cover image support with `attachable_cover_image`.
   - Automatically adds the post creator as an author on creation.
   - Enhanced search and indexing logic in `as_indexed_json`.
   - Retains slugging and validations.

6. app/models/concerns/better_together/attachments/images.rb
- Cleaned up variants for image attachments (`optimized_jpeg`,
`optimized_png`, etc.).

7. app/models/concerns/better_together/authorable.rb
   - Extended permitted parameters to include `author_ids` for posts.

8. app/models/concerns/better_together/publishable.rb
   - Added `published_at` to permitted attributes.
- Updated `published?` and `scheduled?` methods to use
`DateTime.current`.

9. app/views/better_together/posts/_empty.html.erb
   - New view partial: shows placeholder card when no posts exist.
   - Includes link to create a post if permitted.

10. app/views/better_together/posts/_form.html.erb
    - Enhanced form with:
      - Multiple authors (`author_ids`).
      - `published_at` datetime field.
      - Rich content editor (`translated_rich_text_field`).
      - Cover image attachment field.

11. app/views/better_together/posts/_post.html.erb
    - Post card updates:
      - Multi-author rendering via shared authors partial.
      - Displays publish date or “Unpublished” status.

12. app/views/better_together/posts/index.html.erb
- Updated rendering to show either post cards or empty partial using
`render(@posts) || render('empty')`.

### Summary
This pull request introduces a posts system into the Community Engine:
- Rich text content with Action Text
- Cover image attachments with optimized variants
- Multi-author support and automatic author attribution
- Publish scheduling with `published_at`
- Enhanced searchability and indexing
- UI improvements for empty states, author display, and post listings

### Next Steps / Considerations
- Confirm image variant definitions are correct and performant.
- Review UX for post editor (rich text and cover upload).
- Confirm permissions for setting `published_at` and managing authors.
- Test search indexing to ensure updates propagate correctly.

Author: rsmithlal

.env.dev

@@ -9,7 +9,7 @@ APP_DEFAULT_LOCALE='en'
 APP_AVAILABLE_LOCALES='es,en,fr'
 APP_FALLBACK_LOCALES='es,en,fr'
 
-ES_PORT='9201'
+ES_PORT='9200'
 ES_HOST='http://elasticsearch'
 # ELASTICSEARCH_URL='http://elasticsearch:9201'
 

app/builders/better_together/agreement_builder.rb

@@ -36,7 +36,7 @@ def build_privacy_policy # rubocop:todo Metrics/MethodLength, Metrics/AbcSize
         # If a Page exists for the privacy policy, link it so the page content
         # is shown to users instead of the agreement terms.
         page = BetterTogether::Page.find_by(identifier: 'privacy_policy') ||
-               BetterTogether::Page.find_by(slug: 'privacy-policy')
+               BetterTogether::Page.friendly.find('privacy-policy')
         agreement.update!(page: page) if page.present?
       end
       # rubocop:enable Metrics/AbcSize
@@ -58,7 +58,7 @@ def build_terms_of_service # rubocop:todo Metrics/MethodLength, Metrics/AbcSize
 
         # Link a Terms of Service Page if one exists
         page = BetterTogether::Page.find_by(identifier: 'terms_of_service') ||
-               BetterTogether::Page.find_by(slug: 'terms-of-service')
+               BetterTogether::Page.friendly.find('terms-of-service')
         agreement.update!(page: page) if page.present?
       end
       # rubocop:enable Metrics/AbcSize
@@ -80,7 +80,7 @@ def build_code_of_conduct # rubocop:todo Metrics/AbcSize, Metrics/MethodLength
 
         # Link a Code of Conduct Page if one exists
         page = BetterTogether::Page.find_by(identifier: 'code_of_conduct') ||
-               BetterTogether::Page.find_by(slug: 'code-of-conduct')
+               BetterTogether::Page.friendly.find('code-of-conduct')
         agreement.update!(page: page) if page.present?
       end
       # rubocop:enable Metrics/MethodLength

app/controllers/better_together/pages_controller.rb

@@ -147,7 +147,6 @@ def page_params # rubocop:todo Metrics/MethodLength
         :meta_description, :keywords, :published_at, :sidebar_nav_id,
         :privacy, :layout, :template, *Page.localized_attribute_list,
         *Page.extra_permitted_attributes,
-        author_ids: [],
         page_blocks_attributes: [
           :id, :position, :_destroy,
           {

app/models/better_together/page.rb

@@ -9,11 +9,12 @@ class Page < ApplicationRecord
     # to stamp newly-created authorships with the acting person.
     include Categorizable
     include Identifier
+    include Metrics::Viewable
     include Protected
     include Privacy
+    include Publishable
     include Searchable
     include TrackedActivity
-    include Metrics::Viewable
 
     categorizable
 
@@ -35,6 +36,8 @@ class Page < ApplicationRecord
     accepts_nested_attributes_for :page_blocks, allow_destroy: true
 
     translates :title, type: :string
+    alias name title
+
     translates :content, backend: :action_text
 
     settings index: default_elasticsearch_index
@@ -78,11 +81,6 @@ def as_indexed_json(_options = {}) # rubocop:todo Metrics/MethodLength
       )
     end
 
-    # Needed for elasticsearch results to work properly (April 22, 2025)
-    def name
-      title
-    end
-
     def primary_image
       hero_block&.background_image_file
     end

app/models/better_together/post.rb

@@ -3,20 +3,28 @@
 module BetterTogether
   # Represents a blog post
   class Post < ApplicationRecord
+    include Attachments::Images
     include Authorable
     include BlockFilterable
     include FriendlySlug
     include Categorizable
     include Creatable
     include Identifier
+    include Metrics::Viewable
     include Privacy
     include Publishable
+    include Searchable
+    include TrackedActivity
+
+    attachable_cover_image
 
     categorizable
 
     translates :title
-    translates :content, type: :text
-    # translates :content_html, type: :action_text
+    alias name title
+    translates :content, backend: :action_text
+
+    settings index: default_elasticsearch_index
 
     slugged :title
 
@@ -26,8 +34,31 @@ class Post < ApplicationRecord
     validates :content,
               presence: true
 
+    # Automatically grant the post creator an authorship record
+    after_create :add_creator_as_author
+
     def to_s
       title
     end
+
+    configure_attachment_cleanup
+
+    # Customize the data sent to Elasticsearch for indexing
+    def as_indexed_json(_options = {})
+      as_json(
+        only: [:id],
+        methods: [:title, :name, :slug, *self.class.localized_attribute_list.keep_if do |a|
+          a.starts_with?('title' || a.starts_with?('slug') || a.starts_with?('content'))
+        end]
+      )
+    end
+
+    private
+
+    def add_creator_as_author
+      return unless respond_to?(:creator_id) && creator_id.present?
+
+      authorships.find_or_create_by(author_id: creator_id)
+    end
   end
 end

app/models/concerns/better_together/attachments/images.rb

@@ -13,21 +13,11 @@ module Images
       included do
         def self.attachable_cover_image # rubocop:todo Metrics/MethodLength
           has_one_attached :cover_image do |attachable|
-            attachable.variant :optimized_jpeg, resize_to_limit: [2400, 1200],
-                                                # rubocop:todo Layout/LineLength
-                                                saver: { strip: true, quality: 85, interlace: true, optimize_coding: true, trellis_quant: true, quant_table: 3 }, format: 'jpg'
-            # rubocop:enable Layout/LineLength
-            attachable.variant :optimized_png, resize_to_limit: [2400, 1200],
-                                               saver: { strip: true, quality: 85, optimize_coding: true }, format: 'png'
+            attachable.variant :optimized_jpeg, resize_to_limit: [2400, 1200]
+            attachable.variant :optimized_png, resize_to_limit: [2400, 1200]
 
-            attachable.variant :optimized_card_jpeg, resize_to_limit: [1200, 300],
-                                                     # rubocop:todo Layout/LineLength
-                                                     saver: { strip: true, quality: 90, interlace: true, optimize_coding: true, trellis_quant: true, quant_table: 3 }, format: 'jpg'
-            # rubocop:enable Layout/LineLength
-            attachable.variant :optimized_card_png, resize_to_limit: [1200, 300],
-                                                    # rubocop:todo Layout/LineLength
-                                                    saver: { strip: true, quality: 90, optimize_coding: true }, format: 'png'
-            # rubocop:enable Layout/LineLength
+            attachable.variant :optimized_card_jpeg, resize_to_limit: [1200, 300]
+            attachable.variant :optimized_card_png, resize_to_limit: [1200, 300]
           end
 
           validates :cover_image,

app/models/concerns/better_together/authorable.rb

@@ -12,5 +12,15 @@ module Authorable
       has_many :authors,
                through: :authorships
     end
+
+    class_methods do
+      def extra_permitted_attributes
+        super + [
+          {
+            author_ids: []
+          }
+        ]
+      end
+    end
   end
 end

app/models/concerns/better_together/publishable.rb

@@ -23,12 +23,24 @@ def draft?
       end
 
       def published?
+        return false if published_at.nil?
+
         published_at <= DateTime.current
       end
 
       def scheduled?
+        return false if published_at.nil?
+
         published_at >= DateTime.current
       end
     end
+
+    class_methods do
+      def extra_permitted_attributes
+        super + [
+          :published_at
+        ]
+      end
+    end
   end
 end

app/views/better_together/posts/_empty.html.erb

@@ -0,0 +1,12 @@
+<div class="card mb-4 text-center w-100 py-4">
+  <div class="card-body">
+    <h3 class="card-title"> <%= t('better_together.posts.none_title', default: 'No posts yet') %> </h3>
+    <p class="card-text text-muted mb-3"><%= t('better_together.posts.none_body', default: "There are no posts to show right now.") %></p>
+
+    <div>
+      <% if policy(BetterTogether::Post).create? %>
+        <%= link_to t('better_together.posts.create_post', default: 'Create the first post'), new_post_path, class: 'btn btn-primary' %>
+      <% end %>
+    </div>
+  </div>
+</div>

app/views/better_together/posts/_form.html.erb

@@ -48,6 +48,24 @@
     <small class="form-text text-muted"><%= t('hints.categories.select_multiple') %></small>
   </div>
 
+  <div class="mb-3">
+    <%= form.label :author_ids, t('better_together.posts.authors', default: 'Authors') %>
+    <%= form.collection_select :author_ids,
+      BetterTogether::Person.all,
+      :id,
+      :select_option_title,
+      {},
+      { multiple: true,
+        class: "form-select#{' is-invalid' if post.errors[:author_ids].any?}",
+        data: { controller: 'better_together--slim-select' } } %>
+    <% if post.errors[:author_ids].any? %>
+      <div class="invalid-feedback">
+        <%= post.errors[:author_ids].join(', ') %>
+      </div>
+    <% end %>
+    <small class="form-text text-muted"><%= t('hints.authors.select_multiple', default: 'Select one or more authors') %></small>
+  </div>
+
   <div class="mb-3">
     <%= form.label :published_at %>
     <%= form.datetime_field :published_at, include_seconds: false, class: 'form-control' %>
@@ -57,5 +75,9 @@
     <%= render partial: 'better_together/shared/translated_rich_text_field', locals: { model: post, form: form, attribute: 'content' } %>
   </div>
 
+  <div class="mb-3">
+    <%= render 'better_together/shared/fields/attachments/cover_image', form: form %>
+  </div>
+
   <%= yield :resource_toolbar %>
 <% end %>