Skip to main content
Print

The quote list

This article explains how shoppers collect products in a quote list and send it to you as a quote request.

The Add to quote button

An Add to quote button appears on product pages, alongside Add to cart or in its place, and in your shop's product grids, including the Product Collection block. Which products show it, and whether they can still be bought, is set by the rules described in Choosing which products can be quoted.

  • On a product page, the button adds the quantity the shopper chose. For a product with options, such as sizes, the shopper chooses them first; until they do, the button asks for them.
  • A simple product without a price, which WooCommerce does not let shoppers buy, gets the button with a quantity field of its own. A product with options needs prices on its options for its page to show them; when its price is hidden, shoppers never see those prices.
  • In a product grid, the button adds one of the product. A product with options shows its usual link to its page, where the options are chosen.
  • Grouped and external products, and products that are out of stock, show no button.
  • If your product pages use WooCommerce's Add to Cart with Options block, the button appears just after that block, for simple products only.

After a click, a line under the button says "Added to your quote list." with a link to the list.

The quote list page

When you activate the plugin, it creates a page called Quote list with the Quote list block. To use another page, add the Quote list block to it, or the [hraq_quote_list] shortcode, and choose it as Quote list page under WooCommerce > Settings > Quotes.

The page shows each product in the list with its price, or "Price on request" when its price is hidden, a quantity field and a Remove button. If a product can no longer be quoted, for example because you changed its rule, it is taken off the list with a message. Below the list, a form asks for:

  • first name, last name and email address;
  • phone and company, both optional;
  • a delivery address, so you can price shipping and tax; see Address below;
  • an optional message.

The shopper clicks Send quote request and sees "Thank you. Your quote request #123 has been sent." with the email address the quote will go to. Their list is then emptied.

The list is kept in the shopper's browser until they send it, so it stays on that device and that browser. The plugin sets no cookie and starts no session while shoppers browse, so page caching keeps working on every page, the quote list page included.

Address

Under WooCommerce > Settings > Quotes > Address you choose when the form asks for a delivery address:

  • Ask for it when a product needs shipping (the default): required when the list holds a product that is shipped, and not asked for otherwise.
  • Always ask for it.
  • Ask for it, but let shoppers leave it out.
  • Do not ask for it.

What you get

Each request becomes an order in Quote requested, and you get the New quote request email, as for a request made at checkout (see Requesting a quote at checkout). The shopper gets the Quote request received email.

A product whose price is hidden is added to the request at no price, so no page or email shows its price to the shopper. Under that line, the order screen shows staff its catalogue price when the request was made. The Quote box warns you that a product is priced at zero until you set its price.

Spam protection

The form needs no outside service. It refuses a request:

  • when a field that people never see is filled in, as bots do;
  • when it is sent less than three seconds after the page opened, or more than two hours later; the shopper is asked to reload the page;
  • when the same internet connection has already sent more requests this hour than Requests per hour allows (5 by default, 0 for no limit);
  • when the same email address has already been given in three requests this hour, so that nobody can use the form to fill a stranger's inbox;
  • when the whole store has already received 100 requests this hour.

The connection is the address your web server sees. If your site is behind a proxy or a CDN, every visitor may seem to come from the same address; a developer can then pass the visitor's real address through the hraq_client_ip filter. The hraq_email_hourly_limit and hraq_site_hourly_limit filters change the other two limits.

To accept requests only from logged-in customers, tick Only logged-in customers can send the quote form. A captcha plugin can add its own check through the hraq_validate_request filter.

Table of Contents