panda-cms 0.7.0

data/app/controllers/panda/cms/admin/settings/bulk_editor_controller.rb

@@ -0,0 +1,37 @@
+module Panda
+  module CMS
+    class Admin::Settings::BulkEditorController < ApplicationController
+      before_action :set_initial_breadcrumb, only: %i[new]
+
+      def new
+        @json_data = BulkEditor.export
+      end
+
+      def create
+        begin
+          debug_output = BulkEditor.import(params[:site_content])
+        rescue JSON::ParserError
+          redirect_to admin_settings_bulk_editor_path, flash: {error: "Error parsing content; are you sure this update is valid? Reverting..."}
+          return
+        end
+
+        # Grab the latest content back so it's all formatted properly
+        @json_data = BulkEditor.export
+
+        if debug_output[:error].empty? && debug_output[:warning].empty? && debug_output[:success].empty?
+          redirect_to admin_settings_bulk_editor_path, flash: {success: "No changes were found!"}
+        else
+          @debug = debug_output
+          render :new, flash: {warning: "Please review the output below for more information."}
+        end
+      end
+
+      private
+
+      def set_initial_breadcrumb
+        add_breadcrumb "Settings", admin_settings_path
+        add_breadcrumb "Bulk Editor", "#"
+      end
+    end
+  end
+end

data/app/controllers/panda/cms/admin/settings_controller.rb

@@ -0,0 +1,20 @@
+module Panda
+  module CMS
+    class Admin::SettingsController < ApplicationController
+      before_action :set_initial_breadcrumb, only: %i[index show]
+      before_action :authenticate_admin_user!
+
+      def index
+      end
+
+      def show
+      end
+
+      private
+
+      def set_initial_breadcrumb
+        add_breadcrumb "Settings", admin_settings_path
+      end
+    end
+  end
+end

data/app/controllers/panda/cms/application_controller.rb

@@ -0,0 +1,57 @@
+module Panda
+  module CMS
+    class ApplicationController < ::ActionController::Base
+      include ApplicationHelper
+      include ::ApplicationHelper
+
+      protect_from_forgery with: :exception
+
+      # Add flash types for improved alert support with Tailwind
+      add_flash_types :success, :warning, :error, :info
+
+      before_action :set_current_request_details
+
+      helper_method :breadcrumbs
+      helper_method :current_user
+      helper_method :user_signed_in?
+
+      def breadcrumbs
+        @breadcrumbs ||= []
+      end
+
+      def add_breadcrumb(name, path = nil)
+        breadcrumbs << Breadcrumb.new(name, path)
+      end
+
+      # Set the current request details
+      # @return [void]
+      def set_current_request_details
+        Panda::CMS::Current.request_id = request.uuid
+        Panda::CMS::Current.user_agent = request.user_agent
+        Panda::CMS::Current.ip_address = request.ip
+        Panda::CMS::Current.root = request.base_url
+        Panda::CMS::Current.page = nil
+        Panda::CMS::Current.user ||= User.find_by(id: session[:user_id]) if session[:user_id]
+
+        Panda::CMS.config.url ||= Panda::CMS::Current.root
+      end
+
+      def authenticate_user!
+        redirect_to root_path, flash: {error: "Please login to view this!"} unless user_signed_in?
+      end
+
+      def authenticate_admin_user!
+        redirect_to root_path, flash: {error: "Please login to view this!"} unless user_signed_in? && current_user.admin?
+      end
+
+      # Required for paper_trail and seems as good as convention these days
+      def current_user
+        Panda::CMS::Current.user
+      end
+
+      def user_signed_in?
+        !!Panda::CMS::Current.user
+      end
+    end
+  end
+end

data/app/controllers/panda/cms/errors_controller.rb

@@ -0,0 +1,33 @@
+module Panda
+  module CMS
+    class ErrorsController < ApplicationController
+      layout "error"
+
+      def show
+        exception = request.env["action_dispatch.exception"]
+        status_code = exception.try(:status_code) || ActionDispatch::ExceptionWrapper.new(request.env, exception).status_code
+
+        render view_for_code(status_code), status: status_code
+      end
+
+      def error_503
+        render view_for_code(503), status: 503
+      end
+
+      private
+
+      def view_for_code(code)
+        supported_error_codes.fetch(code) { "404" }
+      end
+
+      def supported_error_codes
+        {
+          403 => "403",
+          404 => "404",
+          500 => "500",
+          503 => "503"
+        }
+      end
+    end
+  end
+end

data/app/controllers/panda/cms/form_submissions_controller.rb

@@ -0,0 +1,23 @@
+module Panda
+  module CMS
+    class FormSubmissionsController < ApplicationController
+      def create
+        vars = params.except(:authenticity_token, :controller, :action, :id)
+
+        form = Panda::CMS::Form.find(params[:id])
+        form_submission = Panda::CMS::FormSubmission.create(form_id: params[:id], data: vars.to_unsafe_h)
+        form.update(submission_count: form.submission_count + 1)
+
+        Panda::CMS::FormMailer.notification_email(form: form, form_submission: form_submission).deliver_now
+
+        if (completion_path = form&.completion_path)
+          redirect_to completion_path
+        else
+          # TODO: This isn't a great fallback, we should do something nice here...
+          # Perhaps a simple JS alert when sent?
+          redirect_to "/"
+        end
+      end
+    end
+  end
+end

data/app/controllers/panda/cms/pages_controller.rb

@@ -0,0 +1,72 @@
+module Panda
+  module CMS
+    class PagesController < ApplicationController
+      include ActionView::Helpers::TagHelper
+
+      before_action :check_login_required, only: [:root, :show]
+      after_action :record_visit, only: [:root, :show], unless: :ignore_visit?
+
+      def root
+        params[:path] = ""
+        show
+      end
+
+      def show
+        page = if @overrides&.dig(:page_path_match)
+          Panda::CMS::Page.find_by(path: @overrides.dig(:page_path_match))
+        else
+          Panda::CMS::Page.find_by(path: "/" + params[:path].to_s)
+        end
+
+        Panda::CMS::Current.page = page || Panda::CMS::Page.find_by(path: "/404")
+        if @overrides
+          Panda::CMS::Current.page.title = @overrides&.dig(:title) || page.title
+        end
+
+        layout = page&.template&.file_path
+
+        if page.nil? || page.status == "archived" || layout.nil?
+          # This works for now, but we may want to override in future (e.g. custom 404s)
+          render file: "#{Rails.root}/public/404.html", layout: false, status: :not_found and return
+        end
+
+        template_vars = {
+          page: page,
+          title: Panda::CMS::Current.page&.title || Panda::CMS.config.title
+        }
+
+        render inline: "", assigns: template_vars, status: :ok, layout: layout
+      end
+
+      private
+
+      def check_login_required
+        if Panda::CMS.config.require_login_to_view && !user_signed_in?
+          redirect_to panda_cms_maintenance_path and return
+        end
+      end
+
+      def ignore_visit?
+        # Ignore visits from bots (TODO: make this configurable)
+        return true if /bot/i.match?(request.user_agent)
+        # Ignore visits from Honeybadger
+        return true if request.headers.to_h.key? "Honeybadger-Token"
+
+        false
+      end
+
+      def record_visit
+        RecordVisitJob.perform_later(
+          url: request.url,
+          user_agent: request.user_agent,
+          referrer: request.referrer,
+          ip_address: request.remote_ip,
+          page_id: Panda::CMS::Current.page&.id,
+          current_user_id: current_user&.id,
+          params: params.to_unsafe_h.except(:controller, :action, :path),
+          visited_at: Time.zone.now
+        )
+      end
+    end
+  end
+end

data/app/controllers/panda/cms/posts_controller.rb

@@ -0,0 +1,13 @@
+module Panda
+  module CMS
+    class PostsController < ApplicationController
+      def show
+        @posts_index_page = Panda::CMS::Page.find_by(path: "/#{Panda::CMS.config.posts[:prefix]}")
+        @post = Panda::CMS::Post.find_by!(slug: "/#{params[:slug]}")
+        @title = @post.title
+
+        render inline: "", status: :ok, layout: "layouts/post"
+      end
+    end
+  end
+end

data/app/helpers/panda/cms/admin/files_helper.rb

@@ -0,0 +1,6 @@
+module Panda
+  module CMS
+    module Admin::FilesHelper
+    end
+  end
+end

data/app/helpers/panda/cms/admin/pages_helper.rb

@@ -0,0 +1,6 @@
+module Panda
+  module CMS
+    module Admin::PagesHelper
+    end
+  end
+end

data/app/helpers/panda/cms/admin/posts_helper.rb

@@ -0,0 +1,48 @@
+module Panda
+  module CMS
+    module Admin
+      module PostsHelper
+        def editor_content_for(post, preserved_content = nil)
+          Rails.logger.debug "Editor content for post: #{post.inspect}"
+          Rails.logger.debug "Preserved content: #{preserved_content.inspect}"
+          Rails.logger.debug "Post content: #{post.content.inspect}"
+
+          content = if preserved_content.present?
+            # If preserved_content is a string (JSON), parse it
+            begin
+              preserved_content.is_a?(String) ? JSON.parse(preserved_content) : preserved_content
+            rescue JSON::ParserError => e
+              Rails.logger.error "Failed to parse preserved content: #{e.message}"
+              post.content
+            end
+          else
+            post.content
+          end
+
+          Rails.logger.debug "Using content: #{content.inspect}"
+
+          # Ensure we have a valid editor content structure
+          content = if content.blank? || !content.is_a?(Hash) || !content.key?("blocks")
+            Rails.logger.debug "Creating new editor content structure"
+            {
+              time: Time.now.to_i * 1000,
+              blocks: [],
+              version: "2.28.2"
+            }
+          else
+            # Ensure we have all required fields
+            Rails.logger.debug "Ensuring required fields are present"
+            content["time"] ||= Time.now.to_i * 1000
+            content["version"] ||= "2.28.2"
+            content["blocks"] ||= []
+            content
+          end
+
+          json = content.to_json
+          Rails.logger.debug "Returning JSON: #{json}"
+          json
+        end
+      end
+    end
+  end
+end

data/app/helpers/panda/cms/application_helper.rb

@@ -0,0 +1,120 @@
+module Panda
+  module CMS
+    module ApplicationHelper
+      #
+      # Helper method to render a ViewComponent
+      # @see ViewComponent::Rendering#render
+      # @usage <%= component "example", title: "Hello World!" %>
+      #
+      def component(name, *, **, &)
+        component = name.to_s.camelize.constantize::Component
+        render(component.new(*, **), &)
+      end
+
+      # TODO: Expose this elsewhere later, or you have to include helpers
+      # in the calling application
+      def title_tag
+        if @breadcrumbs.present?
+          "#{@breadcrumbs.last&.name} &middot; #{Panda::CMS.config.title}".html_safe
+        elsif @title.present?
+          "#{@title} &middot; #{Panda::CMS.config.title}".html_safe
+        else
+          Panda::CMS.config.title
+        end
+      end
+
+      def panda_cms_editor
+        if Current.user&.admin
+          content_tag(:a, "🐼", href: edit_admin_page_url(Current.page), class: "text-3xl inline absolute right-2 top-2")
+        end
+      end
+
+      def active_link?(path, match: :starts_with)
+        if match == :starts_with
+          return request.path.starts_with?(path)
+        elsif match == :exact
+          return (request.path == path)
+        end
+
+        false
+      end
+
+      def block_link_to(name = nil, options = nil, html_options = {}, &)
+        html_options[:class] = "block-link"
+        link_to(name, options, html_options, &)
+      end
+
+      def panda_cms_form_with(**options, &)
+        options[:builder] = Panda::CMS::FormBuilder
+        options[:class] = ["block visible p-6 bg-mid/5 rounded-lg border-mid border", options[:class]].compact.join(" ")
+        form_with(**options, &)
+      end
+
+      def nav_class(mode)
+        if mode == "mobile"
+          "-mx-3 block rounded-lg px-3 py-2 font-semibold leading-6 text-white hover:text-white hover:underline focus:underline"
+        else
+          "font-semibold leading-6 text-white hover:text-white hover:underline focus:underline"
+        end
+      end
+
+      def selected_nav_highlight_colour_classes(request)
+        "bg-mid text-white relative flex transition-all py-3 px-2 mb-2 rounded-md group flex gap-x-3 rounded-md text-base leading-6 font-normal "
+      end
+
+      def nav_highlight_colour_classes(request)
+        "text-white hover:bg-mid/60 transition-all group flex gap-x-3 py-3 px-2 mb-2 rounded-md text-base leading-6 font-normal "
+      end
+
+      def level_indent(level)
+        case level
+        when 0
+          "ml-0"
+        when 1
+          "ml-4"
+        when 2
+          "ml-8"
+        when 3
+          "ml-12"
+        when 4
+          "ml-16"
+        when 5
+          "ml-20"
+        when 6
+          "ml-24"
+        when 7
+          "ml-28"
+        when 8
+          "ml-32"
+        when 9
+          "ml-36"
+        when 10
+          "ml-40" # We can go to 72...
+        else
+          "ml-48"
+        end
+      end
+
+      def table_indent(item_with_level_attribute)
+        level_indent(item_with_level_attribute.level)
+      end
+
+      def menu_indent(item_with_level_attribute, indent_with: "pl-")
+        case item_with_level_attribute.level
+        when 0
+          "#{indent_with}0"
+        when 1
+          "#{indent_with}4"
+        when 2
+          "#{indent_with}8"
+        when 3
+          "#{indent_with}12"
+        when 4
+          "#{indent_with}16"
+        else
+          "#{indent_with}20"
+        end
+      end
+    end
+  end
+end

data/app/helpers/panda/cms/pages_helper.rb

@@ -0,0 +1,6 @@
+module Panda
+  module CMS
+    module PagesHelper
+    end
+  end
+end

data/app/helpers/panda/cms/theme_helper.rb

@@ -0,0 +1,18 @@
+module Panda
+  module CMS
+    module ThemeHelper
+      # TODO: Move these into one method?
+      def h1(text, icon: "", additional_styles: "")
+        render HeadingComponent.new(text: text, level: 1, icon: icon, additional_styles: additional_styles)
+      end
+
+      def h2(text, icon: "", additional_styles: "")
+        render HeadingComponent.new(text: text, level: 2, icon: icon, additional_styles: additional_styles)
+      end
+
+      def h3(text, icon: "", additional_styles: "")
+        render HeadingComponent.new(text: text, level: 3, icon: icon, additional_styles: additional_styles)
+      end
+    end
+  end
+end