=== Custom Post Type WooCommerce Integration - Sell Any CPT with WooCommerce ===
Contributors: tinysolution, mehediihasan
Tags: custom post type, woocommerce, sell cpt, checkout, custom fields
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 2.2.10
Requires PHP: 7.4
WC tested up to: 10.9
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Sell any WordPress custom post type with WooCommerce. Add pricing, cart, and checkout to CPT, ACF, or JetEngine posts without duplicate products.

== Description ==

**Custom Post Type WooCommerce Integration** makes any WordPress custom post type (CPT) purchasable through WooCommerce — without recreating each post as a separate WooCommerce product.

If you already store content as custom post types (courses, events, bookings, listings, real estate, cars, books, directories, or digital downloads), you normally cannot sell it directly with WooCommerce. The usual workaround is to duplicate every post as a WooCommerce product and keep the two in sync by hand. This plugin removes that step. It connects your existing CPT to WooCommerce so a single post can be added to the cart, checked out, and paid for using the WooCommerce systems you already trust.

Connect the post type, set a price (or map an existing meta key), and drop a shortcode where you want the price and add-to-cart button to appear. Your custom content becomes sellable, while WooCommerce continues to handle the cart, checkout, orders, payment gateways, coupons, taxes, and emails.

= The problem this plugin solves =

Custom post types hold your content, but WooCommerce only sells WooCommerce products. Bridging the two normally means maintaining duplicate records — one CPT post for display and one product for selling. That duplication causes mismatched prices, broken stock counts, and extra maintenance.

This plugin lets a CPT post *be* the sellable item. There is no second copy to manage, no data migration, and no code required.

= What you can do =

* Sell any custom post type through WooCommerce.
* Use the standard WooCommerce cart and checkout for your CPT content.
* Process CPT purchases as normal WooCommerce orders.
* Accept payment through any WooCommerce payment gateway (Stripe, PayPal, and others).
* Apply WooCommerce coupons, taxes, and order emails to CPT purchases.
* Use WooCommerce shipping where the product type supports it.
* Reuse prices you already store in ACF, JetEngine, Meta Box, or any custom meta key.
* Avoid creating and syncing duplicate WooCommerce products.

= Two ways to use it =

1. **Full shop experience** — make CPT archive pages look like the WooCommerce shop and CPT single pages look like WooCommerce product pages, with product categories and tags.
2. **Checkout and payments only** — keep your custom landing pages exactly as designed and use WooCommerce purely as a secure checkout and payment processor.

Documentation: [Getting started guide](https://www.wptinysolutions.com/docs/woocommerce-integration/install-using-wordpress-dashboard/) | Pro version: [CPT WooCommerce Integration Pro](https://www.wptinysolutions.com/tiny-products/cpt-woo-integration/)

[youtube https://www.youtube.com/watch?v=KvyHjlww1gg]

== Traditional WooCommerce Workflow vs This Plugin ==

**Traditional workflow**

1. Create your content as a custom post type.
2. Manually recreate the same item as a WooCommerce product.
3. Keep price, stock, and details in sync across both copies.
4. Maintain two records forever.

**With this plugin**

1. Create your content as a custom post type.
2. Connect the post type and set (or map) a price.
3. Sell the post directly — WooCommerce handles cart, checkout, and orders.

The difference: no duplicate products, no manual syncing, and one source of truth for each item.

== Why use this plugin ==

* **No duplicate products** — a CPT post becomes the sellable item, so there is nothing to copy or sync.
* **Sell almost anything** — courses, events, bookings, listings, digital files, donations, services, and other custom content.
* **Use existing meta fields** — already storing prices in ACF, JetEngine, Meta Box, or custom meta? Map the meta key and the plugin reads it directly.
* **WooCommerce as checkout only** — keep custom landing pages and use WooCommerce just for secure payments.
* **No coding required** — configure everything from a clean, React-powered admin interface.
* **Theme and builder friendly** — shortcodes work in any theme, template, widget, or page builder.

== Free Features ==

* Integrate unlimited custom post types with WooCommerce.
* Add a regular price meta field to any CPT.
* Add a sale price meta field to any CPT.
* Fallback regular price — map an existing meta key (works well with ACF, JetEngine, and Meta Box values).
* Fallback sale price — reuse a meta key you already have.
* Shortcode for the price: `[cptwooint_price/]`
* Shortcode for the add-to-cart button: `[cptwooint_cart_button/]`
* Shortcode for the short description: `[cptwooint_short_description/]`
* Shortcode for WooCommerce notices: `[cptwooint_wc_all_notices/]`
* Make CPT archive pages look like the WooCommerce shop page.
* Make CPT single pages look like the WooCommerce product page.
* Use WooCommerce product categories with your CPT.
* Use WooCommerce product tags with your CPT.
* Customize the add-to-cart button color, background, and size from settings.

== Pro Features ==

The Pro version includes every free feature plus:

* Quick Edit and Bulk Edit for CPT prices and stock directly from the post list.
* Full product-type support — Simple, Variable, External/Affiliate, and Grouped.
* Display CPT posts on the WooCommerce shop page alongside regular products.
* Sale price scheduling with start and end dates.
* Inventory management — SKU, stock quantity, stock status, low-stock alerts, backorders, sold individually, and purchase limits.
* Shipping data — weight, dimensions, and shipping classes.
* Product gallery images with a Swiper slider (vertical/horizontal thumbnails, RTL, auto-height, and zoom).
* Downloadable products — file delivery, download limits, and expiry dates.
* Customer downloads from the WooCommerce My Account page.
* Upsells and cross-sells for CPTs.
* Product attributes — a full taxonomy-based attribute management interface for CPTs.
* Product reviews and ratings — 1 to 5 stars, verified purchase badge, HPOS-compatible, with rating distribution.
* Structured data / JSON-LD schema — Product, Review, BreadcrumbList, Website, and Order markup for richer search results.
* Additional shortcodes — `[cptwooint_sku]`, `[cptwooint_attributes]`, `[cptwooint_gallery]`, `[cptwooint_gallery_with_variation]`, and `[cptwooint_upsell_products]`.
* WooCommerce Bookings integration (sell bookable CPTs).
* Easy Booking for WooCommerce integration.
* LearnPress review compatibility (sell and review courses).
* Extra Product Options (Themecomplete EPO) support.
* Automatic license updates from the WordPress dashboard.

[Learn more about Pro](https://www.wptinysolutions.com/tiny-products/cpt-woo-integration/)

== Use Cases ==

* **Online courses** — sell LearnPress or custom course post types through WooCommerce.
* **Bookings and appointments** — sell bookable post types (BA Book Everything in free; WooCommerce Bookings and Easy Booking in Pro).
* **Events and tickets** — sell event post types with WooCommerce checkout.
* **Directories and classifieds** — charge for listings built with JetEngine or other CPT tools.
* **Real estate and properties** — sell or accept payment on property listings.
* **Cars and vehicles** — turn vehicle listings into purchasable items.
* **Books and digital downloads** — sell files with download control (Pro).
* **Memberships and services** — sell access or service posts.
* **Donations** — set a fixed amount on a page or post and collect it through WooCommerce checkout.
* **Payments for landing pages** — keep a custom design and use WooCommerce only for the transaction.

== Supported Integrations ==

* **LearnPress** — sell courses through WooCommerce. [Documentation](https://www.wptinysolutions.com/docs/woocommerce-integration/learnpress-compatibility)
* **Advanced Custom Fields (ACF)** — read prices stored in ACF fields by mapping the meta key.
* **JetEngine** — CPT and meta integration, including variation panels.
* **BA Book Everything** — sell bookings and appointments. [Documentation](https://www.wptinysolutions.com/docs/woocommerce-integration/ba-book-everything)
* **Meta Box** — reuse price values stored in Meta Box fields via meta-key mapping.
* **Custom Post Type UI** — register a CPT and connect it right away.
* **Extra Product Options for WooCommerce** (Free and Pro).
* **WooCommerce Bookings** (Pro).
* **Easy Booking for WooCommerce** (Pro).
* Works with **Elementor**, **Visual Composer**, **Gutenberg**, and most page builders.
* Compatible wherever standard WooCommerce hooks are respected.

== Quick Start — Four Steps ==

1. Install and activate **Custom Post Type WooCommerce Integration**.
2. Open **WC Integration** in the WordPress admin sidebar.
3. Select your custom post type under "Select Post Type".
4. Enable the default price meta field — or map your existing meta keys.

Your CPT is now WooCommerce-ready.

= Already storing prices in meta fields? =

If your CPT already stores prices via ACF, JetEngine, Meta Box, or another plugin:

* Select the regular price meta key from the dropdown.
* Optionally select a sale price meta key.
* Save settings — the plugin reads prices straight from your existing data, with no migration.

= Displaying the price and cart button =

Use these shortcodes in pages, posts, single templates, page builders, or widgets:

* `[cptwooint_price/]` — the formatted price.
* `[cptwooint_cart_button/]` — the add-to-cart button.
* `[cptwooint_short_description/]` — the short description.
* `[cptwooint_wc_all_notices/]` — WooCommerce notices (errors, success, warnings).

== Installation ==

**From the WordPress dashboard**

1. Go to **Plugins → Add New**.
2. Search for "Custom Post Type WooCommerce Integration".
3. Click **Install Now**, then **Activate**.
4. Make sure **WooCommerce** is installed and active.
5. Open **WC Integration** from the admin sidebar and select your custom post type.

**Manual upload**

1. Download the plugin ZIP.
2. Go to **Plugins → Add New → Upload Plugin** and choose the file.
3. Click **Install Now**, then **Activate**.
4. Configure the plugin under **WC Integration**.

After activation you are redirected to the settings page, where you can configure post types, meta keys, shortcodes, and button styles.

== Frequently Asked Questions ==

= How can I sell a custom post type in WordPress? =

Install this plugin alongside WooCommerce, open **WC Integration**, select your custom post type, and set a price (or map an existing price meta key). Add the `[cptwooint_cart_button/]` shortcode where you want the buy button. The post can then be added to the WooCommerce cart and purchased through normal checkout.

= Can WooCommerce sell custom post types? =

WooCommerce sells WooCommerce products by default. This plugin bridges the gap so any custom post type can use the WooCommerce cart, checkout, orders, and payment gateways without being converted into a separate product.

= How do I make a CPT purchasable without creating a duplicate product? =

Connect the post type in the plugin settings and assign it a price. The CPT post itself becomes the sellable item, so there is no second WooCommerce product to create or keep in sync.

= Do I need coding skills to use this plugin? =

No. Everything is configured through a React-powered admin interface. Select the post type, enable the price field, and add a shortcode. There is no PHP or theme editing required.

= Can I sell multiple custom post types at once? =

Yes. You can integrate unlimited custom post types. Each one can have its own regular and sale price settings and its own mapped meta keys.

= Does this plugin work with Advanced Custom Fields (ACF)? =

Yes. If you store prices in ACF fields, select the ACF meta key as the fallback regular price (and optionally sale price) in the settings. The plugin reads prices directly from ACF with no data migration.

= Can I sell JetEngine or Meta Box posts? =

Yes. JetEngine has a built-in integration for its CPTs and variation panels. For Meta Box and other tools, map the meta key that stores your price and the plugin reads it directly.

= Is it compatible with LearnPress and BA Book Everything? =

Yes. The plugin ships with built-in integrations for LearnPress (sell courses) and BA Book Everything (sell bookings). It also works alongside Custom Post Type UI and most major CPT plugins.

= Can I use WooCommerce only for payments without showing a shop? =

Yes. You can keep your custom landing pages as designed and use WooCommerce purely as a checkout and payment processor. Connect the CPT or page, and customers pay through any WooCommerce-supported gateway such as Stripe or PayPal.

= Can I accept donations with this plugin? =

Yes. Set a fixed price on a page or post and add the cart button shortcode. Visitors can pay that amount through WooCommerce checkout, without a separate donation plugin.

= Will my CPT archive look like the WooCommerce shop page? =

Yes. Enable the "Archive Page Like Shop Page" option and your CPT archive inherits the WooCommerce shop layout. A matching option makes CPT single pages look like WooCommerce product pages.

= Does it work for events, courses, real estate, cars, and directories? =

Yes. Any custom post type can be made purchasable, so it fits events, courses, listings, real estate, vehicles, books, directories, and similar content. You choose which post types to connect.

= Which shortcodes are included in the free version? =

Four: `[cptwooint_price/]`, `[cptwooint_cart_button/]`, `[cptwooint_short_description/]`, and `[cptwooint_wc_all_notices/]`. They can be placed in pages, posts, templates, widgets, or any page builder.

= Where are the plugin settings after activation? =

A **WC Integration** menu item appears in the WordPress admin sidebar. Open it to configure post types, meta keys, shortcodes, and button styles. You are also redirected there automatically after activation.

= Does it require WooCommerce? =

Yes. WooCommerce must be installed and active, since the plugin uses the WooCommerce cart, checkout, orders, and payment systems.

== Screenshots ==

1. Integration settings — select your CPT and configure the price meta.
2. Price meta field — enable default fields or map existing meta keys.
3. Shortcode generator — copy-ready shortcodes for price and cart.
4. Button style customizer — adjust color, background, and size.

== Changelog ==

= 2.2.10 (Aug 10, 2026) =
* Improvement: Rewrote the plugin readme with clearer feature descriptions, use cases, and setup steps.
* Improvement: Updated WooCommerce tested-up-to version.
* Fix: Review notice button text color no longer inherits the admin link color.

= 2.2.9 (21 May, 2026) =
* Improvement: Save settings notification UI.

= 2.2.8.1 (26 Apr, 2026) =
* Improvement: Documentation and URL updates.

[View the full changelog for all versions.](https://raw.githubusercontent.com/wptinysolution/WP-Changelog/refs/heads/main/cpt-woo-integration.txt)

== Upgrade Notice ==

= 2.2.10 =
Documentation refresh and admin review notice styling fixes. Safe update with no breaking changes.
