panda_cms 0.2.0

data/app/helpers/panda_cms/application_helper.rb

@@ -0,0 +1,91 @@
+module PandaCms
+  module ApplicationHelper
+    def title_tag
+      PandaCms.title
+    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 panda_cms_form_with(**options, &)
+      options[:builder] = PandaCms::FormBuilder
+      options[:class] ||= " bg-white border border-gray-300 rounded-md p-6"
+      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-pink-400 border border-white border-opacity-10 shadow-md text-white relative flex py-3 px-2 mb-2 rounded-md group flex gap-x-3 rounded-md text-base leading-6 font-medium "
+    end
+
+    def nav_highlight_colour_classes(request)
+      "text-sky-100 hover:bg-gray-700 hover:text-white group flex gap-x-3 py-3 px-2 mb-2 rounded-md text-base leading-6 font-medium "
+    end
+
+    def table_indent(item_with_level_attribute)
+      case item_with_level_attribute.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 menu_indent(item_with_level_attribute)
+      case item_with_level_attribute.level
+      when 0
+        "pl-0"
+      when 1
+        "pl-4"
+      when 2
+        "pl-8"
+      when 3
+        "pl-12"
+      when 4
+        "pl-16"
+      else
+        "pl-20"
+      end
+    end
+  end
+end

data/app/helpers/panda_cms/pages_helper.rb

@@ -0,0 +1,4 @@
+module PandaCms
+  module PagesHelper
+  end
+end

data/app/helpers/panda_cms/theme_helper.rb

@@ -0,0 +1,16 @@
+module PandaCms
+  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

data/app/javascript/panda_cms/base.js

@@ -0,0 +1,37 @@
+import { Application as PandaCmsApplication } from "@hotwired/stimulus";
+
+const panda_cms = PandaCmsApplication.start();
+
+// Configure Stimulus development experience
+panda_cms.debug = location.hostname === "localhost";
+window.pandaStimulus = panda_cms;
+
+export { panda_cms };
+
+// Eager load all controllers defined in the import map under controllers/**/*_controller
+import { eagerLoadControllersFrom } from "@hotwired/stimulus-loading";
+eagerLoadControllersFrom("panda_cms/controllers", panda_cms);
+
+import {
+  Alert,
+  Autosave,
+  ColorPreview,
+  Dropdown,
+  Modal,
+  Tabs,
+  Popover,
+  Toggle,
+  Slideover,
+} from "panda_cms/vendor/tailwindcss-stimulus-components";
+panda_cms.register("alert", Alert);
+panda_cms.register("autosave", Autosave);
+panda_cms.register("color-preview", ColorPreview);
+panda_cms.register("dropdown", Dropdown);
+panda_cms.register("modal", Modal);
+panda_cms.register("popover", Popover);
+panda_cms.register("slideover", Slideover);
+panda_cms.register("tabs", Tabs);
+panda_cms.register("toggle", Toggle);
+
+import RailsNestedForm from "panda_cms/vendor/stimulus-components-rails-nested-form";
+panda_cms.register("nested-form", RailsNestedForm);

data/app/javascript/panda_cms/controllers/menu_controller.js

@@ -0,0 +1,19 @@
+import { Controller as PandaCmsController } from "@hotwired/stimulus"
+
+export default class extends PandaCmsController {
+  static targets = ["pandaCmsMenu"]
+  static values = {
+    open: { type: Boolean, default: false }
+  }
+
+  toggle(event) {
+    this.openValue = !this.openValue
+    this.animate()
+  }
+
+  animate() {
+    this.toggleableTargets.forEach(target => {
+      transition(target, this.openValue)
+    })
+  }
+}

data/app/javascript/panda_cms/controllers/rich_text_editor_controller.js

@@ -0,0 +1,59 @@
+import { Controller as PandaCmsController } from "@hotwired/stimulus";
+
+export default class extends PandaCmsController {
+  static targets = ["container", "hidden", "toolbar", "form"];
+
+  connect() {
+    this.quillInit();
+  }
+
+  /**
+   * Fire up quill wyswig editor
+   */
+  quillInit() {
+    const quill = new Quill(this.containerTarget, this.quillOption);
+    let _this = this;
+
+    // While we type, copy the text to our hidden form field so it can be saved.
+    quill.on("text-change", function (delta) {
+      _this.hiddenTarget.value = quill.root.innerHTML;
+    });
+
+    // Capture focus on and off events
+    quill.on("selection-change", function (range, oldRange, source) {
+      if (range === null && oldRange !== null) {
+        _this.onFocusOut();
+      } else if (range !== null && oldRange === null) _this.onFocus();
+    });
+  }
+
+  /**
+   * Fires when the editor receives focus
+   */
+  onFocus() {
+    // Add a border and reveal the toolbar
+    this.element.classList.add("border-gray-200");
+    this.toolbarTarget.classList.add("opacity-100");
+  }
+
+  /**
+   * Fires when the editor loses focus
+   */
+  onFocusOut() {
+    // Hide the border and toolbar
+    this.element.classList.remove("border-gray-200");
+    this.toolbarTarget.classList.remove("opacity-100");
+
+    // Submit the form to save our updates
+    this.formTarget.requestSubmit();
+  }
+
+  // Quill configuration options
+  get quillOption() {
+    return {
+      modules: {
+        toolbar: this.toolbarTarget,
+      },
+    };
+  }
+}

data/app/javascript/panda_cms/controllers/text_field_update_controller.js

@@ -0,0 +1,23 @@
+import { Controller as PandaCmsController } from "@hotwired/stimulus"
+export default class extends PandaCmsController {
+  static targets = [ "existing_root", "input_select", "input_text", "output_text" ]
+
+  connect() {
+  }
+
+  generatePath() {
+    this.output_textTarget.value = "/" + this.createSlug(this.input_textTarget.value);
+  }
+
+  setPrePath() {
+    this.parent_slugs = this.input_selectTarget.options[this.input_selectTarget.selectedIndex].text.match(/.*\((.*)\)$/)[1];
+    this.output_textTarget.previousSibling.innerHTML = (this.existing_rootTarget.value + this.parent_slugs).replace(/\/$/, '');;
+  }
+
+  createSlug(input) {
+    return input.toLowerCase().trim()
+      .replace(/[^\w\s-]/g, "-")
+      .replace(/&/, "and")
+      .replace(/[\s_-]+/g, "-");
+  }
+}

data/app/javascript/panda_cms/vendor/stimulus-components-rails-nested-form.js

@@ -0,0 +1,2 @@
+import{Controller as e}from"@hotwired/stimulus";const t=class _RailsNestedForm extends e{add(e){e.preventDefault();const t=this.templateTarget.innerHTML.replace(/NEW_RECORD/g,(new Date).getTime().toString());this.targetTarget.insertAdjacentHTML("beforebegin",t);const r=new CustomEvent("rails-nested-form:add",{bubbles:!0});this.element.dispatchEvent(r)}remove(e){e.preventDefault();const t=e.target.closest(this.wrapperSelectorValue);if(t.dataset.newRecord==="true")t.remove();else{t.style.display="none";const e=t.querySelector("input[name*='_destroy']");e.value="1"}const r=new CustomEvent("rails-nested-form:remove",{bubbles:!0});this.element.dispatchEvent(r)}};t.targets=["target","template"],t.values={wrapperSelector:{type:String,default:".nested-form-wrapper"}};let r=t;export{r as default};
+

data/app/javascript/panda_cms/vendor/tailwindcss-stimulus-components.js

@@ -0,0 +1,2 @@
+import{Controller as e}from"@hotwired/stimulus";var t=Object.defineProperty;var V=(e,a,i)=>a in e?t(e,a,{enumerable:!0,configurable:!0,writable:!0,value:i}):e[a]=i;var s=(e,t,a)=>(V(e,typeof t!="symbol"?t+"":t,a),a);async function r(e,t,a={}){t?T(e,a):b(e,a)}async function T(e,t={}){let a=e.dataset.transitionEnter||t.enter||"enter",i=e.dataset.transitionEnterFrom||t.enterFrom||"enter-from",n=e.dataset.transitionEnterTo||t.enterTo||"enter-to",o=e.dataset.toggleClass||t.toggleClass||"hidden";e.classList.add(...a.split(" ")),e.classList.add(...i.split(" ")),e.classList.remove(...n.split(" ")),e.classList.remove(...o.split(" ")),await v(),e.classList.remove(...i.split(" ")),e.classList.add(...n.split(" "));try{await x(e)}finally{e.classList.remove(...a.split(" "))}}async function b(e,t={}){let a=e.dataset.transitionLeave||t.leave||"leave",i=e.dataset.transitionLeaveFrom||t.leaveFrom||"leave-from",n=e.dataset.transitionLeaveTo||t.leaveTo||"leave-to",o=e.dataset.toggleClass||t.toggle||"hidden";e.classList.add(...a.split(" ")),e.classList.add(...i.split(" ")),e.classList.remove(...n.split(" ")),await v(),e.classList.remove(...i.split(" ")),e.classList.add(...n.split(" "));try{await x(e)}finally{e.classList.remove(...a.split(" ")),e.classList.add(...o.split(" "))}}function v(){return new Promise((e=>{requestAnimationFrame((()=>{requestAnimationFrame(e)}))}))}function x(e){return Promise.all(e.getAnimations().map((e=>e.finished)))}var a=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()}))}};s(a,"values",{dismissAfter:Number,showDelay:{type:Number,default:0}});var i=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)}};s(i,"targets",["form","status"]),s(i,"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 n=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,a=parseInt(e.substr(0,2),16),i=parseInt(e.substr(2,2),16),n=parseInt(e.substr(4,2),16);return(a*299+i*587+n*114)/1e3>=t?"#000":"#fff"}};s(n,"targets",["preview","color"]),s(n,"values",{style:{type:String,default:"backgroundColor"}});var o=class extends e{connect(){document.addEventListener("turbo:before-cache",this.beforeCache.bind(this))}disconnect(){document.removeEventListener("turbo:before-cache",this.beforeCache.bind(this))}openValueChanged(){r(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")}};s(o,"targets",["menu","button","menuItem"]),s(o,"values",{open:{type:Boolean,default:!1},closeOnEscape:{type:Boolean,default:!0},closeOnClickOutside:{type:Boolean,default:!0}}),s(o,"classes",["enter","enterFrom","enterTo","leave","leaveFrom","leaveTo","toggle"]);var l=class extends e{connect(){this.openValue&&this.open(),document.addEventListener("turbo:before-cache",this.beforeCache.bind(this))}disconnect(){document.removeEventListener("turbo:before-cache",this.beforeCache.bind(this))}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()}};s(l,"targets",["dialog"]),s(l,"values",{open:Boolean});var h=class extends e{openValueChanged(){r(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)}};s(h,"targets",["content"]),s(h,"values",{dismissAfter:Number,open:{type:Boolean,default:!1}});var u=class extends e{connect(){this.openValue&&this.open(),document.addEventListener("turbo:before-cache",this.beforeCache.bind(this))}disconnect(){document.removeEventListener("turbo:before-cache",this.beforeCache.bind(this))}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()}};s(u,"targets",["dialog"]),s(u,"values",{open:Boolean});var c=class extends e{initialize(){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;history.replaceState({},document.title,t)}}}showTab(){this.panelTargets.forEach(((e,t)=>{let a=this.tabTargets[t];t===this.indexValue?(e.classList.remove("hidden"),a.ariaSelected="true",a.dataset.active=!0,this.hasInactiveTabClass&&a?.classList?.remove(...this.inactiveTabClasses),this.hasActiveTabClass&&a?.classList?.add(...this.activeTabClasses)):(e.classList.add("hidden"),a.ariaSelected=null,delete a.dataset.active,this.hasActiveTabClass&&a?.classList?.remove(...this.activeTabClasses),this.hasInactiveTabClass&&a?.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}};s(c,"classes",["activeTab","inactiveTab"]),s(c,"targets",["tab","panel","select"]),s(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=>{r(e,this.openValue)}))}};s(d,"targets",["toggleable"]),s(d,"values",{open:{type:Boolean,default:!1}});export{a as Alert,i as Autosave,n as ColorPreview,o as Dropdown,l as Modal,h as Popover,u as Slideover,c as Tabs,d as Toggle};
+

data/app/jobs/panda_cms/application_job.rb

@@ -0,0 +1,4 @@
+module PandaCms
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/lib/panda_cms/demo_site_generator.rb

@@ -0,0 +1,70 @@
+module PandaCms
+  class DemoSiteGenerator
+    attr_accessor :menus, :pages, :templates
+
+    def initialize
+      @menus = {}
+      @pages = {}
+      @templates = {}
+    end
+
+    #
+    # Creates initial templates and empty blocks
+    #
+    # @return [Hash] A hash containing the created templates
+    def create_templates
+      # Templates
+      initial_templates = [
+        {name: "Homepage", file_path: "layouts/homepage", max_uses: 1},
+        {name: "Page", file_path: "layouts/page"}
+      ]
+
+      initial_templates.each do |template|
+        @templates[template[:name].downcase.to_sym] = PandaCms::Template.find_or_create_by!(template)
+      end
+
+      # Blocks
+      initial_blocks = [
+        {kind: "rich_text", name: "Introduction Text", key: "introduction_text", template: @templates[:homepage]},
+        {kind: "rich_text", name: "Main Content", key: "main_content", template: @templates[:homepage]},
+        {kind: "rich_text", name: "Main Content", key: "main_content", template: @templates[:page]}
+      ]
+
+      initial_blocks.each do |block_data|
+        PandaCms::Block.find_or_create_by!(block_data)
+      end
+
+      # Empty block contents
+      PandaCms::Block.find_each do |block|
+        block.template.pages.each do |page|
+          PandaCms::BlockContent.find_or_create_by!(page: page, block: block, content: "")
+        end
+      end
+    end
+
+    #
+    # Creates initial pages
+    #
+    # @return [Hash] A hash containing the created pages
+    def create_pages
+      @pages[:home] = PandaCms::Page.find_or_create_by!({path: "/", title: "Home", template: @templates[:homepage]})
+      @pages[:about] = PandaCms::Page.find_or_create_by!({path: "/about", title: "About", template: @templates[:page], parent: @pages[:home]})
+      @pages[:terms] = PandaCms::Page.find_or_create_by!({path: "/terms-and-conditions", title: "Terms & Conditions", template: @templates[:page], parent: @pages[:home]})
+    end
+
+    #
+    # Creates initial menus
+    #
+    # @return [Hash] A hash containing the created menus
+    #
+    def create_menus
+      @menus = {}
+      @menus[:main] = PandaCms::Menu.find_or_create_by!(name: "Main Menu")
+      @menus[:footer] = PandaCms::Menu.find_or_create_by!(name: "Footer Menu")
+
+      # Automatically create main menu from homepage
+      @menus[:main].update(kind: :auto, start_page: @pages[:home])
+      @menus[:main].generate_auto_menu_items
+    end
+  end
+end

data/app/lib/panda_cms/slug.rb

@@ -0,0 +1,21 @@
+module PandaCms
+  class Slug
+    # Generates a slug from a provided string
+    #
+    # @param string [String] The provided string to turn into a slug
+    # @return string Generated slug
+    # @see text_field_update_controller.js should also implement this logic
+    def self.generate(string)
+      # Trim whitespace and downcase the string
+      string = string.to_s.strip.downcase
+      # Replace & with "and"
+      string = string.gsub("&", "and")
+      # Remove special characters
+      string = string.gsub(/[\!\@\£\$\%\^\&\*\(\)\+\=\{\}\[\]\:\;\"\'\|\\\`\<\>\?\,\.\/]+/, "")
+      # Replace any whitespace character with -
+      string = string.gsub(/[^\w\s-]/, "-")
+      # Replace multiple occurences of _ and - with -
+      string.gsub(/[\s_-]+/, "-")
+    end
+  end
+end

data/app/mailers/panda_cms/application_mailer.rb

@@ -0,0 +1,6 @@
+module PandaCms
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/panda_cms/application_record.rb

@@ -0,0 +1,5 @@
+module PandaCms
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/panda_cms/block.rb

@@ -0,0 +1,32 @@
+module PandaCms
+  class Block < ApplicationRecord
+    self.table_name = "panda_cms_blocks"
+
+    belongs_to :template, foreign_key: :panda_cms_template_id, class_name: "PandaCms::Template", inverse_of: :blocks, optional: true
+    has_many :block_contents, foreign_key: :panda_cms_block_id, class_name: "PandaCms::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"
+      # image: "image",
+      # video: "video",
+      # audio: "audio",
+      # file: "file",
+      # code: "code",
+      # iframe: "iframe",
+      # quote: "quote",
+      # list: "list"
+      # table: "table",
+      # form: "form"
+    }
+  end
+end

data/app/models/panda_cms/block_content.rb

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

data/app/models/panda_cms/block_content_version.rb

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

data/app/models/panda_cms/breadcrumb.rb

@@ -0,0 +1,10 @@
+module PandaCms
+  class Breadcrumb
+    attr_reader :name, :path
+
+    def initialize(name, path)
+      @name = name
+      @path = path
+    end
+  end
+end

data/app/models/panda_cms/current.rb

@@ -0,0 +1,15 @@
+module PandaCms
+  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

data/app/models/panda_cms/menu.rb

@@ -0,0 +1,50 @@
+module PandaCms
+  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: "PandaCms::MenuItem", inverse_of: :menu
+    belongs_to :start_page, class_name: "PandaCms::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.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

data/app/models/panda_cms/menu_item.rb

@@ -0,0 +1,56 @@
+require "awesome_nested_set"
+
+module PandaCms
+  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: "PandaCms::Menu", inverse_of: :menu_items, touch: true
+    belongs_to :page, foreign_key: :panda_cms_page_id, class_name: "PandaCms::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