User Guide – BestPrice Feed Variations

Ο παρακάτω οδηγός εξηγεί πώς ο διαχειριστής ρυθμίζει και παράγει BestPrice XML feed σε OpenMage / Magento 1. Το προϊόν χρησιμοποιεί το ίδιο source package με το Skroutz Feed Variations, γι’ αυτό το admin section στο Magento εμφανίζεται ως Skroutz Feed.

Admin path

System -> Configuration -> IOWEB TECHNOLOGIES -> Skroutz Feed

Γρήγορη διαδικασία ρύθμισης

1. Εγκαταστήστε το module και καθαρίστε την cache του Magento.
2. Κάντε logout/login στο admin ώστε να ανανεωθούν τα ACL permissions.
3. Ανοίξτε το configuration path του module.
4. Ορίστε το όνομα του XML αρχείου, π.χ. bestprice.xml.
5. Επιλέξτε αν το feed θα περιλαμβάνει ή θα αποκλείει συγκεκριμένες κατηγορίες.
6. Επιλέξτε τα attributes για EAN, χρώμα, μέγεθος και πρόσθετα χαρακτηριστικά περιγραφής.
7. Ρυθμίστε αν θα εξάγονται additional images, weight, MPN και unsaleable products.
8. Ρυθμίστε batch size και batch sleep period για την απόδοση.
9. Αποθηκεύστε τις ρυθμίσεις.
10. Παράγετε το feed από URL ή CLI.
11. Ελέγξτε το XML πριν δοθεί στο BestPrice.
12. Προγραμματίστε cron job αν χρειάζεται αυτόματη ανανέωση.

Options

Filename
Ορίζει το όνομα του XML αρχείου που αποθηκεύεται στο Magento root. Αν βάλετε bestprice.xml, το τελικό αρχείο συνήθως θα είναι διαθέσιμο ως https://www.example.com/bestprice.xml.

Analytics ID
Το configuration περιλαμβάνει Skroutz Analytics ID επειδή το ίδιο package χρησιμοποιείται και για Skroutz. Για BestPrice feed generation το κρίσιμο κομμάτι είναι η XML εξαγωγή προϊόντων.

Category Action
Ορίζει πώς χρησιμοποιείται η επιλογή κατηγοριών. Με Include εξάγονται προϊόντα από τις επιλεγμένες κατηγορίες. Με Exclude αφαιρούνται προϊόντα από τις επιλεγμένες κατηγορίες.

Categories
Επιλέγει τις κατηγορίες που συμμετέχουν στον κανόνα. Τα child categories περιλαμβάνονται αυτόματα στον include/exclude κανόνα.

Color Attributes
Επιλέγει τα configurable select attributes που αντιστοιχούν σε χρώμα. Χρησιμοποιούνται για color-based configurable προϊόντα, σταθερά product IDs ανά χρώμα, color URLs και child product images.

Size Attributes
Επιλέγει τα configurable select attributes που αντιστοιχούν σε μέγεθος. Χρησιμοποιούνται για size values και nested variation nodes με quantity, EAN, availability, link και price data.

Description Attributes
Επιλέγει πρόσθετα product attributes που προστίθενται στο XML description μετά το short description, σε μορφή Label: Value.

EAN Attribute
Επιλέγει το attribute όπου είναι αποθηκευμένο το EAN. Στα variations χρησιμοποιείται πρώτα το child EAN και, αν λείπει, γίνεται fallback στο parent EAN.

Use Simple Product Prices
Ορίζει αν color-based configurable rows μπορούν να χρησιμοποιούν τις τιμές των child simple products αντί για την parent configurable τιμή.

Additional Image
Όταν είναι ενεργό, εξάγει additional image nodes από το media gallery. Για color rows χρησιμοποιούνται images από το αντίστοιχο child product.

Skip Products That Can’t Be Sold
Όταν είναι ενεργό, παραλείπει προϊόντα για τα οποία το Magento επιστρέφει isSaleable() = false.

Use Weight
Προσθέτει weight node. Τα simple products εξάγουν το δικό τους weight, ενώ τα configurable products εξάγουν το μεγαλύτερο weight από τα children.

Include MPN Node
Ορίζει αν θα εξαχθεί MPN node. Η τιμή προέρχεται πρώτα από io_skroutz_mpn και αν είναι κενή χρησιμοποιείται το SKU.

XML Node Names

Στο section XML Node Names ο διαχειριστής μπορεί να αλλάξει τα tag names του XML. Μπορούν να ρυθμιστούν root, created_at, products, product, name, url, image, additional_image, category, categoryid, price_with_vat, vat, manufacturer, description, mpn, ean, InStock, availability, weight, qty, color, size, variations, variation, variationid, link και isbn. Αν δοθεί άκυρο XML element name, το module χρησιμοποιεί το default.

Performance

Batch Size
Ορίζει πόσα προϊόντα επεξεργάζεται κάθε batch. Μικρότερη τιμή μειώνει memory pressure, μεγαλύτερη τιμή μπορεί να ολοκληρώνει πιο γρήγορα σε δυνατό server.

Batch Sleep Period
Ορίζει πόσα δευτερόλεπτα περιμένει ο generator μετά από κάθε batch. Χρήσιμο σε shared hosting.

Use Pregenerated Images
Ορίζει αν τα image URLs θα δημιουργούνται μέσω Magento catalog image helper ή απευθείας από το media URL και το αποθηκευμένο image path.

FBS / Zero Quantity Setting

Το package περιλαμβάνει ρύθμιση force zero quantity για ειδικά marketplace workflows. Όταν είναι ενεργή, όλες οι ποσότητες που εξάγονται στο XML γίνονται 0. Δεν αλλάζει το Magento stock, επηρεάζει μόνο το feed.

Product edit fields

Στο Catalog -> Manage Products -> Edit Product το module χρησιμοποιεί τα παρακάτω πεδία:

• io_skroutz_mpn: MPN override. Αν είναι κενό, χρησιμοποιείται το SKU.
• io_skroutz_exclude: αν οριστεί σε Yes, το προϊόν αποκλείεται πάντα από το feed, ακόμα και αν ανήκει σε included category.

Τα internal attribute codes διατηρούν το αρχικό package naming, αλλά μπορούν να χρησιμοποιηθούν κανονικά και για BestPrice feed χρήση.

Manual feed generation από browser

Ανοίξτε:

https://www.example.com/ioweb/feed/generate

Το module φορτώνει το store configuration, επιλέγει τα προϊόντα, δημιουργεί το XML, επιστρέφει το XML στο browser και αποθηκεύει το αρχείο στο Magento root με το configured filename.

CLI feed generation

Με n98-magerun:

n98-magerun iowebskroutzfeed:generate --store=1

Χρήσιμα options:

• --store=1: store view ID.
• --memory=2G: PHP memory limit.
• --exec_time=1800: μέγιστος χρόνος εκτέλεσης.
• --limit=100: test generation για συγκεκριμένο αριθμό προϊόντων.
• --debug-id=1234: generation για ένα συγκεκριμένο product ID.

Cron scheduling

Το module δεν εγκαθιστά δικό του Magento cron. Για αυτόματη ανανέωση πρέπει να δημιουργηθεί server cron job.

Προτεινόμενο cron με n98-magerun:

15 3 * * * cd /var/www/example.com && /usr/bin/php /usr/local/bin/n98-magerun iowebskroutzfeed:generate --store=1 --memory=2G --exec_time=1800 >> var/log/ioweb_bestpricefeed_cron.log 2>&1

Εναλλακτικό cron με wget για μικρότερα catalogs:

15 3 * * * /usr/bin/wget -q -O /dev/null "https://www.example.com/ioweb/feed/generate"

Εναλλακτικό cron με curl:

15 3 * * * /usr/bin/curl -fsS "https://www.example.com/ioweb/feed/generate" > /dev/null

Για πολλά store views, δημιουργήστε ξεχωριστό command ανά store view και διαφορετικό filename ανά store scope.

Έλεγχος μετά το generation

1. Επιβεβαιώστε ότι το XML αρχείο δημιουργήθηκε στο Magento root.
2. Ανοίξτε το public feed URL.
3. Ελέγξτε product count, κατηγορίες, τιμές με ΦΠΑ, EAN, MPN, εικόνες και availability.
4. Ελέγξτε configurable products με χρώμα/μέγεθος.
5. Ελέγξτε αν out-of-stock προϊόντα εμφανίζονται σύμφωνα με τη ρύθμιση.

Σημαντικοί περιορισμοί

• Δεν ανεβάζει αυτόματα το XML στο BestPrice.
• Δεν δημιουργεί cron schedule από μόνο του.
• Δεν συγχρονίζει orders, stock ή prices με BestPrice.
• Στην τρέχουσα έκδοση ο generation controller δεν φαίνεται να έχει query parameter guard στον κώδικα. Αν απαιτείται προστασία, πρέπει να ελεγχθεί/προστεθεί ή να προστατευτεί από web server rules.