# Επισκόπηση
WooCommerce Courier Center Voucher & Label
Με το πρόσθετο **WooCommerce Courier Center Voucher & Label** μπορείτε να δημιουργήστε Vouchers αυτόματα με 1 κλικ και να τα εκτυπώσετε σε PDF μέγεθος A4, A6 & flyer.
**Εύκολη επεξεργασία ΟΛΩΝ των στοιχείων** της διεύθυνσης αποστολής πριν την έκδοση του voucher.
Μπορείτε να ορίσετε αν θα αποστέλλεται αυτόματα στο email ο **αριθμός αποστολής** με την ολοκλήρωση της παραγγελίας.
**Αυτόματος έλεγχος** παράδοσης των δεμάτων με δυνατότητα ενημέρωσης στο email σας τα δέματα που παραδόθηκαν.
Διαχείριση όλων των απεσταλμένων δεμάτων σε εύχρηστη λίστα. (Εκτύπωση λίστας βάση ημερομηνίας)
Μαζική επανεκτύπωση για τα ήδη δημιουργημένα vouchers των επιλεγμένων παραγγελιών
Μαζική δημιουργία vouchers των επιλεγμένων παραγγελιών
**Δωρεάν και αυτόματες ενημερώσεις για πάντα**
# Βασικές δυνατότητες
**Αυτόματη δημιουργία Voucher με 1 κλικ (on fly)**
* Δημιουργία Voucher μέσα από την παραγγελία
* Δημιουργία Voucher από την λίστα των παραγγελιών
* Υποστήριξη όλων των υπηρεσιών όπως και στο πρόγραμμα που σας παρέχει η Courier Center
* Αυτόματη συμπλήρωση όλων των στοιχείων του πελάτη (όλα τα πεδία είναι επεξεργάσιμα)
* Αυτόματη συμπλήρωση αντικαταβολής και το συνολικό βάρος
* Εργαλείο μετατροπής χαρακτήρων σε ΚΕΦΑΛΑΙΑ
* Προστασία από τη δημιουργία πολλαπλών voucher σε περίπτωση λάθους
* Εύκολος και πλήρης έλεγχος των στοιχείων πριν την δημιουργία του voucher
**Ακύρωση / διαγραφή Voucher**
* Εύκολη διαγραφή του voucher με 1 κλικ (είτε απο την λίστα παραγγελίων είτε απο την λίστα των voucher)
**Ορισμός αυτόματων ενεργειών μετά απο την δημιουργία του voucher:**
* Δυνατότητα απευθείας δημιουργία του PDF (A4, A6 & flyer)
* Δυνατότητα επιλογή αλλαγής κατάστασης της παραγγελίας
* Εξαναγκαστική αποστολή email ολοκλήρωσης και επισύναψη του αρ. αποστολής με shortcode
**Αυτόματη αποστολή voucher στο email του πελάτη κατά την ολοκλήρωση της παραγγελίας**
* Δυνατότητα ενεργοποίησης / απενεργοποίησης λειτουργίας
* Προεπιλεγμένο μήνυμα αποστολής με δυνατότητα μορφοποίησης
* Επιλογή στην παραγγελία αν θα συμπεριληφθεί το μήνυμα με το tracking code
**Αυτόματος έλεγχος της παράδοσης των δεμάτων** (με WP cron)
* Αυτόματος έλεγχος παράδοσης όλων των ‘προς παράδοση voucher’
* Δυνατότητα ειδοποίησης μέσω email σε λίστα για τις νέες παραδόσεις
* Επιλέξτε κάθε πότε να εκτελείτε η αυτόματη εργασία
* **Χειροκίνητος έλεγχος παράδοσης μεμονωμένου voucher** με 1 κλικ (Προβολή ημερομηνία, ώρα παράδοσης και όνομα παραλήπτη)
**Έξτρα εργαλεία**
* Έλεγχος παράδοσης δέματος στην λίστα των παραγγελιών και στην λίστα των voucher
* Ιχνηλάτηση voucher στην λίστα των αποστολών
* Δυνατότητα επανεκτύπωσης ενος voucher σε άλλο μέγεθος (A4, A6 & flyer)
* Μαζική επιλογή παραγγελιών και επανεκτύπωση των vouchers σε 1 PDF
* Εκτύπωση λίστας voucher βαση ημερομηνίας
**Δημιουργία μεμονωμένου voucher αναξέρτητο από μια παραγγελία**
* Επεξεργασία επαφών απο την λίστα
* Αποθήκευση στοιχείων σε λίστα με την χρήση ενός κωδικού σας
* Γρήγορη φόρτωση στοιχείων με την χρήση κωδικού
**Λίστα ιστορικού vouchers**
* Καταγραφή του χρήστη που το δημιούργησε
* Προβολή στοιχείων του voucher
* Δυνατότητα διαγραφής των PDF των παραγγελιών για λόγους εξοικονόμησης αποθηκευτικού χώρου στον server σας
* Δυνατότητα ελέγχου παράδοσης δέματος και ιχνηλάτηση
**Άλλα**
* Τηρεί τα πλαίσια ασφαλείας του WordPress
* Σύγχρονος προγραμματισμός και αρχιτεκτονική του κώδικα
* **Αναβαθμίσεις και υποστήριξη του λογισμικού για πάντα**
* PHP 5.6. – 8.0
* AJAX λειτουργία. Οι λειτουργίες του Plugin είναι βασισμένες σε τεχνολογία AJAX ώστε να μην ανανεώνετε η σελίδα καθε φορά που εκτελείτε μια ενέργεια. Με αυτό τον τρόπο πετυχαίνουμε σημαντική εμπειρία χρήσης.
* Διαθέσιμα διάφορα apply\_filters μέσα στον κώδικα για την εύκολη και άμεση αλλαγή διαφόρων σημαντικών στοιχείων σύμφωνα με τις ανάγκες σας
# Εγκατάσταση
# Εγκατάσταση plugin
Επιλέξτε το φάκελο .zip που μόλις κατεβάσατε απο το CodeCanyon και πατήστε εγκατάσταση.
Πατήστε ενεργοποίηση προσθέτου
###
# Αυτόματες ενημερώσεις
## Δήλωση άδειας χρήσης
### Κατεβάστε το License key από το CodeCanyon
Ανοίξτε το αρχείο που μόλις κατέβηκε, αντιγράψτε τον κωδικό και επικολλήστε το στο πεδίο όπως παρακάτω
Μεταβείτε στις Ρυθμίσεις - > Ρυθμίσεις CCenter και επιλέξτε την ενότητα **Δήλωση άδειας χρήσης**
# Ρυθμίσεις
### Βασικές ρυθμίσεις
Οι ενότητα των ρυθμίσεων βρίσκεται μέσα στην κατηγορία Ρυθμίσεις/Settings -> Ρυθμίσεις Ccenter
Εαν δεν σας έχει στείλει η CCenter τους live κωδικούς σας μπορείτε να δοκιμάστε το Plugin Με τους παρακάτω test κωδικούς
**Χρήστης: CourierCenterAPITestUser**
**Κωδικός: CourierCenterAPITestUser**
**Κλειδί API: CourierCenterAPITestKey**
### Email κωδικού παρακολούθησης - Email tracking code
Ενεργοποιώντας αυτή την επιλογή μπορείτε να ορίσετε ένα μήνυμα ελεύθερου κειμένου που θα συμπεριλαμβάνεται στο email προς τον πελάτη όταν ολοκληρώνεται η παραγγελία. Δηλαδή στο completed email.
Μέσα στο μηνυμα θα πρέπει να εισάγεται το διαθέσιμο shortcode **`[iben_ccenter_tracking]`**το οποίο θα αντικαθίστατε με τον αριθμός αποστολής.
Σε κάθε παραγγελία υπάρχει διαθέσιμο checkbox το οποίο οταν είναι τσεκαρισμένο, τότε και μόνο τότε το μήνυμα θα συμπεριλαμβάνεται στο email της ολοκλήρωσης.
{% hint style="info" %}
Τεχνικά αγκυστρώνεται σε όλα τα do\_action('woocommerce\_email\_order\_details') και όταν το email id = customer\_completed\_order.
Διαθέσιμα filters
iben\_ccenter\_email\_send\_tracking\_email\_hook\_filter iben\_ccenter\_email\_send\_tracking\_emailid\_filter
{% endhint %}
### Αυτόματος έλεγχος παράδοσης
Ενεργοποιώντας αυτήν την επιλογή, το plugin θα ελέγχει τα μη παραδομένα voucher εαν έχουν παραδοθεί. Υπάρχει δυνατότητα να αλλάζει αυτόματα η κατάσταση της παραγγελίας όταν ελεχθεί ως παραδομένο
### Αυτόματη διαγραφή PDF των παραδομένων voucher
Σημαντική ρύθμιση όσο αφορά τη συντήρηση του διαθέσιμου χώρου στον server σας καθώς με αυτή την επιλογή, αυτόματα θα διαγράφονται τα "άχρηστα" αποθηκευμένα vouchers και άλλα πολυμέσα που θεωρητικά δεν υπάρχει λόγος πλέον να κρατούνται αφού έχει ολοκληρωθεί ο η διακινησή τους
Ενεργοποιώντας αυτήν την επιλογή, το plugin θα διαγράφει αυτόματα όλα τα PDF βάση των επιπλέον επιλογές που υπάρχουν ώστε να είστε ήσυχοι πως τα PDF δεν θα δεσμεύουν σημαντικό χώρο.
{% hint style="info" %}
Κάθε φορά που δημιουργείτε 1 voucher και παράγεται το PDF, αποθηκεύονται στον χώρο φιλοξενίας σας.
{% endhint %}
# Χρήσιμα filters
### Διαφορετικό Courier Center billing code για κάθε admin ID
Με αυτό τον τρόπο μπορείτε να αντιστοιχίσετε σε κάθε admin να εκδίδει vouchers με διαφορετικό billing code
```php
add_action('admin_init', 'iben_ccenter_add_custom_acccounts');
function iben_ccenter_add_custom_acccounts(){
// REQUIRE Courier Center V1.3.0 and above
if ( ! class_exists( 'Iben_Woo_Ccenter_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_ccenter_filter_display_multiaccount_message', '__return_true' );
//display account column in vouchers list
add_filter( 'iben_ccenter_filter_vouchers_display_account_column', '__return_true' );
$current_id = get_current_user_id();
// ADMIN ID
if ($current_id == 27){
// ΧΡΗΣΤΗΣ
add_filter( 'iben_ccenter_filter_main_settings_user_alias', function($default_value ) {
return 'xxxxxxxxxxxxx';
}, 10);
// ΚΩΔΙΚΟΣ
add_filter( 'iben_ccenter_filter_main_settings_credential_value', function($default_value ) {
return 'xxxxxxxxxxxxx';
}, 10);
// API KEY
add_filter( 'iben_ccenter_filter_main_settings_apikey', function($default_value ) {
return 'xxxxxxxxxxxxx';
}, 10);
//billing_code
add_filter( 'iben_ccenter_filter_main_settings_billtocode', function($default_value ) {
return '100-2345-xxxx';
}, 10);
}
}
```
### Εμφάνιση σύνολο αντικαταβολών στην λίστα των vouchers
```php
add_filter( 'iben_ccenter_filter_listvouchers_displaycod_all', '__return_true' );
add_filter( 'iben_ccenter_filter_listvouchers_displaycod_delivered', '__return_true' );
add_filter( 'iben_ccenter_filter_listvouchers_displaycod_undelivered', '__return_true' );
```
### Ορισμός διαφορετικού αποστολέα
Εαν θέλετε να αλλάξετε τα στοιχεία του αποστολέα στα vouchers
Απαιτείται έκδοση >= v2.2.0
```php
add_filter('iben_ccenter_filter_api_shipment_body', 'iben_ccenter_add_sender_to_shipment_body');
function iben_ccenter_add_sender_to_shipment_body($send_data) {
// Check if $send_data is an array and if not, initialize it
if (!is_array($send_data)) {
$send_data = [];
}
// Add the Sender information
$send_data["Shipper"] = [
"CompanyName" => 'test', //ΥΠΟΧΡΕΩΤΙΚΟ
"ContactName" =>'iben', //ΠΡΟΑΙΡΕΤΙΚΟ
"Address" => 'Address here', //ΥΠΟΧΡΕΩΤΙΚΟ
"City" => 'City here', //ΥΠΟΧΡΕΩΤΙΚΟ
"ZipCode" => '32100', //ΥΠΟΧΡΕΩΤΙΚΟ
"Phone1" => '21000000000', //ΠΡΟΑΙΡΕΤΙΚΟ
"Country" => 'GR' //ΥΠΟΧΡΕΩΤΙΚΟ
];
return $send_data;
}
```
### Εμφάνιση πολλαπλών υποκωδικών (billing code) στην έκδοση voucher
Με αυτή την προσθήκη θα μπορείτε να επιλέγετε με ποιό υποκωδικό θα δημιουργηθεί το voucher
Απαιτείται η έκδοση >= 2.3.0
```php
add_filter('iben_ccenter_filter_billtocode_order_metabox_enable_selections', '__return_true');
add_filter( 'iben_ccenter_order_metabox_billtocode_selections', 'iben_ccenter_order_metabox_billtocode_selections_function', 10, 1 );
function iben_ccenter_order_metabox_billtocode_selections_function( $default_options ) {
$dynamic_options = array(
'100-120-0004' => 'Αποθήκη 1',
'100-120-0005' => 'Αποθήκη 2'
);
$options = array_merge( $default_options, $dynamic_options );
return $options;
}
```
### Εμφάνιση πολλαπλών υποκωδικών (shipper code) στην έκδοση voucher
Απαιτείται η έκδοση >= 2.4.0
```php
add_filter('iben_ccenter_filter_billtocode_order_metabox', 'iben_ccenter_bill_tocode_def');
function iben_ccenter_bill_tocode_def(){
return '100-xxxx-xxx1';
}
add_filter('iben_ccenter_filter_shippercode_order_metabox_enable_selections', '__return_true');
add_filter( 'iben_ccenter_order_metabox_shippercode_selections', 'iben_ccenter_order_metabox_shippercode_selections_function', 10, 1 );
function iben_ccenter_order_metabox_shippercode_selections_function( $default_options ) {
$dynamic_options = array(
'100-xxxx-xxx1' => 'κεντρικό',
'100-xxxx-xxx2' => 'Θεσσαλονικη',
'100-xxxx-xxx2' => 'Αθηνα'
);
$options = array_merge( $default_options, $dynamic_options );
return $options;
}
```
### Εμφάνιση κωδικών SKU στa σχόλια του voucher
```php
//works for automatic actions too below line
add_filter('iben_ccenter_filter_combine_comments_metafield_order', 'iben_ccenter_display_products_in_comments', 10, 2 );
add_filter('iben_ccenter_filter_comments_order_metabox', 'iben_ccenter_display_products_in_comments', 10, 2 );
function iben_ccenter_display_products_in_comments($comments, $args){
$order = wc_get_order($args['order_id']);
if (!is_object($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_sku().($index == $count ? '' : ', ');
}
}
// Return only product SKUs
// return $export;
// Εμφάνιση σχόλια πελάτη + προιόντα
return $comments.' '.$export;
}
```
# Tracking numbers
Διαθέσιμοι shortcodes για τα template των email σας
prefix\_text και suffix\_text είναι προαιρετικά. **Το ΧΧΧΧ πρέπει να αντικατασταθεί** με το ID της παραγγελίας, συνήθως είναι {order\_id}
**Εμφανίζει το ιστορικό της ιχνηλάτησης σε λίστα.**
```
[iben_ccenter_tracing_shortcode order_id="ΧΧΧΧ"]
```
**Εμφανίζει τον αριθμό αποστολής (εαν έχει δημιουργηθεί voucher στην παραγγελία, αλλιώς εμφανίζει κενό).**
```
[iben_ccenter_tracking_number_shortcode order_id="ΧΧΧΧ" prefix_text = "Κείμενο πριν τα link" suffix_text = "Κείμενο μετά τα link" ]
```
**Εμφανίζει το όνομα της Κούριερ** (εαν έχει δημιουργηθεί voucher στην παραγγελία, αλλιώς εμφανίζει κενό) .\
Διαθέσιμο filter για την αλλαγή του ονόματος: iben\_ccenter\_courier\_name\_shortcode\_filter.
απαιτείται έκδοση >=1.2.0
```
[iben_ccenter_courier_name_shortcode order_id="ΧΧΧΧ" prefix_text = "Κείμενο πριν τα link" suffix_text = "Κείμενο μετά τα link" ]
```
### #1 Ενσωμάτωση μέσα στο email template
```
echo do_shortcode( '[iben_ccenter_courier_name_shortcode order_id = '.$order->get_id().' prefix_text = "
Παρακολούθηση δέματος
\n
Το δέμα σας απεστάλει με την κούριερ " suffix_text = "
" ]' );
}
add_action( 'woocommerce_email_order_details', 'iben_custom_ccenter_email_send_tracking_info_handler', 10, 4 );
```
#### ΑΠΟΤΕΛΕΣΜΑ για #1 και #2
### Παρακολούθηση δέματος
Το δέμα σας απεστάλει με την κούριερ Courier Center
Ο αριθμός αποστολής είναι: [1506201314](https://www.taxydromiki.com/track/1506201314)
