solidus_admin 0.0.2 → 0.1.0

data/config/locales/stores.en.yml

@@ -0,0 +1,6 @@
+en:
+  solidus_admin:
+    stores:
+      title: "Stores"
+      destroy:
+        success: "Stores were successfully removed."

data/config/locales/tax_categories.en.yml

@@ -0,0 +1,6 @@
+en:
+  solidus_admin:
+    tax_categories:
+      title: "Tax Categories"
+      destroy:
+        success: "Tax categories were successfully removed."

data/config/locales/tax_rates.en.yml

@@ -0,0 +1,6 @@
+en:
+  solidus_admin:
+    tax_rates:
+      title: "Tax Rates"
+      destroy:
+        success: "Tax rates were successfully removed."

data/config/locales/taxonomies.en.yml

@@ -0,0 +1,6 @@
+en:
+  solidus_admin:
+    taxonomies:
+      title: "Taxonomies"
+      destroy:
+        success: "Taxonomies were successfully removed."

data/config/locales/users.en.yml

@@ -0,0 +1,6 @@
+en:
+  solidus_admin:
+    users:
+      title: "Users"
+      destroy:
+        success: "Users were successfully removed."

data/config/locales/zones.en.yml

@@ -0,0 +1,6 @@
+en:
+  solidus_admin:
+    zones:
+      title: "Zones"
+      destroy:
+        success: "Zones were successfully removed."

data/config/routes.rb

@@ -1,13 +1,60 @@
 # frozen_string_literal: true
 
 SolidusAdmin::Engine.routes.draw do
+  require "solidus_admin/admin_resources"
+  extend SolidusAdmin::AdminResources
+
   resource :account, only: :show
-  resources :products, only: [:index, :show, :edit, :update] do
+  resources :countries, only: [] do
+    get 'states', to: 'countries#states'
+  end
+
+  admin_resources :products, only: [:index, :update, :destroy] do
     collection do
-      delete :destroy
       put :discontinue
       put :activate
     end
   end
-  resources :orders, only: :index
+
+  # Needs a constraint to avoid interpreting "new" as a product's slug
+  admin_resources :products, only: [
+    :show, :edit
+  ], constraints: ->{ SolidusAdmin::Config.enable_alpha_features? && _1.path != "/admin/products/new" }
+
+  admin_resources :orders, only: [:index]
+
+  admin_resources :orders, except: [
+    :destroy, :index
+  ], constraints: ->{ SolidusAdmin::Config.enable_alpha_features? } do
+    resources :line_items, only: [:destroy, :create, :update]
+    resource :customer
+    resource :ship_address, only: [:show, :edit, :update], controller: "addresses", type: "ship"
+    resource :bill_address, only: [:show, :edit, :update], controller: "addresses", type: "bill"
+
+    member do
+      get :variants_for
+      get :customers_for
+    end
+  end
+
+  admin_resources :users, only: [:index, :destroy]
+  admin_resources :promotions, only: [:index, :destroy]
+  admin_resources :properties, only: [:index, :destroy]
+  admin_resources :option_types, only: [:index, :destroy], sortable: true
+  admin_resources :taxonomies, only: [:index, :destroy], sortable: true
+  admin_resources :promotion_categories, only: [:index, :destroy]
+  admin_resources :tax_categories, only: [:index, :destroy]
+  admin_resources :tax_rates, only: [:index, :destroy]
+  admin_resources :payment_methods, only: [:index, :destroy], sortable: true
+  admin_resources :stock_items, only: [:index, :edit, :update]
+  admin_resources :shipping_methods, only: [:index, :destroy]
+  admin_resources :shipping_categories, only: [:index, :destroy]
+  admin_resources :stock_locations, only: [:index, :destroy]
+  admin_resources :stores, only: [:index, :destroy]
+  admin_resources :zones, only: [:index, :destroy]
+  admin_resources :refund_reasons, only: [:index, :destroy]
+  admin_resources :reimbursement_types, only: [:index]
+  admin_resources :return_reasons, only: [:index, :destroy]
+  admin_resources :adjustment_reasons, only: [:index, :destroy]
+  admin_resources :store_credit_reasons, only: [:index, :destroy]
 end

data/config/tailwind.config.js

@@ -0,0 +1,119 @@
+const defaultTheme = require('tailwindcss/defaultTheme')
+const plugin = require('tailwindcss/plugin')
+const adminRoot = __dirname.replace(/\/config$/, '')
+
+module.exports = {
+  content: [
+    `${adminRoot}/{app/helpers,app/views,app/components,app/assets/javascripts,spec/components/previews}/**/*`,
+  ],
+  theme: {
+    extend: {
+      aria: {
+        current: 'current="true"',
+      },
+      fontFamily: {
+        sans: ["Inter var", ...defaultTheme.fontFamily.sans],
+      },
+      colors: {
+        transparent: "transparent",
+        current: "currentColor",
+
+        // Primary palette
+        "solidus-red": "#ef3023",
+        black: "#222222",
+        graphite: "#c7ccc7",
+        "graphite-light": "#d8dad8",
+        sand: "#f5f3f0",
+        white: "#ffffff",
+
+        // Secondary palette
+        yellow: "#fdc071",
+        orange: "#f68050",
+        blue: "#2554b1",
+        moss: "#2d3925",
+        forest: "#096756",
+        midnight: "#163449",
+        pink: "#f6d7e2",
+        plum: "#3a0e31",
+        sky: "#cbdff1",
+        seafoam: "#c1e0de",
+        dune: "#e6bf9b",
+        "full-black": "#000000",
+
+        // Extra colors (not part of the original palette)
+        "papaya-whip": "#f9e3d9",
+
+        // UI Red
+        red: {
+          100: "#f8d6d3",
+          200: "#f1ada7",
+          300: "#ea8980",
+          400: "#e36054",
+          500: "#dc3728",
+          600: "#b12c20",
+          700: "#862219",
+          800: "#561610",
+          900: "#2b0b08",
+        },
+
+        // Grayscale
+        gray: {
+          15: "#fafafa",
+          25: "#f5f5f5",
+          50: "#f0f0f0",
+          100: "#dedede",
+          200: "#cfcfcf",
+          300: "#bababa",
+          400: "#a3a3a3",
+          500: "#737373",
+          600: "#616161",
+          700: "#4a4a4a",
+          800: "#333333",
+        },
+      },
+      borderRadius: {
+        sm: "4px",
+      },
+      backgroundImage: {
+        "arrow-right-up-line": "url('solidus_admin/arrow_right_up_line.svg')",
+        "arrow-down-s-fill-gray-700": "url('solidus_admin/arrow_down_s_fill_gray_700.svg')",
+        "arrow-down-s-fill-red-400": "url('solidus_admin/arrow_down_s_fill_red_400.svg')",
+      },
+      boxShadow: {
+        sm: "0px 1px 2px 0px rgba(0, 0, 0, 0.04)",
+        base: "0px 4px 8px 0px rgba(0, 0, 0, 0.08), 0px 2px 4px -1px rgba(0, 0, 0, 0.04)",
+      },
+    },
+  },
+  plugins: [
+    require("@tailwindcss/forms")({ strategy: "class" }),
+    require("@tailwindcss/aspect-ratio"),
+    require("@tailwindcss/typography"),
+    require("@tailwindcss/container-queries"),
+    plugin(({ addVariant, addBase, addComponents, theme }) => {
+      // Support the "hidden" attribute
+      addVariant("hidden", "&([hidden])")
+      addVariant("visible", "&:not([hidden])")
+
+      // Support the "search-cancel" pseudo-element
+      addVariant("search-cancel", "&::-webkit-search-cancel-button")
+
+      // Reset the <summary> marker
+      addBase({
+        "summary::-webkit-details-marker": { display: "none" },
+        "summary::marker": { display: "none" },
+        summary: { listStyle: "none" },
+      })
+
+      // Add a text style for links
+      addComponents({
+        ".body-link": {
+          color: theme("colors.blue"),
+          "&:hover": {
+            textDecoration: "underline",
+          },
+        },
+      })
+    }),
+  ],
+}

data/docs/{customizing_main_navigation.md → customizing_menu_items.md}

@@ -1,6 +1,6 @@
 # Customizing the main navigation
 
-You are allowed to add your custom links to the main navigation. To do so, you can access `SolidusAdmin::Config.main_nav` in an initializer:
+You are allowed to add your custom links to the main navigation. To do so, you can access `SolidusAdmin::Config.menu_items` in an initializer:
 
 ```ruby
 # config/initializers/solidus_admin.rb
@@ -13,7 +13,7 @@ SolidusAdmin::Config.menu_items << {
 ```
 
 - The key you provide will be used to translate the link's label under the
-`solidus_admin.main_nav.#{key}` key.
+`solidus_admin.menu_item.#{key}` key.
 - Icon needs to be an icon name from [Remixicon](https://remixicon.com/).
 - Position tells Solidus where to place the link in the main navigation. The
  default items are placed with 10 points of difference between them.

data/docs/customizing_tailwindcss.md

@@ -0,0 +1,57 @@
+# Customizing TailwindCSS
+
+Solidus Admin uses [Tailwind CSS](https://tailwindcss.com/) for styling. The
+benefit of using Tailwind is that it allows you to customize the look and feel
+of the admin without having to write any CSS. By leveraging utility classes,
+you can easily change the colors, fonts, and spacing in use.
+
+Solidus Admin provides a precompiled CSS file that includes all the necessary
+Tailwind classes for the admin to work out of the box.
+
+In case you need to customize the admin's look and feel, or create custom
+components, you can do so by running Tailwind's build process in your host
+application.
+
+This process presumes that you have a working knowledge of Tailwind CSS. If you
+are not familiar with Tailwind, please refer to the [Tailwind
+documentation](https://tailwindcss.com/docs) for more information.
+
+## Setting up a local TailwindCSS build for Solidus Admin
+
+In order to customize the admin's look and feel, you'll need to set up a local
+Tailwind build. This is a two-step process:
+
+Add Tailwind configuration files to your application:
+
+```shell
+bin/rails solidus_admin:tailwindcss:install
+```
+
+This will create all the necessary files for you to customize TailwindCSS,
+including:
+- A `config/solidus_admin/tailwind.config.js` configuration file
+  that will automatically import the Solidus Admin's default configuration.
+- An `app/assets/stylesheets/solidus_admin/application.tailwind.css` file
+  in which you can add your own customizations.
+- Tasks to build the CSS file once or watch for changes and automatically
+  rebuild the target `app/assets/builds/solidus_admin/application.css` file.
+
+In order to manually build the CSS file, run:
+
+```shell
+bin/rails solidus_admin:tailwindcss:build
+```
+
+Or, to watch for changes and automatically rebuild the CSS file, run:
+
+```shell
+bin/rails solidus_admin:tailwindcss:watch
+```
+
+## Caveats
+
+### Conflict with sassc-rails
+
+Tailwind uses modern CSS features that are not recognized by the sassc-rails extension that was included by default in the Gemfile for Rails 6. In order to avoid any errors like SassC::SyntaxError, you must remove that gem from your Gemfile.
+
+*See https://github.com/rails/tailwindcss-rails#conflict-with-sassc-rails.*

data/docs/customizing_view_components.md

@@ -11,18 +11,12 @@ All the components Solidus Admin uses are located in the [`app/components`](../a
 - They are grouped in sidecar directories, where the main component file and
   all its related files (assets, i18n files, etc.) live together.
 
-For instance, the component for the main navigation is located in
-[`app/components/solidus_admin/main_nav/component.rb`](../app/components/solidus_admin/main_nav/component.rb).
-
 Solidus Admin components are designed to be easily customizable by the host
 application. Because of that, if you look at how they are designed, you'll find
 a series of patterns are followed consistently:
 
 - Components are always resolved from a global registry in
-  `SolidusAdmin::Config.components` instead of being referenced by their constant. For
-  example, we call `component('main_nav')` instead of referencing
-  `SolidusAdmin::MainNav::Component` directly. As you'll see later, this makes
-  it easy to replace or tweak a component.
+  `SolidusAdmin::Config.components` instead of being referenced by their constant.
 - It's possible to override the registry locally inside a component by redefining
   the `#component` method. This is useful when you need to use a component that
   is not registered in the global registry or need to address some edge case.
@@ -50,37 +44,22 @@ end
 # render component('foo').new
 ```
 
-## Customizing components
-
-Some of the customizations detailed below require you to match Solidus Admin's
-component paths in your application. For instance, if we talk about the
-component in `solidus_admin` gem's
-`app/components/solidus_admin/main_nav/component.rb`, the matching path in your
-application would be
-`app/components/my_application/solidus_admin/main_nav/component.rb`, where
-`my_application` is the underscored name of your application (you can get it by
-running `Rails.application.class.module_parent_name`).
-
 ### Replacing a component's template
 
 In the most typical case, you'll only need to replace the template used by a
 component. You can do that by creating a new component with a maching path in
 your application, inheriting from the default one. Then, you can create a new
-template for it. For example, to replace the main nav template:
+template for it. For example, to replace the menu item template:
 
-```erb
-# app/components/my_application/solidus_admin/main_nav/component.rb %>
-class MyApplication::SolidusAdmin::MainNav::Component < ::SolidusAdmin::MainNav::Component
+```rb
+# app/components/my_admin/navigation/item/component.rb
+class MyAdmin::Navigation::Item::Component < SolidusAdmin::Layout::Navigation::Item::Component
 end
+```
 
-<%# app/components/my_application/solidus_admin/main_nav/component.html.erb %>
-<nav class="my_own_classes">
-  <%=
-    render main_nav_item_component.with_collection(
-      sorted_items
-    )
-  %>
-</nav>
+```erb
+<%# app/components/my_admin/navigation/item/component.html.erb %>
+<li><%= link_to @item.name, path %></li>
 ```
 
 ### Prepending or appending to a component's template
@@ -90,9 +69,9 @@ component. You can easily do that by rendering the Solidus Admin component and
 adding your markup before or after it.
 
 ```erb
-<%# app/components/my_application/solidus_admin/main_nav/component.html.erb %>
+<%# app/components/my_admin/menu_item/component.html.erb %>
 <h1>MY STORE ADMINISTRATION</h1>
-<%= render SolidusAdmin::MainNav::Component.new %>
+<%= render SolidusAdmin::MenuItem::Component.new %>
 ```
 
 ### Replacing a component
@@ -109,12 +88,12 @@ There are two considerations to keep in mind:
   [SolidusAdmin::BaseComponent](../app/components/solidus_admin/base_component.rb).
   You can consider doing the same if you need to use one of its helpers.
 
-For example, the following replaces the main nav component:
+For example, the following replaces the menu item component:
 
 ```ruby
-# app/components/my_application/solidus_admin/main_nav/component.rb
-class MyApplication::SolidusAdmin::MainNav::Component < SolidusAdmin::BaseComponent
-  # do your thing
+# app/components/my_admin/menu_item/component.rb
+class MyAdmin::MenuItem::Component < SolidusAdmin::BaseComponent
+  # Here goes your code
 end
 ```
 
@@ -138,8 +117,8 @@ matching path from within your application (or manually add it to the
 registry) and override the methods you need to change:
 
 ```ruby
-# app/components/my_application/solidus_admin/main_nav/component.rb
-class MyApplication::SolidusAdmin::MainNav::Component < ::SolidusAdmin::MainNav::Component
+# app/components/my_admin/menu_item/component.rb
+class MyAdmin::MenuItem::Component < SolidusAdmin::MenuItem::Component
   def sorted_items
     super.reverse
   end

data/lib/generators/solidus_admin/install/install_generator.rb

@@ -4,12 +4,13 @@ module SolidusAdmin
   module Generators
     class InstallGenerator < Rails::Generators::Base
       class_option :lookbook, type: :boolean, default: !!ENV['SOLIDUS_ADMIN_LOOKBOOK'], desc: 'Install Lookbook for component previews'
+      class_option :tailwind, type: :boolean, default: false, desc: 'Install TailwindCSS for custom components'
 
       source_root "#{__dir__}/templates"
 
       def install_solidus_core_support
         route <<~RUBY
-          mount SolidusAdmin::Engine, at: '/admin', constraints: ->(req) {
+          mount SolidusAdmin::Engine, at: '#{solidus_mount_point}admin', constraints: ->(req) {
             req.cookies['solidus_admin'] != 'false' &&
             req.params['solidus_admin'] != 'false'
           }
@@ -17,7 +18,7 @@ module SolidusAdmin
       end
 
       def copy_initializer
-        copy_file "config/initializers/solidus_admin.rb"
+        template 'config/initializers/solidus_admin.rb.tt', 'config/initializers/solidus_admin.rb'
       end
 
       def ignore_tailwind_build_files
@@ -25,7 +26,7 @@ module SolidusAdmin
       end
 
       def build_tailwind
-        rake "solidus_admin:tailwindcss:build"
+        rake "solidus_admin:tailwindcss:install" if options[:tailwind]
       end
 
       def install_lookbook
@@ -37,7 +38,15 @@ module SolidusAdmin
           gem "actioncable"
         end
 
-        route "mount Lookbook::Engine, at: '/lookbook' if Rails.env.development?"
+        route "mount Lookbook::Engine, at: '#{solidus_mount_point}lookbook' if Rails.env.development?"
+      end
+
+      private
+
+      def solidus_mount_point
+        mount_point = Spree::Core::Engine.routes.find_script_name({})
+        mount_point += "/" unless mount_point.end_with?("/")
+        mount_point
       end
     end
   end

data/lib/generators/solidus_admin/install/templates/config/initializers/{solidus_admin.rb → solidus_admin.rb.tt}

@@ -6,28 +6,24 @@ SolidusAdmin::Config.configure do |config|
   # It needs to be a path to an image file accessible by Sprockets.
   # config.logo_path = "my_own_logo.svg"
 
-  # Add custom paths for TailwindCSS to scan for styles. By default, it already
-  # includes the following paths:
-  # - public/solidus_admin/*.html
-  # - app/helpers/solidus_admin/**/*.rb
-  # - app/assets/javascripts/solidus_admin/**/*.js
-  # - app/views/solidus_admin/**/*.{erb,haml,html,slim}
-  # - app/components/solidus_admin/**/*.{rb,erb,haml,html,slim,js}
-  #
-  # config.tailwind_content << Rails.root.join("app/my/custom/path/**.rb")
-
-  # Append custom stylesheets to be compiled by TailwindCSS.
-  # config.tailwind_stylesheets << Rails.root.join("app/my/custom/path/style.css")
-
   # Add custom folder paths to watch for changes to trigger a cache sweep forcing a
   # regeneration of the importmap.
   # config.importmap_cache_sweepers << Rails.root.join("app/javascript/my_admin_components")
 
+  # If you want to avoid defining menu_item customizations twice while migrating to SolidusAdmin
+  # you can import menu_items from the backend by uncommenting the following line,
+  # but you will need to
+  <%- if defined? Spree::Backend -%>
+  config.import_menu_items_from_backend!
+  <%- else -%>
+  # config.import_menu_items_from_backend!
+  <%- end -%>
+
   # Add custom paths to importmap files to be loaded.
   # config.importmap_paths << Rails.root.join("config/solidus_admin_importmap.rb")
   #
   # Configure the main navigation.
-  # See SolidusAdmin::MainNavItem for more details.
+  # See SolidusAdmin::MenuItem for more details.
   # config.menu_items << {
   #   key: :my_custom_link,
   #   route: :my_custom_link_path,

data/lib/solidus_admin/admin_resources.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module SolidusAdmin::AdminResources
+  def admin_resources(resource, **options)
+    batch_actions = %i[destroy]
+    batch_actions &= options[:only] if options[:only]
+    batch_actions -= options[:except] if options[:except]
+
+    resources(resource, options) do
+      yield if block_given?
+
+      collection do
+        delete :destroy if batch_actions.include?(:destroy)
+      end
+
+      member do
+        patch :move if options[:sortable]
+      end
+
+      yield if block_given?
+    end
+  end
+end