User Guide – Mass Product Image Updater

Ο οδηγός εξηγεί πώς ο διαχειριστής χρησιμοποιεί το module για μαζική ενημέρωση εικόνων προϊόντων σε OpenMage / Magento 1.

Admin areas

• Catalog -> Manage Products: επιλογή προϊόντων και mass action.
• System -> Configuration -> IOWEB TECHNOLOGIES -> Mass Product Image Updater: πληροφορίες module και Installation ID.

Κύριες δυνατότητες

• Προσθέτει mass action με όνομα Mass Image Update στο product grid.
• Ανοίγει admin upload form για τα επιλεγμένα προϊόντα.
• Επιτρέπει upload μίας ή περισσότερων εικόνων με το κουμπί +.
• Υποστηρίζει αρχεία jpg, jpeg, gif και png.
• Προσθέτει κάθε uploaded image στο media gallery κάθε επιλεγμένου προϊόντος.
• Μπορεί να ορίσει image roles: base image, small image και thumbnail.
• Εμφανίζει result page με επιτυχίες και σφάλματα.

Βήματα χρήσης

1. Πηγαίνετε στο Catalog -> Manage Products.
2. Χρησιμοποιήστε τα filters του grid για να περιορίσετε τα προϊόντα που θέλετε να ενημερώσετε.
3. Επιλέξτε τα προϊόντα με τα checkboxes της πρώτης στήλης.
4. Από το mass action dropdown επιλέξτε Mass Image Update.
5. Πατήστε submit για να ανοίξει η φόρμα upload.
6. Στη φόρμα που ανοίγει, ανεβάστε την πρώτη εικόνα.
7. Επιλέξτε αν η εικόνα θα γίνει base image, small image ή thumbnail.
8. Πατήστε + αν θέλετε να προσθέσετε επιπλέον εικόνες στην ίδια διαδικασία.
9. Πατήστε Update.
10. Ελέγξτε τη result page για επιτυχίες ή σφάλματα.

Image role checkboxes

Base Image
Ορίζει την εικόνα στο Magento role image. Συνήθως χρησιμοποιείται ως κύρια εικόνα προϊόντος.

Small Image
Ορίζει την εικόνα στο Magento role small_image. Συνήθως χρησιμοποιείται σε listings και catalog views, ανάλογα με το theme.

Thumbnail
Ορίζει την εικόνα στο Magento role thumbnail. Συνήθως χρησιμοποιείται σε μικρές προεπισκοπήσεις, cart rows ή admin previews, ανάλογα με το theme.

Αν δεν επιλεγεί κανένα role, η εικόνα προστίθεται στο media gallery και μπορεί να χρησιμοποιηθεί από το Magento όπως κάθε άλλη gallery image.

Χρήση πολλών εικόνων

Κάθε επιπλέον γραμμή upload εφαρμόζεται στα ίδια επιλεγμένα προϊόντα. Έτσι μπορείτε, για παράδειγμα, να προσθέσετε μία κύρια εικόνα και δύο gallery images στην ίδια εκτέλεση.

Προτεινόμενη διαδικασία για μεγάλα updates

1. Ξεκινήστε με μικρό test selection, όπως 2-3 προϊόντα.
2. Ελέγξτε στο product edit page ότι οι εικόνες και τα roles εφαρμόστηκαν σωστά.
3. Καθαρίστε cache αν το storefront εμφανίζει cached εικόνες.
4. Συνεχίστε με μεγαλύτερα batches, ανάλογα με τα PHP upload και execution limits του server.

Installation notes

Το module απαιτεί το IOWEB Base extension. Μετά την εγκατάσταση πρέπει να γίνει cache clear και logout/login στο admin panel για ανανέωση ACL permissions.

Admin template requirement

Για να φορτωθούν σωστά τα admin assets, το admin head template πρέπει να περιλαμβάνει:

<?php echo $this->getChildHtml('ioweb_massproductimageupdater_requirements') ?>

Αν το αρχείο app/design/adminhtml/default/default/template/page/head.phtml είναι ήδη τροποποιημένο από άλλο module ή theme, προσθέστε το παραπάνω block χειροκίνητα στο υπάρχον template.

Προτεινόμενα PHP limits

• upload_max_filesize = 32M
• post_max_size = 32M
• max_file_uploads = 10
• max_execution_time = 300
• memory_limit = 512M

Operational guidance

Το πραγματικό workload είναι ο αριθμός των επιλεγμένων προϊόντων επί τον αριθμό των uploaded images. Για παράδειγμα, 20 προϊόντα και 3 εικόνες σημαίνουν 60 image additions. Για μεγάλα catalogs ξεκινήστε με μικρότερα batches και αυξήστε σταδιακά.

Troubleshooting

• Αν δεν εμφανίζεται το mass action, καθαρίστε cache και κάντε logout/login στο admin.
• Αν η φόρμα έχει σπασμένο styling ή κουμπιά, ελέγξτε το admin head template requirement.
• Αν αποτυγχάνει το upload, ελέγξτε file extension, PHP upload limits και δικαιώματα στο media/.
• Αν κάνει timeout, επιλέξτε λιγότερα προϊόντα ή αυξήστε max_execution_time και memory_limit.
• Αν οι εικόνες προστίθενται αλλά δεν φαίνονται στο storefront, ελέγξτε image roles, cache, theme behavior και file permissions.