Inputo - Name Your Price for WooCommerce documentation

Inputo adds pay what you want pricing to WooCommerce. On a named price product, shoppers see a price box instead of a fixed price. They can type their own amount, nudge it with plus and minus buttons, tap a quick amount or drag a slider. A price meter shows whether the amount is low, fair or generous. Inputo checks the amount against your limits in the browser and again on the server before payment.

You decide the lowest amount you accept, the amount you suggest, when a price counts as generous and, if you want, a maximum. You can type these amounts on each product or let Inputo work them out from the product's regular price using shop-wide percentages. Named prices work for simple products and for individual variations of variable products.

Inputo Pro includes everything in the free edition. It adds quick amount buttons, a price slider, rules for whole categories or tags, access by customer role, per product wording, celebration effects, a line showing what others paid, reports with CSV export, settings import and export, and bulk actions in the product list. It is a complete plugin on its own, so you do not need the free edition installed.

Inputo Pro needs WooCommerce. Install and activate WooCommerce first. You do not need the free edition of Inputo. If the free edition is active when you activate Pro, it is switched off automatically and your products and settings are kept.

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>.

Each product has its own Name your price tab in the Product data box. Switch on Name your price there to turn the product into a named price product. Amounts you type on the product always win over the shop-wide percentages and over rules.

Variable products. Named price is switched 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. Save changes.

You can mix named and fixed prices. 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.

Per product choices. Each product can use a different input style on its own Name your price tab. With Pro you can also change the label, the suggested line and the meter messages for a single product.

In the product list. You can filter the admin product list to named price or fixed price products. Pro adds bulk actions to switch named price on or off for many products at once.

Inputo > General decides how much customers can pay and how the price box behaves. A Live preview on the right shows a sample product and updates as you change settings. Changes 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. For example, with a regular price of 20, a minimum of 50, a suggested price of 100 and a generous price of 150 percent, the product accepts anything from 10, suggests 20 and calls 30 or more generous.

• Minimum price: the lowest amount a customer can pay. Use 0 to let customers take the product for free. Only a minimum of exactly zero allows a free order line, so an empty field never does this by accident.
• Suggested price: 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.

A product with no regular price still works as a named price product. Type the amounts on the product itself. If the minimum is also empty, any amount above zero is accepted.

Price box behaviour. Choose what the price field contains when the page loads, turn the plus and minus buttons on or off, and set how much each press adds or takes away.

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. Turn on Remove data when deleted only if you want the plugin's settings and product amounts removed when you delete the plugin from the Plugins 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.

Input style. How customers choose sets the shop-wide style. Each product can choose differently on its own Name your price tab.

Quick amount buttons. In Amounts, separate values with commas. A number with a percent sign is a share of the suggested price, for example 80%, 100%, 150%. A plain number is a fixed amount, for example 5, 10, 25. Buttons that do not fit within the product's limits are left out. Suggested button caption is the small word under the button that matches the suggested price. Leave it empty for none.

Price slider. The slider takes the place of the price meter track, so its low, fair and generous zones line up exactly with the meter levels. Slider reaches sets how far the slider goes, as a share of the suggested price, when a product has no maximum.

Inputo > Display controls how named price products look on the product page and in your shop.

Product page

• Price under the title: what replaces the usual price near the product title. Choose the suggested price, a "from" line with the minimum price, the regular price unchanged, or nothing.
• 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.
• 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, Show the minimum and maximum and Show the price meter: turn each part of the price box on or off.

Shop, category and search pages

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

Inputo > Text and messages holds every word the customer sees. Use {price}, {min} and {max} where the screen notes it, and they are replaced with the formatted amount.

Labels. The heading above the price field, the suggested price line, the "from" line used when the price display is set to show the minimum, the minimum and maximum hints under the field, and 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. Name each level and write a message for it. The meter appears only for products with a suggested amount. Leave the low level message empty to show nothing.

Error messages. Shown when the amount is missing, is not a number, is below the minimum or is above the maximum. The product is not added to the cart until the amount is fixed. The same message appears if the browser check is bypassed, because the server checks again.

To change the wording on a single product, use that product's Name your price tab.

Inputo > Rules switches named price on for whole categories or tags at once, for example a Donations or Digital downloads category. Each rule has its own percentages.

1. Click Add a rule.
2. Choose the categories or tags the rule reaches and set its percentages.
3. Add more rules if you need them and arrange them in the order you want.
4. Click Save rules.

Rules are checked from the top and the first active match wins. A rule switches named price on and sets the percentages used for empty amounts. Any amount typed on a product still wins over a rule.

Inputo > Access chooses who may name their own price. Everyone else sees the product as a normal product.

• Available to: Everyone, Logged in customers or Customers with chosen roles. Customers outside this group cannot name a price.
• Message on the product page: shown to customers who cannot name a price, under the add to cart area. Leave it empty to show nothing.
• Add a log in link: offers visitors who are not logged in a link to log in and come back.

If you use page caching, read the Page caching topic under Access by customer in Inputo > Documentation.

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

Celebration. Choose the level at which the price box celebrates: never, at generous, or at fair or generous. It celebrates once, the moment the amount reaches that level. You can show a short burst of confetti in your accent colour, a thank you badge that pops up on the price box, or both, and set the badge text. The effects are drawn locally, and nothing is loaded from other servers.

What others paid. Show the average paid adds a line under the field with the average amount real customers paid. The figure comes from paid orders in the report data. It appears only once a product has enough paid orders, never fewer than three.

Inputo > Reports shows how named price products are doing. Pick a period at the top: Last 7 days, Last 30 days, Last 90 days, Last 12 months or All time.

The report covers orders, takings, the average named price, how customers compare with your suggestion, a chart over time and the top products. Click Download CSV to export the figures.

A line is recorded when an order with a named price is paid. Orders placed before Pro was installed can be added from Inputo > Tools with Rebuild now. The report data is stored in a table in your own database and contains order and product numbers and amounts, never names or addresses.

Inputo > Tools has three tools.

• Export settings: click Download settings file to save every setting and rule to a small file. Keep it as a backup or copy it to another shop.
• Import settings: choose an exported file and click Import. This replaces the settings and rules on this shop with those in the file. Product amounts are not changed.
• Rebuild report data: click Rebuild now to read every paid order again and rewrite the report data. The card shows how many lines the report holds. Run it once after installing Pro.

Inputo > Documentation explains every option in the plugin, with examples, so you do not have to leave your site. Use Search the documentation or the topic list on the left. Topics include getting started, how the price guide works, variable products, what your customers see, cart, checkout and orders, tax, quick amounts and the slider, rules, access by customer, wording for one product, celebration and what others paid, reports, tools and bulk actions, a reference for each settings screen, and troubleshooting.

On a named price product page, shoppers see the price box above the Add to cart button. Depending on your settings it contains:

• the price line under the product title, such as the suggested price
• the Name your price label and quick amount buttons, with the suggested amount highlighted
• the price field with your currency symbol and plus and minus buttons
• the minimum and maximum hints
• the price meter or the slider, with low, fair and generous zones, and the message for the current level

Shoppers 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 to the cart. The field has a real label, messages are announced to screen readers as they change, the arrow keys nudge the amount, and animation stops when the visitor prefers reduced motion.

The chosen amount becomes the unit price in the cart, so quantity, coupons, tax and shipping work as usual. Two different amounts for the same product become two cart lines. The block and classic cart and checkout are both supported.

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.