Add blog feature with SEO, i18n, and tagging support

- Create blog posts table with comprehensive SEO fields (meta tags, Open Graph, Twitter cards)
- Implement polymorphic tagging system for flexible content categorization
- Add BlogPost, Tag, and Tagging models with proper associations
- Create blog posts controller with index and show actions
- Design NYT-style blog views with responsive layout
- Add RSS and Atom feed support for blog posts
- Create rake tasks for generating and deleting example blog posts
- Add internationalization support for all blog text
- Include Blog link in main navigation
- Simple pagination implementation without external dependencies

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: jhash

app/controllers/blog_posts_controller.rb

@@ -0,0 +1,33 @@
+class BlogPostsController < ApplicationController
+  before_action :set_blog_post, only: [:show]
+  
+  def index
+    @blog_posts = BlogPost.published.recent.includes(:user, :tags)
+    
+    # Simple pagination without kaminari
+    page = (params[:page] || 1).to_i
+    per_page = 9
+    @blog_posts = @blog_posts.limit(per_page).offset((page - 1) * per_page)
+    
+    respond_to do |format|
+      format.html
+      format.rss { render layout: false }
+      format.atom { render layout: false }
+    end
+  end
+  
+  def show
+    unless @blog_post.published? || (logged_in? && (current_user == @blog_post.user || current_user.superadmin?))
+      redirect_to blog_posts_path, alert: t('blog_posts.not_found')
+      return
+    end
+    
+    @blog_post.increment_views! if @blog_post.published?
+  end
+  
+  private
+  
+  def set_blog_post
+    @blog_post = BlogPost.includes(:user, :tags).find_by!(slug: params[:id])
+  end
+end

app/models/blog_post.rb

@@ -0,0 +1,76 @@
+class BlogPost < ApplicationRecord
+  belongs_to :user
+  has_many :taggings, as: :taggable, dependent: :destroy
+  has_many :tags, through: :taggings
+  
+  # Status enum
+  enum :status, { draft: 0, published: 1, archived: 2 }
+  
+  # Validations
+  validates :title, presence: true
+  validates :slug, presence: true, uniqueness: true
+  validates :content, presence: true
+  
+  # Scopes
+  scope :published, -> { where(status: :published).where('published_at <= ?', Time.current) }
+  scope :recent, -> { order(published_at: :desc) }
+  scope :featured, -> { where.not(featured_image_url: nil) }
+  
+  # Callbacks
+  before_validation :generate_slug, if: -> { slug.blank? && title.present? }
+  before_validation :set_published_at, if: -> { status_changed? && published? }
+  before_save :calculate_reading_time
+  before_save :set_seo_defaults
+  
+  # Instance methods
+  def to_param
+    slug
+  end
+  
+  def published?
+    status == 'published' && published_at.present? && published_at <= Time.current
+  end
+  
+  def increment_views!
+    increment!(:views_count)
+  end
+  
+  def tag_list
+    tags.pluck(:name).join(', ')
+  end
+  
+  def tag_list=(names)
+    self.tags = names.split(',').map do |name|
+      Tag.where(name: name.strip).first_or_create!
+    end
+  end
+  
+  private
+  
+  def generate_slug
+    self.slug = title.parameterize
+    # Ensure uniqueness
+    if BlogPost.where.not(id: id).exists?(slug: slug)
+      self.slug = "#{slug}-#{SecureRandom.hex(4)}"
+    end
+  end
+  
+  def set_published_at
+    self.published_at ||= Time.current if published?
+  end
+  
+  def calculate_reading_time
+    return unless content.present?
+    word_count = content.split.size
+    self.reading_time_minutes = (word_count / 200.0).ceil # Average reading speed: 200 words/minute
+  end
+  
+  def set_seo_defaults
+    self.meta_title ||= title
+    self.meta_description ||= excerpt || content.truncate(160)
+    self.og_title ||= meta_title
+    self.og_description ||= meta_description
+    self.twitter_title ||= meta_title
+    self.twitter_description ||= meta_description
+  end
+end

app/models/tag.rb

@@ -0,0 +1,24 @@
+class Tag < ApplicationRecord
+  has_many :taggings, dependent: :destroy
+  has_many :blog_posts, through: :taggings, source: :taggable, source_type: 'BlogPost'
+  
+  # Validations
+  validates :name, presence: true, uniqueness: true
+  validates :slug, presence: true, uniqueness: true
+  
+  # Callbacks
+  before_validation :generate_slug, if: -> { slug.blank? && name.present? }
+  
+  # Scopes
+  scope :popular, -> { joins(:taggings).group(:id).order('COUNT(taggings.id) DESC') }
+  
+  def to_param
+    slug
+  end
+  
+  private
+  
+  def generate_slug
+    self.slug = name.parameterize
+  end
+end

app/models/tagging.rb

@@ -0,0 +1,7 @@
+class Tagging < ApplicationRecord
+  belongs_to :tag
+  belongs_to :taggable, polymorphic: true
+  
+  # Validations
+  validates :tag_id, uniqueness: { scope: [:taggable_type, :taggable_id] }
+end

app/models/user.rb

@@ -45,4 +45,7 @@ def make_superadmin!
   def remove_superadmin!
     roles.delete(Role.superadmin) if superadmin?
   end
+  
+  # Associations
+  has_many :blog_posts, dependent: :destroy
 end

app/views/blog_posts/index.atom.builder

@@ -0,0 +1,20 @@
+atom_feed do |feed|
+  feed.title t('blog_posts.atom.title', default: 'Blog - Eight')
+  feed.updated @blog_posts.maximum(:updated_at) || Time.current
+
+  @blog_posts.each do |blog_post|
+    feed.entry blog_post, published: blog_post.published_at do |entry|
+      entry.title blog_post.title
+      entry.content blog_post.content, type: 'html'
+      
+      entry.author do |author|
+        author.name blog_post.user.name
+        author.email blog_post.user.email
+      end
+      
+      blog_post.tags.each do |tag|
+        entry.category term: tag.slug, label: tag.name
+      end
+    end
+  end
+end

app/views/blog_posts/index.html.erb

@@ -0,0 +1,72 @@
+<div class="container mx-auto px-4 py-8 max-w-7xl">
+  <!-- NYT-style header -->
+  <header class="border-b-4 border-black mb-8">
+    <h1 class="text-5xl font-serif font-bold mb-4"><%= t('blog_posts.index.title', default: 'The Blog') %></h1>
+    <p class="text-gray-600 mb-4"><%= t('blog_posts.index.subtitle', default: 'Latest insights and updates') %></p>
+  </header>
+
+  <!-- Blog posts grid -->
+  <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-8">
+    <% @blog_posts.each_with_index do |blog_post, index| %>
+      <article class="<%= 'lg:col-span-2 lg:row-span-2' if index == 0 %> border-b pb-8 mb-8">
+        <%= link_to blog_post_path(blog_post), class: "group block" do %>
+          <% if blog_post.featured_image_url.present? %>
+            <div class="mb-4 overflow-hidden <%= index == 0 ? 'h-96' : 'h-48' %>">
+              <%= image_tag blog_post.featured_image_url, 
+                  alt: blog_post.featured_image_alt || blog_post.title,
+                  class: "w-full h-full object-cover group-hover:scale-105 transition-transform duration-300" %>
+            </div>
+          <% end %>
+          
+          <div class="space-y-2">
+            <% if blog_post.tags.any? %>
+              <div class="flex gap-2 flex-wrap">
+                <% blog_post.tags.limit(3).each do |tag| %>
+                  <span class="text-xs font-semibold uppercase tracking-wider text-red-600">
+                    <%= tag.name %>
+                  </span>
+                <% end %>
+              </div>
+            <% end %>
+            
+            <h2 class="text-<%= index == 0 ? '3xl' : '2xl' %> font-serif font-bold leading-tight group-hover:underline">
+              <%= blog_post.title %>
+            </h2>
+            
+            <% if blog_post.excerpt.present? %>
+              <p class="text-gray-700 <%= index == 0 ? 'text-lg' : '' %> line-clamp-3">
+                <%= blog_post.excerpt %>
+              </p>
+            <% end %>
+            
+            <div class="flex items-center text-sm text-gray-600 pt-2">
+              <span class="font-semibold"><%= blog_post.user.name %></span>
+              <span class="mx-2">·</span>
+              <time datetime="<%= blog_post.published_at.iso8601 %>">
+                <%= l(blog_post.published_at, format: :long) %>
+              </time>
+              <% if blog_post.reading_time_minutes.present? %>
+                <span class="mx-2">·</span>
+                <span><%= t('blog_posts.reading_time', count: blog_post.reading_time_minutes, default: '%{count} min read') %></span>
+              <% end %>
+            </div>
+          </div>
+        <% end %>
+      </article>
+    <% end %>
+  </div>
+
+  <!-- Simple pagination -->
+  <% if @blog_posts.size == 9 || params[:page].to_i > 1 %>
+    <nav class="mt-12 flex justify-center space-x-2">
+      <% if params[:page].to_i > 1 %>
+        <%= link_to "← Previous", blog_posts_path(page: params[:page].to_i - 1), 
+            class: "px-4 py-2 border border-gray-300 rounded hover:bg-gray-100" %>
+      <% end %>
+      <% if @blog_posts.size == 9 %>
+        <%= link_to "Next →", blog_posts_path(page: (params[:page] || 1).to_i + 1), 
+            class: "px-4 py-2 border border-gray-300 rounded hover:bg-gray-100" %>
+      <% end %>
+    </nav>
+  <% end %>
+</div>

app/views/blog_posts/index.rss.builder

@@ -0,0 +1,25 @@
+xml.instruct! :xml, version: "1.0"
+xml.rss version: "2.0" do
+  xml.channel do
+    xml.title t('blog_posts.rss.title', default: 'Blog - Eight')
+    xml.description t('blog_posts.rss.description', default: 'Latest blog posts from Eight')
+    xml.link blog_posts_url
+    xml.language I18n.locale.to_s
+
+    @blog_posts.each do |blog_post|
+      xml.item do
+        xml.title blog_post.title
+        xml.description blog_post.excerpt || blog_post.content.to_s.gsub(/<[^>]*>/, '').truncate(300)
+        xml.pubDate blog_post.published_at.to_s(:rfc822)
+        xml.link blog_post_url(blog_post)
+        xml.guid blog_post_url(blog_post)
+        
+        blog_post.tags.each do |tag|
+          xml.category tag.name
+        end
+        
+        xml.author "#{blog_post.user.email} (#{blog_post.user.name})"
+      end
+    end
+  end
+end

app/views/blog_posts/show.html.erb

@@ -0,0 +1,116 @@
+<article class="container mx-auto px-4 py-8 max-w-4xl">
+  <!-- Article header -->
+  <header class="mb-8">
+    <% if @blog_post.tags.any? %>
+      <div class="flex gap-2 flex-wrap mb-4">
+        <% @blog_post.tags.each do |tag| %>
+          <span class="text-xs font-semibold uppercase tracking-wider text-red-600">
+            <%= tag.name %>
+          </span>
+        <% end %>
+      </div>
+    <% end %>
+    
+    <h1 class="text-4xl md:text-5xl font-serif font-bold leading-tight mb-4">
+      <%= @blog_post.title %>
+    </h1>
+    
+    <% if @blog_post.excerpt.present? %>
+      <p class="text-xl text-gray-700 mb-6 font-serif italic">
+        <%= @blog_post.excerpt %>
+      </p>
+    <% end %>
+    
+    <div class="flex items-center text-gray-600 border-t border-b border-gray-300 py-4">
+      <div class="flex-1">
+        <div class="font-semibold text-black"><%= @blog_post.user.name %></div>
+        <time datetime="<%= @blog_post.published_at.iso8601 %>" class="text-sm">
+          <%= l(@blog_post.published_at, format: :long) %>
+        </time>
+      </div>
+      <% if @blog_post.reading_time_minutes.present? %>
+        <div class="text-sm">
+          <%= t('blog_posts.reading_time', count: @blog_post.reading_time_minutes, default: '%{count} min read') %>
+        </div>
+      <% end %>
+    </div>
+  </header>
+
+  <!-- Featured image -->
+  <% if @blog_post.featured_image_url.present? %>
+    <figure class="mb-8">
+      <%= image_tag @blog_post.featured_image_url, 
+          alt: @blog_post.featured_image_alt || @blog_post.title,
+          class: "w-full rounded-lg shadow-lg" %>
+      <% if @blog_post.featured_image_alt.present? %>
+        <figcaption class="text-sm text-gray-600 mt-2 text-center italic">
+          <%= @blog_post.featured_image_alt %>
+        </figcaption>
+      <% end %>
+    </figure>
+  <% end %>
+
+  <!-- Article content -->
+  <div class="prose prose-lg max-w-none font-serif">
+    <%= simple_format(@blog_post.content) %>
+  </div>
+
+  <!-- Article footer -->
+  <footer class="mt-12 pt-8 border-t border-gray-300">
+    <div class="flex items-center justify-between">
+      <div class="text-sm text-gray-600">
+        <%= t('blog_posts.views', count: @blog_post.views_count, default: '%{count} views') %>
+      </div>
+      
+      <% if logged_in? && (current_user == @blog_post.user || current_user.superadmin?) %>
+        <div class="flex gap-4">
+          <%= link_to t('blog_posts.edit'), "#", 
+              class: "text-blue-600 hover:underline" %>
+        </div>
+      <% end %>
+    </div>
+    
+    <!-- Back to blog link -->
+    <div class="mt-8">
+      <%= link_to blog_posts_path, class: "inline-flex items-center text-blue-600 hover:underline" do %>
+        <svg class="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 19l-7-7m0 0l7-7m-7 7h18" />
+        </svg>
+        <%= t('blog_posts.back_to_blog', default: 'Back to Blog') %>
+      <% end %>
+    </div>
+  </footer>
+</article>
+
+<!-- Structured data for SEO -->
+<% if @blog_post.structured_data.present? %>
+  <script type="application/ld+json">
+    <%= @blog_post.structured_data.to_json.html_safe %>
+  </script>
+<% else %>
+  <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "BlogPosting",
+      "headline": <%= @blog_post.title.to_json.html_safe %>,
+      "description": <%= (@blog_post.excerpt || @blog_post.meta_description).to_json.html_safe %>,
+      "author": {
+        "@type": "Person",
+        "name": <%= @blog_post.user.name.to_json.html_safe %>
+      },
+      "datePublished": <%= @blog_post.published_at.iso8601.to_json.html_safe %>,
+      "dateModified": <%= @blog_post.updated_at.iso8601.to_json.html_safe %>,
+      <% if @blog_post.featured_image_url.present? %>
+      "image": <%= @blog_post.featured_image_url.to_json.html_safe %>,
+      <% end %>
+      "publisher": {
+        "@type": "Organization",
+        "name": <%= Rails.application.config.application_name.to_json.html_safe rescue "Eight".to_json.html_safe %>
+      },
+      "mainEntityOfPage": {
+        "@type": "WebPage",
+        "@id": <%= blog_post_url(@blog_post).to_json.html_safe %>
+      }
+    }
+  </script>
+<% end %>