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:

FilterPodatakZadano polje
minimaxsync_company_nameNaziv tvrtkecompany
minimaxsync_company_addressAdresacompany_address
minimaxsync_company_postal_codePoštanski brojcompany_postal_code
minimaxsync_company_cityGradcompany_city
minimaxsync_company_countryDrž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