Οδηγός εγκατάστασης Shopflix XML Feed για WooCommerce

Οδηγός εγκατάστασης Shopflix XML Feed για WooCommerce

Προαπαιτούμενα

• Λογαριασμός πωλητή στη Shopflix.
• EAN στα προϊόντα, αποθηκευμένα σε πεδίο του WooCommerce (meta ή SKU).
• Brand ως attribute ή meta, κατηγορίες και εικόνες σε δημόσια HTTPS διεύθυνση.
• Απόφαση για τον χρόνο αποστολής (ημέρες) ανά προϊόν ή για όλο το κατάστημα.
• Μνήμη PHP τουλάχιστον 256M για μεγάλους καταλόγους.

Εγκατάσταση και License key

1. Κατεβάστε το ZIP από τις λήψεις του λογαριασμού σας. Στο WordPress: Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου → Εγκατάσταση τώρα → Ενεργοποίηση.
2. Ανοίξτε WooCommerce → OBS Shopflix XML.
3. Στο πλαίσιο «Activate OBS Shopflix XML for Update» επικολλήστε το License key στο «Enter Validation Key» και πατήστε Activate.

Χάρτης ρυθμίσεων

• Required Setup: Update Frequency (Hourly / Twice a day / Daily), Mode (Bulk / Cron / Chunk), Default Page Size, Color Attributes, Size Attributes, Default Brand, Brand Attribute, Product Description (Short / Full), Skip Out-of-Stock Products, Skip Backordered Products, Product Name Composer.
• Filters: Include / Exclude Categories, Include / Exclude Brands (με ορισμένο Brand Attribute).
• Overrides: Custom Meta field for EAN, MPN, Barcode, Brand, Product ID, Weight, Availability, Skip product meta.
• Advanced: Test Export Product Limit, Test Export SKU Filter και τα πεδία της Shopflix: MOMM Fashion Format, Add Lead Time Field, Custom Meta field for Lead Time, Default Lead Time, Default Stock Quantity, EAN Prefix.
• Προϊόν: με «Add Lead Time Field = Yes» εμφανίζεται το πεδίο «Shipping Lead Time» στην καρτέλα Γενικά· στο πλάι, «Hide from OBS Shopflix XML».

Δοκιμή και validation

1. Γράψτε 5–10 SKU στο Test Export SKU Filter (απλό, μεταβλητό, σε προσφορά, χωρίς διαχείριση αποθέματος) και πατήστε Quick test export. Η δοκιμή αντικαθιστά το shopflix.xml, οπότε κάντε πλήρη εξαγωγή αμέσως μετά.
2. Ελέγξτε σε κάθε προϊόν ean, quantity, shipping_lead_time, price και list_price, category και image.
3. Πατήστε Generate feed now. Το αρχείο είναι στο wp-content/uploads/obs-xml-export/shopflix.xml.
4. Ανοίξτε το URL από εξωτερικό δίκτυο: πρέπει να ανοίγει ως XML.

Αυτόματη ανανέωση

Στην κάρτα «Scheduling» πατήστε «Show server cron command» και προσθέστε την εντολή στο crontab του server. Το WP-Cron εξαρτάται από τις επισκέψεις στο site και δεν είναι αξιόπιστο για ενημέρωση αποθέματος.

Go-live checklist

• License key ενεργό.
• EAN σε όλα τα προϊόντα, χωρίς ανεπιθύμητο πρόθεμα.
• Default Lead Time με πραγματικές ημέρες αποστολής.
• Διαχείριση αποθέματος ή «Skip Out-of-Stock Products» ενεργό, ώστε να μη στέλνονται εξαντλημένα.
• Η Shopflix έχει πρόσβαση στο URL (whitelist IP στο firewall ή στο CDN).
• Server cron ενεργό και δεύτερη επιτυχημένη εξαγωγή μετά από αλλαγή τιμής.

Αντιμετώπιση προβλημάτων

• Σύμπτωμα: Η Shopflix στέλνει email ότι η αυτόματη ανανέωση του XML αποτυγχάνει και ζητά whitelist IP.
  Αιτία: Firewall, Cloudflare ή bot protection μπλοκάρει τις διευθύνσεις της Shopflix όταν διαβάζει το αρχείο.
  Λύση: Επιτρέψτε στο firewall ή στο CDN τις IP που σας έστειλε η Shopflix για τη διαδρομή /wp-content/uploads/obs-xml-export/shopflix.xml και ελέγξτε το URL από εξωτερικό δίκτυο.
• Σύμπτωμα: Έρχονται παραγγελίες από τη Shopflix για προϊόντα που έχουν εξαντληθεί.
  Αιτία: Τα προϊόντα δεν έχουν διαχείριση αποθέματος, οπότε στέλνεται η «Default Stock Quantity» ακόμα κι αν είναι εξαντλημένα, ή το feed δεν έχει ανανεωθεί.
  Λύση: Ενεργοποιήστε διαχείριση αποθέματος ή το «Skip Out-of-Stock Products», ελέγξτε την τιμή του «Default Stock Quantity» και βάλτε server cron.
• Σύμπτωμα: Ο χρόνος αποστολής μένει 0 ενώ αλλάξατε το «Default Lead Time».
  Αιτία: Το προϊόν έχει δική του τιμή 0 στο πεδίο «Shipping Lead Time» ή στο meta πεδίο, που υπερισχύει της προεπιλογής, ή το feed δεν έχει ξαναπαραχθεί.
  Λύση: Αδειάστε ή διορθώστε την τιμή στο προϊόν, πατήστε «Generate feed now» και ελέγξτε το shipping_lead_time στο XML.
• Σύμπτωμα: Το EAN δεν εμφανίζεται στο XML ή βγαίνει με πρόθεμα.
  Αιτία: Το «Custom Meta field for EAN» είναι κενό ή δείχνει σε λάθος πεδίο· το «EAN Prefix» μπαίνει σε κάθε κωδικό που δεν είναι 13ψήφιος.
  Λύση: Ορίστε το meta key των barcodes (ή _sku) και αδειάστε το «EAN Prefix» αν δεν το χρειάζεστε.
• Σύμπτωμα: Η Shopflix αναφέρει ότι λείπουν οι παραλλαγές ή τα μεγέθη.
  Αιτία: Δεν έχουν οριστεί «Size Attributes» και «Color Attributes» ή η κατηγορία μόδας χρειάζεται το fashion format.
  Λύση: Ορίστε τα attributes μεγέθους και χρώματος και, για ένδυση και υπόδηση, ενεργοποιήστε «MOMM Fashion Format».
• Σύμπτωμα: Το feed δεν ανανεώνεται ή η ημερομηνία created_at είναι παλιά.
  Αιτία: Το WP-Cron δεν τρέχει χωρίς επισκέψεις ή η εξαγωγή σταματά από όριο μνήμης ή χρόνου.
  Λύση: Προσθέστε την εντολή server cron, αυξήστε τη μνήμη PHP σε 256M ή περισσότερο και επιλέξτε Mode Cron για μεγάλο κατάλογο.
• Σύμπτωμα: Στο XML λείπουν προϊόντα του καταστήματος.
  Αιτία: Φίλτρα κατηγοριών ή αποθέματος, προϊόντα που δεν είναι δημοσιευμένα ή δύο προϊόντα με ακριβώς ίδιο τίτλο χωρίς μέγεθος.
  Λύση: Ελέγξτε τα Filters και το Skip Out-of-Stock και δώστε διαφορετικούς τίτλους σε προϊόντα που έχουν τον ίδιο.
• Σύμπτωμα: Μετά από αναβάθμιση της PHP εμφανίζονται μηνύματα «Creation of dynamic property … is deprecated».
  Αιτία: Ειδοποίηση συμβατότητας της PHP 8.2, όχι σφάλμα του feed.
  Λύση: Απενεργοποιήστε την εμφάνιση σφαλμάτων στο site (WP_DEBUG_DISPLAY) και ζητήστε μας την τρέχουσα έκδοση του plugin.