Οδηγός εγκατάστασης WooCommerce Skroutz / BestPrice XML feed

Το XML feed δεν είναι απλό export προϊόντων. Για να εγκριθεί, πρέπει να στέλνει σωστές τιμές, stock, κατηγορίες, εικόνες και marketplace fields όπως brand, EAN ή MPN όπου υπάρχουν. Η έκδοση 2.0.0 απαιτεί PHP 8.1+.

Τι καλύπτει — και τι δεν καλύπτει

Το plugin δημιουργεί XML για Skroutz και BestPrice. Δεν είναι Google Shopping feed, connector παραγγελιών ή Skroutz Smart Cart· αυτές οι ροές χρησιμοποιούν ξεχωριστά plugins.

Checklist πριν το setup

• Πλήρες backup αρχείων/βάσης και πρώτη ρύθμιση σε staging
• WordPress admin πρόσβαση και writable φάκελος κάτω από web root
• Καθαρά SKU, titles, final prices, stock status, permalinks και κύριες εικόνες
• Καταγραφή του source για brand, EAN/GTIN, MPN, ISBN, χρώμα και μέγεθος
• Απόφαση για availability ανά stock/backorder state
• Λίστα category/product exclusions και αντιπροσωπευτικό test sample

Εγκατάσταση ή αναβάθμιση

• Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση προσθέτου
• Επιλέξτε το OBS XML Feed 2.0.0 ZIP, Εγκατάσταση και Ενεργοποίηση
• Σε upgrade κρατήστε screenshot/export των παλιών ρυθμίσεων και το προηγούμενο ZIP
• Ανοίξτε Ρυθμίσεις → Skroutz XML Feed και επιβεβαιώστε καθαρό render χωρίς PHP warning/deprecation/fatal

General Options: generation και αρχείο

• Generate XML URL: το URL που καλεί manual/server generation· το πλήρες token δεν δημοσιεύεται
• XML Request Generate Variable/Value: query parameter και μη προβλέψιμο secret value του generation URL
• XML Filename: όνομα που τελειώνει σε .xml, π.χ. skroutz.xml
• XML compression: ενεργοποιείται μόνο αφού επιβεβαιωθεί ότι ο consumer δέχεται το compressed URL
• XML File Location: υπάρχων writable φάκελος κάτω από web root
• XML Generation Interval: interval που ταιριάζει στη συχνότητα αλλαγής τιμών/stock και στους server resources

Availability ανά κατάσταση αποθέματος

Ρυθμίστε ξεχωριστά προϊόν σε απόθεμα, προϊόν εκτός αποθέματος και προϊόν με επιτρεπτά backorders. Η επιλογή Do not Include αφαιρεί την αντίστοιχη ομάδα από το feed. Μη δηλώνετε άμεση παράδοση όταν η πραγματική αποθήκη δεν την υποστηρίζει.

Map Fields: πρακτικό reference

• Product ID: συνήθως μοναδικό/stable SKU, αλλιώς product/variation ID βάσει mapping
• Manufacturer: taxonomy/attribute/meta που περιέχει το πραγματικό brand, με fallback μόνο όπου είναι νόμιμο και σωστό
• Manufacturer SKU/MPN: πραγματικό part number — όχι τυφλή αντιγραφή SKU
• EAN: έγκυρο EAN/GTIN source ή ρητή επιλογή ότι δεν υπάρχουν EAN
• Product Name: όνομα προϊόντος· append SKU μόνο αν δεν δημιουργεί spam titles
• Product Image: κύρια εικόνα με δημόσιο HTTPS URL
• Product Link: canonical product/variation permalink
• Product Price: current/final price, ελεγμένο σε normal, sale και variation προϊόν
• Categories: συνήθως product_cat· full path μόνο όταν το ζητά το mapping
• Fashion/Book options: color-size ή ISBN μόνο όταν υπάρχουν πραγματικά αντίστοιχα attributes/meta

Categories και exclusions

Inclusion σημαίνει ότι μπαίνουν μόνο οι επιλεγμένες κατηγορίες· exclusion ότι οι επιλεγμένες αφαιρούνται. Ελέγξτε parent/child categories, προϊόν σε πολλαπλές κατηγορίες, variations και τυχόν αντικρουόμενους κανόνες.

Πρώτο Generate και acceptance test

• Save και Generate XML Now
• Έλεγχος Last Generation XML Log και included/skipped counts
• Άνοιγμα XML URL σε private session: HTTP 200, XML και όχι HTML error page
• Sample: simple, variable, sale, out-of-stock, backorder, χωρίς EAN, custom brand και excluded category
• Έλεγχος uniqueness IDs, final prices, availability, εικόνων, permalinks και UTF-8
• Δεύτερο generation και επιβεβαίωση ότι το αρχείο ανανεώνεται χωρίς stale/partial output

Cron και καθημερινή λειτουργία

• Το generation URL καλείται μόνο από trusted scheduler/server cron
• Καταγράψτε timezone/interval και αποφύγετε concurrent jobs
• Μετά από bulk price/stock/category αλλαγές κάντε manual generation και sample diff
• Παρακολουθήστε file timestamp, item count και generation log — η ύπαρξη αρχείου δεν αποδεικνύει ότι είναι φρέσκο

Troubleshooting

• Warning/deprecation: επιβεβαιώστε 2.0.0 και όχι legacy Twig 1 ZIP
• Invalid path/filename: υπάρχων writable webroot φάκελος και όνομα .xml
• Generation URL failure: variable/value, WAF/cache, cron και αλλοίωση token
• Missing products: publish status, stock/backorder rule, category filters και generation log
• Wrong brand/EAN/MPN: πραγματικό taxonomy/meta σε product και variation επίπεδο
• Wrong variation price: mapped price source και sample με/χωρίς sale
• Broken image: δημόσιο HTTPS URL/HTTP 200 χωρίς hotlink restriction
• Timeout/memory: μετρήστε catalog/runtime και προσαρμόστε resources/interval τεκμηριωμένα

Update, rollback και uninstall

Πριν από update κρατήστε το τρέχον ZIP, settings, XML και cron. Μετά το update επαναλάβετε settings render, generation και sample diff. Σε rollback επαναφέρετε μόνο συμβατή προηγούμενη έκδοση και τις αντίστοιχες ρυθμίσεις. Το uninstall αφαιρεί options/logs, αλλά το generated XML μπορεί να παραμείνει στον server και αφαιρείται χειροκίνητα μόνο αφού αποσυνδεθεί από τα marketplaces.

Τι στέλνουμε στο support

Plugin/WP/Woo/PHP versions, ώρα generation, anonymized settings χωρίς token, item counts/log excerpt, δύο product IDs/SKUs και expected/actual αποτέλεσμα. Ποτέ admin password ή πλήρες generation token.

Δες το WooCommerce XML Feed για Skroutz & BestPrice.