WooCommerce
WordPress Plugin Οδηγίες χρήσης
Απαιτήσεις για σωστή εγκατάσταση του πρόσθετου
- To WooCommerce πρέπει να είναι εγκατεστημένο και ενεργό πριν εγκαταστήσετε το πρόσθετο BOX NOW Delivery.
- Απαιτείται PHP έκδοση 8 ή νεότερη.
- Απαιτείται η έκδοση WordPress 6.2 ή νεότερη.
BOX NOW Delivery Ρυθμίσεις μενού διαχειριστή
Τμήμα your API details
- Στο input με όνομα ‘Your API URL‘, εισάγετε τη διεύθυνση URL που σας έχει δώσει η BOX NOW. Αφαιρεί αυτόματα το πρόθεμα ‘https://’ και ‘http://’ γιατί δεν χρειάζεται.
- Στο input με όνομα ‘Your Client ID', εισάγετε το Client ID που σας έχει δώσει η BOX NOW.
- Στο input με όνομα ‘Your Client Secret*, εισάγετε το Client Secret που η BOX NOW σας έχει δώσει
- Στο input με όνομα ‘Warehouse IDs*, εισάγετε το Warehouse ID που η BOX NOW σας έχει δώσει. Εάν θέλετε να προσθέσετε πολλές αποθήκες, διαιρέστε τα αναγνωριστικά με κόμμα για παράδειγμα: 8,2.
- Στο input με όνομα ‘Your Partner ID", μέσα εκεί εισάγετε το ID συνεργάτη που σας έχει δώσει η BOX NOW.
Τμήμα Button Customization
- Στο input με όνομα ‘Change button color", εισάγετε τον έγχρωμο κωδικό HEX που θέλετε για το Κουμπί στη σελίδα ολοκλήρωσης αγοράς που ανοίγει τον αναδυόμενο χάρτη. Εάν δεν το αλλάξετε, παίρνει από προεπιλογή το χρώμα «84C33F.
- Στο input με όνομα ‘Change button text', εκεί εισάγετε το κείμενο που θέλετε να εμφανιστεί για το κουμπί στη σελίδα ολοκλήρωσης αγοράς για τον αναδυόμενο χάρτη. Εάν δεν το αλλάξετε, το προεπιλεγμένο κείμενο είναι: Pick a locker.
Τμήμα Map customization
Εάν επιλέξετε το πρώτο κουμπί επιλογής με το όνομα ‘Popup modal window", θα εμφανιστεί ένα κουμπί στη σελίδα ολοκλήρωσης αγοράς και όταν κάνετε κλικ, θα ανοίξει ένα παράθυρο με τον χάρτη και τα ντουλάπια.
Εάν επιλέξετε το δεύτερο κουμπί επιλογής με το όνομα "Embedded iFrame”, θα ενσωματώσει τον χάρτη αυτόματα στη σελίδα ολοκλήρωσης αγοράς.
Τμήμα GPS tracking location toggle
Εάν επιλέξετε το πρώτο κουμπί επιλογής με το όνομα ‘GPS ΟΝ*, ο χάρτης θα εμφανίσει αυτόματα τα πλησιέστερα ντουλάπια στον χάρτη που είναι διαθέσιμα με βάση την τοποθεσία σας την τρέχουσα στιγμή.
Εάν επιλέξετε το δεύτερο κουμπί επιλογής με το όνομα "GPS OFF', ο χάρτης θα εμφανίσει τα ντουλάπια κοντά σας σύμφωνα με τον Ταχυδρομικό Κώδικα/ΤΚ που έχετε δηλώσει στη διεύθυνση της παραγγελίας.
Τμήμα Choose voucher option
Όταν επιλέξετε το κουμπί επιλογής με το όνομα ‘Send voucher via email" θα εμφανιστεί ένα νέο input από κάτω με το όνομα ‘Please insert your email here:". Μέσα σε αυτό το input, μπορείτε να προσθέσετε το email που θέλετε για να σταλεί το voucher pdf.
Πρέπει να αλλάξετε την κατάσταση της παραγγελίας σε ολοκληρωμένη και να ενημερώσετε την παραγγελία από την ενότητα Ενέργειες παραγγελίας προκειμένου το κουπόνι να σταλεί στο email που έχετε δώσει. Δείτε τις παρακάτω εικόνες παραδειγμάτων.
Εάν κάνετε αυτές τις ενέργειες, θα λάβετε ένα email στο email που έχετε παράσχει με το voucher pdf. Παράδειγμα του email που θα λάβετε.
Εάν θέλετε να ακυρώσετε την παραγγελία, μπορείτε να επιλέξετε από το μενού Κατάσταση μέσα στην παραγγελία το "BOX NOW Cancel Order" και στη συνέχεια να ενημερώσετε την παραγγελία. Αυτή η ενέργεια στέλνει ένα αίτημα για ακύρωση της παραγγελίας στο CMS μας. Δείτε τις παρακάτω εικόνες παραδειγμάτων.
To ‘BOX NOW Cancel Order" λειτουργεί για την ακύρωση της παραγγελίας μόνο όταν έχετε επιλέξει το κουμπί επιλογής ‘Send voucher via email*.
Όταν επιλέγετε το κουμπί επιλογής με το όνομα ‘Display a button in WooCommerce admin order page for printing the vouchers',αυτή η ενέργεια θα εμφανίσει τρία κουμπιά με τα ονόματα ‘Create Vouchers (Small)·, ‘Create Vouchers (Medium)', ‘Create Vouchers (Large)' και ένα πεδίο εισαγωγής στη σελίδα της παραγγελίας για την εκτύπωση των κουπονιών στο πρόγραμμα περιήγησής σας αυτή η ενέργεια θα παρακάμψει τη λειτουργία αποστολής email.
Στην παρακάτω εικόνα παραδείγματος έχουμε δημιουργήσει 2 vouchers κάνοντας κλικ στο κουμπί με όνομα ‘Create Vouchers (Small)'. Βάλαμε τον αριθμό 2 στο πεδίο εισαγωγής και κάναμε κλικ στο κουμπί ‘Create Vouchers (Small)'.
Δημιούργησε δύο πράσινα κουμπιά με τον αριθμό του voucher, οι οποίοι είναι σύνδεσμοι που σας μεταφέρουν στη σελίδα εκτύπωσης του κουπονιού pdf και δύο κόκκινα κουμπιά με το όνομα ‘Cancel Voucher" που ακυρώνουν το σχετικό voucher δίπλα τους και στέλνουν επίσης αίτημα για ακύρωση αυτού του voucher στο CMS μας.
Συμβουλή: Αυτή η ενέργεια θα στείλει 2 αιτήματα στο CMS μας με 2 παραγγελίες που έχουν μεγέθη διαμερισμάτων ‘Small· επειδή επιλέγουμε να δημιουργήσουμε τα vouchers μας κάνοντας κλικ στο κουμπί ‘Create Vouchers (Small)'. Αν θέλετε να δημιουργήσετε μια παραγγελία μεσαίου μεγέθους διαμερίσματος (medium), πρέπει να κάνετε κλικ στο κουμπί ‘Create Vouchers (Medium)" και για Μεγάλο (Large) στο κουμπί ‘Create Vouchers (Large)' αντίστοιχα.
Αφού δημιουργήσετε τα vouchers που θέλετε, τα τρία κουμπιά "Create Vouchers' δεν θα είναι πλέον διαθέσιμα, θα πρέπει να ακυρώσετε όλα τα vouchers για να γίνουν ξανά διαθέσιμα.
Συμβουλή: Δεν μπορείτε να δημιουργήσετε περισσότερα vouchers από τον αριθμό Max Vouchers που υποδεικνύεται με κόκκινο χρώμα, θα εμφανιστεί μήνυμα σφάλματος.
Εάν κάνετε κλικ στα πράσινα κουμπιά με τον αριθμό του κουπονιού, θα ανοίξει μια νέα καρτέλα με το κουπόνι pdf που μπορείτε να εκτυπώσετε. Δείτε το παράδειγμα της εικόνας παρακάτω.
Τμήμα Message shown when locker is not selected
Σε αυτήν την ενότητα, μπορείτε να προσθέσετε το προσαρμοσμένο μήνυμα που θέλετε να εμφανίζεται στη σελίδα ολοκλήρωσης αγοράς όταν δεν έχει επιλεγεί ένα ντουλάπι και κάποιος προσπαθεί να ολοκληρώσει την παραγγελία Εάν δεν προσθέσετε ένα προσαρμοσμένο μήνυμα θα έχει το προεπιλεγμένο μήνυμα ‘Please select a locker first!'.
Αφού κάνετε μια αλλαγή ή κάνετε μια διαφορετική επιλογή στο μενού ρυθμίσεων BOX NOW, αποθηκεύατε πάντα τις αλλαγές σας! Απλώς κάντε κλικ σε αυτό το κουμπί παρακάτω και είστε έτοιμοι να ξεκινήσετε!
BOX NOW Delivery ρυθμίσεις για το WooCommerce
Στη σελίδα ‘Settings' του WooCommerce επιλέξτε την καρτέλα ‘Shipping’ και από εκεί προσθέστε μια "Shipping zone’ όπως φαίνεται στα βήματα των παρακάτω εικόνων.
Από εκεί μπορείτε να προσθέσετε τη ζώνη που θέλετε, έχουμε προσθέσει τη ζώνη ‘Ελλάδα’ σε αυτό το παράδειγμα και από το κουμπί "Add shipping method’ προσθέσαμε τον τρόπο αποστολής BOX NOW και Free shipping. Δείτε το παράδειγμα της εικόνας παρακάτω.
Από εκεί επίσης μπορούμε να κάνουμε επεξεργασία στις ρυθμίσεις από τη μέθοδο αποστολής BOX NOW, απλώς κάντε κλικ στο κουμπί "Edit" κάτω από τη μέθοδο αποστολής. Δείτε το παράδειγμα της εικόνας παρακάτω.
Αυτή είναι η σελίδα ρυθμίσεων για τη μέθοδο αποστολής BOX NOW όπως βλέπουμε στην εικόνα παρακάτω. Μην ξεχνάτε να αποθηκεύετε πάντα τις αλλαγές σας μετά από μια αλλαγή.
Επισκόπηση σελίδας ρυθμίσεων BOX NOW Delivery
- Στην ενότητα ‘Enable/Disable" όταν επιλεχθεί, η μέθοδος αποστολής BOX NOW γίνεται διαθέσιμη στο ταμείο, εάν δεν είναι επιλεγμένη, δεν είναι διαθέσιμη.
- Η εισαγωγή ‘Title Method" αλλάζει τον τίτλο για τη μέθοδο αποστολής, το προεπιλεγμένο όνομα είναι "Box Now*.
- Η εισαγωγή ‘Cost’ προσθέτει το επιθυμητό κόστος για τη συγκεκριμένη μέθοδο αποστολής.
- Στο input με όνομα ‘Free Delivery Threshold" μπορείτε να προσθέσετε τη συνολική αξία της παραγγελίας που θέλετε όταν αυτή υπερβαίνει να είναι δωρεάν χωρίς κόστος. Εάν μείνει κενό, δεν θα έχει κανένα όριο δωρεάν παράδοσης. Για παράδειγμα, εάν έχετε ‘Cost" 2€ και το ‘Free Delivery Threshold" είναι 60€, εάν το σύνολο της παραγγελίας οας είναι πάνω από 60€ τότε το ‘Cost' θα είναι 0€.
- Το αναπτυσσόμενο μενού ‘Taxable’ έχει δύο επιλογές για να επιλέξετε ‘Yes' και ‘No*, εάν επιλέξετε ‘Yes', τότε θα εφαρμόσει φόρους στην παραγγελία σας ανάλογα με τη χώρα στην οποία βρίσκεστε και τους φορολογικούς συντελεστές που έχετε. Εάν επιλέξετε ‘No‘, δεν θα επιβληθούν φόροι στην παραγγελία
- To input με όνομα 'Max Weight" πρέπει πάντα να έχει την τιμή 20, επειδή τα μέγιστα κιλά του ντουλαπιού μας είναι 20 κιλά. Εάν βάλετε έναν αριθμό μεγαλύτερο από 20, τότε η μέθοδος παράδοσης BOX NOW δεν θα λειτουργήσει σύμφωνα με τα πρότυπα.
- Όταν κάνετε εγκατάσταση το plugin θα πρέπει να μεταβείτε σε αυτές τις ρυθμίσεις και να βάλετε τον αριθμό 20 σε αυτό το input και να σώσετε τις αλλαγές. Είναι απαραίτητο για τη σωστή χρήση του πρόσθετου.
- Στην ενότητα "Max Package Dimensions" η είσοδος με το όνομα ‘Max Length (cm)‘ πρέπει πάντα να είναι 60, το ‘Max Width (cm)‘ πρέπει πάντα να είναι 45 και το ‘Max Height (cm)" να είναι πάντα 36, γιατί αυτές είναι οι μέγιστες διαστάσεις των ντουλαπιών μας. Εάν προσθέσετε έναν αριθμό μεγαλύτερο ή μικρότερο από αυτούς που παρουσιάζονται εδώ. το BOX NOW Delivery δεν θα λειτουργήσει όπως αναμένεται.
- Όταν κάνετε εγκατάσταση το plugin θα πρέπει να μεταβείτε σε αυτές τις ρυθμίσεις και να βάλετε στα inputs τους αριθμούς 60. 45 και 36 όπως φαίνονται ακριβώς στην εικόνα της απισκόπησης των ρυθμίσεων και να σώσετε τις αλλαγές. Είναι απαραίτητο για τη σωστή χρήση του πρόσθετου.
- Στην ενότητα με όνομα ‘Cash on delivery custom description settings’, μπορείτε να κάνετε κλικ στην επιλογή με το όνομα ‘Enable Custom Description for COD", εάν την ενεργοποιήσετε θα πρέπει επίσης να γράψετε την προσαρμοσμένη περιγραφή που θέλετε και να αποθηκεύσετε τις αλλαγές. Αυτή η ενέργεια θα αποθηκεύσει μια προσαρμοσμένη περιγραφή για τον ‘BOX NOW PAY ON THE GO!‘ τρόπο πληρωμής που μπορείτε να δείτε στη σελίδα ολοκλήρωσης αγοράς. Αντικαθιστά τον προεπιλεγμένο τρόπο πληρωμής με αντικαταβολή "COD" από το WooCommerce. Δείτε τις παρακάτω εικόνες παραδειγμάτων για καλύτερη κατανόηση.
Μην ξεχνάτε να αποθηκεύετε πάντα τις αλλαγές σας για να εμφανίζονται στη σελίδα ολοκλήρωσης αγοράς!
Χρήσιμοι σύνδεσμοι
- Αν θέλετε περισσότερες πληροφορίες για το widget μας, μπορείτε να το βρείτε εδώ: https://widget-v5.boxnow.gr/devs
- Μπορείτε να ελέγξετε την ιστοσελίδα μας εδώ για περισσότερες χρήσιμες πληροφορίες: https://boxnow.gr/
- Αν θέλετε να επικοινωνήσετε μαζί μας μπορείτε να στείλετε το email σας εδώ: [email protected]
Σε περίπτωση ερωτήσεων αναφορικά με τις λύσεις και τον τρόπο υλοποίησης του προσθέτου μας, παρακαλώ απευθυνθείτε στην διεύθυνση ηλεκτρονικού ταχυδρομείου: [email protected]
Συχνές ερωτήσεις
Παρακαλώ ελέγξτε το error που σας βγάζει στην δημιουργία του voucher (P401, P402 κ.λπ)
Και κάντε την αντίστοιχη διόρθωση.
• P400 - Invalid request data. Make sure are sending the request according to this documentation.
• P401 - Invalid request origin location reference. Make sure you are referencing a valid location ID from Origins endpoint or valid address
• P402 - Invalid request destination location reference. Make sure you are referencing a valid location ID from Destinations endpoint or valid address.
• P405 - Invalid phone number. Make sure you are sending the phone number in full international format, e.g. +30 xx x xxx xxxx.
• C404 - Invalid phone number. Make sure you are sending the phone number in full international format, e.g. +30 xx x xxx xxxx.
• P406 - Invalid compartment/parcel size. Make sure you are sending one of required sizes 1, 2 or 3. Size is required when sending from AnyAPM directly.
• P409 - Invalid delivery partner reference. Make sure you are referencing a valid delivery partner ID from Delivery partners endpoint.
• P410 - Order number conflict. You are trying to create a delivery request for order ID that has already been created. Choose another order id.
• P411 - You are not eligible to use Cash-on-delivery payment type. Use another payment type or contact our support.
• P415 - You are not allowed to create delivery to home address. Contact support if you believe this is a mistake.
• P416 - You are not allowed to use COD payment for delivery to home address. Contact support if you believe this is a mistake.
• P420 - Parcel not ready for cancel. You can cancel only new, undelivered, or parcels that are not returned or lost. Make sure parcel is in transit and try again.
• P421 - Invalid parcel weight. Make sure you are sending value between 0 and 10^6.
• P424 - Invalid region format. Please ensure the format includes a language code followed by a country code in ISO 3166-1 alpha-2 format, separated by a hyphen, e.g. el-GR, or region exists in context.
Κατεβάστε
το plugin τοπικά και ανεβάστε το χειροκίνητα (όχι από το marketplace)
Εφόσον πάλι δεν λειτουργήσει επικοινωνήστε με το τεχνικό τμήμα της boxnow.
Κατεβάστε
το plugin τοπικά και ανεβάστε το χειροκίνητα (όχι από το marketplace)
Εφόσον πάλι δεν λειτουργήσει επικοινωνήστε με το τεχνικό τμήμα της boxnow.
To πρόσθετο ενδέχεται να μην είναι συμβατό με το plugin που έχετε για την αντικαταβολή γι’αυτό ειναι απαραίτητη η δοκιμαστική παραγγελία με αντικαταβολή (BOX NOW Pay on the go) πριν την ενεργοποίηση της υπηρεσίας.
Θα χρειαστεί να επικοινωνήσετε με το τεχνικό τμήμα της BOX NOW για να επιβεβαιώσετε ότι έχετε το αντίστοιχο permission και να κάνετε δοκιμαστική παραγγελία με αντικαταβολή(ΒΟΧ ΝΟW Pay on the go)
Εφόσον έχετε τα προιόντα σας σε ογκομετρημένα σε γραμμάρια θα χρειαστεί να αλλάξετε το maximum weight από τiς ρυθμίσεις τoy boxnow-delivery-service μέσα στο εκάστοτε region.
Αλλες πιθανές αιτίες ειναι :
Free shipping ( εφόσον δεν έχει εξαιρεθεί η BOX NOW)
Conflicts με outdated plugins .
Εφόσον δεν είναι τιποτα παραπάνω θα χρειαστεί να επικοινωνήσετε με το τεχνικό τμήμα της BoxNow
Το plugin δεν είναι συμβατό με τα woocommerce blocks. Για να κάνετε revert στο κλασσικό checkout θα βρείτε οδηγίες στο παρακάτω link . (link) https://woocommerce.com/document/woocommerce-store-editing/customizing-cart-and-checkout/#:~:text=Reverting%20to%20the%20classic%20Cart%20and%20Checkout&text=localIf%20using%20a%20non%2Dblock,the%20Cart%20or%20Checkout%20block.&text=Choose%20%E2%80%9CClassic%20Shortcode%E2%80%9D.,a%20Classic%20Shortcode%20placeholder%20block.
Παρακαλώ δοκιμάστε να κάνετε την δοκιμαστική παραγγελία με το Locker Λεωφόρος Πεντέλης 125 ,15234 Locker_id : 4
Εφόσον έχετε έκδοση του plugin >2.1.2 θα χρειαστεί να συμπληρώσετε email και τηλέφωνο στα αντίστοιχα πεδία στης ρυθμίσεις του plugin και oi επιστροφες θα δρομολογούνται στο Locker στο οποίο στείλατε το δέμα .
Μπορείτε να εξαιρέσετε προιόντα βάση των ογκομετρικών , αρκεί μία διάσταση να είναι μεγαλύτερη από τις επιτρεπόμενες μέσα στις ρυθμίσεις του boxnow delivery service.
Δεν δίνεται η δυνατότητα εξαίρεσης κατηγοριών προϊόντων.