e_plat 1.0.0 → 1.1.0.pre.rc.1

data/lib/e_plat/resource/concerns/overwrite_request_methods.rb

@@ -18,7 +18,7 @@ module EPlat
 
 						if arguments.second && arguments.second.is_a?(Hash) && arguments.second[:params]
 							arguments.second[:params].merge!(client.try("#{element_name}_default_request_args") || {})
-							arguments.second[:params] = mapping.via_native_attributes_where_possible(arguments.second[:params])
+							arguments.second[:params] = mapping.via_native_attributes_where_possible(arguments.second[:params], search: true)
 						else
 							arguments << {params: (client.try("#{element_name}_default_request_args") || {}) }
 						end
@@ -89,6 +89,7 @@ module EPlat
 				def delete(id, options = {})
 					client = EPlat::Current.e_plat_session
 					cached_shopify_webhook_warning if cached_shopify_webhook?
+					options[:force] = true if client.platform == :woocommerce
 
 					if client.platform_klass(self)
 						client.platform_klass(self).delete(id, options)
@@ -127,6 +128,16 @@ module EPlat
 
 			end
 
+			def initialize(attributes = {}, persisted = false)				
+				EPlat::Base::PROTECTED_ATTRIBUTES.each do |protected_attr_key|
+					if attributes.key?(protected_attr_key)
+						new_key_name = self.class.mapping.protected_attributes_rename_on_initialize[protected_attr_key] || "#{EPlat::PROTECTED_PREFIX}#{protected_attr_key}"
+						attributes[new_key_name] = attributes.delete(protected_attr_key)
+					end
+				end
+
+				super
+			end
 
 			def collection_path(options = {})
 				options = options.merge client.try("#{element_name}_default_request_args") || {}

data/lib/e_plat/resource/countable.rb

@@ -9,6 +9,9 @@ module EPlat
 			data = 
 				if counts_via_graphql?
 					graphql_count
+				elsif counts_via_header?
+					raw_data = connection.get(collection_path, headers)
+					raw_data.headers[:x_wp_total].last.to_i
 				elsif counts_via_meta_data?
 					raw_data  = connection.get(collection_path, headers)
 					data_hash = ActiveSupport::JSON.decode(raw_data.body)
@@ -39,6 +42,10 @@ module EPlat
 				self == EPlat::Product or self == EPlat::Shopify::Product
 			end
 
+			def counts_via_header?
+				client.woocommerce?
+			end
+
 			def counts_via_meta_data?
 				return false unless client.bigcommerce?
 

data/lib/e_plat/resource/order.rb

@@ -107,6 +107,9 @@ module EPlat
 			if client.bigcommerce?
 				self.status_id = 5
 				save
+			elsif client.woocommerce?
+				self.status = "cancelled"
+				save
 			else
 				load_attributes_from_response(post(:cancel, {}, options.to_json))
 			end
@@ -118,6 +121,8 @@ module EPlat
 				cancelled_at.present?
 			when :bigcommerce
 				status_id == 5
+			when :woocommerce
+				status == "cancelled"
 			end
 		end
 

data/lib/e_plat/resource/paginated/link_headers.rb

@@ -11,7 +11,7 @@ module EPlat
 			def initialize(link_header)
 				links = parse_link_header(link_header)
 
-				@previous_link = links.find { |link| link.rel == :previous }
+				@previous_link = links.find { |link| link.rel == :previous || link.rel == :prev }
 				@next_link 	   = links.find { |link| link.rel == :next }
 			end
 

data/lib/e_plat/resource/platform_specific/woocommerce/metafield.rb

@@ -0,0 +1,41 @@
+module EPlat::Woocommerce
+	class Metafield < EPlat::Metafield
+		# In WooCommerce, metafields are stored in the meta_data array
+		# with id, key, and value attributes
+		# WooCommerce metafields are always attached to a resource and don't have their own URLs
+
+		belongs_to :product, foreign_key: :owner_id, class_name: "EPlat::Woocommerce::Product"
+		belongs_to :order, foreign_key: :owner_id, class_name: "EPlat::Woocommerce::Order"
+		belongs_to :variant, foreign_key: :owner_id, class_name: "EPlat::Woocommerce::Product::Variant"
+
+		attr_accessor :product, :order, :variant
+
+		def destroy
+			return unless owner.present?
+			
+			run_callbacks :destroy do
+				owner.meta_data = owner.meta_data.reject { _1.id == id }
+				owner.save
+				self.destroyed = true
+			end
+		end
+
+		def owner
+			product || order || variant
+		end
+
+		def owner=(owner)
+			return if owner.nil?
+			
+			case owner.class.name
+			when "EPlat::Woocommerce::Product"
+				@product = owner
+			when "EPlat::Woocommerce::Order"
+				@order = owner
+			when "EPlat::Woocommerce::Product::Variant"
+				@variant = owner
+			end
+		end
+
+	end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/order/billing_address.rb

@@ -0,0 +1,8 @@
+module EPlat::Woocommerce
+  class Order
+    class BillingAddress < EPlat::Order::BillingAddress
+      self.element_name = "billing"
+      # WooCommerce BillingAddress implementation to be added later
+    end
+  end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/order/line_item.rb

@@ -0,0 +1,2 @@
+
+class EPlat::Woocommerce::Order::LineItem < EPlat::Order::LineItem; end

data/lib/e_plat/resource/platform_specific/woocommerce/order/shipping_address.rb

@@ -0,0 +1,8 @@
+module EPlat::Woocommerce
+  class Order
+    class ShippingAddress < EPlat::Order::ShippingAddress
+      self.element_name = "shipping"
+      # WooCommerce ShippingAddress implementation to be added later
+    end
+  end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/order/shipping_line.rb

@@ -0,0 +1,2 @@
+
+class EPlat::Woocommerce::Order::ShippingLine < EPlat::Order::ShippingLine; end

data/lib/e_plat/resource/platform_specific/woocommerce/order.rb

@@ -0,0 +1,8 @@
+
+module EPlat::Woocommerce
+	class Order < EPlat::Order
+		has_one :shipping, class_name: EPlat::Woocommerce::Order::ShippingAddress
+		has_one :billing, class_name: EPlat::Woocommerce::Order::BillingAddress
+		has_many :meta_data, class_name: "EPlat::Woocommerce::Metafield"
+	end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/product/image.rb

@@ -0,0 +1,8 @@
+module EPlat::Woocommerce
+  class Product
+    class Image < EPlat::Product::Image
+      # WooCommerce images are part of the product
+      # and don't have a separate API endpoint
+    end
+  end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/product/option.rb

@@ -0,0 +1,8 @@
+module EPlat::Woocommerce
+  class Product
+    class Option < EPlat::Product::Option
+      # WooCommerce options are part of the product attributes
+      # and don't have a separate API endpoint
+    end
+  end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/product/variant/option_value.rb

@@ -0,0 +1,10 @@
+module EPlat::Woocommerce
+  class Product
+    class Variant
+      class OptionValue < EPlat::Product::Variant::OptionValue
+        # WooCommerce option values come from the variant's attributes array
+        # Each attribute has { id, name, option } structure
+      end
+    end
+  end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/product/variant.rb

@@ -0,0 +1,53 @@
+module EPlat::Woocommerce
+	class Product
+		class Variant < EPlat::Product::Variant
+			self.collection_name = "variations"
+			has_many :meta_data, class_name: "EPlat::Woocommerce::Metafield"
+			
+			attr_accessor :_is_virtual
+			alias_method :new?, :_is_virtual
+
+			class << self
+				def generate_virtual_variant(attributes)
+					instance = new attributes
+					instance._is_virtual = true
+					instance
+				end
+			end
+
+			def save
+				if _is_virtual
+					EPlat.config.mute_woocommerce_variant_warnings || warn("updating product as this is a non-variant product. this variant is generated for interface purposes only")
+
+					pass_through_attributes = {}
+					product.common_product_variant_attributes.each do |attr|
+						next unless changed_attributes.key? attr
+						pass_through_attributes[attr] = send(attr)
+					end
+
+					pass_through_attributes = mapping.via_native_attributes_where_possible(pass_through_attributes)
+					pass_through_attributes.each do |attr, value|
+						product.send("#{attr}=", value)
+					end
+
+					if product.type == "variable" and product.variants.empty?
+						EPlat.config.mute_woocommerce_variant_warnings || warn("Variable product with no variants found, attributes like price can't be set without variants")
+					end
+
+					product.save
+				else 
+					super
+				end
+			end
+
+			def delete(id, options = {})
+				raise "EPlat: Can not delete _is_virtual variant" if _is_virtual
+				super
+			end
+
+			def exists?(id, options = {})
+				(_is_virtual) ? false : super
+			end
+		end
+	end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/product.rb

@@ -0,0 +1,75 @@
+module EPlat::Woocommerce
+	class Product < EPlat::Product
+		has_many :meta_data, class_name: "EPlat::Woocommerce::Metafield"
+
+		def lazy_load_variants
+			# Woo products natively just return an array of ids under the 'variations' key
+			@variants_collection ||= EPlat::Product::Variant.find(
+				:all, from: "#{ client.url_prefix }products/#{id}/variations"
+			).presence || EPlat::Collection.new([generate_default_variant])
+
+			@variants_collection.each do |variant|
+				variant.product = self
+				variant.product_id = id
+			end
+
+			@variants_collection
+		end
+
+		def dup
+			self.class.new.tap do |resource|
+				resource.attributes     = @attributes
+				resource.attributes.delete("id")
+				resource.prefix_options = @prefix_options
+			end
+		end
+
+
+		def common_product_variant_attributes
+			[
+				"body_html",
+				"name",
+				"description",
+				"permalink",
+				"sku",
+				"price",
+				"regular_price",
+				"sale_price",
+				"date_on_sale_from",
+				"date_on_sale_from_gmt",
+				"date_on_sale_to",
+				"date_on_sale_to_gmt",
+				"on_sale",
+				"status",
+				"purchasable",
+				"virtual",
+				"downloadable",
+				"downloads",
+				"download_limit",
+				"download_expiry",
+				"tax_status",
+				"tax_class",
+				"manage_stock",
+				"stock_quantity",
+				"stock_status",
+				"backorders",
+				"backorders_allowed",
+				"backordered",
+				"weight",
+				"dimensions",
+				"shipping_class",
+				"shipping_class_id",
+				"attributes",
+				"menu_order",
+				"meta_data"
+			]
+		end
+
+		private
+
+		def generate_default_variant
+			EPlat::Woocommerce::Product::Variant.generate_virtual_variant attributes.slice(*common_product_variant_attributes).merge(product_id: id, product: self)
+		end
+
+	end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/script_tag.rb

@@ -0,0 +1,5 @@
+module EPlat::Woocommerce
+  class ScriptTag < EPlat::ScriptTag
+    # WooCommerce ScriptTag implementation to be added later
+  end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/shop.rb

@@ -0,0 +1,36 @@
+module EPlat::Woocommerce
+  class Shop < EPlat::Shop
+    class << self
+      # Custom find_single for WooCommerce, since it uses settings/general endpoint
+      def find_single(scope, options)
+        prefix_options, query_options = split_options(options[:params])
+        path = "#{client.url_prefix}settings/general"
+        
+        # The response is an array, so we need to wrap it in a hash with a top-level key
+        response = connection.get(path, client.headers)
+        response_data = format.decode(response.body)
+        
+        # Process response data to create a hash with expected structure
+        response_hash = {}
+        if response_data.is_a?(Array)
+          response_data.each do |setting|
+            key = setting["id"]
+            response_hash[key] = setting if key
+          end
+        end
+        
+        instantiate_record(response_hash, prefix_options)
+      end
+    end
+
+    def lazy_load_weight_unit
+      return @lazy_load_weight_unit if @lazy_load_weight_unit
+      
+      path = "#{client.url_prefix}settings/products/woocommerce_weight_unit"
+      response = connection.get(path, client.headers)
+      response_data = JSON.parse(response.body)
+      
+      @lazy_load_weight_unit = response_data["value"] || response_data["default"]
+    end
+  end
+end

data/lib/e_plat/resource/platform_specific/woocommerce/webhook.rb

@@ -0,0 +1,8 @@
+module EPlat::Woocommerce
+	class Webhook < EPlat::Webhook
+		def destroy
+			self.status = "disabled"
+			self.save
+		end
+	end
+end

data/lib/e_plat/resource/product/variant.rb

@@ -40,6 +40,8 @@ module EPlat
 			def image_src(images=[]) # EPlat::Product::Image => string
 				if client.bigcommerce?
 					image_url
+				elsif client.woocommerce?
+					image&.src
 				elsif is_a?(EPlat::ShopifyWebhook::Product::Variant)
 					images.to_a.find{ |i| i.id == image_id }.try(:src)
 				elsif is_a?(EPlat::Shopify::Product::Variant)

data/lib/e_plat/utils/money.rb

@@ -0,0 +1,32 @@
+module EPlat
+  module Utils
+    class Money
+      include ActiveModel::Model
+      include ActionView::Helpers::NumberHelper
+      
+      def self.string_to_coinage_int(money_string)
+        decimals_removed = ::ApplicationController.helpers.number_with_precision(money_string, precision: 2)
+        (decimals_removed.to_f*100).to_i
+      end
+      
+      def self.percent_discount_int(original_price, discounted_price)
+        return 0 if original_price.to_f.zero?
+        
+        discount_amount = original_price.to_f - discounted_price.to_f
+        discount_percentage = (discount_amount / original_price.to_f)*100
+        discount_percentage.round
+      end
+      
+      def self.coinage_to_poundage_str(number)
+        ::ApplicationController.helpers.number_with_precision( number.to_f/100, precision: 2).to_s
+      end
+
+      def self.money_string_total(money_string, quantity)
+        coinage = string_to_coinage_int(money_string)
+        coinage_to_poundage_str(coinage*quantity.to_i)
+      end
+      
+    end
+  end
+end
+

data/lib/e_plat/version.rb

@@ -1,3 +1,3 @@
 module EPlat
-  VERSION = "1.0.0"
+  VERSION = "1.1.0-rc.1"
 end

data/lib/e_plat.rb

@@ -24,8 +24,8 @@ module EPlat
     extend Dry::Configurable
     SUPPORTED_SHOPIFY_API_VERSIONS = ['2024_01', '2024_07', '2025_01']
     SUPPORTED_BIGCOMMERCE_API_VERSIONS = ['3']
-
-    SUPPORTED_PLATFORMS = ["shopify", "bigcommerce"]
+    SUPPORTED_WOOCOMMERCE_API_VERSIONS = ['3']
+    SUPPORTED_PLATFORMS = ["shopify", "bigcommerce", "woocommerce"]
     SUPPORTED_RESOURCES = [
         "shop",
         "product",
@@ -41,6 +41,7 @@ module EPlat
         "webhook",
         "metafield"
     ]
+    PROTECTED_PREFIX = "_protected_"
     
     setting(:shopify_api_version, default: ENV['EPLAT_SHOPIFY_API_VERSION'] || "2025_01", constructor: ->(value) do 
         SUPPORTED_SHOPIFY_API_VERSIONS.include?(value.underscore) ? value.underscore : raise(ArgumentError, "Shopify API version #{value} is not supported")
@@ -51,10 +52,15 @@ module EPlat
         SUPPORTED_BIGCOMMERCE_API_VERSIONS.include?(v) ? v : raise(ArgumentError, "Bigcommerce API version #{value} is not supported")
     end)
     
-    setting(:woocommerce_api_version, default: "v3", constructor: ->(value) { value.downcase.gsub("v", "") })
+    setting(:woocommerce_api_version, default: ENV['EPLAT_WOOCOMMERCE_API_VERSION'] || "v3", constructor: ->(value) do 
+        v = value.downcase.gsub("v", "")
+        SUPPORTED_WOOCOMMERCE_API_VERSIONS.include?(v) ? v : raise(ArgumentError, "WooCommerce API version #{value} is not supported")
+    end)
 
     setting(:print_graphql_requests, default:ENV['EPLAT_PRINT_GRAPHQL_REQUESTS'] || false)
 
+    setting(:mute_woocommerce_variant_warnings, default: ENV['EPLAT_MUTE_WOOCOMMERCE_VARIANT_WARNINGS'] || false)
+
     def self.api_display_name
         apis = Struct.new(:shopify, :bigcommerce, :woocommerce)
         apis.new(

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: e_plat
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0.pre.rc.1
 platform: ruby
 authors:
 - oliwoodsuk
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-14 00:00:00.000000000 Z
+date: 2025-05-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -303,6 +303,21 @@ files:
 - lib/e_plat/mapping/virtual_collection/base.rb
 - lib/e_plat/mapping/virtual_collection/bigcommerce/order_line_items.rb
 - lib/e_plat/mapping/virtual_collection/shopify/product/variant/option_value.rb
+- lib/e_plat/mapping/woocommerce/v_3/metafield.rb
+- lib/e_plat/mapping/woocommerce/v_3/order.rb
+- lib/e_plat/mapping/woocommerce/v_3/order/billing_address.rb
+- lib/e_plat/mapping/woocommerce/v_3/order/line_item.rb
+- lib/e_plat/mapping/woocommerce/v_3/order/shipping_address.rb
+- lib/e_plat/mapping/woocommerce/v_3/order/shipping_line.rb
+- lib/e_plat/mapping/woocommerce/v_3/product.rb
+- lib/e_plat/mapping/woocommerce/v_3/product/image.rb
+- lib/e_plat/mapping/woocommerce/v_3/product/option.rb
+- lib/e_plat/mapping/woocommerce/v_3/product/variant.rb
+- lib/e_plat/mapping/woocommerce/v_3/product/variant/option_value.rb
+- lib/e_plat/mapping/woocommerce/v_3/script_tag.rb
+- lib/e_plat/mapping/woocommerce/v_3/shop.rb
+- lib/e_plat/mapping/woocommerce/v_3/webhook.rb
+- lib/e_plat/paginated/woocommerce_pagination.rb
 - lib/e_plat/resource/attribute_interface.rb
 - lib/e_plat/resource/base.rb
 - lib/e_plat/resource/collection.rb
@@ -396,6 +411,20 @@ files:
 - lib/e_plat/resource/platform_specific/shopify_webhook/script_tag.rb
 - lib/e_plat/resource/platform_specific/shopify_webhook/shop.rb
 - lib/e_plat/resource/platform_specific/shopify_webhook/webhook.rb
+- lib/e_plat/resource/platform_specific/woocommerce/metafield.rb
+- lib/e_plat/resource/platform_specific/woocommerce/order.rb
+- lib/e_plat/resource/platform_specific/woocommerce/order/billing_address.rb
+- lib/e_plat/resource/platform_specific/woocommerce/order/line_item.rb
+- lib/e_plat/resource/platform_specific/woocommerce/order/shipping_address.rb
+- lib/e_plat/resource/platform_specific/woocommerce/order/shipping_line.rb
+- lib/e_plat/resource/platform_specific/woocommerce/product.rb
+- lib/e_plat/resource/platform_specific/woocommerce/product/image.rb
+- lib/e_plat/resource/platform_specific/woocommerce/product/option.rb
+- lib/e_plat/resource/platform_specific/woocommerce/product/variant.rb
+- lib/e_plat/resource/platform_specific/woocommerce/product/variant/option_value.rb
+- lib/e_plat/resource/platform_specific/woocommerce/script_tag.rb
+- lib/e_plat/resource/platform_specific/woocommerce/shop.rb
+- lib/e_plat/resource/platform_specific/woocommerce/webhook.rb
 - lib/e_plat/resource/product.rb
 - lib/e_plat/resource/product/image.rb
 - lib/e_plat/resource/product/option.rb
@@ -409,6 +438,7 @@ files:
 - lib/e_plat/session.rb
 - lib/e_plat/type_coercer.rb
 - lib/e_plat/types.rb
+- lib/e_plat/utils/money.rb
 - lib/e_plat/version.rb
 - lib/hash.rb
 - lib/tasks/e_plat_tasks.rake