# Plugin Sidro: upute
Plugin Sidro prikazuje spremljenu cijenu na referentni datum uz prodajnu cijenu i izrađuje javni CSV cjenik s arhivom. Podatke proizvoda uređujete u WooCommerceu, a postavke i objavu cjenika u **WooCommerce → Sidro**.
Upute za inačicu **1.0.0**. Snimke zaslona prikazuju primjere iz testne trgovine; izgled vaše trgovine ovisi o temi.
## Sadržaj
- [Prije početka](#prije-pocetka)
- [Brzi početak: sidrene cijene](#brzi-pocetak-sidrene-cijene)
- [Unos podataka proizvoda](#unos-podataka-proizvoda)
- [Postavljanje javnog cjenika](#postavljanje-javnog-cjenika)
- [Podaci koji nedostaju i admin obavijest](#podaci-koji-nedostaju-i-admin-obavijest)
- [Više proizvoda kroz WooCommerce CSV](#woocommerce-csv)
- [Što vide posjetitelji](#sto-vide-posjetitelji)
- [Osnovne poteškoće](#osnovne-poteskoce)
- [Ažuriranje i uklanjanje](#azuriranje-i-uklanjanje)
- [Podržana uporaba i licenca](#podrzana-uporaba-i-licenca)
## Prije početka
Potrebni su **WordPress 7.0 ili noviji, WooCommerce 11.0 ili noviji, PHP 7.4 ili noviji** i valuta trgovine **EUR**. Plugin Sidro aktivirajte na pojedinačnoj WordPress web-stranici. Mrežna aktivacija nije podržana.
ZIP instalirajte kroz **Dodaci → Dodaj dodatak → Prenesi dodatak**, zatim aktivirajte plugin Sidro.
Prikaz sidrenih cijena i automatska izrada cjenika uključeni su prema zadanim postavkama. Možete ih uključivati i isključivati odvojeno. Javna objava počinje kada postavite podatke prodajnog objekta i stranicu cjenika.
U **WooCommerce → Sidro** nalaze se tri kartice:
| Kartica | Što ondje radite |
| --- | --- |
| Upute | Čitate ove upute. Ovo je početna kartica. |
| Pregled | Provjeravate posljednju objavu i podatke koji nedostaju, preuzimate probni CSV te izrađujete ili zamjenjujete javni cjenik. |
| Postavke | Uključujete prikaz i automatsku izradu, unosite podatke prodajnog objekta i birate stranicu cjenika. |
## Brzi početak: sidrene cijene
1. Otvorite **Proizvodi → Svi proizvodi**, odaberite proizvod i otvorite **Podaci o proizvodu → Sidro**.
2. Unesite **Sidrenu cijenu** i provjerite **Referentni datum**. Kod varijabilnog proizvoda podatke unesite za svaku varijaciju koju želite prikazivati.
3. Spremite proizvod gumbom **Ažuriraj**. Kod novog proizvoda upotrijebite **Objavi**.
4. Otvorite **WooCommerce → Sidro → Postavke**. U odjeljku **Prikaz sidrenih cijena** provjerite da je uključeno **Prikazuj sidrene cijene** i nakon promjene odaberite **Spremi**.
5. Otvorite javnu stranicu proizvoda i provjerite redak ispod prodajne cijene. Za varijabilni proizvod najprije odaberite varijaciju.
*Uključivanje prikaza i spremanje te postavke.*
Ako želite koristiti samo sidrene cijene, u odjeljku **Javni CSV cjenik** isključite automatsku izradu i odaberite njegov gumb **Spremi**. Postavljanje javnog cjenika možete obaviti poslije.
## Unos podataka proizvoda
### Jednostavni proizvod
Otvorite **Podaci o proizvodu → Sidro**, unesite vrijednosti i odaberite **Ažuriraj**.
*Jednostavni proizvod: sidrena cijena, datum i ostala polja plugina Sidro.*
### Varijabilni proizvod
1. Otvorite **Podaci o proizvodu → Varijacije**.
2. Proširite željenu varijaciju. Unutar nje pronađite odjeljak **Sidro**, ispod redovne i akcijske cijene.
3. Unesite podatke za tu varijaciju. Ponovite postupak za ostale varijacije.
4. Odaberite **Spremi promjene**, zatim **Ažuriraj** proizvod.
*Polja se nalaze unutar pojedinačne varijacije. Količina je skrivena jer je odabrano Nije primjenjivo.*
Svaka varijacija ima vlastitu sidrenu cijenu i referentni datum. Na ovoj snimci odabrano je **Nije primjenjivo**, pa se polje za količinu ne prikazuje.
### Značenje polja
| Polje | Što upisati |
| --- | --- |
| Sidrena cijena | Cijenu na referentni datum. Prazno znači da cijena nije unesena. Nula je valjana cijena. |
| Referentni datum | Datum na koji se sidrena cijena odnosi. Zadano je 10. 9. 2026.; datum možete promijeniti. |
| Vrsta stavke | **Proizvod** ili **Usluga**. Za usluge se ne prijavljuju nedostajući SKU, marka, barkod i podaci o jedinici mjere. |
| Jedinica mjere | **kg**, **l**, **m**, **m²**, **m³** ili **kom**. Odaberite **Nije primjenjivo** kada se podatak ne primjenjuje. Prazno znači da odabir još nije napravljen. |
| Količina u prodajnom pakiranju | Količinu u odabranoj jedinici. Za 500 g brašna odaberite **kg** i upišite **0,5**. To nije stanje zaliha ni težina pošiljke. |
| Posebni oblik prodaje | Primjerice **Akcijska prodaja**. Tekst ostaje spremljen, a u javnom CSV-u pojavljuje se dok je proizvod na sniženju. |
Za proizvod se količina prikazuje kada odaberete primjenjivu jedinicu. Za usluge su jedinica i količina skrivene; spremljene vrijednosti ostaju sačuvane ako ponovno odaberete Proizvod.
Plugin Sidro sam računa cijenu za jedinicu mjere. Primjerice, cijena pakiranja **5 €** uz količinu **0,5 kg** daje **10 €/kg** u javnom CSV-u.
Sidrenu cijenu unesite prema WooCommerceovoj postavci **Cijene unesene s porezom**. Napomena uz polje pokazuje koristi li trgovina unos s porezom ili bez njega. Nakon promjene poreznih postavki pregledajte spremljene sidrene cijene.
Naziv, SKU, robnu marku, barkod iz polja **GTIN/UPC/EAN/ISBN**, prodajne cijene, datume sniženja, poreze i zalihe uređujete u standardnim WooCommerce poljima. Plugin Sidro ne dodaje zamjenski SKU ili barkod.
## Postavljanje javnog cjenika
### 1. Unesite podatke prodajnog objekta
Otvorite **WooCommerce → Sidro → Postavke → Javni CSV cjenik**. Unesite oblik, adresu i identifikator prodajnog objekta. Ako želite jutarnju objavu, ostavite uključeno **Automatski izrađuj javni CSV cjenik svakog jutra**. Odaberite **Spremi** u tom odjeljku.
*Primjer popunjenih postavki jutarnje objave. Unesite podatke svoje trgovine.*
Podaci prodajnog objekta ulaze u naziv CSV datoteke. Plugin Sidro dodaje redni broj pohrane i vrijeme objave. Vrijednosti na snimci služe samo kao primjer.
### 2. Postavite stranicu za preuzimanje
U odjeljku **Stranica za preuzimanje** odaberite **Izradi stranicu Cjenik**. Možete odabrati i postojeću objavljenu stranicu na koju ste dodali kratki kod `[sidro30_price_list]`.
*Primjer nakon odabira stranice Cjenik. Poveznicu na stranicu dodajte u navigaciju trgovine.*
Na snimci je stranica već odabrana. Poveznicu na nju dodajte u izbornik ili podnožje trgovine kako bi je posjetitelji pronašli. Stranici možete promijeniti naziv i adresu; plugin Sidro pamti odabranu stranicu.
### 3. Provjerite podatke i probni CSV
Otvorite karticu **Pregled** i odjeljak **Podaci koji nedostaju**. Dopunite potrebne vrijednosti, zatim odaberite **Preuzmi probni CSV** i pregledajte datoteku.
Probni CSV sadrži trenutačne podatke i iste stupce i izračune kao javni CSV. Preuzimanje je privatno: ne objavljuje cjenik i ne mijenja arhivu. Dostupno je i prije postavljanja prodajnog objekta i javne stranice.
### 4. Objavite i provjerite preuzimanje
Na kartici **Pregled** odaberite **Izradi današnji cjenik**. Ako današnji cjenik već postoji, gumb se zove **Zamijeni današnji cjenik**.
*Primjer kada je današnji cjenik već objavljen. Probni CSV služi provjeri, a zamjena izrađuje novu javnu datoteku.*
Kada izrada završi, otvorite **Otvori javni cjenik**. Provjerite datum objave i preuzimanje najnovije datoteke. Provjerite i pristup kao odjavljeni posjetitelj.
*Javno preuzimanje najnovijeg cjenika i najnovije datoteke za svaki dan u arhivi.*
## Podaci koji nedostaju i admin obavijest
Odjeljak **WooCommerce → Sidro → Pregled → Podaci koji nedostaju** prikazuje koji podatak nedostaje, broj proizvoda i uputu gdje ga unijeti. Odaberite **Prikaži proizvode** u odgovarajućem retku.
*Poveznica Prikaži proizvode otvara proizvode kojima nedostaje podatak iz odabranog retka.*
Filtrirani WooCommerce popis prikazuje pogođene proizvode, a za varijabilne proizvode navodi i pogođene varijacije. Varijabilni proizvod računa se jednom u broju proizvoda. Broj varijacija prikazan je zasebno; te brojke nemojte zbrajati. Isti proizvod može biti u više redaka tablice.
Marku dodijelite jednom na varijabilnom proizvodu; koristi se i za njegove varijacije. Ako nedostaje cijena za jedinicu mjere, provjerite jedinicu, količinu u pakiranju i WooCommerce prodajnu cijenu. Izračunati iznos ne unosite zasebno.
*Obavijest vodi na pregled podataka koji nedostaju. Na snimci je primjer iz testne trgovine.*
Obavijest **Plugin Sidro: dopunite podatke proizvoda** vodi na isti pregled. Križić je skriva do pojave drugog proizvoda ili varijacije s nepotpunim podacima. **Ne prikazuj više** trajno skriva tu obavijest za vaš korisnički račun na ovoj trgovini. Pregled podataka i dalje je dostupan u pluginu Sidro.
Nedostajući podaci proizvoda ostaju prazni u javnom CSV-u. Nakon dopune preuzmite novi probni CSV. Da bi promjene ušle u javno preuzimanje, zamijenite današnji cjenik ili pričekajte sljedeću jutarnju objavu.
## Više proizvoda kroz WooCommerce CSV
### Dvije različite CSV datoteke
| Datoteka | Namjena |
| --- | --- |
| WooCommerce CSV | Izvozite, uređujete i ponovno uvozite podatke proizvoda. Sadrži stupce s prefiksom **Sidro:**. |
| Javni CSV cjenik | Posjetitelji preuzimaju dovršeni cjenik. Probni CSV služi provjeri njegova sadržaja. Za uređivanje proizvoda koristite WooCommerce CSV. |
### Izvoz
Otvorite **Proizvodi → Svi proizvodi → Izvoz**, odnosno **Izvoz proizvoda** na Sidro kartici Pregled. Odaberite izvoz svih stupaca i kliknite **Generiraj CSV**. Šest stupaca **Sidro:** uključeno je prema zadanim postavkama; za njih ne trebate uključiti izvoz korisničkih meta podataka.
*Izvoz svih stupaca uključuje i šest stupaca Sidro:.*
### Uređivanje datoteke
Koristite izvezenu datoteku kao predložak i sačuvajte izvornu kopiju. Stupci **Sidro:** obično su pri kraju tablice. Svaka varijacija ima vlastiti redak. Sačuvajte ID-eve ili SKU-ove koji povezuju retke s postojećim proizvodima.
| Stupac | Primjer za keramičku šalicu |
| --- | --- |
| Sidro: Sidrena cijena | `11.9` |
| Sidro: Referentni datum | `2026-09-10` |
| Sidro: Vrsta stavke | `Proizvod` |
| Sidro: Jedinica mjere | `kom` |
| Sidro: Količina u prodajnom pakiranju | `1` |
| Sidro: Posebni oblik prodaje | Prazno ako ne upisujete opis sniženja. |
Brojeve upisujte bez znaka € i razdjelnika tisućica. Prihvaća se decimalni zarez ili točka. Datum upišite kao **GGGG-MM-DD**. Program za CSV mora sačuvati razdjelnike i navodnike.
### Uvoz i provjera
1. Otvorite **Proizvodi → Svi proizvodi → Uvoz** i odaberite uređenu datoteku.
2. Uključite **Ažurirajte postojeće proizvode** i odaberite **Nastavi**. WooCommerce povezuje proizvode po ID-u ili SKU-u.
3. Na zaslonu **Mapiranje stupaca** provjerite da je svaki željeni stupac povezan s odgovarajućim poljem **Sidro:**.
4. Za stupce koje ne želite mijenjati odaberite **Ne uvozi**. Zatim odaberite **Pokrenite uvoz** i pregledajte rezultat.
5. Otvorite jedan izmijenjeni proizvod, provjerite vrijednosti i vratite se na Sidro karticu **Pregled**. Preuzmite probni CSV prije javne objave.
*Za uređivanje postojećih proizvoda odaberite Ažurirajte postojeće proizvode.*
*Provjerite povezivanje svakog stupca. Za polja koja želite sačuvati odaberite Ne uvozi.*
### Kako uvoz postupa sa spremljenim vrijednostima
| Što je u datoteci ili mapiranju | Rezultat za polje plugina Sidro |
| --- | --- |
| Stupac je izostavljen ili je odabrano **Ne uvozi** | Postojeća vrijednost ostaje spremljena. |
| Stupac se uvozi, a ćelija je prazna | Vrijednost se briše, uz provjeru valjanosti. Referentni datum ne može ostati prazan uz unesenu sidrenu cijenu. |
| Prazna vrsta stavke | Vraća se zadani odabir **Proizvod**. |
| Nevaljana vrijednost plugina Sidro | WooCommerce prijavljuje pogrešku retka, a Sidro polja tog proizvoda ostaju nepromijenjena. |
**Uvozite samo stupce koje namjeravate promijeniti.** Stupci WooCommerce redovne i akcijske cijene mijenjaju današnje prodajne cijene. Ako se oslanjate na stariji izvoz, provjerite njihovo mapiranje. Današnju redovnu cijenu prepišite u Sidro stupac samo ako je ostala ista od referentnog datuma.
## Što vide posjetitelji
### Sidrena cijena uz proizvod
Na stranici proizvoda te u standardnim prikazima trgovine i kategorija plugin Sidro dodaje redak s datumom i sidrenom cijenom ispod prodajne cijene. Porezni prikaz prati WooCommerce.
*Sidrena cijena ispod prodajne cijene. Izgled stranice ovisi o temi trgovine.*
Ako sidrena cijena nije unesena, redak se ne prikazuje. Varijabilni proizvod nema sidreni raspon; na njegovoj stranici redak se pojavljuje nakon odabira varijacije koja ima svoju prodajnu i sidrenu cijenu. Košarica i naplata zasad nemaju taj redak.
### Javni CSV i arhiva
Javni CSV sadrži naziv, šifru, marku, jedinicu i jediničnu cijenu, maloprodajnu cijenu, podatke o posebnoj prodaji, sidrenu cijenu i datum, barkod te dostupnost. Svaka varijacija ima svoj redak. Proizvodi i usluge koriste iste stupce.
Neobjavljeni, privatni i lozinkom zaštićeni proizvodi nisu uključeni. Javni proizvodi koji nisu dostupni za narudžbu ostaju u cjeniku označeni kao nedostupni. Nepopunjena polja ostaju prazna.
Prodajne i sidrene cijene u javnom CSV-u uključuju porez prema postavkama trgovine. Ako je sniženje aktivno, koristi se akcijska cijena. Svi posjetitelji dobivaju istu dovršenu datoteku i ne moraju biti prijavljeni.
Izrada je zakazana svakog dana u **07:00 prema vremenu u Hrvatskoj**. Izvršavanje WordPressovih zakazanih zadataka ovisi o posjetima i postavkama poslužitelja; za njega su odgovorni vlasnik trgovine i hosting. Vrijeme posljednje objave provjerite na kartici **Pregled**.
**Spremljena izmjena proizvoda ne prepisuje već objavljeni CSV.** Promjene ulaze u sljedeću jutarnju objavu ili novu datoteku koju ručno izradite. Gumb **Zamijeni današnji cjenik** novu datoteku postavlja kao glavno preuzimanje. Arhiva prikazuje najnoviju datoteku za svaki dan; ranije verzije ostaju dostupne preko svojih postojećih poveznica najmanje 30 dana od objave.
Isključivanje automatske izrade zaustavlja jutarnje objave. Ručna izrada i probni CSV ostaju dostupni, a postojeće datoteke ostaju dostupne do isteka arhive. Plugin Sidro uklanja istekle datoteke dok je aktivan.
Ako izrada ne uspije, prethodne datoteke ostaju dostupne. Plugin Sidro pokušava još dvaput u razmaku od 15 minuta. Pogrešku provjerite na Pregledu i po potrebi odaberite **Pokušaj ponovno**.
Za novu javnu objavu potrebna je odabrana, objavljena stranica s kratkim kodom `[sidro30_price_list]`, dostupna bez lozinke. Ako je izbrišete, povučete iz objave ili uklonite kratki kod, poruka na Pregledu vodi na ispravak. Probni CSV ostaje dostupan, a postojeće datoteke ostaju sačuvane do isteka arhive.
### Otvaranje javnog CSV-a u tabličnom programu
Datoteka koristi **UTF-8**, **točku sa zarezom** između stupaca i **decimalni zarez**. Iznosi imaju dvije decimale bez znaka €, a datumi oblik `2026-09-10`. Ako program uklanja početne nule iz barkoda ili SKU-a, pri otvaranju odaberite tekstualni format tih stupaca.
## Osnovne poteškoće
| Poteškoća | Sljedeći korak |
| --- | --- |
| Ne prikazuje se sidrena cijena | Provjerite uključeni prikaz, spremljenu sidrenu cijenu i prikaz prodajne cijene. Za varijabilni proizvod provjerite odabranu varijaciju. |
| Današnji cjenik nije objavljen | Za automatsku objavu provjerite uključenu jutarnju izradu i izvršavanje zakazanih zadataka. Za ručnu i automatsku objavu provjerite podatke prodajnog objekta i javnu stranicu s kratkim kodom. Zatim odaberite **Izradi današnji cjenik** ili **Pokušaj ponovno**. |
| Prijavljena je pogreška zapisivanja | Hosting treba provjeriti dozvole mape za prijenose. |
| U CSV-u nedostaje podatak | Otvorite **Podaci koji nedostaju**, dopunite proizvod ili varijaciju i preuzmite probni CSV. Zatim zamijenite današnji cjenik ili pričekajte sljedeću jutarnju objavu. |
| Stranica nema preuzimanja | Provjerite objavu stranice, kratki kod i postoji li barem jedan dovršeni javni cjenik. |
| Javna datoteka još ima stare vrijednosti | Preuzmite probni CSV da provjerite trenutačne podatke. Javnu datoteku osvježite gumbom **Zamijeni današnji cjenik** ili pričekajte sljedeću jutarnju objavu. |
| Trgovina ili stranica cjenika prikazuje stare vrijednosti | Očistite predmemoriju stranica. Kod predmemorije hostinga ili CDN-a izuzmite stranicu cjenika iz predmemoriranja. |
Uz W3 Total Cache plugin Sidro osvježava predmemoriju stranica nakon promjene svojih polja. Predmemoriju trgovine postavite prema uputama WooCommercea i dodatka za predmemoriranje. Ako cijene ovise o adresi kupca, stranice s kupčevom WooCommerce sesijom izuzmite iz zajedničke predmemorije.
## Ažuriranje i uklanjanje
### Ažuriranje
Novi ZIP prenesite kroz **Dodaci → Dodaj dodatak → Prenesi dodatak** i odaberite zamjenu instalirane inačice. Spremljeni podaci proizvoda, postavke i cjenici ostaju dostupni nakon ažuriranja. Prije ažuriranja pročitajte napomene uz novu inačicu i eventualne posebne upute za prijenos podataka. Sigurnosne kopije ostaju dio uobičajenog održavanja trgovine.
Plugin Sidro nema aktivacijske ključeve ni vlastiti poslužitelj za automatska ažuriranja.
### Deaktivacija i uklanjanje
Deaktivacija i uklanjanje čuvaju spremljene podatke proizvoda, postavke i datoteke. Dok plugin Sidro nije aktivan, njegova polja i imenovani CSV stupci nisu dostupni, ne izrađuje cjenike i ne obrađuje svoja preuzimanja ni kratki kod. Ponovna instalacija i aktivacija koriste sačuvane podatke.
Za zadržavanje postojećih javnih preuzimanja ostavite plugin Sidro aktivnim i isključite automatsku izradu novih cjenika. Ako uklanjate plugin, uredite ili uklonite neiskorišteni kratki kod i poveznice na stranicu cjenika.
## Podržana uporaba i licenca
Podržana su standardna WooCommerce polja jednostavnih proizvoda i varijacija, jedna valuta EUR i jedan katalog. Posebne integracije za pretplate, pakete proizvoda, veleprodajne cijene, više valuta ili višejezične kataloge nisu uključene.
Plugin Sidro dostupan je pod licencom **GNU GPL, inačica 2 ili novija**. Puni tekst licence nalazi se u datoteci **LICENSE.txt** u paketu dodatka.