Με το πρόσθετο WooCommerce ACS Courier Voucher & Label μπορείτε να δημιουργήστε Vouchers **αυτόματα ή με 1 κλικ** και να τα εκτυπώσετε Α4 μέγεθος ή στο μέγεθος θερμικού εκτυπωτή.
**Εύκολη επεξεργασία ΟΛΩΝ των στοιχείων** της διεύθυνσης αποστολής πριν την έκδοση του voucher.
Μπορείτε να ορίσετε αν θα αποστέλλεται αυτόματα στο email ο **αριθμός αποστολής** με την ολοκλήρωση της παραγγελίας.
**Αυτόματος έλεγχος** παράδοσης των δεμάτων με δυνατότητα ενημέρωσης στο email σας τα δέματα που παραδόθηκαν.
Διαχείριση όλων των απεσταλμένων δεμάτων σε μορφή λίστας.
Μαζική επανεκτύπωση για τα ήδη δημιουργημένα vouchers των επιλεγμένων παραγγελιών ή και απο την λίστα των vouchers.
Μαζική δημιουργία και εκτύπωση vouchers των επιλεγμένων παραγγελιών.
**Δωρεάν και αυτόματες ενημερώσεις για πάντα**
# Βασικές δυνατότητες
**Αυτόματη δημιουργία Voucher ή με 1 κλικ (on fly)**
* Δημιουργία Voucher μέσα από την παραγγελία
* Δημιουργία Voucher από την λίστα των παραγγελιών
* Υποστήριξη όλων των υπηρεσιών που σας παρέχει η ACS στο δικό της πρόγραμμα
* Αυτόματη συμπλήρωση όλων των στοιχείων του πελάτη (όλα τα πεδία είναι εύκολα επεξεργάσιμα)
* Αυτόματη συμπλήρωση αντικαταβολής και το συνολικό βάρος
* Εργαλείο μετατροπής χαρακτήρων σε ΚΕΦΑΛΑΙΑ πριν την έκδοση του voucher
* Προστασία από τη δημιουργία πολλαπλών voucher σε περίπτωση λάθους
**Ακύρωση / διαγραφή Voucher**
* Εύκολη διαγραφή του voucher με 1 κλικ (είτε απο την λίστα παραγγελίων είτε απο την λίστα των voucher)
**Ορισμός αυτόματων ενεργειών μετά απο την δημιουργία του voucher:**
* Μπορείτε να ορίσετε αυτόματες ενέργειες για μετά το πάτημα της δημιουργίας του voucher
* Δυνατότητα επιλογή αλλαγής κατάστασης της παραγγελίας
* Εξαναγκαστική αποστολή email ολοκλήρωσης και επισύναψη του αρ. αποστολής με shortcode
* (ΝΕΟ) Αυτόματη αντιγραφή του κωδικού παρακολούθησης σε οποιοδήποτε πεδίο μέσα στην παραγγελία. (Θα πρέπει να ορίσετε στις ρυθμίσεις το μοναδικό αναγνωριστικό του πεδίου πχ. #tracking\_number)
**Αυτόματη αποστολή voucher στο email του πελάτη κατά την ολοκλήρωση της παραγγελίας**
* Δυνατότητα ενεργοποίησης / απενεργοποίησης λειτουργίας για κάθε παραγγελία
* Προεπιλεγμένο μήνυμα αποστολής με δυνατότητα μορφοποίησης απο τις ρυθμίσεις
* Επιλογή στην παραγγελία αν θα συμπεριληφθεί το μήνυμα με το tracking code
**Αυτόματος έλεγχος της παράδοσης των δεμάτων** (με WP cron)
* Αυτόματος έλεγχος παράδοσης όλων των ‘προς παράδοση voucher’
* Αυτόματη αλλαγή κατάστασης παραγγελίας για τα παραδομένα
* Δυνατότητα ειδοποίησης μέσω email σε λίστα για τις νέες παραδόσεις
* Επιλέξτε κάθε πότε να εκτελείτε η αυτόματη εργασία
* Χειροκίνητος έλεγχος παράδοσης μεμονωμένου voucher με 1 κλικ (Προβολή ημερομηνία, ώρα παράδοσης και όνομα παραλήπτη)
**Έξτρα εργαλεία**
* Έλεγχος παράδοσης δέματος στην λίστα των παραγγελιών και στην λίστα των voucher
* Ιχνηλάτηση voucher στην λίστα αλλά και μέσα στην παραγγελία
* Πληροφορίες του voucher από την λίστα των παραγγελιών αλλά και μέσα στην παραγγελία
* Μαζική δημιουργία vouchers και άμεση εκτύπωση
* Μαζική επανεκτύπωση vouchers
**Δημιουργία μεμονωμένου voucher αναξέρτητο από μια παραγγελία**
* Επεξεργασία επαφών απο την λίστα
* Αποθήκευση στοιχείων σε λίστα με την χρήση ενός κωδικού σας
* Γρήγορη φόρτωση στοιχείων με την χρήση κωδικού
**Λίστα ιστορικού vouchers**
* Καταγραφή του χρήστη που δημιούργησε το voucher
* Προβολή στοιχείων του voucher
* Δυνατότητα ελέγχου παράδοσης δέματος και ιχνηλάτησης με 1 κλικ
**Άλλα**
* Τηρεί τα πλαίσια ασφαλείας του WordPress
* Σύγχρονος προγραμματισμός και αρχιτεκτονική του κώδικα
* **Αναβαθμίσεις και υποστήριξη του λογισμικού για πάντα**
* PHP 5.6. – 8.0
* AJAX λειτουργία. Οι λειτουργίες του Plugin είναι βασισμένες σε τεχνολογία AJAX ώστε να μην ανανεώνετε η σελίδα καθε φορά που εκτελείτε μια ενέργεια. Με αυτό τον τρόπο πετυχαίνουμε σημαντική εμπειρία χρήσης.
* Διαθέσιμα διάφορα apply\_filters μέσα στον κώδικα για την εύκολη και άμεση αλλαγή διαφόρων σημαντικών στοιχείων σύμφωνα με τις ανάγκες σας
# Εγκατάσταση
# Εγκατάσταση plugin
Επιλέξτε το φάκελο .zip που μόλις κατεβάσατε απο το CodeCanyon και πατήστε εγκατάσταση.
Πατήστε ενεργοποίηση προσθέτου
###
# Αυτόματες ενημερώσεις
## Δήλωση άδειας χρήσης
### Κατεβάστε το License key από το CodeCanyon
Ανοίξτε το αρχείο που μόλις κατέβηκε, αντιγράψτε τον κωδικό και επικολλήστε το στο πεδίο όπως παρακάτω
Μεταβείτε στις Ρυθμίσεις - > Ρυθμίσεις ACS και επιλέξτε την ενότητα **Δήλωση άδειας χρήσης**
# Ρυθμίσεις
### Βασικές ρυθμίσεις
Οι ενότητα των ρυθμίσεων βρίσκεται μέσα στην κατηγορία Ρυθμίσεις/Settings -> Ρυθμίσεις ACS
Εαν δεν σας έχει στείλει η ACS τους live κωδικούς σας μπορείτε να δοκιμάστε το Plugin με τους παρακάτω test κωδικούς
Company ID: **demo**
Company Password: **demo**
User ID: **demo**
User Password: **demo**
Κωδικός χρέωσης: **2ΑΘ999999**
Ονομα αποστολέα: eshop(Οτι θέλετε)
Application Key: **ff3981a2ac67410e877c1d73e7d83006**
### Email κωδικού παρακολούθησης - Email tracking code
Ενεργοποιώντας αυτή την επιλογή μπορείτε να ορίσετε ένα μήνυμα ελεύθερου κειμένου που θα συμπεριλαμβάνεται στο email προς τον πελάτη όταν ολοκληρώνεται η παραγγελία. Δηλαδή στο completed email.
Μέσα στο μηνυμα θα πρέπει να εισάγεται το διαθέσιμο shortcode **`[iben_acs_tracking]`**το οποίο θα αντικαθίστατε με τον αριθμός αποστολής.
Σε κάθε παραγγελία υπάρχει διαθέσιμο checkbox το οποίο οταν είναι τσεκαρισμένο, τότε και μόνο τότε το μήνυμα θα συμπεριλαμβάνεται στο email της ολοκλήρωσης.
{% hint style="info" %}
Τεχνικά αγκυστρώνεται σε όλα τα do\_action('woocommerce\_email\_order\_details') και όταν το email id = customer\_completed\_order.
Διαθέσιμα filters
iben\_acs\_email\_send\_tracking\_email\_hook\_filter iben\_acs\_email\_send\_tracking\_emailid\_filter
{% endhint %}
### Αυτόματος έλεγχος παράδοσης
Ενεργοποιώντας αυτήν την επιλογή, το plugin θα ελέγχει τα μη παραδομένα voucher εαν έχουν παραδοθεί. Υπάρχει δυνατότητα να αλλάζει αυτόματα η κατάσταση της παραγγελίας όταν ελεχθεί ως παραδομένο
### Αυτόματη διαγραφή PDF
Σημαντική ρύθμιση όσο αφορά τη συντήρηση του διαθέσιμου χώρου στον server σας καθώς με αυτή την επιλογή, αυτόματα θα διαγράφονται τα "άχρηστα" αποθηκευμένα vouchers και άλλα πολυμέσα που θεωρητικά δεν υπάρχει λόγος πλέον να κρατούνται αφού έχει ολοκληρωθεί ο η διακινησή τους
Ενεργοποιώντας αυτήν την επιλογή, το plugin θα διαγράφει αυτόματα όλα τα PDF βάση των επιπλέον επιλογές που υπάρχουν ώστε να είστε ήσυχοι πως τα PDF δεν θα δεσμεύουν σημαντικό χώρο.
{% hint style="info" %}
Κάθε φορά που δημιουργείτε 1 voucher και παράγεται το PDF, αποθηκεύονται στον χώρο φιλοξενίας σας.
{% endhint %}
### Αυτόματη δημιουργία των vouchers
Με αυτή την επιλογή τα vouchers θα δημιουργούνται αυτόματα όταν μια νεα παραγγελία τοποθετείται στο καταστημά σας.
# Χρήσιμα filters
### Βάρος
Στο παρακάτω παράδειγμα ορίζουμε μέγιστο βάρος τα 2 κιλά εάν είναι πάνω απο 2, διαφορετικά θα πάρει το βάρος που έχει αυτόματα υπολογιστεί από τα προϊόντα
### Τηλέφωνο 2 ή κινητό σε custom πεδίο
Εαν έχετε custom πεδίο στο checkout, πχ Κινητό και meta name είναι \_billing\_mobile κανένα πρόβλημα.
Σε άλλη περίπτωση εαν το custom πεδίο σας έχει διαφορετικό meta name τότε θα πρέπει να τρέξετε το παρακάτω κώδικα στο αρχείο chilld functions.php και απλά αλλάξτε το όνομα **\_billing\_mobile** με το δικό σας meta όνομα.
Η κάτω παύλα ( \_ ) είναι απαραίτητη.
```php
function ben_acs_mycustomphonefield(){
return '_billing_mobile';
}
add_filter( 'iben_acs_filter_phone2_metafield_order_metabox', 'ben_acs_mycustomphonefield' );
```
### Άλλα filters
`iben_acs_filter_comments_order_metabox`
Για τα σχόλια / παρατηρήσεις του voucher
`iben_acs_filter_cashdelivery_order_metabox`
Για την αντικαταβολή του voucher
### Αναγνώριση 3rd party πληρωμή αντικαταβολής
Σε κάποιες περιπτώσεις που χρησιμοποιείται μέθοδο πληρωμής (αντικαταβολή) από κάποιο άλλο plugin ή custom. Σε αυτή την περίπτωση το plugin δεν γνωρίζει εαν είναι αντικαταβολή και να προστεθεί αυτόματα στο πεδίο.
**alg\_custom\_gateway\_1 =** Είναι το ID της μεθόδου πληρωμής
```php
add_filter('iben_acs_filter_cashdelivery_payments_order_metabox', 'iben_acs_cash_delivery_add_alg_custom1');
function iben_acs_cash_delivery_add_alg_custom1(){
return $payments = array('alg_custom_gateway_1');
}
```
### Προσθήκη αρ. παραγγελίας στο πεδιο σχόλια
Σε περίπτωση που θέλετε να εκτυπώνεται ο αρ. παραγγελίας μέσα στα σχόλια του voucher θα πρέπει να χρησιμοποιήσετε την παρακάτω function
```php
add_filter('iben_acs_filter_combine_comments_metafield_order', 'iben_acs_override_com_meta', 10, 2);
add_filter('iben_acs_filter_automatic_comments_metafield_order', 'iben_acs_override_com_meta', 10, 2);
add_filter('iben_acs_filter_comments_order_metabox', 'iben_acs_override_com_meta', 10, 2);
function iben_acs_override_com_meta($comment, $order_id){
$order = wc_get_order($order_id);
if ( !is_a( $order, 'WC_Order' ) ){ return; }
//GET ORDER COMMENTS
$comments = $order->get_customer_note();
$order_number = $order->get_order_number();
return 'Παραγγελία ID:'.$order_number.' '.$comments;
}
```
### Εμφάνιση προϊόντων στο σχόλια
```php
//works for automatic actions too
add_filter('iben_acs_filter_automatic_comments_metafield_order', 'iben_acs_display_products_in_comments', 10, 2 );
//works for bulk creation too
add_filter('iben_acs_filter_combine_comments_metafield_order', 'iben_acs_display_products_in_comments', 10, 2 );
add_filter('iben_acs_filter_comments_order_metabox', 'iben_acs_display_products_in_comments', 10, 2 );
function iben_acs_display_products_in_comments($comments, $order_id){
$order = wc_get_order($order_id);
if ( !is_a( $order, 'WC_Order' ) ){ return; }
$export = '';
if ($order->get_items()){
$count = count($order->get_items());
$index = 0;
foreach( $order->get_items() as $item_id => $product_item ){
$index++;
$product = $product_item->get_product();
$export .= $product->get_name().' x '.$product_item->get_quantity().($index == $count ? '': ', ');
}
}
// Εμφάνιση προιόντων μόνο
return $export;
// Εμφάνιση σχόλια πελάτη + προιόντα
// return $comments.' '.$export;
}
```
### Αλλαγή billing code ανάλογα το βάρος
```php
add_filter('iben_acs_filter_billingcode_order_metabox', 'iben_acs_filter_billing_code', 10, 2);
function iben_acs_filter_billing_code($billingcode, $order_id){
$order = wc_get_order($order_id);
if ( !is_a( $order, 'WC_Order' ) ){
return $billingcode;
}
foreach( $order->get_items() as $item_id => $product_item ){
$total_weight = 0;
foreach( $order->get_items() as $item_id => $product_item ){
$quantity = $product_item->get_quantity(); // get quantity
$product = $product_item->get_product(); // get the WC_Product object
if( $product ) {
$product_weight = $product->get_weight(); // get the product weight
$total_weight += floatval( ( $product_weight ? $product_weight : 0 ) * $quantity );
}
}
}
if ($total_weight < 3){
return 'billing code 1';
}else{
return 'billing code 2';
}
}
```
### Διαφορετικό ACS λογαριασμό για κάθε admin ID
```php
add_action('admin_init', 'iben_acs_custom_acccounts');
function iben_acs_custom_acccounts(){
// REQUIRE v1.6.0 and later
if ( ! class_exists( 'Iben_Woo_Acs_Admin_Woo' ) ) return;
if ( ! is_admin() ) return;
if ( !current_user_can( 'edit_shop_orders' ) ) return;
//display admin bar which account is assigned
add_filter( 'iben_acs_filter_display_multiaccount_message', '__return_true' );
//display in account column in vouchers list
add_filter( 'iben_acs_filter_vouchers_display_account_column', '__return_true' );
$current_id = get_current_user_id();
// ADMIN ID
if ($current_id == 1){
add_filter( 'iben_acs_main_company_id', function($default_value ) {
return 'xxxxx';
}, 10);
add_filter( 'iben_acs_main_company_password', function($default_value ) {
return 'xxxxxx';
}, 10);
add_filter( 'iben_acs_main_user_id', function($default_value ) {
return 'xxxxx';
}, 10
);
add_filter( 'iben_acs_main_user_password', function($default_value ) {
return '14411';
}, 10);
add_filter( 'iben_acs_main_apikey', function($default_value ) {
return 'e248xxxx3fca40af8ae8bb2cb6c4xxx';
}, 10);
add_filter( 'iben_acs_main_billing_code', function($default_value ) {
return 'xxxxxx';
}, 10);
// ADMIN ID
}elseif ($current_id == 2){
add_filter( 'iben_acs_main_company_id', function($default_value ) {
return 'demo';
}, 10);
add_filter( 'iben_acs_main_company_password', function($default_value ) {
return 'demo';
}, 10);
add_filter( 'iben_acs_main_user_id', function($default_value ) {
return 'demo';
}, 10
);
add_filter( 'iben_acs_main_user_password', function($default_value ) {
return 'demo';
}, 10);
add_filter( 'iben_acs_main_apikey', function($default_value ) {
return 'ff3981a2ac67410e877c1d73e7d83006';
}, 10);
add_filter( 'iben_acs_main_billing_code', function($default_value ) {
return '2ΑΘ999999';
}, 10);
}
}
```
### Αποστολή email καθε φορά που το δεμά παραδίδεται και έχει αντικαταβολή
```php
// requires iBen ACS v2.5.1 and above
add_action('iben_acs_check_delivery_hook_after_delivered', 'iben_custom_trigger_function_delivered', 10, 2);
function iben_custom_trigger_function_delivered($order_id, $id_record){
if ( !function_exists( 'iben_acs_get_Vouchers_from_id' ) ) return;
$data = iben_acs_get_Vouchers_from_id($id_record);
if (empty($data) && !is_object($data) ) return;
$voucher = $data->acs_main_voucher;
$data = maybe_unserialize($data->acs_voucher_info);
//if COD
if (!isset($data['Cod_Ammount'])) return;
$cash = str_replace(",",".", $data['Cod_Ammount']);
$cash = floatval(preg_replace('/\.(?=.*\.)/', '', $cash));
if ($cash > 0){
// SEND EMAIL HERE
$headers = array('Content-Type: text/html; charset=UTF-8');
$subject = esc_html__( 'Just delivered a COD shipment', 'iben-woo-ups' );
$body = '
ACS voucher: '.$voucher.' ('.$cash.')
';
wp_mail( 'info@ibenetos.com', $subject, $body, $headers );
}
}
```
### Εμφάνιση σύνολο αντικαταβολών στην λίστα των vouchers
```php
add_filter( 'iben_acs_filter_listvouchers_displaycod_all', '__return_true' );
add_filter( 'iben_acs_filter_listvouchers_displaycod_delivered', '__return_true' );
add_filter( 'iben_acs_filter_listvouchers_displaycod_undelivered', '__return_true' );
```
# Tracking numbers
Διαθέσιμοι shortcodes για τα template των email σας
prefix\_text και suffix\_text είναι προαιρετικά. **Το ΧΧΧΧ πρέπει να αντικατασταθεί** με το ID της παραγγελίας, συνήθως είναι {order\_id}
**Εμφανίζει το ιστορικό της ιχνηλάτησης σε λίστα.**
```
[iben_acs_tracing_shortcode order_id="ΧΧΧΧ"]
```
**Εμφανίζει τον αριθμό αποστολής (εαν έχει δημιουργηθεί voucher στην παραγγελία, αλλιώς εμφανίζει κενό).**
```
[iben_acs_tracking_number_shortcode order_id="ΧΧΧΧ" prefix_text = "Κείμενο πριν τα link" suffix_text = "Κείμενο μετά τα link" ]
```
**Εμφανίζει το όνομα της Κούριερ** (εαν έχει δημιουργηθεί voucher στην παραγγελία, αλλιώς εμφανίζει κενό) .\
Διαθέσιμο filter για την αλλαγή του ονόματος: iben\_acs\_courier\_name\_shortcode\_filter.
απαιτείται έκδοση >=2.5.0
```
[iben_acs_courier_name_shortcode order_id="ΧΧΧΧ" prefix_text = "Κείμενο πριν τα link" suffix_text = "Κείμενο μετά τα link" ]
```
### #1 Ενσωμάτωση μέσα στο email template
```
echo do_shortcode( '[iben_acs_courier_name_shortcode order_id = '.$order->get_id().' prefix_text = "
Παρακολούθηση δέματος
\n
Το δέμα σας απεστάλει με την κούριερ " suffix_text = "
" ]' );
}
add_action( 'woocommerce_email_order_details', 'iben_custom_acs_email_send_tracking_info_handler', 10, 4 );
```
#### ΑΠΟΤΕΛΕΣΜΑ για #1 και #2
### Παρακολούθηση δέματος
Το δέμα σας απεστάλει με την κούριερ ACS
Ο αριθμός αποστολής είναι: [1506201314](https://www.taxydromiki.com/track/1506201314)
.png?alt=media&token=5abea815-01c2-435d-b9ba-837aed407ca1)
.png?alt=media&token=6170d98a-2d88-44b3-8aa2-138ad5632325)
