Od instalacije do pouzdane javne objave.

Instalacija

1. Upute za instalaciju, nadogradnju i provjeru zahtjeva nalaze se u ovom vodiču.
2. U WordPressu otvori Dodaci → Dodaj novi → Prenesi dodatak .
3. Prenesi ZIP, instaliraj ga i aktiviraj.
4. Otvori glavni izbornik Sidrena i provjeri početne postavke.

Početno postavljanje

Odaberi koristiš li WooCommerce katalog, samostalni katalog proizvoda i usluga ili kombinirani način. Zatim postavi lokacije, provjeri referentne datume i odluči kako će se javni cjenik objavljivati.

Preporučeni redoslijed

1. provjeri vremensku zonu WordPressa
2. dodaj fizičke poslovnice i webshop
3. unesi ili uvezi sidrene podatke
4. provjeri primjenjivost jedinične cijene gdje je relevantna
5. pokreni tehničku provjeru
6. generiraj prvu valjanu objavu

Katalog proizvoda i usluga

Za proizvode se mogu voditi aktualna i sidrena cijena, referentni datum i skupina, marka, šifra, barkod, jedinica mjere, cijena po jedinici, posebni oblik prodaje, povijest te lokacijske vrijednosti. Za usluge se mogu voditi naziv, vrsta, opseg, cijene, pripadajući troškovi i podaci o robi koja je sastavni dio usluge kada je to relevantno.

WooCommerce CSV import/export može sadržavati Sidrena polja, dok samostalni katalog podržava vlastiti uvoz. CSV ulaz treba normalizirati u UTF-8, a tekstualna polja u javnom izvozu zaštititi od formula-injection prefiksa.

Poslovnice i webshop

Fizičke lokacije vode se odvojeno od webshopa. Time svaka lokacija može imati vlastitu raspoloživost, lokalnu cijenu i javnu datoteku, bez pretpostavke da je globalni WooCommerce stock uvijek dovoljan opis stvarnog stanja poslovnice.

Digitalni cjenici i arhiva

Sidrena generira javne CSV/XML datoteke i javni HTML prikaz. Uspješna objava sprema se kao zasebna verzija, a prethodne objave ostaju dostupne najmanje 30 dana prema pravilima koja projekt prati.

• javni HTML cjenik može koristiti spremljenu javnu verziju podataka
• CSV i XML imaju jednaku logiku podataka po lokaciji
• arhiva može spremati SHA-256 za provjeru integriteta
• neuspjela nova generacija ne treba pregaziti zadnju valjanu objavu
• filename se gradi iz podataka prodajnog/uslužnog objekta i vremenske oznake

Shortcodeovi

Ovisno o instaliranoj verziji, javni prikazi uključuju sljedeće shortcodeove:

[sidrena_cjenik]
[sidrena_arhiva]
[sidrena_cijena]
[sidrena_cjenici]
[sidrena_usluge]

REST API

Javni REST endpointi služe za dohvat cjenika i aktualnih javnih cijena. Endpoint ne bi smio izlagati private, draft, password-protected ili namjerno katalogom skrivene proizvode.

GET /wp-json/sidrena/v1/cjenici
GET /wp-json/sidrena/v1/cijene

Automatizacija, cron i WP-CLI

WP-Cron ovisi o prometu weba. Ako je rok objave poslovno kritičan, koristi pouzdan server cron koji redovito pokreće WordPress cron ili odgovarajuću WP-CLI naredbu. Generiranje treba imati lock kako dvije objave ne bi istodobno pisale iste datoteke.

wp sidrena generate
wp sidrena status
wp sidrena audit

Sigurnosni model

Administracijske akcije trebaju koristiti WordPress capability i nonce provjere, sanitizirati ulaz i escapati izlaz. Datoteke se trebaju pisati u kontrolirano područje, bez path traversal mogućnosti i uz atomic temp → rename obrazac.

Dijagnostika i veći katalozi

Za kataloge od tisuća stavki važno je izbjegavati N+1 upite i učitavanje cijelog kataloga u memoriju. Koristi paginaciju, spremljeni javni prikaz i dnevnik aktivnosti kako bi se problem uočio prije nego utječe na javni cjenik.

Za tehničke upute, prijavu problema i informacije o aktualnoj verziji koristi službenu dokumentaciju projekta.