Οδηγός χρήσης WebARTing Address Autocomplete for WooCommerce

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

Το WebARTing Address Autocomplete for WooCommerce βοηθά τον πελάτη να συμπληρώσει πιο γρήγορα τα στοιχεία διεύθυνσης στο checkout.

Ο πελάτης μπορεί να γράψει αρχικά οδού, Τ.Κ., πόλη ή περιοχή, όπως:

• Σταδίου Αθήνα
• 18531
• Πειραιάς
• Κέρκυρα
• Ρόδος

Το πρόσθετο εμφανίζει προτάσεις και, όταν ο πελάτης επιλέξει μία, συμπληρώνει όσα στοιχεία μπορεί: οδό, Τ.Κ., πόλη και περιφέρεια.

2. Πού βρίσκεται στο WordPress admin

Το πρόσθετο έχει δικό του κεντρικό μενού στο WordPress, έξω από το WooCommerce.

WebARTing Address

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

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

4. Geoapify API Key

Το Geoapify χρησιμοποιείται για αναζήτηση πλήρων διευθύνσεων, κυρίως οδών, περιοχών και Τ.Κ.

Πώς προστίθεται το API Key

1. Ο διαχειριστής δημιουργεί λογαριασμό στο Geoapify.
2. Δημιουργεί ή ανοίγει ένα project στο Geoapify dashboard.
3. Αντιγράφει το API Key.
4. Πηγαίνει στο WordPress admin → WebARTing Address.
5. Επικολλά το key στο πεδίο Geoapify API Key.
6. Πατά Αποθήκευση ρυθμίσεων.

5. Τοπική βάση Τ.Κ. Ελλάδας

Η τοπική βάση βοηθά όταν η εξωτερική υπηρεσία δεν επιστρέφει πλήρη ή σωστά αποτελέσματα. Δεν βρίσκει πάντα οδούς, αλλά βοηθά με Τ.Κ., πόλη, περιοχή, περιφερειακή ενότητα και περιφέρεια.

Αυτόματη εισαγωγή GeoNames

1. Πήγαινε στο WebARTing Address.
2. Βρες την ενότητα Τοπική βάση Τ.Κ. / Περιοχών Ελλάδας.
3. Άφησε ενεργό το Καθαρισμός υπάρχουσας τοπικής βάσης πριν την εισαγωγή, ειδικά στην πρώτη εισαγωγή.
4. Πάτα Import GeoNames Greece postal codes.
5. Περίμενε να εμφανιστεί μήνυμα επιτυχίας.

6. Χειροκίνητο CSV import

Το CSV import είναι χρήσιμο αν υπάρχει δική μας λίστα περιοχών ή θέλουμε να διορθώσουμε/εμπλουτίσουμε συγκεκριμένες εγγραφές.

Μορφή CSV

postcode,city,area,regional_unit,region

Παράδειγμα

postcode,city,area,regional_unit,region
18531,Πειραιάς,Κέντρο Πειραιά,Πειραιάς,Αττική
18453,Νίκαια,Νίκαια,Πειραιάς,Αττική
49100,Κέρκυρα,Κέρκυρα,Κέρκυρα,Ιόνια Νησιά
85100,Ρόδος,Ρόδος,Δωδεκάνησα,Νότιο Αιγαίο

Βήματα εισαγωγής

1. Πήγαινε στο WebARTing Address.
2. Στην ενότητα τοπικής βάσης, επίλεξε το CSV αρχείο.
3. Αν θέλεις αντικατάσταση της υπάρχουσας βάσης, τσέκαρε το καθάρισμα βάσης.
4. Πάτα Εισαγωγή CSV.

7. Πώς λειτουργεί στο checkout

Στο checkout, ο πελάτης αρχίζει να γράφει σε πεδίο διεύθυνσης, Τ.Κ. ή πόλης. Μετά από λίγους χαρακτήρες εμφανίζεται λίστα προτάσεων.

Πεδία στα οποία εμφανίζεται

• Οδός / Διεύθυνση
• Ταχυδρομικός Κώδικας
• Πόλη

Τι συμπληρώνεται μετά την επιλογή

• Οδός, όπου υπάρχει
• Τ.Κ.
• Πόλη
• Περιφέρεια

8. Περιφέρεια / State

Το plugin προσπαθεί να αντιστοιχίσει την Περιφέρεια που επιστρέφει η υπηρεσία με τις επίσημες επιλογές του WooCommerce για Ελλάδα.

Προειδοποίηση Περιφέρειας

Αν το plugin δεν μπορέσει να επιλέξει με σιγουριά την Περιφέρεια, εμφανίζει μήνυμα:

Ελέγξτε την Περιφέρεια πριν συνεχίσετε.

Σε αυτή την περίπτωση ο πελάτης ή ο διαχειριστής πρέπει να επιλέξει χειροκίνητα τη σωστή Περιφέρεια.

9. Cache και απόδοση

Το plugin χρησιμοποιεί cache ώστε να μην κάνει την ίδια αναζήτηση ξανά και ξανά.

Τι αποθηκεύεται

• το κείμενο αναζήτησης
• τα αποτελέσματα από Geoapify
• τα αποτελέσματα από local fallback
• η τελική λίστα προτάσεων

Γιατί είναι σημαντικό

Με cache, οι επαναλαμβανόμενες αναζητήσεις είναι πιο γρήγορες και πιο ελαφριές για το checkout.

10. Προτεινόμενες δοκιμές

Μετά από εγκατάσταση ή αλλαγές στις ρυθμίσεις, κάνε δοκιμή στο πραγματικό checkout.

Σταδίου Αθήνα
18531
Πειραιάς
Κορυδαλλός
Κέρκυρα
Ζάκυνθος
Ρόδος
Ηράκλειο
Πάτρα
Καλαμάτα
Θεσσαλονίκη

Τι πρέπει να ελέγξεις

• Αν εμφανίζεται η λίστα προτάσεων.
• Αν μπορείς να πατήσεις πρόταση χωρίς να εξαφανίζεται αμέσως.
• Αν συμπληρώνεται ο Τ.Κ.
• Αν συμπληρώνεται η πόλη.
• Αν αλλάζει σωστά η Περιφέρεια.
• Αν εμφανίζεται προειδοποίηση όταν η Περιφέρεια δεν ταιριάζει.
• Αν το checkout συνεχίζει να υπολογίζει κανονικά μεταφορικά/σύνολα.

11. Συχνά προβλήματα και λύσεις

Δεν εμφανίζονται προτάσεις

• Έλεγξε ότι το plugin είναι ενεργό.
• Έλεγξε ότι έχει αποθηκευτεί το Geoapify API Key.
• Δοκίμασε με τουλάχιστον 3 χαρακτήρες.
• Καθάρισε cache/minify.

Η λίστα κρύβεται πίσω από το theme

Οι νεότερες εκδόσεις χρησιμοποιούν fixed dropdown με υψηλό z-index. Αν υπάρχει ακόμα θέμα, πιθανόν κάποιο theme ή checkout builder επιβάλλει δικό του layer/CSS.

Η λίστα εξαφανίζεται πριν πατηθεί

Αυτό συνήθως οφείλεται σε ανανέωση του WooCommerce checkout. Οι νεότερες εκδόσεις κρατούν το dropdown ανοιχτό αρκετά ώστε να μπορεί ο πελάτης να επιλέξει.

Δεν βρίσκει όλες τις οδούς

Φυσιολογικό για δωρεάν/OSM-based υπηρεσίες. Η local βάση βοηθά με Τ.Κ./πόλεις/περιοχές, όχι με όλες τις οδούς της Ελλάδας.

Δεν αλλάζει πάντα η Περιφέρεια

Το plugin έχει mapping για τις 13 ελληνικές Περιφέρειες. Αν δεν ταιριάξει με σιγουριά, εμφανίζει προειδοποίηση.

Το GeoNames import αποτυγχάνει

• Έλεγξε αν ο server έχει ενεργό ZipArchive/php-zip.
• Έλεγξε αν ο server επιτρέπει εξερχόμενες συνδέσεις.
• Δοκίμασε χειροκίνητο CSV import.

12. Τι να μην πειράζει ο απλός χρήστης

Σύντομη λίστα ελέγχου

1. Το plugin είναι ενεργό.
2. Υπάρχει Geoapify API Key.
3. Η χώρα είναι gr.
4. Η γλώσσα είναι el.
5. Έχει γίνει Import GeoNames Greece postal codes.
6. Η τοπική βάση Τ.Κ. έχει εγγραφές.
7. Το autocomplete εμφανίζεται στο checkout.
8. Η Περιφέρεια ελέγχεται σωστά ή εμφανίζεται προειδοποίηση.