Changeset 3810486
- Timestamp:
- 11/19/2026 01:14:47 AM (3 hours ago)
- Location:
- cleancatalog-quote-for-woocommerce
- Files:
-
- 2 edited
-
tags/1.1.0/readme.txt (modified) (3 diffs)
-
trunk/readme.txt (modified) (3 diffs)
Legend:
- Unmodified
- Added
- Removed
-
cleancatalog-quote-for-woocommerce/tags/1.1.0/readme.txt
r3810287 r3810486 1 1 === CleanCatalog Quote for WooCommerce === 2 2 Contributors: ozkanworks 3 Tags: woocommerce, catalog mode, request a quote, block theme, hpos3 Tags: catalog mode, request a quote, hide price, b2b, enquiry 4 4 Requires at least: 6.5 5 5 Tested up to: 7.1 … … 9 9 License URI: https://www.gnu.org/licenses/gpl-2.0.html 10 10 11 Block-Theme (FSE), HPOS, and Store API ready Catalog Mode & Request a Quote for WooCommerce—zero PHP sessions, zero cache-busting cookies.11 Switch WooCommerce to Catalog Mode, hide product prices, and accept multi-item Request a Quote inquiries—fast, cache-safe, and Block-Theme ready. 12 12 13 13 == Description == 14 14 15 CleanCatalog Quote for WooCommerce gives store owners a lightweight, reliable way to switch WooCommerce into Catalog Mode, hide prices, and accept multi-item Request a Quote inquiries without breaking modern WordPress Block Themes, WooCommerce Cart/Checkout/Mini-Cart blocks, or full-page caching.15 Turn your WooCommerce store into a clean B2B catalog or **Request a Quote** storefront in minutes—without slowing down your site, breaking your theme, or disabling page caching. 16 16 17 = Built for Modern WooCommerce Architecture = 18 * **Full Site Editing (FSE) & Block Theme Ready:** Handles `woocommerce/add-to-cart-form`, `woocommerce/add-to-cart-with-options`, `woocommerce/product-button`, `woocommerce/mini-cart`, and `woocommerce/product-price` blocks cleanly, plus classic WooCommerce themes such as Storefront. 19 * **Zero Page-Cache Destruction:** Never calls `session_start()` or `wp_rand()` on page loads, never sets `PHPSESSID` or `wp_woocommerce_session_` on anonymous visitors, and never writes expired guest sessions into `wp_options`. Guest quote lists stay in browser `localStorage` until submission. 20 * **Cache-Safe REST Submission:** Fetches a fresh nonce via a `nocache_headers()` endpoint at submission time, protected by honeypot, same-origin checks, and server-side IP transient rate limiting. 21 * **HPOS Native Orders:** Saves quote requests via official WooCommerce CRUD (`wc_create_order()`) under the `Quote Request` status (`wc-ccatq-quote`) and delivers both Admin and Customer emails reliably. 22 * **Variable Products & "Any" Attributes:** Keeps variation selectors intact in Quote Mode so customers can pick exact or "Any" attribute combinations. 23 * **SEO-Safe by Default:** Never alters `is_in_stock()` (preventing false "Out of Stock" Google Search warnings). Optional opt-in toggles allow hiding JSON-LD `offers` and Store API `/wc/store/v1/products` prices when Hide Price is active. 17 Whether you sell wholesale, custom-built equipment, made-to-order products, or showroom inventory, CleanCatalog Quote for WooCommerce lets customers browse your catalog, pick variations, build a multi-item quote list, and send inquiries straight into **WooCommerce → Orders**. 18 19 = What You Can Do = 20 21 * **4 Storefront Modes:** Switch cleanly between Normal Store, **Catalog Only** (disable purchasing and link to a custom Contact / Enquiry button), **Catalog + Request a Quote** (replace *Add to Cart* with *Add to Quote*), or **Quote Alongside Cart** (keep regular checkout active alongside a quote option). 22 * **Hide Product Prices:** Hide storefront prices globally and optionally show custom replacement text such as *"Contact for Pricing"*—while keeping prices visible to your team in WP Admin. 23 * **Multi-Item Quote List (Popup Modal or Dedicated Page):** Visitors can add multiple products and quantities to a Quote List and submit everything via a slide-up popup modal or a dedicated page using the **Quote Request Basket** block or `[ccatq_quote_basket]` shortcode. 24 * **Full Variable Product Support:** Customers can choose exact product variations (size, color, material—including "Any" attribute combinations) before adding items to their quote. 25 * **Quotes Managed Like Real WooCommerce Orders:** Every inquiry is stored cleanly inside **WooCommerce → Orders** under the editable `Quote Request` status (`wc-ccatq-quote`) with automatic confirmation emails sent to both the store admin and the customer. 26 27 = Ideal For = 28 29 * Wholesale, B2B, and trade stores needing custom pricing or bulk inquiries 30 * Custom-manufactured, configured, or made-to-order products 31 * Showrooms and manufacturer catalogs displaying stock without direct online checkout 32 * Stores temporarily pausing checkout while keeping product pages visible 33 34 = Built for Modern WooCommerce (For Agencies & Developers) = 35 36 Unlike legacy catalog plugins that drop session cookies on every visitor or break modern WooCommerce templates, CleanCatalog is engineered for current WordPress and WooCommerce standards: 37 38 * **Full Site Editing (FSE) & Classic Themes:** Natively supports WooCommerce blocks (`woocommerce/add-to-cart-form`, `woocommerce/add-to-cart-with-options`, `woocommerce/product-button`, `woocommerce/mini-cart`, `woocommerce/product-price`) as well as classic themes like Astra, Kadence, and Storefront. 39 * **Zero Page-Cache Destruction:** Never calls `session_start()` or `wp_rand()` on page loads and never sets `PHPSESSID` or `wp_woocommerce_session_` cookies on anonymous shoppers. Guest quote lists stay in browser `localStorage` until submission. 40 * **Cache-Safe REST Submission:** Fetches a fresh nonce via a `nocache_headers()` endpoint only when submitting a quote, backed by honeypot, same-origin checks, and server-side IP transient rate limiting. 41 * **HPOS Native Orders:** Uses official WooCommerce CRUD (`wc_create_order()`), declares HPOS and Cart/Checkout Block compatibility, and excludes unpaid quote requests from revenue analytics. 42 * **SEO-Safe by Default:** Never fakes out-of-stock status via `is_in_stock()` (avoiding false "Out of Stock" warnings in search results). Optional opt-in toggles allow removing JSON-LD `offers` or masking Store API (`/wc/store/v1/products`) prices when prices are hidden. 43 44 = Optional Pro Extension = 45 46 Looking for granular B2B rules and quote-to-payment checkout? **[Clean Catalog & Quote Pro](https://cleancatalog.site/pricing/)** extends the free plugin with: 47 48 * **Targeted Rules Matrix:** Apply different modes or price visibility rules by WordPress user role, logged-out guests, logged-in users, product categories, tags, or per-product overrides. 49 * **Extra B2B Quote Form Fields:** Capture Tax / VAT / EORI ID, shipping country/city, target delivery date, PO reference, and up to 2 custom fields. 50 * **Branded Printable Quote Proposals:** Generate clean Print / Save-as-PDF proposal sheets (`noindex, nofollow`) with your logo, address, terms, and expiry date. 51 * **Quote-to-Payment Workflow:** Email customers a `Quote Sent` proposal link that opens WooCommerce's native Pay for Order screen—with automatic daily quote expiration. 24 52 25 53 == External Services == … … 29 57 == Installation == 30 58 31 1. Upload the `cleancatalog-quote-for-woocommerce` folder to `/wp-content/plugins/`, or install via the WordPress Plugins screen. 32 2. Activate the plugin through the **Plugins** menu in WordPress (requires WooCommerce). 33 3. Configure your mode under **WooCommerce > Catalog & Quote**. 34 4. Optionally place the **Quote Request Basket** block or `[ccatq_quote_basket]` shortcode on a dedicated page. 59 1. Upload the `cleancatalog-quote-for-woocommerce` folder to `/wp-content/plugins/`, or install via the **Plugins → Add New** screen in WordPress. 60 2. Activate the plugin through the **Plugins** menu (requires WooCommerce 9.0+). 61 3. Go to **WooCommerce → Catalog & Quote** to pick your Storefront Mode and customize button labels or price text. 62 4. Optionally place the **Quote Request Basket** block or `[ccatq_quote_basket]` shortcode on a dedicated quote page. 63 64 == Frequently Asked Questions == 65 66 = Will this slow down my site or break Cloudflare / WP Rocket / LiteSpeed caching? = 67 68 No. Pending quote lists stay in the visitor's browser `localStorage`, and no PHP sessions or WooCommerce session cookies are created when anonymous visitors browse your shop. A fresh REST nonce is fetched via a `no-store` endpoint (`GET /wp-json/ccatq/v1/nonce`) only at the moment a shopper clicks Submit. 69 70 = Does hiding prices mark my products as "Out of Stock" in Google? = 71 72 No. CleanCatalog never modifies `is_in_stock()`, preventing false "Out of Stock" Google Search issues. An optional opt-in setting also lets you strip JSON-LD `offers` or mask `/wc/store/v1/products` prices when Hide Price is active. 73 74 = Does it work with Block Themes (FSE) and WooCommerce HPOS? = 75 76 Yes. It supports Full Site Editing WooCommerce blocks (including the Mini-Cart, Product Price, Product Button, Add to Cart Form, and Add to Cart with Options blocks), classic themes, and WooCommerce High-Performance Order Storage (HPOS). 77 78 = Where do submitted quote requests appear? = 79 80 Every submitted quote creates an editable order under **WooCommerce → Orders** with the **Quote Request** status (`wc-ccatq-quote`) and sends email notifications to both the store admin and the customer. 35 81 36 82 == Changelog == -
cleancatalog-quote-for-woocommerce/trunk/readme.txt
r3810287 r3810486 1 1 === CleanCatalog Quote for WooCommerce === 2 2 Contributors: ozkanworks 3 Tags: woocommerce, catalog mode, request a quote, block theme, hpos3 Tags: catalog mode, request a quote, hide price, b2b, enquiry 4 4 Requires at least: 6.5 5 5 Tested up to: 7.1 … … 9 9 License URI: https://www.gnu.org/licenses/gpl-2.0.html 10 10 11 Block-Theme (FSE), HPOS, and Store API ready Catalog Mode & Request a Quote for WooCommerce—zero PHP sessions, zero cache-busting cookies.11 Switch WooCommerce to Catalog Mode, hide product prices, and accept multi-item Request a Quote inquiries—fast, cache-safe, and Block-Theme ready. 12 12 13 13 == Description == 14 14 15 CleanCatalog Quote for WooCommerce gives store owners a lightweight, reliable way to switch WooCommerce into Catalog Mode, hide prices, and accept multi-item Request a Quote inquiries without breaking modern WordPress Block Themes, WooCommerce Cart/Checkout/Mini-Cart blocks, or full-page caching.15 Turn your WooCommerce store into a clean B2B catalog or **Request a Quote** storefront in minutes—without slowing down your site, breaking your theme, or disabling page caching. 16 16 17 = Built for Modern WooCommerce Architecture = 18 * **Full Site Editing (FSE) & Block Theme Ready:** Handles `woocommerce/add-to-cart-form`, `woocommerce/add-to-cart-with-options`, `woocommerce/product-button`, `woocommerce/mini-cart`, and `woocommerce/product-price` blocks cleanly, plus classic WooCommerce themes such as Storefront. 19 * **Zero Page-Cache Destruction:** Never calls `session_start()` or `wp_rand()` on page loads, never sets `PHPSESSID` or `wp_woocommerce_session_` on anonymous visitors, and never writes expired guest sessions into `wp_options`. Guest quote lists stay in browser `localStorage` until submission. 20 * **Cache-Safe REST Submission:** Fetches a fresh nonce via a `nocache_headers()` endpoint at submission time, protected by honeypot, same-origin checks, and server-side IP transient rate limiting. 21 * **HPOS Native Orders:** Saves quote requests via official WooCommerce CRUD (`wc_create_order()`) under the `Quote Request` status (`wc-ccatq-quote`) and delivers both Admin and Customer emails reliably. 22 * **Variable Products & "Any" Attributes:** Keeps variation selectors intact in Quote Mode so customers can pick exact or "Any" attribute combinations. 23 * **SEO-Safe by Default:** Never alters `is_in_stock()` (preventing false "Out of Stock" Google Search warnings). Optional opt-in toggles allow hiding JSON-LD `offers` and Store API `/wc/store/v1/products` prices when Hide Price is active. 17 Whether you sell wholesale, custom-built equipment, made-to-order products, or showroom inventory, CleanCatalog Quote for WooCommerce lets customers browse your catalog, pick variations, build a multi-item quote list, and send inquiries straight into **WooCommerce → Orders**. 18 19 = What You Can Do = 20 21 * **4 Storefront Modes:** Switch cleanly between Normal Store, **Catalog Only** (disable purchasing and link to a custom Contact / Enquiry button), **Catalog + Request a Quote** (replace *Add to Cart* with *Add to Quote*), or **Quote Alongside Cart** (keep regular checkout active alongside a quote option). 22 * **Hide Product Prices:** Hide storefront prices globally and optionally show custom replacement text such as *"Contact for Pricing"*—while keeping prices visible to your team in WP Admin. 23 * **Multi-Item Quote List (Popup Modal or Dedicated Page):** Visitors can add multiple products and quantities to a Quote List and submit everything via a slide-up popup modal or a dedicated page using the **Quote Request Basket** block or `[ccatq_quote_basket]` shortcode. 24 * **Full Variable Product Support:** Customers can choose exact product variations (size, color, material—including "Any" attribute combinations) before adding items to their quote. 25 * **Quotes Managed Like Real WooCommerce Orders:** Every inquiry is stored cleanly inside **WooCommerce → Orders** under the editable `Quote Request` status (`wc-ccatq-quote`) with automatic confirmation emails sent to both the store admin and the customer. 26 27 = Ideal For = 28 29 * Wholesale, B2B, and trade stores needing custom pricing or bulk inquiries 30 * Custom-manufactured, configured, or made-to-order products 31 * Showrooms and manufacturer catalogs displaying stock without direct online checkout 32 * Stores temporarily pausing checkout while keeping product pages visible 33 34 = Built for Modern WooCommerce (For Agencies & Developers) = 35 36 Unlike legacy catalog plugins that drop session cookies on every visitor or break modern WooCommerce templates, CleanCatalog is engineered for current WordPress and WooCommerce standards: 37 38 * **Full Site Editing (FSE) & Classic Themes:** Natively supports WooCommerce blocks (`woocommerce/add-to-cart-form`, `woocommerce/add-to-cart-with-options`, `woocommerce/product-button`, `woocommerce/mini-cart`, `woocommerce/product-price`) as well as classic themes like Astra, Kadence, and Storefront. 39 * **Zero Page-Cache Destruction:** Never calls `session_start()` or `wp_rand()` on page loads and never sets `PHPSESSID` or `wp_woocommerce_session_` cookies on anonymous shoppers. Guest quote lists stay in browser `localStorage` until submission. 40 * **Cache-Safe REST Submission:** Fetches a fresh nonce via a `nocache_headers()` endpoint only when submitting a quote, backed by honeypot, same-origin checks, and server-side IP transient rate limiting. 41 * **HPOS Native Orders:** Uses official WooCommerce CRUD (`wc_create_order()`), declares HPOS and Cart/Checkout Block compatibility, and excludes unpaid quote requests from revenue analytics. 42 * **SEO-Safe by Default:** Never fakes out-of-stock status via `is_in_stock()` (avoiding false "Out of Stock" warnings in search results). Optional opt-in toggles allow removing JSON-LD `offers` or masking Store API (`/wc/store/v1/products`) prices when prices are hidden. 43 44 = Optional Pro Extension = 45 46 Looking for granular B2B rules and quote-to-payment checkout? **[Clean Catalog & Quote Pro](https://cleancatalog.site/pricing/)** extends the free plugin with: 47 48 * **Targeted Rules Matrix:** Apply different modes or price visibility rules by WordPress user role, logged-out guests, logged-in users, product categories, tags, or per-product overrides. 49 * **Extra B2B Quote Form Fields:** Capture Tax / VAT / EORI ID, shipping country/city, target delivery date, PO reference, and up to 2 custom fields. 50 * **Branded Printable Quote Proposals:** Generate clean Print / Save-as-PDF proposal sheets (`noindex, nofollow`) with your logo, address, terms, and expiry date. 51 * **Quote-to-Payment Workflow:** Email customers a `Quote Sent` proposal link that opens WooCommerce's native Pay for Order screen—with automatic daily quote expiration. 24 52 25 53 == External Services == … … 29 57 == Installation == 30 58 31 1. Upload the `cleancatalog-quote-for-woocommerce` folder to `/wp-content/plugins/`, or install via the WordPress Plugins screen. 32 2. Activate the plugin through the **Plugins** menu in WordPress (requires WooCommerce). 33 3. Configure your mode under **WooCommerce > Catalog & Quote**. 34 4. Optionally place the **Quote Request Basket** block or `[ccatq_quote_basket]` shortcode on a dedicated page. 59 1. Upload the `cleancatalog-quote-for-woocommerce` folder to `/wp-content/plugins/`, or install via the **Plugins → Add New** screen in WordPress. 60 2. Activate the plugin through the **Plugins** menu (requires WooCommerce 9.0+). 61 3. Go to **WooCommerce → Catalog & Quote** to pick your Storefront Mode and customize button labels or price text. 62 4. Optionally place the **Quote Request Basket** block or `[ccatq_quote_basket]` shortcode on a dedicated quote page. 63 64 == Frequently Asked Questions == 65 66 = Will this slow down my site or break Cloudflare / WP Rocket / LiteSpeed caching? = 67 68 No. Pending quote lists stay in the visitor's browser `localStorage`, and no PHP sessions or WooCommerce session cookies are created when anonymous visitors browse your shop. A fresh REST nonce is fetched via a `no-store` endpoint (`GET /wp-json/ccatq/v1/nonce`) only at the moment a shopper clicks Submit. 69 70 = Does hiding prices mark my products as "Out of Stock" in Google? = 71 72 No. CleanCatalog never modifies `is_in_stock()`, preventing false "Out of Stock" Google Search issues. An optional opt-in setting also lets you strip JSON-LD `offers` or mask `/wc/store/v1/products` prices when Hide Price is active. 73 74 = Does it work with Block Themes (FSE) and WooCommerce HPOS? = 75 76 Yes. It supports Full Site Editing WooCommerce blocks (including the Mini-Cart, Product Price, Product Button, Add to Cart Form, and Add to Cart with Options blocks), classic themes, and WooCommerce High-Performance Order Storage (HPOS). 77 78 = Where do submitted quote requests appear? = 79 80 Every submitted quote creates an editable order under **WooCommerce → Orders** with the **Quote Request** status (`wc-ccatq-quote`) and sends email notifications to both the store admin and the customer. 35 81 36 82 == Changelog ==
Note:
See TracChangeset
for help on using the changeset viewer.