Isamu Takeda

ITMAROON EC RELATE BLOCKS provides two Gutenberg blocks to integrate a headless Shopify commerce flow into a WordPress site:
<ul>
<li>
<code>itmar/product-block</code>
<ul>
<li>Links a WordPress post type to Shopify products.</li>
<li>When the linked posts are published/updated, the plugin can create/update the corresponding Shopify product data (depending on your configuration and permissions).</li>
<li>Designed for WordPress as the content layer (product pages) while Shopify remains the commerce layer (inventory + checkout).</li>
</ul>
</li>
<li>
<code>itmar/cart-block</code>
<ul>
<li>Provides a cart UI powered by Shopify Storefront API Cart.</li>
<li>Sends shoppers to Shopify Checkout to complete payment.</li>
</ul>
</li>
</ul>
Important concept (recommended operation): 
* Shopify is the source of truth for inventory and checkout. 
* WordPress is the source of truth for marketing/product content. 
* This plugin focuses on a smooth purchase flow from WordPress pages to Shopify Checkout.
<h3>Security / Data Handling (Important)</h3>
<ul>
<li>Admin API Token and Storefront API Token are saved server-side in WordPress options via REST and are NOT embedded into post content or rendered into front-end HTML.</li>
<li>The editor UI no longer persists secret tokens as block attributes. Tokens should never be stored in post_content.</li>
</ul>
<h3>Block Overview</h3>
= itmar/product-block = 
Use this block in the Site Editor (template) to enable Shopify connection and product linkage for a selected post type.
Main settings (Block Inspector → “EC setting”): 
* Select Product Post Type 
* Store Site URL (Shopify domain) 
* Shop ID (for Customer Account API) 
* Channel Name (publication / sales channel display name) 
* Headless Client ID (Customer Account API client_id) 
* Admin API Token (saved server-side; not stored in post content) 
* Storefront API Token (saved server-side; not stored in post content) 
* Optional display controls (fields selector, display count, cart icon media ID, etc.)
<h4>itmar/cart-block</h4>
Use this block to show the cart UI. It uses Shopify Storefront API Cart endpoints to: 
* Create/update cart lines 
* Show totals 
* Provide a Checkout URL for completing purchase in Shopify Checkout
<h3>Shopify Setup (Required)</h3>
You need a Shopify store and API credentials.
1) Admin API Access Token (for product/customer management) 
* Create a Shopify app (Custom app) and generate an Admin API access token. 
* Grant only the minimum required permissions.
2) Storefront API Access Token (for product/cart/checkout flow) 
* Create a Storefront access token in Shopify.
3) Customer Accounts (Headless) (optional but recommended if you enable customer login) 
* Enable the new Customer Accounts / Customer Account API in Shopify. 
* Install Shopify “Headless” (sales channel) and obtain the “Client ID” used for OAuth (Customer Account API). 
* You will also need the “Shop ID”. 
 – Tip: You can derive Shop ID from the issuer value in: 
 https://{your-shop-domain}/.well-known/openid-configuration
<h3>Quick Start (Recommended Workflow)</h3>
1) Configure connection settings 
* Open the Site Editor. 
* Add <code>itmar/product-block</code> to a global template (e.g., Header, or a dedicated template used site-wide). 
* In the block Inspector → “EC setting”, enter: 
 – Shopify domain (Store Site URL) 
 – Channel Name (e.g., “Online Store”) 
 – Headless Client ID / Shop ID (if using customer login) 
 – Admin API Token and Storefront API Token (saved to WordPress options)
2) Choose the linked post type 
* In <code>itmar/product-block</code>, select your product post type (e.g., “product”).
3) Add the cart 
* Add <code>itmar/cart-block</code> to a template/page where you want the cart UI to appear.
4) Publish product posts 
* Create or edit posts in the selected post type. 
* Publish/update them to trigger Shopify-side creation/update (based on your configuration).
<h3>Related Links</h3>
<ul>
<li>ec-relate-blocks: GitHub 
https://github.com/itmaroon/itmaroon-ec-relate-blocks</li>
<li>block-class-package: GitHub 
https://github.com/itmaroon/block-class-package</li>
<li>block-class-package: Packagist 
https://packagist.org/packages/itmar/block-class-package</li>
<li>itmar-block-packages: npm 
https://www.npmjs.com/package/itmar-block-packages</li>
<li>itmar-block-packages: GitHub 
https://github.com/itmaroon/itmar-block-packages</li>
</ul>
<h3>Developer Notes</h3>
<ol>
<li>PHP class management is done using Composer.</li>
<li>Shared functions/components are published as an npm package and reused across plugins.</li>
</ol>
<h3>External Services</h3>
This plugin connects to external services to provide e-commerce functionality.
<h4>Shopify</h4>
Service provider: 
* Shopify
Domains contacted: 
* The Shopify shop domain configured by the site administrator (e.g. *.myshopify.com or a custom Shopify domain) for Admin API / GraphQL Admin API requests. 
* shopify.com for authentication / OAuth token exchange (when customer login is enabled). 
* Shopify-operated domains used for checkout and storefront features (depending on configuration).
APIs used (depending on your configuration/features enabled): 
* Shopify Admin API (product/customer management) 
* Shopify GraphQL Admin API (graphql.json) 
* Shopify Storefront API (product/cart/checkout flow) 
* Shopify Customer Account API / OAuth endpoints (optional customer login)
Data that may be sent to Shopify: 
* Store domain, channel name, and API credentials / access tokens (server-side) 
* Product data required for creating/updating products (title, description, image, sales price, list price, quantity in stock) 
– The title is the title of the post data sent. 
– The description is an excerpt of the post data sent. 
– The image is the featured image, if one is set. Furthermore, if the ACF custom field has a gallery field named “gallery”, images in that field will also be added. 
– The sales price is the price set in the “prces” group set in the ACF custom field if “sales_price” is set as a member. 
– The list price is the price set in the above group if “list_price” is set. 
– The stock quantity is set as the default quantity if “quantity” is set in the ACF custom field. However, this does not reflect your sales history in Shopify, so do not use it outside of the initial setup. 
* Cart line items (variant IDs and quantities) 
* Customer authentication and identity linkage (OAuth code exchange, customer access tokens when enabled) 
* When uploading product images via Admin API: image data (or image URLs) and related metadata for Shopify product images. 
* For authentication / OAuth token exchange (when enabled): OAuth codes and token exchange parameters.
When data is sent: 
* When saving settings (admin only) 
* When rendering product/cart features or performing cart actions 
* When creating/updating Shopify products based on WordPress post changes 
* When performing customer authentication (if enabled) 
* When exchanging OAuth tokens (e.g. https://shopify.com/authentication/{shop_id}/oauth/token) if enabled.
Important: 
* Shopify is responsible for payment processing and checkout. 
* As with any HTTP request, the WordPress server’s IP address and user agent may be included in requests to Shopify.
Terms / Privacy: 
* Shopify Terms of Service: https://www.shopify.com/legal/terms 
* Shopify Privacy Policy: https://www.shopify.com/legal/privacy 
* Shopify API License and Terms of Use: https://www.shopify.com/legal/api-terms
<h4>GitHub (raw.githubusercontent.com) – Shopify Product Taxonomy</h4>
This plugin downloads a taxonomy text file hosted on GitHub (raw.githubusercontent.com) to provide a category list used by the plugin.
Domain contacted: 
* raw.githubusercontent.com
Data that may be sent and when: 
* When the taxonomy list is fetched/updated, the WordPress server requests a file such as: 
 https://raw.githubusercontent.com/Shopify/product-taxonomy/main/dist/ja/categories.txt 
* No user/customer data is intentionally sent for this action, but the WordPress server’s IP address and user agent may be included in the request.
Terms / Privacy: 
* GitHub Terms of Service: https://docs.github.com/site-policy/github-terms/github-terms-of-service 
* GitHub Privacy Statement: https://docs.github.com/site-policy/privacy-policies/github-privacy-statement

ITMAROON EC RELATE BLOCKS

Gutenberg blocks that connect WordPress product pages to Shopify (inventory + checkout) using Shopify APIs.

Cart2Cart

Supported WooCommerce versions: 1.1.x – 5.x
Shopify to WooCommerce Migration plugin by Cart2Cart designed to help e-merchants perform Shopify to WooCommerce switch without impacting the sales or customers. Via the Cart2Cart’s intuitive interface, you only have to provide the credentials of your Shopify & WooCommerce stores (to enable data exchange between them), select the entities you want to move – and the plugin will do the rest.
<h3>Shopify to WooCommerce Migration plugin by Cart2Cart. How It Works</h3>
Setting up the Shopify to WooCommerce migration module requires no special technical expertise and takes only a few clicks: 
– Install the plugin and provide your Shopify & WooCommerce store details. 
– Pick the data you want to export from Shopify to WooCommerce and additional options to refine migration possibilities. 
– Run a Free Demo migration (optional) or start Full Migration.
<h3>Shopify to WooCommerce service by Cart2Cart is free to download and install. Once installed, you will get 2 migration options:</h3>
<ul>
<li>Demo migration (free) — exports a limited number of entities from Shopify to WooCommerce store in less than 30 minutes. Often used for testing purposes.</li>
<li>Full Migration (paid) — performs the entire Shopify database migration to WooCommerce (usually it takes a few hours).</li>
</ul>
<h3>Benefits You Get Migrating With Shopify to WooCommerce Migration Plugin by Cart2Cart:</h3>
<ul>
<li>Avoid Shopify store downtime</li>
</ul>
The store data transfer is performed on the Cart2Cart servers, thus your customers won’t notice the replatforming.
<ul>
<li>Automate the database transfer</li>
</ul>
The Shopify to WooCommerce importer minimizes the human involvement in the process and simplifies the whole transition procedure to 3 easy to complete steps.
<ul>
<li>Save money</li>
</ul>
Switching from Shopify to WooCommerce via the plugin is 5-10 times cheaper than hiring a 3rd party agency or a developer.
<h3>Shopify to WooCommerce Migration plugin by Cart2Cart. Price</h3>
The starting price for the automated moving from Shopify to WooCommerce is $29. The final cost for your replatforming depends on the number of entities and additional options you want to transfer. You can estimate the exact cost for your Shopify to WooCommerce migration via the Cart2Cart Migration Estimator.
<h3>Data you can move from Shopify to WooCommerce:</h3>
<ul>
<li>Products – Name, SKU, Full Description, Status, Manufacturer, Tax Class. Price, Sale Price, URL, Meta Title, Meta Description, Weight, Product Tags, Variants ( SKU, Weight, Attributes, Quantity, Price, Special Price, Additional image), Base Image, Additional Images, Quantity, Manage Stock.</li>
<li>Product Categories – Name, Description, Image, URL, Meta Title, Meta Description.</li>
<li>Manufacturers – Name, Image.</li>
<li>Customers – First Name, Last Name, Email, Billing Address (First Name, Last Name, Company, Address 1, Address 2, Country, State, City, Zip Code), Shipping Address (First Name, Last Name, Company, Address 1, Address 2, Country, State, City, Zip Code.</li>
<li>Orders – ID, Order Date, Order Status, Order Products (Name, SKU), Product Price, Quantity, Discount Price, Shipping Price, Total Price, Order Comments, Billing Address ( First Name, Last Name, Company, Address 1, Address 2, Country, State, City, Zip Code, Telephone ), Shipping Address (First Name, Last Name, Company, Address 1, Address 2, Country, State, City, Zip Code.</li>
<li>Coupons – Name, Coupon Code, Type Discount, Discount Amount.</li>
<li>Reviews – Status, Rate, User Name, User Email, Product, Title.</li>
<li>Blogs – Title, SEO URLs.</li>
<li>Blog Posts – Title, Full Description, Short Description, Tags, Created Time, Modified Time, SEO URL, Blog IDs, Comments, Post Redirects, Images.</li>
<li>CMS Pages – Title, Created Date, URL, Status, Content Heading.</li>
</ul>
<h3>Extra Migration Options to Expand Migration Possibilities:</h3>
<ul>
<li>Migrate Shopify store categories and products SEO URLs to the new WooCommerce store</li>
<li>Create the 301 redirects on the WooCommerce store after migration</li>
<li>Preserve order IDs on WooCommerce store</li>
<li>Move images from Shopify store products descriptions, categories descriptions, and blog posts descriptions to new WooCommerce</li>
</ul>

Cart2Cart: Shopify to WooCommerce Migration

Benefit from a seamless yet comprehensive data transfer from Shopify to WooCommerce. Free Demo and 24/7 support included!

ITMAROON EC RELATE BLOCKS vs Cart2Cart: Shopify to WooCommerce Migration