Yes. Extend \\SidcraftCommerce\\Payments\\Gateway<\/code> and register it with the sidcraft_commerce_gateways<\/code> filter. See the \"Developers: custom payment gateways\" section above and docs\/example-gateway.php<\/code>.<\/p><\/dd>\nHow do I add a product with Sidcraft Page Builder?<\/h3><\/dt>\nClick Store \u2192 Add New Product. The product opens in Sidcraft Page Builder with the Product data panel open: enter the price (and stock, SKU, image and so on), design the page with any Units, then click Publish. Add the Add to Cart and Product Price Units where you want them; if your layout has no Add to Cart Unit, the standard buy box is added above it. To use the WordPress editor instead, turn off \"Design products with Sidcraft Page Builder\" under Store \u2192 Settings.<\/p><\/dd>\n
How do item options work?<\/h3><\/dt>\nOn a product, under Product data \u2192 Item options (or in the Product data panel in Sidcraft Page Builder), type one group per line, for example Size*: Small | Medium +2 | Large +4<\/code> or Extras [checkbox]: Cheese +1 | Bacon +2<\/code>. *<\/code> makes a group required; [radio]<\/code>, [checkbox]<\/code> and [text]<\/code> change how it is shown; +2<\/code> adds 2 to the price. Customers choose on the product page, and product grids show \"Choose options\".<\/p><\/dd>\nCan developers build add-ons, for example for a restaurant?<\/h3><\/dt>\nYes. See the \"Developers: add-ons\" section above, docs\/ADDONS.md<\/code> and the restaurant example in docs\/example-addon.php<\/code>.<\/p><\/dd>\nCan I change how the store looks?<\/h3><\/dt>\nYes. Style the Commerce Units in Sidcraft Page Builder, or copy any template from the plugin's templates\/<\/code> folder into yourtheme\/sidcraft-commerce\/<\/code> and edit it there.<\/p><\/dd>\nDoes it work with page caching?<\/h3><\/dt>\nYes. Shop and product pages stay cacheable, the cart badge fills in after the page loads, and Cart and Checkout pages are marked no-cache automatically.<\/p><\/dd>\n
What if two people buy the last item?<\/h3><\/dt>\nThe order reserves stock as it is created, and the reservation only succeeds while the stored quantity is still at least the amount being bought. The other buyer is told there is not enough stock. A pending order that is still unpaid after 24 hours is cancelled and the units go back. Cancelled and Refunded do the same for the units that order still holds.<\/p><\/dd>\n
How do refunds and chargebacks work?<\/h3><\/dt>\nStripe charge.refunded<\/code> and PayPal PAYMENT.CAPTURE.REFUNDED<\/code> record the amount once. If that amount covers the order, the order is marked Refunded and the remaining stock, coupon use and gift-card balance are returned. A smaller amount stays a partial refund and returns stock only for quantities named on the order screen (Refund box) or in the provider payload. Stripe charge.dispute.created<\/code> \/ charge.dispute.closed<\/code> and PayPal customer-dispute events set the order to Disputed. Stock stays reserved. A dispute the buyer wins marks the order Refunded. A dispute the store wins returns the order to its previous status.<\/p><\/dd>\nCan a guest attach the order to an account?<\/h3><\/dt>\nYes. Checkout has \u201cCreate an account with this email\u201d. WordPress emails a link to set the password. If that email already has an account, the buyer is asked to log in. Logging in or registering later with the same email attaches guest orders placed on version 1.0.9 or newer.<\/p><\/dd>\n
How do I export products?<\/h3><\/dt>\nOpen Store \u2192 Export catalog and download the JSON file. It contains the product title, description, categories, regular and sale price, SKU, stock and item options. It does not contain the Sidcraft Page Builder layout. Tools \u2192 Export also includes the product post type.<\/p><\/dd>\n
Which currencies use three decimal places?<\/h3><\/dt>\nBHD, JOD, KWD, OMR and TND are sent to payment providers in thousandths and displayed with 3 decimals. Zero-decimal currencies (JPY, KRW, VND and the rest of that set) use no decimals. Other currencies use the decimal setting under Store \u2192 Settings.<\/p><\/dd>\n
What happens to my data if I delete the plugin?<\/h3><\/dt>\nSettings, sessions and temporary data are removed. Products, orders, coupons and gift cards are kept, unless you add define( 'SIDCRAFT_COMMERCE_REMOVE_ALL_DATA', true );<\/code> to wp-config.php before deleting the plugin.<\/p><\/dd>\n\n<\/dl>\n\n\n1.0.9<\/h4>\n\n\n- Stock is reserved when the order is placed. The update only succeeds while enough units remain, so two buyers cannot both take the last item. A pending order unpaid after 24 hours is cancelled and its stock is returned.<\/li>\n
- Partial refunds. The order screen records an amount and the quantities to put back. A Stripe or PayPal refund that covers the order total marks it Refunded. A smaller amount does not return stock unless quantities are named. Each provider event is applied once.<\/li>\n
- Disputed status. Stripe
charge.dispute.created<\/code> and charge.dispute.closed<\/code>, and PayPal customer-dispute events, keep stock reserved while a dispute is open. A lost dispute refunds the order. A won dispute restores the previous status.<\/li>\n- Guest checkout can create an account. Logging in or registering with the same email attaches guest orders placed on 1.0.9 or newer.<\/li>\n
- Three-decimal currencies (BHD, JOD, KWD, OMR, TND) are charged in thousandths. Zero-decimal currencies stay on a factor of 1.<\/li>\n
- Store \u2192 Export catalog writes products, categories, price, SKU, stock and item options to JSON, without the page-builder layout.<\/li>\n
- Templates updated (1.0.9): units\/checkout.php.<\/li>\n<\/ul>\n\n
0.9.2<\/h4>\n\n\n- Plugin Check: output escaping on the order screen's item list and in the Add to Cart template.<\/li>\n<\/ul>\n\n
0.9.1<\/h4>\n\n\n- Developers: new
sidcraft_commerce_editor_styles<\/code> filter so add-on Units are styled in the Sidcraft Page Builder canvas, and add-on Units can use any glyph or emoji as their builder icon.<\/li>\n<\/ul>\n\n0.9.0<\/h4>\n\n\n- Item options. Type option groups on a product (Product data \u2192 Item options, or the builder's Product data panel): dropdowns, buttons, multiple choices and text boxes, each choice optionally adding to the price, and any group can be required. Customers choose on the product page with a running price; each combination is its own cart line; stock is checked across all lines of a product; prices are recalculated on every request. Choices show in the cart, checkout, order-received page, emails, the order screen and PayPal.<\/li>\n
- Add-on support:
sidcraft_commerce_product_options<\/code> filter, Cart::add_with_options()<\/code> and an options<\/code> parameter on the cart\/add REST route.<\/li>\n- Order statuses can be registered by add-ons with
Post_Types::register_order_status()<\/code>: label, position, colour, whether it counts as paid, and an optional customer email. Stock, sales, gift cards and reviews now follow each status's \"paid\" setting instead of a fixed list. New sidcraft_commerce_order_status_definitions<\/code> filter; the older sidcraft_commerce_order_statuses<\/code> filter still works.<\/li>\n- Checkout fields added by add-ons can be dropdowns (
select<\/code> with choices) or text areas, and their values now show on the order-received page and in emails as well as the admin.<\/li>\n- New developer guide (docs\/ADDONS.md) and a complete restaurant add-on example (docs\/example-addon.php).<\/li>\n
- Templates updated (0.9.0): units\/add-to-cart.php, units\/cart-panel.php, units\/checkout.php, units\/checkout-summary.php, units\/order-confirmation.php, emails\/order.php. New: units\/item-options.php.<\/li>\n<\/ul>\n\n
0.8.0<\/h4>\n\n\n- Products are designed in Sidcraft Page Builder. Add New Product (menu, Products list and admin bar) opens a new product in the builder, and products get \"Edit with Sidcraft Page Builder\" on the product screen, in the Products list and in the admin bar.<\/li>\n
- New Product data panel inside the builder: regular and sale price, SKU, stock tracking and quantity or stock status, image badge, featured, categories, product image, short description and \"hide the automatic buy box\". It opens by itself on a new product without a price, and the builder's Save also saves it.<\/li>\n
- The automatic buy box is skipped when the product layout already has an Add to Cart Unit, and it now sits above a Sidcraft layout instead of being replaced by it.<\/li>\n
- New setting: Store \u2192 Settings \u2192 \"Design products with Sidcraft Page Builder\" (on by default). Turn it off to add and edit products in the WordPress editor.<\/li>\n<\/ul>\n\n
0.7.4<\/h4>\n\n\n- Plugin Check: order-screen shipment fields are sanitized field by field when read, and the shipment save no longer writes to $_POST.<\/li>\n
- Fix: adding a shipment with \"Mark the order Completed\" no longer gets undone by the order status dropdown on the same save.<\/li>\n
- Admin: gift card screen uses a stylesheet class instead of an inline style.<\/li>\n<\/ul>\n\n
0.7.3<\/h4>\n\n\n- Gift cards. Tick \"This product is a gift card\" on a product and set preset amounts and\/or allow a custom amount (with a minimum and maximum). Buyers choose the amount, recipient, message and an optional send date; each card is emailed to the recipient once the order is paid, or on the chosen date.<\/li>\n
- Store \u2192 Gift cards: issue cards by hand (store credit, prizes), see balances, recipients and history, change a balance, resend the email, disable a card.<\/li>\n
- Redeeming: a gift card field in the cart and at checkout. Several cards per order; a card pays up to its balance and keeps the rest. When cards cover the whole order, no payment method is needed. Amounts are taken when the order is placed and returned if it is cancelled or refunded; cards bought in a cancelled or refunded order are disabled.<\/li>\n
- Gift cards are not charged tax or shipping and coupons don't apply to them. Optional expiry for new cards (Store \u2192 Settings \u2192 Payments \u2192 Gift cards; default never).<\/li>\n
- Orders with nothing left to pay (gift cards or a 100% coupon) no longer ask for a payment method.<\/li>\n
- Codes are protected against guessing (10 failed attempts per hour per visitor).<\/li>\n
- Templates updated (0.7.3): units\/add-to-cart.php, units\/cart-panel.php, units\/checkout.php, units\/checkout-summary.php. New: units\/gift-card-form.php, units\/gift-card-redeem.php, emails\/gift-card.php.<\/li>\n<\/ul>\n\n
0.7.2<\/h4>\n\n\n- Shipment tracking: a \"Shipment tracking\" box on each order adds the carrier, tracking number and date. The customer gets a \"Your order has shipped\" email with a Track your package button, and the tracking shows on the order-received page. Several shipments per order are supported.<\/li>\n
- Automatic tracking links for Australia Post, Canada Post, City-Link Express, DHL, DPD (UK and Europe), Fastway South Africa, FedEx, OnTrac, Parcelforce, Poczta Polska, InPost, DPD Polska, DHL Parcel Polska, GLS Poland, Royal Mail, SAPO, TNT Express (consignment and reference), UPS and USPS. Custom carriers with any link; Store \u2192 Settings \u2192 Shipping & tax \u2192 \"Your carriers\" saves your own carriers and can replace a built-in link.<\/li>\n
- Adding a shipment can mark the order Completed (one email: the shipped email replaces the \"order complete\" email).<\/li>\n
- Templates updated (0.7.2): emails\/order.php. New: units\/shipments.php.<\/li>\n<\/ul>\n\n
0.7.1<\/h4>\n\n\n- All payment gateways work for everyone; there is no licence check of any kind.<\/li>\n
- Declares its dependency on Sidcraft Page Builder (Requires Plugins header).<\/li>\n<\/ul>\n\n
0.7.0<\/h4>\n\n\n- New payment methods: Stripe (cards, Apple Pay, Google Pay) with Klarna, Afterpay \/ Clearpay and Affirm; Razorpay; PayU India; Mercado Pago.<\/li>\n
- PayPal: on-page buttons with Pay in 4 (Pay Later), Venmo and cards, plus a Pay in 4 message (the redirect flow remains as an option).<\/li>\n
- Developer framework: the Gateway base class now provides settings fields, return and webhook routes (\/gateway\/{id}\/return and \/webhook), HTTP helpers and a POST-form checkout flow. Example in docs\/example-gateway.php.<\/li>\n
- Store \u2192 Settings is split into tabs: General, Shipping & tax, Payments, Emails.<\/li>\n<\/ul>\n\n
0.6.2<\/h4>\n\n\n- Plugin Check: coupon lookup no longer sets suppress_filters; tested up to WordPress 7.1.<\/li>\n<\/ul>\n\n
0.6.1<\/h4>\n\n\n- WordPress.org review: text domain is now sidcraft-commerce-for-sidcraft-page-builder; every stored name, post type, status, shortcode, script handle and JavaScript global uses the sidccofo prefix; admin CSS\/JS are enqueued files; editor REST routes check per-product permissions.<\/li>\n
- Shortcodes are now [sidccofo_product_grid], [sidccofo_cart], [sidccofo_checkout], [sidccofo_order_confirmation] and so on.<\/li>\n
- wp-config.php constants renamed: SIDCRAFT_COMMERCE_PAYPAL_CLIENT_ID, SIDCRAFT_COMMERCE_PAYPAL_SECRET, SIDCRAFT_COMMERCE_PAYPAL_WEBHOOK_ID.<\/li>\n<\/ul>\n\n
0.6.0<\/h4>\n\n\n- Verified-customer reviews. Clicking a star on a product (Product Rating Unit, buy box or the reviews section) opens a popup with that rating picked; the customer enters their order number, the email used on the order and their review. The order must be paid and contain the product, and each order can review each product once. Reviews appear in the product details with a \"Verified purchase\" badge, the average, a 5-to-1 star breakdown and the review list.<\/li>\n
- New Product Reviews Unit ([sidccofo_product_reviews]); added automatically below the product description (Store \u2192 Settings \u2192 \"Show reviews on product pages\").<\/li>\n
- Store \u2192 Settings \u2192 \"Publish verified reviews immediately\" (on by default); turn off to approve each review under Comments first. The Comments screen shows the stars and a link to the verifying order.<\/li>\n
- The open WordPress comment form is closed on products, so only verified customers can review. Existing reviews are kept and still count toward the average.<\/li>\n
- Protection against guessing: the same message for a wrong order number or email, a limit of 10 failed attempts per hour per visitor, and a hidden spam-trap field.<\/li>\n
- Product Rating Unit: stars are clickable (switch \"Click a star to rate\"), and it now shows \"Be the first to review\" instead of hiding when a product has no reviews.<\/li>\n
- Templates updated (0.6.0): units\/product-rating.php. New: single\/reviews.php, single\/no-comments.php.<\/li>\n<\/ul>\n\n
0.5.0<\/h4>\n\n\n- Coupons (Store \u2192 Coupons): the coupon title is the code; choose a percentage of the (sale-priced) subtotal or a fixed amount off, with optional minimum spend, expiry date and usage limit. Customers apply or remove one coupon in the cart or at checkout. The discount shows as its own line in the cart, checkout, confirmation, emails and admin order, reduces tax and counts toward free shipping, and is sent to PayPal as a discount. Usage is counted when an order is placed on hold \/ processing and given back on cancel \/ refund.<\/li>\n
- Image badges: pick HOT, POPULAR, Sale or Clearance per product (Product data \u2192 Image badge). It shows top-right on the product image in grids, quick view and the product page. Without a chosen badge, products on sale still show \"Sale\".<\/li>\n
- Sold Out: out-of-stock products get a highlighted \"Sold Out\" label over a dimmed image.<\/li>\n
- Sale prices: the sale price now sits above the struck-through regular price. A sale price that isn't lower than the regular price is rejected with a notice. The cart shows the struck-through regular price next to sale-priced lines.<\/li>\n
- Fix: the sidcraft_commerce_order_status_{status} action fired with an empty status.<\/li>\n
- Templates updated (0.5.0): loop\/product-card.php, quick-view.php, units\/cart-panel.php, units\/checkout-summary.php. New: units\/coupon-form.php.<\/li>\n<\/ul>\n\n
0.4.1<\/h4>\n\n\n- Fix: no translations are loaded before init (WordPress 6.7+ \"_load_textdomain_just_in_time was called incorrectly\" notice when Sidcraft Page Builder was missing or inactive).<\/li>\n
- Admin: \"Add New Product\" menu label; order screen shows country, state and payment method names; sale prices in the Products list no longer show screen-reader text.<\/li>\n<\/ul>\n\n
0.4.0<\/h4>\n\n\n- Tax by country and state: prices entered including or excluding tax, a rate table (country, optional state, rate, label), optional tax on shipping. Tax shows as its own line (or \"Includes \u2026 tax\") in the cart, checkout, confirmation, emails and admin, and is sent to the payment provider.<\/li>\n
- Shipping zones: a flat rate per group of countries, a * zone for everywhere else, free shipping over an amount (store-wide or per zone). Countries outside every zone can't check out and aren't offered.<\/li>\n
- Checkout: country and state are lists; shipping and tax update as soon as they change. \"Add $X more for free shipping\" in the cart.<\/li>\n
- Templates updated (0.4.0): cart-panel.php, checkout.php, checkout-summary.php, order-confirmation.php, emails\/order.php.<\/li>\n
- Coding standards: passes WordPress Coding Standards (PHPCS) and Plugin Check.<\/li>\n<\/ul>\n\n
0.3.3<\/h4>\n\n\n- Readme text updates.<\/li>\n<\/ul>\n\n
0.3.2<\/h4>\n\n\n- Internal detection changes.<\/li>\n<\/ul>\n\n
0.3.1<\/h4>\n\n\n- Sidcraft integration wired to Sidcraft Page Builder's real extension API (tested with 0.15.4): Units register on sidcraft_page_builder_units_register, appear in the editor under Commerce, preview live on the editor canvas, and are excluded from Sidcraft's fragment cache.<\/li>\n
- Fixed: Sidcraft Page Builder is detected by SIDCRAFT_PAGE_BUILDER_VERSION plus its own requirements check (0.15.0+ required).<\/li>\n
- Fixed: Sidcraft layouts are read from _sidsyn_document_data (assets now load in on Sidcraft-built pages).<\/li>\n
- Fixed: product URLs could 404 after Sidcraft Page Builder was reactivated or updated; permalinks now repair themselves.<\/li>\n<\/ul>\n\n
0.3.0<\/h4>\n\n\n- Payments: PayPal (Orders v2, verified webhooks).<\/li>\n<\/ul>\n\n
0.2.0<\/h4>\n\n\n- Standalone store engine: no WooCommerce dependency. Products, categories, reviews, cart sessions, checkout, orders, emails, settings.<\/li>\n
- Stripe Checkout gateway with signed webhooks and a return-page fallback. Offline payment gateway.<\/li>\n
- New Units: Cart, Checkout, Order Confirmation. Cart\/Checkout layouts adapt to the space they're given.<\/li>\n<\/ul>\n\n
0.1.0<\/h4>\n\n\n- First build (WooCommerce-based, replaced by 0.2.0).<\/li>\n<\/ul>","raw_excerpt":"Online store for Sidcraft Page Builder: cart, checkout, coupons, reviews; PayPal, Stripe, Apple Pay, Klarna, Razorpay and more.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/381922","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=381922"}],"author":[{"embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ssiddiqi4"}],"wp:attachment":[{"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=381922"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=381922"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=381922"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=381922"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=381922"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/it.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=381922"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}