RubyGems - helios-press - Versions diffs - 0.4 → 0.5 - Mend

helios-press 0.4 → 0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

checksums.yaml +4 -4
data/MIT-LICENSE +1 -1
data/README.md +49 -1
data/app/controllers/helios/press/admin/posts_controller.rb +1 -1
data/app/models/helios/press/post.rb +33 -0
data/app/views/helios/press/admin/posts/_form.html.erb +7 -1
data/app/views/helios/press/posts/show.html.erb +3 -20
data/app/views/layouts/helios/press/application.html.erb +1 -1
data/lib/helios/press/configuration.rb +7 -1
data/lib/helios/press/engine.rb +18 -0
data/lib/helios/press/version.rb +1 -1
metadata +18 -7

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ea59768263242ec8f88e1bd68e8d33f67f4b5a313d32626ac735632be159672
-  data.tar.gz: f2aa7c604191d1e340f18c1c9cf980d6f988407deff6127953a023572bcd1ef6
+  metadata.gz: 81300e27ac6528a2ed98720628689300cb0be7257061154bbecc6ecfb8734ca6
+  data.tar.gz: 145396036b9ce29b1ea7eb700e3a8af95f0d33329852c8f79ac375b913a0df50
 SHA512:
-  metadata.gz: fa4299b094dca0fc56ef35d1c930146cabbf6020bc4561f7482c140a1d9fac88a995f56a18a7aa53da51331f03e1b75e9d4d88f3c26c66b52968594673567752
-  data.tar.gz: 6e804a7772de4fe2f6b29ed41b1f111bede76ef00b86e39e3215bf07f311ac30344e28cafde50df2e11e5878dc843cd585272536bfc4bd9bb43634a1168c6352
+  metadata.gz: 469105b200430a999c911d10e90744e2936824e5224079cb91fe97fb4753599f398ba197a6bbfe232fcf7e52784b519904b62e9b71799d0d48770950100a77e8
+  data.tar.gz: ed7b189d44a41125b0fa0fe3d44c59c4912ffbf48b20cee7a0f6b1e49c6fd924e191d0ad38020737435982d9721e7a8fed239e16b80ad468dab983dffd13f707

data/MIT-LICENSE CHANGED Viewed

@@ -1,4 +1,4 @@
-Copyright TODO: Write your name
+Copyright (c) 2026 Jason Fleetwood-Boldt
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md CHANGED Viewed

@@ -38,6 +38,11 @@ Helios::Press.configure do |config|
   # Optional slug prefix for posts
   config.post_slug_prefix = nil  # e.g., "blog/" for /blog/my-post
+  # SEO / social metadata
+  config.site_name = "My Blog"                          # og:site_name and <title> fallback
+  config.twitter_site = "@myhandle"                     # twitter:site card handle
+  config.default_image_url = nil                        # fallback og:image when a post has no image
   # API authentication (for external post ingestion)
   # Default: checks X-API-Key header against BLOG_INGEST_API_KEY env var
   config.api_authentication = ->(controller) {
@@ -50,6 +55,34 @@ Helios::Press.configure do |config|
 end
 ```
+## SEO (helios-seo)
+helios-press delegates the entire page `<head>` — meta description, canonical,
+robots, Open Graph, Twitter cards, and the JSON-LD graph — to
+[helios-seo](../helios-seo), which it depends on. Press only supplies the
+per-post share image; the post `show` view calls
+`helios_seo_tags(@post, title: false)` (the layout keeps ownership of `<title>`).
+Integration checklist:
+1. **Configure helios-seo** in `config/initializers/helios_seo.rb` — set
+   `site_name`, `site_url`, `author`, `twitter_site` / `twitter_creator`, and
+   `default_og_image`. These now live in helios-seo; the old
+   `Helios::Press` SEO settings (`twitter_site`, `default_image_url`) are
+   superseded. (`config.site_name` on Press is still used as the layout
+   `<title>` fallback.)
+2. **Layout** — make sure your layout yields `:head` inside `<head>`. The
+   bundled Press layout already does.
+3. **Per-post share image** — authors can upload a "Social share image" in the
+   post form to override; otherwise the post's banner (its first image block) is
+   used. Falls back to helios-seo's site-wide `default_og_image`. Requires
+   ActiveStorage (already used by Press image blocks).
+4. **Canonical URLs** default to `"{site_url}/{slug}"`, which matches the public
+   `get ":slug"` route when the Public engine is mounted at root. On a subpath
+   mount, set `config.canonical_url` in the helios-seo initializer.
+5. **`/llms.txt`** (optional) — mount `Helios::Seo::Engine` at root to serve it;
+   set `config.llms_posts = -> { Helios::Press::Post.published.reverse_sorted }`.
 ## Routes
 Helios::Press provides three independent engines that you can mount wherever you want:
@@ -185,6 +218,21 @@ Two modes are supported:
 Images are stored as `BlockImage` records with ActiveStorage attachments and served via `rails_storage_proxy_path`. Failed downloads are logged and skipped (soft failure — the original src is preserved).
+## Releases
+### 0.5
+- SEO delegated to [helios-seo](../helios-seo) (new dependency). The post `show`
+  view now renders `helios_seo_tags(@post, title: false)` instead of the bundled
+  `_meta_tags` partial, adding a meta description, `robots`, and a JSON-LD graph
+  on top of the previous Open Graph / Twitter tags.
+- Removed `app/views/helios/press/posts/_meta_tags.html.erb` and
+  `app/helpers/helios/press/seo_helper.rb` (superseded by helios-seo).
+- `Post` gains an optional `og_image` attachment (a "Social share image" field in
+  the admin form) plus `Post#og_image_url`, which builds a stable, absolute
+  ActiveStorage proxy URL for the post's share image, falling back to the post's
+  banner (first image block). See the [SEO](#seo-helios-seo) section.
 ## License
-Proprietary. All rights reserved.
+MIT License. See [MIT-LICENSE](MIT-LICENSE) for details.

data/app/controllers/helios/press/admin/posts_controller.rb CHANGED Viewed

@@ -60,7 +60,7 @@ module Helios
         end
         def post_params
-          params.require(:post).permit(:name, :published, :slug, :keywords, :description)
+          params.require(:post).permit(:name, :published, :slug, :keywords, :description, :og_image)
         end
         def helios_press_admin

data/app/models/helios/press/post.rb CHANGED Viewed

@@ -3,6 +3,10 @@ module Helios
     class Post < ActiveRecord::Base
       self.table_name = "helios_press_posts"
+      # Optional explicit social-share image. When set it overrides the banner;
+      # otherwise the post's banner (first image block) is used. See #og_image_url.
+      has_one_attached :og_image
       has_many :blocks, -> { order(position: :asc) },
                class_name: "Helios::Press::Block",
                foreign_key: :post_id,
@@ -18,8 +22,37 @@ module Helios
       scope :published, -> { where(published: true) }
       scope :reverse_sorted, -> { order(updated_at: :desc) }
+      # Absolute URL for the post's social-share image, sized to the OG-
+      # recommended 1200x630. Prefers the explicit `og_image` override, then
+      # falls back to the post's banner (the first attached image block). Returns
+      # nil when neither exists, so helios-seo can fall back to its site-wide
+      # default.
+      #
+      # `view` is the ActionView context helios-seo passes into the resolver. We
+      # use `view.polymorphic_url` so the result is the stable ActiveStorage
+      # proxy/redirect URL (per the app's resolve_model_to_route) — absolute,
+      # using the request host — NOT the short-lived signed service URL that
+      # `.url` returns. Degrades to nil on any failure (e.g. no view context).
+      def og_image_url(view: nil)
+        attachment = og_image.attached? ? og_image : banner_image
+        return nil unless attachment && view
+        variant = attachment.variant(resize_to_limit: [ 1200, 630 ])
+        view.polymorphic_url(variant)
+      rescue StandardError
+        nil
+      end
       private
+      # The post's banner: the first attached image in the first image block.
+      def banner_image
+        image_block = blocks.detect do |block|
+          block.block_type == "image_container" && block.block_images.any?
+        end
+        image_block&.block_images&.detect { |bi| bi.file.attached? }&.file
+      end
       def generate_slug
         prefix = Helios::Press.configuration.post_slug_prefix
         base_slug = name.parameterize

data/app/views/helios/press/admin/posts/_form.html.erb CHANGED Viewed

@@ -1,4 +1,4 @@
-<%= form_with(model: post, url: post.persisted? ? helios_press_admin.post_path(post) : helios_press_admin.posts_path, local: true) do |form| %>
+<%= form_with(model: post, url: post.persisted? ? helios_press_admin.post_path(post) : helios_press_admin.posts_path, local: true, multipart: true) do |form| %>
   <% if post.errors.any? %>
     <div class="alert alert-danger">
       <h4><%= pluralize(post.errors.count, "error") %> prohibited this post from being saved:</h4>
@@ -31,6 +31,12 @@
     <%= form.text_field :keywords, class: "form-control", placeholder: "Separate keywords with commas" %>
   </div>
+  <div class="mb-3">
+    <%= form.label :og_image, "Social share image", class: "form-label" %>
+    <%= form.file_field :og_image, class: "form-control", accept: "image/*" %>
+    <div class="form-text">Optional. Overrides the post's banner image for social/link previews.</div>
+  </div>
   <div class="mb-3">
     <div class="form-check">
       <%= form.check_box :published, class: "form-check-input" %>

data/app/views/helios/press/posts/show.html.erb CHANGED Viewed

@@ -1,26 +1,9 @@
 <% content_for :title, @post.name %>
+<%# helios-seo renders the full head layer: description, canonical, robots, OG,
+    Twitter, and JSON-LD. title: false because the layout owns the <title>. %>
 <% content_for :head do %>
-  <%
-    first_image_block = @post.blocks.find { |b| b.block_type == "image_container" && b.block_images.any? }
-  %>
-  <% if @post.keywords.present? %>
-    <meta name="keywords" content="<%= @post.keywords %>">
-  <% end %>
-  <meta property="og:title" content="<%= @post.name %>">
-  <meta property="og:type" content="article">
-  <meta property="og:url" content="<%= request.base_url %>/<%= @post.slug %>">
-  <% if @post.description.present? %>
-    <meta property="og:description" content="<%= @post.description %>">
-  <% end %>
-  <% if first_image_block&.block_images&.first&.file&.attached? %>
-    <meta property="og:image" content="<%= url_for(first_image_block.block_images.first.file.variant(resize_to_limit: [1200, 630])) %>">
-  <% end %>
-  <% if @post.published? %>
-    <meta property="article:published_time" content="<%= @post.created_at.iso8601 %>">
-    <meta property="article:modified_time" content="<%= @post.updated_at.iso8601 %>">
-  <% end %>
+  <%= helios_seo_tags(@post, title: false) %>
 <% end %>
 <div class="container my-5">

data/app/views/layouts/helios/press/application.html.erb CHANGED Viewed

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <title>Helios press</title>
+  <title><%= content_for?(:title) ? yield(:title) : (Helios::Press.configuration.site_name.presence || "Helios press") %></title>
   <%= csrf_meta_tags %>
   <%= csp_meta_tag %>

data/lib/helios/press/configuration.rb CHANGED Viewed

@@ -5,7 +5,10 @@ module Helios
                     :public_parent_controller,
                     :api_parent_controller,
                     :api_authentication,
-                    :post_slug_prefix
+                    :post_slug_prefix,
+                    :site_name,
+                    :twitter_site,
+                    :default_image_url
       def initialize
         @admin_parent_controller = "ApplicationController"
@@ -13,6 +16,9 @@ module Helios
         @api_parent_controller = "ActionController::API"
         @api_authentication = nil
         @post_slug_prefix = nil
+        @site_name = nil
+        @twitter_site = nil
+        @default_image_url = nil
       end
     end
   end

data/lib/helios/press/engine.rb CHANGED Viewed

@@ -12,6 +12,24 @@ module Helios
           helper Rails.application.routes.url_helpers
         end
       end
+      # Adapt Post to helios-seo: supply the per-post social-share image. The
+      # host app still provides site identity (site_name, site_url, author, ...)
+      # and may override this resolver. Canonical URLs are left to helios-seo's
+      # default ("{site_url}/{slug}"), which matches the public "get :slug" route
+      # when the Public engine is mounted at root; hosts on a subpath set their
+      # own `canonical_url`.
+      initializer "helios_press.seo" do
+        if defined?(Helios::Seo)
+          Helios::Seo.configure do |seo|
+            # Two-arg form: helios-seo passes the view context so we can build an
+            # absolute ActiveStorage proxy URL for the share image.
+            seo.image_resolver = ->(post, view) do
+              post.respond_to?(:og_image_url) ? post.og_image_url(view: view) : nil
+            end
+          end
+        end
+      end
     end
     module Admin

data/lib/helios/press/version.rb CHANGED Viewed

@@ -1,5 +1,5 @@
 module Helios
   module Press
-    VERSION = "0.4"
+    VERSION = "0.5"
   end
 end

metadata CHANGED Viewed

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: helios-press
 version: !ruby/object:Gem::Version
-  version: '0.4'
+  version: '0.5'
 platform: ruby
 authors:
 - Jason Fleetwood-Boldt
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-28 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -80,6 +79,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: helios-seo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A Rails engine providing a WordPress-like block editor for blog posts.
   Supports text (ActionText), image stacks, and video blocks with drag-to-reorder.
 email:
@@ -146,11 +159,10 @@ files:
 - lib/tasks/helios/press_tasks.rake
 homepage: https://github.com/heliosdev-shop/helios-press
 licenses:
-- Nonstandard
+- MIT
 metadata:
   homepage_uri: https://github.com/heliosdev-shop/helios-press
   source_code_uri: https://github.com/heliosdev-shop/helios-press
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -165,8 +177,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Multi-block blog post editor for Rails with drag-to-reorder
 test_files: []