jekyll-spree-client 0.1.7 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7a67bab159ca15a9bdb21c85f14da4c5f401d91c04a9da7c8317d4e5bb4a15d
-  data.tar.gz: 74eff3966ee98fd1baae257b5dfb243064ffe509c834173a3ffce34664f514fe
+  metadata.gz: 29f4a2f251e21575d7f5b4ef34af064f8fb80a7a2e494267d19336f201288c3d
+  data.tar.gz: 77521c26bb015d395fa515adf4270385c28de024a57725d08123c8c7d0daebd5
 SHA512:
-  metadata.gz: 658045e9a4e79977df68d0945520c6a2d150a52e1574ae86c3dc71fcd842f45967672b202c784f2aa12826ce3bd512f8b04b505bfd1d402cc798e968e3b0a37d
-  data.tar.gz: 7120d85321bff77a6ec69e39abd52801436de8daca45b9b9be19b64824c50c5912d8d2988ba81436dd94a6d8575f1ed6675de34310cec72ed1b89bdb442d5230
+  metadata.gz: 71480aa397d2fe3e0191833bc55194d6d287ac1825c5ebe01ecbb341a13d1de79f16d1686a2b6a4ebd879cc882584d9bab940ded155208988386110104d00a8b
+  data.tar.gz: f917c8e9cf3675801c8240ab88bc05f19368fd1597065ec7d789f4ec82ed5acab22733e5dc65ba7dfc63cc703ed197de4c09d1207f9e79f0d1663253a647b2dc

data/README.md

@@ -16,16 +16,6 @@ conversion unless you store prices as strings.
 
 You can use Integer and Floats now!
 
-### Update
-
-The issue is that Spree expects to receive prices in the locale format
-(ie, "200,00") but will return them on Ruby's `to_s` conversion
-("200.0") so we need to reconvert them to our current format and juggle
-between them.
-
-We'll deal with `Integer` for now until we find [a better
-solution](https://github.com/spree/spree/issues/10556).
-
 ## Installation
 
 Add this line to your site's Gemfile:
@@ -77,8 +67,10 @@ Add the required fields in their frontmatter:
 ---
 layout: post
 title: A product
+description: With a description
 sku: A unique ID
 price: 100.00
+cost_price: 50.0
 stock: 100
 weight: 100
 height: 100
@@ -90,18 +82,64 @@ depth: 100
 The layout doesn't matter, but we recommend to use a layout for
 products.
 
+### Layouts
+
+You'll need four layouts and at least a corresponding post, one for each
+step of the buying process.
+
+* `cart` the cart, shows the order details
+* `shipment` shipping and billing addresses, shipping rates apply here
+* `payment` select payment methods
+* `confirmation` order confirmation page
+
+They'll be available on Liquid under the `site.STEP` keys.
+
+### Hooks
+
+If you need to do some data manipulation before and after
+synchronization is done, you can use hooks.  In a `_plugins/spree.rb`
+file:
+
+```ruby
+Jekyll::Hooks.register :spree, :pre_render do |spree|
+  spree.local_products.each do |product|
+    product.data['_description'] = product.data['description']
+    product.data['description'] = product.data['productore']&.data&.dig('title')
+  end
+end
+
+Jekyll::Hooks.register :spree, :post_render do |spree|
+  spree.local_products.each do |product|
+    product.data['description'] = product.data.delete '_description'
+
+    product.data.delete 'description' unless product.data['description']
+  end
+end
+```
+
+This plugin gets the description value from another document (they're
+linked using
+[jekyll-linked-posts](https://0xacab.org/sutty/jekyll/jekyll-linked-posts/),
+it's a real example!), and then recovers it.
+
+* `pre_render` runs just before starting synchronization
+* `post_render` run after synchronization and before writing changes
+
 ### Building the site
 
 During site build, the plugin will communicate with the Spree API and
-create products when they don't exist or update their price, current
-stock and the other values.
+create products when they don't exist or locally update their price,
+current stock and the other values.
 
 Some fields will appear on the frontmatter:
 
 ```yaml
 variant_id: 1
 in_stock: true
-sync_error: 2020-10-10 00:00:00 UTC
+errors:
+  time: 2020-10-10 00:00:00 UTC
+  messages:
+  - Something went wrong
 ```
 
 * `variant_id` is the ID in the Spree database.
@@ -109,11 +147,27 @@ sync_error: 2020-10-10 00:00:00 UTC
 * `in_stock` is true or false according to availability (Spree decides
   this).
 
-* `sync_error` if the synchronization fails there will be a timestamp
-  here.
+* `errors` if the synchronization fails there will be a timestamp and
+  some messages here.
 
 ## Notes
 
+* Synchronization follows this rules.
+
+  If the product doesn't exist on Spree, it's created.
+
+  If it does, the Jekyll document is updated with price, weight,
+  dimensions and stock.
+
+  It means once the product is created on Spree, Spree manages this
+  variables.
+
+  But Product properties like description and metadata are updated from
+  Jekyll to Spree.
+
+  We want this to change in the near future but we need to think a way
+  to prevent conflicts.
+
 * All products are created as "master variants" on Spree.  There will be
   no pictures, taxonomies or other values, only basic product
   information.
@@ -126,11 +180,12 @@ sync_error: 2020-10-10 00:00:00 UTC
 * Stock is added to the default stock location, meaning the first active
   one.  The API doesn't show or allows to query the actual default.
 
-* The `price` is in the default currency.
+* `price` and `cost_price` are expressed in Spree's default currency.
 
 * If you install the `jekyll-write-and-commit-changes` plugin it will
-  save the data back to disk when you build with `JEKYLL_ENV=production`
-  environment variable.
+  save the data back to disk when you build.  Using the
+  `JEKYLL_ENV=production` environment variable will also commit changes
+  to git.
 
 * Check the shipping category ID on Spree, since there's no API for it,
   you need to provide it manually, default is `1`.

data/lib/jekyll-spree-client.rb

@@ -6,7 +6,20 @@ require_relative 'jekyll/spree_client'
 # matter.  The SKU needs to be unique, but this plugin doesn't ensure
 # that.  Duplicated SKUs will be silently ignored for now.
 Jekyll::Hooks.register :site, :post_read do |site|
-  next unless ENV['SPREE_API_KEY']
+  # Ordered articles
+  posts = site.site_payload['site']['posts']
+
+  # Make steps available to other articles
+  %w[cart shipment payment confirmation].each do |step|
+    site.config[step] = posts.find do |doc|
+      doc.data['layout'] == step
+    end
+  end
+
+  unless ENV['SPREE_API_KEY']
+    Jekyll.logger.warn "SPREE_API_KEY environment variable missing, skipping syncrhonization"
+    next
+  end
 
   config = site.config['spree']&.transform_keys(&:to_sym) || {}
   config.merge!(site: site, api_key: ENV['SPREE_API_KEY'], spree_url: ENV['SPREE_URL'])

data/lib/jekyll/spree_client.rb

@@ -33,7 +33,21 @@ module Jekyll
     #
     # @return [Array]
     def variant_fields
-      @variant_fields ||= %w[price weight height width depth].freeze
+      @variant_fields ||= %w[price weight height width depth cost_price].freeze
+    end
+
+    # Fields that can change locally and we need to sync to Spree
+    #
+    # @return [Array]
+    def product_fields
+      @product_fields ||= %w[name description meta_description meta_keywords meta_title].freeze
+    end
+
+    # All fields, using during creation
+    #
+    # @return [Array]
+    def create_fields
+      @create_fields ||= product_fields + variant_fields
     end
 
     # Spree Client
@@ -56,6 +70,8 @@ module Jekyll
     end
 
     def sync!
+      Jekyll::Hooks.trigger :spree, :pre_render, self
+
       # The API allows to query several SKUs at the same time, so we send
       # groups of 10 products.
       local_products.each_slice(10) do |products|
@@ -68,13 +84,18 @@ module Jekyll
           products.each do |p|
             mark_with_error p,
               i18n.dig('spree', 'errors', 'api') || "Couldn't obtain variants, the store may be down or API key is incorrect"
-            local_save p.save
           end
 
           next
         end
 
         products.each do |product|
+          # Products have names, not titles, so we save them for later
+          product.data['_name'] = product.data['name'] if product.data.key? 'name'
+          product.data['name'] = product.data['title']
+
+          # Remove previous errors
+          product.data.delete 'errors'
           # Find the corresponding Spree variant in the response
           variant = response['variants'].find do |v|
             v[sku_field] == product.data[sku_field]
@@ -86,8 +107,16 @@ module Jekyll
           else
             create product
           end
+
+          product.data['name'] = product.data.delete('_name') if product.data.key? '_name'
         end
       end
+
+      Jekyll::Hooks.trigger :spree, :post_render, self
+
+      local_products.each do |product|
+        local_save product
+      end
     end
 
     private
@@ -150,6 +179,22 @@ module Jekyll
     # @param [Hash]
     # @return [true,false]
     def update(product, variant)
+      # Sync local changes to Spree
+      remote_product = product.data.slice(*product_fields).transform_keys(&:to_sym)
+      # Only when they haven't changed, so we don't waste time sending a
+      # request.
+      unless remote_product == variant.slice(*product_fields).transform_keys(&:to_sym)
+        # XXX: We don't have the product ID with the variant but we have
+        # the slug.
+        remote_product[:id] = variant['slug']
+        remote_product[:sku] = product.data[sku_field]
+
+        unless remote_products.update **remote_product
+          Jekyll.logger.error "Couldn't update #{product.data['title']}"
+          mark_with_error product, error_messages
+        end
+      end
+
       # XXX: The API replies with stringified numbers so we convert them
       # back to the type we're using locally.
       variant.slice(*variant_fields).each do |k, v|
@@ -162,9 +207,8 @@ module Jekyll
 
       product.data['in_stock'] = variant['in_stock']
       product.data['variant_id'] = variant['id']
-      product.data.delete 'errors'
 
-      local_save product
+      product
     end
 
     # If the product doesn't exist, create it.
@@ -172,23 +216,18 @@ module Jekyll
     # @param [Jekyll::Document]
     # @return [true,false]
     def create(product)
-      new_product = product.data.slice(*variant_fields).transform_keys(&:to_sym)
+      new_product = product.data.slice(*create_fields).transform_keys(&:to_sym)
       new_product[:sku] = product.data[sku_field]
-      new_product[:name] = product.data['title']
 
       unless remote_products.create **new_product
         Jekyll.logger.error "Couldn't create #{product.data['title']}"
         mark_with_error product, error_messages
-        local_save product
 
         return false
       end
 
       product.data['variant_id'] = remote_products.response.dig('master', 'id')
 
-      # Save the variant ID
-      local_save product
-
       # Add the initial stock
       spree.stock_items(id: product.data['variant_id'], stock_location_id: stock_location['id'])
            .stock_movements.create(quantity: product.data['stock'])
@@ -202,7 +241,7 @@ module Jekyll
         errors.map do |error|
           field + ' ' + error
         end
-      end.flatten
+      end&.flatten
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-spree-client
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.12
 platform: ruby
 authors:
 - f
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-12-01 00:00:00.000000000 Z
+date: 2021-04-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: spree-api-client