🔑 Aktivacija
Upravlja aktivacijom licence potrebne za povezivanje s Pricelist Serverom.
Unos podataka o licenci omogućuje sve funkcije dodatka.

Glavna polja:
• License ID → jedinstveni identifikacijski kod licence.
• License Expiration → datum isteka licence.

Nakon unosa podataka, pritisnite Save za dovršetak aktivacije. Otvorit će se prozor Sync za sinkronizaciju.

🔄 Sinkronizacija
Omogućuje sinkronizaciju sadržaja kataloga s Pricelist Servera na WordPress stranicu.
Tijekom sinkronizacije ažuriraju se artikli, cjenici, opisi i slike.

Dostupne funkcije:
• Ručno pokretanje sinkronizacije.
• Prikaz statusa napretka.

💡 Savjet: redovito izvršavajte sinkronizaciju ili nakon svakog ažuriranja kataloga.

🧰 Develop
Omogućuje postavljanje zadane jezika i provođenje testova bez utjecaja na produkcijsko okruženje.

Glavna polja:
• Default Language → referentni jezik za razvoj na temelju dostupnih jezika kataloga.

⚙️ Postavljanje
Upravlja općim postavkama dodatka i objavljenog kataloga.

Dostupne opcije:
• Stranica uvjeta prodaje → poveznica na informativnu stranicu web mjesta.
• Jedinica mjere → osnovna jedinica za proizvode (npr. cm, mm, komad).
• Simbol valute → opcija UKLJUČENO/ISKLJUČENO koja određuje hoće li se prikazivati simbol valute postavljen u cjeniku Pricelist Servera.
• UKLJUČENO → simbol valute prikazuje se uz cijene na web mjestu.
• ISKLJUČENO → cijene se prikazuju bez simbola valute.
• Jezik za sigurnosnu kopiju → rezervni jezik ako prijevod nije dostupan.
• Regeneracija jedinstvenih ID-ova → funkcija za ponovno stvaranje identifikatora blokova.

💡 Savjet: držite opciju Simbol valute aktivnom samo ako su online cjenici namijenjeni jednoj referentnoj valuti.

📱 Aplikacija
Definira postavke integracije s namjenskom aplikacijom Pricelist ili s mobilnim dijelom web stranice.
Omogućuje navođenje odredišne stranice i osnovnih parametara povezivanja.

• Odredišna stranica → stranica prikazana pri otvaranju chatbota.

📝 Napomena
Aktivirajte funkcionalnost brzog izračuna ponude na web stranici.
Korisnici mogu odabrati artikle, konfiguracije ili završne obrade izravno s cjenika i dobiti procijenjeni ukupni iznos u stvarnom vremenu.

Glavne funkcije:
• Aktivacija dinamičkog izračuna cijena.
• Upravljanje opcijama prilagodbe (npr. boja, završna obrada, količina).
• Prikaz sažetka ponude.
Generirane ponude automatski se bilježe u odjeljku Pricelist Note na Pricelist Serveru.

Operativni savjeti
• Provjerite ispravnu aktivaciju licence prije pokretanja sinkronizacije.
• Postavite razvojno okruženje odvojeno od produkcijskog.
• Redovito ažurirajte podatke putem odjeljka Sync.
• Koristite Vault samo s sigurnim i zaštićenim vjerodajnicama.
• Povremeno provjeravajte konfigurirane korisnike u WP-User kako biste održali dosljednost između WordPressa i Pricelist Servera.

Blok Price-list Description omogućuje prikaz opisa artikala unutar stranica WordPress stranice koji su prisutni u cjeniku povezanom s Pricelist Serverom. To je jedan od osnovnih blokova za izgradnju strukture online cjenika i omogućuje automatsko dohvaćanje informacija o proizvodima, kao što su opisi, zaglavlja i tehnički podaci, putem šifre artikla ili tekstualne pretrage.

🔹 ID
Odjeljak ID sadrži sve glavne parametre konfiguracije bloka.
• ID: To je jedinstveni kod koji se automatski dodjeljuje bloku. Služi za identifikaciju unutar stranice i ne može se ručno mijenjati.
• Tag: Određuje vrstu HTML elementa koji će sadržavati tekst (na primjer, paragraf, naslov 1, naslov 2, span, itd.). Omogućuje definiranje hijerarhije i semantičkog stila sadržaja.
• Font Style: Omogućuje odabir stila teksta među dostupnim opcijama (Normal ili Bold).
• Price-list Code: To je polje koje povezuje blok s artiklom iz cjenika. Kod se ne može ručno unijeti, već se mora odabrati putem pretraživanja (ikona povećala 🔍). Moguće je pretraživati putem teksta (na primjer, dio opisa) ili putem neutralnog koda.
• Mode: Ovo se polje automatski popunjava nakon odabira koda i označava vrstu dohvaćenog podatka. Može imati vrijednosti:
• Opis artikla → ako je pretraga pronašla artikl.
• Opis zaglavlja → ako je pretraga pronašla zaglavlje.
• Field Type: Omogućuje odabir vrste polja koje će se prikazati, kao što su “Standardno opisno polje”, “Tehničko polje” ili druga, ovisno o dostupnim informacijama za proizvod.

🔹 Link
Odjeljak Link omogućuje da blok bude klikabilan, povezujući ga s internim ili vanjskim resursom.
• Tip: Definira vrstu veze koja se primjenjuje. Dostupne opcije su:
• Stranica → povezuje blok sa stranicom na web mjestu.
• Post → povezuje blok s člankom na WordPressu.
• Prilagođeni link → omogućuje unos prilagođenog URL-a.
• Povezano: Ovisno o odabranoj vrsti, omogućuje odabir stranice, posta ili web adrese za povezivanje. Ovo je korisno, na primjer, za povezivanje koda artikla s odgovarajućom stranicom proizvoda ili kategorijom u katalogu.

🔹 Phantom
Odjeljak Phantom omogućuje aktivaciju privatnog načina rada bloka.
• Phantom način: Kada je aktivan, sadržaj bloka je skriven za neregistrirane korisnike i ostaje vidljiv samo onima koji su prijavljeni. Posebno je koristan za upravljanje sadržajem namijenjenim isključivo distributerima, partnerima ili internom osoblju (na primjer, povlaštene cijene ili tehničke informacije).

🔹 Cjenik AI
Sekcija Cjenik AI integrira blok sa sustavom umjetne inteligencije cjenika, omogućujući generiranje dinamičkih opisa ili prilagođenih tekstova temeljenih na podacima artikla.
• Sadržaj: Glavno polje gdje se unosi prompt, odnosno tekst koji vodi automatsko generiranje sadržaja. Moguće je koristiti dinamičke oznake za pozivanje podataka odabranog proizvoda.
Primjer prompta:
• Kod <COD> je <st;A;des> modela <topic> sa širinom <diml>
• Učitaj spremljeni prompt / Spremi prompt: Omogućuju učitavanje prethodno spremljenog prompta ili spremanje novog za ponovnu upotrebu u drugim blokovima.
• Pregled: Prikazuje pregled konačnog rezultata zamjenom oznaka stvarnim vrijednostima povezanog proizvoda.
• Oznake: Popis dostupnih polja za odabrani kod artikla (npr. COD, DIML, DIMP, DES, itd.), koja se mogu koristiti unutar prompta.
• Tema: Polje posvećeno referentnoj temi prompta (na primjer model, kolekcija ili kategorija). Omogućuje generiranje tekstova koji su koherentniji i kontekstualiziraniji u odnosu na prikazani proizvod.

Blok Price-list Table omogućuje prikaz podataka cjenika u tabličnom formatu. Svaka tablica može biti potpuno prilagođena: broj redaka i stupaca, sadržaj ćelija, podaci učitani iz cjenika, slike, poveznice, slobodni tekstovi, opisi i mnogo više. To je idealan blok za izradu strukturiranih cjenika, tehničkih tablica, mreža proizvoda ili konfigurabilnih kartica.

🔹 Struktura tablice
Tablica se generira na temelju parametara unesenih u odjeljak Table Settings:
• Rows number: broj redaka za generiranje
• Columns number: broj stupaca za generiranje
• Cell style: omogućuje primjenu grafičkog stila na ćelije (okviri, pozadine, poravnanja)
Kada se spremi, dodatak automatski generira popis ćelija s progresivnim nazivom:
Format ćelija:
ćelija-
Primjeri:
• Red 0 → ćelija-00, ćelija-01, ćelija-02
• Red 1 → ćelija-10, ćelija-11, ćelija-12
• …
• Red 5 → ćelija-50, ćelija-51, ćelija-52
Svaka ćelija može se konfigurirati neovisno.

🔹 Odabir ćelije
Nakon generiranja tablice:
1. Otvara se padajući izbornik Cell.
2. Odabire se ćelija za konfiguriranje (npr. cella-01).
3. Ovisno o odabranom tipu sadržaja, bočna traka prikazuje različite postavke.

🔹 Dostupne vrste sadržaja
Za svaku ćeliju moguće je odabrati vrstu sadržaja putem polja Tip ćelije:
• Opis članka
• Podaci o članku
• Opis zaglavlja
• Cijena
• Slobodan tekst
• Slika
Kada se odabere vrsta, bočna traka prikazuje postavke koje odgovaraju kategoriji.

🔸 KONFIGURACIJA ĆELIJA
U nastavku su opisane sve moguće konfiguracije prema odabranom sadržaju.

🟦 1. Opis artikla
Prikazuje opis povezanog artikla.

Dostupna polja:
• Šifra artikla: odabire se klikom na lupu i pretraživanjem:
• neutralni kod
• opisni tekst artikla
• Način: automatski se popunjava
• Vrsta polja: odaberite koje opisno polje prikazati (npr. standardni opis, tehnički opis, jezik, itd.).
• ROW SPAN / COL SPAN: Omogućuju spajanje ćelije s onima susjednim:
• 0 = nema spajanja
• 1+ = spajanje ćelija vertikalno ili horizontalno

🟩 2. Podaci o artiklu
Prikazuje osnovne informacije o proizvodu.

Primjeri odabranih polja:
• šifra artikla
• dimenzije
• visina, širina, dubina
• dodatne informacije
Funkcionira kao Opis artikla, s pretraživanjem pomoću povećala.

🟧 3. Opis zaglavlja
Prikazuje opise koji pripadaju zaglavljima cjenika.

Polja
• Kod zaglavlja: Pretraživanje pomoću povećala, odabirom zaglavlja cjenika.
• Tip polja: Opisno polje zaglavlja
• Poveznica:
• Tip: odabir vrste sadržaja (Stranica, Objave, Prilagođena poveznica)
• Povezano: odabir stranice/objave/URL-a
Korisno za omogućavanje klikanja na kategorije ili sekcije.

🟥 4. Cijena
Prikazuje cijenu iz cjenika.

Dostupna polja
• Šifra artikla: može se odabrati samo putem pretraživanja
• Stupac cijene: stupac cjenika koji se koristi

5. Slobodan tekst
Unesite ručno tekst u ćeliju, neće biti preveden.

🟪 6. Slika
Umeće sliku u ćeliju.

Odabir slike:
• Slika se odabire iz Media Library WordPressa.

Dimenzije slike:
• Image auto dimension = ON –> Koristi originalne dimenzije slike.
• Image auto dimension = OFF –> Omogućuje ručno definiranje:
• širina
• visina
• maksimalna širina
• maksimalna visina

Pažnja!: potrebno je unijeti i jedinicu mjere (px, %, vh, vw, itd.)

❓ Kako funkcioniraju?
Width i Height definiraju stvarne dimenzije slike.
• Ako su postavljeni, slika se prisiljava točno na te vrijednosti.
• Slika ne može premašiti niti pasti ispod tih dimenzija.
• Mogu promijeniti proporcije ako širina i visina ne poštuju izvorni omjer.

Primjer:
– Width: 300px
– Height: 200px
→ slika će uvijek biti 300×200 px, bez obzira na izvornu veličinu.

Max-Width i Max-Height definiraju maksimalnu granicu, a ne fiksnu veličinu.
• Slika zadržava izvorne proporcije.
• Slika može biti manja, ali nikada neće premašiti postavljene vrijednosti.
• Ako je izvorna slika veća, automatski će se smanjiti kako bi se uklopila u granice.
Primjer:
– Max-Width: 300px
– Max-Height: 200px
→ slika se prilagođava maksimalnom dostupnom prostoru, bez deformiranja.

Ako su oba postavljena, slika pokušava poštovati širinu/visinu, ali nikada ne premašuje max-width i max-height.

Prefiks / Sufiks:
Omogućuju odabir slike na temelju naziva datoteke s navedenim sufiksom ili prefiksom.
Prefiks/sufiks omogućuju pronalaženje varijanti kao što su:
• AB01.jpg
• crtež_AB01.png
• AB01_shema.jpeg

Primjer:
Šifra artikla = AB01
Prefiks = crtež_
Sufiks = (prazno)
Plugin će automatski tražiti u Media Library datoteku koja sadrži:
crtež_AB01.*

Rekurzivno nadjačavanje:
Služi za rekurzivni blok (objašnjeno u sljedećem modulu).
Ako je rekurzivno nadjačavanje aktivno, slika ostaje odabrana, bez automatske zamjene na temelju odabrane šifre artikla.

🔹 SPREMANJE
Gumb Save cell nalazi se unutar zaslona za konfiguraciju svake pojedine ćelije.
Služi za spremanje:
• postavki trenutno odabrane ćelije
• opće konfiguracije tablice
• trenutnog stanja stranice WordPress

👉 Važno je kliknuti “Save cell” prije nego što napustite odabranu ćeliju, inače se unesene promjene neće primijeniti.

🔹 PREGLED
Kliknite na Show Table za pregled tablice s generiranim podacima.

Blok Price-list Recursive omogućuje automatsko generiranje niza ponavljajućih tablica, počevši od predloška stvorenog s blokom Price-list table i primjenom na više odabranih šifri artikala. Rezultat je niz tablica identičnih u strukturi, ali s različitim sadržajem ovisno o pridruženoj šifri.

Važna napomena: blok Recursive funkcionira samo na šiframa artikala, ne na zaglavljima.

1. Upravljanje udrugama
Otvaranje panela
Kliknite na Manage Associations za otvaranje prozora za upravljanje kodovima.
Dodavanje udruge
1. Kliknite Add Association
2. Pretražite šifru artikla putem teksta ili koda
3. Kliknite Associa pored željenog koda
4. Ponovite za sve potrebne kodove
5. Potvrdite sa Save & Close
Redoslijed udruga
• Svaki kod se unosi s automatskom pozicijom (0,1,2,…)
• Možete ga promijeniti pomoću Move Up / Move Down
• Utvrđeni redoslijed određuje redoslijed kojim se generiraju tablice na frontend-u

2. Odabir predloška Nakon što spremite asocijacije, izaberite iz izbornika Predložak koju tablicu (prethodno stvorenu s tablicom cjenika) treba koristiti za svaki kod. Predložak je obavezan, jer: • definira strukturu ćelija • označava koja polja treba zamijeniti • omogućuje rekurzivnom da zna koje elemente generirati (tekstovi, slike, cijene, itd.).

3. Field override
Polje Field override dostupno je samo u rekurzivnim blokovima.
Služi za isključivanje jednog ili više polja iz prikaza rekurzivnog bloka, kako bi se izbjeglo njihovo automatsko ponavljanje.
Funkcioniranje
U polje Field override treba unijeti naziv polja koje treba isključiti
(primjer: DES1, DES2, IMG, itd.).
Kada se rekurzivni blok obrađuje, navedeno polje se ne prikazuje.
Sva ostala polja nastavljaju se normalno upravljati rekurzivnim blokom.
U praksi, blok se renderira kao i obično, ali bez navedenog polja.
Primjer
Rekurzivni blok konfiguriran za prikaz:
DES1
DES2
DES3
Postavljanjem:
Field override = DES2
Rezultat:
DES1 → vidljivo
DES2 → nije prikazano
DES3 → vidljivo
Tipična upotreba
Polje Field override korisno je kada:
informacija treba biti prikazana samo jednom (izvan rekurzivnog bloka)
želite izbjeći dupliciranje sadržaja
potrebna je preciznija kontrola nad time što se automatski ponavlja

4. Prefiks/Sufiks slike (pažnja!)
U bloku Recursive možete postaviti:
• Image Prefix
• Image Suffix
Ove vrijednosti primjenjuju se na SVE slike unutar predloška.

⚠️ Pažnja
Ako neke ćelije u predlošku već imaju specifičan prefiks/sufiks, dodavanje prefiksa/sufiksa i u rekursivnom može:
• duplicirati prefikse/sufikse,
• uzrokovati da se slika ne pronađe.
Praktično pravilo
• Ako sve slike trebaju imati određeni prefiks ili sufiks → postavite ga u Recursive.
• Ako samo neke slike trebaju imati → postavite ga direktno u tablici (predložak) i ostavite prazne Prefix i Suffix u Recursive.

5. Kako se generiraju tablice
Za svaki pridruženi kod:
1. Sustav klonira predložak
2. Automatski zamjenjuje polja ćelija (npr. kod, dimenzija, slika, opis, itd.)
3. Primjenjuje prefikse/sufikse na slike (ako su postavljeni u Recursive)
4. Prikazuje na stranici niz tablica, po jednu za svaki kod

Primjer:
Odabrali ste kodove AB01, AB02, AB03
→ Bit će generirane tri tablice identične strukture, ali s:
• različitim kodom
• različitim opisima
• slikama s nazivom AB01 / AB02 / AB03
• tekstualnim sadržajem automatski prilagođenim

6. AI Polja
Recursive ne sadrži polje “content”: AI tekst se nalazi u predlošku, gdje će biti napisan dinamički (npr. s AI oznakama kao što su , itd.).
Može se primijeniti samo opća tema.
Recursive se ograničava na prosljeđivanje ispravnih vrijednosti za svaki kod.

7. Konačni ispis (render)
Prilikom objave, blok će prikazati:
• tablicu za svaki kod
• prema određenom redoslijedu
• s ispravno zamijenjenim podacima i slikama

Blok Price-list Single Price omogućuje prikaz jedne cijene preuzete s cjenika, za određeni artikl i odabrani stupac cijene. Koristi se, na primjer, kada želite prikazati cijenu proizvoda unutar stranice s detaljima ili na kartici proizvoda.

⚙️ Postavke bloka

🔎 Šifra cjenika
Polje za pretraživanje koje ti omogućuje odabir šifre artikla samo putem pretraživanja.
👉 Ne možeš ga ručno unijeti.
Možeš pretraživati putem:
• teksta opisa
• neutralnog koda
Nakon što odabereš rezultat, blok se automatski povezuje s artiklom.

🧱 Stupac Odaberite iz kojeg stupca cijena preuzeti vrijednost.

📌 Čemu služi? Mnoge tvrtke koriste više stupaca za upravljanje različitim cijenama: • različiti materijali • varijante • cjenovni razredi

Primjer: • Stupac 001 → cijena u melaminu • Stupac 002 → cijena u mramoru 👉 Ovim poljem točno odabirete koju cijenu prikazati.

💱 Valuta

Simbol valute:
• određuje ga Pricelist Server (npr. €, $, CHF…)
• može se aktivirati ili deaktivirati u postavkama WordPress dodatka (opcije ON/OFF)

👉 blok ne upravlja izravno valutom, već samo prikazom.