Plugin Directory

Changeset 3810486


Ignore:
Timestamp:
11/19/2026 01:14:47 AM (3 hours ago)
Author:
ozkanworks
Message:

Update readme.txt for store owners and developers

Location:
cleancatalog-quote-for-woocommerce
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • cleancatalog-quote-for-woocommerce/tags/1.1.0/readme.txt

    r3810287 r3810486  
    11=== CleanCatalog Quote for WooCommerce ===
    22Contributors: ozkanworks
    3 Tags: woocommerce, catalog mode, request a quote, block theme, hpos
     3Tags: catalog mode, request a quote, hide price, b2b, enquiry
    44Requires at least: 6.5
    55Tested up to: 7.1
    … …  
    99License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 Block-Theme (FSE), HPOS, and Store API ready Catalog Mode & Request a Quote for WooCommerce—zero PHP sessions, zero cache-busting cookies.
     11Switch WooCommerce to Catalog Mode, hide product prices, and accept multi-item Request a Quote inquiries—fast, cache-safe, and Block-Theme ready.
    1212
    1313== Description ==
    1414
    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.
     15Turn 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.
    1616
    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.
     17Whether 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
     36Unlike 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
     46Looking 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.
    2452
    2553== External Services ==
    … …  
    2957== Installation ==
    3058
    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.
     591. Upload the `cleancatalog-quote-for-woocommerce` folder to `/wp-content/plugins/`, or install via the **Plugins → Add New** screen in WordPress.
     602. Activate the plugin through the **Plugins** menu (requires WooCommerce 9.0+).
     613. Go to **WooCommerce → Catalog & Quote** to pick your Storefront Mode and customize button labels or price text.
     624. 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
     68No. 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
     72No. 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
     76Yes. 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
     80Every 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.
    3581
    3682== Changelog ==
  • cleancatalog-quote-for-woocommerce/trunk/readme.txt

    r3810287 r3810486  
    11=== CleanCatalog Quote for WooCommerce ===
    22Contributors: ozkanworks
    3 Tags: woocommerce, catalog mode, request a quote, block theme, hpos
     3Tags: catalog mode, request a quote, hide price, b2b, enquiry
    44Requires at least: 6.5
    55Tested up to: 7.1
    … …  
    99License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 Block-Theme (FSE), HPOS, and Store API ready Catalog Mode & Request a Quote for WooCommerce—zero PHP sessions, zero cache-busting cookies.
     11Switch WooCommerce to Catalog Mode, hide product prices, and accept multi-item Request a Quote inquiries—fast, cache-safe, and Block-Theme ready.
    1212
    1313== Description ==
    1414
    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.
     15Turn 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.
    1616
    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.
     17Whether 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
     36Unlike 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
     46Looking 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.
    2452
    2553== External Services ==
    … …  
    2957== Installation ==
    3058
    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.
     591. Upload the `cleancatalog-quote-for-woocommerce` folder to `/wp-content/plugins/`, or install via the **Plugins → Add New** screen in WordPress.
     602. Activate the plugin through the **Plugins** menu (requires WooCommerce 9.0+).
     613. Go to **WooCommerce → Catalog & Quote** to pick your Storefront Mode and customize button labels or price text.
     624. 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
     68No. 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
     72No. 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
     76Yes. 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
     80Every 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.
    3581
    3682== Changelog ==
Note: See TracChangeset for help on using the changeset viewer.