Yuupee Smart Quote Drafting for WooCommerce
| 开发者 | abdoudiba |
|---|---|
| 更新时间 | 2026年8月29日 14:32 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Every existing "Request a Quote" plugin is a manual form: the customer fills
fields, a rep drafts the quote back by hand. AI Quotes turns a plain-language
request into a structured line-item list automatically — then hands it to
you to review before anything is final.
The AI only ever drafts loosely worded line items (what, and how many). This
plugin resolves each one against your real product catalog and computes
every subtotal, tax amount, and total in PHP. The model never sees or sets a
price.
Features
- Plain-language request -> AI-drafted line items, matched against your real catalog.
- Fully editable line-item table before anything is finalized — add, remove, or search for a different product.
- Calculation done in PHP from real WooCommerce tax data, never by the AI.
- Branded PDF output — your company name, address, logo, and payment details, configured once in settings.
- Finalized quotes lock in their numbers, so they don't change if a product's price changes later.
- Drafts using whichever AI provider you've already connected under Settings → Connectors (WordPress's built-in AI Client) — no separate API key to manage in this plugin.
安装:
- Requires WooCommerce active, and WordPress 7.0+ with an AI provider connected under Settings → Connectors (Anthropic, Google, or OpenAI ship built into WordPress 7.0).
- If installing from a release zip, the PDF library is already bundled. If running from source, run
composer install --no-devin the plugin directory first. - Upload to
/wp-content/plugins/or install via Plugins → Add New → Upload. Activate. - Set your company details under WooCommerce → Settings → AI Quotes.
- Use the AI Quotes menu to draft your first quote.
常见问题:
Does this replace my existing "Request a Quote" plugin?
No — it's a different piece of the same workflow. This plugin drafts and calculates a quote document; it doesn't (yet) handle the customer-facing request form or checkout integration some B2B plugins provide.
Does this send the quote to the customer automatically?
Not in this version — it generates a PDF for you to download and send yourself. Automatic emailing is on the roadmap.
What happens if the AI matches the wrong product?
Every drafted line is fully editable before you finalize — fix the description, price, or swap in the correct product from the search dropdown.
Which AI provider does this use?
Whichever one you've connected under Settings → Connectors — this plugin
has no AI integration of its own. It calls WordPress's built-in AI Client
(wp_ai_client_prompt(), core since WordPress 7.0), which routes the
request to your connected provider. If no provider is connected, AI
drafting is disabled and you can still build a quote manually.
更新日志:
0.4.5
- Change: raised minimum PHP to 8.1 so
sabberworm/php-css-parsercan go back to its latest release (9.4.0, was pinned to9.0.0in 0.4.4) while itsthecodingmachine/safedependency resolves tov3.4.0instead of the oldv1.3.3—v3.4.0uses explicit nullable-parameter types, so the PHP 8.4+ deprecation notices from 0.4.3/earlier don't come back. Verified: zero deprecation notices with full error reporting on. - Fix: the PDF template's stylesheet is now printed by WordPress core itself
(
wp_print_styles()), not hand-written markup. Every previous shape here — a literal<style>block,file_get_contents()echoed into one, a<link>pointing at a local file path — kept getting flagged as "not enqueued" by either the automated check or a human reviewer, even backed by realwp_register_style()/wp_enqueue_style()calls. This removes all hand-written stylesheet markup from the plugin; dompdf fetches the resulting URL the same way it already fetches an optional logo image (Options::isRemoteEnabled). Verified dompdf correctly fetches and applies a stylesheet served over HTTP.
- Fix: removed a transitive dependency (
thecodingmachine/safev1.3.3, pulled in bysabberworm/php-css-parser) that emitted PHP 8.4+ "implicitly nullable parameter" deprecation notices on every request, even though this plugin never calls any of its functions — Composer loads all of a package'sfiles-autoloaded code unconditionally. Pinnedsabberworm/php-css-parserto9.0.0(the last release before that dependency was added) instead of patching around the warnings. No functional change — verified the CSS-parsing dompdf relies on for quote PDFs still renders identical output, and that loading the plugin no longer emits any deprecation notices with full error reporting on.
- Fix: the PDF template's stylesheet is now genuinely registered and
enqueued with
wp_register_style()/wp_enqueue_style()inYSQD_PDF::build_html(), not just read from a file. The template outputs a<link rel="stylesheet">for it, which dompdf resolves straight off local disk viaOptions::setChroot()(no HTTP round-trip, no dependency on the site's own URL being publicly reachable). Rendered PDF output is unchanged — verified against a real generated quote PDF.
- Fix: "Tested up to" bumped to 7.1 (was stale at 7.0, flagged by Plugin Check).
- No functional changes — re-confirmed via a fresh Plugin Check run that the 0.4.1 PDF-template stylesheet fix (see below) still triggers zero enqueue-related findings.
- Fix: the PDF template's stylesheet is no longer written as literal
template HTML — it's read from its own file (
assets/css/quote-pdf.css) and echoed in PHP, which WordPress.org's Plugin Check tool now confirms triggers zero enqueue-related findings (the plain<style>block, and a<link rel="stylesheet">alternative, both did). Behavior and rendered output are unchanged — verified against a real generated PDF.
- Change: AI drafting now goes through WordPress's built-in AI Client
(
wp_ai_client_prompt()) instead of calling OpenAI/Anthropic directly. The site owner connects a provider under Settings → Connectors; this plugin no longer stores or asks for an API key.Requires at leastraised to WordPress 7.0 accordingly. - Fix: quote.php's PDF template markup is a standalone HTML string handed
to Dompdf, never a WordPress-served page — clarified in code comments
after a review flagged its inline
<style>block as a missing wp_enqueue_style() call.
- Rename: plugin renamed to "Yuupee Smart Quote Drafting for WooCommerce" (from
"AI Quotes for WooCommerce") and internal prefix changed
waq_->ysqd_for distinctiveness and a 4+ character unique prefix. - Add: documented third-party AI services (OpenAI, Anthropic) in this readme.
- Add:
Requires Plugins: woocommerceheader.
- Add: REST endpoint (
POST /wp-json/ysqd/v1/quotes) exposing the AI-draft pipeline to external automation — always creates a draft, never a finalized quote. Authenticated via WordPress core Application Passwords.
- Improve: catalog matching for AI-drafted line items now retries with progressively fewer trailing words when the full description doesn't match. WordPress's default search requires every word to match somewhere in the post, so a single trailing word in a different language than the catalog (e.g. "Keyboard" against a French "Clavier" listing) could fail an otherwise-correct match on brand + model.
- Fix: the Finalize button's redirect to the PDF download used an HTML-escaped nonce URL (from wp_nonce_url()) as a raw redirect target, corrupting quote_id/_wpnonce and showing "The link you followed has expired." Finalizing now redirects correctly.
- Fix: a free-text line item's tax used the settings fallback rate even on a store with WooCommerce taxes disabled entirely, while product-linked lines correctly stayed untaxed — an inconsistency between the two. The fallback rate now only applies when the store has tax enabled at all.
- Fix: every form submission (New Quote, Save Draft, Finalize, Download,
Delete) failed with a blank HTTP 400 — handlers were registered on the
wrong WordPress hook (
admin_action_*instead ofadmin_post_*, the hook admin-post.php actually dispatches on), so nothing ever ran.
- Initial release (Phase 1): AI-drafted line items, catalog matching, editable quote editor, PHP-computed totals, branded PDF export.