Merge branch '1.0.0.studiou-wc-free-photo-product'

studiou-wc-free-photo-product/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(command -v php)",
+      "Bash(php -v)",
+      "WebFetch(domain:www.studiou.cz)"
+    ]
+  }
+}

studiou-wc-free-photo-product/CLAUDE.md

@@ -0,0 +1,82 @@
+# CLAUDE.md - Studiou WC Free Photo Product
+
+## Project Overview
+
+WordPress/WooCommerce plugin called **studiou-wc-free-photo-product** (QDR - Studiou WC Free Photo Product) v1.2.1.
+Allows publishing special variable products where customers upload custom raw images to be printed for a price.
+
+## Initial Requirements
+
+1. WP (6.9.4) / WooCommerce (10.6.2) plugin with variants and custom raw image upload for photo printing. Frontend shows product with upload box and preview on the WooCommerce product detail page.
+2. Product configuration area: Media Category for uploaded files, Maximum raw file size. Shortcode to embed product on any page.
+3. Uploaded raw files stored in WP media library with a specific media category per product. Chunked upload to bypass PHP upload size limits. Media files linked with product.
+4. Admin summary page: list of uploaded files, download as ZIP (bulk), order number, delete, change state (downloaded, ready, solved).
+5. HPOS support and localization (English, Czech).
+
+## Tech Stack
+
+- PHP 8.2+, WordPress 6.9.4+, WooCommerce 10.0+
+- jQuery for frontend/admin JS
+- WordPress AJAX (admin-ajax.php) for chunked upload
+- WC session storage for passing file data between upload and add-to-cart (theme-agnostic)
+- Custom DB table via dbDelta for file tracking
+- Custom taxonomy `studiou_media_category` on `attachment` post type
+
+## Architecture
+
+- Main class: `Studiou_WC_Free_Photo_Product` in root plugin file
+- Constants prefix: `STUDIOU_WCFPP_`
+- CSS class prefix: `studiou-fpp-`
+- JS namespace: `studiouWcfppFront` (frontend), `studiouWcfpp` (admin)
+- Nonces: `studiou-wcfpp-front-nonce` (frontend), `studiou-wcfpp-nonce` (admin)
+- Text domain: `studiou-wc-free-photo-product`
+
+## Key Classes
+
+- `Studiou_WC_FPP_DB` - Custom table CRUD, media category taxonomy
+- `Studiou_WC_FPP_Product` - WC product data tab, product meta
+- `Studiou_WC_FPP_Upload` - Chunked upload AJAX, file assembly, attachment creation
+- `Studiou_WC_FPP_Single_Product` - Upload area on product page (`woocommerce_single_product_summary` priority 35), WC session storage, server-side validation (`woocommerce_add_to_cart_validation` priority 1) + safety net (`woocommerce_add_to_cart` removes items without photo)
+- `Studiou_WC_FPP_Shortcode` - `[studiou_free_photo_product id="X"]` renders product with WC native variation form
+- `Studiou_WC_FPP_Cart` - Reads file data from WC session via `woocommerce_add_cart_item_data`, replaces cart/order item thumbnails (classic cart via `woocommerce_cart_item_thumbnail`, block cart via `woocommerce_product_get_image_id`/`woocommerce_product_variation_get_image_id`), order item meta, order linking
+- `Studiou_WC_FPP_Admin` - Summary page with filters/pagination, status management, ZIP download, file download with auto-status-change, bulk actions with confirmation dialogs
+
+## Frontend Flow
+
+1. Upload area rendered below variation table via `woocommerce_single_product_summary` (priority 35)
+2. On page load, existing session state restored (preview, gallery image)
+3. Customer uploads photo via chunked AJAX
+4. On upload complete, JS stores file ref in WC session
+5. Product gallery image replaced with uploaded photo preview; restored on remove
+6. Customer selects variant and clicks any Add to Cart button (buttons look normal — no client-side disabling)
+7. `woocommerce_add_to_cart_validation` (priority 1) checks WC session — blocks with error notice if no photo
+8. `woocommerce_add_to_cart` safety net — removes item if it was added without photo data
+9. `woocommerce_add_cart_item_data` reads file data from WC session (session NOT cleared — same photo reusable for multiple variants)
+10. Cart thumbnails: classic cart via `woocommerce_cart_item_thumbnail`, block cart via `woocommerce_product_get_image_id`/`woocommerce_product_variation_get_image_id`
+11. Order admin: thumbnail via `woocommerce_admin_order_item_thumbnail`, download link via `woocommerce_after_order_itemmeta` (auto-marks status as "downloaded")
+12. On checkout, file record linked to order via `woocommerce_checkout_order_processed` (classic), `woocommerce_store_api_checkout_order_processed` (block), `woocommerce_thankyou` (fallback)
+13. Session only cleared when user clicks Remove
+14. Admin photo files view: download marks "ready" -> "downloaded", bulk actions with confirmations, pagination preserves filters
+
+## Coding Conventions
+
+- Follow patterns from sibling plugin `studiou-wc-product-cat-manage`
+- All PHP files start with `if (!defined('WPINC')) { die; }`
+- AJAX handlers: verify nonce, check capabilities, try/catch with WP_DEBUG logging
+- Output buffer cleanup in AJAX handlers
+- Use `wp_send_json_success` / `wp_send_json_error` for all AJAX responses
+- All user-facing strings wrapped in `__()` or `esc_html_e()` with text domain
+- Sanitize all inputs: `absint()`, `sanitize_text_field()`, `sanitize_file_name()`
+- Escape all outputs: `esc_html()`, `esc_attr()`, `esc_url()`, `wp_kses_post()`
+
+## Build / Deploy Notes
+
+- Generate .mo from .po: `php languages/generate-mo.php` or `wp i18n make-mo languages/`
+- Plugin creates DB table on activation via `register_activation_hook`
+- Activation hook requires explicit `require_once` for DB class (runs before `plugins_loaded`)
+- Temp chunks stored in `wp-content/uploads/studiou-fpp-chunks/` (cleaned on deactivation)
+- Assembled files stored in `wp-content/uploads/YYYY/MM/free-photo/`
+
+## Version Bumping
+
+When changing JS or CSS files, always bump the plugin version in the main PHP file header AND the `STUDIOU_WCFPP_VERSION` constant to bust browser cache.

studiou-wc-free-photo-product/assets/css/admin.css

@@ -0,0 +1,155 @@
+/* Product edit - Free Photo tab */
+#woocommerce-product-data ul.wc-tabs li.studiou_fpp_options a::before {
+    content: '\f128';
+    font-family: dashicons;
+}
+
+.studiou-fpp-add-media-cat-btn {
+    margin-left: 5px !important;
+    min-width: 30px;
+    text-align: center;
+}
+
+.studiou-fpp-new-media-cat-form {
+    padding: 0 12px;
+}
+
+.studiou-fpp-new-media-cat-form .form-field {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+}
+
+.studiou-fpp-new-media-cat-form input[type="text"] {
+    flex: 1;
+}
+
+#studiou-fpp-shortcode-display {
+    background: #f0f0f1;
+    padding: 6px 12px;
+    border-radius: 3px;
+    user-select: all;
+}
+
+/* Admin summary page */
+.studiou-fpp-admin-wrap {
+    max-width: 1400px;
+}
+
+.studiou-fpp-admin-notice-area {
+    margin-bottom: 10px;
+}
+
+.studiou-fpp-filters {
+    margin: 15px 0;
+    padding: 12px 15px;
+    background: #fff;
+    border: 1px solid #ccd0d4;
+    border-radius: 4px;
+}
+
+.studiou-fpp-filters form {
+    display: flex;
+    gap: 8px;
+    align-items: center;
+    flex-wrap: wrap;
+}
+
+.studiou-fpp-filters select,
+.studiou-fpp-filters input[type="search"] {
+    height: 32px;
+}
+
+.studiou-fpp-filters input[type="search"] {
+    min-width: 200px;
+}
+
+.studiou-fpp-bulk-actions {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin: 10px 0;
+    flex-wrap: wrap;
+}
+
+.studiou-fpp-bulk-actions select {
+    height: 32px;
+}
+
+.studiou-fpp-total-count {
+    margin-left: auto;
+    color: #666;
+    font-style: italic;
+}
+
+#studiou-fpp-bulk-spinner {
+    float: none;
+    visibility: hidden;
+}
+
+/* Files table */
+.studiou-fpp-files-table .column-thumbnail {
+    width: 60px;
+}
+
+.studiou-fpp-files-table .column-status {
+    width: 130px;
+}
+
+.studiou-fpp-files-table .column-date {
+    width: 150px;
+}
+
+.studiou-fpp-files-table .column-actions {
+    width: 90px;
+}
+
+.studiou-fpp-files-table .column-order {
+    width: 80px;
+}
+
+.studiou-fpp-thumb {
+    width: 50px;
+    height: 50px;
+    object-fit: cover;
+    border-radius: 3px;
+    display: block;
+}
+
+.studiou-fpp-status-select {
+    width: 100%;
+    height: 28px;
+    font-size: 12px;
+}
+
+.studiou-fpp-no-order {
+    color: #999;
+}
+
+.studiou-fpp-files-table .column-actions {
+    white-space: nowrap;
+}
+
+.studiou-fpp-files-table .column-actions .button {
+    padding: 0 6px;
+    min-height: 28px;
+}
+
+.studiou-fpp-files-table .column-actions .dashicons {
+    font-size: 16px;
+    width: 16px;
+    height: 16px;
+}
+
+/* Status colors */
+.studiou-fpp-status-ready {
+    color: #d63638;
+}
+
+.studiou-fpp-status-downloaded {
+    color: #dba617;
+}
+
+.studiou-fpp-status-solved {
+    color: #00a32a;
+}

studiou-wc-free-photo-product/assets/css/frontend.css

@@ -0,0 +1,296 @@
+.studiou-fpp-product {
+    max-width: 800px;
+    margin: 20px 0;
+    font-family: inherit;
+}
+
+.studiou-fpp-product-header {
+    display: flex;
+    gap: 20px;
+    margin-bottom: 30px;
+    align-items: flex-start;
+}
+
+.studiou-fpp-product-image {
+    flex: 0 0 200px;
+}
+
+.studiou-fpp-product-image img {
+    max-width: 100%;
+    height: auto;
+    border-radius: 4px;
+}
+
+.studiou-fpp-product-info {
+    flex: 1;
+}
+
+.studiou-fpp-product-title {
+    margin: 0 0 10px;
+    font-size: 1.6em;
+}
+
+.studiou-fpp-product-description {
+    color: #555;
+    line-height: 1.6;
+}
+
+.studiou-fpp-section {
+    margin-bottom: 25px;
+}
+
+.studiou-fpp-section h3 {
+    margin: 0 0 12px;
+    font-size: 1.2em;
+    border-bottom: 2px solid #eee;
+    padding-bottom: 8px;
+}
+
+/* Variants table */
+.studiou-fpp-variants-table-wrap {
+    overflow-x: auto;
+}
+
+.studiou-fpp-variants-table {
+    width: 100%;
+    border-collapse: collapse;
+    border: 1px solid #ddd;
+}
+
+.studiou-fpp-variants-table th,
+.studiou-fpp-variants-table td {
+    padding: 10px 14px;
+    text-align: left;
+    border-bottom: 1px solid #eee;
+}
+
+.studiou-fpp-variants-table thead th {
+    background: #f7f7f7;
+    font-weight: 600;
+    border-bottom: 2px solid #ddd;
+}
+
+.studiou-fpp-variants-table .studiou-fpp-col-select {
+    width: 40px;
+    text-align: center;
+}
+
+.studiou-fpp-variants-table .studiou-fpp-col-price {
+    white-space: nowrap;
+    font-weight: 600;
+}
+
+.studiou-fpp-variant-row {
+    cursor: pointer;
+    transition: background 0.15s;
+}
+
+.studiou-fpp-variant-row:hover {
+    background: #f5f9ff;
+}
+
+.studiou-fpp-variant-row.studiou-fpp-variant-selected {
+    background: #e8f4fd;
+}
+
+.studiou-fpp-variant-row input[type="radio"] {
+    margin: 0;
+    cursor: pointer;
+}
+
+/* Upload area */
+.studiou-fpp-upload-info {
+    color: #777;
+    font-size: 0.9em;
+    margin-bottom: 12px;
+}
+
+.studiou-fpp-upload-area {
+    border: 2px dashed #ccc;
+    border-radius: 8px;
+    padding: 40px 20px;
+    text-align: center;
+    cursor: pointer;
+    transition: border-color 0.2s, background 0.2s;
+    position: relative;
+}
+
+.studiou-fpp-upload-area:hover,
+.studiou-fpp-upload-area.studiou-fpp-dragover {
+    border-color: #2271b1;
+    background: #f0f7ff;
+}
+
+.studiou-fpp-upload-icon {
+    font-size: 48px;
+    width: 48px;
+    height: 48px;
+    color: #999;
+    display: block;
+    margin: 0 auto 10px;
+}
+
+.studiou-fpp-upload-area:hover .studiou-fpp-upload-icon {
+    color: #2271b1;
+}
+
+.studiou-fpp-upload-prompt p {
+    margin: 0;
+    color: #777;
+}
+
+.studiou-fpp-file-input {
+    display: none;
+}
+
+/* Progress bar */
+.studiou-fpp-progress {
+    margin-top: 15px;
+    display: flex;
+    align-items: center;
+    gap: 12px;
+}
+
+.studiou-fpp-progress-bar {
+    flex: 1;
+    height: 20px;
+    background: #eee;
+    border-radius: 10px;
+    overflow: hidden;
+}
+
+.studiou-fpp-progress-fill {
+    height: 100%;
+    background: #2271b1;
+    border-radius: 10px;
+    transition: width 0.3s;
+}
+
+.studiou-fpp-progress-text {
+    font-weight: 600;
+    min-width: 40px;
+    text-align: right;
+}
+
+/* Preview */
+.studiou-fpp-preview {
+    display: flex;
+    align-items: center;
+    gap: 15px;
+    padding: 15px;
+    background: #f9f9f9;
+    border: 1px solid #ddd;
+    border-radius: 6px;
+    margin-top: 15px;
+}
+
+.studiou-fpp-preview-image {
+    flex: 0 0 80px;
+}
+
+.studiou-fpp-preview-image img {
+    max-width: 80px;
+    max-height: 80px;
+    border-radius: 4px;
+    display: block;
+}
+
+.studiou-fpp-preview-info {
+    flex: 1;
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 10px;
+}
+
+.studiou-fpp-preview-name {
+    font-weight: 500;
+    word-break: break-all;
+}
+
+.studiou-fpp-remove-file {
+    flex-shrink: 0;
+    color: #b32d2e !important;
+    border-color: #b32d2e !important;
+}
+
+.studiou-fpp-remove-file:hover {
+    background: #b32d2e !important;
+    color: #fff !important;
+}
+
+/* Actions / Add to cart */
+.studiou-fpp-actions {
+    padding-top: 15px;
+    border-top: 2px solid #eee;
+}
+
+.studiou-fpp-add-to-cart-btn {
+    padding: 12px 30px !important;
+    font-size: 1.1em !important;
+    font-weight: 600;
+}
+
+.studiou-fpp-add-to-cart-btn:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+}
+
+/* Cart uploaded photo preview */
+.studiou-fpp-cart-preview {
+    margin-top: 8px;
+}
+
+.studiou-fpp-cart-preview img {
+    max-width: 70px;
+    max-height: 70px;
+    object-fit: cover;
+    border-radius: 4px;
+    border: 1px solid #ddd;
+}
+
+/* Messages */
+.studiou-fpp-msg {
+    padding: 10px 15px;
+    border-radius: 4px;
+    margin-bottom: 12px;
+    font-size: 0.95em;
+}
+
+.studiou-fpp-msg-error {
+    background: #fef1f1;
+    color: #b32d2e;
+    border: 1px solid #f5c6c6;
+}
+
+.studiou-fpp-msg-success {
+    background: #ecf7ed;
+    color: #1e7e34;
+    border: 1px solid #c3e6c3;
+}
+
+.studiou-fpp-error {
+    color: #b32d2e;
+    font-style: italic;
+}
+
+/* Responsive */
+@media (max-width: 600px) {
+    .studiou-fpp-product-header {
+        flex-direction: column;
+    }
+
+    .studiou-fpp-product-image {
+        flex: none;
+        text-align: center;
+    }
+
+    .studiou-fpp-preview {
+        flex-direction: column;
+        text-align: center;
+    }
+
+    .studiou-fpp-preview-info {
+        flex-direction: column;
+    }
+}

studiou-wc-free-photo-product/assets/js/admin.js

@@ -0,0 +1,305 @@
+(function ($) {
+    'use strict';
+
+    $(document).ready(function () {
+
+        // ========================================
+        // Product edit page: Free Photo tab
+        // ========================================
+        if ($('#studiou_fpp_product_data').length) {
+            initProductTab();
+        }
+
+        // ========================================
+        // Admin summary page
+        // ========================================
+        if ($('.studiou-fpp-admin-wrap').length) {
+            initSummaryPage();
+        }
+
+        function initProductTab() {
+            // Show/hide new media category form
+            $('.studiou-fpp-add-media-cat-btn').on('click', function () {
+                $('.studiou-fpp-new-media-cat-form').toggle();
+            });
+
+            $('.studiou-fpp-cancel-media-cat-btn').on('click', function () {
+                $('.studiou-fpp-new-media-cat-form').hide();
+                $('#studiou_fpp_new_cat_name').val('');
+            });
+
+            // Save new media category
+            $('.studiou-fpp-save-media-cat-btn').on('click', function () {
+                var name = $('#studiou_fpp_new_cat_name').val().trim();
+                if (!name) {
+                    return;
+                }
+
+                var $btn = $(this);
+                $btn.prop('disabled', true);
+
+                $.ajax({
+                    url: studiouWcfpp.ajaxUrl,
+                    type: 'POST',
+                    data: {
+                        action: 'studiou_wcfpp_add_media_category',
+                        nonce: studiouWcfpp.nonce,
+                        name: name
+                    },
+                    success: function (response) {
+                        if (response.success) {
+                            var $select = $('#_studiou_fpp_media_category');
+                            $select.append(
+                                $('<option>', {
+                                    value: response.data.term_id,
+                                    text: response.data.name,
+                                    selected: true
+                                })
+                            );
+                            $('.studiou-fpp-new-media-cat-form').hide();
+                            $('#studiou_fpp_new_cat_name').val('');
+                        } else {
+                            alert(response.data ? response.data.message : studiouWcfpp.i18n.error);
+                        }
+                    },
+                    error: function () {
+                        alert(studiouWcfpp.i18n.error);
+                    },
+                    complete: function () {
+                        $btn.prop('disabled', false);
+                    }
+                });
+            });
+        }
+
+        function initSummaryPage() {
+            var $noticeArea = $('.studiou-fpp-admin-notice-area');
+
+            // Select all
+            $('#studiou-fpp-select-all').on('change', function () {
+                $('.studiou-fpp-file-cb').prop('checked', $(this).is(':checked'));
+            });
+
+            // Individual status change
+            $('.studiou-fpp-status-select').on('change', function () {
+                var fileId = $(this).data('file-id');
+                var status = $(this).val();
+                var $el = $(this);
+
+                $.ajax({
+                    url: studiouWcfpp.ajaxUrl,
+                    type: 'POST',
+                    data: {
+                        action: 'studiou_wcfpp_update_status',
+                        nonce: studiouWcfpp.nonce,
+                        file_id: fileId,
+                        status: status
+                    },
+                    success: function (response) {
+                        if (response.success) {
+                            showAdminNotice(studiouWcfpp.i18n.statusUpdated, 'success');
+                        } else {
+                            showAdminNotice(response.data ? response.data.message : studiouWcfpp.i18n.error, 'error');
+                        }
+                    },
+                    error: function () {
+                        showAdminNotice(studiouWcfpp.i18n.error, 'error');
+                    }
+                });
+            });
+
+            // Delete single
+            $(document).on('click', '.studiou-fpp-delete-single', function () {
+                var fileId = $(this).data('file-id');
+                if (!confirm(studiouWcfpp.i18n.confirmDeleteSingle)) {
+                    return;
+                }
+
+                $.ajax({
+                    url: studiouWcfpp.ajaxUrl,
+                    type: 'POST',
+                    data: {
+                        action: 'studiou_wcfpp_delete_files',
+                        nonce: studiouWcfpp.nonce,
+                        file_ids: [fileId]
+                    },
+                    success: function (response) {
+                        if (response.success) {
+                            $('tr[data-file-id="' + fileId + '"]').fadeOut(300, function () {
+                                $(this).remove();
+                            });
+                            showAdminNotice(response.data.message, 'success');
+                        } else {
+                            showAdminNotice(response.data ? response.data.message : studiouWcfpp.i18n.error, 'error');
+                        }
+                    },
+                    error: function () {
+                        showAdminNotice(studiouWcfpp.i18n.error, 'error');
+                    }
+                });
+            });
+
+            // Bulk action apply
+            $('#studiou-fpp-bulk-apply').on('click', function () {
+                var action = $('#studiou-fpp-bulk-action').val();
+                if (!action) {
+                    return;
+                }
+
+                var fileIds = getSelectedFileIds();
+                if (fileIds.length === 0) {
+                    showAdminNotice(studiouWcfpp.i18n.noFilesSelected, 'error');
+                    return;
+                }
+
+                var confirmMsg = '';
+                if (action === 'delete') {
+                    confirmMsg = studiouWcfpp.i18n.confirmDelete;
+                } else if (action === 'download_zip') {
+                    confirmMsg = studiouWcfpp.i18n.confirmDownloadZip;
+                } else if (action.startsWith('status_')) {
+                    confirmMsg = studiouWcfpp.i18n.confirmStatusChange;
+                }
+
+                if (confirmMsg && !confirm(confirmMsg)) {
+                    return;
+                }
+
+                if (action === 'download_zip') {
+                    bulkDownloadZip(fileIds);
+                } else if (action === 'delete') {
+                    bulkDelete(fileIds);
+                } else if (action.startsWith('status_')) {
+                    var status = action.replace('status_', '');
+                    bulkUpdateStatus(fileIds, status);
+                }
+            });
+
+            function getSelectedFileIds() {
+                var ids = [];
+                $('.studiou-fpp-file-cb:checked').each(function () {
+                    ids.push($(this).val());
+                });
+                return ids;
+            }
+
+            function bulkDownloadZip(fileIds) {
+                showBulkSpinner(true);
+                showAdminNotice(studiouWcfpp.i18n.generatingZip, 'info');
+
+                $.ajax({
+                    url: studiouWcfpp.ajaxUrl,
+                    type: 'POST',
+                    data: {
+                        action: 'studiou_wcfpp_download_zip',
+                        nonce: studiouWcfpp.nonce,
+                        file_ids: fileIds
+                    },
+                    success: function (response) {
+                        if (response.success) {
+                            // Trigger download
+                            window.location.href = response.data.download_url;
+                            showAdminNotice(
+                                response.data.file_count + ' file(s) in archive.',
+                                'success'
+                            );
+                        } else {
+                            showAdminNotice(response.data ? response.data.message : studiouWcfpp.i18n.error, 'error');
+                        }
+                    },
+                    error: function () {
+                        showAdminNotice(studiouWcfpp.i18n.error, 'error');
+                    },
+                    complete: function () {
+                        showBulkSpinner(false);
+                    }
+                });
+            }
+
+            function bulkDelete(fileIds) {
+                showBulkSpinner(true);
+
+                $.ajax({
+                    url: studiouWcfpp.ajaxUrl,
+                    type: 'POST',
+                    data: {
+                        action: 'studiou_wcfpp_delete_files',
+                        nonce: studiouWcfpp.nonce,
+                        file_ids: fileIds
+                    },
+                    success: function (response) {
+                        if (response.success) {
+                            fileIds.forEach(function (id) {
+                                $('tr[data-file-id="' + id + '"]').fadeOut(300, function () {
+                                    $(this).remove();
+                                });
+                            });
+                            showAdminNotice(response.data.message, 'success');
+                        } else {
+                            showAdminNotice(response.data ? response.data.message : studiouWcfpp.i18n.error, 'error');
+                        }
+                    },
+                    error: function () {
+                        showAdminNotice(studiouWcfpp.i18n.error, 'error');
+                    },
+                    complete: function () {
+                        showBulkSpinner(false);
+                    }
+                });
+            }
+
+            function bulkUpdateStatus(fileIds, status) {
+                showBulkSpinner(true);
+
+                $.ajax({
+                    url: studiouWcfpp.ajaxUrl,
+                    type: 'POST',
+                    data: {
+                        action: 'studiou_wcfpp_bulk_status',
+                        nonce: studiouWcfpp.nonce,
+                        file_ids: fileIds,
+                        status: status
+                    },
+                    success: function (response) {
+                        if (response.success) {
+                            // Update dropdowns
+                            fileIds.forEach(function (id) {
+                                $('tr[data-file-id="' + id + '"] .studiou-fpp-status-select').val(status);
+                            });
+                            showAdminNotice(response.data.message, 'success');
+                        } else {
+                            showAdminNotice(response.data ? response.data.message : studiouWcfpp.i18n.error, 'error');
+                        }
+                    },
+                    error: function () {
+                        showAdminNotice(studiouWcfpp.i18n.error, 'error');
+                    },
+                    complete: function () {
+                        showBulkSpinner(false);
+                    }
+                });
+            }
+
+            function showBulkSpinner(show) {
+                $('#studiou-fpp-bulk-spinner').css('visibility', show ? 'visible' : 'hidden');
+            }
+
+            function showAdminNotice(message, type) {
+                var cls = 'notice-' + (type === 'error' ? 'error' : (type === 'info' ? 'info' : 'success'));
+                $noticeArea.html(
+                    '<div class="notice ' + cls + ' is-dismissible"><p>' + escHtml(message) + '</p>' +
+                    '<button type="button" class="notice-dismiss"><span class="screen-reader-text">Dismiss</span></button></div>'
+                );
+                $noticeArea.find('.notice-dismiss').on('click', function () {
+                    $(this).closest('.notice').fadeOut(200, function () { $(this).remove(); });
+                });
+            }
+        }
+
+        function escHtml(str) {
+            var div = document.createElement('div');
+            div.appendChild(document.createTextNode(str));
+            return div.innerHTML;
+        }
+    });
+})(jQuery);

studiou-wc-free-photo-product/assets/js/frontend.js

@@ -0,0 +1,330 @@
+(function ($) {
+    'use strict';
+
+    $(document).ready(function () {
+
+        var $uploadWrap = $('.studiou-fpp-upload-wrap');
+        if (!$uploadWrap.length) {
+            return;
+        }
+
+        var productId = $uploadWrap.data('product-id');
+        var maxFileSize = parseInt($uploadWrap.data('max-file-size'), 10) || 50;
+        var chunkSize = parseInt(studiouWcfppFront.chunkSize, 10) || 1048576;
+        var uploadedAttachmentId = null;
+        var uploadedFileRecordId = null;
+        var isUploading = false;
+        var originalGalleryImages = {};
+
+        // Upload area elements
+        var $dropzone = $uploadWrap.find('#studiou-fpp-dropzone');
+        var $fileInput = $uploadWrap.find('#studiou-fpp-file-input');
+        var $progress = $uploadWrap.find('.studiou-fpp-progress');
+        var $progressFill = $uploadWrap.find('.studiou-fpp-progress-fill');
+        var $progressText = $uploadWrap.find('.studiou-fpp-progress-text');
+        var $preview = $uploadWrap.find('.studiou-fpp-preview');
+        var $previewImg = $preview.find('img');
+        var $previewName = $uploadWrap.find('.studiou-fpp-preview-name');
+        var $removeBtn = $uploadWrap.find('.studiou-fpp-remove-file');
+        var $messages = $uploadWrap.find('.studiou-fpp-messages');
+
+        // ==========================================
+        // Restore session state on page load
+        // ==========================================
+        if (typeof studiouWcfppSession !== 'undefined' && studiouWcfppSession.attachment_id) {
+            uploadedAttachmentId = studiouWcfppSession.attachment_id;
+            uploadedFileRecordId = studiouWcfppSession.file_record_id;
+            showPreview(studiouWcfppSession.thumbnail_url, studiouWcfppSession.file_name);
+            updateProductGallery(studiouWcfppSession.preview_url || studiouWcfppSession.thumbnail_url);
+        }
+
+        // ==========================================
+        // Drag and drop
+        // ==========================================
+        $dropzone.on('dragover dragenter', function (e) {
+            e.preventDefault();
+            e.stopPropagation();
+            $(this).addClass('studiou-fpp-dragover');
+        });
+
+        $dropzone.on('dragleave drop', function (e) {
+            e.preventDefault();
+            e.stopPropagation();
+            $(this).removeClass('studiou-fpp-dragover');
+        });
+
+        $dropzone.on('drop', function (e) {
+            var files = e.originalEvent.dataTransfer.files;
+            if (files.length > 0) {
+                handleFile(files[0]);
+            }
+        });
+
+        $dropzone.on('click', function () {
+            if (!isUploading) {
+                $fileInput.trigger('click');
+            }
+        });
+
+        $fileInput.on('change', function () {
+            if (this.files.length > 0) {
+                handleFile(this.files[0]);
+            }
+        });
+
+        // Remove file
+        $removeBtn.on('click', function () {
+            removeUploadedFile();
+        });
+
+        // ==========================================
+        // Upload logic
+        // ==========================================
+        function handleFile(file) {
+            if (isUploading) return;
+
+            var maxBytes = maxFileSize * 1024 * 1024;
+            if (file.size > maxBytes) {
+                showMessage(studiouWcfppFront.i18n.fileTooLarge.replace('%s', maxFileSize), 'error');
+                return;
+            }
+
+            clearMessages();
+            startChunkedUpload(file);
+        }
+
+        function startChunkedUpload(file) {
+            isUploading = true;
+            var totalChunks = Math.ceil(file.size / chunkSize);
+            var uploadId = 'upload_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
+            var currentChunk = 0;
+
+            $dropzone.hide();
+            $progress.show();
+
+            function uploadNextChunk() {
+                var start = currentChunk * chunkSize;
+                var end = Math.min(start + chunkSize, file.size);
+                var blob = file.slice(start, end);
+
+                var formData = new FormData();
+                formData.append('action', 'studiou_wcfpp_upload_chunk');
+                formData.append('nonce', studiouWcfppFront.nonce);
+                formData.append('product_id', productId);
+                formData.append('upload_id', uploadId);
+                formData.append('chunk_index', currentChunk);
+                formData.append('total_chunks', totalChunks);
+                formData.append('file_name', file.name);
+                formData.append('file_size', file.size);
+                formData.append('chunk', blob, 'chunk');
+
+                var isLastChunk = (currentChunk === totalChunks - 1);
+                if (isLastChunk) {
+                    $progressFill.css('width', '100%');
+                    $progressText.text(studiouWcfppFront.i18n.processing || 'Processing...');
+                }
+
+                $.ajax({
+                    url: studiouWcfppFront.ajaxUrl,
+                    type: 'POST',
+                    data: formData,
+                    processData: false,
+                    contentType: false,
+                    timeout: isLastChunk ? 120000 : 30000,
+                    success: function (response) {
+                        if (response.success) {
+                            if (!isLastChunk) {
+                                currentChunk++;
+                                var percent = Math.round((currentChunk / totalChunks) * 100);
+                                $progressFill.css('width', percent + '%');
+                                $progressText.text(percent + '%');
+                            }
+
+                            if (response.data.complete) {
+                                uploadedAttachmentId = response.data.attachment_id;
+                                uploadedFileRecordId = response.data.file_record_id;
+
+                                storeInSession(
+                                    response.data.attachment_id,
+                                    response.data.file_record_id,
+                                    response.data.file_name
+                                );
+
+                                showPreview(response.data.thumbnail_url, response.data.file_name);
+                                updateProductGallery(response.data.preview_url || response.data.thumbnail_url);
+                                $progress.hide();
+                                isUploading = false;
+                            } else {
+                                uploadNextChunk();
+                            }
+                        } else {
+                            uploadFailed(response.data ? response.data.message : studiouWcfppFront.i18n.uploadError);
+                        }
+                    },
+                    error: function () {
+                        uploadFailed(studiouWcfppFront.i18n.uploadError);
+                    }
+                });
+            }
+
+            uploadNextChunk();
+        }
+
+        // ==========================================
+        // Session management
+        // ==========================================
+        function storeInSession(attachmentId, fileRecordId, fileName) {
+            $.ajax({
+                url: studiouWcfppFront.ajaxUrl,
+                type: 'POST',
+                data: {
+                    action: 'studiou_wcfpp_set_upload_session',
+                    nonce: studiouWcfppFront.nonce,
+                    attachment_id: attachmentId,
+                    file_record_id: fileRecordId,
+                    file_name: fileName
+                }
+            });
+        }
+
+        function clearSession() {
+            $.ajax({
+                url: studiouWcfppFront.ajaxUrl,
+                type: 'POST',
+                data: {
+                    action: 'studiou_wcfpp_clear_upload_session',
+                    nonce: studiouWcfppFront.nonce
+                }
+            });
+        }
+
+        // ==========================================
+        // Product gallery image replacement
+        // ==========================================
+        function updateProductGallery(imageUrl) {
+            if (!imageUrl) return;
+
+            var selectors = [
+                '.woocommerce-product-gallery__image img',
+                '.product .wp-post-image',
+                '.product-image img',
+                '.product-thumbnail img',
+                '.entry-summary img.attachment-woocommerce_thumbnail',
+                '.product-gallery img:first'
+            ];
+
+            var $img = null;
+            for (var i = 0; i < selectors.length; i++) {
+                $img = $(selectors[i]).first();
+                if ($img.length) break;
+            }
+            if (!$img || !$img.length) return;
+
+            if (!originalGalleryImages.src) {
+                originalGalleryImages.src = $img.attr('src');
+                originalGalleryImages.srcset = $img.attr('srcset') || '';
+                originalGalleryImages.sizes = $img.attr('sizes') || '';
+                var $link = $img.closest('a');
+                if ($link.length) originalGalleryImages.href = $link.attr('href');
+            }
+
+            $img.attr('src', imageUrl).removeAttr('srcset').removeAttr('sizes');
+            var $link = $img.closest('a');
+            if ($link.length) $link.attr('href', imageUrl);
+        }
+
+        function restoreProductGallery() {
+            if (!originalGalleryImages.src) return;
+
+            var selectors = [
+                '.woocommerce-product-gallery__image img',
+                '.product .wp-post-image',
+                '.product-image img',
+                '.product-thumbnail img',
+                '.entry-summary img.attachment-woocommerce_thumbnail',
+                '.product-gallery img:first'
+            ];
+
+            var $img = null;
+            for (var i = 0; i < selectors.length; i++) {
+                $img = $(selectors[i]).first();
+                if ($img.length) break;
+            }
+            if (!$img || !$img.length) return;
+
+            $img.attr('src', originalGalleryImages.src);
+            if (originalGalleryImages.srcset) $img.attr('srcset', originalGalleryImages.srcset);
+            if (originalGalleryImages.sizes) $img.attr('sizes', originalGalleryImages.sizes);
+            if (originalGalleryImages.href) $img.closest('a').attr('href', originalGalleryImages.href);
+
+            originalGalleryImages = {};
+        }
+
+        // ==========================================
+        // UI helpers
+        // ==========================================
+        function uploadFailed(message) {
+            isUploading = false;
+            $progress.hide();
+            $dropzone.show();
+            showMessage(message, 'error');
+            $fileInput.val('');
+        }
+
+        function showPreview(thumbnailUrl, fileName) {
+            if (thumbnailUrl) {
+                $previewImg.attr('src', thumbnailUrl).show();
+            } else {
+                $previewImg.hide();
+            }
+            $previewName.text(fileName);
+            $preview.show();
+            $dropzone.hide();
+        }
+
+        function removeUploadedFile() {
+            if (!uploadedFileRecordId) return;
+
+            $.ajax({
+                url: studiouWcfppFront.ajaxUrl,
+                type: 'POST',
+                data: {
+                    action: 'studiou_wcfpp_remove_upload',
+                    nonce: studiouWcfppFront.nonce,
+                    file_record_id: uploadedFileRecordId
+                },
+                success: function () {
+                    resetUpload();
+                }
+            });
+        }
+
+        function resetUpload() {
+            uploadedAttachmentId = null;
+            uploadedFileRecordId = null;
+            clearSession();
+            restoreProductGallery();
+            $preview.hide();
+            $previewImg.attr('src', '');
+            $previewName.text('');
+            $dropzone.show();
+            $fileInput.val('');
+            clearMessages();
+        }
+
+        function showMessage(text, type) {
+            var cls = type === 'error' ? 'studiou-fpp-msg-error' : 'studiou-fpp-msg-success';
+            $messages.html('<div class="studiou-fpp-msg ' + cls + '">' + escHtml(text) + '</div>');
+        }
+
+        function clearMessages() {
+            $messages.empty();
+        }
+
+        function escHtml(str) {
+            var div = document.createElement('div');
+            div.appendChild(document.createTextNode(str));
+            return div.innerHTML;
+        }
+    });
+})(jQuery);

studiou-wc-free-photo-product/includes/class-studiou-wc-fpp-admin.php

@@ -0,0 +1,329 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+class Studiou_WC_FPP_Admin {
+
+    /** @var Studiou_WC_FPP_DB */
+    private $db;
+
+    public function __construct($db) {
+        $this->db = $db;
+
+        // AJAX handlers
+        add_action('wp_ajax_studiou_wcfpp_update_status', array($this, 'ajax_update_status'));
+        add_action('wp_ajax_studiou_wcfpp_delete_files', array($this, 'ajax_delete_files'));
+        add_action('wp_ajax_studiou_wcfpp_download_zip', array($this, 'ajax_download_zip'));
+        add_action('wp_ajax_studiou_wcfpp_bulk_status', array($this, 'ajax_bulk_status'));
+
+        // Handle direct ZIP download and file download (marks as downloaded)
+        add_action('admin_init', array($this, 'handle_zip_download'));
+        add_action('admin_init', array($this, 'handle_file_download'));
+    }
+
+    public function render_summary_page() {
+        // Process filters
+        $current_status = isset($_GET['status']) ? sanitize_text_field($_GET['status']) : '';
+        $current_product = isset($_GET['product_id']) ? absint($_GET['product_id']) : 0;
+        $current_search = isset($_GET['s']) ? sanitize_text_field($_GET['s']) : '';
+        $current_page = isset($_GET['paged']) ? max(1, absint($_GET['paged'])) : 1;
+        $per_page = 30;
+
+        $args = array(
+            'status'  => $current_status,
+            'product_id' => $current_product,
+            'search'  => $current_search,
+            'limit'   => $per_page,
+            'offset'  => ($current_page - 1) * $per_page,
+            'orderby' => isset($_GET['orderby']) ? sanitize_text_field($_GET['orderby']) : 'created_at',
+            'order'   => isset($_GET['order']) ? sanitize_text_field($_GET['order']) : 'DESC',
+        );
+
+        $records = $this->db->get_file_records($args);
+        $total = $this->db->count_file_records($args);
+        $total_pages = ceil($total / $per_page);
+
+        // Get products that have FPP enabled for filter dropdown
+        $fpp_products = $this->get_fpp_products();
+
+        include STUDIOU_WCFPP_PLUGIN_DIR . 'views/admin-summary.php';
+    }
+
+    private function get_fpp_products() {
+        $args = array(
+            'post_type'      => 'product',
+            'post_status'    => 'publish',
+            'posts_per_page' => -1,
+            'meta_query'     => array(
+                array(
+                    'key'   => '_studiou_fpp_enabled',
+                    'value' => 'yes',
+                ),
+            ),
+            'fields' => 'ids',
+        );
+        $product_ids = get_posts($args);
+        $products = array();
+        foreach ($product_ids as $pid) {
+            $products[$pid] = get_the_title($pid);
+        }
+        return $products;
+    }
+
+    public function ajax_update_status() {
+        check_ajax_referer('studiou-wcfpp-nonce', 'nonce');
+
+        if (!current_user_can('manage_woocommerce')) {
+            wp_send_json_error(array('message' => __('Insufficient permissions.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $file_id = isset($_POST['file_id']) ? absint($_POST['file_id']) : 0;
+        $status = isset($_POST['status']) ? sanitize_text_field($_POST['status']) : '';
+
+        if (!$file_id || !$status) {
+            wp_send_json_error(array('message' => __('Invalid data.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $result = $this->db->update_file_status($file_id, $status);
+        if ($result === false) {
+            wp_send_json_error(array('message' => __('Failed to update status.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        wp_send_json_success(array('message' => __('Status updated.', 'studiou-wc-free-photo-product')));
+    }
+
+    public function ajax_bulk_status() {
+        check_ajax_referer('studiou-wcfpp-nonce', 'nonce');
+
+        if (!current_user_can('manage_woocommerce')) {
+            wp_send_json_error(array('message' => __('Insufficient permissions.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $file_ids = isset($_POST['file_ids']) ? array_map('absint', (array) $_POST['file_ids']) : array();
+        $status = isset($_POST['status']) ? sanitize_text_field($_POST['status']) : '';
+
+        if (empty($file_ids) || !$status) {
+            wp_send_json_error(array('message' => __('Invalid data.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $updated = 0;
+        foreach ($file_ids as $fid) {
+            if ($this->db->update_file_status($fid, $status)) {
+                $updated++;
+            }
+        }
+
+        wp_send_json_success(array(
+            'message' => sprintf(__('%d file(s) updated.', 'studiou-wc-free-photo-product'), $updated),
+        ));
+    }
+
+    public function ajax_delete_files() {
+        check_ajax_referer('studiou-wcfpp-nonce', 'nonce');
+
+        if (!current_user_can('manage_woocommerce')) {
+            wp_send_json_error(array('message' => __('Insufficient permissions.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $file_ids = isset($_POST['file_ids']) ? array_map('absint', (array) $_POST['file_ids']) : array();
+        if (empty($file_ids)) {
+            wp_send_json_error(array('message' => __('No files selected.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $deleted = 0;
+        foreach ($file_ids as $fid) {
+            if ($this->db->delete_file_record($fid)) {
+                $deleted++;
+            }
+        }
+
+        wp_send_json_success(array(
+            'message' => sprintf(__('%d file(s) deleted.', 'studiou-wc-free-photo-product'), $deleted),
+        ));
+    }
+
+    public function ajax_download_zip() {
+        check_ajax_referer('studiou-wcfpp-nonce', 'nonce');
+
+        if (!current_user_can('manage_woocommerce')) {
+            wp_send_json_error(array('message' => __('Insufficient permissions.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $file_ids = isset($_POST['file_ids']) ? array_map('absint', (array) $_POST['file_ids']) : array();
+        if (empty($file_ids)) {
+            wp_send_json_error(array('message' => __('No files selected.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $records = $this->db->get_file_records_by_ids($file_ids);
+        if (empty($records)) {
+            wp_send_json_error(array('message' => __('No files found.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        // Generate ZIP
+        $upload_dir = wp_upload_dir();
+        $zip_name = 'fpp-files-' . date('Y-m-d-His') . '.zip';
+        $zip_path = $upload_dir['basedir'] . '/studiou-fpp-chunks/' . $zip_name;
+
+        if (!class_exists('ZipArchive')) {
+            wp_send_json_error(array('message' => __('ZIP extension not available on server.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $zip = new ZipArchive();
+        if ($zip->open($zip_path, ZipArchive::CREATE) !== true) {
+            wp_send_json_error(array('message' => __('Could not create ZIP file.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $added = 0;
+        foreach ($records as $record) {
+            $file_path = get_attached_file($record->attachment_id);
+            if ($file_path && file_exists($file_path)) {
+                // Use order number prefix if available
+                $prefix = $record->order_id ? 'order-' . $record->order_id . '_' : '';
+                $zip->addFile($file_path, $prefix . $record->file_name);
+                $added++;
+            }
+        }
+        $zip->close();
+
+        if ($added === 0) {
+            if (file_exists($zip_path)) {
+                unlink($zip_path);
+            }
+            wp_send_json_error(array('message' => __('No files could be added to archive.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        // Generate a nonce-protected download URL
+        $download_url = add_query_arg(array(
+            'studiou_fpp_download' => 1,
+            'file' => $zip_name,
+            '_wpnonce' => wp_create_nonce('studiou-fpp-zip-download'),
+        ), admin_url('admin.php'));
+
+        wp_send_json_success(array(
+            'download_url' => $download_url,
+            'file_count'   => $added,
+        ));
+    }
+
+    public function handle_zip_download() {
+        if (!isset($_GET['studiou_fpp_download']) || !isset($_GET['file'])) {
+            return;
+        }
+
+        if (!wp_verify_nonce($_GET['_wpnonce'], 'studiou-fpp-zip-download')) {
+            wp_die(__('Security check failed.', 'studiou-wc-free-photo-product'));
+        }
+
+        if (!current_user_can('manage_woocommerce')) {
+            wp_die(__('Insufficient permissions.', 'studiou-wc-free-photo-product'));
+        }
+
+        $file_name = sanitize_file_name($_GET['file']);
+        $upload_dir = wp_upload_dir();
+        $file_path = $upload_dir['basedir'] . '/studiou-fpp-chunks/' . $file_name;
+
+        if (!file_exists($file_path) || pathinfo($file_name, PATHINFO_EXTENSION) !== 'zip') {
+            wp_die(__('File not found.', 'studiou-wc-free-photo-product'));
+        }
+
+        header('Content-Type: application/zip');
+        header('Content-Disposition: attachment; filename="' . $file_name . '"');
+        header('Content-Length: ' . filesize($file_path));
+        header('Pragma: no-cache');
+
+        readfile($file_path);
+
+        // Clean up the ZIP file after download
+        unlink($file_path);
+        exit;
+    }
+
+    /**
+     * Handle single file download — serves the file and marks status as "downloaded".
+     */
+    public function handle_file_download() {
+        if (!isset($_GET['studiou_fpp_download_file'])) {
+            return;
+        }
+
+        if (!wp_verify_nonce($_GET['_wpnonce'] ?? '', 'studiou-fpp-download-file')) {
+            wp_die(__('Security check failed.', 'studiou-wc-free-photo-product'));
+        }
+
+        if (!current_user_can('manage_woocommerce')) {
+            wp_die(__('Insufficient permissions.', 'studiou-wc-free-photo-product'));
+        }
+
+        $file_record_id = isset($_GET['file_record_id']) ? absint($_GET['file_record_id']) : 0;
+        $attachment_id = isset($_GET['attachment_id']) ? absint($_GET['attachment_id']) : 0;
+
+        if (!$attachment_id) {
+            wp_die(__('File not found.', 'studiou-wc-free-photo-product'));
+        }
+
+        // Mark as downloaded
+        if ($file_record_id) {
+            $record = $this->db->get_file_record($file_record_id);
+            if ($record && $record->status === 'ready') {
+                $this->db->update_file_status($file_record_id, 'downloaded');
+            }
+        }
+
+        // Serve the file
+        $file_path = get_attached_file($attachment_id);
+        if (!$file_path || !file_exists($file_path)) {
+            wp_die(__('File not found.', 'studiou-wc-free-photo-product'));
+        }
+
+        $file_name = basename($file_path);
+        $mime_type = mime_content_type($file_path) ?: 'application/octet-stream';
+
+        header('Content-Type: ' . $mime_type);
+        header('Content-Disposition: attachment; filename="' . $file_name . '"');
+        header('Content-Length: ' . filesize($file_path));
+        header('Pragma: no-cache');
+
+        readfile($file_path);
+        exit;
+    }
+
+    public static function get_status_label($status) {
+        $labels = array(
+            'ready'      => __('Ready', 'studiou-wc-free-photo-product'),
+            'downloaded' => __('Downloaded', 'studiou-wc-free-photo-product'),
+            'solved'     => __('Solved', 'studiou-wc-free-photo-product'),
+        );
+        return isset($labels[$status]) ? $labels[$status] : $status;
+    }
+
+    public static function get_status_class($status) {
+        $classes = array(
+            'ready'      => 'studiou-fpp-status-ready',
+            'downloaded' => 'studiou-fpp-status-downloaded',
+            'solved'     => 'studiou-fpp-status-solved',
+        );
+        return isset($classes[$status]) ? $classes[$status] : '';
+    }
+
+    public static function get_order_edit_url($order_id) {
+        if (class_exists('Automattic\WooCommerce\Utilities\OrderUtil')
+            && \Automattic\WooCommerce\Utilities\OrderUtil::custom_orders_table_usage_is_enabled()) {
+            return admin_url('admin.php?page=wc-orders&action=edit&id=' . $order_id);
+        }
+        return admin_url('post.php?post=' . $order_id . '&action=edit');
+    }
+}

studiou-wc-free-photo-product/includes/class-studiou-wc-fpp-cart.php

@@ -0,0 +1,282 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+class Studiou_WC_FPP_Cart {
+
+    /** @var Studiou_WC_FPP_DB */
+    private $db;
+
+    public function __construct($db) {
+        $this->db = $db;
+
+        // Capture file data from WC session on add-to-cart
+        add_filter('woocommerce_add_cart_item_data', array($this, 'add_cart_item_data'), 10, 3);
+
+        // Display uploaded file info in cart
+        add_filter('woocommerce_get_item_data', array($this, 'display_cart_item_data'), 10, 2);
+
+        // Replace cart item thumbnail with uploaded image (classic cart)
+        add_filter('woocommerce_cart_item_thumbnail', array($this, 'cart_item_thumbnail'), 10, 3);
+
+        // Show uploaded photo preview directly after item name in cart (classic cart)
+        add_action('woocommerce_after_cart_item_name', array($this, 'show_cart_item_photo_preview'), 10, 2);
+
+        // Override product image for block cart (Store API) — returns uploaded photo as product image
+        add_filter('woocommerce_product_get_image_id', array($this, 'override_product_image_for_cart'), 10, 2);
+        add_filter('woocommerce_product_variation_get_image_id', array($this, 'override_product_image_for_cart'), 10, 2);
+
+        // Save file reference to order item
+        add_action('woocommerce_checkout_create_order_line_item', array($this, 'save_order_item_meta'), 10, 4);
+
+        // Link file records to order after checkout (classic + block checkout)
+        add_action('woocommerce_checkout_order_processed', array($this, 'link_files_to_order'), 10, 3);
+        add_action('woocommerce_store_api_checkout_order_processed', array($this, 'link_files_to_order_from_store_api'), 10, 1);
+        add_action('woocommerce_thankyou', array($this, 'link_files_to_order_fallback'), 10, 1);
+
+        // Replace order item thumbnail with uploaded image (admin)
+        add_filter('woocommerce_admin_order_item_thumbnail', array($this, 'admin_order_item_thumbnail'), 10, 3);
+
+        // Add download link to order item in admin
+        add_action('woocommerce_after_order_itemmeta', array($this, 'admin_order_item_download_link'), 10, 3);
+    }
+
+    public function add_cart_item_data($cart_item_data, $product_id, $variation_id) {
+        // Check if this product (or its parent) is FPP enabled
+        $fpp_product_id = $product_id;
+        if (!Studiou_WC_FPP_Product::is_fpp_product($product_id)) {
+            $product = wc_get_product($product_id);
+            if ($product && $product->get_parent_id() && Studiou_WC_FPP_Product::is_fpp_product($product->get_parent_id())) {
+                $fpp_product_id = $product->get_parent_id();
+            } else {
+                return $cart_item_data;
+            }
+        }
+
+        // Read file data from WC session
+        if (!WC()->session) {
+            return $cart_item_data;
+        }
+
+        $attachment_id = WC()->session->get('studiou_fpp_attachment_id');
+        $file_record_id = WC()->session->get('studiou_fpp_file_record_id');
+        $file_name = WC()->session->get('studiou_fpp_file_name');
+        $thumb_url = WC()->session->get('studiou_fpp_thumb_url');
+
+        if (!$attachment_id || !$file_record_id) {
+            return $cart_item_data;
+        }
+
+        // Verify the file record exists
+        $record = $this->db->get_file_record($file_record_id);
+        if (!$record || (int) $record->attachment_id !== (int) $attachment_id) {
+            return $cart_item_data;
+        }
+
+        $cart_item_data['studiou_fpp_attachment_id'] = $attachment_id;
+        $cart_item_data['studiou_fpp_file_record_id'] = $file_record_id;
+        $cart_item_data['studiou_fpp_file_name'] = $file_name ?: $record->file_name;
+        $cart_item_data['studiou_fpp_thumb_url'] = $thumb_url ?: '';
+
+        // Update file record with variation
+        $actual_variation_id = $variation_id ?: $product_id;
+        $this->db->update_file_record($file_record_id, array(
+            'variation_id' => $actual_variation_id,
+        ));
+
+        // Keep session data so the same photo can be used for multiple variants
+        return $cart_item_data;
+    }
+
+    public function cart_item_thumbnail($thumbnail, $cart_item, $cart_item_key) {
+        $url = $this->get_cart_item_thumb_url($cart_item);
+        if ($url) {
+            $alt = isset($cart_item['studiou_fpp_file_name']) ? esc_attr($cart_item['studiou_fpp_file_name']) : '';
+            return '<img src="' . esc_url($url) . '" alt="' . $alt . '" class="attachment-woocommerce_thumbnail" />';
+        }
+        return $thumbnail;
+    }
+
+    /**
+     * Override product/variation image_id when rendered in cart context (block cart / Store API).
+     * Returns the uploaded photo attachment_id so the block cart shows it instead of placeholder.
+     */
+    public function override_product_image_for_cart($image_id, $product) {
+        if (!WC()->cart) {
+            return $image_id;
+        }
+
+        $product_id = $product->get_id();
+
+        foreach (WC()->cart->get_cart() as $cart_item) {
+            if (empty($cart_item['studiou_fpp_attachment_id'])) {
+                continue;
+            }
+
+            $match = false;
+            if (isset($cart_item['variation_id']) && $cart_item['variation_id'] == $product_id) {
+                $match = true;
+            } elseif ($cart_item['product_id'] == $product_id) {
+                $match = true;
+            }
+
+            if ($match) {
+                return (int) $cart_item['studiou_fpp_attachment_id'];
+            }
+        }
+
+        return $image_id;
+    }
+
+    public function display_cart_item_data($item_data, $cart_item) {
+        if (isset($cart_item['studiou_fpp_file_name'])) {
+            $item_data[] = array(
+                'name'    => __('Uploaded Photo', 'studiou-wc-free-photo-product'),
+                'value'   => esc_html($cart_item['studiou_fpp_file_name']),
+                'display' => '',
+            );
+        }
+        return $item_data;
+    }
+
+    public function show_cart_item_photo_preview($cart_item, $cart_item_key) {
+        $url = $this->get_cart_item_thumb_url($cart_item);
+        if ($url) {
+            echo '<div class="studiou-fpp-cart-preview">';
+            echo '<img src="' . esc_url($url) . '" alt="' . esc_attr($cart_item['studiou_fpp_file_name'] ?? '') . '" />';
+            echo '</div>';
+        }
+    }
+
+    private function get_cart_item_thumb_url($cart_item) {
+        // 1. Use stored URL from session (most reliable)
+        if (!empty($cart_item['studiou_fpp_thumb_url'])) {
+            return $cart_item['studiou_fpp_thumb_url'];
+        }
+
+        // 2. Try WP attachment lookup
+        if (!empty($cart_item['studiou_fpp_attachment_id'])) {
+            $att_id = (int) $cart_item['studiou_fpp_attachment_id'];
+            $thumb = wp_get_attachment_image_src($att_id, 'thumbnail');
+            if ($thumb) {
+                return $thumb[0];
+            }
+            $url = wp_get_attachment_url($att_id);
+            if ($url) {
+                return $url;
+            }
+        }
+
+        return '';
+    }
+
+    public function save_order_item_meta($item, $cart_item_key, $values, $order) {
+        if (isset($values['studiou_fpp_attachment_id'])) {
+            $item->add_meta_data('_studiou_fpp_attachment_id', $values['studiou_fpp_attachment_id']);
+        }
+        if (isset($values['studiou_fpp_file_record_id'])) {
+            $item->add_meta_data('_studiou_fpp_file_record_id', $values['studiou_fpp_file_record_id']);
+        }
+        if (isset($values['studiou_fpp_file_name'])) {
+            $item->add_meta_data('_studiou_fpp_file_name', $values['studiou_fpp_file_name']);
+            $item->add_meta_data(__('Uploaded Photo', 'studiou-wc-free-photo-product'), $values['studiou_fpp_file_name']);
+        }
+        if (isset($values['studiou_fpp_thumb_url'])) {
+            $item->add_meta_data('_studiou_fpp_thumb_url', $values['studiou_fpp_thumb_url']);
+        }
+    }
+
+    public function link_files_to_order($order_id, $posted_data, $order) {
+        $this->do_link_files($order);
+    }
+
+    /**
+     * Block checkout fires this hook with only the $order parameter.
+     */
+    public function link_files_to_order_from_store_api($order) {
+        $this->do_link_files($order);
+    }
+
+    /**
+     * Fallback: runs on thank-you page to catch any missed linking.
+     */
+    public function link_files_to_order_fallback($order_id) {
+        $order = wc_get_order($order_id);
+        if ($order) {
+            $this->do_link_files($order);
+        }
+    }
+
+    private function do_link_files($order) {
+        if (!$order) {
+            return;
+        }
+        $order_id = $order->get_id();
+        foreach ($order->get_items() as $item_id => $item) {
+            $file_record_id = $item->get_meta('_studiou_fpp_file_record_id');
+            if ($file_record_id) {
+                // Only link if not already linked
+                $record = $this->db->get_file_record((int) $file_record_id);
+                if ($record && (int) $record->order_id === 0) {
+                    $this->db->link_file_to_order((int) $file_record_id, $order_id, $item_id);
+                }
+            }
+        }
+    }
+
+    public function admin_order_item_thumbnail($thumbnail, $item_id, $item) {
+        // Try stored URL first
+        $thumb_url = $item->get_meta('_studiou_fpp_thumb_url');
+        if ($thumb_url) {
+            return '<img src="' . esc_url($thumb_url) . '" alt="" class="wc-block-components-product-image" width="50" height="50" />';
+        }
+
+        // Fallback to attachment lookup
+        $attachment_id = $item->get_meta('_studiou_fpp_attachment_id');
+        if ($attachment_id) {
+            $image = wp_get_attachment_image($attachment_id, 'thumbnail');
+            if ($image) {
+                return $image;
+            }
+            $url = wp_get_attachment_url($attachment_id);
+            if ($url) {
+                return '<img src="' . esc_url($url) . '" alt="" width="50" height="50" />';
+            }
+        }
+        return $thumbnail;
+    }
+
+    public function admin_order_item_download_link($item_id, $item, $product) {
+        $attachment_id = $item->get_meta('_studiou_fpp_attachment_id');
+        if (!$attachment_id) {
+            return;
+        }
+
+        $file_url = wp_get_attachment_url($attachment_id);
+        $file_name = $item->get_meta('_studiou_fpp_file_name');
+        if (!$file_url) {
+            return;
+        }
+
+        $file_record_id = $item->get_meta('_studiou_fpp_file_record_id');
+
+        // Build download URL that also marks file as downloaded
+        $download_url = add_query_arg(array(
+            'studiou_fpp_download_file' => 1,
+            'file_record_id' => $file_record_id ?: 0,
+            'attachment_id' => $attachment_id,
+            '_wpnonce' => wp_create_nonce('studiou-fpp-download-file'),
+        ), admin_url('admin.php'));
+
+        echo '<p class="studiou-fpp-order-download">';
+        echo '<a href="' . esc_url($download_url) . '" class="button button-small">';
+        echo '<span class="dashicons dashicons-download" style="line-height:1.4;vertical-align:middle;"></span> ';
+        echo esc_html__('Download uploaded photo', 'studiou-wc-free-photo-product');
+        echo '</a>';
+        if ($file_name) {
+            echo ' <small>(' . esc_html($file_name) . ')</small>';
+        }
+        echo '</p>';
+    }
+}

studiou-wc-free-photo-product/includes/class-studiou-wc-fpp-db.php

@@ -0,0 +1,283 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+class Studiou_WC_FPP_DB {
+
+    const TABLE_NAME = 'studiou_fpp_files';
+
+    public function __construct() {
+        $this->register_media_taxonomy();
+    }
+
+    private function register_media_taxonomy() {
+        add_action('init', array($this, 'register_media_category_taxonomy'));
+    }
+
+    public function register_media_category_taxonomy() {
+        $labels = array(
+            'name'              => __('Media Categories', 'studiou-wc-free-photo-product'),
+            'singular_name'     => __('Media Category', 'studiou-wc-free-photo-product'),
+            'search_items'      => __('Search Media Categories', 'studiou-wc-free-photo-product'),
+            'all_items'         => __('All Media Categories', 'studiou-wc-free-photo-product'),
+            'parent_item'       => __('Parent Media Category', 'studiou-wc-free-photo-product'),
+            'parent_item_colon' => __('Parent Media Category:', 'studiou-wc-free-photo-product'),
+            'edit_item'         => __('Edit Media Category', 'studiou-wc-free-photo-product'),
+            'update_item'       => __('Update Media Category', 'studiou-wc-free-photo-product'),
+            'add_new_item'      => __('Add New Media Category', 'studiou-wc-free-photo-product'),
+            'new_item_name'     => __('New Media Category Name', 'studiou-wc-free-photo-product'),
+            'menu_name'         => __('Media Categories', 'studiou-wc-free-photo-product'),
+        );
+
+        register_taxonomy('studiou_media_category', 'attachment', array(
+            'hierarchical'      => true,
+            'labels'            => $labels,
+            'show_ui'           => true,
+            'show_admin_column' => true,
+            'query_var'         => true,
+            'rewrite'           => array('slug' => 'media-category'),
+            'show_in_rest'      => true,
+        ));
+    }
+
+    public function get_table_name() {
+        global $wpdb;
+        return $wpdb->prefix . self::TABLE_NAME;
+    }
+
+    public function create_tables() {
+        global $wpdb;
+
+        $table_name = $this->get_table_name();
+        $charset_collate = $wpdb->get_charset_collate();
+
+        $sql = "CREATE TABLE {$table_name} (
+            id bigint(20) unsigned NOT NULL AUTO_INCREMENT,
+            product_id bigint(20) unsigned NOT NULL,
+            variation_id bigint(20) unsigned DEFAULT 0,
+            order_id bigint(20) unsigned DEFAULT 0,
+            order_item_id bigint(20) unsigned DEFAULT 0,
+            attachment_id bigint(20) unsigned NOT NULL,
+            customer_id bigint(20) unsigned DEFAULT 0,
+            session_key varchar(64) DEFAULT '',
+            file_name varchar(255) NOT NULL,
+            status varchar(20) NOT NULL DEFAULT 'ready',
+            created_at datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            updated_at datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            PRIMARY KEY (id),
+            KEY product_id (product_id),
+            KEY order_id (order_id),
+            KEY attachment_id (attachment_id),
+            KEY status (status),
+            KEY customer_id (customer_id)
+        ) {$charset_collate};";
+
+        require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
+        dbDelta($sql);
+
+        update_option('studiou_wcfpp_db_version', STUDIOU_WCFPP_VERSION);
+    }
+
+    public function insert_file_record($data) {
+        global $wpdb;
+
+        $defaults = array(
+            'product_id'    => 0,
+            'variation_id'  => 0,
+            'order_id'      => 0,
+            'order_item_id' => 0,
+            'attachment_id' => 0,
+            'customer_id'   => get_current_user_id(),
+            'session_key'   => '',
+            'file_name'     => '',
+            'status'        => 'ready',
+            'created_at'    => current_time('mysql'),
+            'updated_at'    => current_time('mysql'),
+        );
+
+        $data = wp_parse_args($data, $defaults);
+
+        $result = $wpdb->insert(
+            $this->get_table_name(),
+            $data,
+            array('%d', '%d', '%d', '%d', '%d', '%d', '%s', '%s', '%s', '%s', '%s')
+        );
+
+        if ($result === false) {
+            return false;
+        }
+
+        return $wpdb->insert_id;
+    }
+
+    public function get_file_record($id) {
+        global $wpdb;
+        $table = $this->get_table_name();
+        return $wpdb->get_row($wpdb->prepare("SELECT * FROM {$table} WHERE id = %d", $id));
+    }
+
+    public function get_file_records($args = array()) {
+        global $wpdb;
+        $table = $this->get_table_name();
+
+        $defaults = array(
+            'product_id' => 0,
+            'order_id'   => 0,
+            'status'     => '',
+            'orderby'    => 'created_at',
+            'order'      => 'DESC',
+            'limit'      => 50,
+            'offset'     => 0,
+            'search'     => '',
+        );
+        $args = wp_parse_args($args, $defaults);
+
+        $where = array('1=1');
+        $values = array();
+
+        if (!empty($args['product_id'])) {
+            $where[] = 'product_id = %d';
+            $values[] = $args['product_id'];
+        }
+        if (!empty($args['order_id'])) {
+            $where[] = 'order_id = %d';
+            $values[] = $args['order_id'];
+        }
+        if (!empty($args['status'])) {
+            $where[] = 'status = %s';
+            $values[] = $args['status'];
+        }
+        if (!empty($args['search'])) {
+            $where[] = 'file_name LIKE %s';
+            $values[] = '%' . $wpdb->esc_like($args['search']) . '%';
+        }
+
+        $where_clause = implode(' AND ', $where);
+
+        $allowed_orderby = array('id', 'product_id', 'order_id', 'file_name', 'status', 'created_at', 'updated_at');
+        $orderby = in_array($args['orderby'], $allowed_orderby) ? $args['orderby'] : 'created_at';
+        $order = strtoupper($args['order']) === 'ASC' ? 'ASC' : 'DESC';
+
+        $sql = "SELECT * FROM {$table} WHERE {$where_clause} ORDER BY {$orderby} {$order} LIMIT %d OFFSET %d";
+        $values[] = (int) $args['limit'];
+        $values[] = (int) $args['offset'];
+
+        if (!empty($values)) {
+            $sql = $wpdb->prepare($sql, $values);
+        }
+
+        return $wpdb->get_results($sql);
+    }
+
+    public function count_file_records($args = array()) {
+        global $wpdb;
+        $table = $this->get_table_name();
+
+        $where = array('1=1');
+        $values = array();
+
+        if (!empty($args['product_id'])) {
+            $where[] = 'product_id = %d';
+            $values[] = $args['product_id'];
+        }
+        if (!empty($args['order_id'])) {
+            $where[] = 'order_id = %d';
+            $values[] = $args['order_id'];
+        }
+        if (!empty($args['status'])) {
+            $where[] = 'status = %s';
+            $values[] = $args['status'];
+        }
+        if (!empty($args['search'])) {
+            $where[] = 'file_name LIKE %s';
+            $values[] = '%' . $wpdb->esc_like($args['search']) . '%';
+        }
+
+        $where_clause = implode(' AND ', $where);
+        $sql = "SELECT COUNT(*) FROM {$table} WHERE {$where_clause}";
+
+        if (!empty($values)) {
+            $sql = $wpdb->prepare($sql, $values);
+        }
+
+        return (int) $wpdb->get_var($sql);
+    }
+
+    public function update_file_record($id, $data) {
+        global $wpdb;
+
+        $data['updated_at'] = current_time('mysql');
+
+        return $wpdb->update(
+            $this->get_table_name(),
+            $data,
+            array('id' => $id),
+            null,
+            array('%d')
+        );
+    }
+
+    public function update_file_status($id, $status) {
+        $allowed = array('ready', 'downloaded', 'solved');
+        if (!in_array($status, $allowed)) {
+            return false;
+        }
+        return $this->update_file_record($id, array('status' => $status));
+    }
+
+    public function delete_file_record($id) {
+        global $wpdb;
+
+        $record = $this->get_file_record($id);
+        if (!$record) {
+            return false;
+        }
+
+        // Delete the attachment from media library
+        if ($record->attachment_id) {
+            wp_delete_attachment($record->attachment_id, true);
+        }
+
+        return $wpdb->delete(
+            $this->get_table_name(),
+            array('id' => $id),
+            array('%d')
+        );
+    }
+
+    public function get_file_records_by_ids($ids) {
+        global $wpdb;
+        $table = $this->get_table_name();
+
+        if (empty($ids)) {
+            return array();
+        }
+
+        $ids = array_map('intval', $ids);
+        $placeholders = implode(',', array_fill(0, count($ids), '%d'));
+        $sql = $wpdb->prepare("SELECT * FROM {$table} WHERE id IN ({$placeholders})", $ids);
+
+        return $wpdb->get_results($sql);
+    }
+
+    public function link_file_to_order($file_record_id, $order_id, $order_item_id) {
+        return $this->update_file_record($file_record_id, array(
+            'order_id'      => $order_id,
+            'order_item_id' => $order_item_id,
+        ));
+    }
+
+    public function get_media_categories() {
+        $terms = get_terms(array(
+            'taxonomy'   => 'studiou_media_category',
+            'hide_empty' => false,
+        ));
+
+        if (is_wp_error($terms)) {
+            return array();
+        }
+
+        return $terms;
+    }
+}

studiou-wc-free-photo-product/includes/class-studiou-wc-fpp-product.php

@@ -0,0 +1,235 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+class Studiou_WC_FPP_Product {
+
+    public function __construct() {
+        // Add product data tab
+        add_filter('woocommerce_product_data_tabs', array($this, 'add_product_data_tab'));
+        add_action('woocommerce_product_data_panels', array($this, 'add_product_data_panel'));
+        add_action('woocommerce_process_product_meta', array($this, 'save_product_meta'));
+
+        // AJAX for adding new media category from product edit page
+        add_action('wp_ajax_studiou_wcfpp_add_media_category', array($this, 'ajax_add_media_category'));
+    }
+
+    public function add_product_data_tab($tabs) {
+        $tabs['studiou_fpp'] = array(
+            'label'    => __('Free Photo', 'studiou-wc-free-photo-product'),
+            'target'   => 'studiou_fpp_product_data',
+            'class'    => array('show_if_variable'),
+            'priority' => 80,
+        );
+        return $tabs;
+    }
+
+    public function add_product_data_panel() {
+        global $post;
+        $product_id = $post->ID;
+
+        $enabled = get_post_meta($product_id, '_studiou_fpp_enabled', true);
+        $media_category = get_post_meta($product_id, '_studiou_fpp_media_category', true);
+        $max_file_size = get_post_meta($product_id, '_studiou_fpp_max_file_size', true);
+        $upload_info_text = get_post_meta($product_id, '_studiou_fpp_upload_info_text', true);
+        $min_width = get_post_meta($product_id, '_studiou_fpp_min_width', true);
+        $min_height = get_post_meta($product_id, '_studiou_fpp_min_height', true);
+        $max_width = get_post_meta($product_id, '_studiou_fpp_max_width', true);
+        $max_height = get_post_meta($product_id, '_studiou_fpp_max_height', true);
+
+        if (empty($max_file_size)) {
+            $max_file_size = 50;
+        }
+
+        $categories = get_terms(array(
+            'taxonomy'   => 'studiou_media_category',
+            'hide_empty' => false,
+        ));
+        if (is_wp_error($categories)) {
+            $categories = array();
+        }
+        ?>
+        <div id="studiou_fpp_product_data" class="panel woocommerce_options_panel">
+            <div class="options_group">
+                <?php
+                woocommerce_wp_checkbox(array(
+                    'id'          => '_studiou_fpp_enabled',
+                    'label'       => __('Enable Free Photo', 'studiou-wc-free-photo-product'),
+                    'description' => __('Enable custom photo upload for this product', 'studiou-wc-free-photo-product'),
+                    'value'       => $enabled,
+                ));
+                ?>
+            </div>
+
+            <div class="options_group">
+                <p class="form-field _studiou_fpp_media_category_field">
+                    <label for="_studiou_fpp_media_category"><?php esc_html_e('Media Category', 'studiou-wc-free-photo-product'); ?></label>
+                    <select id="_studiou_fpp_media_category" name="_studiou_fpp_media_category" class="select short">
+                        <option value=""><?php esc_html_e('— Select category —', 'studiou-wc-free-photo-product'); ?></option>
+                        <?php foreach ($categories as $cat) : ?>
+                            <option value="<?php echo esc_attr($cat->term_id); ?>" <?php selected($media_category, $cat->term_id); ?>>
+                                <?php echo esc_html($cat->name); ?>
+                            </option>
+                        <?php endforeach; ?>
+                    </select>
+                    <button type="button" class="button studiou-fpp-add-media-cat-btn" title="<?php esc_attr_e('Add New Category', 'studiou-wc-free-photo-product'); ?>">+</button>
+                    <?php echo wc_help_tip(__('Uploaded files will be assigned to this media category.', 'studiou-wc-free-photo-product')); ?>
+                </p>
+
+                <div class="studiou-fpp-new-media-cat-form" style="display:none;">
+                    <p class="form-field">
+                        <label for="studiou_fpp_new_cat_name"><?php esc_html_e('New Category Name', 'studiou-wc-free-photo-product'); ?></label>
+                        <input type="text" id="studiou_fpp_new_cat_name" class="short" />
+                        <button type="button" class="button studiou-fpp-save-media-cat-btn"><?php esc_html_e('Add', 'studiou-wc-free-photo-product'); ?></button>
+                        <button type="button" class="button studiou-fpp-cancel-media-cat-btn"><?php esc_html_e('Cancel', 'studiou-wc-free-photo-product'); ?></button>
+                    </p>
+                </div>
+            </div>
+
+            <div class="options_group">
+                <?php
+                woocommerce_wp_text_input(array(
+                    'id'                => '_studiou_fpp_max_file_size',
+                    'label'             => __('Max File Size (MB)', 'studiou-wc-free-photo-product'),
+                    'description'       => __('Maximum allowed file size for uploads in megabytes.', 'studiou-wc-free-photo-product'),
+                    'desc_tip'          => true,
+                    'type'              => 'number',
+                    'custom_attributes' => array(
+                        'step' => '1',
+                        'min'  => '1',
+                        'max'  => '500',
+                    ),
+                    'value'             => $max_file_size,
+                ));
+                ?>
+            </div>
+
+            <div class="options_group">
+                <p class="form-field">
+                    <label><?php esc_html_e('Min Image Resolution (px)', 'studiou-wc-free-photo-product'); ?></label>
+                    <span class="wrap">
+                        <input type="number" id="_studiou_fpp_min_width" name="_studiou_fpp_min_width" class="short" style="width:80px;" min="0" step="1" value="<?php echo esc_attr($min_width); ?>" placeholder="<?php esc_attr_e('Width', 'studiou-wc-free-photo-product'); ?>" />
+                        &times;
+                        <input type="number" id="_studiou_fpp_min_height" name="_studiou_fpp_min_height" class="short" style="width:80px;" min="0" step="1" value="<?php echo esc_attr($min_height); ?>" placeholder="<?php esc_attr_e('Height', 'studiou-wc-free-photo-product'); ?>" />
+                    </span>
+                    <?php echo wc_help_tip(__('Minimum image resolution in pixels. Leave empty to skip. Width and height are interchangeable (portrait/landscape auto-detected).', 'studiou-wc-free-photo-product')); ?>
+                </p>
+                <p class="form-field">
+                    <label><?php esc_html_e('Max Image Resolution (px)', 'studiou-wc-free-photo-product'); ?></label>
+                    <span class="wrap">
+                        <input type="number" id="_studiou_fpp_max_width" name="_studiou_fpp_max_width" class="short" style="width:80px;" min="0" step="1" value="<?php echo esc_attr($max_width); ?>" placeholder="<?php esc_attr_e('Width', 'studiou-wc-free-photo-product'); ?>" />
+                        &times;
+                        <input type="number" id="_studiou_fpp_max_height" name="_studiou_fpp_max_height" class="short" style="width:80px;" min="0" step="1" value="<?php echo esc_attr($max_height); ?>" placeholder="<?php esc_attr_e('Height', 'studiou-wc-free-photo-product'); ?>" />
+                    </span>
+                    <?php echo wc_help_tip(__('Maximum image resolution in pixels. Leave empty to skip. Width and height are interchangeable (portrait/landscape auto-detected).', 'studiou-wc-free-photo-product')); ?>
+                </p>
+            </div>
+
+            <div class="options_group">
+                <?php
+                woocommerce_wp_textarea_input(array(
+                    'id'          => '_studiou_fpp_upload_info_text',
+                    'label'       => __('Upload Info Text', 'studiou-wc-free-photo-product'),
+                    'description' => __('Custom text displayed above the upload area on the product page. Leave empty for default text.', 'studiou-wc-free-photo-product'),
+                    'desc_tip'    => true,
+                    'value'       => $upload_info_text,
+                    'style'       => 'height:80px;',
+                ));
+                ?>
+            </div>
+
+            <div class="options_group">
+                <p class="form-field">
+                    <label><?php esc_html_e('Shortcode', 'studiou-wc-free-photo-product'); ?></label>
+                    <code id="studiou-fpp-shortcode-display">[studiou_free_photo_product id="<?php echo esc_attr($product_id); ?>"]</code>
+                    <?php echo wc_help_tip(__('Use this shortcode to display this product with photo upload on any page.', 'studiou-wc-free-photo-product')); ?>
+                </p>
+            </div>
+        </div>
+        <?php
+    }
+
+    public function save_product_meta($product_id) {
+        $enabled = isset($_POST['_studiou_fpp_enabled']) ? 'yes' : 'no';
+        update_post_meta($product_id, '_studiou_fpp_enabled', $enabled);
+
+        if (isset($_POST['_studiou_fpp_media_category'])) {
+            update_post_meta($product_id, '_studiou_fpp_media_category', absint($_POST['_studiou_fpp_media_category']));
+        }
+
+        if (isset($_POST['_studiou_fpp_max_file_size'])) {
+            $max_size = absint($_POST['_studiou_fpp_max_file_size']);
+            if ($max_size < 1) $max_size = 1;
+            if ($max_size > 500) $max_size = 500;
+            update_post_meta($product_id, '_studiou_fpp_max_file_size', $max_size);
+        }
+
+        if (isset($_POST['_studiou_fpp_upload_info_text'])) {
+            update_post_meta($product_id, '_studiou_fpp_upload_info_text', sanitize_textarea_field($_POST['_studiou_fpp_upload_info_text']));
+        }
+
+        // Resolution limits (0 or empty = no limit)
+        $res_fields = array('_studiou_fpp_min_width', '_studiou_fpp_min_height', '_studiou_fpp_max_width', '_studiou_fpp_max_height');
+        foreach ($res_fields as $field) {
+            $val = isset($_POST[$field]) ? absint($_POST[$field]) : 0;
+            update_post_meta($product_id, $field, $val ?: '');
+        }
+    }
+
+    public function ajax_add_media_category() {
+        check_ajax_referer('studiou-wcfpp-nonce', 'nonce');
+
+        if (!current_user_can('manage_woocommerce')) {
+            wp_send_json_error(array('message' => __('Insufficient permissions.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $name = isset($_POST['name']) ? sanitize_text_field($_POST['name']) : '';
+        if (empty($name)) {
+            wp_send_json_error(array('message' => __('Category name is required.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $term = wp_insert_term($name, 'studiou_media_category');
+        if (is_wp_error($term)) {
+            wp_send_json_error(array('message' => $term->get_error_message()));
+            return;
+        }
+
+        wp_send_json_success(array(
+            'term_id' => $term['term_id'],
+            'name'    => $name,
+        ));
+    }
+
+    public static function is_fpp_product($product_id) {
+        return get_post_meta($product_id, '_studiou_fpp_enabled', true) === 'yes';
+    }
+
+    public static function get_product_max_file_size($product_id) {
+        $size = get_post_meta($product_id, '_studiou_fpp_max_file_size', true);
+        return !empty($size) ? (int) $size : 50;
+    }
+
+    public static function get_product_upload_info_text($product_id) {
+        return get_post_meta($product_id, '_studiou_fpp_upload_info_text', true);
+    }
+
+    public static function get_product_media_category($product_id) {
+        return (int) get_post_meta($product_id, '_studiou_fpp_media_category', true);
+    }
+
+    /**
+     * Get resolution limits for a product.
+     * Returns array with min_width, min_height, max_width, max_height (0 = no limit).
+     */
+    public static function get_product_resolution_limits($product_id) {
+        return array(
+            'min_width'  => (int) get_post_meta($product_id, '_studiou_fpp_min_width', true),
+            'min_height' => (int) get_post_meta($product_id, '_studiou_fpp_min_height', true),
+            'max_width'  => (int) get_post_meta($product_id, '_studiou_fpp_max_width', true),
+            'max_height' => (int) get_post_meta($product_id, '_studiou_fpp_max_height', true),
+        );
+    }
+}

studiou-wc-free-photo-product/includes/class-studiou-wc-fpp-shortcode.php

@@ -0,0 +1,61 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+class Studiou_WC_FPP_Shortcode {
+
+    public function __construct() {
+        add_shortcode('studiou_free_photo_product', array($this, 'render_shortcode'));
+    }
+
+    public function render_shortcode($atts) {
+        $atts = shortcode_atts(array(
+            'id' => 0,
+        ), $atts, 'studiou_free_photo_product');
+
+        $product_id = absint($atts['id']);
+        if (!$product_id) {
+            return '<p class="studiou-fpp-error">' . esc_html__('Product ID is required.', 'studiou-wc-free-photo-product') . '</p>';
+        }
+
+        $product = wc_get_product($product_id);
+        if (!$product) {
+            return '<p class="studiou-fpp-error">' . esc_html__('Product not found.', 'studiou-wc-free-photo-product') . '</p>';
+        }
+
+        if (!Studiou_WC_FPP_Product::is_fpp_product($product_id)) {
+            return '<p class="studiou-fpp-error">' . esc_html__('This product does not support photo upload.', 'studiou-wc-free-photo-product') . '</p>';
+        }
+
+        if (!$product->is_type('variable')) {
+            return '<p class="studiou-fpp-error">' . esc_html__('This product must be a variable product.', 'studiou-wc-free-photo-product') . '</p>';
+        }
+
+        // Enqueue assets
+        wp_enqueue_style('studiou-wcfpp-frontend');
+        wp_enqueue_script('studiou-wcfpp-frontend');
+
+        $max_file_size = Studiou_WC_FPP_Product::get_product_max_file_size($product_id);
+
+        // Set global product so WC template functions work
+        global $post;
+        $original_post = $post;
+        $post = get_post($product_id);
+        setup_postdata($post);
+
+        ob_start();
+        include STUDIOU_WCFPP_PLUGIN_DIR . 'views/frontend-product.php';
+        $output = ob_get_clean();
+
+        // Restore original post
+        $post = $original_post;
+        if ($original_post) {
+            setup_postdata($original_post);
+        } else {
+            wp_reset_postdata();
+        }
+
+        return $output;
+    }
+}

studiou-wc-free-photo-product/includes/class-studiou-wc-fpp-single-product.php

@@ -0,0 +1,165 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+class Studiou_WC_FPP_Single_Product {
+
+    public function __construct() {
+        // Render upload area below the variation table on single product page
+        add_action('woocommerce_single_product_summary', array($this, 'render_upload_area'), 35);
+
+        // Server-side validation: block add-to-cart without photo (priority 1 = very early)
+        add_filter('woocommerce_add_to_cart_validation', array($this, 'validate_add_to_cart'), 1, 6);
+
+        // Safety net: if item was added without photo, remove it immediately
+        add_action('woocommerce_add_to_cart', array($this, 'check_after_add_to_cart'), 10, 6);
+
+        // AJAX: store uploaded file reference in WC session
+        add_action('wp_ajax_studiou_wcfpp_set_upload_session', array($this, 'ajax_set_upload_session'));
+        add_action('wp_ajax_nopriv_studiou_wcfpp_set_upload_session', array($this, 'ajax_set_upload_session'));
+        add_action('wp_ajax_studiou_wcfpp_clear_upload_session', array($this, 'ajax_clear_upload_session'));
+        add_action('wp_ajax_nopriv_studiou_wcfpp_clear_upload_session', array($this, 'ajax_clear_upload_session'));
+    }
+
+    public function render_upload_area() {
+        global $product;
+        if (!$product || !Studiou_WC_FPP_Product::is_fpp_product($product->get_id())) {
+            return;
+        }
+
+        wp_enqueue_style('studiou-wcfpp-frontend');
+        wp_enqueue_script('studiou-wcfpp-frontend');
+
+        $product_id = $product->get_id();
+        $max_file_size = Studiou_WC_FPP_Product::get_product_max_file_size($product_id);
+
+        // Pass existing session state to JS for restore on page load
+        $session_data = array();
+        if (WC()->session) {
+            $att_id = WC()->session->get('studiou_fpp_attachment_id');
+            if ($att_id) {
+                $thumb = wp_get_attachment_image_src($att_id, 'thumbnail');
+                $preview = wp_get_attachment_image_src($att_id, 'woocommerce_single');
+                $session_data = array(
+                    'attachment_id'  => $att_id,
+                    'file_record_id' => WC()->session->get('studiou_fpp_file_record_id'),
+                    'file_name'      => WC()->session->get('studiou_fpp_file_name'),
+                    'thumbnail_url'  => $thumb ? $thumb[0] : '',
+                    'preview_url'    => $preview ? $preview[0] : ($thumb ? $thumb[0] : ''),
+                );
+            }
+        }
+
+        wp_localize_script('studiou-wcfpp-frontend', 'studiouWcfppSession', $session_data);
+
+        include STUDIOU_WCFPP_PLUGIN_DIR . 'views/single-product-upload.php';
+    }
+
+    /**
+     * Resolve whether a product_id or its parent is FPP-enabled.
+     */
+    private function resolve_fpp_product_id($product_id, $variation_id = 0) {
+        // Check direct product
+        if (Studiou_WC_FPP_Product::is_fpp_product($product_id)) {
+            return $product_id;
+        }
+
+        // Check parent of the product (in case product_id is variation)
+        $product = wc_get_product($product_id);
+        if ($product && $product->get_parent_id() && Studiou_WC_FPP_Product::is_fpp_product($product->get_parent_id())) {
+            return $product->get_parent_id();
+        }
+
+        // Check variation_id's parent
+        if ($variation_id && $variation_id !== $product_id) {
+            $variation = wc_get_product($variation_id);
+            if ($variation && $variation->get_parent_id() && Studiou_WC_FPP_Product::is_fpp_product($variation->get_parent_id())) {
+                return $variation->get_parent_id();
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Validate before add-to-cart: block if FPP product and no photo in session.
+     */
+    public function validate_add_to_cart($passed, $product_id, $quantity, $variation_id = 0, $variations = array(), $cart_item_data = array()) {
+        $fpp_id = $this->resolve_fpp_product_id($product_id, $variation_id);
+        if (!$fpp_id) {
+            return $passed;
+        }
+
+        // Check WC session for uploaded file
+        if (WC()->session) {
+            $attachment_id = WC()->session->get('studiou_fpp_attachment_id');
+            if ($attachment_id) {
+                return $passed;
+            }
+        }
+
+        wc_add_notice(__('Please upload a photo before adding to cart.', 'studiou-wc-free-photo-product'), 'error');
+        return false;
+    }
+
+    /**
+     * Safety net: if an FPP item was added without photo data, remove it.
+     * This catches cases where validation was somehow bypassed.
+     */
+    public function check_after_add_to_cart($cart_item_key, $product_id, $quantity, $variation_id, $variation, $cart_item_data) {
+        $fpp_id = $this->resolve_fpp_product_id($product_id, $variation_id);
+        if (!$fpp_id) {
+            return;
+        }
+
+        // If the cart item has no FPP attachment, remove it
+        if (empty($cart_item_data['studiou_fpp_attachment_id'])) {
+            WC()->cart->remove_cart_item($cart_item_key);
+            wc_add_notice(__('Please upload a photo before adding to cart.', 'studiou-wc-free-photo-product'), 'error');
+        }
+    }
+
+    public function ajax_set_upload_session() {
+        check_ajax_referer('studiou-wcfpp-front-nonce', 'nonce');
+
+        $attachment_id = isset($_POST['attachment_id']) ? absint($_POST['attachment_id']) : 0;
+        $file_record_id = isset($_POST['file_record_id']) ? absint($_POST['file_record_id']) : 0;
+        $file_name = isset($_POST['file_name']) ? sanitize_text_field($_POST['file_name']) : '';
+
+        if (!$attachment_id || !$file_record_id) {
+            wp_send_json_error(array('message' => __('Invalid file data.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        if (WC()->session) {
+            WC()->session->set('studiou_fpp_attachment_id', $attachment_id);
+            WC()->session->set('studiou_fpp_file_record_id', $file_record_id);
+            WC()->session->set('studiou_fpp_file_name', $file_name);
+
+            // Store thumbnail URL directly so it can be used in cart without wp_get_attachment lookup
+            $thumb_url = '';
+            $thumb = wp_get_attachment_image_src($attachment_id, 'thumbnail');
+            if ($thumb) {
+                $thumb_url = $thumb[0];
+            } else {
+                $thumb_url = wp_get_attachment_url($attachment_id);
+            }
+            WC()->session->set('studiou_fpp_thumb_url', $thumb_url ?: '');
+        }
+
+        wp_send_json_success();
+    }
+
+    public function ajax_clear_upload_session() {
+        check_ajax_referer('studiou-wcfpp-front-nonce', 'nonce');
+
+        if (WC()->session) {
+            WC()->session->set('studiou_fpp_attachment_id', null);
+            WC()->session->set('studiou_fpp_file_record_id', null);
+            WC()->session->set('studiou_fpp_file_name', null);
+        }
+
+        wp_send_json_success();
+    }
+}

studiou-wc-free-photo-product/includes/class-studiou-wc-fpp-upload.php

@@ -0,0 +1,391 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+class Studiou_WC_FPP_Upload {
+
+    /** @var Studiou_WC_FPP_DB */
+    private $db;
+
+    public function __construct($db) {
+        $this->db = $db;
+        add_action('wp_ajax_studiou_wcfpp_upload_chunk', array($this, 'handle_chunk_upload'));
+        add_action('wp_ajax_nopriv_studiou_wcfpp_upload_chunk', array($this, 'handle_chunk_upload'));
+        add_action('wp_ajax_studiou_wcfpp_remove_upload', array($this, 'handle_remove_upload'));
+        add_action('wp_ajax_nopriv_studiou_wcfpp_remove_upload', array($this, 'handle_remove_upload'));
+    }
+
+    private function get_chunks_dir() {
+        $upload_dir = wp_upload_dir();
+        return $upload_dir['basedir'] . '/studiou-fpp-chunks';
+    }
+
+    private function get_allowed_mime_types() {
+        return array(
+            'jpg|jpeg|jpe' => 'image/jpeg',
+            'png'          => 'image/png',
+            'tiff|tif'     => 'image/tiff',
+            'bmp'          => 'image/bmp',
+            'psd'          => 'image/vnd.adobe.photoshop',
+            'cr2'          => 'image/x-canon-cr2',
+            'nef'          => 'image/x-nikon-nef',
+            'arw'          => 'image/x-sony-arw',
+            'dng'          => 'image/x-adobe-dng',
+            'orf'          => 'image/x-olympus-orf',
+            'rw2'          => 'image/x-panasonic-rw2',
+            'raf'          => 'image/x-fuji-raf',
+            'webp'         => 'image/webp',
+        );
+    }
+
+    public function handle_chunk_upload() {
+        // Clean output buffers
+        while (ob_get_level()) {
+            ob_end_clean();
+        }
+
+        check_ajax_referer('studiou-wcfpp-front-nonce', 'nonce');
+
+        $product_id  = isset($_POST['product_id']) ? absint($_POST['product_id']) : 0;
+        $upload_id   = isset($_POST['upload_id']) ? sanitize_text_field($_POST['upload_id']) : '';
+        $chunk_index = isset($_POST['chunk_index']) ? absint($_POST['chunk_index']) : 0;
+        $total_chunks = isset($_POST['total_chunks']) ? absint($_POST['total_chunks']) : 0;
+        $file_name   = isset($_POST['file_name']) ? sanitize_file_name($_POST['file_name']) : '';
+        $file_size   = isset($_POST['file_size']) ? absint($_POST['file_size']) : 0;
+
+        // Validate product
+        if (!$product_id || !Studiou_WC_FPP_Product::is_fpp_product($product_id)) {
+            wp_send_json_error(array('message' => __('Invalid product.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        // Validate file size
+        $max_size = Studiou_WC_FPP_Product::get_product_max_file_size($product_id);
+        if ($file_size > ($max_size * 1024 * 1024)) {
+            wp_send_json_error(array('message' => sprintf(
+                __('File is too large. Maximum size: %s MB', 'studiou-wc-free-photo-product'),
+                $max_size
+            )));
+            return;
+        }
+
+        // Validate upload_id format (should be alphanumeric)
+        if (!preg_match('/^[a-zA-Z0-9_-]+$/', $upload_id)) {
+            wp_send_json_error(array('message' => __('Invalid upload ID.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        // Validate chunk file exists
+        if (!isset($_FILES['chunk']) || $_FILES['chunk']['error'] !== UPLOAD_ERR_OK) {
+            wp_send_json_error(array('message' => __('Chunk upload failed.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $chunks_dir = $this->get_chunks_dir();
+        if (!file_exists($chunks_dir)) {
+            wp_mkdir_p($chunks_dir);
+        }
+
+        // Store the chunk
+        $chunk_file = $chunks_dir . '/' . $upload_id . '_chunk_' . $chunk_index;
+        if (!move_uploaded_file($_FILES['chunk']['tmp_name'], $chunk_file)) {
+            wp_send_json_error(array('message' => __('Failed to store chunk.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        // If this is the last chunk, assemble the file
+        if ($chunk_index === $total_chunks - 1) {
+            // Clean any output that may have been generated
+            while (ob_get_level()) {
+                ob_end_clean();
+            }
+
+            $result = $this->assemble_chunks($upload_id, $total_chunks, $file_name, $product_id);
+
+            // Clean again before sending JSON
+            while (ob_get_level()) {
+                ob_end_clean();
+            }
+
+            if (is_wp_error($result)) {
+                wp_send_json_error(array('message' => $result->get_error_message()));
+                return;
+            }
+
+            wp_send_json_success(array(
+                'complete'       => true,
+                'attachment_id'  => $result['attachment_id'],
+                'file_record_id' => $result['file_record_id'],
+                'thumbnail_url'  => $result['thumbnail_url'],
+                'preview_url'    => $result['preview_url'],
+                'file_name'      => $result['file_name'],
+            ));
+            return;
+        }
+
+        wp_send_json_success(array(
+            'complete'    => false,
+            'chunk_index' => $chunk_index,
+        ));
+    }
+
+    private function assemble_chunks($upload_id, $total_chunks, $file_name, $product_id) {
+        $chunks_dir = $this->get_chunks_dir();
+        $upload_dir = wp_upload_dir();
+
+        // Create a subdirectory for free photo uploads
+        $fpp_dir = $upload_dir['path'] . '/free-photo';
+        if (!file_exists($fpp_dir)) {
+            wp_mkdir_p($fpp_dir);
+        }
+
+        // Generate unique filename
+        $ext = pathinfo($file_name, PATHINFO_EXTENSION);
+        $base = sanitize_file_name(pathinfo($file_name, PATHINFO_FILENAME));
+        $unique_name = $base . '_' . uniqid() . '.' . $ext;
+        $assembled_path = $fpp_dir . '/' . $unique_name;
+
+        // Assemble chunks
+        $output = fopen($assembled_path, 'wb');
+        if (!$output) {
+            $this->cleanup_chunks($upload_id, $total_chunks);
+            return new WP_Error('assemble_failed', __('Failed to create output file.', 'studiou-wc-free-photo-product'));
+        }
+
+        for ($i = 0; $i < $total_chunks; $i++) {
+            $chunk_file = $chunks_dir . '/' . $upload_id . '_chunk_' . $i;
+            if (!file_exists($chunk_file)) {
+                fclose($output);
+                unlink($assembled_path);
+                $this->cleanup_chunks($upload_id, $total_chunks);
+                return new WP_Error('chunk_missing', sprintf(
+                    __('Missing chunk %d.', 'studiou-wc-free-photo-product'),
+                    $i
+                ));
+            }
+
+            $chunk_data = file_get_contents($chunk_file);
+            fwrite($output, $chunk_data);
+        }
+        fclose($output);
+
+        // Clean up chunk files
+        $this->cleanup_chunks($upload_id, $total_chunks);
+
+        // Validate file extension
+        $allowed = $this->get_allowed_mime_types();
+        $ext_lower = strtolower($ext);
+        $valid = false;
+        foreach ($allowed as $exts => $mime) {
+            $ext_list = explode('|', $exts);
+            if (in_array($ext_lower, $ext_list)) {
+                $valid = true;
+                break;
+            }
+        }
+        if (!$valid) {
+            unlink($assembled_path);
+            return new WP_Error('invalid_type', __('File type not allowed.', 'studiou-wc-free-photo-product'));
+        }
+
+        // Validate image resolution (if limits are set)
+        $res_error = $this->validate_image_resolution($assembled_path, $product_id);
+        if (is_wp_error($res_error)) {
+            unlink($assembled_path);
+            return $res_error;
+        }
+
+        // Create WP attachment
+        $relative_path = str_replace($upload_dir['basedir'] . '/', '', $assembled_path);
+        $filetype = wp_check_filetype($unique_name, $allowed);
+
+        $attachment_data = array(
+            'post_mime_type' => $filetype['type'] ?: 'application/octet-stream',
+            'post_title'     => sanitize_file_name($file_name),
+            'post_content'   => '',
+            'post_status'    => 'inherit',
+            'post_parent'    => $product_id,
+        );
+
+        $attachment_id = wp_insert_attachment($attachment_data, $assembled_path, $product_id);
+        if (is_wp_error($attachment_id)) {
+            unlink($assembled_path);
+            return $attachment_id;
+        }
+
+        // Generate metadata (wrapped in output buffer to prevent stray output corrupting JSON)
+        require_once(ABSPATH . 'wp-admin/includes/image.php');
+        ob_start();
+        try {
+            @set_time_limit(120);
+            $metadata = @wp_generate_attachment_metadata($attachment_id, $assembled_path);
+            if (!empty($metadata)) {
+                wp_update_attachment_metadata($attachment_id, $metadata);
+            }
+        } catch (\Throwable $e) {
+            if (defined('WP_DEBUG') && WP_DEBUG) {
+                error_log('STUDIOU FPP: metadata generation failed - ' . $e->getMessage());
+            }
+        }
+        ob_end_clean();
+
+        // Assign media category
+        $media_cat_id = Studiou_WC_FPP_Product::get_product_media_category($product_id);
+        if ($media_cat_id) {
+            wp_set_object_terms($attachment_id, array((int) $media_cat_id), 'studiou_media_category');
+        }
+
+        // Get thumbnail URL (small - for upload preview)
+        $thumbnail_url = '';
+        $image_src = wp_get_attachment_image_src($attachment_id, 'thumbnail');
+        if ($image_src) {
+            $thumbnail_url = $image_src[0];
+        } else {
+            $thumbnail_url = wp_mime_type_icon($attachment_id);
+        }
+
+        // Get preview URL (larger - for product gallery replacement)
+        $preview_url = '';
+        $preview_src = wp_get_attachment_image_src($attachment_id, 'woocommerce_single');
+        if ($preview_src) {
+            $preview_url = $preview_src[0];
+        } elseif ($image_src) {
+            $preview_url = $image_src[0];
+        }
+
+        // Get session key for guests
+        $session_key = '';
+        if (!is_user_logged_in()) {
+            if (WC()->session) {
+                $session_key = WC()->session->get_customer_id();
+            }
+        }
+
+        // Insert file record
+        $file_record_id = $this->db->insert_file_record(array(
+            'product_id'    => $product_id,
+            'attachment_id' => $attachment_id,
+            'customer_id'   => get_current_user_id(),
+            'session_key'   => $session_key,
+            'file_name'     => $file_name,
+        ));
+
+        if (!$file_record_id) {
+            wp_delete_attachment($attachment_id, true);
+            return new WP_Error('record_failed', __('Failed to create file record.', 'studiou-wc-free-photo-product'));
+        }
+
+        return array(
+            'attachment_id'  => $attachment_id,
+            'file_record_id' => $file_record_id,
+            'thumbnail_url'  => $thumbnail_url,
+            'preview_url'    => $preview_url,
+            'file_name'      => $file_name,
+        );
+    }
+
+    /**
+     * Validate image resolution against product limits.
+     * Width/height are commutable — a 3000x2000 image matches both 3000x2000 and 2000x3000 limits.
+     */
+    private function validate_image_resolution($file_path, $product_id) {
+        $limits = Studiou_WC_FPP_Product::get_product_resolution_limits($product_id);
+
+        // Skip if no limits set
+        $has_min = ($limits['min_width'] > 0 || $limits['min_height'] > 0);
+        $has_max = ($limits['max_width'] > 0 || $limits['max_height'] > 0);
+        if (!$has_min && !$has_max) {
+            return true;
+        }
+
+        // Get image dimensions
+        $size = @getimagesize($file_path);
+        if (!$size || !isset($size[0], $size[1])) {
+            // Cannot determine dimensions (e.g. RAW files) — skip validation
+            return true;
+        }
+
+        $img_w = $size[0];
+        $img_h = $size[1];
+
+        // Normalize: always compare min(w,h) vs min(limit_w,limit_h) and max(w,h) vs max(limit_w,limit_h)
+        // This makes portrait/landscape interchangeable
+        $img_short = min($img_w, $img_h);
+        $img_long = max($img_w, $img_h);
+
+        // Minimum resolution check
+        if ($has_min) {
+            $min_short = min($limits['min_width'] ?: 0, $limits['min_height'] ?: 0);
+            $min_long = max($limits['min_width'] ?: 0, $limits['min_height'] ?: 0);
+            // If only one dimension is set, use it for both
+            if ($min_short === 0) $min_short = $min_long;
+
+            if ($img_short < $min_short || $img_long < $min_long) {
+                return new WP_Error('resolution_too_small', sprintf(
+                    __('Image resolution %1$dx%2$d px is too small. Minimum required: %3$dx%4$d px.', 'studiou-wc-free-photo-product'),
+                    $img_w, $img_h, $limits['min_width'] ?: $limits['min_height'], $limits['min_height'] ?: $limits['min_width']
+                ));
+            }
+        }
+
+        // Maximum resolution check
+        if ($has_max) {
+            $max_short = min($limits['max_width'] ?: PHP_INT_MAX, $limits['max_height'] ?: PHP_INT_MAX);
+            $max_long = max($limits['max_width'] ?: PHP_INT_MAX, $limits['max_height'] ?: PHP_INT_MAX);
+            if ($max_short === PHP_INT_MAX) $max_short = $max_long;
+
+            if ($img_short > $max_short || $img_long > $max_long) {
+                return new WP_Error('resolution_too_large', sprintf(
+                    __('Image resolution %1$dx%2$d px is too large. Maximum allowed: %3$dx%4$d px.', 'studiou-wc-free-photo-product'),
+                    $img_w, $img_h, $limits['max_width'] ?: $limits['max_height'], $limits['max_height'] ?: $limits['max_width']
+                ));
+            }
+        }
+
+        return true;
+    }
+
+    private function cleanup_chunks($upload_id, $total_chunks) {
+        $chunks_dir = $this->get_chunks_dir();
+        for ($i = 0; $i < $total_chunks; $i++) {
+            $chunk_file = $chunks_dir . '/' . $upload_id . '_chunk_' . $i;
+            if (file_exists($chunk_file)) {
+                unlink($chunk_file);
+            }
+        }
+    }
+
+    public function handle_remove_upload() {
+        check_ajax_referer('studiou-wcfpp-front-nonce', 'nonce');
+
+        $file_record_id = isset($_POST['file_record_id']) ? absint($_POST['file_record_id']) : 0;
+        if (!$file_record_id) {
+            wp_send_json_error(array('message' => __('Invalid file.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $record = $this->db->get_file_record($file_record_id);
+        if (!$record) {
+            wp_send_json_error(array('message' => __('File not found.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        // Only allow removal if not yet linked to an order
+        if ($record->order_id > 0) {
+            wp_send_json_error(array('message' => __('Cannot remove a file linked to an order.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        // Verify ownership
+        $current_user_id = get_current_user_id();
+        if ($current_user_id > 0 && (int) $record->customer_id !== $current_user_id) {
+            wp_send_json_error(array('message' => __('Permission denied.', 'studiou-wc-free-photo-product')));
+            return;
+        }
+
+        $this->db->delete_file_record($file_record_id);
+
+        wp_send_json_success(array('message' => __('File removed.', 'studiou-wc-free-photo-product')));
+    }
+}

studiou-wc-free-photo-product/languages/generate-mo.php

@@ -0,0 +1,146 @@
+<?php
+/**
+ * Generate .mo files from .po files.
+ * Run: php generate-mo.php
+ * Or use Poedit / WP-CLI: wp i18n make-mo .
+ */
+
+if (php_sapi_name() !== 'cli') {
+    die('CLI only');
+}
+
+$dir = __DIR__;
+$po_files = glob($dir . '/*.po');
+
+foreach ($po_files as $po_file) {
+    $mo_file = preg_replace('/\.po$/', '.mo', $po_file);
+    echo "Converting: " . basename($po_file) . " -> " . basename($mo_file) . "\n";
+
+    $entries = parse_po($po_file);
+    write_mo($mo_file, $entries);
+    echo "Done. " . count($entries) . " entries.\n";
+}
+
+function parse_po($file) {
+    $content = file_get_contents($file);
+    $entries = array();
+    $current_msgid = null;
+    $current_msgstr = array();
+    $current_msgid_plural = null;
+    $state = '';
+
+    $lines = explode("\n", $content);
+    foreach ($lines as $line) {
+        $line = trim($line);
+
+        // Skip comments
+        if (empty($line) || $line[0] === '#') {
+            if ($current_msgid !== null && $state !== '') {
+                save_entry($entries, $current_msgid, $current_msgid_plural, $current_msgstr);
+                $current_msgid = null;
+                $current_msgid_plural = null;
+                $current_msgstr = array();
+                $state = '';
+            }
+            continue;
+        }
+
+        if (preg_match('/^msgid\s+"(.*)"$/', $line, $m)) {
+            if ($current_msgid !== null) {
+                save_entry($entries, $current_msgid, $current_msgid_plural, $current_msgstr);
+            }
+            $current_msgid = stripcslashes($m[1]);
+            $current_msgid_plural = null;
+            $current_msgstr = array();
+            $state = 'msgid';
+        } elseif (preg_match('/^msgid_plural\s+"(.*)"$/', $line, $m)) {
+            $current_msgid_plural = stripcslashes($m[1]);
+            $state = 'msgid_plural';
+        } elseif (preg_match('/^msgstr\s+"(.*)"$/', $line, $m)) {
+            $current_msgstr[0] = stripcslashes($m[1]);
+            $state = 'msgstr';
+        } elseif (preg_match('/^msgstr\[(\d+)\]\s+"(.*)"$/', $line, $m)) {
+            $current_msgstr[(int)$m[1]] = stripcslashes($m[2]);
+            $state = 'msgstr[' . $m[1] . ']';
+        } elseif (preg_match('/^"(.*)"$/', $line, $m)) {
+            $val = stripcslashes($m[1]);
+            if ($state === 'msgid') {
+                $current_msgid .= $val;
+            } elseif ($state === 'msgid_plural') {
+                $current_msgid_plural .= $val;
+            } elseif (preg_match('/^msgstr/', $state)) {
+                $idx = 0;
+                if (preg_match('/\[(\d+)\]/', $state, $im)) {
+                    $idx = (int)$im[1];
+                }
+                $current_msgstr[$idx] = ($current_msgstr[$idx] ?? '') . $val;
+            }
+        }
+    }
+
+    if ($current_msgid !== null) {
+        save_entry($entries, $current_msgid, $current_msgid_plural, $current_msgstr);
+    }
+
+    return $entries;
+}
+
+function save_entry(&$entries, $msgid, $msgid_plural, $msgstr) {
+    if ($msgid === null) return;
+
+    if ($msgid_plural !== null) {
+        $key = $msgid . "\x00" . $msgid_plural;
+        ksort($msgstr);
+        $val = implode("\x00", $msgstr);
+    } else {
+        $key = $msgid;
+        $val = $msgstr[0] ?? '';
+    }
+
+    $entries[$key] = $val;
+}
+
+function write_mo($file, $entries) {
+    ksort($entries);
+    $offsets = array();
+    $ids = '';
+    $strs = '';
+
+    foreach ($entries as $id => $str) {
+        $offsets[] = array(strlen($id), strlen($ids), strlen($str), strlen($strs));
+        $ids .= $id . "\x00";
+        $strs .= $str . "\x00";
+    }
+
+    $count = count($offsets);
+    $header_size = 28;
+    $key_offset_start = $header_size;
+    $val_offset_start = $key_offset_start + $count * 8;
+    $keys_start = $val_offset_start + $count * 8;
+    $vals_start = $keys_start + strlen($ids);
+
+    $output = pack('V', 0x950412de);  // magic
+    $output .= pack('V', 0);          // revision
+    $output .= pack('V', $count);     // number of strings
+    $output .= pack('V', $key_offset_start);  // offset of original strings table
+    $output .= pack('V', $val_offset_start);  // offset of translated strings table
+    $output .= pack('V', 0);          // hash table size
+    $output .= pack('V', 0);          // hash table offset
+
+    // Original strings offsets
+    foreach ($offsets as $o) {
+        $output .= pack('V', $o[0]);                // length
+        $output .= pack('V', $keys_start + $o[1]);  // offset
+    }
+
+    // Translated strings offsets
+    foreach ($offsets as $o) {
+        $output .= pack('V', $o[2]);                // length
+        $output .= pack('V', $vals_start + $o[3]);  // offset
+    }
+
+    $output .= $ids;
+    $output .= $strs;
+
+    file_put_contents($file, $output);
+}

studiou-wc-free-photo-product/languages/studiou-wc-free-photo-product-cs_CZ.po

@@ -0,0 +1,362 @@
+# Czech translation for QDR - Studiou WC Free Photo Product
+# Copyright (C) 2026 Dalibor Votruba
+# This file is distributed under the GPL v2 or later.
+msgid ""
+msgstr ""
+"Project-Id-Version: QDR - Studiou WC Free Photo Product 1.2.2\n"
+"Report-Msgid-Bugs-To: https://www.quadarax.com\n"
+"POT-Creation-Date: 2026-04-02 00:00+0000\n"
+"PO-Revision-Date: 2026-04-02 00:00+0000\n"
+"Last-Translator: Dalibor Votruba <info@quadarax.com>\n"
+"Language-Team: Czech <info@quadarax.com>\n"
+"Language: cs_CZ\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n>=2 && n<=4 ? 1 : 2);\n"
+"X-Generator: Poedit 3.0\n"
+
+msgid "QDR - Studiou WC Free Photo Product requires WooCommerce to be installed and activated."
+msgstr "QDR - Studiou WC Free Photo Product vyžaduje nainstalovaný a aktivovaný WooCommerce."
+
+msgid "Free Photo Files"
+msgstr "Soubory fotografií"
+
+msgid "Are you sure you want to delete the selected files?"
+msgstr "Opravdu chcete smazat vybrané soubory?"
+
+msgid "Are you sure you want to delete this file?"
+msgstr "Opravdu chcete smazat tento soubor?"
+
+msgid "Download selected files as ZIP archive?"
+msgstr "Stáhnout vybrané soubory jako ZIP archiv?"
+
+msgid "Are you sure you want to change the status of the selected files?"
+msgstr "Opravdu chcete změnit stav vybraných souborů?"
+
+msgid "No files selected."
+msgstr "Nejsou vybrány žádné soubory."
+
+msgid "Status updated."
+msgstr "Stav aktualizován."
+
+msgid "An error occurred."
+msgstr "Došlo k chybě."
+
+msgid "Generating ZIP archive..."
+msgstr "Generování ZIP archivu..."
+
+msgid "Deleting..."
+msgstr "Mazání..."
+
+msgid "Uploading..."
+msgstr "Nahrávání..."
+
+msgid "Upload complete"
+msgstr "Nahrávání dokončeno"
+
+msgid "Processing..."
+msgstr "Zpracování..."
+
+msgid "Upload failed. Please try again."
+msgstr "Nahrávání selhalo. Zkuste to prosím znovu."
+
+msgid "File is too large. Maximum size: %s MB"
+msgstr "Soubor je příliš velký. Maximální velikost: %s MB"
+
+msgid "Please select a variant."
+msgstr "Prosím vyberte variantu."
+
+msgid "Please upload a file."
+msgstr "Prosím nahrajte soubor."
+
+msgid "Product added to cart!"
+msgstr "Produkt přidán do košíku!"
+
+msgid "Could not add to cart. Please try again."
+msgstr "Nelze přidat do košíku. Zkuste to prosím znovu."
+
+msgid "Drag & drop your file here or click to browse"
+msgstr "Přetáhněte soubor sem nebo klikněte pro výběr"
+
+msgid "Remove"
+msgstr "Odebrat"
+
+msgid "Media Categories"
+msgstr "Kategorie médií"
+
+msgid "Media Category"
+msgstr "Kategorie médií"
+
+msgid "Search Media Categories"
+msgstr "Hledat kategorie médií"
+
+msgid "All Media Categories"
+msgstr "Všechny kategorie médií"
+
+msgid "Parent Media Category"
+msgstr "Nadřazená kategorie médií"
+
+msgid "Parent Media Category:"
+msgstr "Nadřazená kategorie médií:"
+
+msgid "Edit Media Category"
+msgstr "Upravit kategorii médií"
+
+msgid "Update Media Category"
+msgstr "Aktualizovat kategorii médií"
+
+msgid "Add New Media Category"
+msgstr "Přidat novou kategorii médií"
+
+msgid "New Media Category Name"
+msgstr "Název nové kategorie médií"
+
+msgid "Free Photo"
+msgstr "Volná fotografie"
+
+msgid "Enable Free Photo"
+msgstr "Povolit volnou fotografii"
+
+msgid "Enable custom photo upload for this product"
+msgstr "Povolit nahrávání vlastních fotografií pro tento produkt"
+
+msgid "— Select category —"
+msgstr "— Vyberte kategorii —"
+
+msgid "Uploaded files will be assigned to this media category."
+msgstr "Nahrané soubory budou přiřazeny k této kategorii médií."
+
+msgid "New Category Name"
+msgstr "Název nové kategorie"
+
+msgid "Add"
+msgstr "Přidat"
+
+msgid "Cancel"
+msgstr "Zrušit"
+
+msgid "Max File Size (MB)"
+msgstr "Max. velikost souboru (MB)"
+
+msgid "Maximum allowed file size for uploads in megabytes."
+msgstr "Maximální povolená velikost souboru pro nahrávání v megabajtech."
+
+msgid "Shortcode"
+msgstr "Shortcode"
+
+msgid "Use this shortcode to display this product with photo upload on any page."
+msgstr "Použijte tento shortcode pro zobrazení tohoto produktu s nahráváním fotografií na jakékoli stránce."
+
+msgid "Upload Info Text"
+msgstr "Text informací o nahrávání"
+
+msgid "Custom text displayed above the upload area on the product page. Leave empty for default text."
+msgstr "Vlastní text zobrazený nad oblastí nahrávání na stránce produktu. Ponechte prázdné pro výchozí text."
+
+msgid "Min Image Resolution (px)"
+msgstr "Min. rozlišení obrázku (px)"
+
+msgid "Width"
+msgstr "Šířka"
+
+msgid "Height"
+msgstr "Výška"
+
+msgid "Minimum image resolution in pixels. Leave empty to skip. Width and height are interchangeable (portrait/landscape auto-detected)."
+msgstr "Minimální rozlišení obrázku v pixelech. Ponechte prázdné pro přeskočení. Šířka a výška jsou zaměnitelné (automatická detekce orientace)."
+
+msgid "Max Image Resolution (px)"
+msgstr "Max. rozlišení obrázku (px)"
+
+msgid "Maximum image resolution in pixels. Leave empty to skip. Width and height are interchangeable (portrait/landscape auto-detected)."
+msgstr "Maximální rozlišení obrázku v pixelech. Ponechte prázdné pro přeskočení. Šířka a výška jsou zaměnitelné (automatická detekce orientace)."
+
+msgid "Image resolution %1$dx%2$d px is too small. Minimum required: %3$dx%4$d px."
+msgstr "Rozlišení obrázku %1$dx%2$d px je příliš malé. Minimální požadované: %3$dx%4$d px."
+
+msgid "Image resolution %1$dx%2$d px is too large. Maximum allowed: %3$dx%4$d px."
+msgstr "Rozlišení obrázku %1$dx%2$d px je příliš velké. Maximální povolené: %3$dx%4$d px."
+
+msgid "Category name is required."
+msgstr "Název kategorie je povinný."
+
+msgid "Insufficient permissions."
+msgstr "Nedostatečná oprávnění."
+
+msgid "Invalid product."
+msgstr "Neplatný produkt."
+
+msgid "Invalid upload ID."
+msgstr "Neplatné ID nahrávání."
+
+msgid "Chunk upload failed."
+msgstr "Nahrávání části selhalo."
+
+msgid "Failed to store chunk."
+msgstr "Nepodařilo se uložit část souboru."
+
+msgid "Failed to create output file."
+msgstr "Nepodařilo se vytvořit výstupní soubor."
+
+msgid "Missing chunk %d."
+msgstr "Chybějící část %d."
+
+msgid "File type not allowed."
+msgstr "Tento typ souboru není povolen."
+
+msgid "Failed to create file record."
+msgstr "Nepodařilo se vytvořit záznam souboru."
+
+msgid "Invalid file."
+msgstr "Neplatný soubor."
+
+msgid "File not found."
+msgstr "Soubor nenalezen."
+
+msgid "Cannot remove a file linked to an order."
+msgstr "Nelze odstranit soubor propojený s objednávkou."
+
+msgid "Permission denied."
+msgstr "Přístup zamítnut."
+
+msgid "File removed."
+msgstr "Soubor odstraněn."
+
+msgid "Product ID is required."
+msgstr "ID produktu je povinné."
+
+msgid "Product not found."
+msgstr "Produkt nenalezen."
+
+msgid "This product does not support photo upload."
+msgstr "Tento produkt nepodporuje nahrávání fotografií."
+
+msgid "This product must be a variable product."
+msgstr "Tento produkt musí být variabilní produkt."
+
+msgid "Please upload a photo before adding to cart."
+msgstr "Před přidáním do košíku prosím nahrajte fotografii."
+
+msgid "Download uploaded photo"
+msgstr "Stáhnout nahranou fotografii"
+
+msgid "Invalid file data."
+msgstr "Neplatná data souboru."
+
+msgid "Uploaded Photo"
+msgstr "Nahraná fotografie"
+
+msgid "Upload Your Photo"
+msgstr "Nahrajte svou fotografii"
+
+msgid "Maximum file size: %s MB. Accepted formats: JPEG, PNG, TIFF, BMP, PSD, RAW (CR2, NEF, ARW, DNG, ORF, RW2, RAF), WebP."
+msgstr "Maximální velikost souboru: %s MB. Povolené formáty: JPEG, PNG, TIFF, BMP, PSD, RAW (CR2, NEF, ARW, DNG, ORF, RW2, RAF), WebP."
+
+msgid "Preview"
+msgstr "Náhled"
+
+msgid "All Statuses"
+msgstr "Všechny stavy"
+
+msgid "Ready"
+msgstr "Připraveno"
+
+msgid "Downloaded"
+msgstr "Staženo"
+
+msgid "Solved"
+msgstr "Vyřízeno"
+
+msgid "All Products"
+msgstr "Všechny produkty"
+
+msgid "Search file name..."
+msgstr "Hledat název souboru..."
+
+msgid "Filter"
+msgstr "Filtrovat"
+
+msgid "Bulk Actions"
+msgstr "Hromadné akce"
+
+msgid "Download ZIP"
+msgstr "Stáhnout ZIP"
+
+msgid "Set Status: Ready"
+msgstr "Nastavit stav: Připraveno"
+
+msgid "Set Status: Downloaded"
+msgstr "Nastavit stav: Staženo"
+
+msgid "Set Status: Solved"
+msgstr "Nastavit stav: Vyřízeno"
+
+msgid "Delete"
+msgstr "Smazat"
+
+msgid "Apply"
+msgstr "Použít"
+
+msgid "%d file"
+msgid_plural "%d files"
+msgstr[0] "%d soubor"
+msgstr[1] "%d soubory"
+msgstr[2] "%d souborů"
+
+msgid "File Name"
+msgstr "Název souboru"
+
+msgid "Product"
+msgstr "Produkt"
+
+msgid "Order"
+msgstr "Objednávka"
+
+msgid "Customer"
+msgstr "Zákazník"
+
+msgid "Status"
+msgstr "Stav"
+
+msgid "Date"
+msgstr "Datum"
+
+msgid "Actions"
+msgstr "Akce"
+
+msgid "No files found."
+msgstr "Žádné soubory nenalezeny."
+
+msgid "Guest"
+msgstr "Host"
+
+msgid "Download"
+msgstr "Stáhnout"
+
+msgid "Invalid data."
+msgstr "Neplatná data."
+
+msgid "Failed to update status."
+msgstr "Nepodařilo se aktualizovat stav."
+
+msgid "%d file(s) updated."
+msgstr "Aktualizováno %d soubor(ů)."
+
+msgid "%d file(s) deleted."
+msgstr "Smazáno %d soubor(ů)."
+
+msgid "ZIP extension not available on server."
+msgstr "Rozšíření ZIP není na serveru dostupné."
+
+msgid "Could not create ZIP file."
+msgstr "Nelze vytvořit ZIP soubor."
+
+msgid "No files could be added to archive."
+msgstr "Do archivu nebylo možné přidat žádné soubory."
+
+msgid "Security check failed."
+msgstr "Bezpečnostní kontrola selhala."
+
+msgid "Add New Category"
+msgstr "Přidat novou kategorii"

studiou-wc-free-photo-product/languages/studiou-wc-free-photo-product.pot

@@ -0,0 +1,474 @@
+# Copyright (C) 2026 Dalibor Votruba
+# This file is distributed under the GPL v2 or later.
+msgid ""
+msgstr ""
+"Project-Id-Version: QDR - Studiou WC Free Photo Product 1.2.2\n"
+"Report-Msgid-Bugs-To: https://www.quadarax.com\n"
+"POT-Creation-Date: 2026-04-02 00:00+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#: studiou-wc-free-photo-product.php
+msgid "QDR - Studiou WC Free Photo Product requires WooCommerce to be installed and activated."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Free Photo Files"
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Are you sure you want to delete the selected files?"
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Are you sure you want to delete this file?"
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Download selected files as ZIP archive?"
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Are you sure you want to change the status of the selected files?"
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "No files selected."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Status updated."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "An error occurred."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Generating ZIP archive..."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Deleting..."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Uploading..."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Upload complete"
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Processing..."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Upload failed. Please try again."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "File is too large. Maximum size: %s MB"
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Please select a variant."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Please upload a file."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Product added to cart!"
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Could not add to cart. Please try again."
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Drag & drop your file here or click to browse"
+msgstr ""
+
+#: studiou-wc-free-photo-product.php
+msgid "Remove"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "Media Categories"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "Media Category"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "Search Media Categories"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "All Media Categories"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "Parent Media Category"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "Parent Media Category:"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "Edit Media Category"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "Update Media Category"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "Add New Media Category"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-db.php
+msgid "New Media Category Name"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Free Photo"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Enable Free Photo"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Enable custom photo upload for this product"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "— Select category —"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Uploaded files will be assigned to this media category."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "New Category Name"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Add"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Cancel"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Max File Size (MB)"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Maximum allowed file size for uploads in megabytes."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Shortcode"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Use this shortcode to display this product with photo upload on any page."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Upload Info Text"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Custom text displayed above the upload area on the product page. Leave empty for default text."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Min Image Resolution (px)"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Width"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Height"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Minimum image resolution in pixels. Leave empty to skip. Width and height are interchangeable (portrait/landscape auto-detected)."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Max Image Resolution (px)"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Maximum image resolution in pixels. Leave empty to skip. Width and height are interchangeable (portrait/landscape auto-detected)."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+#, php-format
+msgid "Image resolution %1$dx%2$d px is too small. Minimum required: %3$dx%4$d px."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+#, php-format
+msgid "Image resolution %1$dx%2$d px is too large. Maximum allowed: %3$dx%4$d px."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Category name is required."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-product.php
+msgid "Insufficient permissions."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Invalid product."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Invalid upload ID."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Chunk upload failed."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Failed to store chunk."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Failed to create output file."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Missing chunk %d."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "File type not allowed."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Failed to create file record."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Invalid file."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "File not found."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Cannot remove a file linked to an order."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "Permission denied."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-upload.php
+msgid "File removed."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-shortcode.php
+msgid "Product ID is required."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-shortcode.php
+msgid "Product not found."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-shortcode.php
+msgid "This product does not support photo upload."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-shortcode.php
+msgid "This product must be a variable product."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-single-product.php
+msgid "Please upload a photo before adding to cart."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-cart.php
+msgid "Download uploaded photo"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-single-product.php
+msgid "Invalid file data."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-cart.php
+msgid "Uploaded Photo"
+msgstr ""
+
+#: views/single-product-upload.php
+msgid "Upload Your Photo"
+msgstr ""
+
+#: views/single-product-upload.php
+msgid "Maximum file size: %s MB. Accepted formats: JPEG, PNG, TIFF, BMP, PSD, RAW (CR2, NEF, ARW, DNG, ORF, RW2, RAF), WebP."
+msgstr ""
+
+#: views/single-product-upload.php
+msgid "Preview"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "All Statuses"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Ready"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Downloaded"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Solved"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "All Products"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Search file name..."
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Filter"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Bulk Actions"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Download ZIP"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Set Status: Ready"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Set Status: Downloaded"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Set Status: Solved"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Delete"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Apply"
+msgstr ""
+
+#: views/admin-summary.php
+#, php-format
+msgid "%d file"
+msgid_plural "%d files"
+msgstr[0] ""
+msgstr[1] ""
+
+#: views/admin-summary.php
+msgid "File Name"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Product"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Order"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Customer"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Status"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Date"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Actions"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "No files found."
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Guest"
+msgstr ""
+
+#: views/admin-summary.php
+msgid "Download"
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-admin.php
+msgid "Invalid data."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-admin.php
+msgid "Failed to update status."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-admin.php
+#, php-format
+msgid "%d file(s) updated."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-admin.php
+#, php-format
+msgid "%d file(s) deleted."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-admin.php
+msgid "ZIP extension not available on server."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-admin.php
+msgid "Could not create ZIP file."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-admin.php
+msgid "No files could be added to archive."
+msgstr ""
+
+#: includes/class-studiou-wc-fpp-admin.php
+msgid "Security check failed."
+msgstr ""

studiou-wc-free-photo-product/readme.md

@@ -0,0 +1,255 @@
+# QDR - Studiou WC Free Photo Product
+
+WordPress (6.9.4+) / WooCommerce (10.6.2+) plugin that allows publishing special variable products with custom raw image upload for photo printing. Customers select a product variant using WooCommerce's native variation selector and upload their photo file, which gets stored in the WordPress media library under a configurable media category.
+
+## Requirements
+
+- WordPress 6.9.4+
+- WooCommerce 10.0+
+- PHP 8.2+
+- PHP ZipArchive extension (for admin ZIP download)
+
+## Installation
+
+1. Upload the `studiou-wc-free-photo-product` folder to `/wp-content/plugins/`
+2. Activate the plugin through the Plugins menu in WordPress
+3. The plugin creates a custom database table `{prefix}studiou_fpp_files` on activation
+
+## Configuration
+
+### Creating a Free Photo Product
+
+1. Create or edit a WooCommerce product and set its type to **Variable**
+2. Add variations with attributes (e.g. size: 10x15, 20x30, A4) and prices
+3. Go to the **Free Photo** tab in the product data panel (visible for Variable products)
+4. Check **Enable Free Photo**
+5. Select or create a **Media Category** - uploaded files will be assigned to this category
+6. Set **Max File Size (MB)** - maximum allowed upload size per file (1-500 MB, default 50)
+7. Optionally set **Min Image Resolution (px)** and **Max Image Resolution (px)** - width and height are interchangeable (portrait/landscape auto-detected). Leave empty to skip validation. RAW files that cannot be measured are skipped.
+8. Copy the displayed **Shortcode** for use on custom pages
+
+### Product Detail Page
+
+When a variable product has Free Photo enabled, the upload area automatically appears on the WooCommerce single product page **below** the product summary (below the variation table and Add to Cart buttons). The customer workflow is:
+
+1. Upload a photo file via drag-and-drop or file browser (below the variation table)
+2. The product gallery image updates to show the uploaded photo preview
+3. Select a variant from the product variation table and click its **Add to Cart** button
+4. If no photo is uploaded, the server blocks the add-to-cart and shows an error notice
+5. The uploaded photo stays — the same photo can be used for multiple variants without re-uploading
+
+The uploaded file reference is stored in the WooCommerce session, so it works with any add-to-cart method (form POST, AJAX buttons, individual variation buttons). The session persists across add-to-cart actions, allowing the same photo to be used for multiple variants. The session is only cleared when the user explicitly removes the uploaded photo.
+
+Add-to-cart is blocked server-side until a photo is uploaded:
+- **Validation**: `woocommerce_add_to_cart_validation` (priority 1) checks the WC session for uploaded file data and blocks with an error notice if missing.
+- **Safety net**: `woocommerce_add_to_cart` action removes any FPP cart item that was added without a photo (catches edge cases where validation was bypassed).
+- Product detection uses `resolve_fpp_product_id()` which checks the product itself, its parent, and the variation's parent to handle all add-to-cart methods.
+
+On page reload, existing session state is restored — the upload preview and product gallery image are reconstructed from the server-side session data. When the photo is removed, the original product image is restored. Add-to-cart buttons always look and behave normally — blocking is entirely server-side.
+
+### Shortcode
+
+The shortcode can be used to embed the product with its variation selector and upload area on any page:
+
+```
+[studiou_free_photo_product id="123"]
+```
+
+Replace `123` with your product ID. The shortcode renders:
+- Product image, name, and short description
+- WooCommerce native variation selector and Add to Cart form
+- Upload area with drag-and-drop, progress bar, and preview (injected into the form)
+
+### Accepted File Formats
+
+JPEG, PNG, TIFF, BMP, PSD, WebP, and camera RAW formats: CR2 (Canon), NEF (Nikon), ARW (Sony), DNG (Adobe), ORF (Olympus), RW2 (Panasonic), RAF (Fuji).
+
+## Chunked Upload
+
+Files are uploaded in 1 MB chunks via AJAX to bypass PHP `upload_max_filesize` and `post_max_size` limits. The server assembles chunks into the final file, creates a WordPress media attachment, and assigns it to the configured media category. The chunk size is defined by the `STUDIOU_WCFPP_CHUNK_SIZE` constant.
+
+## Admin Summary Page
+
+Navigate to **Products > Free Photo Files** to manage uploaded files.
+
+### Features
+
+- Filter by status (Ready / Downloaded / Solved), product, or file name search
+- Inline status change per file via dropdown
+- Single file download (automatically marks status as "downloaded" if currently "ready")
+- Single file delete with media attachment cleanup
+- Bulk actions with confirmation dialogs: Download as ZIP, Set Status (Ready / Downloaded / Solved), Delete
+- Order number links (HPOS-compatible)
+- Customer name display
+- Pagination (30 files per page, preserves active filters across pages)
+
+### File Statuses
+
+| Status | Meaning |
+|---|---|
+| Ready | File uploaded, awaiting processing |
+| Downloaded | File has been downloaded by admin (set automatically on download) |
+| Solved | File has been printed / order fulfilled |
+
+## Cart and Order Integration
+
+The plugin integrates with WooCommerce's native add-to-cart flow using WC session storage. When a photo is uploaded, the file reference is stored in the WC session via AJAX. When any add-to-cart button is clicked, `woocommerce_add_cart_item_data` reads the file data from the session and attaches it to the cart item. The session persists so the same photo can be reused for multiple variants. The `woocommerce_add_to_cart_validation` filter ensures a photo is uploaded before the item can be added. This approach works with any theme or plugin that handles variable product display (individual variation buttons, dropdowns, tables, etc.).
+
+When a customer adds a photo product to the cart:
+- The cart item thumbnail shows the uploaded photo — works with both **classic cart** (`woocommerce_cart_item_thumbnail` filter) and **block cart** (`woocommerce_product_get_image_id` / `woocommerce_product_variation_get_image_id` filters that override the product image for the Store API)
+- The uploaded file name is shown as "Uploaded Photo" in the cart
+- On checkout, the file record is linked to the order and order item
+- In the order admin, order item thumbnails show the uploaded photo instead of the product image
+- The uploaded photo file name appears as order item metadata
+- A **Download uploaded photo** button with the original file name is shown below the order item meta in admin (downloading automatically marks the file status as "downloaded")
+- Files linked to orders cannot be removed by the customer
+
+## Media Categories
+
+The plugin registers a custom taxonomy `studiou_media_category` on the `attachment` post type. Categories are visible in the Media Library admin column and can be managed from:
+- **Free Photo** product tab (inline add via "+" button)
+- Media Library sidebar
+
+Each product has one assigned media category. All files uploaded for that product are tagged with it.
+
+## HPOS Support
+
+The plugin declares full compatibility with WooCommerce High-Performance Order Storage (HPOS / Custom Order Tables). Order edit links in the admin summary page use the correct URL format based on whether HPOS is enabled.
+
+## Localization
+
+Supported languages:
+- English (default)
+- Czech (cs_CZ)
+
+Translation files are in the `languages/` directory.
+
+To compile the `.mo` file from `.po`:
+
+```bash
+# Using the included helper script
+php languages/generate-mo.php
+
+# Or using WP-CLI
+wp i18n make-mo languages/
+
+# Or using gettext
+msgfmt languages/studiou-wc-free-photo-product-cs_CZ.po -o languages/studiou-wc-free-photo-product-cs_CZ.mo
+```
+
+Text domain: `studiou-wc-free-photo-product`
+
+## Database
+
+The plugin creates one custom table on activation:
+
+**`{prefix}studiou_fpp_files`**
+
+| Column | Type | Description |
+|---|---|---|
+| id | bigint | Primary key |
+| product_id | bigint | WC product ID |
+| variation_id | bigint | WC variation ID |
+| order_id | bigint | WC order ID (set on checkout) |
+| order_item_id | bigint | WC order item ID (set on checkout) |
+| attachment_id | bigint | WP media attachment ID |
+| customer_id | bigint | WP user ID (0 for guests) |
+| session_key | varchar(64) | WC session key for guest users |
+| file_name | varchar(255) | Original uploaded file name |
+| status | varchar(20) | ready / downloaded / solved |
+| created_at | datetime | Upload timestamp |
+| updated_at | datetime | Last update timestamp |
+
+## File Structure
+
+```
+studiou-wc-free-photo-product/
+├── studiou-wc-free-photo-product.php        Main plugin file
+├── includes/
+│   ├── class-studiou-wc-fpp-db.php          Database + media taxonomy
+│   ├── class-studiou-wc-fpp-product.php     Product data tab
+│   ├── class-studiou-wc-fpp-upload.php      Chunked upload handler
+│   ├── class-studiou-wc-fpp-shortcode.php   Shortcode renderer
+│   ├── class-studiou-wc-fpp-single-product.php  Product page upload area
+│   ├── class-studiou-wc-fpp-cart.php        Cart/order integration (native WC flow)
+│   └── class-studiou-wc-fpp-admin.php       Admin summary page
+├── views/
+│   ├── frontend-product.php                 Shortcode template
+│   ├── single-product-upload.php            Upload area for product page
+│   └── admin-summary.php                    Admin file list template
+├── assets/
+│   ├── css/admin.css                        Admin styles
+│   ├── css/frontend.css                     Frontend styles
+│   ├── js/admin.js                          Admin JS
+│   └── js/frontend.js                       Frontend JS (chunked upload)
+└── languages/
+    ├── studiou-wc-free-photo-product.pot    Translation template
+    ├── studiou-wc-free-photo-product-cs_CZ.po  Czech translation
+    └── generate-mo.php                      MO file generator
+```
+
+## Hooks and Filters
+
+### AJAX Actions
+
+| Action | Auth | Description |
+|---|---|---|
+| `studiou_wcfpp_upload_chunk` | Both | Upload a file chunk |
+| `studiou_wcfpp_remove_upload` | Both | Remove an uploaded file (pre-order) |
+| `studiou_wcfpp_set_upload_session` | Both | Store uploaded file reference in WC session |
+| `studiou_wcfpp_clear_upload_session` | Both | Clear uploaded file reference from WC session |
+| `studiou_wcfpp_add_media_category` | Admin | Create a new media category |
+| `studiou_wcfpp_update_status` | Admin | Update single file status |
+| `studiou_wcfpp_bulk_status` | Admin | Bulk update file statuses |
+| `studiou_wcfpp_delete_files` | Admin | Delete files (single or bulk) |
+| `studiou_wcfpp_download_zip` | Admin | Generate ZIP of selected files |
+
+### WooCommerce Hooks Used
+
+| Hook | Type | Description |
+|---|---|---|
+| `woocommerce_single_product_summary` (priority 35) | Action | Renders upload area below the variation table |
+| `woocommerce_add_to_cart_validation` | Filter | Validates photo is uploaded |
+| `woocommerce_add_cart_item_data` | Filter | Captures file data into cart item |
+| `woocommerce_cart_item_thumbnail` | Filter | Replaces cart item thumbnail (classic cart) |
+| `woocommerce_product_get_image_id` | Filter | Returns uploaded photo as product image (block cart) |
+| `woocommerce_product_variation_get_image_id` | Filter | Returns uploaded photo as variation image (block cart) |
+| `woocommerce_get_item_data` | Filter | Displays file name in cart |
+| `woocommerce_checkout_create_order_line_item` | Action | Saves file meta to order item |
+| `woocommerce_checkout_order_processed` | Action | Links file record to order (classic checkout) |
+| `woocommerce_store_api_checkout_order_processed` | Action | Links file record to order (block checkout) |
+| `woocommerce_thankyou` | Action | Fallback linking on thank-you page |
+| `woocommerce_admin_order_item_thumbnail` | Filter | Replaces order item thumbnail with uploaded photo |
+| `woocommerce_after_order_itemmeta` | Action | Shows download link for uploaded photo in order admin |
+| `woocommerce_product_data_tabs` | Filter | Adds Free Photo product tab |
+| `woocommerce_product_data_panels` | Action | Renders Free Photo settings panel |
+| `woocommerce_process_product_meta` | Action | Saves Free Photo product meta |
+
+### Product Meta Keys
+
+| Key | Description |
+|---|---|
+| `_studiou_fpp_enabled` | "yes" / "no" |
+| `_studiou_fpp_media_category` | Term ID of media category |
+| `_studiou_fpp_max_file_size` | Max upload size in MB |
+| `_studiou_fpp_min_width` | Min image width in px (0 = no limit) |
+| `_studiou_fpp_min_height` | Min image height in px (0 = no limit) |
+| `_studiou_fpp_max_width` | Max image width in px (0 = no limit) |
+| `_studiou_fpp_max_height` | Max image height in px (0 = no limit) |
+
+### Order Item Meta Keys
+
+| Key | Description |
+|---|---|
+| `_studiou_fpp_attachment_id` | WP attachment ID |
+| `_studiou_fpp_file_record_id` | File record ID in custom table |
+| `_studiou_fpp_file_name` | Original file name |
+| `_studiou_fpp_thumb_url` | Thumbnail URL (for reliable display) |
+
+## License
+
+GPL v2 or later
+
+## Author
+
+Dalibor Votruba - [quadarax.com](https://www.quadarax.com)

studiou-wc-free-photo-product/studiou-wc-free-photo-product.php

@@ -0,0 +1,268 @@
+<?php
+/**
+ * Plugin Name: QDR - Studiou WC Free Photo Product
+ * Plugin URI: https://www.quadarax.com/plugins/studiou-wc-free-photo-product
+ * Description: Allows publishing special WooCommerce products with variants and custom raw image upload for photo printing
+ * Version: 1.2.2
+ * Requires at least: 6.9.4
+ * Requires PHP: 8.2
+ * Author: Dalibor Votruba
+ * Author URI: https://www.quadarax.com
+ * License: GPL v2 or later
+ * License URI: https://www.gnu.org/licenses/gpl-2.0.html
+ * Text Domain: studiou-wc-free-photo-product
+ * Domain Path: /languages
+ * WC requires at least: 10.0
+ * WC tested up to: 10.6
+ * Woo: 12346:a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4
+ */
+
+if (!defined('WPINC')) {
+    die;
+}
+
+if (!defined('STUDIOU_WCFPP_VERSION')) define('STUDIOU_WCFPP_VERSION', '1.2.2');
+if (!defined('STUDIOU_WCFPP_PLUGIN_DIR')) define('STUDIOU_WCFPP_PLUGIN_DIR', plugin_dir_path(__FILE__));
+if (!defined('STUDIOU_WCFPP_PLUGIN_URL')) define('STUDIOU_WCFPP_PLUGIN_URL', plugin_dir_url(__FILE__));
+if (!defined('STUDIOU_WCFPP_PLUGIN_BASENAME')) define('STUDIOU_WCFPP_PLUGIN_BASENAME', plugin_basename(__FILE__));
+if (!defined('STUDIOU_WCFPP_CHUNK_SIZE')) define('STUDIOU_WCFPP_CHUNK_SIZE', 1024 * 1024); // 1MB chunks
+
+class Studiou_WC_Free_Photo_Product {
+
+    /** @var Studiou_WC_FPP_DB */
+    private $db;
+
+    /** @var Studiou_WC_FPP_Product */
+    private $product;
+
+    /** @var Studiou_WC_FPP_Upload */
+    private $upload;
+
+    /** @var Studiou_WC_FPP_Shortcode */
+    private $shortcode;
+
+    /** @var Studiou_WC_FPP_Single_Product */
+    private $single_product;
+
+    /** @var Studiou_WC_FPP_Cart */
+    private $cart;
+
+    /** @var Studiou_WC_FPP_Admin */
+    private $admin;
+
+    public function __construct() {
+        $this->load_dependencies();
+        add_action('admin_init', array($this, 'check_required_plugins'));
+        add_action('admin_menu', array($this, 'add_admin_menu'), 99);
+        add_action('admin_enqueue_scripts', array($this, 'register_admin_assets'));
+        add_action('wp_enqueue_scripts', array($this, 'register_frontend_assets'));
+        $this->init_components();
+        add_action('before_woocommerce_init', array($this, 'declare_hpos_compatibility'));
+    }
+
+    private function load_dependencies() {
+        require_once STUDIOU_WCFPP_PLUGIN_DIR . 'includes/class-studiou-wc-fpp-db.php';
+        require_once STUDIOU_WCFPP_PLUGIN_DIR . 'includes/class-studiou-wc-fpp-product.php';
+        require_once STUDIOU_WCFPP_PLUGIN_DIR . 'includes/class-studiou-wc-fpp-upload.php';
+        require_once STUDIOU_WCFPP_PLUGIN_DIR . 'includes/class-studiou-wc-fpp-shortcode.php';
+        require_once STUDIOU_WCFPP_PLUGIN_DIR . 'includes/class-studiou-wc-fpp-single-product.php';
+        require_once STUDIOU_WCFPP_PLUGIN_DIR . 'includes/class-studiou-wc-fpp-cart.php';
+        require_once STUDIOU_WCFPP_PLUGIN_DIR . 'includes/class-studiou-wc-fpp-admin.php';
+    }
+
+    private function init_components() {
+        $this->db = new Studiou_WC_FPP_DB();
+        $this->product = new Studiou_WC_FPP_Product();
+        $this->upload = new Studiou_WC_FPP_Upload($this->db);
+        $this->shortcode = new Studiou_WC_FPP_Shortcode();
+        $this->single_product = new Studiou_WC_FPP_Single_Product();
+        $this->cart = new Studiou_WC_FPP_Cart($this->db);
+        $this->admin = new Studiou_WC_FPP_Admin($this->db);
+    }
+
+    public function check_required_plugins() {
+        if (!class_exists('WooCommerce')) {
+            add_action('admin_notices', function () {
+                echo '<div class="notice notice-error"><p>';
+                echo esc_html__('QDR - Studiou WC Free Photo Product requires WooCommerce to be installed and activated.', 'studiou-wc-free-photo-product');
+                echo '</p></div>';
+            });
+        }
+    }
+
+    public function declare_hpos_compatibility() {
+        if (class_exists('Automattic\WooCommerce\Utilities\FeaturesUtil')) {
+            \Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility(
+                'custom_order_tables',
+                __FILE__,
+                true
+            );
+        }
+    }
+
+    public function add_admin_menu() {
+        if (class_exists('WooCommerce')) {
+            add_submenu_page(
+                'edit.php?post_type=product',
+                __('Free Photo Files', 'studiou-wc-free-photo-product'),
+                __('Free Photo Files', 'studiou-wc-free-photo-product'),
+                'manage_woocommerce',
+                'studiou-fpp-summary',
+                array($this->admin, 'render_summary_page')
+            );
+        }
+    }
+
+    public function register_admin_assets($hook) {
+        // Product edit page
+        $screen = get_current_screen();
+        if ($screen && ($screen->id === 'product' || $screen->post_type === 'product')) {
+            wp_enqueue_style(
+                'studiou-wcfpp-admin',
+                STUDIOU_WCFPP_PLUGIN_URL . 'assets/css/admin.css',
+                array(),
+                STUDIOU_WCFPP_VERSION
+            );
+            wp_enqueue_script(
+                'studiou-wcfpp-admin',
+                STUDIOU_WCFPP_PLUGIN_URL . 'assets/js/admin.js',
+                array('jquery'),
+                STUDIOU_WCFPP_VERSION,
+                true
+            );
+            wp_localize_script('studiou-wcfpp-admin', 'studiouWcfpp', array(
+                'ajaxUrl' => admin_url('admin-ajax.php'),
+                'nonce' => wp_create_nonce('studiou-wcfpp-nonce'),
+                'i18n' => array(
+                    'confirmDelete' => __('Are you sure you want to delete the selected files?', 'studiou-wc-free-photo-product'),
+                    'confirmDeleteSingle' => __('Are you sure you want to delete this file?', 'studiou-wc-free-photo-product'),
+                    'confirmDownloadZip' => __('Download selected files as ZIP archive?', 'studiou-wc-free-photo-product'),
+                    'confirmStatusChange' => __('Are you sure you want to change the status of the selected files?', 'studiou-wc-free-photo-product'),
+                    'noFilesSelected' => __('No files selected.', 'studiou-wc-free-photo-product'),
+                    'statusUpdated' => __('Status updated.', 'studiou-wc-free-photo-product'),
+                    'error' => __('An error occurred.', 'studiou-wc-free-photo-product'),
+                    'generatingZip' => __('Generating ZIP archive...', 'studiou-wc-free-photo-product'),
+                    'deleting' => __('Deleting...', 'studiou-wc-free-photo-product'),
+                ),
+            ));
+        }
+
+        // Admin summary page
+        if ('product_page_studiou-fpp-summary' === $hook) {
+            wp_enqueue_style(
+                'studiou-wcfpp-admin',
+                STUDIOU_WCFPP_PLUGIN_URL . 'assets/css/admin.css',
+                array(),
+                STUDIOU_WCFPP_VERSION
+            );
+            wp_enqueue_script(
+                'studiou-wcfpp-admin',
+                STUDIOU_WCFPP_PLUGIN_URL . 'assets/js/admin.js',
+                array('jquery'),
+                STUDIOU_WCFPP_VERSION,
+                true
+            );
+            wp_localize_script('studiou-wcfpp-admin', 'studiouWcfpp', array(
+                'ajaxUrl' => admin_url('admin-ajax.php'),
+                'nonce' => wp_create_nonce('studiou-wcfpp-nonce'),
+                'i18n' => array(
+                    'confirmDelete' => __('Are you sure you want to delete the selected files?', 'studiou-wc-free-photo-product'),
+                    'confirmDeleteSingle' => __('Are you sure you want to delete this file?', 'studiou-wc-free-photo-product'),
+                    'confirmDownloadZip' => __('Download selected files as ZIP archive?', 'studiou-wc-free-photo-product'),
+                    'confirmStatusChange' => __('Are you sure you want to change the status of the selected files?', 'studiou-wc-free-photo-product'),
+                    'noFilesSelected' => __('No files selected.', 'studiou-wc-free-photo-product'),
+                    'statusUpdated' => __('Status updated.', 'studiou-wc-free-photo-product'),
+                    'error' => __('An error occurred.', 'studiou-wc-free-photo-product'),
+                    'generatingZip' => __('Generating ZIP archive...', 'studiou-wc-free-photo-product'),
+                    'deleting' => __('Deleting...', 'studiou-wc-free-photo-product'),
+                ),
+            ));
+        }
+    }
+
+    public function register_frontend_assets() {
+        wp_register_style(
+            'studiou-wcfpp-frontend',
+            STUDIOU_WCFPP_PLUGIN_URL . 'assets/css/frontend.css',
+            array(),
+            STUDIOU_WCFPP_VERSION
+        );
+        wp_register_script(
+            'studiou-wcfpp-frontend',
+            STUDIOU_WCFPP_PLUGIN_URL . 'assets/js/frontend.js',
+            array('jquery'),
+            STUDIOU_WCFPP_VERSION,
+            true
+        );
+        wp_localize_script('studiou-wcfpp-frontend', 'studiouWcfppFront', array(
+            'ajaxUrl' => admin_url('admin-ajax.php'),
+            'nonce' => wp_create_nonce('studiou-wcfpp-front-nonce'),
+            'chunkSize' => STUDIOU_WCFPP_CHUNK_SIZE,
+            'cartUrl' => wc_get_cart_url(),
+            'i18n' => array(
+                'uploading' => __('Uploading...', 'studiou-wc-free-photo-product'),
+                'uploadComplete' => __('Upload complete', 'studiou-wc-free-photo-product'),
+                'processing' => __('Processing...', 'studiou-wc-free-photo-product'),
+                'uploadError' => __('Upload failed. Please try again.', 'studiou-wc-free-photo-product'),
+                'fileTooLarge' => __('File is too large. Maximum size: %s MB', 'studiou-wc-free-photo-product'),
+                'selectVariant' => __('Please select a variant.', 'studiou-wc-free-photo-product'),
+                'uploadFile' => __('Please upload a file.', 'studiou-wc-free-photo-product'),
+                'addedToCart' => __('Product added to cart!', 'studiou-wc-free-photo-product'),
+                'addToCartError' => __('Could not add to cart. Please try again.', 'studiou-wc-free-photo-product'),
+                'dragDropText' => __('Drag & drop your file here or click to browse', 'studiou-wc-free-photo-product'),
+                'removeFile' => __('Remove', 'studiou-wc-free-photo-product'),
+            ),
+        ));
+    }
+
+    public static function activate() {
+        require_once STUDIOU_WCFPP_PLUGIN_DIR . 'includes/class-studiou-wc-fpp-db.php';
+        $db = new Studiou_WC_FPP_DB();
+        $db->create_tables();
+
+        // Create chunks temp directory
+        $upload_dir = wp_upload_dir();
+        $chunks_dir = $upload_dir['basedir'] . '/studiou-fpp-chunks';
+        if (!file_exists($chunks_dir)) {
+            wp_mkdir_p($chunks_dir);
+            file_put_contents($chunks_dir . '/.htaccess', 'deny from all');
+            file_put_contents($chunks_dir . '/index.php', '<?php // Silence is golden');
+        }
+    }
+
+    public static function deactivate() {
+        // Clean up temp chunks
+        $upload_dir = wp_upload_dir();
+        $chunks_dir = $upload_dir['basedir'] . '/studiou-fpp-chunks';
+        if (is_dir($chunks_dir)) {
+            $files = glob($chunks_dir . '/*');
+            foreach ($files as $file) {
+                if (is_file($file) && basename($file) !== '.htaccess' && basename($file) !== 'index.php') {
+                    unlink($file);
+                }
+            }
+        }
+    }
+}
+
+// Activation/deactivation hooks
+register_activation_hook(__FILE__, array('Studiou_WC_Free_Photo_Product', 'activate'));
+register_deactivation_hook(__FILE__, array('Studiou_WC_Free_Photo_Product', 'deactivate'));
+
+function run_studiou_wc_free_photo_product() {
+    static $initialized = false;
+    if ($initialized) {
+        return;
+    }
+    $initialized = true;
+
+    load_plugin_textdomain(
+        'studiou-wc-free-photo-product',
+        false,
+        dirname(plugin_basename(__FILE__)) . '/languages/'
+    );
+
+    new Studiou_WC_Free_Photo_Product();
+}
+
+add_action('plugins_loaded', 'run_studiou_wc_free_photo_product');

studiou-wc-free-photo-product/views/admin-summary.php

@@ -0,0 +1,206 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+/** @var array $records */
+/** @var int $total */
+/** @var int $total_pages */
+/** @var int $current_page */
+/** @var string $current_status */
+/** @var int $current_product */
+/** @var string $current_search */
+/** @var int $per_page */
+/** @var array $fpp_products */
+$base_url = admin_url('edit.php?post_type=product&page=studiou-fpp-summary');
+?>
+<div class="wrap studiou-fpp-admin-wrap">
+    <h1><?php esc_html_e('Free Photo Files', 'studiou-wc-free-photo-product'); ?></h1>
+
+    <div class="studiou-fpp-admin-notice-area"></div>
+
+    <!-- Filters -->
+    <div class="studiou-fpp-filters">
+        <form method="get" action="<?php echo esc_url(admin_url('edit.php')); ?>">
+            <input type="hidden" name="post_type" value="product" />
+            <input type="hidden" name="page" value="studiou-fpp-summary" />
+
+            <select name="status">
+                <option value=""><?php esc_html_e('All Statuses', 'studiou-wc-free-photo-product'); ?></option>
+                <option value="ready" <?php selected($current_status, 'ready'); ?>><?php esc_html_e('Ready', 'studiou-wc-free-photo-product'); ?></option>
+                <option value="downloaded" <?php selected($current_status, 'downloaded'); ?>><?php esc_html_e('Downloaded', 'studiou-wc-free-photo-product'); ?></option>
+                <option value="solved" <?php selected($current_status, 'solved'); ?>><?php esc_html_e('Solved', 'studiou-wc-free-photo-product'); ?></option>
+            </select>
+
+            <select name="product_id">
+                <option value=""><?php esc_html_e('All Products', 'studiou-wc-free-photo-product'); ?></option>
+                <?php foreach ($fpp_products as $pid => $pname) : ?>
+                    <option value="<?php echo esc_attr($pid); ?>" <?php selected($current_product, $pid); ?>><?php echo esc_html($pname); ?></option>
+                <?php endforeach; ?>
+            </select>
+
+            <input type="search" name="s" value="<?php echo esc_attr($current_search); ?>" placeholder="<?php esc_attr_e('Search file name...', 'studiou-wc-free-photo-product'); ?>" />
+
+            <button type="submit" class="button"><?php esc_html_e('Filter', 'studiou-wc-free-photo-product'); ?></button>
+        </form>
+    </div>
+
+    <!-- Bulk actions -->
+    <div class="studiou-fpp-bulk-actions">
+        <select id="studiou-fpp-bulk-action">
+            <option value=""><?php esc_html_e('Bulk Actions', 'studiou-wc-free-photo-product'); ?></option>
+            <option value="download_zip"><?php esc_html_e('Download ZIP', 'studiou-wc-free-photo-product'); ?></option>
+            <option value="status_ready"><?php esc_html_e('Set Status: Ready', 'studiou-wc-free-photo-product'); ?></option>
+            <option value="status_downloaded"><?php esc_html_e('Set Status: Downloaded', 'studiou-wc-free-photo-product'); ?></option>
+            <option value="status_solved"><?php esc_html_e('Set Status: Solved', 'studiou-wc-free-photo-product'); ?></option>
+            <option value="delete"><?php esc_html_e('Delete', 'studiou-wc-free-photo-product'); ?></option>
+        </select>
+        <button type="button" class="button" id="studiou-fpp-bulk-apply"><?php esc_html_e('Apply', 'studiou-wc-free-photo-product'); ?></button>
+        <span class="spinner" id="studiou-fpp-bulk-spinner"></span>
+
+        <span class="studiou-fpp-total-count">
+            <?php echo esc_html(sprintf(
+                _n('%d file', '%d files', $total, 'studiou-wc-free-photo-product'),
+                $total
+            )); ?>
+        </span>
+    </div>
+
+    <!-- Files table -->
+    <table class="wp-list-table widefat fixed striped studiou-fpp-files-table">
+        <thead>
+            <tr>
+                <td class="manage-column column-cb check-column">
+                    <input type="checkbox" id="studiou-fpp-select-all" />
+                </td>
+                <th class="column-thumbnail"><?php esc_html_e('Preview', 'studiou-wc-free-photo-product'); ?></th>
+                <th class="column-filename"><?php esc_html_e('File Name', 'studiou-wc-free-photo-product'); ?></th>
+                <th class="column-product"><?php esc_html_e('Product', 'studiou-wc-free-photo-product'); ?></th>
+                <th class="column-order"><?php esc_html_e('Order', 'studiou-wc-free-photo-product'); ?></th>
+                <th class="column-customer"><?php esc_html_e('Customer', 'studiou-wc-free-photo-product'); ?></th>
+                <th class="column-status"><?php esc_html_e('Status', 'studiou-wc-free-photo-product'); ?></th>
+                <th class="column-date"><?php esc_html_e('Date', 'studiou-wc-free-photo-product'); ?></th>
+                <th class="column-actions"><?php esc_html_e('Actions', 'studiou-wc-free-photo-product'); ?></th>
+            </tr>
+        </thead>
+        <tbody>
+            <?php if (empty($records)) : ?>
+                <tr>
+                    <td colspan="9"><?php esc_html_e('No files found.', 'studiou-wc-free-photo-product'); ?></td>
+                </tr>
+            <?php else : ?>
+                <?php foreach ($records as $record) :
+                    $attachment_url = wp_get_attachment_url($record->attachment_id);
+                    $thumb = wp_get_attachment_image_src($record->attachment_id, 'thumbnail');
+                    $thumb_url = $thumb ? $thumb[0] : wp_mime_type_icon($record->attachment_id);
+                    $product_title = get_the_title($record->product_id);
+
+                    $customer_name = '';
+                    if ($record->customer_id > 0) {
+                        $user = get_userdata($record->customer_id);
+                        $customer_name = $user ? $user->display_name : '#' . $record->customer_id;
+                    } else {
+                        $customer_name = __('Guest', 'studiou-wc-free-photo-product');
+                    }
+
+                    $order_link = '';
+                    if ($record->order_id > 0) {
+                        $order_url = Studiou_WC_FPP_Admin::get_order_edit_url($record->order_id);
+                        $order_link = '<a href="' . esc_url($order_url) . '">#' . esc_html($record->order_id) . '</a>';
+                    } else {
+                        $order_link = '<span class="studiou-fpp-no-order">—</span>';
+                    }
+
+                    // Download URL that also marks file as downloaded
+                    $download_url = add_query_arg(array(
+                        'studiou_fpp_download_file' => 1,
+                        'file_record_id' => $record->id,
+                        'attachment_id' => $record->attachment_id,
+                        '_wpnonce' => wp_create_nonce('studiou-fpp-download-file'),
+                    ), admin_url('admin.php'));
+                    ?>
+                    <tr data-file-id="<?php echo esc_attr($record->id); ?>">
+                        <th scope="row" class="check-column">
+                            <input type="checkbox" class="studiou-fpp-file-cb" value="<?php echo esc_attr($record->id); ?>" />
+                        </th>
+                        <td class="column-thumbnail">
+                            <img src="<?php echo esc_url($thumb_url); ?>" alt="" class="studiou-fpp-thumb" />
+                        </td>
+                        <td class="column-filename">
+                            <?php if ($attachment_url) : ?>
+                                <a href="<?php echo esc_url($attachment_url); ?>" target="_blank"><?php echo esc_html($record->file_name); ?></a>
+                            <?php else : ?>
+                                <?php echo esc_html($record->file_name); ?>
+                            <?php endif; ?>
+                        </td>
+                        <td class="column-product">
+                            <a href="<?php echo esc_url(get_edit_post_link($record->product_id)); ?>"><?php echo esc_html($product_title); ?></a>
+                        </td>
+                        <td class="column-order">
+                            <?php echo $order_link; ?>
+                        </td>
+                        <td class="column-customer">
+                            <?php echo esc_html($customer_name); ?>
+                        </td>
+                        <td class="column-status">
+                            <select class="studiou-fpp-status-select" data-file-id="<?php echo esc_attr($record->id); ?>">
+                                <option value="ready" <?php selected($record->status, 'ready'); ?>><?php esc_html_e('Ready', 'studiou-wc-free-photo-product'); ?></option>
+                                <option value="downloaded" <?php selected($record->status, 'downloaded'); ?>><?php esc_html_e('Downloaded', 'studiou-wc-free-photo-product'); ?></option>
+                                <option value="solved" <?php selected($record->status, 'solved'); ?>><?php esc_html_e('Solved', 'studiou-wc-free-photo-product'); ?></option>
+                            </select>
+                        </td>
+                        <td class="column-date">
+                            <?php echo esc_html(date_i18n(get_option('date_format') . ' ' . get_option('time_format'), strtotime($record->created_at))); ?>
+                        </td>
+                        <td class="column-actions">
+                            <?php if ($attachment_url) : ?>
+                                <a href="<?php echo esc_url($download_url); ?>" class="button button-small" title="<?php esc_attr_e('Download', 'studiou-wc-free-photo-product'); ?>">
+                                    <span class="dashicons dashicons-download" style="line-height:1.4;"></span>
+                                </a>
+                            <?php endif; ?>
+                            <button type="button" class="button button-small studiou-fpp-delete-single" data-file-id="<?php echo esc_attr($record->id); ?>" title="<?php esc_attr_e('Delete', 'studiou-wc-free-photo-product'); ?>">
+                                <span class="dashicons dashicons-trash" style="line-height:1.4;color:#b32d2e;"></span>
+                            </button>
+                        </td>
+                    </tr>
+                <?php endforeach; ?>
+            <?php endif; ?>
+        </tbody>
+    </table>
+
+    <!-- Pagination -->
+    <?php if ($total_pages > 1) : ?>
+        <div class="tablenav bottom">
+            <div class="tablenav-pages">
+                <span class="displaying-num">
+                    <?php echo esc_html(sprintf(
+                        _n('%d file', '%d files', $total, 'studiou-wc-free-photo-product'),
+                        $total
+                    )); ?>
+                </span>
+                <?php
+                // Preserve filters in pagination links
+                $pagination_args = array(
+                    'post_type'  => 'product',
+                    'page'       => 'studiou-fpp-summary',
+                );
+                if ($current_status) $pagination_args['status'] = $current_status;
+                if ($current_product) $pagination_args['product_id'] = $current_product;
+                if ($current_search) $pagination_args['s'] = $current_search;
+
+                $pagination = paginate_links(array(
+                    'base'      => add_query_arg('paged', '%#%', admin_url('edit.php?' . http_build_query($pagination_args))),
+                    'format'    => '',
+                    'current'   => $current_page,
+                    'total'     => $total_pages,
+                    'prev_text' => '&laquo;',
+                    'next_text' => '&raquo;',
+                ));
+                if ($pagination) {
+                    echo $pagination;
+                }
+                ?>
+            </div>
+        </div>
+    <?php endif; ?>
+</div>

studiou-wc-free-photo-product/views/frontend-product.php

@@ -0,0 +1,36 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+/** @var WC_Product_Variable $product */
+/** @var int $max_file_size */
+$product_id = $product->get_id();
+?>
+<div class="studiou-fpp-product">
+
+    <div class="studiou-fpp-product-header">
+        <?php if ($product->get_image_id()) : ?>
+            <div class="studiou-fpp-product-image">
+                <?php echo $product->get_image('woocommerce_thumbnail'); ?>
+            </div>
+        <?php endif; ?>
+        <div class="studiou-fpp-product-info">
+            <h2 class="studiou-fpp-product-title"><?php echo esc_html($product->get_name()); ?></h2>
+            <?php if ($product->get_short_description()) : ?>
+                <div class="studiou-fpp-product-description">
+                    <?php echo wp_kses_post($product->get_short_description()); ?>
+                </div>
+            <?php endif; ?>
+        </div>
+    </div>
+
+    <?php
+    // Render WooCommerce native product form (includes variation selectors + add to cart)
+    // The upload area is injected via woocommerce_before_add_to_cart_button hook
+    ?>
+    <div class="studiou-fpp-section">
+        <?php woocommerce_variable_add_to_cart(); ?>
+    </div>
+
+</div>

studiou-wc-free-photo-product/views/single-product-upload.php

@@ -0,0 +1,54 @@
+<?php
+if (!defined('WPINC')) {
+    die;
+}
+
+/** @var int $product_id */
+/** @var int $max_file_size */
+?>
+<div class="studiou-fpp-upload-wrap" data-product-id="<?php echo esc_attr($product_id); ?>" data-max-file-size="<?php echo esc_attr($max_file_size); ?>">
+
+    <h3><?php esc_html_e('Upload Your Photo', 'studiou-wc-free-photo-product'); ?></h3>
+    <?php
+    $custom_info = Studiou_WC_FPP_Product::get_product_upload_info_text($product_id);
+    if (!empty($custom_info)) :
+    ?>
+        <p class="studiou-fpp-upload-info"><?php echo nl2br(esc_html($custom_info)); ?></p>
+    <?php else : ?>
+        <p class="studiou-fpp-upload-info">
+            <?php echo esc_html(sprintf(
+                __('Maximum file size: %s MB. Accepted formats: JPEG, PNG, TIFF, BMP, PSD, RAW (CR2, NEF, ARW, DNG, ORF, RW2, RAF), WebP.', 'studiou-wc-free-photo-product'),
+                $max_file_size
+            )); ?>
+        </p>
+    <?php endif; ?>
+
+    <div class="studiou-fpp-upload-area" id="studiou-fpp-dropzone">
+        <div class="studiou-fpp-upload-prompt">
+            <span class="studiou-fpp-upload-icon dashicons dashicons-upload"></span>
+            <p><?php esc_html_e('Drag & drop your file here or click to browse', 'studiou-wc-free-photo-product'); ?></p>
+        </div>
+        <input type="file" id="studiou-fpp-file-input" class="studiou-fpp-file-input"
+            accept=".jpg,.jpeg,.png,.tiff,.tif,.bmp,.psd,.cr2,.nef,.arw,.dng,.orf,.rw2,.raf,.webp" />
+    </div>
+
+    <div class="studiou-fpp-progress" style="display:none;">
+        <div class="studiou-fpp-progress-bar">
+            <div class="studiou-fpp-progress-fill" style="width:0%"></div>
+        </div>
+        <span class="studiou-fpp-progress-text">0%</span>
+    </div>
+
+    <div class="studiou-fpp-preview" style="display:none;">
+        <div class="studiou-fpp-preview-image">
+            <img src="" alt="<?php esc_attr_e('Preview', 'studiou-wc-free-photo-product'); ?>" />
+        </div>
+        <div class="studiou-fpp-preview-info">
+            <span class="studiou-fpp-preview-name"></span>
+            <button type="button" class="button studiou-fpp-remove-file"><?php esc_html_e('Remove', 'studiou-wc-free-photo-product'); ?></button>
+        </div>
+    </div>
+
+    <div class="studiou-fpp-messages"></div>
+
+</div>