railspress-engine 0.1.0

data/app/views/railspress/admin/posts/_form.html.erb

@@ -0,0 +1,129 @@
+<%= form_with model: [:admin, @post], class: "rp-form" do |form| %>
+  <% if @post.errors.any? %>
+    <div class="rp-form-errors">
+      <ul>
+        <% @post.errors.full_messages.each do |msg| %>
+          <li><%= msg %></li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+
+  <div class="rp-form-layout">
+    <!-- Main content column -->
+    <div class="rp-form-main">
+      <div class="rp-form-group">
+        <%= form.label :title, class: "rp-label" %>
+        <%= form.text_field :title,
+            class: "rp-input rp-input--title",
+            placeholder: "Enter post title...",
+            data: { slug_source: true },
+            required: true %>
+      </div>
+
+      <div class="rp-form-group">
+        <%= form.label :slug, class: "rp-label" %>
+        <%= form.text_field :slug,
+            class: "rp-input rp-input--mono",
+            placeholder: "auto-generated-from-title",
+            data: { slug_target: true } %>
+        <p class="rp-hint">Leave blank to auto-generate from title</p>
+      </div>
+
+      <div class="rp-form-group">
+        <%= form.label :content, class: "rp-label" %>
+        <%= form.rich_text_area :content, class: "rp-rich-text" %>
+        <p class="rp-hint">Rich text editor powered by Lexxy</p>
+      </div>
+    </div>
+
+    <!-- Sidebar column -->
+    <div class="rp-form-sidebar">
+      <div class="rp-sidebar-section">
+        <h3 class="rp-sidebar-title">Publishing</h3>
+
+        <div class="rp-form-group">
+          <%= form.label :status, class: "rp-label" %>
+          <%= form.select :status,
+              Railspress::Post.statuses.keys.map { |s| [s.titleize, s] },
+              {},
+              class: "rp-select" %>
+        </div>
+
+        <div class="rp-form-group">
+          <%= form.label :category_id, "Category", class: "rp-label" %>
+          <%= form.collection_select :category_id, @categories, :id, :name,
+              { prompt: "No category" },
+              { class: "rp-select" } %>
+        </div>
+
+        <% if authors_enabled? %>
+          <div class="rp-form-group">
+            <%= form.label :author_id, "Author", class: "rp-label" %>
+            <%= form.collection_select :author_id, available_authors, :id, Railspress.author_display_method,
+                { prompt: "No author", selected: @post.author_id },
+                { class: "rp-select" } %>
+          </div>
+        <% end %>
+
+        <div class="rp-form-group">
+          <%= form.label :tag_list, "Tags", class: "rp-label" %>
+          <%= form.text_field :tag_list,
+              class: "rp-input",
+              placeholder: "ruby, rails, tutorial",
+              value: @post.tag_list %>
+          <p class="rp-hint">Comma-separated. New tags created automatically.</p>
+        </div>
+      </div>
+
+      <% if header_images_enabled? %>
+        <div class="rp-sidebar-section">
+          <h3 class="rp-sidebar-title">Header Image</h3>
+
+          <div class="rp-form-group">
+            <% if @post.header_image.attached? %>
+              <div class="rp-header-image-preview">
+                <%= image_tag @post.header_image.variant(resize_to_limit: [400, 300]), class: "rp-header-image-thumb" %>
+              </div>
+            <% end %>
+
+            <%= form.label :header_image, class: "rp-label" %>
+            <%= form.file_field :header_image, accept: "image/*", class: "rp-file-input" %>
+            <p class="rp-hint">Recommended: 1200x630px for social sharing</p>
+
+            <% if @post.header_image.attached? %>
+              <label class="rp-checkbox-label">
+                <%= form.check_box :remove_header_image, {}, "1", "0" %>
+                Remove current image
+              </label>
+            <% end %>
+          </div>
+        </div>
+      <% end %>
+
+      <div class="rp-sidebar-section">
+        <h3 class="rp-sidebar-title">SEO</h3>
+
+        <div class="rp-form-group">
+          <%= form.label :meta_title, class: "rp-label" %>
+          <%= form.text_field :meta_title,
+              class: "rp-input",
+              placeholder: "Defaults to post title" %>
+        </div>
+
+        <div class="rp-form-group">
+          <%= form.label :meta_description, class: "rp-label" %>
+          <%= form.text_area :meta_description,
+              class: "rp-input",
+              rows: 3,
+              placeholder: "Brief description for search engines" %>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <div class="rp-form-actions">
+    <%= form.submit class: "rp-btn rp-btn--primary" %>
+    <%= link_to "Cancel", admin_posts_path, class: "rp-btn rp-btn--secondary" %>
+  </div>
+<% end %>

data/app/views/railspress/admin/posts/edit.html.erb

@@ -0,0 +1,2 @@
+<h1 class="rp-page-title rp-page-title--standalone">Edit Post</h1>
+<%= render "form" %>

data/app/views/railspress/admin/posts/index.html.erb

@@ -0,0 +1,55 @@
+<div class="rp-page-header">
+  <h1 class="rp-page-title">Posts</h1>
+  <div class="rp-page-actions">
+    <%= link_to "New Post", new_admin_post_path, class: "rp-btn rp-btn--primary" %>
+  </div>
+</div>
+
+<div class="rp-card">
+  <div class="rp-table--responsive">
+    <table class="rp-table">
+      <thead>
+        <tr>
+          <th>Title</th>
+          <th>Category</th>
+          <% if authors_enabled? %><th>Author</th><% end %>
+          <th>Status</th>
+          <th>Date</th>
+          <th class="rp-table-actions">Actions</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @posts.each do |post| %>
+          <tr>
+            <td>
+              <%= link_to post.title, admin_post_path(post), class: "rp-link rp-table-primary" %>
+              <% if post.tags.any? %>
+                <div class="rp-tag-list">
+                  <% post.tags.each do |tag| %>
+                    <span class="rp-tag"><%= tag.name %></span>
+                  <% end %>
+                </div>
+              <% end %>
+            </td>
+            <td><%= post.category&.name || "—" %></td>
+            <% if authors_enabled? %>
+              <td><%= post.author&.public_send(Railspress.author_display_method) || "—" %></td>
+            <% end %>
+            <td>
+              <span class="rp-badge rp-badge--<%= post.status %>">
+                <%= post.status.titleize %>
+              </span>
+            </td>
+            <td class="rp-table-secondary"><%= post.created_at.strftime("%b %d, %Y") %></td>
+            <td class="rp-table-actions">
+              <%= link_to "Edit", edit_admin_post_path(post), class: "rp-link" %>
+              <%= button_to "Delete", admin_post_path(post), method: :delete,
+                  data: { turbo_confirm: "Delete this post?" },
+                  class: "rp-link rp-link--danger" %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</div>

data/app/views/railspress/admin/posts/new.html.erb

@@ -0,0 +1,2 @@
+<h1 class="rp-page-title rp-page-title--standalone">New Post</h1>
+<%= render "form" %>

data/app/views/railspress/admin/posts/show.html.erb

@@ -0,0 +1,47 @@
+<div class="rp-page-header">
+  <div>
+    <h1 class="rp-page-title"><%= @post.title %></h1>
+    <div class="rp-post-meta">
+      <span class="rp-badge rp-badge--<%= @post.status %>"><%= @post.status.titleize %></span>
+      <% if @post.category %>
+        <span><%= @post.category.name %></span>
+      <% end %>
+      <% if authors_enabled? && @post.author %>
+        <span>by <%= @post.author.public_send(Railspress.author_display_method) %></span>
+      <% end %>
+      <span><%= @post.created_at.strftime("%b %d, %Y") %></span>
+    </div>
+  </div>
+  <div class="rp-page-actions">
+    <%= link_to "Edit", edit_admin_post_path(@post), class: "rp-btn rp-btn--primary" %>
+    <%= link_to "Back", admin_posts_path, class: "rp-btn rp-btn--secondary" %>
+  </div>
+</div>
+
+<% if @post.tags.any? %>
+  <div class="rp-tag-list rp-post-tags">
+    <% @post.tags.each do |tag| %>
+      <span class="rp-tag"><%= tag.name %></span>
+    <% end %>
+  </div>
+<% end %>
+
+<% if header_images_enabled? && @post.header_image.attached? %>
+  <div class="rp-header-image">
+    <%= image_tag @post.header_image.variant(resize_to_limit: [1200, 630]), class: "rp-header-image-full" %>
+  </div>
+<% end %>
+
+<article class="rp-card rp-card--padded rp-prose">
+  <%= @post.content %>
+</article>
+
+<% if @post.meta_title.present? || @post.meta_description.present? %>
+  <div class="rp-seo-preview">
+    <h3 class="rp-seo-preview-title">SEO Preview</h3>
+    <div class="rp-seo-title"><%= @post.meta_title.presence || @post.title %></div>
+    <% if @post.meta_description.present? %>
+      <div class="rp-seo-description"><%= @post.meta_description %></div>
+    <% end %>
+  </div>
+<% end %>

data/app/views/railspress/admin/shared/_flash.html.erb

@@ -0,0 +1,5 @@
+<% flash.each do |type, message| %>
+  <div class="rp-flash rp-flash--<%= type %>">
+    <%= message %>
+  </div>
+<% end %>

data/app/views/railspress/admin/shared/_sidebar.html.erb

@@ -0,0 +1,38 @@
+<div class="rp-sidebar-content">
+  <h1 class="rp-logo">RailsPress</h1>
+
+  <nav class="rp-nav">
+    <%= link_to railspress.admin_root_path, class: "rp-nav-link #{current_page?(railspress.admin_root_path) ? 'rp-nav-link--active' : ''}" do %>
+      <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M3 9l9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/>
+        <polyline points="9 22 9 12 15 12 15 22"/>
+      </svg>
+      Dashboard
+    <% end %>
+
+    <%= link_to railspress.admin_posts_path, class: "rp-nav-link #{controller_name == 'posts' ? 'rp-nav-link--active' : ''}" do %>
+      <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/>
+        <polyline points="14 2 14 8 20 8"/>
+        <line x1="16" y1="13" x2="8" y2="13"/>
+        <line x1="16" y1="17" x2="8" y2="17"/>
+      </svg>
+      Posts
+    <% end %>
+
+    <%= link_to railspress.admin_categories_path, class: "rp-nav-link #{controller_name == 'categories' ? 'rp-nav-link--active' : ''}" do %>
+      <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M22 19a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h5l2 3h9a2 2 0 0 1 2 2z"/>
+      </svg>
+      Categories
+    <% end %>
+
+    <%= link_to railspress.admin_tags_path, class: "rp-nav-link #{controller_name == 'tags' ? 'rp-nav-link--active' : ''}" do %>
+      <svg class="rp-nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+        <path d="M20.59 13.41l-7.17 7.17a2 2 0 0 1-2.83 0L2 12V2h10l8.59 8.59a2 2 0 0 1 0 2.82z"/>
+        <line x1="7" y1="7" x2="7.01" y2="7"/>
+      </svg>
+      Tags
+    <% end %>
+  </nav>
+</div>

data/app/views/railspress/admin/tags/_form.html.erb

@@ -0,0 +1,27 @@
+<%= form_with model: [:admin, @tag], class: "rp-form rp-form--narrow" do |form| %>
+  <% if @tag.errors.any? %>
+    <div class="rp-form-errors">
+      <ul>
+        <% @tag.errors.full_messages.each do |msg| %>
+          <li><%= msg %></li>
+        <% end %>
+      </ul>
+    </div>
+  <% end %>
+
+  <div class="rp-form-group">
+    <%= form.label :name, class: "rp-label rp-label--lg rp-label--required" %>
+    <%= form.text_field :name, class: "rp-input rp-input--lg", placeholder: "Tag name", data: { slug_source: true }, required: true %>
+  </div>
+
+  <div class="rp-form-group">
+    <%= form.label :slug, class: "rp-label" %>
+    <%= form.text_field :slug, class: "rp-input rp-input--mono", placeholder: "auto-generated-if-blank", data: { slug_target: true } %>
+    <p class="rp-hint">Leave blank to auto-generate from name</p>
+  </div>
+
+  <div class="rp-form-actions">
+    <%= form.submit class: "rp-btn rp-btn--primary" %>
+    <%= link_to "Cancel", admin_tags_path, class: "rp-btn rp-btn--secondary" %>
+  </div>
+<% end %>

data/app/views/railspress/admin/tags/edit.html.erb

@@ -0,0 +1,6 @@
+<% content_for :title, "Edit Tag" %>
+
+<h1 class="rp-page-title rp-page-title--standalone">Edit Tag</h1>
+<div class="rp-card rp-card--padded">
+  <%= render "form" %>
+</div>

data/app/views/railspress/admin/tags/index.html.erb

@@ -0,0 +1,42 @@
+<% content_for :title, "Tags" %>
+
+<div class="rp-page-header">
+  <h1 class="rp-page-title">Tags</h1>
+  <div class="rp-page-actions">
+    <%= link_to "New Tag", new_admin_tag_path, class: "rp-btn rp-btn--primary" %>
+  </div>
+</div>
+
+<div class="rp-card">
+  <% if @tags.any? %>
+    <div class="rp-table--responsive">
+      <table class="rp-table">
+        <thead>
+          <tr>
+            <th>Name</th>
+            <th>Slug</th>
+            <th>Posts</th>
+            <th class="rp-table-actions">Actions</th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @tags.each do |tag| %>
+            <tr>
+              <td class="rp-table-primary"><%= tag.name %></td>
+              <td class="rp-table-secondary"><%= tag.slug %></td>
+              <td><%= tag.posts.count %></td>
+              <td class="rp-table-actions">
+                <%= link_to "Edit", edit_admin_tag_path(tag), class: "rp-link" %>
+                <%= button_to "Delete", admin_tag_path(tag), method: :delete,
+                    data: { turbo_confirm: "Delete this tag?" },
+                    class: "rp-link rp-link--danger" %>
+              </td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  <% else %>
+    <p class="rp-empty-state">No tags yet. <%= link_to "Create your first tag", new_admin_tag_path, class: "rp-link" %>.</p>
+  <% end %>
+</div>

data/app/views/railspress/admin/tags/new.html.erb

@@ -0,0 +1,6 @@
+<% content_for :title, "New Tag" %>
+
+<h1 class="rp-page-title rp-page-title--standalone">New Tag</h1>
+<div class="rp-card rp-card--padded">
+  <%= render "form" %>
+</div>

data/config/routes.rb

@@ -0,0 +1,9 @@
+Railspress::Engine.routes.draw do
+  root to: redirect("admin")
+  namespace :admin do
+    root "dashboard#index"
+    resources :categories, except: [ :show ]
+    resources :tags, except: [ :show ]
+    resources :posts
+  end
+end

data/db/migrate/20241218000001_create_railspress_categories.rb

@@ -0,0 +1,14 @@
+class CreateRailspressCategories < ActiveRecord::Migration[8.0]
+  def change
+    create_table :railspress_categories do |t|
+      t.string :name, null: false
+      t.string :slug, null: false
+      t.text :description
+
+      t.timestamps
+    end
+
+    add_index :railspress_categories, :name, unique: true
+    add_index :railspress_categories, :slug, unique: true
+  end
+end

data/db/migrate/20241218000002_create_railspress_tags.rb

@@ -0,0 +1,13 @@
+class CreateRailspressTags < ActiveRecord::Migration[8.0]
+  def change
+    create_table :railspress_tags do |t|
+      t.string :name, null: false
+      t.string :slug, null: false
+
+      t.timestamps
+    end
+
+    add_index :railspress_tags, :name, unique: true
+    add_index :railspress_tags, :slug, unique: true
+  end
+end

data/db/migrate/20241218000003_create_railspress_posts.rb

@@ -0,0 +1,19 @@
+class CreateRailspressPosts < ActiveRecord::Migration[8.0]
+  def change
+    create_table :railspress_posts do |t|
+      t.string :title, null: false
+      t.string :slug, null: false
+      t.references :category, null: true, foreign_key: { to_table: :railspress_categories }
+      t.integer :status, default: 0, null: false
+      t.datetime :published_at
+      t.string :meta_title
+      t.text :meta_description
+
+      t.timestamps
+    end
+
+    add_index :railspress_posts, :slug, unique: true
+    add_index :railspress_posts, :status
+    add_index :railspress_posts, :published_at
+  end
+end

data/db/migrate/20241218000004_create_railspress_post_tags.rb

@@ -0,0 +1,12 @@
+class CreateRailspressPostTags < ActiveRecord::Migration[8.0]
+  def change
+    create_table :railspress_post_tags do |t|
+      t.references :post, null: false, foreign_key: { to_table: :railspress_posts }
+      t.references :tag, null: false, foreign_key: { to_table: :railspress_tags }
+
+      t.timestamps
+    end
+
+    add_index :railspress_post_tags, [:post_id, :tag_id], unique: true
+  end
+end

data/lib/generators/railspress/authors/authors_generator.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/base"
+
+module Railspress
+  module Generators
+    class AuthorsGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Enable author support for RailsPress posts"
+
+      def create_migration
+        migration_template(
+          "add_author_to_railspress_posts.rb.tt",
+          "db/migrate/add_author_to_railspress_posts.rb",
+          migration_version: migration_version
+        )
+      end
+
+      def create_initializer
+        if initializer_exists?
+          say_status :skip, "config/initializers/railspress.rb already exists", :yellow
+          say ""
+          say "Add the following to your existing initializer:", :yellow
+          say ""
+          say "  config.enable_authors", :cyan
+          say "  config.author_class_name = \"User\"", :cyan
+          say "  # config.author_scope = :admins", :cyan
+          say "  # config.author_display_method = :name", :cyan
+          say ""
+        else
+          template "railspress.rb.tt", "config/initializers/railspress.rb"
+        end
+      end
+
+      def show_post_install_message
+        say ""
+        say "=" * 60, :green
+        say "  RailsPress Authors enabled!", :green
+        say "=" * 60, :green
+        say ""
+        say "Next steps:", :yellow
+        say ""
+        say "  1. Run migrations:"
+        say "     $ rails db:migrate", :cyan
+        say ""
+        say "  2. Configure authors in config/initializers/railspress.rb", :cyan
+        say ""
+        say "  3. (Optional) Add an author scope to your User model:"
+        say "     scope :authors, -> { where(role: :admin) }", :cyan
+        say ""
+        say "=" * 60, :green
+      end
+
+      private
+
+      def initializer_exists?
+        File.exist?(Rails.root.join("config", "initializers", "railspress.rb"))
+      end
+
+      def migration_version
+        "[#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}]"
+      end
+
+      # Required for migration_template to work
+      def self.next_migration_number(dirname)
+        next_migration_number = current_migration_number(dirname) + 1
+        ActiveRecord::Migration.next_migration_number(next_migration_number)
+      end
+    end
+  end
+end

data/lib/generators/railspress/authors/templates/add_author_to_railspress_posts.rb.tt

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class AddAuthorToRailspressPosts < ActiveRecord::Migration<%= migration_version %>
+  def change
+    add_column :railspress_posts, :author_id, :bigint
+    add_index :railspress_posts, :author_id
+  end
+end

data/lib/generators/railspress/authors/templates/railspress.rb.tt

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+Railspress.configure do |config|
+  # ==========================================================================
+  # Authors
+  # ==========================================================================
+
+  # Enable author tracking on posts
+  # When enabled, posts can have an author and the admin form shows an author select
+  config.enable_authors
+
+  # The class name of your author model (default: "User")
+  config.author_class_name = "User"
+
+  # Controller method that returns the current user (default: :current_user)
+  # Used to pre-select the author on new posts
+  # config.current_author_method = :current_user
+
+  # Scope for which users appear in the author dropdown (default: nil = all)
+  # Pass a symbol to call a scope on the author class, or a lambda for custom logic
+  #
+  # Examples:
+  #   config.author_scope = :admins                    # calls User.admins
+  #   config.author_scope = :authors                   # calls User.authors
+  #   config.author_scope = ->(klass) { klass.active } # custom filtering
+  #
+  # config.author_scope = nil
+
+  # Method called on author to display in the dropdown (default: :name)
+  # config.author_display_method = :name
+end