railspress-engine 0.1.0

data/app/assets/stylesheets/railspress/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/controllers/railspress/admin/base_controller.rb

@@ -0,0 +1,38 @@
+module Railspress
+  module Admin
+    class BaseController < ActionController::Base
+      layout "railspress/admin"
+
+      helper_method :current_author, :available_authors, :authors_enabled?, :header_images_enabled?
+
+      # Authentication hook - to be configured later
+      # before_action :authenticate_admin!
+
+      private
+
+      def set_flash(type, message)
+        flash[type] = message
+      end
+
+      def authors_enabled?
+        Railspress.authors_enabled?
+      end
+
+      def header_images_enabled?
+        Railspress.header_images_enabled?
+      end
+
+      def current_author
+        return nil unless authors_enabled?
+        method_name = Railspress.current_author_method
+        return nil unless respond_to?(method_name, true)
+        send(method_name)
+      end
+
+      def available_authors
+        return [] unless authors_enabled?
+        Railspress.available_authors
+      end
+    end
+  end
+end

data/app/controllers/railspress/admin/categories_controller.rb

@@ -0,0 +1,53 @@
+module Railspress
+  module Admin
+    class CategoriesController < BaseController
+      before_action :set_category, only: [:edit, :update, :destroy]
+
+      def index
+        @categories = Category.ordered
+      end
+
+      def new
+        @category = Category.new
+      end
+
+      def create
+        @category = Category.new(category_params)
+        if @category.save
+          redirect_to admin_categories_path, notice: "Category created."
+        else
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def edit
+      end
+
+      def update
+        if @category.update(category_params)
+          redirect_to admin_categories_path, notice: "Category updated."
+        else
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      def destroy
+        if @category.destroy
+          redirect_to admin_categories_path, notice: "Category deleted."
+        else
+          redirect_to admin_categories_path, alert: "Cannot delete category with posts."
+        end
+      end
+
+      private
+
+      def set_category
+        @category = Category.find(params[:id])
+      end
+
+      def category_params
+        params.require(:category).permit(:name, :slug, :description)
+      end
+    end
+  end
+end

data/app/controllers/railspress/admin/dashboard_controller.rb

@@ -0,0 +1,12 @@
+module Railspress
+  module Admin
+    class DashboardController < BaseController
+      def index
+        @posts_count = Post.count
+        @categories_count = Category.count
+        @tags_count = Tag.count
+        @recent_posts = Post.ordered.limit(5)
+      end
+    end
+  end
+end

data/app/controllers/railspress/admin/posts_controller.rb

@@ -0,0 +1,71 @@
+module Railspress
+  module Admin
+    class PostsController < BaseController
+      before_action :set_post, only: [:show, :edit, :update, :destroy]
+      before_action :load_categories, only: [:new, :create, :edit, :update]
+
+      def index
+        @posts = Post.includes(:category, :tags).ordered
+      end
+
+      def show
+      end
+
+      def new
+        @post = Post.new
+        @post.author = current_author if authors_enabled?
+      end
+
+      def create
+        @post = Post.new(post_params)
+        if @post.save
+          redirect_to admin_post_path(@post), notice: "Post created."
+        else
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def edit
+      end
+
+      def update
+        if @post.update(post_params)
+          redirect_to admin_post_path(@post), notice: "Post updated."
+        else
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      def destroy
+        @post.destroy
+        redirect_to admin_posts_path, notice: "Post deleted."
+      end
+
+      private
+
+      def set_post
+        @post = Post.find(params[:id])
+      end
+
+      def load_categories
+        @categories = Category.ordered
+      end
+
+      def post_params
+        permitted = [
+          :title,
+          :slug,
+          :category_id,
+          :content,
+          :status,
+          :meta_title,
+          :meta_description,
+          :tag_list
+        ]
+        permitted << :author_id if authors_enabled?
+        permitted.push(:header_image, :remove_header_image) if header_images_enabled?
+        params.require(:post).permit(permitted)
+      end
+    end
+  end
+end

data/app/controllers/railspress/admin/tags_controller.rb

@@ -0,0 +1,50 @@
+module Railspress
+  module Admin
+    class TagsController < BaseController
+      before_action :set_tag, only: [:edit, :update, :destroy]
+
+      def index
+        @tags = Tag.ordered
+      end
+
+      def new
+        @tag = Tag.new
+      end
+
+      def create
+        @tag = Tag.new(tag_params)
+        if @tag.save
+          redirect_to admin_tags_path, notice: "Tag created."
+        else
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def edit
+      end
+
+      def update
+        if @tag.update(tag_params)
+          redirect_to admin_tags_path, notice: "Tag updated."
+        else
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      def destroy
+        @tag.destroy
+        redirect_to admin_tags_path, notice: "Tag deleted."
+      end
+
+      private
+
+      def set_tag
+        @tag = Tag.find(params[:id])
+      end
+
+      def tag_params
+        params.require(:tag).permit(:name, :slug)
+      end
+    end
+  end
+end

data/app/controllers/railspress/application_controller.rb

@@ -0,0 +1,4 @@
+module Railspress
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/helpers/railspress/application_helper.rb

@@ -0,0 +1,4 @@
+module Railspress
+  module ApplicationHelper
+  end
+end

data/app/jobs/railspress/application_job.rb

@@ -0,0 +1,4 @@
+module Railspress
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/railspress/application_mailer.rb

@@ -0,0 +1,6 @@
+module Railspress
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/railspress/application_record.rb

@@ -0,0 +1,6 @@
+module Railspress
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+    self.table_name_prefix = "railspress_"
+  end
+end

data/app/models/railspress/category.rb

@@ -0,0 +1,18 @@
+module Railspress
+  class Category < ApplicationRecord
+    has_many :posts, dependent: :restrict_with_error
+
+    validates :name, presence: true, uniqueness: true
+    validates :slug, presence: true, uniqueness: true
+
+    before_validation :generate_slug, if: -> { slug.blank? && name.present? }
+
+    scope :ordered, -> { order(:name) }
+
+    private
+
+    def generate_slug
+      self.slug = name.parameterize
+    end
+  end
+end

data/app/models/railspress/post.rb

@@ -0,0 +1,74 @@
+module Railspress
+  class Post < ApplicationRecord
+    belongs_to :category, optional: true
+    # Author association - only functional when Railspress.authors_enabled?
+    # The author class is configured via Railspress.configure { |c| c.author_class_name = "User" }
+    def author
+      return nil unless author_id.present? && Railspress.authors_enabled?
+      Railspress.author_class.find_by(id: author_id)
+    end
+
+    def author=(user)
+      self.author_id = user&.id
+    end
+    has_many :post_tags, dependent: :destroy
+    has_many :tags, through: :post_tags
+
+    has_rich_text :content
+    has_one_attached :header_image
+
+    # Virtual attribute for removing header image via checkbox
+    attr_accessor :remove_header_image
+    before_save :purge_header_image, if: -> { remove_header_image == "1" }
+
+    enum :status, { draft: 0, published: 1 }, default: :draft
+
+    validates :title, presence: true
+    validates :slug, presence: true, uniqueness: true
+
+    before_validation :generate_slug, if: -> { slug.blank? && title.present? }
+    before_save :set_published_at
+
+    scope :ordered, -> { order(created_at: :desc) }
+    scope :recent, -> { ordered.limit(10) }
+    scope :published, -> { where(status: :published).where.not(published_at: nil) }
+    scope :drafts, -> { where(status: :draft) }
+    scope :by_author, ->(author) { where(author_id: author.id) }
+
+    # Accepts CSV string and syncs tags
+    def tag_list=(csv_string)
+      self.tags = Tag.from_csv(csv_string)
+    end
+
+    def tag_list
+      tags.pluck(:name).join(", ")
+    end
+
+    private
+
+    def generate_slug
+      base_slug = title.parameterize
+      slug_candidate = base_slug
+      counter = 1
+
+      while self.class.where(slug: slug_candidate).where.not(id: id).exists?
+        slug_candidate = "#{base_slug}-#{counter}"
+        counter += 1
+      end
+
+      self.slug = slug_candidate
+    end
+
+    def set_published_at
+      if published? && published_at.nil?
+        self.published_at = Time.current
+      elsif draft?
+        self.published_at = nil
+      end
+    end
+
+    def purge_header_image
+      header_image.purge_later
+    end
+  end
+end

data/app/models/railspress/post_tag.rb

@@ -0,0 +1,8 @@
+module Railspress
+  class PostTag < ApplicationRecord
+    belongs_to :post
+    belongs_to :tag
+
+    validates :post_id, uniqueness: { scope: :tag_id }
+  end
+end

data/app/models/railspress/tag.rb

@@ -0,0 +1,32 @@
+module Railspress
+  class Tag < ApplicationRecord
+    has_many :post_tags, dependent: :destroy
+    has_many :posts, through: :post_tags
+
+    validates :name, presence: true, uniqueness: { case_sensitive: false }
+    validates :slug, presence: true, uniqueness: true
+
+    before_validation :normalize_name
+    before_validation :generate_slug, if: -> { slug.blank? && name.present? }
+
+    scope :ordered, -> { order(:name) }
+
+    # Find or create tags from CSV string
+    def self.from_csv(csv_string)
+      return [] if csv_string.blank?
+
+      tag_names = csv_string.split(",").map { |t| t.strip.downcase }.reject(&:blank?).uniq
+      tag_names.map { |name| find_or_create_by(name: name) }
+    end
+
+    private
+
+    def normalize_name
+      self.name = name.strip.downcase if name.present?
+    end
+
+    def generate_slug
+      self.slug = name.parameterize
+    end
+  end
+end

data/app/views/active_storage/blobs/_blob.html.erb

@@ -0,0 +1,14 @@
+<figure class="attachment attachment--<%= blob.representable? ? "preview" : "file" %> attachment--<%= blob.filename.extension %>">
+  <% if blob.representable? %>
+    <%= image_tag blob.representation(resize_to_limit: local_assigns[:in_gallery] ? [ 800, 600 ] : [ 1024, 768 ]) %>
+  <% end %>
+
+  <figcaption class="attachment__caption">
+    <% if caption = blob.try(:caption) %>
+      <%= caption %>
+    <% else %>
+      <span class="attachment__name"><%= blob.filename %></span>
+      <span class="attachment__size"><%= number_to_human_size blob.byte_size %></span>
+    <% end %>
+  </figcaption>
+</figure>

data/app/views/layouts/action_text/contents/_content.html.erb

@@ -0,0 +1,3 @@
+<div class="trix-content">
+  <%= yield -%>
+</div>

data/app/views/layouts/railspress/admin.html.erb

@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title><%= content_for?(:title) ? "#{yield(:title)} - " : "" %>RailsPress Admin</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+  <%= stylesheet_link_tag "lexxy", media: "all" %>
+  <%= stylesheet_link_tag "railspress/admin", media: "all" %>
+</head>
+<body>
+  <div class="rp-admin-layout">
+    <!-- Mobile Header -->
+    <header class="rp-mobile-header">
+      <button class="rp-hamburger" aria-label="Toggle menu" aria-expanded="false">
+        <span></span>
+        <span></span>
+        <span></span>
+      </button>
+      <span class="rp-mobile-logo">RailsPress</span>
+    </header>
+
+    <div class="rp-overlay"></div>
+
+    <!-- Sidebar -->
+    <aside class="rp-sidebar">
+      <%= render "railspress/admin/shared/sidebar" %>
+    </aside>
+
+    <!-- Main Content -->
+    <main class="rp-main">
+      <%= render "railspress/admin/shared/flash" %>
+      <%= yield %>
+    </main>
+  </div>
+
+  <%= javascript_importmap_tags %>
+  <%= javascript_include_tag "railspress/admin" %>
+</body>
+</html>

data/app/views/layouts/railspress/application.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Railspress</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag    "railspress/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

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

@@ -0,0 +1,32 @@
+<%= form_with model: [:admin, @category], class: "rp-form rp-form--narrow" do |form| %>
+  <% if @category.errors.any? %>
+    <div class="rp-form-errors">
+      <ul>
+        <% @category.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: "Category 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-group">
+    <%= form.label :description, class: "rp-label" %>
+    <%= form.text_area :description, rows: 3, class: "rp-input", placeholder: "Brief description of this category (optional)" %>
+  </div>
+
+  <div class="rp-form-actions">
+    <%= form.submit class: "rp-btn rp-btn--primary" %>
+    <%= link_to "Cancel", admin_categories_path, class: "rp-btn rp-btn--secondary" %>
+  </div>
+<% end %>

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

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

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

@@ -0,0 +1,42 @@
+<% content_for :title, "Categories" %>
+
+<div class="rp-page-header">
+  <h1 class="rp-page-title">Categories</h1>
+  <div class="rp-page-actions">
+    <%= link_to "New Category", new_admin_category_path, class: "rp-btn rp-btn--primary" %>
+  </div>
+</div>
+
+<div class="rp-card">
+  <% if @categories.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>
+          <% @categories.each do |category| %>
+            <tr>
+              <td class="rp-table-primary"><%= category.name %></td>
+              <td class="rp-table-secondary"><%= category.slug %></td>
+              <td><%= category.posts.count %></td>
+              <td class="rp-table-actions">
+                <%= link_to "Edit", edit_admin_category_path(category), class: "rp-link" %>
+                <%= button_to "Delete", admin_category_path(category), method: :delete,
+                    data: { turbo_confirm: "Delete this category?" },
+                    class: "rp-link rp-link--danger" %>
+              </td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  <% else %>
+    <p class="rp-empty-state">No categories yet. <%= link_to "Create your first category", new_admin_category_path, class: "rp-link" %>.</p>
+  <% end %>
+</div>

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

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

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

@@ -0,0 +1,45 @@
+<% content_for :title, "Dashboard" %>
+
+<div class="rp-page-header">
+  <h1 class="rp-page-title">Dashboard</h1>
+  <div class="rp-page-actions">
+    <%= link_to "New Post", new_admin_post_path, class: "rp-btn rp-btn--primary" %>
+  </div>
+</div>
+
+<!-- Stats Grid -->
+<div class="rp-stats-grid">
+  <div class="rp-stat-card">
+    <div class="rp-stat-value"><%= @posts_count %></div>
+    <div class="rp-stat-label">Posts</div>
+  </div>
+  <div class="rp-stat-card">
+    <div class="rp-stat-value"><%= @categories_count %></div>
+    <div class="rp-stat-label">Categories</div>
+  </div>
+  <div class="rp-stat-card">
+    <div class="rp-stat-value"><%= @tags_count %></div>
+    <div class="rp-stat-label">Tags</div>
+  </div>
+</div>
+
+<!-- Recent Posts -->
+<div class="rp-section">
+  <div class="rp-section-header">
+    <h2 class="rp-section-title">Recent Posts</h2>
+  </div>
+  <div class="rp-card">
+    <% if @recent_posts.any? %>
+      <ul class="rp-list">
+        <% @recent_posts.each do |post| %>
+          <li class="rp-list-item">
+            <%= link_to post.title, admin_post_path(post), class: "rp-link" %>
+            <span class="rp-badge rp-badge--<%= post.status %>"><%= post.status.titleize %></span>
+          </li>
+        <% end %>
+      </ul>
+    <% else %>
+      <p class="rp-empty-state">No posts yet. <%= link_to "Create your first post", new_admin_post_path, class: "rp-link" %>.</p>
+    <% end %>
+  </div>
+</div>