Rexivue Lens Prescription for WooCommerce

Security

• Every submitted value is checked on the server against the product’s configured options. Anything else is rejected with an error message.
• Box counts must be whole numbers from 1 to the maximum.
• The quantity is locked to the number of boxes in the classic cart, the Cart block and the Store API, and re-checked before checkout.
• Variation IDs must belong to the product being added.
• Admin saves are protected by a nonce and the edit_product capability.
• Uploaded prescriptions are checked for real file type and size, stored under random names in wp-content/uploads/rexivue-prescriptions/ , and can only be downloaded by users with the edit_shop_orders capability through a nonce-protected link on the order screen.

Configuration

Product > Product data > Prescription

• Left eye (OS) / Right eye (OD) : show the prescription table and ask for values for that eye. At least one eye must be enabled for the table to appear.
• SPH / CYL / AXIS : tick to ask for the value, then list the allowed options separated by | , in display order. Example: -0.50|-0.75|-1.00|0.00|+0.50 . A field that is ticked but has no options is not shown.
• Prescription upload : let customers attach an image or PDF.

WooCommerce > Settings > Products > Prescription fields

• Maximum upload size (MB) : default 5 MB, never more than the server allows.
• Delete data on uninstall : see “Uninstall” below.

Hooks

Filters

• rexivue_product_config( array $config, WC_Product $product ) : the normalised configuration of a product.
• rexivue_max_boxes( int $max = 10, WC_Product $product ) : maximum boxes per eye.
• rexivue_is_field_required( bool $required = false, string $field, string $eye, array $clean, array $config, WC_Product|null $product ) : make SPH/CYL/AXIS mandatory.
• rexivue_validation_errors( WP_Error $errors, array $prescription, array $config, WC_Product|null $product ) : add store-specific validation rules.
• rexivue_upload_mimes( array $mimes ) : accepted upload types (images and PDF by default).
• rexivue_pending_upload_lifetime( int $seconds = 604800 ) : how long an upload that never reached an order is kept.
• rexivue_add_to_cart_selectors( string[] $selectors ) : add-to-cart buttons the script handles.
• rexivue_buy_now_selectors( string[] $selectors ) : separate Buy Now buttons.
• rexivue_native_submit( bool $native = true ) : submit the product form natively (bypasses theme AJAX add-to-cart).

Actions

• rexivue_loaded( Rexivue\LensPrescription\Plugin $plugin ) : after the plugin has registered its hooks. Components are available through $plugin->get( 'cart' ) , get( 'order' ) , get( 'frontend' ) , get( 'uploads' ) and get( 'admin' ) .
• rexivue_cleanup_pending_uploads : daily cron event that removes abandoned uploads.

Shortcodes

None.

Data stored

Everything the plugin stores uses the rexivue prefix.

Product meta:

• _rexivue_left_eye , _rexivue_right_eye : yes when the eye is enabled.
• _rexivue_sph_enabled , _rexivue_cyl_enabled , _rexivue_axis_enabled : yes when the field is enabled.
• _rexivue_sph_values , _rexivue_cyl_values , _rexivue_axis_values : allowed options separated by | .
• _rexivue_upload_enabled : yes when uploads are enabled.

Order line item meta:

• Visible (shown with translated labels): rexivue_left_sph , rexivue_left_cyl , rexivue_left_axis , rexivue_left_boxes , the same four for right , and rexivue_prescription_file (original file name).
• Hidden: _rexivue_prescription (structured copy), _rexivue_prescription_file (stored file name), _rexivue_prescription_file_name (original file name).

Options: rexivue_db_version , rexivue_max_upload_mb , rexivue_delete_data_on_uninstall .

Cart item data: rexivue_prescription (array with prescription , file and uid ).

Files: wp-content/uploads/rexivue-prescriptions/pending/ (in carts) and /orders/ (attached to orders).

Uninstall

Deactivating the plugin never deletes data.

When the plugin is deleted it always removes its scheduled event and data-version option. If Delete data on uninstall is enabled it also removes its settings, the prescription meta on products and variations, and uploads that never became part of an order.

Orders, order item meta and prescription files attached to orders are never deleted, because they are business records. Remove them manually if your data-retention policy requires it.