panda_cms 0.5.0

data/app/components/panda_cms/admin/tab_bar_component.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module PandaCms
+  module Admin
+    class TabBarComponent < ViewComponent::Base
+      attr_reader :tabs
+
+      def initialize(tabs: [])
+        @tabs = tabs
+      end
+    end
+  end
+end

data/app/components/panda_cms/admin/table_component.html.erb

@@ -0,0 +1,21 @@
+<div class="table overflow-x-auto mb-12 w-full rounded-lg border border-mid">
+  <div class="table-header-group">
+    <div class="table-row text-base font-medium text-white bg-mid">
+      <% columns.each_with_index do |column, i| %>
+        <div class="table-cell sticky top-0 z-10 p-4 <% if i.zero? %>rounded-tl-md<% elsif i == columns.size - 1 %>rounded-tr-md<% end %>"><%= column.label %></div>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="table-row-group">
+    <% @rows.each do |row| %>
+      <div class="table-row relative bg-mid/5 hover:bg-mid/20">
+        <% @columns.each do |column| %>
+          <div class="table-cell py-5 px-3 h-20 text-sm align-middle whitespace-nowrap border-b border-mid/20">
+            <%= view_context.capture(row, &column.cell) %>
+          </div>
+        <% end %>
+      </div>
+    <% end %>
+  </div>
+</div>

data/app/components/panda_cms/admin/table_component.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module PandaCms
+  module Admin
+    class TableComponent < ViewComponent::Base
+      attr_reader :columns
+
+      def initialize(rows:)
+        @rows = rows
+        @columns = []
+      end
+
+      def column(label, &)
+        @columns << Column.new(label, &)
+      end
+
+      private
+
+      # Ensures @columns gets populated [https://dev.to/rolandstuder/supercharged-table-component-built-with-viewcomponent-3j6i]
+      def before_render
+        content
+      end
+    end
+
+    class Column
+      attr_reader :label, :cell
+
+      def initialize(label, &block)
+        @label = label
+        @cell = block
+      end
+    end
+
+    class TagColumn < Column
+      attr_reader :label, :cell
+
+      def initialize(label, &block)
+        @label = label
+        @cell = PandaCms::Admin::TagComponent.new(status: block)
+      end
+    end
+  end
+end

data/app/components/panda_cms/admin/tag_component.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module PandaCms
+  module Admin
+    class TagComponent < ViewComponent::Base
+      attr_accessor :status, :text
+
+      def initialize(status: :active, text: nil)
+        @status = status.to_sym
+        @text = text || status.to_s.humanize
+      end
+
+      def call
+        classes = "inline-flex items-center py-1 px-2 text-xs font-medium rounded-md ring-1 ring-inset "
+
+        classes += case @status
+        when :active
+          "text-black ring-black/30 bg-active border-0 "
+        when :draft
+          "text-black ring-black/30 bg-warning "
+        when :inactive, :hidden
+          "text-black ring-black/30 bg-black/5 bg-white "
+        else
+          "text-black bg-white "
+        end
+
+        content_tag :span, class: classes do
+          @text
+        end
+      end
+    end
+  end
+end

data/app/components/panda_cms/admin/user_activity_component.html.erb

@@ -0,0 +1,5 @@
+<% if user.is_a?(PandaCms::User) %>
+  <%= render PandaCms::Admin::UserDisplayComponent.new(user: user, metadata: "#{time_ago_in_words(model.updated_at)} ago") %>
+<% else %>
+  <div class="text-black/60"><%= time_ago_in_words(model.updated_at) %> ago</div>
+<% end %>

data/app/components/panda_cms/admin/user_activity_component.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module PandaCms
+  module Admin
+    class UserActivityComponent < ViewComponent::Base
+      attr_accessor :model
+      attr_accessor :updated_at
+      attr_accessor :user
+
+      # @param whodunnit_to [ActiveRecord::Base] Model instance to which the user activity is related
+      def initialize(whodunnit_to: nil)
+        @model = whodunnit_to
+        whodunnit_id = @model.versions&.last&.whodunnit
+        @user = User.find(whodunnit_id) if whodunnit_id
+        @updated_at = @model.updated_at
+      end
+    end
+  end
+end

data/app/components/panda_cms/admin/user_display_component.html.erb

@@ -0,0 +1,11 @@
+<a href="#" class="block flex-shrink-0 group">
+  <div class="flex items-center">
+    <div>
+      <img class="inline-block w-10 h-10 rounded-full" src="https://avatars.githubusercontent.com/u/663625?v=4" alt="">
+    </div>
+    <div class="ml-3">
+      <p class="text-sm text-black group-hover:text-black/60"><%= user.firstname %> <%= user.lastname %></p>
+      <% if metadata %><p class="text-sm text-black/60"><%= metadata %></p><% end %>
+    </div>
+  </div>
+</a>

data/app/components/panda_cms/admin/user_display_component.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module PandaCms
+  module Admin
+    class UserDisplayComponent < ViewComponent::Base
+      attr_accessor :user_id, :user, :metadata
+
+      def initialize(user_id: nil, user: nil, metadata: "")
+        @user = if user.nil? && user_id.present? && PandaCms::User.find(user_id)
+          PandaCms::User.find(user_id)
+        else
+          user
+        end
+
+        @metadata = metadata
+      end
+    end
+  end
+end

data/app/components/panda_cms/grid_component.html.erb

@@ -0,0 +1,6 @@
+<div class="w-full grid <%= @columns %> min-h-20">
+  <% @colspans.each do |colspan| %>
+    <div class="border border-red-500 bg-red-50 <%= colspan %>" onDragOver="parent.onDragOver(event);" onDrop="parent.onDrop(event);">
+    </div>
+  <% end %>
+</div>

data/app/components/panda_cms/grid_component.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module PandaCms
+  class GridComponent < ViewComponent::Base
+    def initialize(columns: 1, spans: [1])
+      @columns = "grid-cols-#{columns}"
+      @colspans = []
+      spans.each do |span|
+        @colspans << "col-span-#{span}"
+      end
+    end
+  end
+end

data/app/components/panda_cms/menu_component.html.erb

@@ -0,0 +1,3 @@
+<% @menu_items.each do |menu_item| %>
+  <a href="<%= menu_item.resolved_link %>" class="<%= @item_styles %>"><%= menu_item.text %></a>
+<% end %>

data/app/components/panda_cms/menu_component.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module PandaCms
+  class MenuComponent < ViewComponent::Base
+    attr_accessor :menu_item
+    attr_accessor :children
+
+    def initialize(name:, item_styles: "")
+      @menu = PandaCms::Menu.find_by(name: name)
+      @menu_items = @menu.menu_items.order(:lft) if @menu.present?
+      @item_styles = item_styles
+    end
+
+    def render?
+      @menu_items.present?
+    end
+  end
+end

data/app/components/panda_cms/page_menu_component.html.erb

@@ -0,0 +1,24 @@
+<% inactive_nav_styles = "border-gray-200 text-slate-600 " %>
+<% active_nav_styles = "bg-gray-100 text-blue-900 border-blue-900" %>
+
+<nav class="flex flex-col flex-1">
+  <ul role="list" class="flex flex-col flex-1">
+    <li>
+      <a href="<%= menu_item.page.path %>" class="border-l-2 hover:bg-gray-50 group flex px-3 py-2.5 text-lg leading-6 font-semibold <%= menu_item.page == PandaCms::Current.page ? active_nav_styles : inactive_nav_styles %>">
+        <%= menu_item.text %>
+      </a>
+    </li>
+
+    <div>
+      <ul class="mt-1">
+        <% PandaCms::MenuItem.each_with_level(menu_item.descendants) do |submenu_item, level| %>
+          <li data-level="<%= level %>" data-page-id="<%= submenu_item.page.id %>" <% if level > 1 && !PandaCms::Current.page.id.in?(submenu_item.page.self_and_ancestors.ids + submenu_item.page.siblings.ids) %> class="hidden"<% end %>>
+            <a href="<%= submenu_item.page.path %>" class="border-l-2 <%= helpers.menu_indent(submenu_item) %> hover:bg-gray-50 block px-3 py-2.5 text-base leading-6 font-regular <%= submenu_item.page == PandaCms::Current.page ? active_nav_styles : inactive_nav_styles %>">
+              <%= submenu_item.page.title %>
+            </a>
+          </li>
+        <% end %>
+      </ul>
+    </div>
+  </ul>
+</nav>

data/app/components/panda_cms/page_menu_component.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module PandaCms
+  class PageMenuComponent < ViewComponent::Base
+    attr_accessor :menu_item
+    attr_accessor :children
+
+    def initialize(page:, start_depth:)
+      start_page = if page.depth == start_depth
+        page
+      else
+        page.ancestors.find { |anc| anc.depth == start_depth }
+      end
+
+      menu = PandaCms::Menu.find_by(kind: "auto", start_page: start_page)
+      @menu_item = menu.menu_items.order(:lft)&.first unless menu.nil?
+      @children = menu_item&.descendants unless menu_item.nil?
+    end
+
+    def render?
+      @menu_item
+    end
+  end
+end

data/app/components/panda_cms/rich_text_component.html.erb

@@ -0,0 +1,40 @@
+<%= content_tag(:div, @content, @options) %>
+
+<script type="text/javascript">
+    document.addEventListener("pandaCmsRichTextEditorLoaded", function() {
+      console.debug("[Panda CMS] Called event listener: pandaCmsRichTextEditorLoaded for <%= @options[:id] %>");
+
+      // Allowing per-element toolbar configuration, if needed
+      let quillOptions = {
+        modules: {
+          toolbar: [
+            [{ header: [1, 2, 3, false] }],
+            ["bold", "italic", "underline"],
+            [{ list: "ordered" }, { list: "bullet" }],
+            [{ script: "sub" }, { script: "super" }],
+            [{ color: [] }, { background: [] }],
+            [{ align: [] }],
+            ["link", "image", "video", "code-block", "clean"],
+          ],
+          magicUrl: true,
+          imageCompressor: {
+            quality: 0.9,
+            maxWidth: 2000,
+            maxHeight: 2000,
+            imageType: "image/png",
+            keepImageTypes: ["image/jpeg", "image/jpg", "image/png"],
+          },
+        },
+        theme: "bubble",
+      };
+
+      let quillVar = "<%= @options[:id] %>";
+      console.debug(`[Panda CMS] Enabling Quill editor: ${quillVar}`);
+
+      console.debug(`[Panda CMS] Quill options for ${quillVar}: `, quillOptions);
+
+      Quill.register("modules/imageCompressor", imageCompressor);
+
+      quillVar = new Quill("#" + quillVar, quillOptions);
+    });
+  </script>

data/app/components/panda_cms/rich_text_component.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module PandaCms
+  # Text component
+  # @param key [Symbol] The key to use for the text component
+  # @param text [String] The text to display
+  # @param editable [Boolean] If the text is editable or not (defaults to true)
+  # @param options [Hash] The options to pass to the content_tag
+  class RichTextComponent < ViewComponent::Base
+    KIND = "rich_text"
+
+    def initialize(key: :text_component, text: "Lorem ipsum...", editable: true, **options)
+      @key = key
+      @text = text
+      @options = options || {}
+      @editable = editable
+    end
+
+    # Check if the element is editable and set up the content
+    def before_render
+      @editable &&= params[:embed_id].present? && params[:embed_id] == Current.page.id && Current.user&.admin?
+
+      block = PandaCms::Block.find_by(kind: "rich_text", key: @key, panda_cms_template_id: Current.page.panda_cms_template_id)
+      block_content = block.block_contents.find_by(panda_cms_page_id: Current.page.id)
+      @content = block_content.content.html_safe
+      @options[:id] = "editor_rich_text_#{block_content&.id&.tr("-", "_")}"
+
+      if @editable
+        @options[:data] = {
+          block_content_id: block_content&.id
+        }
+      end
+    end
+  end
+end

data/app/components/panda_cms/text_component.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module PandaCms
+  # Text component
+  # @param key [Symbol] The key to use for the text component
+  # @param text [String] The text to display
+  # @param editable [Boolean] If the text is editable or not (defaults to true)
+  # @param options [Hash] The options to pass to the content_tag
+  class TextComponent < ViewComponent::Base
+    KIND = "plain_text"
+
+    # Allows accessing the plain text of the component directly
+    attr_accessor :plain_text
+
+    def initialize(key: :text_component, text: "Lorem ipsum...", editable: true, **options)
+      @key = key
+      @text = text
+      @options = options || {}
+      @options[:id] ||= "text-#{key.to_s.dasherize}"
+      @editable = editable
+    end
+
+    def call
+      # TODO: For the non-editable version, grab this from a cache or similar?
+      block = PandaCms::Block.find_by(kind: KIND, key: @key, panda_cms_template_id: Current.page.panda_cms_template_id)
+
+      if block.nil?
+        raise PandaCms::MissingBlockError("Block with key #{@key} not found") unless Rails.env.production?
+        return false
+      end
+
+      block_content = block.block_contents.find_by(panda_cms_page_id: Current.page.id)
+      plain_text = block_content&.content.to_s
+
+      if @editable
+        @options[:contenteditable] = "plaintext-only"
+        @options[:data] = {
+          "editable-kind": "plain_text",
+          "editable-page-id": Current.page.id,
+          "editable-block-content-id": block_content&.id
+        }
+
+        @options[:id] = "editor-#{block_content&.id}"
+        content = plain_text
+      else
+        content = prepare_content_for_display(plain_text)
+      end
+
+      content_tag(:span, content, @options, false) # Don't escape the content
+    end
+
+    #
+    # Prepares content for display
+    #
+    # @usage Do not use this when rendering editable content
+    def prepare_content_for_display(content)
+      # Replace \n characters with <br> tags
+      content.gsub("\n", "<br>")
+    end
+
+    # Check if the element is editable
+    # TODO: Check user permissions
+    def before_render
+      @editable &&= params[:embed_id].present? && params[:embed_id] == Current.page.id
+    end
+  end
+end

data/app/constraints/panda_cms/admin_constraint.rb

@@ -0,0 +1,16 @@
+module PandaCms
+  class AdminConstraint
+    def initialize(&block)
+      @block = block
+    end
+
+    def matches?(request)
+      user = current_user(request)
+      user.present? && user.admin? && @block&.call(user)
+    end
+
+    def current_user(request)
+      User.find_by(id: request.session[:user_id])
+    end
+  end
+end

data/app/controllers/panda_cms/admin/block_contents_controller.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module PandaCms
+  module Admin
+    class BlockContentsController < ApplicationController
+      before_action :set_page, only: %i[update]
+      before_action :set_block_content, only: %i[update]
+      before_action :set_paper_trail_whodunnit, only: %i[update]
+      before_action :authenticate_admin_user!
+
+      # @type PATCH/PUT
+      # @return
+      def update
+        if @block_content.update(block_content_params)
+          @block_content.page.touch # Update the page's updated_at
+          render json: @block_content, status: :ok
+        else
+          render json: @block_content.errors, status: :unprocessable_entity
+        end
+      end
+
+      private
+
+      # @type private
+      # @return PandaCms::Page
+      def set_page
+        @page = PandaCms::Page.find(params[:page_id])
+      end
+
+      # @type private
+      # @return PandaCms::BlockContent
+      def set_block_content
+        @block_content = PandaCms::BlockContent.find(params[:id])
+      end
+
+      # Only allow a list of trusted parameters through.
+      # @type private
+      # @return ActionController::StrongParameters
+      def block_content_params
+        params.require(:block_content).permit(:content)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,31 @@
+require "groupdate"
+require "whois-parser"
+
+module PandaCms
+  class Admin::DashboardController < ApplicationController
+    before_action :set_initial_breadcrumb, only: %i[show]
+    before_action :authenticate_admin_user!
+
+    # GET /admin
+    def show
+      @domain_expiry = domain_expiry
+    end
+
+    private
+
+    def set_initial_breadcrumb
+      add_breadcrumb "Dashboard", PandaCms.admin_path
+    end
+
+    def domain_expiry
+      return "" if request.domain == "localhost"
+
+      whois_record = Whois.whois(request.domain)
+      if (parser = whois_record&.parser)
+        " (expiry date: #{parser.expires_on&.strftime("%d %b %Y")})"
+      else
+        " (error parsing WHOIS data)"
+      end
+    end
+  end
+end

data/app/controllers/panda_cms/admin/files_controller.rb

@@ -0,0 +1,19 @@
+module PandaCms
+  class Admin::FilesController < ApplicationController
+    before_action :set_initial_breadcrumb, only: %i[index show]
+    before_action :authenticate_admin_user!
+
+    def index
+      redirect_to admin_dashboard_path
+    end
+
+    def show
+    end
+
+    private
+
+    def set_initial_breadcrumb
+      add_breadcrumb "Media", admin_files_path
+    end
+  end
+end

data/app/controllers/panda_cms/admin/forms_controller.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module PandaCms
+  module Admin
+    class FormsController < ApplicationController
+      before_action :set_initial_breadcrumb, only: %i[index show]
+      # before_action :set_paper_trail_whodunnit, only: %i[create update]
+      before_action :authenticate_admin_user!
+
+      # Lists all forms
+      # @type GET
+      # @return ActiveRecord::Collection A list of all forms
+      def index
+        forms = PandaCms::Form.order(:name)
+        render :index, locals: {forms: forms}
+      end
+
+      def show
+        form = PandaCms::Form.find(params[:id])
+
+        add_breadcrumb form.name, admin_form_path(form)
+        submissions = form.form_submissions.order(created_at: :desc)
+        # TODO: Set a whitelist of fields we allow to be submitted for the form, shown in this view
+        # and a formatting array of how to display them... eventually?
+
+        fields = if submissions.last
+          submissions.last.data.keys.reverse.map { |field| [field, field.titleize] }
+        else
+          []
+        end
+
+        render :show, locals: {form: form, submissions: submissions, fields: fields}
+      end
+
+      private
+
+      def set_initial_breadcrumb
+        add_breadcrumb "Forms", admin_forms_path
+      end
+
+      private
+
+      # Only allow a list of trusted parameters through
+      # @type private
+      # @return ActionController::StrongParameters
+      def form_params
+        params.require(:form).permit(:name, :completion_path)
+      end
+    end
+  end
+end

data/app/controllers/panda_cms/admin/menus_controller.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module PandaCms
+  module Admin
+    class MenusController < ApplicationController
+      before_action :set_initial_breadcrumb, only: %i[index new edit create update]
+      before_action :set_paper_trail_whodunnit, only: %i[create update]
+      before_action :authenticate_admin_user!
+
+      # Lists all menus which can be managed by the administrator
+      # @type GET
+      # @return ActiveRecord::Collection An array of all menus
+      def index
+        menus = PandaCms::Menu.order(:name)
+        render :index, locals: {menus: menus}
+      end
+
+      # Loads the menu editor
+      # @type GET
+      def edit
+        add_breadcrumb menu.name, edit_admin_menu_path(menu)
+      end
+
+      # GET /admin/menus/new
+      # @type GET
+      def new
+        @menu = PandaCms::Menu.new
+        @menu.menu_items.new
+        set_new_menu_breadcrumb
+      end
+
+      # POST /admin/menus
+      def create
+        @menu = PandaCms::Menu.new(menu_params)
+
+        if @menu.save
+          redirect_to admin_menus_path, notice: "Menu was successfully created."
+        else
+          flash[:error] = @menu.errors.full_messages.join(", ")
+          set_new_menu_breadcrumb
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      # @type PATCH/PUT
+      # @return
+      def update
+        if menu.update!(menu_params)
+          redirect_to edit_admin_menu_path(menu),
+            status: :see_other,
+            flash: {success: "This menu was successfully updated!"}
+        else
+          add_breadcrumb menu.name, edit_admin_menu_path(menu)
+          flash[:error] = "There was an error updating the menu."
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      private
+
+      def menu
+        @menu ||= PandaCms::Menu.find(params[:id])
+      end
+
+      def set_initial_breadcrumb
+        add_breadcrumb "Menus", admin_menus_path
+      end
+
+      def set_new_menu_breadcrumb
+        add_breadcrumb "Add New Menu", new_admin_menu_path
+      end
+
+      # Only allow a list of trusted parameters through.
+      # @type private
+      # @return ActionController::StrongParameters
+      def menu_params
+        params.require(:menu).permit(:name, menu_items_attributes: %i[id text external_url sort_order panda_cms_page_id _destroy])
+      end
+    end
+  end
+end