1. Τι κάνει το πρόσθετο

Το πρόσθετο δημιουργεί ένα αρχείο XML με τα προϊόντα του WooCommerce, ώστε να μπορεί να το διαβάζει το Skroutz ή άλλο marketplace. Το XML περιλαμβάνει πληροφορίες όπως τίτλο προϊόντος, τιμή, εικόνα, κατασκευαστή, SKU, EAN, διαθεσιμότητα, ποσότητα, κατηγορία και περιγραφή.

Βασικές δυνατότητες

• Χειροκίνητη δημιουργία XML με μπάρα προόδου.
• Αυτόματη δημιουργία μέσω WP-Cron.
• Επιλογή ονόματος και φακέλου αρχείου XML.
• Υποστήριξη GZIP όταν το αρχείο είναι μεγάλο.
• Ρύθμιση πεδίων όπως ID, manufacturer, MPN, EAN και availability.
• Εξαιρέσεις προϊόντων ανά κατηγορία, ετικέτα, brand ή χαρακτηριστικό.
• Ορατότητα ανά προϊόν στη λίστα προϊόντων, στην επεξεργασία και στην ταχυεπεξεργασία.
• Προσαρμοσμένα XML πεδία για ειδικές απαιτήσεις marketplace.
• Έλεγχος προϊόντων και αναφορά προβλημάτων.

2. Πρώτη ρύθμιση

Μετά την εγκατάσταση και ενεργοποίηση του plugin, εμφανίζεται στο WordPress admin νέο μενού:

WebARTing Skroutz XML

1. Μπείτε στο WebARTing Skroutz XML → Ρυθμίσεις XML.
2. Ελέγξτε ότι το feed είναι ενεργό.
3. Ρυθμίστε τον φάκελο και το όνομα του αρχείου XML.
4. Ρυθμίστε από πού θα διαβάζεται ο κατασκευαστής.
5. Ρυθμίστε από πού θα διαβάζονται MPN και EAN.
6. Ρυθμίστε τη διαθεσιμότητα.
7. Αποθηκεύστε τις ρυθμίσεις.
8. Πατήστε Χτίσιμο XML τώρα.
9. Ανοίξτε το URL του XML και ελέγξτε το αποτέλεσμα.

3. Dashboard

Η αρχική σελίδα του πρόσθετου δείχνει τη συνολική κατάσταση του XML feed.

Κουμπιά ενεργειών

• Χτίσιμο XML τώρα: ξεκινά τη δημιουργία του XML.
• Έλεγχος προϊόντων: ελέγχει τα προϊόντα για ελλείψεις ή πιθανά προβλήματα.
• Ρυθμίσεις: ανοίγει τη σελίδα ρυθμίσεων.

4. Βασικές ρυθμίσεις XML

Ενεργό feed

Αν είναι ενεργό, το πρόσθετο μπορεί να δημιουργεί XML. Αν είναι ανενεργό, δεν θα παράγεται νέο feed.

Αυτόματο χτίσιμο

Όταν είναι ενεργό, το WordPress θα προσπαθεί να ανανεώνει το XML αυτόματα μέσω WP-Cron. Για μικρά και μεσαία eshop είναι αρκετό. Για πολύ μεγάλα eshop, ίσως χρειαστεί server cron.

Φάκελος εξαγωγής

Ορίζει πού θα αποθηκεύεται το XML μέσα στον φάκελο uploads του WordPress.

webarting-feeds

Το τελικό URL θα μοιάζει με:

https://example.gr/wp-content/uploads/webarting-feeds/skroutz.xml

Όνομα αρχείου XML

Ορίζει το όνομα του αρχείου.

skroutz.xml

Συμπίεση

Batch size

Ορίζει πόσα προϊόντα επεξεργάζεται το plugin σε κάθε βήμα. Αν το κατάστημα είναι μεγάλο ή ο server αδύναμος, βάλτε μικρότερη τιμή.

5. Ρύθμιση ID προϊόντος

Το πεδίο <id> είναι πολύ σημαντικό. Πρέπει να είναι μοναδικό και σταθερό. Αν αλλάζει συνέχεια, το marketplace μπορεί να θεωρεί ότι πρόκειται για νέο προϊόν.

Διαθέσιμες επιλογές ID

Πρόθεμα ID

Αν χρησιμοποιείτε WooCommerce ID και θέλετε πρόθεμα, μπορείτε να βάλετε:

product-

Τότε το XML θα εμφανίσει:

<id>product-977</id>

6. Mappings πεδίων

Τα mappings λένε στο plugin από πού θα πάρει κάθε σημαντική πληροφορία.

Manufacturer / Κατασκευαστής

Ο κατασκευαστής μπορεί να διαβαστεί από taxonomy, attribute ή custom field.

MPN

Το MPN είναι ο κωδικός κατασκευαστή. Σε πολλά ελληνικά eshop χρησιμοποιείται το SKU ως MPN, αλλά αυτό δεν είναι πάντα σωστό. Αν υπάρχει πραγματικός κωδικός κατασκευαστή, προτιμήστε τον.

EAN / Barcode

Το EAN συνήθως βρίσκεται σε custom field από άλλο plugin ή από ERP import.

Συνηθισμένα meta keys:

_ean
_barcode
_global_unique_id
_wpm_gtin_code
_alg_ean
_ts_gtin

7. Category και Category Path

Το plugin υποστηρίζει δύο σχετικά πεδία:

<category>Σεσουάρ</category>
<category_path>Μικρό συσκευές &gt; Συσκευές προσωπικής φροντίδας &gt; Σεσουάρ</category_path>

Τι σημαίνει το category

Το <category> είναι η τελική κατηγορία του προϊόντος. Δηλαδή το τελευταίο κομμάτι του category path.

Τι σημαίνει το category_path

Το <category_path> είναι η πλήρης διαδρομή της κατηγορίας.

Παράδειγμα:

Μικρό συσκευές > Συσκευές προσωπικής φροντίδας > Σεσουάρ

Το plugin στο XML το γράφει με ασφαλή XML μορφή:

Μικρό συσκευές > Συσκευές προσωπικής φροντίδας > Σεσουάρ

Category mapping

Αν θέλετε να αλλάξετε το path που βγαίνει στο XML, χρησιμοποιήστε το mapping κατηγοριών.

Μορφή:

woo-category-slug | Marketplace Category Path

Παράδειγμα:

sesouar | Μικρό συσκευές > Συσκευές προσωπικής φροντίδας > Σεσουάρ
set-kouzinas | Λευκές συσκευές > Εντοιχιζόμενες συσκευές > Σετ κουζίνες-φούρνοι

Πώς βγαίνει το category από το category_path

Αν το path είναι:

Μικρό συσκευές > Συσκευές προσωπικής φροντίδας > Σεσουάρ

τότε το plugin βγάζει:

<category>Σεσουάρ</category>

8. Διαθεσιμότητα

Η διαθεσιμότητα μπορεί να βγαίνει με δύο τρόπους.

Παράδειγμα ρυθμίσεων

Ποσότητα

Αν το προϊόν έχει διαχείριση αποθέματος, το plugin παίρνει την πραγματική ποσότητα. Αν δεν έχει διαχείριση αποθέματος, χρησιμοποιεί τη default ποσότητα που ορίσατε.

9. Εξαιρέσεις προϊόντων

Οι εξαιρέσεις καθορίζουν ποια προϊόντα δεν θα μπουν στο XML.

Αυτόματες παραλείψεις

Εξαιρέσεις ανά ομάδα

Μπορείτε να εξαιρέσετε προϊόντα με βάση:

• Κατηγορίες WooCommerce.
• Ετικέτες προϊόντων.
• Brand.
• Attribute και συγκεκριμένες τιμές attribute.

Παράδειγμα εξαίρεσης με attribute

Αν έχετε attribute pa_marketplace και τιμή no-skroutz, μπορείτε να εξαιρέσετε όσα προϊόντα έχουν αυτή την τιμή.

Attribute taxonomy: pa_marketplace
Attribute values: no-skroutz

10. Προσαρμοσμένα XML πεδία

Η ενότητα αυτή χρησιμοποιείται όταν θέλετε να προσθέσετε επιπλέον πεδία στο XML, πέρα από τα βασικά.

Μορφή γραμμής

xml_tag | source | key

Διαθέσιμες πηγές

Εικόνα από βιβλιοθήκη WordPress

Για να βάλετε εικόνα από τα Πολυμέσα, χρησιμοποιήστε:

energy_label | attachment_image | 123

Το 123 είναι το ID της εικόνας στη βιβλιοθήκη WordPress.

Πώς βρίσκω το ID εικόνας;

1. Πηγαίνετε στο WordPress admin → Πολυμέσα.
2. Ανοίξτε την εικόνα.
3. Στο URL θα δείτε κάτι σαν post=123.
4. Το 123 είναι το ID της εικόνας.

Σωστό και λάθος XML tag

Το πρώτο πεδίο πρέπει να είναι αγγλικό/λατινικό XML tag χωρίς κενά.

11. Ορατότητα προϊόντων στο Skroutz

Κάθε προϊόν μπορεί να είναι ορατό ή κρυφό από το XML.

Από τη λίστα προϊόντων

Στη λίστα προϊόντων του WooCommerce εμφανίζεται στήλη Skroutz.

Με κλικ στην ένδειξη μπορείτε να αλλάξετε άμεσα την κατάσταση.

Από την επεξεργασία προϊόντος

Στη σελίδα επεξεργασίας προϊόντος υπάρχει επιλογή:

Εμφάνιση στο Skroutz XML

Από την ταχυεπεξεργασία

Στην ταχυεπεξεργασία μπορείτε να ορίσετε αν το προϊόν είναι ορατό ή εκτός XML χωρίς να ανοίξετε ολόκληρο το προϊόν.

Μαζικές ενέργειες

Από τη λίστα προϊόντων μπορείτε να επιλέξετε πολλά προϊόντα και να εκτελέσετε:

• Ενεργοποίηση στο Skroutz XML.
• Απενεργοποίηση από Skroutz XML.

12. Χτίσιμο XML

Το κουμπί Χτίσιμο XML τώρα ξεκινά τη δημιουργία του XML.

Τι εμφανίζει η μπάρα προόδου

• Ποσοστό ολοκλήρωσης.
• Πόσα προϊόντα ελέγχθηκαν.
• Πόσα προϊόντα μπήκαν στο XML.
• Πόσα προϊόντα παραλείφθηκαν.
• Τελικό link για το XML και το GZIP.

Τι γίνεται τεχνικά

Το plugin χτίζει πρώτα προσωρινό αρχείο και στο τέλος αντικαθιστά το τελικό XML. Έτσι, αν η διαδικασία διακοπεί, δεν χαλάει το προηγούμενο σωστό feed.

Αν κολλήσει το build

1. Μειώστε το batch size.
2. Ελέγξτε αν υπάρχει fatal error στο WordPress debug log.
3. Ελέγξτε αν ο server έχει χαμηλό memory limit.
4. Καθαρίστε το lock από το dashboard, αν υπάρχει σχετική επιλογή.

13. Έλεγχος feed

Ο έλεγχος προϊόντων βοηθά να βρείτε γιατί κάποια προϊόντα δεν μπαίνουν στο XML ή γιατί μπορεί να έχουν ελλιπή δεδομένα.

Συνηθισμένα προβλήματα

14. Logs

Τα logs δείχνουν τι έγινε στο τελευταίο export.

Πληροφορίες που εμφανίζονται

• Πότε έγινε το export.
• Αν έγινε από cron ή χειροκίνητα.
• Πόσα προϊόντα μπήκαν στο XML.
• Πόσα προϊόντα παραλείφθηκαν.
• Για ποιους λόγους παραλείφθηκαν.
• Πόσο χρόνο πήρε η διαδικασία.
• Μέγεθος XML.
• Αν δημιουργήθηκε GZIP.

Παράδειγμα log

status: success
source: manual
included: 9068
skipped: 269
xml_size: 21 MB
gzip_created: yes

skipped_reasons:
- Χωρίς εικόνα: 103
- Χωρίς κατασκευαστή: 23
- Χωρίς τιμή: 143

Αυτό σημαίνει ότι το XML δημιουργήθηκε, αλλά 269 προϊόντα κόπηκαν λόγω ελλείψεων.

15. Έτοιμα παραδείγματα

Παράδειγμα προϊόντος στο XML

<product>
  <id>977</id>
  <name>Imetec Belissima P3 3400 My Pro</name>
  <link>https://example.gr/product/imetec-belissima-p3-3400-my-pro/</link>
  <image>https://example.gr/wp-content/uploads/2025/05/U.jpg</image>
  <price_with_vat>79.90</price_with_vat>
  <category>Σεσουάρ</category>
  <category_path>Μικρό συσκευές &gt; Συσκευές προσωπικής φροντίδας &gt; Σεσουάρ</category_path>
  <manufacturer>Imetec</manufacturer>
  <mpn>203280</mpn>
  <ean>5201234567890</ean>
  <sku>203280</sku>
  <availability>Διαθέσιμο από 4-10 ημέρες</availability>
  <quantity>0</quantity>
  <description>Περιγραφή προϊόντος...</description>
</product>

Προσαρμοσμένα πεδία για ηλεκτρικές συσκευές

energy_class | attribute | pa_energy_class
power_watt | attribute | pa_power
color | attribute | pa_color
warranty | attribute | pa_warranty
supplier_code | meta | _supplier_code
warehouse_code | meta | _warehouse_code
gtin | meta | _global_unique_id
extra_image_1 | gallery_image | 1
extra_image_2 | gallery_image | 2
energy_label | attachment_image | 123

Προσαρμοσμένα πεδία για ρούχα/παπούτσια

color | attribute | pa_color
size | attribute | pa_size
gender | attribute | pa_gender
material | attribute | pa_material
season | attribute | pa_season
brand_name | taxonomy | product_brand
barcode | ean |
extra_image_1 | gallery_image | 1
extra_image_2 | gallery_image | 2

Σταθερά πεδία

currency | static | EUR
country | static | GR
vat_status | static | included
marketplace | static | skroutz

16. Συχνά προβλήματα

Το XML δεν δημιουργείται

• Ελέγξτε ότι το WooCommerce είναι ενεργό.
• Ελέγξτε ότι ο φάκελος uploads έχει δικαιώματα εγγραφής.
• Μειώστε το batch size.
• Ελέγξτε το WordPress debug log για fatal errors.

Λείπουν πολλά προϊόντα από το XML

• Δείτε το log για τους λόγους παράλειψης.
• Ελέγξτε αν έχετε ενεργή παράλειψη χωρίς εικόνα, τιμή ή κατασκευαστή.
• Ελέγξτε αν έχουν εξαιρεθεί κατηγορίες, ετικέτες ή brands.
• Ελέγξτε αν τα προϊόντα είναι απενεργοποιημένα από τη στήλη Skroutz.

Δεν εμφανίζεται ο κατασκευαστής

• Αν το brand είναι taxonomy, βάλτε σωστό taxonomy, π.χ. product_brand.
• Αν το brand είναι attribute, βάλτε σωστό attribute, π.χ. pa_brand.
• Αν είναι custom field, βάλτε το σωστό meta key.

Δεν εμφανίζεται το EAN

• Ελέγξτε ποιο plugin αποθηκεύει το barcode.
• Δοκιμάστε συνηθισμένα meta keys όπως _ean, _barcode, _global_unique_id.
• Αν το barcode είναι attribute, επιλέξτε attribute και βάλτε π.χ. pa_ean.

Το category path είναι λάθος

• Ελέγξτε την κατηγορία του προϊόντος στο WooCommerce.
• Ελέγξτε αν υπάρχει custom category mapping.
• Βεβαιωθείτε ότι το τελικό κομμάτι του path είναι η σωστή τελική κατηγορία.

Το AJAX build αποτυγχάνει

• Κάντε hard refresh στο admin.
• Ελέγξτε αν κάποιο security plugin μπλοκάρει το admin-ajax.php.
• Μειώστε το batch size.
• Ελέγξτε για PHP fatal errors.

17. Checklist πριν δοθεί το XML στο Skroutz