Code snippets
Plugin nudi WordPress filtere kojima developer može prilagoditi podatke koji se šalju u Minimax. Ovdje su najčešći primjeri. Kod dodajte u functions.php child teme ili pomoću dodatka za code snippete.
Prije početka
Snippete neka dodaje osoba koja zna PHP. Pogreška u functions.php može srušiti stranicu. Nakon promjene ručno sinkronizirajte jednu testnu narudžbu i provjerite račun u Minimaxu.
Sve narudžbe na kupca „Kupac“, osim R1 računa
Filter minimax_sync_data poziva se neposredno prije slanja narudžbe u Minimax. Prima sve pripremljene podatke i vraća ih, eventualno izmijenjene:
apply_filters( 'minimax_sync_data', $syncData, $orderData, $syncPaymentOptions );
Primjer ispod sve narudžbe fizičkih osoba šalje u Minimax pod generičkim kupcem „Kupac“:
- ime kupca zamjenjuje s „Kupac“,
- adresu, poštanski broj i grad postavlja na „/“,
- narudžbe s OIB-om (
$syncData['minimax']['customerVAT']) ne mijenja, pa tvrtke i dalje dobivaju R1 račun sa svojim podacima.
add_filter('minimax_sync_data','replace_customer_data',10,3);
function replace_customer_data($syncData,$orderData,$syncPaymentOptions){
if(empty($syncData['minimax']['customerVAT'])){
$syncData['order']['AddresseeName'] = 'Kupac';
$syncData['order']['AddresseeAddress'] = '/';
$syncData['order']['AddresseePostalCode'] = '/';
$syncData['order']['AddresseeCity'] = '/';
}
return $syncData;
}
OIB tvrtke
Plugin OIB traži u ovim poljima narudžbe, redom: vat_number, billing_vat_number, billing_vat, billing_eu_vat_number, OIB tvrtke (i u istim poljima s podvlakom ispred, npr. _billing_vat). Ako vaša trgovina OIB sprema drugdje, imate dvije mogućnosti.
Drugo meta polje – minimaxsync_vat_number
Filter vraća naziv meta polja, ne sam OIB. Plugin tada čita samo to polje.
add_filter( 'minimaxsync_vat_number', function () {
return '_billing_oib'; // meta ključ u kojem vaša trgovina sprema OIB
} );
Vlastita logika – minimax_customer_vat_id
Filter prima OIB koji je plugin pronašao (ili false) i narudžbu, a vraća OIB koji će se koristiti.
add_filter( 'minimax_customer_vat_id', function ( $vatNumber, $order ) {
if ( empty( $vatNumber ) ) {
$vatNumber = $order->get_meta( '_moj_oib' );
}
return $vatNumber ? preg_replace( '/^HR/i', '', trim( $vatNumber ) ) : false;
}, 10, 2 );
Koristite jedan od dva filtera
Ako je dodan minimaxsync_vat_number, plugin vraća vrijednost tog polja odmah i minimax_customer_vat_id se ne poziva.
Naziv i adresa tvrtke
Naziv tvrtke plugin čita iz polja Tvrtka u adresi za naplatu (ili iz meta polja Ime tvrtke). Ako je naziv tvrtke popunjen, kupac se na računu vodi kao tvrtka. Kao i kod OIB-a, ovi filteri vraćaju naziv meta polja iz kojeg se podatak čita:
| Filter | Podatak | Zadano polje |
|---|---|---|
minimaxsync_company_name | Naziv tvrtke | company |
minimaxsync_company_address | Adresa | company_address |
minimaxsync_company_postal_code | Poštanski broj | company_postal_code |
minimaxsync_company_city | Grad | company_city |
minimaxsync_company_country | Država (ISO kod, npr. HR) | company_country |
add_filter( 'minimaxsync_company_name', function () {
return '_billing_naziv_tvrtke';
} );
add_filter( 'minimaxsync_company_address', function () {
return '_billing_adresa_tvrtke';
} );
Dodajte samo filtere za polja koja vaša trgovina zaista sprema na drugom mjestu. Za polja bez filtera plugin koristi podatke iz adrese za naplatu.
Preskakanje besplatnih narudžbi
Narudžbe s iznosom 0,00 € (npr. poklon ili 100 % kupon) plugin inače šalje u Minimax. Ako ih ne želite, uključite filter minimax_skip_free_orders:
add_filter( 'minimax_skip_free_orders', '__return_true' );
Takva narudžba ostaje nesinkronizirana uz napomenu „Order value is 0 and you used the filter to skip free orders.“ To nije greška i ne šalje se obavijest o neuspjehu.
Broj decimala
Iznosi na stavkama računa zaokružuju se na broj decimala spremljen u postavkama plugina: 6 za trgovine koje su plugin instalirale od verzije 2.0.0, a 2 za trgovine koje su ga koristile i prije. Postotci (PDV, popust) uvijek imaju 2 decimale. Filter minimax_round_decimals prima zadani broj i vraća onaj koji želite:
add_filter( 'minimax_round_decimals', function ( $decimals ) {
return 2;
} );
Novi artikl u Minimaxu
Kada artikl kreirate iz WooCommercea (gumb „Create this product in minimax“ ili skupno), podatke artikla prije slanja možete izmijeniti filterom minimax_create_item_data. Drugi parametar je true kod skupnog kreiranja.
add_filter( 'minimax_create_item_data', function ( $itemData, $isBulk ) {
// Primjer: svi novi artikli dobivaju jedinicu mjere "kom"
if ( empty( $itemData['UnitOfMeasurement'] ) ) {
$itemData['UnitOfMeasurement'] = 'kom';
}
return $itemData;
}, 10, 2 );
Cijene s PDV-om
Plugin iz postavki WooCommercea (WooCommerce → Postavke → Porez → Cijene unesene s porezom) zaključuje sadrže li cijene PDV. To utječe na preuzimanje cijena iz Minimaxa i na kreiranje artikala. Ako vaša trgovina cijene računa drugačije nego što ta postavka kaže, to možete promijeniti filterom minimax_sync_prices_include_tax:
add_filter( 'minimax_sync_prices_include_tax', '__return_true' ); // cijene sadrže PDV
// ili
add_filter( 'minimax_sync_prices_include_tax', '__return_false' ); // cijene su bez PDV-a

