Everything you need to set up Aluleth Product Options, the plugin that adds extra fields and paid options to your WooCommerce and FluentCart products: texts, choices, swatches, file uploads, conditional logic and a live price total. Want to see it first? Open the démo en ligne.
Contents
- Prérequis
- Installation
- Licence and updates
- Your first option group
- Types de champs
- Prix
- Logique conditionnelle
- File uploads
- Where the options appear
- WooCommerce
- FluentCart
- Settings
- Langues
- Uninstalling
- Troubleshooting
Prérequis
- WordPress 6.5 or newer and PHP 7.4 or newer.
- WooCommerce 8.0 or newer, or FluentCart 2.2 or newer. Both can be active on the same site.
Installation
- In WordPress, go to Plugins › Add New › Upload Plugin, choose the zip you downloaded, then click Install Now and Activate.
- Check that WooCommerce or FluentCart is active. Without one of them, the plugin shows a notice and adds nothing to your products.
- A new Product Options menu appears in the admin, with Option groups, Add new and Settings.
Upload the zip itself, not a folder from inside it. If WordPress says the file is too large, ask your host to raise the upload limit or upload the aluleth-product-options folder to wp-content/plugins by FTP.
Licence and updates
Bought on the Aluleth Market? Your licence key is in your account and in the order email. Go to Product Options › Licence, paste the key and click Activate: updates then appear in Dashboard › Updates like any other plugin. A Single site licence works on one site, a 10 sites licence on ten. To move a licence, click Deactivate on the old site first.
Copies bought on a marketplace have no licence screen: updates are downloaded from the marketplace where you bought the plugin. After the update period, the plugin keeps working; you only need a new licence for new versions and support.
Your first option group
An option group is a set of fields, such as an engraving text, a gift wrap box or a file to upload, shown on the products you choose.
- Go to Product Options › Add new and give the group a name, for example “Engraving”. Customers do not see this name.
- Pick a field type under Add a field. Open the field to set its label, help text, price and limits. Drag fields with the handle to change their order.
- Under Where to show it, choose Tous les produits, or Chosen products and categories. You can also list products to leave out under Except these products.
- Click Save, then open one of the products on your site: the fields appear above the Add to cart button.
When several groups apply to the same product, the Order on the page number decides which group comes first (lower numbers first). In Option groups you can duplicate, turn off or delete a group. A copy gets its own field IDs, so the copy and the original can be on the same product. With WooCommerce you can also turn the options off for one product in its Advanced tab.
Types de champs
| Field | Use it for |
|---|---|
| Short text | A name, an engraving, a short message. Limits: fewest and most characters. |
| Long text | Instructions or a longer message. |
| Number | A quantity, a size, a length. Limits: lowest and highest number, step. |
| Date | A delivery or event date. |
| File upload | A logo, a photo, a document to print. See File uploads. |
| Dropdown | One choice in a compact list. |
| One choice | Radio buttons. |
| Several choices | Checkboxes. Limits: fewest and most choices. |
| Buttons | One choice shown as buttons (or several, with “Customer can pick several”). |
| Colour swatches | Colours shown as dots: one choice, or several with “Customer can pick several”. |
| Image swatches | Small pictures: one choice, or several with “Customer can pick several”. |
| Yes / no box | A single checkbox, such as “Add gift wrapping”. |
| Heading | A title to split a long group into parts. |
| Text | A short explanation. Simple HTML such as links and bold text is allowed. |
Every field has a label, a help text shown under it, a Required switch and, under Advanced, a half-width layout (two fields side by side) and a CSS class. For lists, use Add several at once to paste one choice per line, with a price after a | sign, for example Gold | 5.
Prix
| Price type | How it is counted |
|---|---|
| Fixed amount | The amount is added when the customer fills in the field or ticks the box. |
| Percentage of the product price | A percentage of the product (or variation) price. |
| Price per character | The amount × the number of characters typed (spaces not counted). |
| Price per unit | The number typed × the amount (Number fields). |
| Price per choice | Each choice of a list has its own price, fixed or in percent. |
- For each item: the price is multiplied by the quantity. Once per order line: charged once, whatever the quantity – use it for set-up fees such as a print plate or a design check.
- A negative number gives a discount. With FluentCart, a discount charged once per order line is not possible (FluentCart cannot take it off exactly): it is not offered on FluentCart products, and the editor shows a warning next to the setting. Charge it for each item, or use a FluentCart coupon.
- Option prices are added to the product price and taxed like the product, with your store’s tax settings.
- Under the fields, a small box shows the product price, the options and the total. It follows the quantity and the chosen variation. You can turn it off, or hide it while the chosen options are free, in Settings.
Logique conditionnelle
Open a field, turn Conditions on and choose Show this field only when…. Each rule compares an earlier field with a value: is, is not, contains, does not contain, is empty, is filled in, more than, less than. Choose whether all these rules or any of these rules must be true. Text rules ignore upper and lower case, accented letters included (É matches é), but not accents themselves (é does not match e).
What customers type is kept exactly as typed: text that looks like HTML (such as <b> or &), percent signs, repeated spaces, backslashes, any language and emoji. The product page and the server only remove spaces at both ends, invisible control characters, and line breaks in one-line fields, the same way, so the conditions, the price and the saved answer always agree; the field shows the answer that will be ordered. Answers are always shown as plain text, in the cart, the order, the emails and the admin.
A field can only depend on the fields above it. If you move a field (with the arrows or by dragging) above a field its condition uses, the move is not made and a message tells you which field has to stay above. Hidden fields are never charged and never required, and the rules are checked again on the server, the same way as on the page, when the product is added to the cart.
An option group saved with an earlier version may have a condition above the field it uses. Its fields show Check the condition, a list above the fields says how to correct the order, and the group can be saved once the order works. Until then, that condition counts the field below it as empty, on the page and on the server.
File uploads
- Customers choose their file on the product page; it is uploaded before the product goes into the cart.
- Set the largest file and the accepted file types in Settings › File uploads. Each file field can have its own size and list of extensions.
- Files are kept in
wp-content/uploads/alpo-uploads, each in a folder with a random name. Each file is saved under a random name and cannot be opened from its address, on any server (Apache, LiteSpeed, Nginx, IIS): there is no rule to ask your host for. Files uploaded before version 1.0.5 are protected the same way automatically after the update. - Shop managers download the files from the order (WooCommerce order screen, FluentCart order activity).
- Files that never reach an order are deleted after two days. Remove next to an uploaded file deletes it at once.
- If a file in the cart is removed or deleted before the order, the cart and the checkout say so and stop the order. The Upload it again link opens the product page with the other answers filled in; the new file replaces the product in the cart and keeps its quantity.
- To protect your server, uploads made before an order are limited: a guest can send 20 files per hour and keep up to 100 MB waiting for an order (50 files and 200 MB for signed-in customers), and all waiting files together are limited to 2 GB. Files in an order do not count. Customers see a clear message when they reach a limit. Developers can change the limits with the
alpo_upload_limitsfilter.
Where the options appear
The chosen options and their prices follow the product everywhere: cart, checkout, order screen, order emails and the customer’s account. With Prices next to options on, each line shows its price, like “(+$5.00)”. Orders always keep the options the customer chose, even if you change or delete the group later.
WooCommerce
- Simple and variable products. With a variable product, the total follows the chosen variation.
- Classic cart and checkout, Cart and Checkout blocks and the Store API.
- Compatible with high-performance order storage (HPOS).
- Products with a required option or a file upload show Select options in product lists and open the product page. Change this text in Settings.
- “Order again” keeps the options. Each set of options is its own cart line.
FluentCart
- The fields appear above the Buy now and Add to cart buttons.
- Options and prices are shown in the cart drawer, the cart page, the checkout summary, the receipt and the emails. Buy now works with the options.
- Uploaded files are linked in the order activity.
- FluentCart keeps one cart line per product variation. The same product added again with the same options raises the quantity; with other options, the cart line takes the new options. To buy two versions, place a second order.
- Options are not added to FluentCart subscription products in this version.
Settings
| Setting | Ce qu'il fait |
|---|---|
| Price total | Shows the product price, the options and the total under the fields. Can be hidden while the chosen options are free. |
| Prices next to options | Shows each option’s price on the product page, in the cart and in orders. |
| Texts | Your own wording for the “Options” and “Total” lines and the button in product lists. Leave empty to use the default text in your site language. |
| File uploads | Largest file and accepted file types for all file fields. |
| When you delete the plugin | Tick it to delete the option groups, settings and uploaded files when the plugin is deleted. |
Langues
The plugin is in English, French, Spanish and Filipino (Tagalog), and follows the language of your site. Labels, help texts and choices you type in your groups are shown as you wrote them; with a translation plugin such as TranslatePress or WPML, translate them like the rest of your pages.
Uninstalling
Deactivating the plugin keeps everything. Deleting it keeps your groups and files too, unless you ticked Delete the option groups, settings and uploaded files in Settings. Orders always keep the options customers chose.
Troubleshooting
| Problem | What to do |
|---|---|
| The fields do not appear on a product | Check that the group is on and that Where to show it includes the product or its category, and that the product is not in Except these products. With WooCommerce, check the product’s Advanced tab. |
| The total does not change | Clear your cache plugin and any “combine / delay JavaScript” option for the product page, then reload. |
| A file cannot be uploaded | The file may be larger than the limit of the field or of your server (shown in Settings), or its type is not in the accepted list. |
| “The file for … is no longer available” in the cart or at checkout | The file was removed or it waited more than two days for an order. The customer clicks Upload it again, sends the file again and adds the product: the cart line is replaced. |
| “Not moved: … has to stay above …” in the option group editor | A condition can only use fields above it. Change or remove the condition first, or keep that field above. |
| Uploaded files can be opened by their address on Nginx | Ask your host to deny access to wp-content/uploads/alpo-uploads. |
| Licence: “The licence server could not be reached” | Your server could not reach our store. Try again in a minute; if it keeps happening, ask your host whether outgoing connections are blocked. |
Still stuck? Write to us from the Support page with your order number.