PersoNailit

PersoNailit adds a "PersoNailit" tab to the WooCommerce product data panel, letting store owners attach one or more personalization elements to any simple or variable product:

• Text — a free-text field with max length, allowed-character restrictions (letters only / numbers only) and text transform (uppercase, lowercase, capitalize). Can carry its own extra price.
• Image Upload — single or multiple file upload, with configurable maximum size and allowed file types (PNG, JPG, GIF, PDF). Can carry its own extra price.
• Color Swatches — a repeater of clickable colors, each with its own optional price, sale price, stock status, weight/dimensions, reference and preview image.
• Box Swatches — a repeater of clickable boxes (text or image), with the same per-value price, sale price, stock, shipping and reference options as Color, plus a configurable size (Small/Medium/Large) and an option to display the price inside the box itself.

Each element can be marked as required. Submitted values are validated on add-to-cart, shown in the cart and stored as order item meta, so store owners see exactly what the customer requested on every order. Combinations Available on simple products only (see the FAQ below for why). When a product has two or more Color/Box elements, PersoNailit can generate every combination of their values automatically ("Generate Combinations"). Each combination can then be given its own price, sale price, image, stock status, weight and dimensions — overriding the individual color/box values for that specific pairing. Bulk actions are available to set price, stock status, weight or dimensions across several combinations at once. Out of stock handling Colors, boxes and combinations can each be marked as out of stock. The storefront automatically blocks "Add to cart" and shows a message when the customer's current selection (or active combination) is unavailable. Element Sets A product's configured elements can be saved as a reusable "set" from the product panel, then added to any other product in one click — useful when several products share the same personalization style. Global Settings & Element Settings Two admin screens (under the main PersoNailit menu) let store owners:

• customize the personalization box's appearance (background color, accent color, title, padding, border radius) and whether new elements are required by default — Global Settings;
• set global defaults per element type (placeholder text, default file types and size, default swatch size, default box size, etc.), used whenever a product doesn't override them — Element Settings.

Uploaded files are stored in a temporary, .htaccess-protected directory until checkout completes, then moved to a final protected directory and attached to the order. Unclaimed temporary uploads are deleted automatically after 3 days. Extending PersoNailit Developers can register additional element types without modifying plugin files, by dropping a class implementing PersoNailit_Element_Interface into includes/elements/{type}/class-element-{type}.php, or by hooking into the personailit_elements filter to register/remove elements programmatically. See docs/hooks.md for the full list of available hooks.

1.0.0

• Text, Image Upload, Color Swatches and Box Swatches elements.
• Combinations: auto-generated combos of Color/Box values with their own price, sale price, image, stock, weight and dimensions, plus bulk actions.
• Out of stock handling for individual values and combinations.
• Element Sets: save and reuse a product's element configuration.
• Global Settings and Element Settings admin screens.
• Cart and order integration with per-element validation.
• Temporary/final upload handling with automatic cleanup.