panda-cms 0.7.0

data/app/javascript/panda/cms/tailwindcss-stimulus-components.js

@@ -0,0 +1,4 @@
+// tailwindcss-stimulus-components@6.1.2 downloaded from https://ga.jspm.io/npm:tailwindcss-stimulus-components@6.1.2/dist/tailwindcss-stimulus-components.module.js
+
+import{Controller as e}from"@hotwired/stimulus";var t=Object.defineProperty;var V=(e,s,a)=>s in e?t(e,s,{enumerable:!0,configurable:!0,writable:!0,value:a}):e[s]=a;var i=(e,t,s)=>V(e,typeof t!="symbol"?t+"":t,s);async function n(e,t,s={}){t?await T(e,s):await b(e,s)}async function T(e,t={}){let{transitionClasses:s,fromClasses:a,toClasses:o,toggleClass:r}=C("Enter",e,t);return v(e,{firstFrame(){e.classList.add(...s.split(" ")),e.classList.add(...a.split(" ")),e.classList.remove(...o.split(" ")),e.classList.remove(...r.split(" "))},secondFrame(){e.classList.remove(...a.split(" ")),e.classList.add(...o.split(" "))},ending(){e.classList.remove(...s.split(" "))}})}async function b(e,t={}){let{transitionClasses:s,fromClasses:a,toClasses:o,toggleClass:r}=C("Leave",e,t);return v(e,{firstFrame(){e.classList.add(...a.split(" ")),e.classList.remove(...o.split(" ")),e.classList.add(...s.split(" "))},secondFrame(){e.classList.remove(...a.split(" ")),e.classList.add(...o.split(" "))},ending(){e.classList.remove(...s.split(" ")),e.classList.add(...r.split(" "))}})}function C(e,t,s){return{transitionClasses:t.dataset[`transition${e}`]||s[e.toLowerCase()]||e.toLowerCase(),fromClasses:t.dataset[`transition${e}From`]||s[`${e.toLowerCase()}From`]||`${e.toLowerCase()}-from`,toClasses:t.dataset[`transition${e}To`]||s[`${e.toLowerCase()}To`]||`${e.toLowerCase()}-to`,toggleClass:t.dataset.toggleClass||s.toggleClass||s.toggle||"hidden"}}function L(e){e._stimulus_transition={timeout:null,interrupted:!1}}function I(e){e._stimulus_transition&&e._stimulus_transition.interrupt&&e._stimulus_transition.interrupt()}function v(e,t){e._stimulus_transition&&I(e);let s,a,o;return L(e),e._stimulus_transition.cleanup=()=>{a||t.firstFrame(),o||t.secondFrame(),t.ending(),e._stimulus_transition=null},e._stimulus_transition.interrupt=()=>{s=!0,e._stimulus_transition.timeout&&clearTimeout(e._stimulus_transition.timeout),e._stimulus_transition.cleanup()},new Promise((r=>{s||requestAnimationFrame((()=>{s||(t.firstFrame(),a=!0,requestAnimationFrame((()=>{s||(t.secondFrame(),o=!0,e._stimulus_transition&&(e._stimulus_transition.timeout=setTimeout((()=>{s||e._stimulus_transition.cleanup(),r()}),w(e))))})))}))}))}function w(e){let t=Number(getComputedStyle(e).transitionDuration.replace(/,.*/,"").replace("s",""))*1e3,s=Number(getComputedStyle(e).transitionDelay.replace(/,.*/,"").replace("s",""))*1e3;return t===0&&(t=Number(getComputedStyle(e).animationDuration.replace("s",""))*1e3),t+s}var s=class extends e{connect(){setTimeout((()=>{T(this.element)}),this.showDelayValue),this.hasDismissAfterValue&&setTimeout((()=>{this.close()}),this.dismissAfterValue)}close(){b(this.element).then((()=>{this.element.remove()}))}};i(s,"values",{dismissAfter:Number,showDelay:{type:Number,default:0}});var a=class extends e{connect(){this.timeout=null}save(){clearTimeout(this.timeout),this.timeout=setTimeout((()=>{this.statusTarget.textContent=this.submittingTextValue,this.formTarget.requestSubmit()}),this.submitDurationValue)}success(){this.setStatus(this.successTextValue)}error(){this.setStatus(this.errorTextValue)}setStatus(e){this.statusTarget.textContent=e,this.timeout=setTimeout((()=>{this.statusTarget.textContent=""}),this.statusDurationValue)}};i(a,"targets",["form","status"]),i(a,"values",{submitDuration:{type:Number,default:1e3},statusDuration:{type:Number,default:2e3},submittingText:{type:String,default:"Saving..."},successText:{type:String,default:"Saved!"},errorText:{type:String,default:"Unable to save."}});var o=class extends e{update(){this.preview=this.colorTarget.value}set preview(e){this.previewTarget.style[this.styleValue]=e;let t=this._getContrastYIQ(e);this.styleValue==="color"?this.previewTarget.style.backgroundColor=t:this.previewTarget.style.color=t}_getContrastYIQ(e){e=e.replace("#","");let t=128,s=parseInt(e.substr(0,2),16),a=parseInt(e.substr(2,2),16),o=parseInt(e.substr(4,2),16);return(s*299+a*587+o*114)/1e3>=t?"#000":"#fff"}};i(o,"targets",["preview","color"]),i(o,"values",{style:{type:String,default:"backgroundColor"}});var r=class extends e{connect(){this.boundBeforeCache=this.beforeCache.bind(this),document.addEventListener("turbo:before-cache",this.boundBeforeCache)}disconnect(){document.removeEventListener("turbo:before-cache",this.boundBeforeCache)}openValueChanged(){n(this.menuTarget,this.openValue,this.transitionOptions),this.openValue===!0&&this.hasMenuItemTarget&&this.menuItemTargets[0].focus()}show(){this.openValue=!0}close(){this.openValue=!1}hide(e){this.closeOnClickOutsideValue&&e.target.nodeType&&this.element.contains(e.target)===!1&&this.openValue&&(this.openValue=!1),this.closeOnEscapeValue&&e.key==="Escape"&&this.openValue&&(this.openValue=!1)}toggle(){this.openValue=!this.openValue}nextItem(e){e.preventDefault(),this.menuItemTargets[this.nextIndex].focus()}previousItem(e){e.preventDefault(),this.menuItemTargets[this.previousIndex].focus()}get currentItemIndex(){return this.menuItemTargets.indexOf(document.activeElement)}get nextIndex(){return Math.min(this.currentItemIndex+1,this.menuItemTargets.length-1)}get previousIndex(){return Math.max(this.currentItemIndex-1,0)}get transitionOptions(){return{enter:this.hasEnterClass?this.enterClass:"transition ease-out duration-100",enterFrom:this.hasEnterFromClass?this.enterFromClass:"transform opacity-0 scale-95",enterTo:this.hasEnterToClass?this.enterToClass:"transform opacity-100 scale-100",leave:this.hasLeaveClass?this.leaveClass:"transition ease-in duration-75",leaveFrom:this.hasLeaveFromClass?this.leaveFromClass:"transform opacity-100 scale-100",leaveTo:this.hasLeaveToClass?this.leaveToClass:"transform opacity-0 scale-95",toggleClass:this.hasToggleClass?this.toggleClass:"hidden"}}beforeCache(){this.openValue=!1,this.menuTarget.classList.add("hidden")}};i(r,"targets",["menu","button","menuItem"]),i(r,"values",{open:{type:Boolean,default:!1},closeOnEscape:{type:Boolean,default:!0},closeOnClickOutside:{type:Boolean,default:!0}}),i(r,"classes",["enter","enterFrom","enterTo","leave","leaveFrom","leaveTo","toggle"]);var l=class extends e{connect(){this.openValue&&this.open(),this.boundBeforeCache=this.beforeCache.bind(this),document.addEventListener("turbo:before-cache",this.boundBeforeCache)}disconnect(){document.removeEventListener("turbo:before-cache",this.boundBeforeCache)}open(){this.dialogTarget.showModal()}close(){this.dialogTarget.setAttribute("closing",""),Promise.all(this.dialogTarget.getAnimations().map((e=>e.finished))).then((()=>{this.dialogTarget.removeAttribute("closing"),this.dialogTarget.close()}))}backdropClose(e){e.target.nodeName=="DIALOG"&&this.close()}show(){this.dialogTarget.show()}hide(){this.close()}beforeCache(){this.close()}};i(l,"targets",["dialog"]),i(l,"values",{open:Boolean});var u=class extends e{openValueChanged(){n(this.contentTarget,this.openValue),this.shouldAutoDismiss&&this.scheduleDismissal()}show(e){this.shouldAutoDismiss&&this.scheduleDismissal(),this.openValue=!0}hide(){this.openValue=!1}toggle(){this.openValue=!this.openValue}get shouldAutoDismiss(){return this.openValue&&this.hasDismissAfterValue}scheduleDismissal(){this.hasDismissAfterValue&&(this.cancelDismissal(),this.timeoutId=setTimeout((()=>{this.hide(),this.timeoutId=void 0}),this.dismissAfterValue))}cancelDismissal(){typeof this.timeoutId=="number"&&(clearTimeout(this.timeoutId),this.timeoutId=void 0)}};i(u,"targets",["content"]),i(u,"values",{dismissAfter:Number,open:{type:Boolean,default:!1}});var h=class extends e{connect(){this.openValue&&this.open(),this.boundBeforeCache=this.beforeCache,document.addEventListener("turbo:before-cache",this.boundBeforeCache)}disconnect(){document.removeEventListener("turbo:before-cache",this.boundBeforeCache)}open(){this.dialogTarget.showModal()}close(){this.dialogTarget.setAttribute("closing",""),Promise.all(this.dialogTarget.getAnimations().map((e=>e.finished))).then((()=>{this.dialogTarget.removeAttribute("closing"),this.dialogTarget.close()}))}backdropClose(e){e.target.nodeName=="DIALOG"&&this.close()}show(){this.open()}hide(){this.close()}beforeCache(){this.close()}};i(h,"targets",["dialog"]),i(h,"values",{open:Boolean});var c=class extends e{initialize(){this.updateAnchorValue&&this.anchor&&(this.indexValue=this.tabTargets.findIndex((e=>e.id===this.anchor)))}connect(){this.showTab()}change(e){e.currentTarget.tagName==="SELECT"?this.indexValue=e.currentTarget.selectedIndex:e.currentTarget.dataset.index?this.indexValue=e.currentTarget.dataset.index:e.currentTarget.dataset.id?this.indexValue=this.tabTargets.findIndex((t=>t.id==e.currentTarget.dataset.id)):this.indexValue=this.tabTargets.indexOf(e.currentTarget)}nextTab(){this.indexValue=Math.min(this.indexValue+1,this.tabsCount-1)}previousTab(){this.indexValue=Math.max(this.indexValue-1,0)}firstTab(){this.indexValue=0}lastTab(){this.indexValue=this.tabsCount-1}indexValueChanged(){if(this.showTab(),this.dispatch("tab-change",{target:this.tabTargets[this.indexValue],detail:{activeIndex:this.indexValue}}),this.updateAnchorValue){let e=this.tabTargets[this.indexValue].id;if(this.scrollToAnchorValue)location.hash=e;else{let t=window.location.href.split("#")[0]+"#"+e;typeof Turbo<"u"?Turbo.navigator.history.replace(new URL(t)):history.replaceState({},document.title,t)}}}showTab(){this.panelTargets.forEach(((e,t)=>{let s=this.tabTargets[t];t===this.indexValue?(e.classList.remove("hidden"),s.ariaSelected="true",s.dataset.active=!0,this.hasInactiveTabClass&&s?.classList?.remove(...this.inactiveTabClasses),this.hasActiveTabClass&&s?.classList?.add(...this.activeTabClasses)):(e.classList.add("hidden"),s.ariaSelected=null,delete s.dataset.active,this.hasActiveTabClass&&s?.classList?.remove(...this.activeTabClasses),this.hasInactiveTabClass&&s?.classList?.add(...this.inactiveTabClasses))})),this.hasSelectTarget&&(this.selectTarget.selectedIndex=this.indexValue),this.scrollActiveTabIntoViewValue&&this.scrollToActiveTab()}scrollToActiveTab(){let e=this.element.querySelector("[aria-selected]");e&&e.scrollIntoView({inline:"center"})}get tabsCount(){return this.tabTargets.length}get anchor(){return document.URL.split("#").length>1?document.URL.split("#")[1]:null}};i(c,"classes",["activeTab","inactiveTab"]),i(c,"targets",["tab","panel","select"]),i(c,"values",{index:0,updateAnchor:Boolean,scrollToAnchor:Boolean,scrollActiveTabIntoView:Boolean});var d=class extends e{toggle(e){this.openValue=!this.openValue,this.animate()}toggleInput(e){this.openValue=e.target.checked,this.animate()}hide(){this.openValue=!1,this.animate()}show(){this.openValue=!0,this.animate()}animate(){this.toggleableTargets.forEach((e=>{n(e,this.openValue)}))}};i(d,"targets",["toggleable"]),i(d,"values",{open:{type:Boolean,default:!1}});export{s as Alert,a as Autosave,o as ColorPreview,r as Dropdown,l as Modal,u as Popover,h as Slideover,c as Tabs,d as Toggle,n as transition};
+

data/app/jobs/panda/cms/application_job.rb

@@ -0,0 +1,6 @@
+module Panda
+  module CMS
+    class ApplicationJob < ActiveJob::Base
+    end
+  end
+end

data/app/jobs/panda/cms/record_visit_job.rb

@@ -0,0 +1,31 @@
+module Panda
+  module CMS
+    class RecordVisitJob < ApplicationJob
+      queue_as :default
+
+      def perform(
+        url: nil,
+        user_agent: nil,
+        referrer: nil,
+        ip_address: nil,
+        page_id: nil,
+        current_user_id: nil,
+        params: [],
+        visited_at: nil,
+        redirect_id: nil
+      )
+        Panda::CMS::Visit.create!(
+          url: url,
+          user_agent: user_agent,
+          referrer: referrer,
+          ip_address: ip_address,
+          page_id: page_id,
+          redirect_id: redirect_id,
+          user_id: current_user_id,
+          params: params,
+          visited_at: visited_at
+        )
+      end
+    end
+  end
+end

data/app/mailers/panda/cms/application_mailer.rb

@@ -0,0 +1,8 @@
+module Panda
+  module CMS
+    class ApplicationMailer < ActionMailer::Base
+      default from: "noreply@pandacms.io"
+      layout "mailer"
+    end
+  end
+end

data/app/mailers/panda/cms/form_mailer.rb

@@ -0,0 +1,21 @@
+module Panda
+  module CMS
+    class FormMailer < Panda::CMS::ApplicationMailer
+      def notification_email(form:, form_submission:)
+        # TODO: Handle fields named just "name", and "email" better
+        @submission_data = form_submission.data
+        @sender_name = @submission_data["first_name"].to_s + " " + @submission_data["last_name"].to_s
+        @sender_email = @submission_data["email"].to_s
+
+        mail(
+          subject: "#{form.name}: #{form_submission.created_at.strftime("%d %b %Y %H:%M")}",
+          to: email_address_with_name("james@otaina.co.uk", "James Inman"),
+          from: email_address_with_name("noreply@pandacms.io", "Panda CMS"),
+          reply_to: email_address_with_name(@sender_email, @sender_name),
+          track_opens: "true",
+          message_stream: "outbound"
+        )
+      end
+    end
+  end
+end

data/app/models/action_text/rich_text_version.rb

@@ -0,0 +1,6 @@
+module ActionText
+  class RichTextVersion < ::Panda::CMS::Version
+    self.table_name = :action_text_rich_text_versions
+    self.sequence_name = :action_text_rich_text_versions_id_seq
+  end
+end

data/app/models/panda/cms/application_record.rb

@@ -0,0 +1,7 @@
+module Panda
+  module CMS
+    class ApplicationRecord < ActiveRecord::Base
+      self.abstract_class = true
+    end
+  end
+end

data/app/models/panda/cms/block.rb

@@ -0,0 +1,34 @@
+module Panda
+  module CMS
+    class Block < ApplicationRecord
+      self.table_name = "panda_cms_blocks"
+
+      belongs_to :template, foreign_key: :panda_cms_template_id, class_name: "Panda::CMS::Template", inverse_of: :blocks, optional: true
+      has_many :block_contents, foreign_key: :panda_cms_block_id, class_name: "Panda::CMS::BlockContent", inverse_of: :block
+
+      validates :kind, presence: true
+      validates :name, presence: true
+      validates :key, presence: true, uniqueness: {scope: :panda_cms_template_id, case_sensitive: false}
+
+      # Validation for presence on template intentionally skipped to allow global elements
+
+      # NB: Commented out values are not yet implemented
+      enum :kind, {
+        plain_text: "plain_text",
+        rich_text: "rich_text",
+        iframe: "iframe",
+        list: "list",
+        code: "code"
+        # image: "image",
+        # video: "video",
+        # audio: "audio",
+        # file: "file",
+        # iframe: "iframe",
+        # quote: "quote",
+        # list: "list"
+        # table: "table",
+        # form: "form"
+      }
+    end
+  end
+end

data/app/models/panda/cms/block_content.rb

@@ -0,0 +1,18 @@
+module Panda
+  module CMS
+    class BlockContent < ApplicationRecord
+      include EditorJsContent
+
+      self.table_name = "panda_cms_block_contents"
+
+      has_paper_trail versions: {
+        class_name: "Panda::CMS::BlockContentVersion"
+      }
+
+      belongs_to :page, foreign_key: :panda_cms_page_id, class_name: "Panda::CMS::Page", inverse_of: :block_contents, optional: true, touch: true
+      belongs_to :block, foreign_key: :panda_cms_block_id, class_name: "Panda::CMS::Block", inverse_of: :block_contents, optional: false
+
+      validates :block, presence: true, uniqueness: {scope: :page}
+    end
+  end
+end

data/app/models/panda/cms/block_content_version.rb

@@ -0,0 +1,8 @@
+module Panda
+  module CMS
+    class BlockContentVersion < Version
+      self.table_name = :panda_cms_block_content_versions
+      self.sequence_name = :panda_cms_block_content_versions_id_seq
+    end
+  end
+end

data/app/models/panda/cms/breadcrumb.rb

@@ -0,0 +1,12 @@
+module Panda
+  module CMS
+    class Breadcrumb
+      attr_reader :name, :path
+
+      def initialize(name, path)
+        @name = name
+        @path = path
+      end
+    end
+  end
+end

data/app/models/panda/cms/current.rb

@@ -0,0 +1,17 @@
+module Panda
+  module CMS
+    class Current < ActiveSupport::CurrentAttributes
+      attribute :root, :page
+      attribute :user
+      attribute :request_id, :user_agent, :ip_address
+
+      # resets { Time.zone = nil }
+
+      # def user=(user)
+      # super
+      # self.account = user.account
+      # Time.zone = user.time_zone
+      # end
+    end
+  end
+end

data/app/models/panda/cms/form.rb

@@ -0,0 +1,9 @@
+module Panda
+  module CMS
+    class Form < ApplicationRecord
+      self.table_name = "panda_cms_forms"
+
+      has_many :form_submissions, class_name: "Panda::CMS::FormSubmission"
+    end
+  end
+end

data/app/models/panda/cms/form_submission.rb

@@ -0,0 +1,7 @@
+module Panda
+  module CMS
+    class FormSubmission < ApplicationRecord
+      self.table_name = "panda_cms_form_submissions"
+    end
+  end
+end

data/app/models/panda/cms/menu.rb

@@ -0,0 +1,52 @@
+module Panda
+  module CMS
+    class Menu < ApplicationRecord
+      self.table_name = "panda_cms_menus"
+
+      after_save :generate_auto_menu_items, if: -> { kind == "auto" }
+
+      has_many :menu_items, -> { order(lft: :asc) }, foreign_key: :panda_cms_menu_id, class_name: "Panda::CMS::MenuItem", inverse_of: :menu
+      belongs_to :start_page, class_name: "Panda::CMS::Page", foreign_key: "start_page_id", inverse_of: :page_menu, optional: true
+
+      accepts_nested_attributes_for :menu_items, reject_if: :all_blank, allow_destroy: true
+
+      validates :name, presence: true, uniqueness: {case_sensitive: false}
+      validates :kind, presence: true, inclusion: {in: ["static", "auto"]}
+      validate :validate_start_page
+
+      def generate_auto_menu_items
+        return false if kind != "auto"
+
+        # NB: Transactions are not distributed across database connections
+        transaction do
+          menu_items.destroy_all
+          menu_item_root = menu_items.create(text: start_page.title, panda_cms_page_id: start_page.id)
+          generate_menu_items(parent_menu_item: menu_item_root, parent_page: start_page)
+        end
+      end
+
+      private
+
+      def generate_menu_items(parent_menu_item:, parent_page:)
+        parent_page.children.where(status: [:active]).each do |page|
+          menu_item = menu_items.create(text: page.title, panda_cms_page_id: page.id, parent: parent_menu_item)
+          if page.children
+            generate_menu_items(parent_menu_item: menu_item, parent_page: page)
+          end
+        end
+      end
+
+      #
+      # Validate that the start page is set if the menu is of kind auto
+      #
+      # @return nil
+      # @visibility private
+      #
+      def validate_start_page
+        if kind == "auto" && start_page.nil?
+          errors.add(:start_page, "can't be blank")
+        end
+      end
+    end
+  end
+end

data/app/models/panda/cms/menu_item.rb

@@ -0,0 +1,58 @@
+require "awesome_nested_set"
+
+module Panda
+  module CMS
+    class MenuItem < ApplicationRecord
+      acts_as_nested_set scope: [:panda_cms_menu_id], counter_cache: :children_count
+
+      self.implicit_order_column = "lft"
+      self.table_name = "panda_cms_menu_items"
+
+      belongs_to :menu, foreign_key: :panda_cms_menu_id, class_name: "Panda::CMS::Menu", inverse_of: :menu_items, touch: true
+      belongs_to :page, foreign_key: :panda_cms_page_id, class_name: "Panda::CMS::Page", inverse_of: :menu_items, optional: true
+
+      validates :text, presence: true, uniqueness: {scope: :panda_cms_menu_id, case_sensitive: false}
+      validates :page, presence: true, unless: -> { external_url.present? }
+      validates :external_url, presence: true, unless: -> { page.present? }
+
+      validate :validate_is_actual_link
+
+      #
+      # Returns the resolved link for the menu item.
+      #
+      # If the menu item is associated with a page, it returns the path of the page.
+      # If the menu item is associated with an external URL, it returns the external URL.
+      #
+      # @return [String] Resolved link
+      # @visibility public
+      def resolved_link
+        if page
+          page.path
+        elsif external_url
+          external_url
+        else
+          ""
+        end
+      end
+
+      private
+
+      #
+      # Validate that the link is an actual link or a page
+      #
+      # @return nil
+      # @visibility private
+      def validate_is_actual_link
+        if page.nil? && external_url.nil?
+          errors.add(:page, "must be a valid page or external link, neither are set")
+          errors.add(:external_url, "must be a valid page or external link, neither are set")
+        end
+
+        if !page.nil? && !external_url.nil?
+          errors.add(:page, "must be a valid page or external link, both are set")
+          errors.add(:external_url, "must be a valid page or external link, both are set")
+        end
+      end
+    end
+  end
+end

data/app/models/panda/cms/page.rb

@@ -0,0 +1,96 @@
+require "awesome_nested_set"
+
+module Panda
+  module CMS
+    class Page < ApplicationRecord
+      acts_as_nested_set counter_cache: :children_count
+      self.table_name = "panda_cms_pages"
+      self.implicit_order_column = "lft"
+
+      has_paper_trail versions: {
+        class_name: "Panda::CMS::PageVersion"
+      }
+
+      after_save :after_save
+
+      belongs_to :template, foreign_key: :panda_cms_template_id, class_name: "Panda::CMS::Template", inverse_of: :pages, optional: false, counter_cache: :pages_count
+      has_many :blocks, through: :template
+      has_many :block_contents, foreign_key: :panda_cms_page_id, class_name: "Panda::CMS::BlockContent", inverse_of: :page
+      has_many :menu_items, foreign_key: :panda_cms_page_id, class_name: "Panda::CMS::MenuItem", inverse_of: :page
+      has_many :menus, through: :menu_items
+      has_many :menus_of_parent, through: :parent, source: :menus
+      has_one :page_menu, foreign_key: :start_page_id, class_name: "Panda::CMS::Menu"
+
+      validates :title, presence: true
+
+      validates :path,
+        presence: true,
+        uniqueness: true,
+        format: {with: /\A\/.*\z/, message: "must start with a forward slash"}
+
+      validates :parent,
+        presence: true,
+        unless: -> { path == "/" }
+
+      validates :panda_cms_template_id,
+        presence: true
+
+      scope :ordered, -> { order(:lft) }
+
+      enum :status, {
+        active: "active",
+        draft: "draft",
+        hidden: "hidden",
+        archived: "archived"
+      }
+
+      #
+      # Update any menus which include this page or its parent as a menu item
+      #
+      # @return nil
+      # @visibility public
+      #
+      def update_auto_menus
+        menus.find_each(&:generate_auto_menu_items)
+        menus_of_parent.find_each(&:generate_auto_menu_items)
+      end
+
+      private
+
+      #
+      # After save callbacks
+      #
+      # @return nil
+      # @visibility private
+      #
+      def after_save
+        generate_content_blocks
+        update_existing_menu_items
+        update_auto_menus
+      end
+
+      def generate_content_blocks
+        template_block_ids = template.blocks.ids
+        page_existing_block_ids = block_contents.map { |bc| bc.block.id }
+        required_block_ids = template_block_ids - page_existing_block_ids
+
+        if required_block_ids.count > 0
+          required_block_ids.each do |block_id|
+            Panda::CMS::BlockContent.find_or_create_by!(page: self, panda_cms_block_id: block_id, content: "")
+          end
+        end
+      end
+
+      #
+      # Update text of existing menu items if the title differs
+      #
+      # @return nil
+      # @todo Only run this if the page title has changed
+      # @visibility private
+      #
+      def update_existing_menu_items
+        menu_items.where.not(text: title).update_all(text: title)
+      end
+    end
+  end
+end

data/app/models/panda/cms/page_version.rb

@@ -0,0 +1,8 @@
+module Panda
+  module CMS
+    class PageVersion < Version
+      self.table_name = :panda_cms_page_versions
+      self.sequence_name = :panda_cms_page_versions_id_seq
+    end
+  end
+end

data/app/models/panda/cms/post.rb

@@ -0,0 +1,60 @@
+require "awesome_nested_set"
+
+module Panda
+  module CMS
+    class Post < ApplicationRecord
+      include ::Panda::CMS::EditorJsContent
+
+      self.table_name = "panda_cms_posts"
+
+      has_paper_trail versions: {
+        class_name: "Panda::CMS::PostVersion"
+      }
+
+      belongs_to :user, class_name: "Panda::CMS::User"
+
+      validates :title, presence: true
+      validates :slug,
+        presence: true,
+        uniqueness: true,
+        format: {
+          with: /\A\/[a-z0-9-]+\z/,
+          message: "must start with a forward slash and contain only lowercase letters, numbers, and hyphens"
+        }
+
+      scope :ordered, -> { order(published_at: :desc) }
+      scope :with_user, -> { includes(:user) }
+
+      enum :status, {
+        active: "active",
+        draft: "draft",
+        hidden: "hidden",
+        archived: "archived"
+      }
+
+      def to_param
+        slug.delete_prefix("/")
+      end
+
+      def admin_param
+        id
+      end
+
+      def excerpt(length = 100, squish: true)
+        return "" if content.blank?
+
+        text = if content.is_a?(Hash) && content["blocks"]
+          content["blocks"]
+            .select { |block| block["type"] == "paragraph" }
+            .map { |block| block["data"]["text"] }
+            .join(" ")
+        else
+          content.to_s
+        end
+
+        text = text.squish if squish
+        text.truncate(length).html_safe
+      end
+    end
+  end
+end

data/app/models/panda/cms/post_version.rb

@@ -0,0 +1,8 @@
+module Panda
+  module CMS
+    class PostVersion < Version
+      self.table_name = :panda_cms_post_versions
+      self.sequence_name = :panda_cms_post_versions_id_seq
+    end
+  end
+end

data/app/models/panda/cms/redirect.rb

@@ -0,0 +1,11 @@
+module Panda
+  module CMS
+    class Redirect < ApplicationRecord
+      belongs_to :origin_page, class_name: "Panda::CMS::Page", foreign_key: :origin_panda_cms_page_id
+      belongs_to :destination_page, class_name: "Panda::CMS::Page", foreign_key: :destination_panda_cms_page_id
+
+      validates :status_code, presence: true
+      validates :visits, presence: true
+    end
+  end
+end

data/app/models/panda/cms/template.rb

@@ -0,0 +1,124 @@
+module Panda
+  module CMS
+    # Represents a template in the Panda CMS application.
+    class Template < ApplicationRecord
+      self.table_name = "panda_cms_templates"
+
+      # Enables versioning for the Template model using the `has_paper_trail` gem.
+      has_paper_trail versions: {
+        class_name: "Panda::CMS::TemplateVersion"
+      }
+
+      # Associations
+      has_many :pages, class_name: "Panda::CMS::Page", dependent: :restrict_with_error, inverse_of: :template, foreign_key: :panda_cms_template_id
+      has_many :blocks, class_name: "Panda::CMS::Block", dependent: :restrict_with_error, inverse_of: :template, foreign_key: :panda_cms_template_id
+      has_many :block_contents, through: :blocks
+
+      # Validations
+      validates :name, presence: true, uniqueness: true
+
+      validates :file_path,
+        presence: true,
+        uniqueness: true,
+        format: {with: /\Alayouts\/.*\z/, message: "must be a valid layout file path"}
+
+      validate :validate_template_file_exists
+
+      # Scopes
+      scope :available, -> {
+        where("max_uses IS NULL OR (pages_count IS NOT NULL AND pages_count < max_uses)")
+      }
+
+      def self.default
+        find_by(file_path: "layouts/page")
+      end
+
+      # Generate missing blocks for all templates
+      # @return [void]
+      def self.generate_missing_blocks
+        # Loop through all templates in app/views/layouts/*.html.erb
+        Dir.glob("app/views/layouts/*.html.erb").each do |file|
+          # TODO: Delete all blocks which aren't in use by a template?
+
+          File.open(file).each_line do |line|
+            # Matches:
+            # Panda::CMS::RichTextComponent.new(key: :value)
+            # Panda::CMS::RichTextComponent.new key: :value, key: value
+            line.match(/Panda::CMS::([a-zA-Z]+)Component\.new[ \(]+([^\)]+)[\)]*/) do |match|
+              # Extract the hash values
+              template_path = file.gsub("app/views/", "").gsub(".html.erb", "")
+              template_name = template_path.gsub("layouts/", "").titleize
+
+              # Create the template if it doesn't exist
+              template = Panda::CMS::Template.find_or_create_by!(file_path: template_path) do |template|
+                template.name = template_name
+              end
+
+              next if match[1] == "PageMenu" # Skip PageMenu blocks
+              next if match[1] == "Menu" # Skip Menu blocks
+
+              # Previously used match[1].underscore but this supports more complex database
+              # operations, and is more secure as it'll force the usage of a class
+              block_kind = "Panda::CMS::#{match[1]}Component".constantize::KIND
+
+              match[2].split(",").map do |keyvar|
+                key, value = keyvar.split(":", 2)
+                next if key != "key"
+
+                block_name = value.to_s.strip.tr(":", "")
+                # Create the block if it doesn't exist
+                # TODO: +/- the output if it's created or removed
+                begin
+                  block = Panda::CMS::Block.find_or_create_by!(template: template, kind: block_kind, key: block_name) do |block|
+                    block.name = block_name.titleize
+                  end
+                rescue ActiveRecord::RecordInvalid => e
+                  raise "Error creating block '#{block_name}' on template '#{template_name}': #{e.message}"
+                end
+
+                # For the given block, create the block_content for each page using the template
+                template.pages.each do |page|
+                  Panda::CMS::BlockContent.find_or_create_by!(block: block, page: page) do |block_content|
+                    block_content.content = {}
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+
+      private
+
+      # Custom validation method to check if the file_path is a valid layout file path
+      # NB: Currently only supports .html.erb templates, may want to expand in future?
+      # @return [void]
+      def validate_template_file_exists
+        # Remove any directory traversal attempts from the file_path
+        safe_file_path = file_path.to_s.gsub("../", "")
+        # Check if the file_path is an ERB template that exists in app/views
+        template_path = Rails.root.join("app", "views", "#{safe_file_path}.html.erb")
+        # NB: file? checks for files and excludes directories (unlike exist?)
+        errors.add(:file_path, "must be an existing layout file path") unless File.file?(template_path)
+      end
+
+      # Import templates from the filesystem into the database
+      # @return [void]
+      def self.load_from_filesystem
+        Rails.root.glob("app/views/layouts/**/*.html.erb").each do |file|
+          # Extract the file path from the Rails root
+          file_path = file.to_s.sub("#{Rails.root}/app/views/", "").sub(".html.erb", "")
+
+          next if file_path == "layouts/application" || file_path == "layouts/mailer"
+
+          # Find or create the template based on the file path
+          find_or_create_by(file_path: file_path) do |t|
+            t.name = file_path.sub("layouts/", "").titleize
+          end
+        end
+      end
+
+      private_class_method :load_from_filesystem
+    end
+  end
+end

data/app/models/panda/cms/template_version.rb

@@ -0,0 +1,8 @@
+module Panda
+  module CMS
+    class TemplateVersion < Version
+      self.table_name = :panda_cms_template_versions
+      self.sequence_name = :panda_cms_template_versions_id_seq
+    end
+  end
+end