panda-cms 0.8.0 → 0.10.0

data/db/migrate/20251104172638_set_page_types_for_existing_pages.rb

@@ -0,0 +1,27 @@
+class SetPageTypesForExistingPages < ActiveRecord::Migration[8.0]
+  def up
+    # Set system type for error pages
+    execute <<-SQL
+      UPDATE panda_cms_pages
+      SET page_type = 'system'
+      WHERE path IN ('/404', '/500')
+    SQL
+
+    # Set posts type for news/blog pages
+    execute <<-SQL
+      UPDATE panda_cms_pages
+      SET page_type = 'posts'
+      WHERE path LIKE '%news%' OR path LIKE '%blog%' OR path LIKE '%updates%'
+    SQL
+
+    # All other pages remain as 'standard' (the default)
+  end
+
+  def down
+    # Reset all to standard
+    execute <<-SQL
+      UPDATE panda_cms_pages
+      SET page_type = 'standard'
+    SQL
+  end
+end

data/db/migrate/20251105000001_add_pending_review_status_to_pages_and_posts.panda_cms.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class AddPendingReviewStatusToPagesAndPosts < ActiveRecord::Migration[8.0]
+  def up
+    # Add pending_review status to pages and posts for content approval workflow
+    # This allows content creators to submit drafts for editorial review
+
+    # Note: We're not modifying the enum directly in the database
+    # Rails enums are string-based, so we just document the new allowed value
+    # The application code will handle the new status value
+
+    # Update any existing pages/posts that might benefit from this status
+    # (In a real migration, you'd add logic here if needed)
+  end
+
+  def down
+    # Convert any pending_review items back to draft
+    Panda::CMS::Page.where(status: "pending_review").update_all(status: "draft")
+    Panda::CMS::Post.where(status: "pending_review").update_all(status: "draft")
+  end
+end

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

@@ -10,11 +10,8 @@ module Generators
         desc "Adds the basic configuration for Panda CMS to your Rails app."
 
         def create_initializer_file
-          # Add the initializer
-          initializer_path = "config/initializers/panda/cms.rb"
-          unless File.exist?("#{::Rails.root}/#{initializer_path}")
-            FileUtils.cp "#{::Panda::CMS::Engine.root}/#{initializer_path}", "#{::Rails.root}/#{initializer_path}"
-          end
+          # Skip creating initializer - Panda::Core already creates config/initializers/panda.rb
+          # See config/initializers/panda/cms.rb in the gem for an example configuration
 
           # Add the seed loader to the seeds.rb file
           unless File.read("#{::Rails.root}/db/seeds.rb")&.include?("Panda::CMS::Engine.load_seed")

data/lib/panda/cms/asset_loader.rb

@@ -161,19 +161,24 @@ module Panda
         end
 
         def development_javascript_url
-          # Try cached assets first, then importmap
-          version = asset_version
-          # Try root level first (standalone bundle), then versioned directory
-          root_path = "/panda-cms-assets/panda-cms-#{version}.js"
-          versioned_path = "/panda-cms-assets/#{version}/panda-cms-#{version}.js"
-
-          if cached_asset_exists?(root_path)
-            root_path
-          elsif cached_asset_exists?(versioned_path)
-            versioned_path
+          # In development, use importmap for live-reloading
+          # Only use compiled assets in test/CI environments
+          if Rails.env.development?
+            "/panda/cms/application_panda_cms.js"
           else
-            # Fallback to importmap or engine asset
-            "/assets/panda/cms/controllers/index.js"
+            # Try cached assets for test environment
+            version = asset_version
+            root_path = "/panda-cms-assets/panda-cms-#{version}.js"
+            versioned_path = "/panda-cms-assets/#{version}/panda-cms-#{version}.js"
+
+            if cached_asset_exists?(root_path)
+              root_path
+            elsif cached_asset_exists?(versioned_path)
+              versioned_path
+            else
+              # Fallback to importmap
+              "/panda/cms/application_panda_cms.js"
+            end
           end
         end
 
@@ -251,7 +256,7 @@ module Panda
 
         def engine_assets_available?
           # Check if engine's JavaScript files are available
-          engine_js_path = Rails.root.join("..", "..", "app", "javascript", "panda", "cms", "controllers", "index.js")
+          engine_js_path = Panda::CMS::Engine.root.join("app", "javascript", "panda", "cms", "controllers", "index.js")
           File.exist?(engine_js_path)
         end
 
@@ -312,6 +317,21 @@ module Panda
           end
         end
 
+        # Simple response object for HTTP requests
+        class Response
+          attr_reader :code, :body
+
+          def initialize(success:, code:, body:)
+            @success = success
+            @code = code
+            @body = body
+          end
+
+          def success?
+            @success
+          end
+        end
+
         def fetch_url(url)
           uri = URI(url)
           http = Net::HTTP.new(uri.host, uri.port)
@@ -324,14 +344,14 @@ module Panda
 
           response = http.request(request)
 
-          OpenStruct.new(
-            success?: response.code.to_i == 200,
+          Response.new(
+            success: response.code.to_i == 200,
             code: response.code,
             body: response.body
           )
         rescue => e
           Rails.logger.error "[Panda CMS] Network error: #{e.message}"
-          OpenStruct.new(success?: false, code: "error", body: nil)
+          Response.new(success: false, code: "error", body: nil)
         end
 
         def asset_integrity(version, filename)

data/lib/panda/cms/debug.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Panda
+  module CMS
+    module Debug
+      class << self
+        # Check if debug mode is enabled via PANDA_DEBUG environment variable
+        def enabled?
+          ENV["PANDA_DEBUG"].to_s.downcase == "true" || ENV["PANDA_DEBUG"] == "1"
+        end
+
+        # Log a debug message if debug mode is enabled
+        def log(message)
+          Panda::Core::Debug.log(message, prefix: "PANDA CMS")
+        end
+
+        # Log an object with pretty printing (using awesome_print if available)
+        def inspect(object, label: nil)
+          Panda::Core::Debug.inspect(object, label: label, prefix: "PANDA CMS")
+        end
+
+        # Enable HTTP debugging for Net::HTTP requests (delegates to Core)
+        def enable_http_debug!
+          Panda::Core::Debug.enable_http_debug!
+        end
+      end
+    end
+  end
+end

data/lib/panda/cms/engine.rb

@@ -19,14 +19,8 @@ module Panda
         #{root}/app/services
       ]
 
-      # Basic session setup only
-      initializer "panda.cms.session", before: :load_config_initializers do |app|
-        app.config.middleware = app.config.middleware.dup if app.config.middleware.frozen?
-
-        app.config.session_store :cookie_store, key: "_panda_cms_session"
-        app.config.middleware.use ActionDispatch::Cookies
-        app.config.middleware.use ActionDispatch::Session::CookieStore, app.config.session_options
-      end
+      # Session configuration is left to the consuming application
+      # The CMS engine does not impose session store requirements
 
       config.to_prepare do
         ApplicationController.helper(::ApplicationHelper)
@@ -43,11 +37,19 @@ module Panda
       end
 
       # Make files in public available to the main app (e.g. /panda_cms-assets/favicon.ico)
-      config.app_middleware.use(
-        Rack::Static,
+      config.middleware.use Rack::Static,
         urls: ["/panda-cms-assets"],
         root: Panda::CMS::Engine.root.join("public")
-      )
+
+      # Make JavaScript files available for importmap
+      # Serve from app/javascript with proper MIME types
+      config.middleware.use Rack::Static,
+        urls: ["/panda/cms"],
+        root: Panda::CMS::Engine.root.join("app/javascript"),
+        header_rules: [
+          [:all, {"Cache-Control" => Rails.env.development? ? "no-cache, no-store, must-revalidate" : "public, max-age=31536000",
+                  "Content-Type" => "text/javascript; charset=utf-8"}]
+        ]
 
       # Custom error handling
       # config.exceptions_app = Panda::CMS::ExceptionsApp.new(exceptions_app: routes)
@@ -86,13 +88,22 @@ module Panda
         end
       end
 
+      # Auto-mount CMS routes
       config.after_initialize do |app|
         # Append routes to the routes file
         app.routes.append do
           mount Panda::CMS::Engine => "/", :as => "panda_cms"
           post "/_forms/:id", to: "panda/cms/form_submissions#create", as: :panda_cms_form_submit
           get "/_maintenance", to: "panda/cms/errors#error_503", as: :panda_cms_maintenance
-          get "/*path", to: "panda/cms/pages#show", as: :panda_cms_page
+
+          # Catch-all route for CMS pages, but exclude admin paths and assets
+          admin_path = Panda::Core.config.admin_path.delete_prefix("/")
+          constraints = ->(request) {
+            !request.path.start_with?("/#{admin_path}") &&
+              !request.path.start_with?("/panda-cms-assets/")
+          }
+          get "/*path", to: "panda/cms/pages#show", as: :panda_cms_page, constraints: constraints
+
           root to: "panda/cms/pages#root"
         end
       end
@@ -131,63 +142,111 @@ module Panda
         app.config.view_component.preview_paths << root.join("spec/components/previews")
         app.config.view_component.generate.sidecar = true
         app.config.view_component.generate.preview = true
+
+        # Add preview directories to autoload paths in development
+        if Rails.env.development?
+          # Handle frozen autoload_paths array
+          if app.config.autoload_paths.frozen?
+            app.config.autoload_paths = app.config.autoload_paths.dup
+          end
+          app.config.autoload_paths << root.join("spec/components/previews")
+        end
       end
 
       # Authentication is now handled by Panda::Core::Engine
 
-      # Configure Core for CMS
-      initializer "panda.cms.configure_core" do |app|
+      # Configure Core for CMS (runs before app initializers so apps can override)
+      initializer "panda.cms.configure_core", before: :load_config_initializers do |app|
         Panda::Core.configure do |config|
-          # Customize login page
-          config.login_logo_path = "/panda-cms-assets/panda-nav.png"
-          config.login_page_title = "Panda CMS Admin"
+          # Core now provides the admin interface foundation
+          # Apps using CMS can customize login_logo_path, login_page_title, etc. in their own initializers
+
+          # Register CMS navigation items
+          config.admin_navigation_items = ->(user) {
+            items = []
+
+            # Dashboard
+            items << {
+              path: "#{config.admin_path}/cms",
+              label: "Dashboard",
+              icon: "fa-solid fa-house"
+            }
+
+            # Pages
+            items << {
+              path: "#{config.admin_path}/cms/pages",
+              label: "Pages",
+              icon: "fa-solid fa-file"
+            }
+
+            # Collections (if enabled)
+            if Panda::CMS::Features.enabled?(:collections)
+              items << {
+                path: "#{config.admin_path}/cms/collections",
+                label: "Collections",
+                icon: "fa-solid fa-table-cells"
+              }
+            end
+
+            # Posts
+            items << {
+              path: "#{config.admin_path}/cms/posts",
+              label: "Posts",
+              icon: "fa-solid fa-newspaper"
+            }
+
+            # Forms
+            items << {
+              path: "#{config.admin_path}/cms/forms",
+              label: "Forms",
+              icon: "fa-solid fa-inbox"
+            }
+
+            # Files
+            items << {
+              path: "#{config.admin_path}/cms/files",
+              label: "Files",
+              icon: "fa-solid fa-image"
+            }
+
+            # Menus
+            items << {
+              path: "#{config.admin_path}/cms/menus",
+              label: "Menus",
+              icon: "fa-solid fa-bars"
+            }
+
+            # Settings
+            items << {
+              path: "#{config.admin_path}/cms/settings",
+              label: "Settings",
+              icon: "fa-solid fa-gear"
+            }
+
+            items
+          }
 
-          # Set dashboard redirect path to CMS dashboard (using Core's admin_path)
-          config.dashboard_redirect_path = "#{Panda::Core.configuration.admin_path}/cms"
+          # Redirect to CMS dashboard after login
+          # Apps can override this if they want different behavior
+          config.dashboard_redirect_path = -> { "#{Panda::Core.config.admin_path}/cms" }
 
           # Customize initial breadcrumb
           config.initial_admin_breadcrumb = ->(controller) {
             # Use CMS dashboard path - just use the string path
-            ["Admin", "#{Panda::Core.configuration.admin_path}/cms"]
+            ["Admin", "#{config.admin_path}/cms"]
           }
 
           # Dashboard widgets
           config.admin_dashboard_widgets = ->(user) {
             widgets = []
 
-            # Add CMS statistics widgets if CMS is available
-            if defined?(Panda::CMS)
-              widgets << Panda::CMS::Admin::StatisticsComponent.new(
-                metric: "Views Today",
-                value: Panda::CMS::Visit.group_by_day(:visited_at, last: 1).count.values.first || 0
-              )
-              widgets << Panda::CMS::Admin::StatisticsComponent.new(
-                metric: "Views Last Week",
-                value: Panda::CMS::Visit.group_by_week(:visited_at, last: 1).count.values.first || 0
-              )
-              widgets << Panda::CMS::Admin::StatisticsComponent.new(
-                metric: "Views Last Month",
-                value: Panda::CMS::Visit.group_by_month(:visited_at, last: 1).count.values.first || 0
-              )
-            end
+            # TODO: Add CMS statistics widgets when StatisticsComponent is implemented
+            # This was removed along with Pro code migration
 
             widgets
           }
         end
       end
-
-      config.before_initialize do |_app|
-        # Default configuration
-        Panda::CMS.configure do |config|
-          # Array of additional EditorJS tools to load
-          # Example: [{ url: "https://cdn.jsdelivr.net/npm/@editorjs/image@latest" }]
-          config.editor_js_tools ||= []
-
-          # Hash of EditorJS tool configurations
-          # Example: { image: { class: 'ImageTool', config: { ... } } }
-          config.editor_js_tool_config ||= {}
-        end
-      end
     end
 
     class MissingBlockError < StandardError; end

data/lib/panda/cms/features.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Panda
+  module CMS
+    # Lightweight feature flag registry so open-source core can gate functionality
+    # that is only available when panda-cms-pro is installed.
+    module Features
+      Feature = Struct.new(:name, :provider, keyword_init: true)
+
+      class MissingFeatureError < StandardError; end
+
+      class << self
+        def register(name, provider:)
+          registry[name.to_sym] = Feature.new(name: name.to_sym, provider: provider)
+        end
+
+        def unregister(name)
+          registry.delete(name.to_sym)
+        end
+
+        def reset!
+          registry.clear
+        end
+
+        def enabled?(name)
+          registry.key?(name.to_sym)
+        end
+
+        def require!(name)
+          return if enabled?(name)
+
+          raise MissingFeatureError,
+            "The #{name} feature is only available with panda-cms-pro."
+        end
+
+        def provider_for(name)
+          registry[name.to_sym]&.provider
+        end
+
+        def enabled_features
+          registry.keys
+        end
+
+        private
+
+        def registry
+          @registry ||= {}
+        end
+      end
+    end
+  end
+end

data/lib/panda-cms/version.rb

@@ -2,6 +2,6 @@
 
 module Panda
   module CMS
-    VERSION = "0.8.0"
+    VERSION = "0.10.0"
   end
 end

data/lib/panda-cms.rb

@@ -9,8 +9,7 @@ module Panda
   module CMS
     class Configuration
       attr_accessor :title, :require_login_to_view, :authentication,
-        :posts, :url, :editor_js_tools,
-        :editor_js_tool_config, :instagram, :analytics
+        :posts, :url, :instagram, :analytics
 
       def initialize
         @title = "Demo Site"
@@ -18,8 +17,6 @@ module Panda
         @authentication = {}
         @posts = {enabled: true, prefix: "blog"}
         @url = nil
-        @editor_js_tools = []
-        @editor_js_tool_config = {}
         @instagram = {
           enabled: false,
           username: nil,
@@ -56,7 +53,7 @@ module Panda
 
     def self.root_path
       # Delegate to Panda::Core's admin_path configuration
-      Panda::Core.configuration.admin_path
+      Panda::Core.config.admin_path
     end
 
     class << self
@@ -64,7 +61,7 @@ module Panda
 
       def route_namespace
         # Delegate to Panda::Core's admin_path configuration
-        Panda::Core.configuration.admin_path
+        Panda::Core.config.admin_path
       end
     end
   end
@@ -91,10 +88,12 @@ Panda::CMS.loader.inflector.inflect(
 
 # Manually require files from panda-cms directory
 require_relative "panda-cms/version"
+require_relative "panda/cms/debug"
 require_relative "panda/cms/exceptions_app"
 require_relative "panda/cms/engine"
 require_relative "panda/cms/demo_site_generator"
 require_relative "panda/cms/asset_loader"
+require_relative "panda/cms/features"
 require_relative "panda/cms/slug"
 
 Panda::CMS.loader.setup

data/lib/tasks/assets.rake

@@ -23,13 +23,8 @@ namespace :panda do
         File.write(js_file, js_bundle)
         puts "✅ JavaScript compiled: #{js_file} (#{File.size(js_file)} bytes)"
 
-        # Compile CSS bundle (if any CSS files exist)
-        css_bundle = compile_css_bundle(version)
-        if css_bundle && !css_bundle.strip.empty?
-          css_file = output_dir.join("panda-cms-#{version}.css")
-          File.write(css_file, css_bundle)
-          puts "✅ CSS compiled: #{css_file} (#{File.size(css_file)} bytes)"
-        end
+        # CSS is now provided by Panda Core
+        puts "ℹ️  CSS is provided by Panda Core at /panda-core-assets/panda-core.css"
 
         # Create manifest file
         manifest = create_asset_manifest(version)
@@ -43,7 +38,6 @@ namespace :panda do
         FileUtils.mkdir_p(test_asset_dir)
 
         js_file_name = "panda-cms-#{version}.js"
-        css_file_name = "panda-cms-#{version}.css"
 
         # Copy JavaScript file
         if File.exist?(output_dir.join(js_file_name))
@@ -51,12 +45,6 @@ namespace :panda do
           puts "✅ Copied JavaScript to test location: #{test_asset_dir.join(js_file_name)}"
         end
 
-        # Copy CSS file
-        if File.exist?(output_dir.join(css_file_name))
-          FileUtils.cp(output_dir.join(css_file_name), test_asset_dir.join(css_file_name))
-          puts "✅ Copied CSS to test location: #{test_asset_dir.join(css_file_name)}"
-        end
-
         # Copy manifest
         if File.exist?(output_dir.join("manifest.json"))
           FileUtils.cp(output_dir.join("manifest.json"), test_asset_dir.join("manifest.json"))
@@ -186,44 +174,9 @@ def compile_javascript_bundle(version)
   bundle.join("\n")
 end
 
-def compile_css_bundle(version)
-  puts "Creating simplified CSS bundle for CI testing..."
-
-  # Create a minimal CSS bundle with basic styles
-  bundle = []
-  bundle << "/* Panda CMS CSS Bundle v#{version} */"
-  bundle << "/* Compiled: #{Time.now.utc.iso8601} */"
-  bundle << "/* This is a simplified bundle for CI testing purposes */"
-  bundle << ""
-
-  # Add some basic styles that might be expected
-  bundle << "/* Basic Panda CMS Styles */"
-  bundle << ".panda-cms-admin {"
-  bundle << "  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;"
-  bundle << "  line-height: 1.5;"
-  bundle << "}"
-  bundle << ""
-  bundle << ".panda-cms-editor {"
-  bundle << "  min-height: 200px;"
-  bundle << "  border: 1px solid #e5e7eb;"
-  bundle << "  border-radius: 0.375rem;"
-  bundle << "  padding: 1rem;"
-  bundle << "}"
-  bundle << ""
-  bundle << ".panda-cms-hidden {"
-  bundle << "  display: none !important;"
-  bundle << "}"
-  bundle << ""
-  bundle << "/* Editor ready state */"
-  bundle << ".editor-ready {"
-  bundle << "  opacity: 1;"
-  bundle << "  transition: opacity 0.3s ease-in-out;"
-  bundle << "}"
-  bundle << ""
-
-  puts "✅ Created simplified CSS bundle (#{bundle.join("\n").length} chars)"
-  bundle.join("\n")
-end
+# CSS compilation removed - all CSS is now provided by Panda Core
+# The panda-core.css file includes all admin interface styling including
+# EditorJS styles, theme variables, and component styles
 
 def create_asset_manifest(version)
   output_dir = Rails.root.join("tmp", "panda_cms_assets")

data/lib/tasks/panda_cms_tasks.rake

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# Provide consistent namespacing for Panda tasks
+# Rails auto-generates panda_cms:* tasks from the module name,
+# but we want to use panda:cms:* for consistency across all Panda gems
+
+namespace :panda do
+  namespace :cms do
+    namespace :install do
+      desc "Copy migrations from panda-cms to application"
+      task :migrations do
+        Rake::Task["panda_cms:install:migrations"].invoke
+      end
+    end
+  end
+end