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

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

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

• Εμπορικός λογαριασμός car.gr με δυνατότητα εισαγωγής μέσω XML και τα τρέχοντα όρια του πακέτου σας (πλήθος αγγελιών).
• Μοναδικά SKU σε όλα τα προϊόντα και τις παραλλαγές: το SKU χρησιμοποιείται ως κωδικός αγγελίας.
• Περιγραφές προϊόντων με ουσιαστικό κείμενο και φωτογραφίες σε δημόσια HTTPS URLs.
• Για οχήματα: attributes ή meta για μάρκα, μοντέλο, έτος/μήνα ταξινόμησης, κυβικά, χιλιόμετρα, καύσιμο κ.λπ.
• PHP με επέκταση XMLReader (2.3.0) και επαρκή μνήμη (η σελίδα του plugin προτείνει τουλάχιστον 256M).

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

1. Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση και επιλέξτε το ZIP του «OBS Cargr XML». Ενεργοποίηση. Κατά την ενεργοποίηση φορτώνονται οι λίστες μαρκών, μοντέλων και extras του car.gr.
2. Ανοίξτε WooCommerce → OBS Cargr XML.
3. Στο πλαίσιο ενεργοποίησης επικολλήστε το License key στο «Enter Validation Key» και πατήστε Activate.

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

• Type: Vehicles ή Classifieds (προεπιλογή Classifieds).
• Custom Meta field for Product Condition (meta ή attribute pa_…) και Default Product Condition.
• Για Vehicles: Vehicle Type Attribute, Vehicle Make ID Attribute, Vehicle Model ID Attribute, Vehicle Registration Year/Month Attribute, Vehicle Engine, Mileage, Fuel Type, Transmission, Doors, Seats, Color, Drive Type, Power Attribute, Variant Attribute, Features. Στην καρτέλα του προϊόντος εμφανίζονται επίσης πεδία Vehicle Types (Bicycle/Bike/Car/Taxi), Make ID, Model ID, Registration Year/Month, Engine, Mileage, Fuel Type.
• Μεταβλητά προϊόντα στο car.gr (2.3.0): «Μόνο γονικό προϊόν», «Μόνο παραλλαγές» ή «Γονικό και παραλλαγές». Η αλλαγή ζητά επιβεβαίωση και κρατά αντίγραφο των προηγούμενων ρυθμίσεων.
• Κοινές ρυθμίσεις: Update Frequency, Mode (Bulk/Cron/Chunk), Default Page Size, Include/Exclude Categories, Include/Exclude Brands, Skip Out-of-Stock Products, Skip Backordered Products, Custom Meta field for Product ID / MPN / EAN / Brand, Product Description, Test Export Product Limit, Test Export SKU Filter.

Mapping κατηγοριών

1. Κατεβάστε το Excel με τις κατηγορίες του car.gr από το link «Download Car.gr categories excel».
2. Ανοίξτε Ρυθμίσεις → OBS CAR.GR XML Category Mapping (ή το link «Map Categories for XML Output») και συμπληρώστε το ID car.gr για κάθε κατηγορία που εξάγεται.
3. Κατηγορίες χωρίς ID εξαιρέστε τις από το feed· αλλιώς τα προϊόντα τους βγαίνουν χωρίς category_id και απορρίπτονται.

Δοκιμή και validation

1. Βάλτε στο Test Export SKU Filter προϊόντα από διαφορετικές κατηγορίες (και ένα μεταβλητό) και πατήστε Quick test export. Η δοκιμαστική εξαγωγή δημοσιεύεται κι αυτή ως cargr.xml, γι' αυτό κάντε τη πριν δηλώσετε το URL ή ξαναπαράγετε πλήρες feed αμέσως μετά.
2. Ελέγξτε σε κάθε αγγελία: unique_id, category_id, περιγραφή, τιμή, φωτογραφίες, condition και external_link.
3. Πατήστε Generate feed now και δείτε το «Τελευταία εξαγωγή XML». Το αρχείο βρίσκεται στο wp-content/uploads/obs-xml-export/cargr.xml.
4. Ανοίξτε το URL από εξωτερικό δίκτυο: πρέπει να επιστρέφει HTTP 200 και έγκυρο XML.

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

Σε μεγάλους καταλόγους προτιμήστε server cron με την εντολή που δείχνει η σελίδα «Scheduling» (php …/wp-content/plugins/obs-cargr-xml/cron.php, μόνο από CLI) και συχνότητα που αντέχει ο server. Η ωριαία παραγωγή σε μεγάλο κατάλογο μπορεί να επιβαρύνει το site.

Go-live checklist

• License key ενεργό· σωστός Type.
• Όλες οι εξαγόμενες κατηγορίες έχουν ID car.gr.
• Καμία διπλή εγγραφή SKU· επιλεγμένη πολιτική μεταβλητών προϊόντων.
• Πλήρες feed (όχι test export) δημοσιευμένο, «Τελευταία εξαγωγή XML» χωρίς σφάλμα.
• Το car.gr διαβάζει το URL (χωρίς firewall/CDN μπλοκάρισμα)· cron ενεργό.

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

• Σύμπτωμα: Το car.gr απορρίπτει το feed με μήνυμα του τύπου «price not expected, expected category_id».
  Αιτία: Η κατηγορία WooCommerce του προϊόντος δεν έχει ID κατηγορίας car.gr, οπότε το category_id λείπει από την αγγελία.
  Λύση: Συμπληρώστε ID σε όλες τις εξαγόμενες κατηγορίες στη σελίδα Category Mapping ή εξαιρέστε τις κατηγορίες που δεν θέλετε στο car.gr και ξαναπαράγετε.
• Σύμπτωμα: Σφάλματα για κενή κατάσταση (condition), πολύ σύντομη περιγραφή ή λάθος τύπο αγγελίας.
  Αιτία: Δεν έχει οριστεί Default Product Condition, οι περιγραφές είναι κενές/σύντομες ή επιλέχθηκε Vehicles ενώ πουλάτε ανταλλακτικά (ή το αντίθετο).
  Λύση: Ορίστε Default Product Condition ή πεδίο κατάστασης, συμπληρώστε περιγραφές και ελέγξτε το Type.
• Σύμπτωμα: Κάθε παραλλαγή εμφανίζεται ως ξεχωριστή αγγελία ή το car.gr αναφέρει διπλές αγγελίες.
  Αιτία: Οι παραλλαγές εξάγονταν ξεχωριστά ή μοιράζονταν τον κωδικό του γονικού.
  Λύση: Στην 2.3.0 επιλέξτε «Μόνο γονικό προϊόν» στο «Μεταβλητά προϊόντα στο car.gr». Η ρύθμιση δεν αλλάζει τίποτα μέχρι να την αποθηκεύσει διαχειριστής.
• Σύμπτωμα: Η εξαγωγή αποτυγχάνει με «duplicate_unique_id».
  Αιτία: Δύο διαφορετικά προϊόντα έχουν το ίδιο SKU.
  Λύση: Διορθώστε τα SKU των προϊόντων που εμφανίζονται στο «Τελευταία εξαγωγή XML». Μέχρι τότε το προηγούμενο cargr.xml μένει όπως ήταν.
• Σύμπτωμα: Η παραγωγή δεν τελειώνει, βγάζει 503 ή το site βαραίνει κάθε ώρα.
  Αιτία: Μεγάλος κατάλογος με ωριαίο WP-Cron, ανεπαρκής μνήμη/χρόνος PHP ή παλιότερη έκδοση χωρίς τις βελτιώσεις για Redis.
  Λύση: Αναβαθμίστε στην 2.3.0, βάλτε server cron, Mode Chunk και αραιότερη συχνότητα, αυξήστε τη μνήμη PHP.
• Σύμπτωμα: Το car.gr δεν μπορεί να διαβάσει το URL (403, proxy error, συγχρονισμός κολλημένος).
  Αιτία: Firewall, CDN ή bot protection μπλοκάρει το car.gr.
  Λύση: Επιτρέψτε την πρόσβαση στο /wp-content/uploads/obs-xml-export/cargr.xml και ελέγξτε το URL από εξωτερικό δίκτυο.
• Σύμπτωμα: Μάρκα ή μοντέλο οχήματος δεν αναγνωρίζονται σωστά.
  Αιτία: Το όνομα στο WooCommerce δεν ταιριάζει με τις λίστες car.gr του plugin, οπότε χρησιμοποιείται προεπιλεγμένο ID.
  Λύση: Γράψτε τη μάρκα και το μοντέλο ακριβώς όπως εμφανίζονται στις λίστες car.gr του plugin: η αντιστοίχιση γίνεται μόνο με το όνομα.