panda_cms 0.5.0

data/app/javascript/controllers/text_controller.js

@@ -0,0 +1,78 @@
+import { Controller as PandaCmsController } from "@hotwired/stimulus";
+
+export default class extends PandaCmsController {
+  static targets = ["source"];
+  static values = { page: String, blockcontent: String };
+  static classes = ["initial", "success", "error"];
+
+  connect() {
+    this.sourceTarget.classList.add(...this.initialClasses);
+  }
+
+  save() {
+    this.cleanedContent = this.clean(this.sourceTarget.innerHTML);
+
+    fetch(
+      `/admin/pages/${this.pageValue}/block_contents/${this.blockcontentValue}`,
+      {
+        method: "PATCH",
+        headers: {
+          "Content-Type": "application/json",
+          "X-CSRF-Token": document
+            .querySelector('meta[name="csrf-token"]')
+            .getAttribute("content"),
+        },
+        body: JSON.stringify({ content: this.cleanedContent }),
+      }
+    )
+      .then((response) => response.json())
+      .then((data) => {
+        this.setSuccessClasses();
+      })
+      .catch((error) => {
+        alert("Error:", error);
+        console.log(error);
+        this.element.classList.remove(
+          ...this.initialClasses,
+          ...this.successClasses
+        );
+        this.element.classList.add(...this.errorClasses);
+      });
+  }
+
+  setInitialClasses() {
+    this.element.classList.remove(...this.successClasses, ...this.errorClasses);
+    this.element.classList.add(...this.initialClasses);
+  }
+
+  setSuccessClasses() {
+    this.element.classList.remove(...this.initialClasses, ...this.errorClasses);
+    this.element.classList.add(...this.successClasses);
+    this.resetInitialClassesTimer();
+  }
+
+  setErrorClasses() {
+    this.element.classList.remove(
+      ...this.initialClasses,
+      ...this.successClasses
+    );
+    this.element.classList.add(...this.errorClasses);
+    this.resetInitialClassesTimer();
+  }
+
+  resetInitialClassesTimer() {
+    setTimeout(
+      function () {
+        this.setInitialClasses();
+      }.bind(this),
+      1000
+    );
+  }
+
+  clean(content) {
+    // Replace horrible bullet points
+    content = content.replace(/• /g, "* ");
+    // TODO: More formatting
+    return content;
+  }
+}

data/app/javascript/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/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/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/jobs/panda_cms/record_visit_job.rb

@@ -0,0 +1,29 @@
+module PandaCms
+  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
+    )
+      PandaCms::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

data/app/lib/panda_cms/bulk_editor.rb

@@ -0,0 +1,169 @@
+require "htmlentities"
+require "json"
+
+module PandaCms
+  #
+  # Bulk editor for site content in JSON format
+  #
+  class BulkEditor
+    #
+    # Export all site content to a JSON string
+    #
+    # @return [String] The JSON data
+    #
+    def self.export
+      data = extract_current_data
+      JSON.pretty_generate(data)
+    end
+
+    #
+    # Import site content from a JSON string
+    #
+    # @param json_data [String] The JSON data to import
+    # @return [Hash] A hash of debug information
+    #
+    def self.import(json_data)
+      # See if we can parse the JSON
+      new_data = JSON.parse(json_data)
+      current_data = extract_current_data
+
+      debug = {
+        success: [],
+        error: [],
+        warning: []
+      }
+
+      # Make sure templates are up to date
+      PandaCms::Template.generate_missing_blocks
+
+      # Run through the new data and compare it to the current data
+      new_data["pages"].each do |path, page_data|
+        if current_data["pages"][path].nil?
+          begin
+            page = PandaCms::Page.create!(
+              path: path,
+              title: page_data["title"],
+              template: PandaCms::Template.find_by(name: page_data["template"]),
+              parent: PandaCms::Page.find_by(path: page_data["parent"])
+            )
+          rescue => e
+            debug[:error] << "Failed to create page '#{path}': #{e.message}"
+            next
+          end
+
+          if !page
+            debug[:error] << "Unhandled: page '#{path}' does not exist in the current data and cannot be created"
+            next
+          else
+            debug[:success] << "Created page '#{path}' with title '#{page_data["title"]}'"
+          end
+        else
+          page = PandaCms::Page.find_by(path: path)
+
+          if page_data["title"] != current_data["pages"][path]["title"]
+            page.update(title: page_data["title"])
+            debug[:success] << "Updated: page '#{path}' title from '#{current_data["pages"][path]["title"]}' to '#{page_data["title"]}'"
+          end
+
+          if page_data["template"] != current_data["pages"][path]["template"]
+            # TODO: Handle page template changes
+            debug[:error] << "Page '#{path}' template is '#{current_data["pages"][path]["template"]}' and cannot be changed to '#{page_data["template"]}' without manual intervention"
+          end
+        end
+
+        page_data["contents"].each do |key, block_data|
+          content = block_data["content"]
+
+          if current_data.dig("pages", path, "contents", key).nil?
+            raise "Unknown page 1" if page.nil?
+            block = PandaCms::Block.find_or_create_by(key: key, template: page.template) do |block_meta|
+              block_meta.name = key.titleize
+            end
+
+            if !block
+              debug[:error] << "Error creating block '#{key.titleize}' on page '#{page.title}'"
+              next
+            end
+
+            block_content = PandaCms::BlockContent.find_or_create_by(block: block, page: page)
+            # block_content.content = HTMLEntities.new.encode(content, :named)
+            block_content.content = content
+
+            begin
+              block_content.save!
+
+              if block_content.content != content
+                debug[:error] << "Failed to save content for '#{block.name}' on page '#{page.title}'"
+              else
+                debug[:success] << "Created '#{block.name}' content on page '#{page.title}'"
+              end
+            rescue => e
+              debug[:error] << "Failed to create '#{block.name}' content on page '#{page.title}': #{e.message}"
+            end
+          elsif content != current_data["pages"][path]["contents"][key]["content"]
+            # Content has changed
+            raise "Unknown page 2" if page.nil?
+            block = PandaCms::Block.find_by(key: key, template: page.template)
+            if PandaCms::BlockContent.find_by(page: page, block: block)&.update(content: content)
+              debug[:success] << "Updated '#{key.titleize}' content on page '#{page.title}'"
+            else
+              debug[:error] << "Failed to update '#{key.titleize}' content on page '#{page.title}'"
+            end
+          end
+        end
+      end
+
+      new_data["menus"].each do |menu_data|
+      end
+
+      new_data["templates"].each do |template_data|
+      end
+
+      debug
+    end
+
+    #
+    # Extract the current data from the database into a standardised format
+    #
+    # Used both as the export format, and to compare imported data with for changes
+    #
+    # @visibility private
+    def self.extract_current_data
+      data = {
+        "pages" => {},
+        "menus" => {},
+        "templates" => {},
+        "settings" => {}
+      }
+
+      # Pages
+      PandaCms::Page.includes(:template).order("lft ASC").each do |page|
+        data["pages"][page.path] ||= {}
+      end
+
+      # TODO: Eventually set the position of the block in the template, and then order from there rather than the name?
+      PandaCms::BlockContent.includes(:block, page: [:template]).order("panda_cms_pages.lft ASC, panda_cms_blocks.key ASC").each do |block_content|
+        item = data["pages"][block_content.page.path] ||= {}
+        item["title"] = block_content.page.title
+        item["template"] = block_content.page.template.name
+        item["parent"] = block_content.page.parent&.path
+        item["contents"] ||= {}
+        item["contents"][block_content.block.key] = {
+          kind: block_content.block.kind, # We need the kind to recreate the block
+          content: block_content.content
+        }
+        data["pages"][block_content.page.path] = item
+      end
+
+      # Menus
+      # item = data["menus"][] ||= {}
+
+      # Templates
+      # item = data["templates"][] ||= {}
+
+      data["settings"] = {}
+
+      data.with_indifferent_access
+    end
+  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,22 @@
+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: "noreply@pandacms.io"
+    layout "mailer"
+  end
+end

data/app/mailers/panda_cms/form_mailer.rb

@@ -0,0 +1,19 @@
+module PandaCms
+  class FormMailer < PandaCms::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

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/form.rb

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

data/app/models/panda_cms/form_submission.rb

@@ -0,0 +1,5 @@
+module PandaCms
+  class FormSubmission < ApplicationRecord
+    self.table_name = "panda_cms_form_submissions"
+  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.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