User documentation: Product enquiry for WooCommerce

Enquiry Button

Enquiry Button on Shop/Category Page

Enable or disable the enquiry button on product listings such as shop and category pages. When enabled, customers can add products to their enquiry cart directly from these pages.
Example: If you want users to enquire about multiple products without visiting each product page, enable this option.

Show enquiry option when product is out of stock (Shop/Category)

Show the enquiry button only when a product is out of stock on shop or category pages. Useful for capturing interest in unavailable items.
Example: If a product is sold out, users can still enquire about its availability.

Enquiry Button Position on Shop/Category Page

Choose where to place the enquiry button on shop and category pages. Options include before/after product title or at the start/end of the product listing.
Example: Place the button after the product title for better visibility.

Enquiry Button text (Shop/Category)

Customize the text displayed on the enquiry button for shop and category pages.
Example: Change the button text to “Request Info” instead of “Add to Enquiry”.

Enquiry Button Text for Variable Products

Set different button text for variable products (e.g., “View Options”) since they can’t be added directly from the shop page.
Example: For T-shirts with sizes, use “View Options” to prompt users to select a variation.

Enquiry Button Style for Shop/Category Page

Customize the button’s appearance on shop and category pages, including colors, font size, width, border radius, and padding.
Example: Make the button orange with white text and rounded corners.

Enquiry Button on Single Product Page

Enable or disable the enquiry button on individual product detail pages. Allows customers to enquire about a specific product.
Example: Show the button on every product page for direct enquiries.

Show enquiry option when product is out of stock (Single Product)

Show the enquiry button only when a product is out of stock on single product pages.
Example: If a product is unavailable, users can still send an enquiry.

Enquiry Button Position on Single Product Page

Choose where to place the enquiry button on product detail pages, such as before/after the add to cart button or summary.

You can add the enquiry button using the shortcode [pi_enquiry_button] on the single product page.

Example: Place the button after the add to cart button for easy access.

Enquiry Button text (Single Product)

Customize the text displayed on the enquiry button for single product pages.
Example: Use “Contact Us” instead of “Add to Enquiry”.

Enquiry Button Style for Single Product Page

Customize the button’s appearance on individual product pages, including colors, font size, width, border radius, and padding.
Example: Make the button match your site’s branding.

Auto-Select First Variation for Enquiry

If no variation is selected, automatically add the first variation of a variable product to the enquiry cart.
Example: For products with sizes, auto-select the first available size if the user doesn’t choose one.

Enquiry submission form

This setting category groups options related to the enquiry submission form, including button text and style.

Submit Enquiry Button Text

Customize the text for the enquiry submission button.
Example: Change the button text to “Send Request”.

Submit Enquiry Button Style

Customize the appearance of the submit enquiry button, including colors, font size, width, border radius, and padding.
Example: Make the submit button stand out with a bold color.

Restrict Enquiry by User Role

Only show the enquiry button to selected user roles. Leave blank to enable for all users.
Example: Restrict enquiries to logged-in wholesale customers only.

Loading Image

Display this image while the enquiry action is being processed.
Example: Show a spinner or loading GIF when the user submits an enquiry.

Advance option

Add to Cart Button Visibility

Controls if the standard WooCommerce Add to Cart button stays visible, is always hidden, or hides only when the enquiry feature is active for a product.

Example: Choose “Hide if enquiry enabled” so normal products keep Add to Cart, but enquiry-only products hide it.

Product Price Visibility

Determines when product prices are hidden: never, for everyone, only for guests, or only on products with enquiry enabled. Hiding prices also hides Add to Cart.

Example: Set to “guest” to show prices only to logged-in users.

Hide Price Column in Enquiry Cart

Removes the price column (and from emails) in the enquiry cart to make the process quote-focused.

Example: Enable when you always custom quote and never want users to see prices up front.

Hide Quantity Column in Enquiry Cart

Removes the quantity column so each product is listed once without quantity adjustment.

Example: Use for service enquiries where quantity is irrelevant.

Hide Product Message Column in Enquiry Cart

Removes the per‑product note/message input field from enquiry cart.

Example: Enable if you only want a single global message in the form and dont want to take product specific messages.

Hide Subtotal in Enquiry Cart

Hides the subtotal row. Automatically redundant if prices are already removed.

Example: Use when you do not want any implied pricing before quoting.

Apply Tax Settings to Enquiry Cart Prices

Displays prices in the enquiry cart respecting WooCommerce tax display rules. Disable to show raw product base price.

Example: Disable if you want backend team to decide tax later.

Enquiry Cart Page

Selects which page hosts the enquiry cart shortcode. Must contain [pisol_enquiry_cart] if custom.

Example: Create a page “Request List” and add shortcode “[pisol_enquiry_cart]” and select it here.

Redirect Cart & Checkout to Enquiry Cart

Forces visitors trying to access WooCommerce cart or checkout to the enquiry cart page, making the store enquiry-only.

Example: Enable for catalog mode without purchasing.

View Enquiry Cart Button Text

Customizes the link text shown after adding a product to the enquiry cart.

Variation Selection Warning Message

Error shown when a variable product is added without selecting all attributes.

Example: “Please choose size and color first.”

Form Submission Success Message

Displayed after successful enquiry when no thank you redirect URL is set.

Example: “Thank you! We will reply within 24 hours.”

Thank You Page URL

Redirect target after enquiry submission. Blank means stay on page and show success message.

Example: https://example.com/thank-you-enquiry

Action After Adding Product to Enquiry

Defines post-add behavior: do nothing, redirect to cart, open form popup, or show popup confirmation message.

Example: Select “popup” to prompt immediate form submission.

Popup Message Text

Template for the add-to-enquiry popup. Supports {product} and {view_cart} placeholders.

Example: “{product} added. {view_cart} or continue browsing.”

Empty Enquiry Cart Message

Message displayed when the enquiry cart has no products.

Example: “No items yet. Browse products to add enquiries.”

Show Enquiry Cart Products in Popup

Toggles listing already added products inside the enquiry popup form.

Example: Enable to let users confirm items before submitting.

Enquiry Popup Title

Heading text at top of the enquiry form popup.

Example: “Request a Quote”.

Popup Title Background Color

Sets the background color of the popup header bar.

Example: Use brand color #0057B8.

Popup Title Text Color

Sets the text color of the popup header title.

Example: White (#FFFFFF) for dark backgrounds.

My Enquiries Menu Title

Label shown in the My Account navigation for the enquiries endpoint.

Example: Change to “Quotes”.

My Enquiries Page URL Slug

URL endpoint slug under My Account. Must be lowercase and hyphenated.

Example: quotes-history

Product ID Column Label

Header text for the product ID column in the enquiry cart table.

Example: Change to “ID”.

Product Column Label

Header text for the product name/details column.

Example: “Item”.

Price Column Label

Header text for the price column (if shown).

Example: “Unit Price”.

SKU Column Label

Header text for the SKU column.

Example: “Code”.

Quantity Column Label

Header text for the quantity column.

Example: “Qty”.

Message Column Label

Header text for per‑product message/notes column.

Example: “Notes”.

Total Cost Label

Label for the total/subtotal row (if totals visible).

Example: “Estimated Total”.

Product Message Placeholder Text

Placeholder inside the per‑product message input.

Example: “Add special requirements”.

Required Field Validation Message

Error shown when a required form field is left blank.

Example: “Required”.

Numeric Field Validation Message

Error shown when non-numeric characters are entered in number-only fields.

Example: “Numbers only”.

Email Validation Message

Error shown when an invalid email format is entered.

Example: “Invalid email”.

Enquiry Form Layout

Selects single or two-column layout for form fields.

Example: Use two-column to shorten vertical scroll.

Enquiry Cart Position Relative to Form

Places the enquiry cart block above, left, or right of the form.

Example: Choose “right” for desktop side-by-side layout.

Webhook URL

Endpoint to receive JSON enquiry payload after submission (e.g., Zapier, automation tools). Invalid URLs are cleared.

Example: https://hooks.zapier.com/hooks/catch/123456/abc123

Dynamic Cart

Show Floating Enquiry Cart Icon

Enables the floating enquiry cart icon that stays visible as the user browses. It dynamically shows the current number of items added to the enquiry cart and gives quick access to view or submit the enquiry.

Example: Enable it to show a small cart icon at the bottom-right that updates from 0 to 3 as the user adds three different products.

Use Shortcode Instead of Auto-Insert

Disables the automatic floating icon and lets you manually place the cart icon anywhere using the shortcode [enquiry_cart_icon]. Useful for integrating into theme headers or custom layouts.

Example: Enable this, then add [enquiry_cart_icon] inside a header widget area so it aligns with your theme’s native menu.

Floating Cart Icon Position

Selects the screen corner (top-left, top-right, bottom-left, bottom-right) where the automatic floating enquiry cart icon appears. Only applies when shortcode mode is disabled.

Example: Choose Bottom Right to place the icon above the mobile thumb zone for easy tapping.

Cart Icon Click Action

Defines what happens when the user clicks the enquiry cart icon: navigate to the enquiry cart page, open the full enquiry form in a popup, or display a mini enquiry cart panel. Lets you tailor interaction style to your UX strategy.

Example: Select “Open mini enquiry cart” to show a small slide-out panel listing items without a page reload.

Auto-Open Mini Cart on Product Add

If enabled, the mini enquiry cart automatically opens immediately after a product is added, giving instant visual confirmation and encouraging further action (edit/remove/submit).

Example: User clicks “Add to Enquiry” and the mini cart slides in showing the newly added product.

Custom Cart Icon Image

Allows uploading a custom image to replace the default enquiry cart icon. Supports branding or thematic alignment with your site design. Leave blank to use the built‑in icon.

Example: Upload a speech-bubble icon to emphasize that this is an enquiry, not a purchase cart.

Cart Icon Counter Display

Determines whether the badge on the cart icon shows the total quantity of all items (including multiples) or the number of unique products added. Helps align user perception with your enquiry processing style.

Example: If a user adds Product A (qty 3) and Product B (qty 1): Quantity mode shows 4; Product count mode shows 2.

Mini Cart Header Text

Customizes the title text displayed at the top of the mini enquiry cart panel or popup. Useful for localization or rewording (e.g., “Quote Basket”).

Example: Change to “Request For Quote” to match B2B language.

Submit Button Text

Sets the label shown on the mini cart’s submission button. Adjust for tone or action clarity (e.g., “Send Request” vs “Submit Enquiry”).

Example: Set to “Get Quote” to encourage action.

Submit Button Styling

Controls visual styling of the mini cart submit button: background colors (normal/hover), text colors (normal/hover), font size, fixed width with unit, border radius, and horizontal/vertical padding. Ensures the button matches theme branding.

Example: Increase width to 300px, set background to brand blue, and adjust padding for a prominent CTA.

Mini Cart Header Background Color

Sets the background color for the mini cart header area to align with brand palette or to create contrast with the body content.

Example: Use #222 for a dark header with white text for readability.

Mini Cart Header Text Color

Defines the text (and icon) color inside the mini cart header, ensuring contrast against the selected header background.

Example: Pair a dark maroon background with #FFFFFF text for accessibility.

Cart Count Element Selector

Advanced: A jQuery/CSS selector for an existing theme element where the enquiry item count should be mirrored. When set, the plugin updates that element’s text with the current enquiry count, enabling seamless theme integration without duplicating icons.

Example: Enter .site-header .mini-cart-count to reuse your theme’s existing badge area.

Cart Link Element Selector

Advanced: A jQuery/CSS selector targeting an existing cart link in the theme to dynamically replace its URL with the enquiry cart page URL. Helps repurpose a standard WooCommerce cart link for the enquiry workflow.

Example: Enter a selector like a.menu-item-cart > a so clicking it opens the enquiry cart instead of the WooCommerce cart.

WooCommerce Cart to Enquiry

When enabled, customers can submit the products in their WooCommerce cart as an enquiry instead of placing an order.

Email Setting

Recipient Email Address(es)

Defines one or more admin/manager email addresses that receive new enquiry notifications. Multiple addresses can be separated by commas. Invalid addresses are ignored during save. If empty, an admin notice prompts completion.

Example: admin@site.com, sales@site.com

Admin Email Subject Line

Subject line used in notification emails sent to site administrators. Supports the placeholder {enquiry_no} which is replaced with the enquiry number.

Example: New enquiry received (Enquiry #{enquiry_no}) -> “New enquiry received (Enquiry #1045)”

Sender Email Address

Email address placed in the From header of outgoing enquiry emails. Should belong to the site’s domain to improve deliverability. Falls back to WordPress default if left blank.

Example: noreply@yourstore.com

Sender Display Name

Human‑readable name shown as the sender in recipient inboxes. Helps with brand recognition and trust.

Example: YourStore Enquiries

Show Customer Name as Sender in Admin Email

When enabled, replaces the configured sender name with the customer’s submitted name in emails sent to admins, making identification faster.

Example: From: Jane Doe <jane@example.com> instead of YourStore Enquiries

Force Image URLs in Emails

Forces product and logo images to use absolute URLs. Enable only if images fail to load due to relative path issues.

Example: Converts /wp-content/uploads/logo.png to https://yourstore.com/wp-content/uploads/logo.png

Hide Product Images in Emails

Removes product thumbnail images from enquiry emails to reduce size or create a minimalist layout.

Example: Email shows only product name, SKU, quantity instead of including thumbnails.

Include Product SKU in Emails & Cart

Adds SKU values beside product names in enquiry cart and emails to aid product identification.

Example: “Premium Mug (SKU: MUG-RED-11)”

Include Product ID in Emails

Displays the internal WooCommerce product ID in admin/customer emails. Useful for backend reference or integrations.

Example: “Premium Mug (ID: 742)”

Send Copy to Customer

Sends a confirmation email to the customer containing their submitted enquiry details.

Example: Customer receives “We received your enquiry” email after submission.

Hide Customer Details from Customer Email

Removes the customer’s own contact block from the confirmation email they receive to avoid redundancy.

Example: Customer email omits name/email/phone table while admin email keeps it.

Display Product Messages as Separate Rows

Shows per‑product custom messages in their own dedicated rows instead of cramped inline columns, improving readability for longer notes.

Example: Product row followed by a full-width “Message: Please quote bulk price.”

Customer Email Subject Line

Subject line for the confirmation sent to the customer. Supports {enquiry_no} placeholder.

Example: Your enquiry is submitted (Ref #{enquiry_no}) -> “Your enquiry is submitted (Ref #1045)”

Include Logo in Emails

Controls whether a configured logo image appears in the email header. Disable to simplify layout or reduce bandwidth.

Example: Header shows company logo above the enquiry details.

Email Logo Image

Uploaded logo displayed (if enabled) in the header of outgoing enquiry emails for branding.

Example: 200×60 PNG company logo.

Use WooCommerce Email Styling

Applies WooCommerce core email template (colors, borders, typography) for visual consistency with order emails.

Example: Enquiry email matches the styling of order confirmation emails.

Email Header Text

Headline text shown near top of the email body. Supports {enquiry_no} placeholder for dynamic numbering.

Example: Enquiry no. #1045

Send Plain Text Emails

Forces all enquiry emails to be sent as plain text (no HTML, images, or formatting). Improves compatibility and reduces spam filtering risk.

Example: Simple text list of products instead of a styled table.

Manager Email Type

Determines whether each product manager receives the full enquiry (all products) or only a filtered email containing products they manage.

Example: Different mode: Manager A gets only products they own; Same mode: all managers receive identical full enquiry.

Email Delivery Method

Selects immediate sending or scheduled background (cron) dispatch of product manager emails. Background mode reduces perceived submission delay.

Example: High volume store chooses “background scheduling” to queue 50 manager notifications.

Enable Honeypot Protection

Adds a hidden form field intended to trap bots. Submissions filling it are discarded, reducing spam without user friction.

Example: Bot fills hidden “website2” field -> enquiry rejected.

CAPTCHA Protection

Enables an image CAPTCHA challenge to block automated submissions. Can be disabled if honeypot alone suffices.

Example: User enters characters from distorted image.

CAPTCHA Character Type

Defines allowable character set for generated CAPTCHA codes: uppercase, lowercase, numbers, or a mix for higher entropy.

Example: Mix -> “A7b4Zq”

CAPTCHA Length

Number of characters displayed in the CAPTCHA. Longer length increases difficulty for bots but may reduce usability.

Example: Length 6 -> “G4NM2Q”

CAPTCHA Field Placeholder

Placeholder text shown inside the CAPTCHA input field guiding the user on expected action.

Example: “Enter the CAPTCHA”

Message Above Product Table (Customer)

Custom rich text (supports limited HTML/shortcodes) displayed above the product list in customer confirmation emails.

Example: “Thank you for your enquiry. Our team will reply within 24 hours.”

Message Below Product Table (Customer)

Additional content shown after the product table in customer emails; good for next steps or helpful links.

Example: “Need changes? Reply directly to this email.”

Message Below Customer Details (Customer)

Content displayed beneath the customer information block in customer emails—useful for disclaimers or privacy notes.

Example: “We use your data only to respond to this enquiry.”

Message Above Product Table (Admin)

Internal note area added above the product list in admin notification emails—can contain handling instructions.

Example: “Route pricing questions to Finance if discount requested.”

Message Below Product Table (Admin)

Appears after product list in admin emails; ideal for workflow reminders or ticket references.

Example: “Log this enquiry in CRM within 4 hours.”

Message Below Customer Details (Admin)

Displays beneath the customer info block in admin emails—useful for internal escalation or verification steps.

Example: “Verify VAT number before sending quote.”

Email Background Color

Hex color for the overall email body background (outside tables). Affects visual contrast and brand alignment.

Example: #FFFFFF for white background.

Email Text Color

Default font color used for most body text. Ensure adequate contrast versus background.

Example: #000000 for standard black text.

Email Link Color

Color applied to anchor links inside emails. Should be distinguishable and accessible.

Example: #0000FF classic blue links.

Product Table Header Background

Background color for header row cells of the product table, improving column label visibility.

Example: #CCCCCC light gray header.

Product Table Cell Background

Background color for product data rows to set contrast from page background or alternate sections.

Example: #EEEEEE subtle row fill.

Product Table Border Color

Color for bottom borders separating product rows, aiding readability.

Example: #CCCCCC light dividing lines.

Customer Table Header Background

Background color for header cells in the customer information table.

Example: #CCCCCC for consistent neutral header.

Customer Table Cell Background

Background color for customer detail data cells.

Example: #EEEEEE soft gray cell fill.

Customer Table Border Color

Color of horizontal borders between customer info rows.

Example: #CCCCCC matching product table borders.

Terms & Conditions

Enable Terms & Conditions Checkbox

Adds a Terms & Conditions (T&C) agreement checkbox to the enquiry form. When enabled, users see a checkbox below the enquiry fields and can optionally (or mandatorily, depending on the required setting) confirm acceptance before submitting their enquiry for multiple products.

Example: Enable this to show a checkbox: “I agree to the Terms & Conditions” before the enquiry submit button.

Make Terms & Conditions Required

Forces the user to check the T&C checkbox before the enquiry form can be submitted. Useful for legal compliance or to ensure users acknowledge policies such as returns or quote validity.

Example: If a user forgets to tick it, form shows an error: “Please accept the Terms & Conditions.”

Terms & Conditions Text

Defines the text (with allowed HTML) displayed next to the checkbox. You can insert links to your full Terms page or add brief policy notes. Stored with safe HTML filtering.

Example: We accept Terms & Conditions and confirm our enquiry is genuine.

Hide Terms Agreement from Emails

When enabled, the “Terms & Conditions accepted” line is omitted from admin and/or notification emails, keeping emails focused on enquiry content only.

Example: Enable this if you already log acceptance elsewhere and want cleaner notification emails.

Form Maker

The Form Maker page lets you create and manage the enquiry form used in the product enquiry feature of the plugin.
It works through a click-to-add interface where you choose the type of field you want, configure its details, and save it.

Default Fields

• Name and Email are mandatory and always present in the form.
• All other fields are optional — you can add, enable, disable, or delete them at any time.

Field Type Buttons (Top Bar)

Click a button to add a new field of that type:

• Add text field – Single-line input for short text.
• Add textarea – Multi-line box for longer responses.
• Add radio button – Single-choice selection from multiple options.
• Add checkbox – Multiple-choice selection.
• Add dropdown – Drop-down list of predefined options.
• Add image uploader – Lets the user upload an image.
• Add date field – Date selector.
• Add time field – Time selector.
• Add date time field – Combined date and time selector.

Form Fields Table

Each added field appears in the table below, where you can configure:

Reset Form Fields Button

• Reset Form Fields – Restores the form to its default state.

Usage Tips

• Adding Fields: Click the desired field type button, set its label, placeholder, and options, then save it.
• Reordering Fields: Change the Order number to control the display order.
• Making Fields Mandatory: Toggle Required so the user must fill it in before submission.
• Temporary Disabling: Use Enable toggle instead of deleting a field if you might reuse it later.
• Testing: After making changes, check the enquiry form on the front end to ensure everything works as intended.

Import/Export Settings

This allows you to import or export the plugin setting.

Telegram alert

Telegram bot token

This token uniquely identifies your Telegram bot and authorizes the plugin to send enquiry alerts through that bot. You obtain it from BotFather when creating a bot. The plugin uses this token to call the Telegram Bot API and post messages containing enquiry details to the destinations you configure. Keep it secret (treat like a password); anyone with the token can send messages as your bot. If you rotate or regenerate the token in BotFather you must update it here or alerts will stop.

Example: 1234567890:AAHjd8sdasdadsaQwrtyuOPqweRTYu-iKLMno

Example: @myshopalerts,-1001934567789,@team_sales

rajeshsingh520: #file:documentation.prompt.md

GitHub Copilot:

Telegram bot token

This token uniquely identifies your Telegram bot and authorizes the plugin to send enquiry alerts through that bot. You obtain it from BotFather when creating a bot. The plugin uses this token to call the Telegram Bot API and post messages containing enquiry details to the destinations you configure. Keep it secret (treat like a password); anyone with the token can send messages as your bot. If you rotate or regenerate the token in BotFather you must update it here or alerts will stop.

Example: 1234567890:AAHjd8sdasdadsaQwrtyuOPqweRTYu-iKLMno

Telegram Channel or Group ids

Comma‑separated list of Telegram chat identifiers (channel usernames prefixed with @ or numeric group/channel IDs) where enquiry alerts should be delivered. For groups, add the bot to the group. For channels, make the bot an admin so it can post. The plugin will iterate through each ID and send the same enquiry notification message. Use numeric IDs (often start with -100 for supergroups/channels) if username posting fails. Remove any spaces; do not include invite links.

Example: @myshopalerts,-1001934567789,@team_sales

Telegram Channel or Group ids

Single Telegram chat identifier (either a channel username starting with @, or a numeric group / channel ID) where enquiry alerts will be delivered. Only ONE value is supported (no commas). For a group, add the bot to the group. For a channel, promote the bot to admin so it can post. Use the numeric ID (often begins with -100 for supergroups/channels) if the @username does not work. Do not paste invite links or multiple IDs.

Example: -1001934567789

Enquiry Option Settings

Following options are present in the product:

Disable Enquiry

Controls whether the enquiry button is available for this product.
Options:

• Follow Global Setting – Uses the setting defined in the plugin’s global configuration.
• Disable Enquiry – Hides the enquiry button for this product, regardless of global settings.
• Enable Enquiry – Shows the enquiry button for this product, even if the global setting disables it.

Disable Add to Cart

Controls whether the “Add to Cart” option is available for this product.
Options:

• Follow Global Setting – Uses the global configuration for Add to Cart visibility.
• Disable Add to Cart – Prevents customers from adding this product to their cart.
• Show Add to Cart – Always displays the Add to Cart button for this product, regardless of global settings.

Hide Price

Controls whether the product price is visible to customers.
Options:

• Follow Global Setting – Uses the plugin’s global price visibility setting.
• Don’t Hide – Always displays the product price.
• Hide for All – Hides the price for all visitors.
• Hide for Non-Logged In – Hides the price for visitors who are not logged into their account.
• Hide if Enquiry is Enabled for Product – Hides the price only when the enquiry option is enabled for this product.

Product Manager Email IDs

Allows you to assign one or more product manager email addresses.

• Enter email addresses separated by a comma (,).
• These emails will receive enquiry notifications for this specific product.