Inputo - Name Your Price for WooCommerce Free documentation

Inputo turns a WooCommerce product into a pay what you want product. You decide the lowest amount you accept and the amount you suggest, and your customers choose what they pay. It suits digital downloads, donations, courses, artwork, tickets, tips and anything else where a flexible price makes sense.

Every named price product has a price guide with four amounts: a minimum, a suggested, a generous and an optional maximum price. You can type them on each product, or let Inputo work them out from the regular price using shop wide percentages. As the customer types, a price meter fills and shows a short thank you message at three levels you name yourself: low, fair and generous.

Named prices work on simple products and on individual variations of variable products. The amount is checked in the browser and again on the server before checkout, so a named price product can never reach an order without a valid amount. The plugin works with the block and classic cart and checkout, and with High Performance Order Storage.

Inputo is a free plugin on WordPress.org. It needs WooCommerce, so install and activate WooCommerce first.

Go to Inputo > General to decide how much customers can pay and how the price box behaves. A Live preview on the right shows a sample product with the price box. Try typing a price there: changes appear at once and reach your shop when you click Save changes.

Price guide

When a product has no amounts of its own, they are worked out from its regular price using these percentages. A product with a regular price of 20 and a suggested price of 100 percent suggests 20.

• Minimum price: the lowest amount a customer can pay. Use 0 to let customers take the product for free.
• Suggested price: the amount you recommend. It is shown as a hint and marks the middle of the price meter.
• Generous price: amounts at or above this level are thanked as generous.
• Maximum price: the highest amount allowed. Use 0 for no upper limit.

Amounts that do not make sense are tidied: the suggested amount is never below the minimum, the generous amount is never below the suggestion, and nothing is above the maximum. A maximum lower than the minimum is ignored.

Price box behaviour

• Starting value: what the price field contains when the page loads. Choose between an empty field with the suggested price as a hint, the suggested price, or the minimum price.
• Plus and minus buttons: shows buttons on either side of the field that nudge the price up or down.
• Button step: how much each press of plus or minus adds or takes away, in your store currency.

Cart and orders

• Show the chosen price in the cart: adds a line under the item in the cart and checkout confirming the price the customer chose.

Advanced

• Remove data when deleted: when the plugin is deleted from the Plugins screen, also delete its settings and product amounts. Leave this off if you might reinstall Inputo later.

Go to Inputo > Display to choose how named price products look on the product page and in your shop. The Live preview updates as you change the settings.

Product page

• Price under the title: what replaces the usual price near the product title. Options are The suggested price, From the minimum price, The regular price, unchanged and Nothing, hide the price.
• Price box style: Card stands out on the page. Minimal blends in with the theme.
• Accent colour: used for the field outline, the meter and the buttons. Click Select Color to pick one.
• Add to cart button text: the button under the price box on named price product pages. Leave it empty to keep your theme's wording.
• Show the suggested price: a line above the field with the amount you recommend.
• Show the minimum and maximum: a small line under the field so customers know the limits before they type.
• Show the price meter: a bar that fills as the price rises and thanks the customer at each level.

Shop, category and search pages

• Price in product lists: what shows as the price on shop, category, search and related product lists. It uses the same four options as Price under the title.
• Button text: the button in product lists. It opens the product page, where the customer chooses a price.

Go to Inputo > Text and messages to edit every word the customer sees. Use {price}, {min} and {max} where noted, and they are replaced with the formatted amount.

Labels

• Field label: the heading above the price field.
• Suggested price line: use {price} for the suggested amount.
• From line: used when the price display is set to show the minimum. Use {price} for the amount.
• Minimum hint: shown under the field. Use {price} for the minimum.
• Maximum hint: shown under the field when a maximum is set. Use {price} for the maximum.
• Cart line label: the label for the chosen price under the item in the cart.

Price meter

Low runs from the minimum to the suggested price, fair from the suggested to the generous price, and generous is anything above that. You can rename each level with Low level name, Fair level name and Generous level name, and set the message shown at each level. The low level message is shown while the price is below the suggestion, so keep it warm. Leave it empty to show nothing.

Error messages

These appear when the amount is missing, is not a number, is below the minimum (use {min}) or is above the maximum (use {max}). The product is not added to the cart until the amount is valid.

Go to Inputo > Documentation for a guide inside the plugin. It explains every option with examples, so you do not have to leave your site to find out what a setting does.

Use Search the documentation or the topic list on the left to jump to a topic, for example Getting started, How the price guide works, Variable products, What your customers see, Cart, checkout and orders, Tax, the settings of each screen, Changing the look, For developers and Troubleshooting.

Shop wide settings live under Inputo in the sidebar. Each product also has its own amounts on its Name your price tab, and those always win over the shop wide percentages.

1. Go to Products and edit a simple product, or create one.
2. In the Product data box, open the Name your price tab.
3. Switch on Name your price.
4. Leave the amounts empty to use your default percentages, or type your own minimum, suggested and generous amounts.
5. Update the product and view it. The price box appears above the Add to cart button.

Products with no regular price

A named price product does not need a regular price. Without one, type the amounts on the product itself. If the minimum is also empty, any amount above zero is accepted.

Letting people pay nothing

Type 0 as the minimum on the product, or set the Minimum price percentage on Inputo > General to 0. Only a minimum of exactly zero allows a free order line, so an empty field never does by accident.

Finding named price products

In the admin product list, named price products are marked, and you can filter the list to named price or fixed price products.

You switch named prices on per variation.

1. Edit the variable product and open the Variations tab.
2. Expand a variation and tick Name your price in its header, next to Enabled and Virtual.
3. Optionally type amounts in the Name your price fields under the pricing fields.
4. Click Save changes.

Some variations can have a named price while others keep a fixed price. The price box appears only when the customer picks a named price variation. With a mix, the product keeps the usual price range in lists.

The amount the customer chooses becomes the unit price in the cart, so quantity, coupons, tax and shipping all work as usual. Two different amounts for the same product become two cart lines.

• The chosen amount is applied to the cart on the server, which both the block and the classic cart and checkout use.
• The amount is checked when the product is added to the cart, every time the cart is checked, and before checkout, including for the block checkout and the Store API.
• When Show the chosen price in the cart is on, a line under the item confirms the price the customer chose. You can rename it with Cart line label.
• The named price and the suggested price at the time are recorded on every order line and shown on the order screen.
• Order again brings back the same amount.

Tax

The customer types an amount the way your shop shows prices. If your shop shows prices including tax, the typed amount includes tax too, even when you enter product prices without tax. The limits follow the same rule.

Start with the Price box style and Accent colour on Inputo > Display. For more control:

• Use the CSS custom properties on .inputo-nyp in your theme's CSS.
• Copy templates/price-input.php from the plugin to yourtheme/inputo/price-input.php and edit the copy.

On a named price product page, shoppers see a price box above the Add to cart button. It contains:

• A field for the amount with the currency symbol, and optional plus and minus buttons.
• The suggested amount and the minimum and maximum limits, when you choose to show them.
• The price meter, a bar that fills as the amount grows, with three levels (low, fair and generous), each with its own name and message. It appears only for products with a suggested amount.

Customers can type any number format, for example 12.50, 12,50 or 1.250,00. If the amount is missing, unreadable, too low or too high, the box says so in plain words and the product is not added. The same message appears if the browser check is bypassed, because the server checks again.

On shop, category and search pages, a named price product shows the price wording you chose on the Display screen. Its button opens the product page, because the customer still needs to choose a price.

The price box is accessible: the field has a real label, the limits and messages are linked to it for screen readers, messages are announced as they change, the arrow keys nudge the amount, and animation stops when the visitor prefers reduced motion.