cms42 0.1.0

data/config/locales/en.yml

@@ -0,0 +1,390 @@
+en:
+  date:
+    formats:
+      cms_date: "%d %b %Y"
+  time:
+    formats:
+      cms_csv_datetime: "%Y-%m-%d %H:%M"
+      cms_datetime: "%d %b %Y %H:%M"
+  cms:
+    shared:
+      empty_value: "-"
+      no: "No"
+      yes: "Yes"
+    errors:
+      admin_parent_controller_required: "Cms admin requires config.admin_parent_controller in production. Point it at a host controller that enforces authentication, for example \"Admin::BaseController\"."
+      current_site_required: "Cms admin requires config.current_site_resolver to return a Cms::Site. Configure it in Cms.setup so admin requests resolve the active CMS site explicitly."
+      page_not_found: "Page not found"
+      record_not_found: "The requested record was not found."
+      site_slug_not_provided: "CMS site slug not provided"
+      api:
+        site_not_found: "Site not found"
+        page_not_found: "Page not found"
+        unauthorized: "Unauthorized"
+      form_field:
+        invalid_field_name: "only lowercase letters, numbers and underscores"
+      form_submission:
+        blank: "Please complete at least one field."
+        required: "%{label} is required"
+      document:
+        invalid_file_type: "must be a supported document file"
+      image:
+        invalid_file_type: "must be a valid image file"
+      section:
+        setting_required: "%{name} is required"
+        invalid_image: "contains an image that is not available for this site"
+        global_section_requires_attachment: "A global section must stay attached to at least one page."
+      page:
+        sections_required: "Published pages must have at least one section."
+      site:
+        default_locale_unavailable: "is not included in I18n.available_locales"
+      webhook:
+        unsupported_events: "contains unsupported values: %{events}"
+    notices:
+      form_submission_sent: "Your message has been sent."
+      site_created: "Site created."
+      site_updated: "Site updated."
+      page_created: "Page created."
+      page_updated: "Page updated."
+      page_deleted: "Page deleted."
+      section_added: "Section added."
+      section_created: "Section created."
+      section_updated: "Section updated."
+      section_deleted: "Section deleted."
+      section_removed: "Section removed from page."
+      section_attached: "Section attached."
+      field_added: "Field added."
+      field_updated: "Field updated."
+      field_removed: "Field removed."
+      submission_deleted: "Submission deleted."
+      image_uploaded: "Image uploaded."
+      image_updated: "Image updated."
+      image_deleted: "Image deleted."
+      document_uploaded: "Document uploaded."
+      document_updated: "Document updated."
+      document_deleted: "Document deleted."
+      api_key_updated: "API key updated."
+      api_key_deleted: "API key deleted."
+      webhook_created: "Webhook created."
+      webhook_updated: "Webhook updated."
+      webhook_deleted: "Webhook deleted."
+    mailers:
+      form_submission:
+        subject: "New form submission - %{page_title}"
+    form_field_kinds:
+      checkbox: "Checkbox"
+      email: "Email"
+      select: "Select"
+      text: "Text"
+      textarea: "Textarea"
+    form_submission_mailer:
+      notify:
+        submitted_at: "Submitted at"
+        title: "New form submission — %{page}"
+    page_statuses:
+      archived: "Archived"
+      draft: "Draft"
+      published: "Published"
+    page_templates:
+      custom: "Custom"
+      form: "Form"
+      landing: "Landing"
+      standard: "Standard"
+    public:
+      forms:
+        send: "Send"
+        contact: "Contact"
+        submission_problem: "There was a problem with your submission"
+    section_kinds:
+      cta: "Call to action"
+      hero: "Hero"
+      image: "Image"
+      rich_text: "Rich text"
+    section_settings:
+      labels:
+        alignment: "Alignment"
+        alt_text: "Alt text"
+        background_color: "Background color"
+        button_text: "Button text"
+        button_url: "Button URL"
+        caption: "Caption"
+        cta_text: "CTA text"
+        cta_url: "CTA URL"
+        image_url: "Image URL"
+      options:
+        alignment:
+          center: "Center"
+          left: "Left"
+          right: "Right"
+    webhook_events:
+      page_published: "Page published"
+      page_unpublished: "Page unpublished"
+    admin:
+      api_keys:
+        create:
+          back: "Back to API keys"
+          title: "API Key Created"
+          token_warning: "Copy your API token now — it will not be shown again:"
+        edit:
+          back: "Back"
+          title: "Edit API Key"
+        index:
+          active: "Active"
+          created: "Created"
+          delete: "Delete"
+          delete_confirm: "Delete this API key?"
+          edit: "Edit"
+          empty: "No API keys yet."
+          last_used: "Last used"
+          name: "Name"
+          never: "Never"
+          new: "New API Key"
+          title: "API Keys"
+        new:
+          back: "Back"
+          title: "New API Key"
+      documents:
+        edit:
+          title: "Edit Document — %{title}"
+        form:
+          cancel: "Cancel"
+          current: "Current"
+          file: "File"
+        index:
+          actions: "Actions"
+          delete: "Delete"
+          delete_confirm: "Delete this document?"
+          description: "Description"
+          edit: "Edit"
+          empty: "No documents yet."
+          file: "File"
+          title: "Documents"
+          title_heading: "Title"
+          upload: "Upload document"
+        new:
+          title: "Upload Document"
+      form_fields:
+        edit:
+          title: "Edit field — %{label}"
+        form:
+          cancel: "Cancel"
+          field_name: "Field name (snake_case, used as data key)"
+          hint: "Hint text shown below the field"
+          options: "Options (for select fields, one per line)"
+        index:
+          actions: "Actions"
+          back: "Back to page"
+          delete: "Delete"
+          delete_confirm: "Delete this field?"
+          edit: "Edit"
+          empty: "No fields yet. Add fields to build your form."
+          field_name: "Field name"
+          kind: "Kind"
+          label: "Label"
+          new: "New field"
+          required: "Required"
+          submissions: "View submissions"
+          title: "Form fields — %{page}"
+        new:
+          title: "New form field — %{page}"
+      form_submissions:
+        index:
+          actions: "Actions"
+          back: "Back to form fields"
+          delete: "Delete"
+          delete_confirm: "Delete this submission?"
+          empty: "No submissions yet."
+          export: "Export CSV"
+          submitted_at: "Submitted at"
+          title: "Submissions — %{page}"
+      images:
+        edit:
+          title: "Edit Image — %{title}"
+        form:
+          alt_text: "Alt text"
+          cancel: "Cancel"
+          file: "Image file"
+          translation: "Translation (%{locale})"
+        index:
+          delete: "Delete"
+          delete_confirm: "Delete this image?"
+          edit: "Edit"
+          empty: "No images yet."
+          title: "Images"
+          upload: "Upload image"
+        new:
+          title: "Upload Image"
+      pages:
+        edit:
+          title: "Edit Page"
+        form:
+          cancel: "Cancel"
+          current_files: "Current files"
+          media_files: "Gallery/attachments"
+          no_parent: "— none (root page)"
+          parent_page: "Parent page"
+          remove_hero_image: "Remove hero image"
+          remove_media_files: "Remove all gallery/attachments"
+          seo_description: "SEO description"
+          seo_title: "SEO title"
+          template: "Template"
+          title: "Title"
+          translation: "Translation (%{locale})"
+          translation_title: "Title"
+        index:
+          actions: "Actions"
+          clear: "Clear"
+          delete: "Delete"
+          delete_confirm: "Delete this page?"
+          edit: "Edit"
+          empty: "No pages yet. Create your first page to start building the site."
+          empty_search: "No pages matched your search."
+          footer: "footer"
+          header: "header"
+          intro: "Pages are listed in site order. Use parent pages for simple hierarchies and search when you need to jump straight to one page."
+          nav: "Nav"
+          new: "New page"
+          search: "Search"
+          search_placeholder: "Search by title or slug…"
+          site_settings: "Website settings"
+          slug: "Slug"
+          status: "Status"
+          template: "Template"
+          title: "Pages"
+          title_heading: "Title"
+          view: "View"
+        new:
+          title: "New Page"
+        show:
+          add_section: "+ Add section"
+          attach: "Attach section"
+          attach_existing: "Attach global section"
+          attachments: "Attachments"
+          back: "Back"
+          content_sections: "Content sections"
+          edit: "Edit"
+          footer: "Footer"
+          form_fields: "Form fields"
+          header: "Header"
+          hero_image: "Hero image"
+          home_page: "Home page"
+          locale: "Locale"
+          meta_description: "Meta description"
+          meta_title: "Meta title"
+          nav_group: "Nav group"
+          no_title: "(no title)"
+          parent: "Parent"
+          preview: "Preview"
+          share_preview: "Share preview"
+          section_hint: "Select a section type above to add content."
+          select_global: "Select a global section"
+          slug: "Slug"
+          status: "Status"
+          submissions: "Submissions"
+          subpages: "Subpages"
+          template: "Template"
+          translation_missing_badge: "%{locale}: missing"
+          translation_missing_title: "%{locale}: missing"
+          translations: "Translations"
+      sections:
+        edit:
+          title: "Edit section — %{kind}"
+        form:
+          add: "Add section"
+          cancel: "Cancel"
+          content: "Content"
+          content_placeholder: "Rich text content"
+          image_library_empty: "Upload images in the media library before using this block."
+          kind: "Kind"
+          manage_images: "Manage images"
+          select_image: "Select image"
+          settings: "Block settings"
+          upload_image: "Upload image"
+          update: "Update section"
+        index:
+          actions: "Actions"
+          back: "Back to pages"
+          delete: "Delete"
+          delete_confirm: "Delete this section everywhere it is used?"
+          disabled: "Disabled"
+          edit: "Edit"
+          empty: "No global sections yet."
+          enabled: "Enabled"
+          intro: "Manage site-wide global sections here and attach them to pages where needed."
+          kind: "Kind"
+          new: "New global section"
+          no_title: "(no title)"
+          status: "Status"
+          title: "Sections"
+          title_heading: "Title"
+          unused: "Not attached"
+          usage: "Used on"
+        new:
+          title: "Add section — %{kind}"
+        show:
+          details: "Section details"
+          global: "Global"
+          no_translation: "No translation for this locale."
+        section:
+          delete: "Delete"
+          delete_confirm: "Remove this section?"
+          disabled: "Disabled"
+          drag: "Drag to reorder"
+          edit: "Edit"
+          enabled: "Enabled"
+          no_title: "(no title)"
+      sites:
+        new:
+          title: "Create Website"
+          intro: "Create the first CMS site before managing pages, media, and settings."
+        edit:
+          title: "Edit Website Settings"
+        show:
+          title: "Website Settings"
+          public_url: "Public URL"
+          published: "Published"
+          default_locale: "Default locale"
+          available_locales: "Available locales"
+          logo: "Logo"
+          logo_alt: "%{site} logo"
+          logo_hint: "The logo is also used as the site's favicon."
+          edit: "Edit site"
+          manage_pages: "Manage pages"
+        form:
+          logo_alt: "%{site} logo"
+          logo_hint: "Used for both the site logo and favicon."
+          remove_logo: "Remove logo"
+          create: "Create site"
+          save: "Save"
+          cancel: "Cancel"
+      webhook_deliveries:
+        index:
+          back: "Back to webhooks"
+          delivered_at: "Delivered at"
+          empty: "No deliveries yet."
+          error: "Error"
+          event: "Event"
+          response_code: "Response code"
+          status: "Success"
+          title: "Deliveries — %{url}"
+      webhooks:
+        edit:
+          back: "Back"
+          title: "Edit Webhook"
+        form:
+          events: "Events"
+          secret: "Secret (optional — used for HMAC signature)"
+          url: "Endpoint URL"
+        index:
+          active: "Active"
+          delete: "Delete"
+          delete_confirm: "Delete this webhook?"
+          edit: "Edit"
+          empty: "No webhooks yet."
+          events: "Events"
+          new: "New Webhook"
+          title: "Webhooks"
+          url: "URL"
+        new:
+          back: "Back"
+          title: "New Webhook"

data/config/routes.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+Cms::Engine.routes.draw do
+  namespace :admin do
+    resource :site, only: %i[new create show edit update]
+    resources :sections
+    resources :pages do
+      member do
+        get :preview
+      end
+      patch "sections/sort", to: "sections#sort", as: :sort_sections
+      resources :sections, except: :index
+      post "sections/attach", to: "sections#attach", as: :attach_section
+      resources :form_fields do
+        collection do
+          patch :sort
+        end
+      end
+      resources :form_submissions, only: %i[index destroy]
+    end
+    resources :images
+    resources :documents
+    resources :api_keys, except: %i[show]
+    resources :webhooks, except: %i[show] do
+      resources :deliveries, only: :index, controller: "webhook_deliveries"
+    end
+  end
+
+  namespace :api, defaults: { format: :json } do
+    namespace :v1 do
+      resources :sites, only: :show, param: :site_slug do
+        resources :pages, only: :show, param: :slug
+      end
+      resource :site, only: :show, controller: :sites
+      resources :pages, only: :show, param: :slug
+    end
+  end
+
+  scope module: :public do
+    # Public form submissions
+    resources :pages, only: [] do
+      resources :form_submissions, only: :create
+    end
+
+    # Public multi-site routes (site resolved via URL slug)
+    resources :sites, only: :show, param: :site_slug
+    get "sites/:site_slug/*slug", to: "sites#show", as: :site_page
+
+    # Draft preview (token-based, no auth required)
+    get "preview/:preview_token", to: "previews#show", as: :page_preview
+
+    # Public single-site routes (site resolved via header/subdomain)
+    get "/", to: "sites#show", as: :current_site
+    get "*slug", to: "sites#show", as: :current_site_page
+  end
+end

data/lib/cms/engine.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "action_text/engine"
+
+module Cms
+  class Engine < ::Rails::Engine
+    isolate_namespace Cms
+
+    initializer "cms.assets.precompile" do |app|
+      app.config.assets.precompile += %w[cms/application.css cms/application.js]
+    end
+
+    initializer "cms.importmap", before: "importmap" do |app|
+      if app.config.respond_to?(:importmap)
+        app.config.importmap.paths << Engine.root.join("config/importmap.rb")
+        app.config.importmap.cache_sweepers << Engine.root.join("app/javascript")
+      end
+    end
+
+    config.after_initialize do
+      if Rails.env.production? && Cms.config.admin_parent_controller.blank?
+        raise "Cms: admin_parent_controller must be configured in production. " \
+              "Set it in your Cms.setup block, e.g.: config.admin_parent_controller = \"AdminController\""
+      end
+    end
+
+    config.to_prepare do
+      # Section block classes
+      section_block_classes = {
+        "rich_text" => Cms::Section::Blocks::RichTextBlock,
+        "image" => Cms::Section::Blocks::ImageBlock,
+        "hero" => Cms::Section::Blocks::HeroBlock,
+        "cta" => Cms::Section::Blocks::CallToActionBlock
+      }
+
+      Cms::Section::KindRegistry::BUILT_IN_KINDS.each do |kind|
+        Cms::Section::KindRegistry.register(kind, block_class: section_block_classes[kind])
+      end
+
+      Array(Cms.config.page_templates).each do |key|
+        Cms::Page::TemplateRegistry.register(key)
+      end
+    end
+  end
+end

data/lib/cms/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Cms
+  VERSION = "0.1.0"
+end

data/lib/cms.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "discard"
+require "cms/version"
+require "cms/engine"
+
+module Cms
+  class Configuration
+    attr_accessor :parent_controller,
+                  :admin_parent_controller,
+                  :current_site_resolver,
+                  :form_submission_email,
+                  :mailer_from,
+                  :image_renditions,
+                  :page_templates,
+                  :page_resolver_class,
+                  :api_site_serializer_class,
+                  :api_page_serializer_class,
+                  :admin_layout,
+                  :public_layout,
+                  :authorize_admin,
+                  :auto_destroy_orphaned_sections
+
+    def initialize
+      @parent_controller = "ApplicationController"
+      @admin_parent_controller = nil
+      @admin_layout = "cms/application"
+      @public_layout = "cms/public"
+      @image_renditions = {}
+      @page_templates = []
+      @page_resolver_class = "Cms::PageResolver"
+      @api_site_serializer_class = "Cms::Api::SiteSerializer"
+      @api_page_serializer_class = "Cms::Api::PageSerializer"
+      @mailer_from = nil
+      @authorize_admin = nil
+      @auto_destroy_orphaned_sections = false
+    end
+  end
+
+  class << self
+    def config
+      @config ||= Configuration.new
+    end
+
+    def setup
+      yield config
+    end
+
+    def parent_controller
+      config.parent_controller
+    end
+
+    def parent_controller=(val)
+      config.parent_controller = val
+    end
+
+    def page_resolver_class
+      constantize_config_value(config.page_resolver_class)
+    end
+
+    def api_site_serializer_class
+      constantize_config_value(config.api_site_serializer_class)
+    end
+
+    def api_page_serializer_class
+      constantize_config_value(config.api_page_serializer_class)
+    end
+
+    private
+
+    def constantize_config_value(value)
+      value.is_a?(String) ? value.constantize : value
+    end
+  end
+end

data/lib/cms42.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "cms"

data/lib/generators/cms/install/install_generator.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/active_record"
+
+module Cms
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include Rails::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+
+      def create_migrations
+        migration_template "create_cms_tables.rb", "db/migrate/create_cms_tables.rb"
+      end
+
+      def copy_initializer
+        template "initializer.rb", "config/initializers/cms.rb"
+      end
+
+      def self.next_migration_number(dirname)
+        ActiveRecord::Generators::Base.next_migration_number(dirname)
+      end
+    end
+  end
+end