spree_page_builder 5.3.0.rc1

data/app/views/spree/admin/pages/_table_row.html.erb

@@ -0,0 +1,28 @@
+<tr id="<%= dom_id page %>" data-controller="row-link" class="cursor-pointer">
+  <td scope="row" data-action="click->row-link#openLink" class="w-60">
+    <%= link_to page.name, spree.edit_admin_theme_path(current_store.default_theme, page_id: page.id), data: { row_link_target: :link, turbo_frame: '_top', turbo_prefetch: false } %>
+  </td>
+  <td data-action="click->row-link#openLink" class="w-15">
+    <%= spree_time_ago(page.created_at) %>
+  </td>
+  <td data-action="click->row-link#openLink" class="w-15">
+    <%= spree_time_ago(page.updated_at) %>
+  </td>
+  <td class="w-10 text-right">
+    <%= dropdown do %>
+      <%= dropdown_toggle class: 'btn-light btn-sm' do %>
+        <%= icon('dots-vertical', class: 'mr-0') %>
+      <% end %>
+      <%= dropdown_menu do %>
+        <ul class="list-none p-0 mb-0">
+          <li>
+            <%= link_to_with_icon 'edit', Spree.t(:edit), spree.edit_admin_theme_path(current_store.default_theme, page_id: page.id), class: 'dropdown-item', data: { turbo_frame: '_top', turbo_prefetch: false } %>
+          </li>
+          <li>
+            <%= link_to_delete(page, class: 'dropdown-item text-red-600 hover:bg-red-100', icon: 'trash') %>
+          </li>
+        </ul>
+      <% end %>
+    <% end %>
+  </td>
+</tr>

data/app/views/spree/admin/pages/edit.html.erb

@@ -0,0 +1,13 @@
+<%= turbo_frame_tag :dialog do %>
+  <%= form_with model: @page, url: spree.admin_page_path(@page), data: { controller: 'slug-form seo-form' }, scope: :page do |f| %>
+    <%= dialog_header(@page.display_name) %>
+    <div class="dialog-body">
+      <%= render 'spree/admin/shared/error_messages', target: @page %>
+      <%= render 'form', f: f, vertical: true %>
+    </div>
+    <div class="dialog-footer">
+      <%= turbo_save_button_tag Spree.t('actions.save'), data: {turbo_frame: :_top} %>
+      <%= link_to Spree.t('actions.destroy'), spree.admin_page_path(@page.id), data: { turbo_method: :delete, turbo_frame: '_top', turbo_confirm: Spree.t(:are_you_sure )}, class: 'btn btn-danger ml-auto' %>
+    </div>
+  <% end %>
+<% end %>

data/app/views/spree/admin/pages/filters.html.erb

@@ -0,0 +1,7 @@
+<%= search_form_for [:admin, @search], url: spree.admin_pages_path , class: "filter-wrap", data: {controller: "filters"} do |f| %>
+  <%= render 'spree/admin/shared/filters_search_bar', param: :name_cont, label: Spree.t(:name) %>
+
+  <%= render "spree/admin/shared/filter_badge_template" %>
+
+  <div data-filters-target="badgesContainer" class="filter-badges-container"></div>
+<% end %>

data/app/views/spree/admin/pages/index.html.erb

@@ -0,0 +1,11 @@
+<% content_for :page_title do %>
+  <%= Spree.t(:pages) %>
+<% end %>
+<% content_for :page_actions do %>
+  <%= render_admin_partials(:pages_actions_partials) %>
+  <%= link_to_with_icon 'plus', Spree.t(:add_new_page), spree.new_admin_page_path, class: "btn btn-primary" if can?(:create, Spree::Page.new) %>
+<% end %>
+
+<%= render_admin_partials(:pages_header_partials) %>
+
+<%= render 'spree/admin/shared/index_table' %>

data/app/views/spree/admin/pages/new.html.erb

@@ -0,0 +1 @@
+<%= render 'spree/admin/shared/new_resource', data: { controller: 'slug-form seo-form' } %>

data/app/views/spree/admin/storefront/edit.html.erb

@@ -0,0 +1,89 @@
+<% content_for :page_title do %>
+  <%= Spree.t(:settings) %>
+<% end %>
+
+<% content_for :title do %>
+  <%= Spree.t(:settings) %>
+<% end %>
+
+
+<%= content_for(:page_actions) do %>
+  <%= turbo_save_button_tag Spree.t('actions.update'), form: "edit_store_#{@store.id}" %>
+<% end %>
+
+<%= render partial: 'spree/admin/shared/error_messages', locals: { target: @store }, class: 'mb-12 pb-12' %>
+
+<%= form_for @store, url: spree.admin_storefront_path, method: :patch do |f| %>
+  <div class="grid grid-cols-12 gap-16">
+    <div class="col-span-12 lg:col-span-6 lg:col-start-4">
+      <div class="card mb-6">
+        <div class="card-header">
+          <h5 class="card-title">
+            <%= Spree.t(:seo) %>
+          </h5>
+        </div>
+        <div class="card-body">
+          <%= f.spree_text_field :seo_title %>
+          <%= f.spree_text_area :meta_description %>
+          <%= f.spree_check_box :preferred_index_in_search_engines, label: Spree.t(:index_in_search_engines), help: 'Checking this box will allow your site to appear in search engines.' %>
+        </div>
+      </div>
+
+      <div class="card mb-6">
+        <div class="card-header">
+          <h5 class="card-title">
+            <%= Spree.t(:security) %>
+          </h5>
+        </div>
+        <div class="card-body" data-controller="reveal" data-reveal-hidden-class="hidden">
+          <%= f.spree_check_box :preferred_password_protected, label: Spree.t(:password_protected), help: 'Checking this box will put your storefront behind a password.', data: { action: 'reveal#toggle' } %>
+          <div class="hidden" data-reveal-target="item">
+            <%= f.spree_text_field :storefront_password, label: Spree.t(:password), help: 'Enter a password to protect your storefront.' %>
+          </div>
+        </div>
+      </div>
+
+      <div class="card mb-6">
+        <div class="card-header">
+          <h5 class="card-title">
+            <%= Spree.t(:custom_code) %>
+          </h5>
+        </div>
+        <div class="card-body">
+          <%= f.spree_text_area :storefront_custom_code_head, rows: 4 %>
+          <%= f.spree_text_area :storefront_custom_code_body_start, rows: 4 %>
+          <%= f.spree_text_area :storefront_custom_code_body_end, rows: 4 %>
+        </div>
+      </div>
+
+      <div class="card mb-6">
+        <div class="card-header">
+          <h5 class="card-title">
+            <%= Spree.t(:images) %>
+          </h5>
+        </div>
+        <div class="card-body">
+          <%= f.spree_file_field :favicon_image, width: 120, height: 120, crop: true, label: 'Favicon image', help_bubble: "A favicon is a small image that appears in the tab of your web browser when you visit a website. It is usually a tiny square or rectangle with a unique design or logo that represents the website" %>
+
+          <%= f.spree_file_field :social_image, width: 1200, height: 630, crop: true, label: 'Preview image', help_bubble: "This image will be used when your store is shared on social media or in search engines." %>
+        </div>
+      </div>
+
+      <div class="card mb-6">
+        <div class="card-header">
+          <h5 class="card-title">
+            <%= Spree.t(:social_media) %>
+          </h5>
+        </div>
+        <div class="card-body">
+          <div class="alert alert-info">
+            Social links will be displayed in the footer of your store
+          </div>
+          <% Spree::Store::SUPPORTED_SOCIAL_NETWORKS.each do |social| %>
+            <%= f.spree_text_field social.to_sym, label: social.capitalize, placeholder: Spree::Store::SOCIAL_NETWORKS_CONFIG[social.to_sym][:input_placeholder] %>
+          <% end %>
+        </div>
+      </div>
+    </div>
+  </div>
+<% end %>

data/app/views/spree/admin/themes/_theme.html.erb

@@ -0,0 +1,56 @@
+<tr id="<%= spree_dom_id theme %>">
+  <td class="w-70 p-0">
+    <%= link_to theme.ready? ? spree.edit_admin_theme_path(theme) : '#', class: 'flex align-items-top p-6', data: { turbo_prefetch: false } do %>
+      <div class="w-20">
+        <%= render 'spree/admin/themes/theme_preview_image', theme: theme, css_class: 'border rounded-lg w-full' %>
+      </div>
+
+      <div class="flex flex-col ml-6 w-80">
+        <strong><%= theme.name %></strong>
+        <p class="mb-0 mt-1">
+          <span class="text-gray-600">
+            <%= Spree.t(:updated_at) %>: 
+            <%= spree_time_ago(theme.updated_at) %>
+          </span>
+        </p>
+      </div>
+    <% end %>
+  </td>
+  <td class="w-10">
+    <% if theme.ready? %>
+      <% if theme.default? %>
+        <span class="badge  badge-success">
+          <%= icon('check') %>
+          <%= Spree.t(:live) %>
+        </span>
+      <% else %>
+        <span class="badge  badge-light">
+          <%= Spree.t(:draft) %>
+        </span>
+      <% end %>
+    <% else %>
+      <span class="badge  badge-light">
+        <%= Spree.t(:duplicating) %>
+      </span>
+    <% end %>
+  </td>
+  <td class="w-20">
+    <% if theme.ready? %>
+      <div class="flex justify-end w-full gap-2">
+        <%= link_to Spree.t('actions.publish'), publish_admin_theme_path(theme), class: 'btn btn-sm btn-light', data: { turbo_method: :put } unless theme.default? %>
+        <%= dropdown do %>
+          <%= dropdown_toggle class: 'btn-light btn-sm h-full' do %>
+            <%= icon('dots-vertical', class: 'mr-0') %>
+          <% end %>
+          <%= dropdown_menu do %>
+            <%= link_to_edit theme, class: 'dropdown-item', data: { turbo_prefetch: false } %>
+            <%= link_to_with_icon 'copy', Spree.t(:clone), spree.clone_admin_theme_path(theme), class: 'dropdown-item', data: { turbo_method: :post } %>
+            <% unless theme.default? %>
+            <%= link_to_delete(theme, icon: 'trash', class: 'dropdown-item text-red-600 hover:bg-red-100 shadow-none') if can?(:delete, theme) %>
+          <% end %>
+          <% end %>
+        <% end %>
+      </div>
+    <% end %>
+  </td>
+</tr>

data/app/views/spree/admin/themes/_theme_preview_image.html.erb

@@ -0,0 +1,17 @@
+<% width ||= 120 %>
+<% height ||= 72 %>
+<% css_class ||= '' %>
+
+<% if theme.screenshot.attached? && theme.screenshot.variable? %>
+  <%= image_tag(spree_image_url(theme.screenshot, width: width, height: height), class: css_class, loading: :lazy) %>
+<% elsif theme.class.preview_image_url.present? %>
+  <%= image_tag(
+  theme.class.preview_image_url,
+  class: css_class,
+  loading: :lazy
+) %>
+<% else %>
+  <div class="rounded-md bg-gray-25 text-gray-600 flex items-center justify-center img-fluid" style="height: <%= height %>px">
+    <%= icon('camera-off', class: 'text-gray-600 opacity-50') %>
+  </div>
+<% end %>

data/app/views/spree/admin/themes/edit.html.erb

@@ -0,0 +1,14 @@
+<div class="hidden md:block">
+  <div class="desktopLiveView" data-page-builder-target="previewContainer">
+    <div class="embed-responsive embed-responsive-4by3 bg-transparent">
+      <iframe class="embed-responsive-item border border-gray-200 bg-transparent rounded-xl"
+              data-page-builder-target="iframe"
+              data-action="load->page-builder#initializeVisualEditor"
+              id="page-builder-preview"
+              sandbox="allow-same-origin allow-forms allow-popups allow-scripts allow-modals">
+      </iframe>
+    </div>
+  </div>
+</div>
+
+<%= turbo_frame_tag :iframe_preview_scripts %>

data/app/views/spree/admin/themes/index.html.erb

@@ -0,0 +1,80 @@
+<%= content_for :page_title do %>
+  <%= Spree.t(:themes) %>
+<% end %>
+
+<%= content_for :page_actions do %>
+  <%= render_admin_partials(:themes_actions_partials) %>
+  <%= link_to_with_icon 'eye', Spree.t(:view_your_store), current_store.formatted_url_or_custom_domain, class: 'btn btn-light', target: '_blank' %>
+<% end %>
+
+<%= content_for :page_alerts do %>
+  <div class="alert alert-info">
+    If you wan't to make changes to theme but don't want to go live with them,
+    you can make a copy of the theme and make changes to the copy. And later promote that copy
+    to the live theme.
+  </div>
+  <br />
+
+  <% unless current_store.default_custom_domain&.active? %>
+    <div class="alert alert-info inline-flex items-center py-2 pr-2">
+      <div class="flex items-center">
+        <span>
+          You don't have domain connected to your store
+        </span>
+        <%= link_to 'Connect your own domain', spree.admin_custom_domains_path, class: 'btn btn-secondary ml-4' %>
+      </div>
+    </div>
+  <% end %>
+<% end %>
+
+<%= render_admin_partials(:themes_header_partials) %>
+
+<div class="card-lg">
+  <table class="table">
+    <thead>
+      <tr>
+        <th><%= Spree.t(:theme) %></th>
+        <th><%= Spree.t(:status) %></th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      <%= render partial: 'spree/admin/themes/theme', collection: @themes, cached: spree_base_cache_scope %>
+    </tbody>
+  </table>
+</div>
+
+<% if available_themes.any? %>
+  <div class="card-lg">
+    <div class="card-header">
+      <h5 class="card-title">Add a new theme</h5>
+    </div>
+    <div class="card-body pb-0">
+      <p>Pick a theme from the list of available themes</p>
+
+      <div class="row row-cols-1 row-cols-md-2 row-cols-lg-3">
+        <% available_themes.each do |theme| %>
+          <div class="col mb-6">
+            <div class="card hover:bg-gray-25">
+              <% if theme.preview_image_url.present? %>
+                <%= image_tag theme.preview_image_url, class: 'card-img-top' %>
+              <% end %>
+              <div class="card-body">
+                <h5 class="card-title"><%= theme.display_name %></h5>
+                <p class="text-gray-600">
+                  by <%= link_to theme.authors.join(', '), theme.website, target: '_blank' %>
+                </p>
+                <p><%= theme.description %></p>
+
+                <%= form_for :theme, url: spree.admin_themes_path do |f| %>
+                  <%= f.hidden_field :type, value: theme.to_s %>
+                  <%= f.submit Spree.t(:add), class: 'btn btn-primary' %>
+                <% end %>
+              </div>
+            </div>
+          </div>
+        <% end %>
+      </div>
+    </div>
+  </div>
+<% end %>

data/app/views/spree/admin/themes/update.turbo_stream.erb

@@ -0,0 +1 @@
+<%= refresh_theme_preview %>

data/config/initializers/spree_admin_navigation.rb

@@ -0,0 +1,46 @@
+# Page Builder Admin Navigation Configuration
+# This file defines the storefront/page builder navigation for Spree Admin
+
+Rails.application.config.after_initialize do
+  # ===============================================
+  # Sidebar Navigation
+  # ===============================================
+  sidebar_nav = Spree.admin.navigation.sidebar
+
+  # Storefront with submenu
+  sidebar_nav.add :storefront,
+          label: 'admin.storefront',
+          url: :admin_themes_path,
+          icon: 'building-store',
+          position: 65,
+          if: -> { can?(:manage, Spree::Theme) } do |storefront|
+
+    # Pages
+    storefront.add :pages,
+                  label: :pages,
+                  url: :admin_pages_path,
+                  position: 20,
+                  if: -> { can?(:manage, Spree::Page) }
+
+    # Storefront Settings
+    storefront.add :storefront_settings,
+                  label: :settings,
+                  url: :edit_admin_storefront_path,
+                  position: 40,
+                  if: -> { can?(:manage, current_store) }
+  end
+
+  # ===============================================
+  # Settings Navigation
+  # ===============================================
+  settings_nav = Spree.admin.navigation.settings
+
+  # Checkout
+  settings_nav.add :checkout,
+          label: :checkout,
+          url: -> { spree.edit_admin_store_path(section: 'checkout') },
+          icon: 'shopping-cart',
+          position: 50,
+          active: -> { controller_name == 'stores' && params[:section] == 'checkout' },
+          if: -> { can?(:manage, current_store) }
+end

data/config/initializers/spree_admin_partials.rb

@@ -0,0 +1,3 @@
+Rails.application.config.after_initialize do
+  Spree.admin.partials.dashboard_sidebar << 'spree/admin/dashboard/store_preview'
+end

data/config/locales/en.yml

@@ -0,0 +1,42 @@
+en:
+  spree:
+    admin:
+      edit_theme: Edit theme
+      page_builder:
+        background_color: Background color
+        border_bottom_width: Border bottom width
+        border_color: Border color
+        border_top_width: Border top width
+        bottom_padding: Bottom padding
+        button_alignment: Button alignment
+        button_background_color: Button background color
+        button_style: Button style
+        button_text: Button's text
+        button_text_color: Button text color
+        category: Category
+        description: Description
+        description_alignment: Description alignment
+        desktop_image_alignment: Image alignment for desktop
+        desktop_logo_height: Logo height (desktop)
+        heading: Heading
+        heading_alignment: Heading alignment
+        heading_size: Heading size
+        height: Height
+        image_click_hint: Clicking on the image will send the user to the selected page/URL
+        left_aligned: Left aligned
+        logo_centered: Logo centered
+        max_video_width_on_desktop: Max video width on desktop
+        maximum_posts_to_show: Maximum posts to show
+        maximum_products_to_show: Maximum products to show
+        nav_centered: Nav centered
+        not_set: Not set
+        separated: Separated
+        show_more_button: Show explore category button
+        show_taxon_image: Show taxon image
+        text_color: Text color
+        title: Title
+        top_padding: Top padding
+        use_description_from_admin: Use description from admin
+        vertical_alignment: Vertical alignment
+        youtube_video_url: Youtube video URL
+    default_theme_name: Default Theme

data/config/routes.rb

@@ -0,0 +1,43 @@
+Spree::Core::Engine.add_routes do
+  namespace :admin, path: Spree.admin_path do
+    # storefront / page builder
+    resource :storefront, only: [:edit, :update], controller: :storefront
+    resources :themes, except: [:new, :show] do
+      member do
+        put :update_with_page
+        put :publish
+        post :clone
+      end
+      resources :sections, controller: 'page_sections', only: %i[new create] do
+        member do
+          patch :move_higher
+          patch :move_lower
+        end
+      end
+    end
+    resources :pages, except: [:show] do
+      resources :sections, controller: 'page_sections', only: %i[new create] do
+        member do
+          patch :move_higher
+          patch :move_lower
+        end
+      end
+    end
+    resources :page_sections, only: %i[edit update destroy] do
+      member do
+        patch :restore_design_settings_to_defaults
+      end
+
+      resources :blocks, controller: 'page_blocks' do
+        member do
+          patch :move_higher
+          patch :move_lower
+        end
+
+        resources :links, controller: 'page_links', only: [:create]
+      end
+      resources :links, controller: 'page_links', only: [:create]
+    end
+    resources :page_links, only: [:edit, :update, :destroy]
+  end
+end

data/db/migrate/20250120094216_create_page_builder_models.rb

@@ -0,0 +1,78 @@
+class CreatePageBuilderModels < ActiveRecord::Migration[6.1]
+  def change
+    if !table_exists?(:spree_themes)
+      create_table :spree_themes do |t|
+        t.string :name
+        t.references :store, null: false, index: true
+        t.boolean :default, default: false, null: false
+        t.boolean :ready, default: true
+        t.string :type, default: 'Spree::Themes::Default', null: false
+        t.references :parent
+        t.text :preferences
+
+        t.timestamps
+        t.datetime :deleted_at
+
+        t.index ['deleted_at'], name: 'index_spree_themes_on_deleted_at'
+      end
+
+      create_table :spree_pages do |t|
+        t.references :pageable, polymorphic: true, null: false
+        t.string :type, null: false
+        t.string :slug
+        t.string :name, null: false
+        t.string :meta_title
+        t.string :meta_description
+        t.string :meta_keywords
+        t.references :parent
+        t.text :preferences
+
+        t.timestamps
+        t.datetime :deleted_at
+
+        t.index ['pageable_id', 'name'], name: 'index_spree_pages_on_pageable_id_and_name'
+        t.index ['pageable_id', 'pageable_type', 'type'], name: 'index_spree_pages_on_pageable_id_and_pageable_type_and_type'
+        t.index ['pageable_id', 'pageable_type'], name: 'index_spree_pages_on_pageable_id_and_pageable_type'
+      end
+
+      create_table :spree_page_sections do |t|
+        t.references :pageable, polymorphic: true, null: false, index: true
+        t.string :type, null: false
+        t.string :name, null: false
+        t.integer :position, default: 1, null: false
+        t.integer :page_links_count, default: 0
+        t.text :preferences
+
+        t.timestamps
+        t.datetime :deleted_at
+
+        t.index ['pageable_id', 'pageable_type', 'position'], name: 'index_spree_page_sections_on_pageable_w_position'
+      end
+
+      create_table :spree_page_blocks do |t|
+        t.references :section, null: false, index: true
+        t.string :name, null: false
+        t.integer :position, default: 1, null: false
+        t.string :type, null: false
+        t.integer :page_links_count, default: 0
+        t.text :preferences
+
+        t.timestamps
+        t.datetime :deleted_at
+
+        t.index ['section_id', 'position'], name: 'index_spree_page_blocks_on_section_w_position'
+      end
+
+      create_table :spree_page_links do |t|
+        t.references :parent, polymorphic: true, index: true
+        t.references :linkable, polymorphic: true, index: true
+        t.string :label
+        t.string :url
+        t.boolean :open_in_new_tab, default: false
+        t.integer :position, default: 1, null: false
+
+        t.timestamps
+      end
+    end
+  end
+end

data/db/migrate/20250305121352_remove_page_builder_indices.rb

@@ -0,0 +1,11 @@
+class RemovePageBuilderIndices < ActiveRecord::Migration[7.2]
+  def change
+    if index_name_exists?(:spree_pages, 'index_spree_pages_on_pageable_id_and_pageable_type_and_slug')
+      remove_index :spree_pages, name: 'index_spree_pages_on_pageable_id_and_pageable_type_and_slug'
+    end
+
+    if index_name_exists?(:spree_themes, 'index_spree_themes_on_store_id_and_default')
+      remove_index :spree_themes, name: 'index_spree_themes_on_store_id_and_default'
+    end
+  end
+end

data/db/migrate/20250825175217_add_missing_page_builder_indexes.rb

@@ -0,0 +1,7 @@
+class AddMissingPageBuilderIndexes < ActiveRecord::Migration[7.2]
+  def change
+    add_index :spree_themes, %w[store_id default], name: 'index_spree_themes_on_store_id_and_default', if_not_exists: true
+    add_index :spree_page_links, %w[parent_type parent_id position], name: 'index_spree_page_links_parent_with_position', if_not_exists: true
+    add_index :spree_page_blocks, :deleted_at, if_not_exists: true
+  end
+end

data/db/migrate/20250913130044_add_page_links_counter_cache_to_spree_stores.rb

@@ -0,0 +1,10 @@
+class AddPageLinksCounterCacheToSpreeStores < ActiveRecord::Migration[7.2]
+  def change
+    add_column :spree_stores, :page_links_count, :integer, default: 0, null: false
+
+    Spree::Store.reset_column_information
+    Spree::Store.find_each do |store|
+      Spree::Store.reset_counters(store.id, :links)
+    end
+  end
+end

data/lib/generators/spree/page_builder/install/install_generator.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Spree
+  module PageBuilder
+    module Generators
+      class InstallGenerator < Rails::Generators::Base
+        class_option :migrate, type: :boolean, default: true
+
+        def add_migrations
+          run 'bundle exec rake railties:install:migrations FROM=spree_page_builder'
+        end
+
+        def run_migrations
+          if options[:migrate]
+            run 'bin/rails db:migrate'
+          else
+            puts 'Skipping rails db:migrate, don\'t forget to run it!'
+          end
+        end
+      end
+    end
+  end
+end