eCjenik dokumentacija: Free i Pro
eCjenik je WordPress dodatak za javni cjenik proizvoda i usluga, evidenciju referentnih cijena i objavu CSV arhive. Radi samostalno ili uz WooCommerce. Free sadrži osnovni cjenik, unos, povezivanje i arhivu; Pro dodaje spremljene prikaze, oblikovanje i brendirani ispis.
Status: beta za testiranje. Ove upute opisuju Free 1.2.0-beta.1 i Pro 1.1.0-beta.1, provjereno prema kodu 14. 9. 2026. Pro mogućnosti opisane ovdje implementirane su u beti. Datum javnog izdanja, cijena i komercijalni uvjeti Pro verzije još nisu potvrđeni. Beta nema sustav aktivacije licence.
Kome je eCjenik namijenjen
Za trgovce i pružatelje usluga koji na WordPress stranici žele prikazati cijene i omogućiti preuzimanje objavljenog cjenika. Možete voditi samostalne proizvode i usluge bez web-trgovine ili povezati WooCommerce jednostavne proizvode i varijacije.
Trenutačni profil je jedan objekt, EUR i jedinstvene javne maloprodajne cijene s porezom. Više spremljenih Pro prikaza služi predstavljanju istog kataloga; ne uvodi odvojene cijene za više poslovnica. Personalizirane cijene, više valuta i proizvoljni porezni dodaci zahtijevaju zasebnu provjeru.
Free i Pro: što dobivate
| Mogućnost | Free | Pro uz Free |
|---|---|---|
| Ručni unos proizvoda i usluga | Da | Da |
| CSV uvoz i izvještaj po zapisu | Da | Da |
| Opcionalno WooCommerce povezivanje | Da | Da |
| Aktualne, sidrene i prethodne akcijske cijene | Da, uz unos stvarnih evidencija | Da, isti podaci |
| Osnovni javni cjenik, pretraga i kategorije | Da | Da |
| Blok i shortcode za umetanje | Da | Da, uz izbor spremljenog prikaza |
| Javna CSV objava i nepromjenjiva arhiva | Da | Da |
| Spremljeni prikazi istog kataloga | — | Da |
| Tablica, kartice i predložak usluga s postavkama izgleda | — | Da |
| Boje, font, razmaci, obrubi i izbor dodatnih polja | — | Da |
| Brendirani ispis i spremanje PDF-a kroz preglednik | — | Da, do 1.000 stavki po pripremi |
Free nema licencno ograničenje broja stavki. Stvarni kapacitet i brzina ovise o hostingu, podacima i aktivnim dodacima. Ograničenje Pro ispisa i veličina CSV uvoza zasebne su tehničke granice, a ne ograničenje veličine kataloga.
Prije instalacije
Potreban je WordPress 7.1 ili noviji, PHP 8.2 ili noviji i administratorski pristup. WooCommerce nije obvezan; beta je provjeravana s WooCommerceom 11.1.0. Sve kombinacije tema, dodataka i hostinga nisu pojedinačno potvrđene.
Betu prvo postavite na zasebnu testnu kopiju weba i napravite sigurnosnu kopiju. Za automatsku obradu bez posjeta potreban je raspored na hostingu. Za komprimiranu arhivu PHP mora imati zlib, uključujući nakon preseljenja weba na drugi hosting.
Prvi cjenik u tri koraka
- U WordPressu otvorite Dodaci → Dodaj novi → Prenesi dodatak, instalirajte dobiveni Free ZIP i aktivirajte ga. Otvorite izbornik eCjenik: prikazat će se postavke i obrazac stavki.
- Unesite oblik, adresu i oznaku objekta te profil proizvoda, usluga ili oboje. Dodajte jednu stavku sa stvarnim nazivom, šifrom, cijenom i primjenjivim referentnim podacima. Spremite je i provjerite da se pojavila u popisu.
- U WordPress stranicu dodajte blok eCjenik ili shortcode
[ecjenik]. Otvorite pregled stranice i usporedite prikazanu stavku s unosom. Zatim pokrenite Objavi / ponovno pokušaj kako biste izradili prvi arhivski CSV; provjerite posljednju uspješnu objavu i preuzetu datoteku.
Javni katalog dostupan je i na adresi vašeg WordPressa s dodatkom ?ecjenik=1. Na testnoj kopiji provjerite sve bez javne objave stvarnih poslovnih podataka. Ako se pojavi obavijest o nepotpunim podacima ili sinkronizaciji, ispravite navedeni uzrok prije nastavka.
Ručni unos proizvoda i usluga
Svakoj stavci dodijelite stabilnu šifru, vrstu i naziv. Unesite kategoriju ako želite filtriranje. Kategorija ručne stavke doslovan je naziv: zarez u nazivu ne stvara dvije kategorije. Nakon unosa šifra ostaje stabilna; isti code u CSV-u ažurira istu ručnu stavku.
Aktualna cijena je krajnja EUR cijena s porezom. Dopušteni su decimalna točka ili zarez, najviše dvije decimale, bez razdjelnika tisućica. Za proizvod popunite primjenjive podatke o marki, barkodu, jedinici, dostupnosti i cijenama. Za uslugu marka i barkod nisu obvezni. Ne izmišljajte podatke koji nedostaju.
Za pakiranje od 500 g koje prikazujete po kilogramu unesite jedinicu kg i množinu 0.5. Primjer izračuna: cijena pakiranja 3,00 EUR daje 6,00 EUR/kg. Na Woo stavci množina omogućuje ponovni izračun nakon promjene cijene.
Polje vremena važenja koristi Europe/Zagreb. Unos budućeg datuma za ručnu cijenu ne zakazuje automatsku promjenu; takvu cijenu unesite kada počne vrijediti. Woo zakazane akcije ovise o WooCommerce rasporedu.
Sidrena i najniža prethodna cijena
Sidrena cijena je referentni iznos na odgovarajući datum. Najniža prethodna cijena je zaseban podatak vezan uz posebni oblik prodaje, primjerice akciju. Jedna ne zamjenjuje drugu.
Ugrađeni profil koristi referentne datume 10. 9. 2026. i 2. 5. 2025., ovisno o primjenjivom obuhvatu. Datum i iznos odaberite iz stvarne evidencije; dodatak ne zaključuje vaš pravni režim iz naziva djelatnosti.
Ako iznos nije poznat, ostavite ga praznim i označite Nedostaje povijest. Nula nije zamjena za nepoznatu cijenu. Za stavku koja na referentni datum nije postojala postoji status Novi proizvod / usluga. Razjasnite postupanje za svoj slučaj prije objave. Ispravak postojeće reference treba razlog; prethodna revizija i ranije objavljeni CSV ostaju sačuvani.
Povijest zabilježena nakon instalacije ne dokazuje ranije cijene. Beta ne jamči potpun automatski obračun svih vrsta akcija i prethodnih najnižih cijena; tu referencu provjerite u vlastitoj evidenciji. Potpuna kontrola identiteta akcije i prikaza referenci još je predmet razvoja.
CSV uvoz: veći unos i dopune
- U eCjenik administraciji preuzmite aktualni predložak. Sačuvajte zaglavlje, kodiranje UTF-8 i razdjelnik
;. Ne koristite javni izvozni CSV kao zamjenu za predložak uvoza: imaju različitu namjenu i stupce. - Popunite podatke i prenesite datoteku. Za izmjenu povijesnih podataka unesite razlog ispravka. Najveća datoteka je 20 MiB ili niži limit prikazan u obrascu; pojedini CSV zapis može imati najviše 64 KiB.
- Pratite status i izvještaj. Valjani zapisi spremaju se, neispravni dobivaju poruku. Ispravite odbijene zapise i ponovno ih uvezite. Preglednik možete zatvoriti nakon prihvaćenog prijenosa: nastavak radi na poslužitelju uz aktivan raspored.
Ne morate dijeliti datoteku samo zato što ima više od 1.000 redaka. Uvoz se obrađuje u paketima. Nije jedna zajednička transakcija: otkazivanje ne poništava već spremljene zapise, nego zaustavlja preostale.
| Stupac / vrijednost | Značenje |
|---|---|
code |
Stabilna šifra ručne stavke |
kind: product ili service |
Proizvod ili usluga |
availability: available ili unavailable |
Dostupnost |
anchor_status: known, missing ili new |
Poznata povijest, nedostaje ili nova stavka |
anchor_date |
Referentni datum u obliku YYYY-MM-DD |
effective_at |
Datum/vrijeme važenja, primjer 2026-09-14T07:00, Europe/Zagreb |
Prazan source_id |
Samostalna stavka |
source_id: wc:123 |
Dopuna već sinkroniziranog Woo proizvoda/varijacije s ID-em 123 |
Ovo su ključne vrijednosti, a cjelovito zaglavlje preuzmite iz obrasca. Kod wc:ID uvoz ne prepisuje Woo naziv, aktualnu cijenu i dostupnost. Ako Woo obrada još traje, odgovarajući unos čeka ponovni pokušaj.
Ulaz i izvještaji nisu javno dostupni. Sirovi sadržaj uklanja se u koracima nakon završetka, otkazivanja ili terminalne pogreške. Privatni izvještaj zadržava se 30 dana nakon završetka; njegovo čišćenje ovisi o aktivnom rasporedu. Revizije cijena i objavljena CSV arhiva time se ne brišu.
Povezivanje s WooCommerceom
U eCjenik postavkama uključite WooCommerce povezivanje i pokrenite sinkronizaciju. Pričekajte početnu obradu pa provjerite jednostavni proizvod i, ako ih koristite, njegove varijacije. Aktualnim Woo nazivima, cijenama, porezima i dostupnošću upravljate u WooCommerceu; u eCjeniku dopunjujete referentne podatke.
Promjene se obrađuju u pozadini. Dok izvor nije spreman, eCjenik katalog ili ispis može prikazati poruku da sinkronizacija traje. To nije potvrda da je katalog prazan. Ostavite raspored aktivnim i nakon obrade osvježite prikaz.
Varijacije su zasebne stavke; varijabilni roditelj nije dodatni artikl. Javnost proizvoda i roditelja provjerava se i pri čitanju. Skrivanje proizvoda ne prepisuje ranije izrađene CSV arhive. Ako WooCommerce nedostaje ili integracija nije aktivna, nove Woo promjene ne stižu, a Woo stavke ne prikazuju se kao javne stavke aktualnog kataloga; ručne stavke i ranije objavljena arhiva ostaju zasebni podaci.
Na Woo stranicama osvježavaju se eCjenik reference. One ne zamjenjuju Woo cijenu ili porezne izračune. Ako osvježavanje nije moguće, ostaje poveznica na cjenik. Posebne sustave popusta, personalizacije i cache/CDN postavke provjerite na vlastitom webu.
Aktualni prikaz, CSV objava i arhiva
Aktualni prikaz čita sadašnje dopuštene stavke. CSV objava je dovršena datoteka u određenom trenutku. Arhiva omogućuje preuzimanje ranije objavljenih datoteka bez naknadnog prepisivanja.
Pokrenite Objavi / ponovno pokušaj, pričekajte posljednju uspješnu objavu i preuzmite CSV. Usporedite naziv, šifru, aktualnu i referentnu cijenu nekoliko stavki. Kod pogreške prethodna uspješna objava ostaje dostupna, ali može biti starija od aktualnih podataka. Uvijek provjerite vrijeme objave.
| Adresa na vašem WordPressu | Sadržaj |
|---|---|
/?ecjenik=1 |
Javni cjenik s arhivom |
/?ecjenik=1&ecjenik_download=latest |
Najnovija uspješna CSV objava |
/?ecjenik=1&ecjenik_download=123 |
Arhivska objava s ID-em 123, ako postoji |
CSV koristi UTF-8 BOM, točku-zarez, decimalnu točku i CRLF prijelome redaka. Iznosi su u EUR. Datoteka sadrži podatke stavki, referenci i objekta; ne izvozi interne razloge ispravaka ili ID-eve urednika. Radi sigurnijeg otvaranja u tabličnim programima tekst s obilježjima formule može dobiti početni apostrof.
Objavljene datoteke ne brišu se automatski. Arhiva se može komprimirati bez promjene izvornih bajtova. Hosting treba pratiti kapacitet baze i sigurnosne kopije; kompresija nije jamstvo neograničenog prostora. Tehničku provjeru datoteke omogućuje SHA-256 u HTTP zaglavlju X-eCjenik-SHA256.
Automatska obrada i rokovi
Uvoz, Woo sinkronizacija, objave i čišćenje trebaju stvarno izvršavanje pozadinskih poslova. WordPressov WP-Cron ovisi o posjetima pa sam ne jamči dovršetak u određeno vrijeme.
Zamolite hosting da svake minute izvršava dospjele WordPress događaje. Administrator hostinga može koristiti sljedeću naredbu uz stvarnu putanju WordPress instalacije:
wp --path=/stvarna/putanja/wordpress cron event run --due-now --quiet
To pokreće i dospjele događaje drugih dodataka, uključujući WooCommerce. Ako hosting nema WP-CLI, s njim dogovorite podržano redovito pokretanje WP-Crona i provjeru uspjeha.
Profil proizvoda/mješoviti profil pokreće dnevnu objavu od 07:00 prema Europe/Zagreb ako tog dana još nema uspješne objave; promjene također mogu pokrenuti novu objavu. Profil usluga objavljuje nakon promjene. Dovršetak ovisi o podacima, redovima poslova i hostingu. Postojanje rasporeda nije samo po sebi potvrda objave do roka.
Pro: spremljeni prikazi i izgled
Instalirajte Pro nakon Free dodatka. Ova beta zahtijeva Free 1.2.0-beta.1 i Catalog API 2; ažurirajte oba dodatka zajedno. Ako nedostaje kompatibilna jezgra, Pro prikazuje administratorsku obavijest i čuva spremljene prikaze.
- Otvorite eCjenik → Prikazi → Dodaj prikaz. Unesite naziv i odaberite tablicu, kartice ili cjenik usluga.
- Odaberite kategorije ili ostavite sve. Podesite boje, sistemski font, veličinu teksta, razmake, obrube, zaobljenje i dodatna polja. Kartice mogu imati jednu do tri kolone na računalu; mobitel koristi jednu.
- Pregledajte nacrt administratorskom poveznicom pa objavite prikaz. U bloku eCjenik odaberite spremljeni prikaz ili umetnite
[ecjenik view="123"], zamijenivši 123 njegovim stvarnim ID-em.
Promjena spremljenog prikaza vrijedi na svim mjestima gdje se koristi. Dupliciranjem možete napraviti drugi izgled istog kataloga. Filtri posjetitelja sužavaju već odabrane kategorije; ne otvaraju stavke izvan odabira prikaza.
Aktualne i relevantne referentne cijene ostaju dio prikaza. Pro služi oblikovanju; ne zamjenjuje unos i provjeru podataka. Osnovni [ecjenik] bez odabranog prikaza ostaje Free cjenik.
Pro: ispis i PDF
U postavkama prikaza odaberite logotip iz medijske zbirke, naslov ispisa i podatke objekta. U javnom prikazu pokrenite pripremu ispisa filtriranog skupa. Pričekajte da završi prikaz napretka pa odaberite ispis. Za PDF u dijalogu preglednika izaberite Spremi kao PDF.
Po pripremi je dopušteno do 1.000 stavki. Ako je odabir veći, suzite kategoriju ili pretragu i ponovno pokrenite pripremu. Rezultat se ne skraćuje tiho. Ako indeks ili sinkronizacija nisu spremni, pričekajte i pokušajte ponovno.
Ispis uključuje vrijeme pripreme. To je trenutačni prikaz, nije arhivski CSV ni automatska zamjena za njegovu nepromjenjivu povijest. PDF nastaje kroz preglednik, ne kroz zasebnu poslužiteljsku uslugu generiranja PDF-a.
Rješavanje problema
| Što vidite | Što učiniti |
|---|---|
| Nedostaje sidrena cijena ili povijest | Pribavite stvarni podatak i provjerite odgovarajući status; ne unosite izmišljeni iznos |
| Objava je odbijena zbog podataka | Ispravite navedeno polje/stavku, ponovno objavite i provjerite vrijeme posljednjeg uspjeha |
| Cjenik čeka Woo sinkronizaciju | Provjerite raspored i greške u administraciji; nakon obrade osvježite prikaz |
| Pretraga se priprema | Pričekajte dovršetak indeksa; nepotpun filtrirani rezultat ne koristite kao konačni popis |
| CSV uvoz stoji | Provjerite status i poruku, administratorska prava inicijatora i raspored; koristite ponovni pokušaj nakon otklanjanja uzroka |
| CSV datoteka je prevelika | Smanjite datoteku ispod limita u obrascu; veliki broj redaka sam po sebi nije limit |
| Prikazane su stare cijene | Otvorite izravni cjenik u anonimnom prozoru, usporedite vrijeme CSV objave i provjerite cache/CDN iznimke |
| Posao je već u tijeku | Pričekajte; nakon prekida proces se može nastaviti po isteku lokota. Ne brišite lokote ručno |
| Pro prikaz nije dostupan | Provjerite aktivaciju kompatibilnih Free/Pro verzija, objavljen status prikaza i točan ID |
| Ispis odbija odabir | Suzite skup ispod granice i pričekajte spremnost pretrage/sinkronizacije |
| Arhiva se ne može preuzeti nakon preseljenja | Hosting treba provjeriti zlib, cjelovitost obnovljene baze i zapis pogreške |
| Prostor baze raste | Provjerite arhivu, pozadinske poslove i backup; povijest se zadano ne briše |
Za prijavu problema zabilježite Free/Pro, WordPress, PHP i WooCommerce verzije, korake do pogreške, očekivani/stvarni rezultat te ID i vrijeme problematične objave ili uvoza. Ne šaljite lozinke ni cijeli privatni CSV u javnu prijavu.
Cache i pristup tražilicama
Javni cjenik i CSV dostupni su bez prijave. Blok i shortcode otvaraju cjenik u zasebnom okviru, uz poveznicu za izravno otvaranje. Taj prikaz traži svježe podatke čak i kad je okolna stranica predmemorirana.
S hostingom provjerite da ?ecjenik=1 i potrebne pozadinske rute nisu zamrznuti u CDN/page cacheu. Pravila prijave, zaštite weba, robots.txt ili način „Coming soon” mogu onemogućiti javni pristup unatoč postavkama dodatka.
Ova dokumentacija objašnjava alat u čitljivom HTML-u. Ne jamči indeksiranje ni položaj u tražilici. Upute na marketinškoj stranici i javni cjenik na vašem WordPressu zasebne su stranice.
Nadogradnja, deaktivacija i podaci
Prije nadogradnje napravite konzistentnu sigurnosnu kopiju cijele baze i provjerite obnovu na testnoj kopiji. Beta koristi migracije podataka; starije Free i Pro verzije nisu nužno međusobno kompatibilne.
Deaktivacija Pro čuva spremljene prikaze. Umetnuti prikazi vraćaju se na osnovni Free prikaz dok Pro nije dostupan; administrator vidi obavijest. Ponovna aktivacija kompatibilnog Pro vraća oblikovanje.
Deaktivacija Free ne briše pohranjene podatke. Uklanjanje ih prema zadanim postavkama također zadržava. Trajno brisanje zahtijeva izričitu tehničku postavku i zasebnu odluku vlasnika; prije toga osigurajte potrebno čuvanje i backup. Automatsko brisanje cijele multisite mreže nije podržano.
Pravni doseg i granice bete
eCjenik pomaže pripremi, prikazu i čuvanju cjenika. Ne potvrđuje automatski pravnu usklađenost svake djelatnosti, akcije ili prodajnog kanala.
Ugrađeni profil pripreman je prema odlukama NN 101/2026-1212 i 1213, s primjenom od 1. 10. 2026. Potrebno je zasebno potvrditi primjenjivost na vašu djelatnost, raniji režim, izuzeća i režim bazne cijene od 17. 11. 2026. Pravna provjera, potpune akcijske reference i predprovjera svih nepotpunih stavki/alarma ostaju otvoreni dijelovi razvoja.
Cijene ručno upisane na drugim stranicama, slikama, oglasima ili starim PDF-ovima ne ažuriraju se automatski. Dodatak ne uređuje fizičke oznake u objektu. Za vlastite obveze i ispravnost ulaznih podataka potrebna je poslovna evidencija i odgovarajuća stručna provjera.
Česta pitanja
Trebam li WooCommerce?
Ne. Free radi kao samostalan cjenik proizvoda i usluga. WooCommerce uključite samo ako želite koristiti njegov katalog kao izvor.
Moram li kupiti Pro za CSV i arhivu?
Ne. CSV uvoz, javne CSV objave, arhiva, osnovni cjenik i Woo povezivanje dio su Free jezgre.
Mogu li imati više izgleda istog cjenika?
Da, u Pro beti spremate više prikaza i umetnete ih na različite stranice. Svi koriste isti katalog; promjena podataka ne zahtijeva uređivanje svake kopije prikaza.
Hoće li se promjenom cijene promijeniti stari CSV?
Ne. Nova cijena ide u aktualne podatke i sljedeću objavu. Već objavljena datoteka ostaje ista.
Izračunava li eCjenik cijene prije instalacije?
Ne. Sidrene i potrebne prethodne cijene unosite iz stvarnih evidencija. Praćenje nakon instalacije ne stvara povijest koja ranije nije zabilježena.
Je li PDF isto što i arhiva?
Ne. Pro priprema prikaz za ispis koji preglednik može spremiti kao PDF. CSV arhiva zasebno čuva nepromjenjive objave.
Koliko košta Pro i kada ga mogu kupiti?
Cijena, datum javnog izdanja i uvjeti kupnje još nisu potvrđeni. Ova dokumentacija opisuje postojeću beta implementaciju, a ne otvorenu komercijalnu ponudu.