Refuses WooCommerce orders that match rules you set on email address, phone, postcode, wording, country or network. Automatic rules build themselves from your order history, one payment method can be refused on its own while the rest stay open, an allow list always wins, and every decision is written to a log you can undo.

• Author: George Vasiliades - https://github.com/Poseidonas
• License: GPL-2.0-or-later
• Requires WordPress 6.7 or newer
• Requires PHP 8.0 or newer
• Requires WooCommerce 9.0 or newer, tested up to 11.0
• Compatible with High-Performance Order Storage and with the cart and checkout blocks
• Settings live in WooCommerce > Checkout Guard

Nothing is refused until you say so. On a fresh install the plugin runs in log-only mode, so you can watch what your rules would have done before a single sale is at risk.

What was measured before writing this

Measured on WooCommerce 11.0.1 with a stock store:

The last row is why this plugin resolves the address itself. On a site with no proxy in front of it, anybody can send X-Real-IP: 1.2.3.4 by hand and walk straight past a network rule, or put an innocent customer's address in that header and have them refused. Verified in the lab: with a forged header, this plugin kept using the real connection address while WooCommerce recorded the forged one on the order.

So the plugin ships with proxy headers off, and the settings page shows the connection address, whatever the headers claim, which one the rules use and which one WooCommerce writes on orders, side by side.

Modes

Log only is the default. Rules are evaluated, matches are written to the log, and nothing is refused. This is how you find out that a rule you were about to switch on would have cost you eleven real sales.

Refuse the order turns the same rules into refusals.

The message the customer sees is yours to write and never names the rule that matched, because that would tell a determined buyer exactly what to change.

Block lists

One entry per line. An empty list does nothing.

The billing address is always checked. When the shipping address differs, its country, postcode, street, city and name are checked as well.

The allow list

Checked before anything else. An email address or a network here is never refused, whatever the block lists and the automatic rules say. This exists so that one broad rule cannot cost you a good customer, and it is the reason automatic rules are safe to switch on.

Automatic rules from order history

Written as a sentence you can read: refuse a buyer with 3 orders within 30 days that ended as Cancelled or Failed, counted by email address or by network address.

The count comes from real orders through wc_get_orders(), so it works on High-Performance Order Storage and on the older storage alike. Only the statuses you tick count, and only orders inside the window.

Counting by network catches the buyer who returns with a fresh email address. Counting by email catches the buyer who returns from a different connection. Neither is right for every shop, which is why you choose.

Rules for one payment method

The same kinds of rule, applied to payment methods you pick rather than to the order. Cash on delivery is the usual case: a buyer who keeps refusing deliveries loses cash on delivery while card and bank transfer stay open, so you keep the sale instead of losing it.

Where the rule can be decided before the customer types anything, that is, by network or by country, the payment method is simply not offered. Where it depends on the email address, the order is refused with your message once the address is known.

The log

Every match, in both modes: when, the buyer, the address, which checkout and which payment method, the rule that matched, and whether the order was refused or only logged.

Each row with an email address carries Not right, allow this buyer, which adds that address to the allow list and removes the row in one step. That is the undo, and it is the reason log-only mode is worth running first.

The log keeps a number of entries you set, oldest dropping off the end. Since it holds customer email addresses and network addresses, it answers to the WordPress personal data eraser: erasing a person's data removes their rows.

Honest limits

• The plugin refuses orders. It does not detect fraud. A rule is only as good as what you put in it.
• A network rule is worth as much as the address behind it. Read the section on proxy headers above, and check the table on the settings page before writing one.
• Automatic rules read order history, so a shop with no history yet has nothing to go on.
• Blocking a country here refuses the order at checkout. If you never want to sell there at all, the WooCommerce setting for selling countries is the better tool, because it also stops the customer earlier.
• Wording rules match plain substrings. A short word matches a great deal, so keep them specific.
• Orders created in the admin or through the REST API are not checked. This guards the checkout a customer uses.

Filters

add_filter( 'icxcnika_guard_reasons', function ( array $reasons, array $order, string $gateway ): array {
    return $reasons;
}, 10, 3 );

add_filter( 'icxcnika_guard_settings', function ( array $settings ): array {
    return $settings;
} );

icxcnika_guard_reasons receives every reason a checkout matched, and is the last word before the plugin acts. Return an empty array to let the order through, or add your own reason to refuse it. icxcnika_guard_registry_payload receives the data sent to the installation registry.

Data stored

• Option icxcnika_guard_settings (the rules).
• Option icxcnika_guard_log (the log).
• Option icxcnika_guard_registry_key (random installation key of 48 characters, created only if installation reporting is active).
• Transient icxcnika_guard_release (cached GitHub release lookup, 12 hours).
• Cron event icxcnika_guard_registry_ping (weekly, only if installation reporting is active).

Nothing is written to the orders table and nothing of WooCommerce is changed.

Installation reporting

On activation, on deactivation and once a week the plugin sends a small JSON message to the author's installation registry: plugin slug, plugin version, home URL, site URL, WordPress version, WooCommerce version, PHP version, locale and whether the site is a multisite. Each report carries a random installation key generated locally on first use. No customer data, order data or log data is ever sent.

The reporting address is empty by default, which means nothing is sent at all. Add define( 'ICXCNIKA_REGISTRY_DISABLE', true ); to wp-config.php to turn the reporting off, or define( 'ICXCNIKA_REGISTRY_URL', '...' ); to point it elsewhere.

Updates

Updates are delivered from GitHub Releases through the Update URI header of WordPress. The Plugins screen shows View details and allows automatic updates to be enabled, exactly as for a plugin from the directory.

Uninstall

Deleting the plugin removes both options, the installation key, the cached release check and the scheduled report. Orders, customers and WooCommerce settings are left exactly as they were.

Checkout Guard Rules (Ελληνικά)

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

• Δημιουργός: George Vasiliades - https://github.com/Poseidonas
• Άδεια: GPL-2.0-or-later
• Απαιτεί WordPress 6.7 ή νεότερο
• Απαιτεί PHP 8.0 ή νεότερη
• Απαιτεί WooCommerce 9.0 ή νεότερο, δοκιμασμένο έως 11.0
• Συμβατό με το High-Performance Order Storage και με τα μπλοκ καλαθιού και ταμείου
• Οι ρυθμίσεις βρίσκονται στο WooCommerce > Checkout Guard

Τίποτα δεν απορρίπτεται μέχρι να το πείτε εσείς. Σε νέα εγκατάσταση το πρόσθετο τρέχει σε λειτουργία μόνο καταγραφής, ώστε να δείτε τι θα έκαναν οι κανόνες σας πριν κινδυνέψει έστω μία πώληση.

Τι μετρήθηκε πριν γραφτεί

Μετρήθηκε σε WooCommerce 11.0.1 με κατάστημα χωρίς παρεμβάσεις:

Η τελευταία γραμμή είναι ο λόγος που αυτό το πρόσθετο βρίσκει μόνο του τη διεύθυνση. Σε ιστότοπο χωρίς proxy μπροστά του, οποιοσδήποτε στέλνει X-Real-IP: 1.2.3.4 με το χέρι και προσπερνά κατευθείαν έναν κανόνα δικτύου, ή βάζει τη διεύθυνση ενός αθώου πελάτη σε εκείνη την κεφαλίδα και τον κάνει να απορριφθεί. Επαληθεύτηκε στο εργαστήριο: με πλαστή κεφαλίδα, το πρόσθετο συνέχισε να χρησιμοποιεί την πραγματική διεύθυνση σύνδεσης ενώ το WooCommerce κατέγραψε την πλαστή στην παραγγελία.

Γι' αυτό το πρόσθετο έρχεται με τις κεφαλίδες proxy απενεργοποιημένες, και η σελίδα ρυθμίσεων δείχνει δίπλα δίπλα τη διεύθυνση σύνδεσης, ό,τι ισχυρίζονται οι κεφαλίδες, ποια χρησιμοποιούν οι κανόνες και ποια γράφει το WooCommerce στις παραγγελίες.

Λειτουργίες

Μόνο καταγραφή είναι η προεπιλογή. Οι κανόνες αξιολογούνται, τα ταιριάσματα γράφονται στο ημερολόγιο, και τίποτα δεν απορρίπτεται. Έτσι ανακαλύπτετε ότι ένας κανόνας που ετοιμαζόσασταν να ενεργοποιήσετε θα σας είχε κοστίσει έντεκα πραγματικές πωλήσεις.

Απόρριψη της παραγγελίας μετατρέπει τους ίδιους κανόνες σε απορρίψεις.

Το μήνυμα που βλέπει ο πελάτης το γράφετε εσείς και δεν αναφέρει ποτέ τον κανόνα που ταίριαξε, γιατί έτσι θα λέγατε σε έναν αποφασισμένο αγοραστή ακριβώς τι να αλλάξει.

Λίστες αποκλεισμού

Μία καταχώριση ανά γραμμή. Μια κενή λίστα δεν κάνει τίποτα.

Η διεύθυνση χρέωσης ελέγχεται πάντα. Όταν η διεύθυνση αποστολής διαφέρει, ελέγχονται και η χώρα, ο ταχυδρομικός κώδικας, η οδός, η πόλη και το όνομά της.

Η λίστα επιτρεπτών

Ελέγχεται πριν από όλα. Μια διεύθυνση email ή ένα δίκτυο εδώ δεν απορρίπτεται ποτέ, ό,τι και να λένε οι λίστες αποκλεισμού και οι αυτόματοι κανόνες. Υπάρχει ώστε ένας ευρύς κανόνας να μη σας κοστίσει έναν καλό πελάτη, και είναι ο λόγος που οι αυτόματοι κανόνες μπορούν να ενεργοποιηθούν με ασφάλεια.

Αυτόματοι κανόνες από το ιστορικό παραγγελιών

Γράφονται σαν πρόταση που διαβάζεται: απόρριψη αγοραστή με 3 παραγγελίες μέσα σε 30 ημέρες που κατέληξαν σε Ακυρωμένη ή Αποτυχημένη, με μέτρηση κατά διεύθυνση email ή κατά διεύθυνση δικτύου.

Η μέτρηση προέρχεται από πραγματικές παραγγελίες μέσω του wc_get_orders(), οπότε λειτουργεί τόσο στο High-Performance Order Storage όσο και στην παλαιότερη αποθήκευση. Μετράνε μόνο οι καταστάσεις που επιλέγετε, και μόνο παραγγελίες μέσα στο παράθυρο.

Η μέτρηση κατά δίκτυο πιάνει τον αγοραστή που επιστρέφει με φρέσκο email. Η μέτρηση κατά email πιάνει τον αγοραστή που επιστρέφει από άλλη σύνδεση. Κανένα από τα δύο δεν είναι σωστό για κάθε κατάστημα, γι' αυτό επιλέγετε εσείς.

Κανόνες για μία μέθοδο πληρωμής

Οι ίδιοι τύποι κανόνων, εφαρμοσμένοι σε μεθόδους πληρωμής που επιλέγετε αντί για την παραγγελία. Η συνηθισμένη περίπτωση είναι η αντικαταβολή: ένας αγοραστής που αρνείται συνέχεια τις παραδόσεις χάνει την αντικαταβολή ενώ η κάρτα και η τραπεζική μεταφορά μένουν ανοιχτές, οπότε κρατάτε την πώληση αντί να τη χάνετε.

Όπου ο κανόνας μπορεί να κριθεί πριν πληκτρολογήσει οτιδήποτε ο πελάτης, δηλαδή κατά δίκτυο ή κατά χώρα, η μέθοδος πληρωμής απλώς δεν προσφέρεται. Όπου εξαρτάται από τη διεύθυνση email, η παραγγελία απορρίπτεται με το μήνυμά σας μόλις γίνει γνωστή η διεύθυνση.

Το ημερολόγιο

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

Κάθε γραμμή με διεύθυνση email φέρει το Λάθος, επίτρεψε αυτόν τον αγοραστή, που προσθέτει τη διεύθυνση στη λίστα επιτρεπτών και αφαιρεί τη γραμμή με μία κίνηση. Αυτή είναι η αναίρεση, και είναι ο λόγος που αξίζει να τρέξετε πρώτα τη λειτουργία μόνο καταγραφής.

Το ημερολόγιο κρατά όσες εγγραφές ορίζετε, με τις παλαιότερες να πέφτουν από το τέλος. Επειδή περιέχει διευθύνσεις email και δικτύου πελατών, απαντά στον διαγραφέα προσωπικών δεδομένων του WordPress: η διαγραφή των δεδομένων ενός προσώπου αφαιρεί τις γραμμές του.

Τίμιοι περιορισμοί

• Το πρόσθετο απορρίπτει παραγγελίες. Δεν εντοπίζει απάτη. Ένας κανόνας αξίζει όσο και αυτό που βάζετε μέσα του.
• Ένας κανόνας δικτύου αξίζει όσο και η διεύθυνση πίσω του. Διαβάστε την παραπάνω ενότητα για τις κεφαλίδες proxy, και ελέγξτε τον πίνακα στη σελίδα ρυθμίσεων πριν γράψετε έναν.
• Οι αυτόματοι κανόνες διαβάζουν ιστορικό παραγγελιών, οπότε ένα κατάστημα χωρίς ιστορικό ακόμα δεν έχει πάνω σε τι να στηριχθεί.
• Ο αποκλεισμός μιας χώρας εδώ απορρίπτει την παραγγελία στο ταμείο. Αν δεν θέλετε καθόλου να πουλάτε εκεί, η ρύθμιση χωρών πώλησης του WooCommerce είναι το καλύτερο εργαλείο, γιατί σταματά τον πελάτη νωρίτερα.
• Οι κανόνες διατύπωσης ταιριάζουν απλά υποσύνολα κειμένου. Μια μικρή λέξη ταιριάζει σε πάρα πολλά, οπότε κρατήστε τους συγκεκριμένους.
• Παραγγελίες που δημιουργούνται στη διαχείριση ή μέσω REST δεν ελέγχονται. Αυτό φυλάει το ταμείο που χρησιμοποιεί ο πελάτης.

Φίλτρα

add_filter( 'icxcnika_guard_reasons', function ( array $reasons, array $order, string $gateway ): array {
    return $reasons;
}, 10, 3 );

add_filter( 'icxcnika_guard_settings', function ( array $settings ): array {
    return $settings;
} );

Το icxcnika_guard_reasons δέχεται κάθε λόγο για τον οποίο ταίριαξε ένα ταμείο, και έχει τον τελευταίο λόγο πριν ενεργήσει το πρόσθετο. Επιστρέψτε κενό πίνακα για να περάσει η παραγγελία, ή προσθέστε δικό σας λόγο για να απορριφθεί. Το icxcnika_guard_registry_payload δέχεται τα δεδομένα που στέλνονται στο μητρώο εγκαταστάσεων.

Δεδομένα που αποθηκεύονται

• Option icxcnika_guard_settings (οι κανόνες).
• Option icxcnika_guard_log (το ημερολόγιο).
• Option icxcnika_guard_registry_key (τυχαίο κλειδί εγκατάστασης 48 χαρακτήρων, δημιουργείται μόνο αν είναι ενεργή η αναφορά εγκατάστασης).
• Transient icxcnika_guard_release (cache της αναζήτησης έκδοσης στο GitHub, 12 ώρες).
• Cron event icxcnika_guard_registry_ping (εβδομαδιαίο, μόνο αν είναι ενεργή η αναφορά εγκατάστασης).

Τίποτα δεν γράφεται στον πίνακα παραγγελιών και τίποτα του WooCommerce δεν αλλάζει.

Αναφορά εγκατάστασης

Κατά την ενεργοποίηση, την απενεργοποίηση και μία φορά την εβδομάδα το πρόσθετο στέλνει ένα μικρό μήνυμα JSON στο μητρώο εγκαταστάσεων του δημιουργού: slug και έκδοση του πρόσθετου, home URL, site URL, έκδοση WordPress, έκδοση WooCommerce, έκδοση PHP, γλώσσα και αν το site είναι multisite. Κάθε αναφορά συνοδεύεται από ένα τυχαίο κλειδί εγκατάστασης που δημιουργείται τοπικά την πρώτη φορά. Δεδομένα πελατών, παραγγελιών ή ημερολογίου δεν στέλνονται ποτέ.

Η διεύθυνση αναφοράς είναι κενή από προεπιλογή, που σημαίνει ότι δεν αποστέλλεται τίποτα. Προσθέστε define( 'ICXCNIKA_REGISTRY_DISABLE', true ); στο wp-config.php για να απενεργοποιήσετε την αναφορά, ή define( 'ICXCNIKA_REGISTRY_URL', '...' ); για να τη στείλετε αλλού.

Ενημερώσεις

Οι ενημερώσεις παραδίδονται από τα GitHub Releases μέσω της κεφαλίδας Update URI του WordPress. Η οθόνη Πρόσθετα δείχνει Προβολή λεπτομερειών και επιτρέπει την ενεργοποίηση αυτόματων ενημερώσεων, ακριβώς όπως για πρόσθετο του καταλόγου.

Απεγκατάσταση

Η διαγραφή του πρόσθετου αφαιρεί και τα δύο options, το κλειδί εγκατάστασης, τον αποθηκευμένο έλεγχο έκδοσης και το προγραμματισμένο ραντεβού. Παραγγελίες, πελάτες και ρυθμίσεις WooCommerce μένουν ακριβώς όπως ήταν.