Inputo - Name Your Price for WooCommerce documentation

Inputo adds a Name your price box to your WooCommerce products. Instead of a fixed price, the customer types the amount they want to pay. You set the lowest amount you accept, the amount you suggest, the point where a price counts as generous and, if you like, an upper limit. A price meter fills up as the amount grows and thanks the customer at each level. Every amount is checked in the browser and again on the server before it reaches the cart.

The Pro edition includes everything in the free edition and adds quick amount buttons and a price slider, rules that switch named prices on for whole categories or tags (with optional dates), start and end dates for single products, access by customer role, wording per product, confetti and a thank you badge for generous amounts, an "average paid" line, reports with CSV export, settings import and export, and bulk actions. It also supports WooCommerce Subscriptions, grouped products and the currency switchers WPML WooCommerce Multilingual, Aelia Currency Switcher, CURCY and WOOCS. A shortcode and a block place a complete price box on any page, for example a donation page.

Inputo is for shops that sell on a pay what you want basis: donations, digital downloads, community products, pay what you can events or supporter pricing.

Inputo Pro needs WooCommerce, so install and activate WooCommerce first. Pro is a complete plugin on its own: you do not need the free edition. If the free edition is already active, it stays idle while Pro runs, and all your products and settings carry on as they were.

Inputo works fully as soon as it is activated. The license key turns on automatic updates, so new versions arrive in WordPress like any other plugin update. Pro features never depend on it.

Once the license is active, new versions of Inputo show up under Dashboard > Updates and on the Plugins screen. Click Update now, or click Enable auto-updates in the Inputo row on the Plugins screen and WordPress installs every future release for you.

• Keys are checked once a day in the background, so your site never waits for the license server. If the server is briefly unreachable, the plugin keeps its last known status.
• An expired key or a key that is not accepted only stops updates. Inputo keeps working. After renewing, click Check now in its row.
• Moving to a new domain: click Deactivate on the old site first, then activate the key on the new one. The status shows Site address changed, checking until the new address is confirmed.
• On the command line: wp ppl-license list, wp ppl-license activate <plugin> <key>, wp ppl-license check and wp ppl-license deactivate <plugin>.

The General screen (Inputo > General) decides how much customers can pay and how the price box behaves. Its settings apply to every named price product in your shop.

Price guide

When a product has no amounts of its own, each amount is 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. Any amount typed on the product itself always wins over the percentage.

• Minimum price: nothing lower is accepted. Use 0 to let customers take the product for free.
• Suggested price: shown as a hint and placed in the middle of the price meter.
• Generous price: from here the meter thanks the customer as generous. It never limits what a customer can pay.
• Maximum price: nothing higher is accepted. 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.

Set it up

1. Enter your four percentages under Price guide.
2. Under Price box behaviour, choose the Starting value of the price field and whether to show Plus and minus buttons. If you show them, set the Button step.
3. Under Cart and orders, decide whether to Show the chosen price in the cart.
4. Leave Remove data when deleted off unless you are removing the plugin for good.
5. Press Save changes.

The Live preview on the right shows a sample product with your settings. Try typing a price: changes appear there at once and reach your shop when you save. The status next to the save button says All changes saved or You have unsaved changes.

The Price input screen (Inputo > Price input) gives customers a faster way to choose: one tap amounts, a slider, or both. The price field is always there too, for any other amount. Each product can choose differently on its own Name your price tab.

The four choices

Quick amount buttons

Type the buttons in Amounts, separated by commas. An entry with a percent sign is a share of the suggested price, and a plain number is a fixed amount. For example, 80%, 100%, 150% with a suggested price of 20 gives buttons for 16, 20 and 30, while 5, 10, 25 always gives 5, 10 and 25. Buttons show in the order you type them, up to eight.

A button below the minimum or above the maximum is left out, and so is a duplicate. Percentage buttons need a suggested price, so a product without one only shows fixed amounts. The button that matches the suggested price carries the Suggested button caption underneath.

Price slider

The slider takes the place of the price meter track, so its low, fair and generous zones line up with the meter levels: the first 40 percent runs from the minimum to the suggested price, the next 35 percent to the generous price, and the rest beyond. Slider reaches sets how far it goes when a product has no maximum, and Slider step sets how much each move changes the amount. The slider only appears for products with a suggested price, and it stays usable with a keyboard and a screen reader.

Set it up

1. Choose an option in How customers choose. The fields for that choice appear below it.
2. Fill in the buttons or slider settings.
3. Check the Live preview and press Save changes.

The Display screen (Inputo > Display) controls how named price products look on the product page and in your shop lists.

Product page

1. Pick what shows under the product title in Price under the title: the suggested price, a "From" line with the minimum, the regular price unchanged, or nothing.
2. Choose the Price box style: Card stands out on the page, Minimal blends in with your theme.
3. Pick an Accent colour. It is used for the field outline, the meter and the buttons (and for the confetti on the Effects screen).
4. Optionally type your own Add to cart button text. Leave it empty to keep your theme's wording.
5. Switch the suggested price line, the minimum and maximum line, and the price meter on or off.

Shop, category and search pages

Choose what shows as the price in product lists in Price in product lists, and set the Button text. Named price products can never be added to the cart straight from a list, because the customer has not chosen a price yet, so this button always opens the product page.

Press Save changes when you are done.

The Text and messages screen (Inputo > Text and messages) holds every word the customer sees in the price box, the cart and the error messages. Use the placeholders where noted and they are replaced with the formatted amount:

• {price} in Suggested price line, From line, Minimum hint and Maximum hint
• {min} in Below the minimum
• {max} in Above the maximum

Price meter

The meter has three levels. Low runs from the minimum to the suggested price, fair from the suggested to the generous price, and generous is anything above that. Give each level a name and a message. Keep the low message warm: it shows while the price is below your suggestion. Leave it empty to show nothing.

Error messages

If the amount is missing, unreadable, too low or too high, the box shows one of these messages and the product is not added to the cart. The same message appears if the browser check is bypassed, because the server checks again.

You can also change the label, suggested line and meter messages on a single product, in its Pro options. Press Save changes to keep your wording.

The Rules screen (Inputo > Rules) switches named price on for whole categories or tags at once, without editing each product. Each rule can have its own percentages and its own dates.

Create a rule

1. Press Add a rule.
2. Give it a name you will recognise, such as Donations.
3. Choose categories, tags, or both. A category includes its child categories. With both, a product needs one of the categories and one of the tags. On shops with many categories or tags, the boxes search as you type.
4. Optionally set the rule's own Minimum, Suggested, Generous and Maximum percentages. Leave a percentage empty to use the one on the General screen.
5. Optionally set Starts on and Ends on, for example for a pay what you can weekend. Dates are in your site's time zone and include both days. Leave them empty to run the rule all the time.
6. Press Save rules.

Each card then shows how many published products the rule reaches (for example Reaches 2 published products.) and, when it has dates, whether they are running: Running now, inside its dates., It starts later, so it switches nothing on yet. or Its dates have passed, so it switches nothing on now.

How rules work

• A rule reaches simple products in the chosen categories, their child categories or the chosen tags, and every variation of variable products in them.
• A rule switches named price on even when the product's own switch is off.
• Rules are checked from the top, and the first active rule that matches a product decides its percentages. Use the up and down arrows on each card to change the order, and the bin icon to remove a rule.
• Any amount typed on the product itself is used instead of the rule's percentage for that amount.
• To keep one product out, tick Keep out of rules in the product's Pro options.
• A rule with no category and no tag cannot match anything, so it is not saved, and the screen tells you so.

The Access screen (Inputo > Access) decides who may name their own price. Everyone else sees the product as a normal product.

Who can name a price

Choose an option in Available to:

• Everyone: every visitor can name a price. This is the factory setting.
• Logged in customers: only visitors who are logged in.
• Customers with chosen roles: only users with one of the roles you tick in Roles, which appears when you choose this option. Use it for members only pricing, wholesale buyers or staff.

For everyone else

A product with a regular price is sold at that price as usual, and a product without one cannot be bought. Under the add to cart area (or right after the Add to Cart with Options block on block themes) they see your Message on the product page. With Add a log in link switched on, visitors who are not logged in also get a Log in link that brings them back to the product.

Admin screens, including adding an item to an order by hand, always see products as they are set up.

Page caching: when access is not set to Everyone, product pages differ between visitors. Most caching plugins already skip the cache for logged in visitors. If yours does not, exclude product pages from the cache.

Press Save changes when you are done.

The Effects screen (Inputo > Effects) adds small touches that make paying more feel good. Try them in the preview by typing a generous amount.

Celebration

When the customer's amount first reaches the level you pick in Celebrate when the price is, the box celebrates once, with Confetti in your accent colour, a short Thank you badge, or both. It does not repeat while the customer keeps typing within the same level, and it is skipped for visitors who prefer reduced motion. The effect is drawn by the plugin itself and loads nothing from other servers.

1. Choose Generous or Fair or generous (or Never to switch the celebration off; Confetti and Thank you badge are then hidden).
2. Switch Confetti and Thank you badge on or off.
3. If the badge is on, set the Badge text.

What others paid

Switch on Show the average paid to show a line under the price field with the average amount per item real customers paid for the product (or for the chosen variation). Two settings then appear:

• Average paid line: the wording, with {price} for the average.
• Show after: how many separate buyers a product needs before the line appears, never fewer than three.

The figure comes from paid orders in the report data, in the shopper's currency, with refunded items left out. Each customer account counts once however often it buys, and each guest order counts once, so the average never reveals what one customer paid.

Press Save changes when you are done.

The Reports screen (Inputo > Reports) shows what customers actually pay when they name their price.

Choose the period and currency

Pick Last 7 days, Last 30 days, Last 90 days, Last 12 months or All time at the top. Figures are shown one currency at a time. When orders came in more than one currency, a row of currency codes appears next to the periods so you can switch.

The figures

• Orders: paid orders with at least one named price line, with the number of items sold.
• Takings: named price times quantity, as the customer saw it, less partial refunds.
• Average named price: the average amount customers chose per item. Refunded items are left out.
• Against the suggestion: the named price as a share of the suggested price at the time, averaged per item.
• At or above the suggestion: the share of items, among those with a suggestion, bought at the suggested price or more.

Below them, Takings from named prices is a bar chart over the period, and Top named price products lists your best products with their Items, Takings, Average price and Against the suggestion. Click a product name to edit it.

Where the figures come from

Each order line with a named price is recorded when the order is paid (processing or completed), including orders created straight in a paid status, for example through the REST API. It is recorded again when the order is edited or partly refunded, and removed if the order is cancelled, refunded in full, failed or deleted. The report data sits in a table in your own database and holds order and product numbers and amounts, never names or addresses.

Download CSV

Download CSV exports every named price line in the chosen period, in every currency, one row per order line. The columns are Date, Order, Product, Product ID, Variation ID, Quantity, Quantity refunded, Named price, Refunded, Net takings, Suggested price and Currency.

The Tools screen (Inputo > Tools) has three tools.

Export settings

Press Download settings file to save every setting and rule to a small JSON file, to keep as a backup or to copy to another shop. Rules name their categories and tags by slug and name. Product amounts are not included, because they live on each product.

Import settings

1. Click Choose file and pick a settings file exported from Inputo.
2. Press Import.

The settings and rules on this shop are replaced by those in the file. Product amounts are not changed. Import finds this shop's categories and tags with the same slug, or else the same name. Any it cannot find are listed on the screen and left out of the rules.

Rebuild report data

Press Rebuild now to read every paid order again and rewrite the report data. The card says how many lines the report holds now. Use it once after installing Pro to include orders placed with the free edition, and once after updating to 1.4.0 so older orders are counted with their refunds. Until you do, the Reports and Tools screens remind you. On a large shop the rebuild may stop part way: press Continue to carry on from where it stopped.

The Documentation screen (Inputo > Documentation) is a guide built into the plugin. Every option is explained there, with examples, and the settings reference at the end is generated from the same list the settings screens use, so it always matches your version.

Type a word in Search the documentation to find a topic quickly. The guide covers getting started, the price guide, variable products, what customers see, cart and orders, tax, quick amounts and the slider, rules, access, wording per product, effects, dates, the price box on any page, grouped products, WooCommerce Subscriptions, currencies, reports, tools and bulk actions, and a list of hooks for developers.

Each product has its own Name your price tab in the Product data box. The tab shows for simple products, and its settings always win over the shop-wide percentages.

Simple products

1. Go to Products and edit a product, or create one.
2. In the Product data box, open the Name your price tab.
3. Switch on Name your price ("Let customers choose what they pay for this product").
4. Type a Minimum price, Suggested price, Generous price and Maximum price, or leave any of them empty to work it out from the regular price with your default percentages. The regular price may be left empty too. Without a regular price, type the amounts here; if the minimum is also empty, any amount above zero is accepted.
5. Click Update.

To let people pay nothing, type 0 as the minimum. Only a minimum of exactly zero allows a free order line, so an empty field never does by accident.

Pro options for this product

• How customers choose and Quick amounts change the input style for this product only. Leave them on Use the shop setting and empty to follow the Price input screen.
• Field label, Suggested price line and the three meter messages replace the wording from Text and messages on this product. The label and the suggested line also change the price line under the title and in product lists. For a variable product the wording applies to every variation.
• Keep out of rules stops rules from switching named price on for this product. When a rule does reach the product, the tab tells you which one.

Dates

Set Named price from and Named price until to let customers name a price only between two days, for example a pay what you can weekend. Dates are in your site's time zone and include both days. Outside those days the product sells at its regular price, or cannot be bought if it has none. A cached product page can show the price box a little after its last day, so clear the page cache when a date passes or keep product pages out of the cache.

Variable products

Edit the variable product, open the Variations tab, expand a variation and tick Name your price in its header, next to Enabled and Virtual. Optionally type amounts in the Name your price fields under the pricing fields, then 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. On block themes, the price box sits inside the Add to Cart with Options block and follows the chosen variation there too.

Bulk actions

In Products, tick several products, choose an action from Bulk actions and press Apply:

• Switch on name your price and Switch off name your price change each product's own switch. For variable products every variation is switched. When a rule would switch a product straight back on, Switch off also keeps it out of rules, and the notice says how many.
• Keep out of name your price rules and Follow name your price rules change only that setting.

The product list also has a Named price column with each product's minimum, suggested and maximum amounts, and a filter for named price or fixed price products.

The amount the customer chooses becomes the unit price of the item in the cart, so quantity, coupons, tax and shipping all work as usual. Two different amounts for the same product become two cart lines. With Show the chosen price in the cart switched on (on the General screen), a line under the item confirms the price, labelled with your Cart line label.

Both the block cart and checkout and the classic shortcode pages are supported, as is High Performance Order Storage. Every time the cart is checked, each named price item is checked again against the product's current limits, and a change to rules or access applies to carts that already hold the product.

Because coupons work as usual, a coupon can take a line below the minimum. Leave named price products out of a coupon if that matters to you.

On the order

Each order line records the amount the customer chose and the suggestion at that moment. You see both on the order screen under the item, for example "Price named by the customer: ..., suggested ...". Ordering again from the account page brings back the same amount.

Tax

The amount a customer types is read the way your shop shows prices. If your shop shows prices including tax, the typed amount includes tax too. The line in the cart then matches what the customer typed. Your minimum, suggested, generous and maximum amounts are entered like any product price.

Pro can place a complete name your price form on any page, for example a landing or donation page.

Shortcode

Add [inputo_price_box id="123"] to a page, with the id of a simple product, or of one variation, that takes a named price. Optional attributes:

• button="Donate now" sets the button text.
• title="yes" shows the product name above the box.
• quantity="yes" shows a quantity field.

Example: [inputo_price_box id="123" button="Give now" title="yes"]

Block

In the block editor, add the Name your price box block from the WooCommerce group and enter the product or variation id in the block settings. You can also set the button text and show the title and a quantity field. The block shows the same form as the shortcode.

What happens on submit

The amount is checked exactly as on the product page and the product is added to the cart. The confirmation, or the reason it was refused, appears right above the box. A variable product needs the id of one variation with every attribute set. When a box cannot show, editors see a short note explaining why; visitors see nothing. Visitors who may not name a price (see Access) see your access message instead.

WooCommerce Subscriptions

With WooCommerce Subscriptions active, simple subscriptions and variations of variable subscriptions can take a named price, switched on and set up the same way as other products. The amount the customer chooses is charged at sign-up and again at every renewal. The billing period, length, free trial and sign-up fee stay as set on the subscription product: customers choose the amount, not the period. The price box tells the customer how often the price is charged ("Your price is charged every ...") and whether a sign-up fee is added to the first payment.

Several currencies

With WPML WooCommerce Multilingual, Aelia Currency Switcher, CURCY or WOOCS, the minimum, suggested, generous and maximum amounts are shown in the shopper's currency, and the amount the shopper types is charged once, in that currency. The order and the report record the order's own currency. A developer can add any other switcher with the inputo_nyp_currency_rate filter.

Grouped products

Each named price item of a grouped product gets its own price box next to its quantity, in the classic grouped form and in the Add to Cart with Options block. Only items with a quantity above zero need a price, and each is checked on its own.

On a named price product page, the usual price near the title is replaced by the wording you chose on the Display screen, for example the suggested price line. Above the Add to cart button, shoppers see the price box:

• the Field label and, depending on How customers choose, quick amount buttons with the suggested one marked
• the price field with the currency symbol, and plus and minus buttons if switched on
• the minimum and maximum hints
• the price meter (or the slider on it) with the Low, Fair and Generous levels and the message for the current level
• the average paid line, when switched on and the product has enough buyers

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 explains why in plain words and the product is not added. When the amount reaches your celebration level, confetti and a thank you badge appear once.

The box is keyboard and screen reader friendly: the field has a real label, messages are announced as they change, the arrow keys nudge the amount, and animation stops for visitors who prefer reduced motion.

In shop, category and search lists, named price products show your list price wording and a button (by default Name your price) that opens the product page. Visitors who may not name a price (see Access) see a normal product with your message and an optional log in link.