WPMelon Product Customization Fields for WooCommerce

FAQ

Does it work with the block cart and checkout?

Yes. Selected options and their prices show in the classic and block cart and checkout.

Does it work with variable products?

Yes. Percentage prices follow the price of the selected variation.

How do one-time fees work?

Set an option’s charge to “Once per line” and its price is added once for each cart line, whatever the quantity, as a cart fee named after the product and the option. A percentage is a percentage of one unit’s price. The fee uses the product’s tax status and tax class. The same product added twice with different choices is two cart lines, so it pays the fee twice.

Do coupons discount one-time fees?

No. WooCommerce coupons apply to product prices, not to fees, so one-time fees are charged in full. Options charged per item are part of the product price and are discounted as usual.

Why don’t Apple Pay, Google Pay or PayPal buttons show on some product pages?

Express-pay buttons on a product page buy the product directly, without the option fields, so the shopper’s choices would be lost. The plugin hides them on the product pages of products that have options (WooCommerce Stripe Gateway, WooPayments and WooCommerce PayPal Payments). They still show in the cart and at checkout, where the options are already in the cart.

Does it work with WPML or Polylang?

Yes. Every text shoppers see in an option group (field labels, descriptions, placeholders, choice labels, headings and paragraphs) is registered for translation in the “WPMelon Product Customization Fields” group: with WPML under WPML → String Translation (WPML String Translation must be active), with Polylang under Languages → Translations. The option group editor always shows and edits the original texts. Shoppers see the translations on the product page, in the cart and at checkout, and the options are saved on the order in the language the order was placed in. A group assigned to a product, category or tag also applies to their translations, and a group attached to one translation of a product applies to all of them. Polylang translates by text, so two fields with the same label share one translation. With WPML and the block checkout, choose directories or a domain per language under WPML → Languages → Language URL format: when the language is a URL parameter (?lang=), the checkout runs in the default language and the whole order, options included, is saved in that language. Option prices are not converted per currency; see “Known limitations” for currency switchers.

Where are uploaded files stored?

In a private folder inside your uploads directory, under random file names. Customers see only the file name; shop managers download files from the order screen.

What happens to my option groups if I delete the plugin?

They stay, unless you turn on “Remove all data when the plugin is deleted” under Products → Product Options → Settings. With it on, deleting the plugin removes the option groups, the groups attached to products and the files customers uploaded. Options already saved on orders always stay on the orders, and deactivating the plugin never deletes anything.

Is customer text safe to print in my own code?

Text and textarea values are kept as the customer typed them, except HTML tags are removed (and no “<” that could start a tag is kept). They are plain text, not HTML: escape them for the context you print them in (esc_html(), esc_attr()), as WooCommerce and this plugin do.

My store is behind Cloudflare or another proxy. Do uploads still work?

Yes, but upload limits count per visitor IP address, and behind a proxy every visitor arrives from the proxy’s address. Return the real visitor IP from the wpm_pcf_upload_client_ip filter, read from the header your proxy sets (for example CF-Connecting-IP). Without it, all visitors share one limit of 20 uploads per 10 minutes. The wpm_pcf_upload_rate_limit, wpm_pcf_pending_max_files (default 500) and wpm_pcf_pending_max_bytes (default 1 GB) filters change the limits.