Cjenik HR
WooCommerce plugin za javnu objavu cjenika, sidrenu cijenu i najnizu cijenu u posljednjih 30 dana
by nikolapevic · github.com/nikolapevic/woocommerce-cjenik-hr
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/nikolapevic/woocommerce-cjenik-hr/archive/refs/heads/main.zipWordPress/WooCommerce plugin za javnu objavu cjenika, sidrenu cijenu i najnižu cijenu u posljednjih 30 dana.
Plugin radi tri stvari:
- Prikazuje referentne cijene u trgovini. Ispod cijene, u popisu proizvoda i na stranici proizvoda, prikazuje sidrenu cijenu, a na sniženim proizvodima i najnižu cijenu u posljednjih 30 dana.
- Objavljuje cjenik. Svakog radnog dana zapisuje CSV pod propisanim nazivom datoteke i čuva prethodne verzije javno dostupnima.
- Vodi evidenciju promjena cijena iz koje se izvodi podatak o sniženjima.
Status
Kod je napisan prema uputama i statički provjeren, ali nije pokrenut na produkcijskoj instalaciji. Prije korištenja provjerite ga na testnom okruženju.
Nazivi stupaca, razdjelnik i decimalni znak postavljeni su prema uobičajenoj praksi hrvatskih cjenika. Provjerite ih uz važeći pravilnik prije prve službene objave — svi su podesivi bez izmjene koda.
Instalacija
- Kopirajte mapu
cjenik-hruwp-content/plugins/i aktivirajte plugin. - Proizvodi → Cjenik: ispunite adresu i oznaku objekta. Ostalo ima razumne zadane vrijednosti — adresa se preuzima iz WooCommerce postavki trgovine, marka iz naziva web-mjesta.
- Kliknite Objavi cjenik sada i provjerite naziv datoteke i sadržaj.
- Preuzmite CSV za uređivanje, popunite šifre, marke, barkodove i neto količine, pa ga vratite natrag.
Dnevna objava
WP-Cron se pokreće tek kad netko posjeti stranicu, pa za pouzdanu objavu prije 8:00 dodajte pravi cron na poslužitelju:
30 7 * * 1-5 cd /put/do/wordpressa && wp cron event run cjenik_daily_build
Državni praznici se ne prepoznaju — vidi filtar cjenik_is_working_day.
Kratki kodovi
[cjenik] — važeći cjenik i arhiva, unutar teme.
| Atribut | Zadano | Opis |
|---|---|---|
arhiva |
da |
prikaz prethodnih verzija |
limit |
0 |
koliko prethodnih verzija, 0 za sve |
prikaz |
popis |
popis ili tablica |
naslovi |
da |
prikaz naslova odjeljaka |
[cjenik]
[cjenik prikaz="tablica" limit="30"]
[cjenik arhiva="ne" naslovi="ne"]
[cjenik_url] — samo adresa važeće datoteke:
<a href="[cjenik_url]">Preuzmi cjenik</a>
Ako napravite stranicu čija je adresa jednaka postavci Adresa javne stranice
(zadano cjenik), ta stranica ima prednost pred ugrađenom rutom.
Stupci CSV-a
naziv_proizvoda, sifra_proizvoda, marka_proizvoda, neto_kolicina,
jedinica_mjere, MPC, cijena_za_jedinicu_mjere, MPC_posebni_oblik_prodaje,
posebni_oblik_prodaje, naziv_posebnog_oblika_prodaje,
najniza_cijena_u_poslj_30_dana, sidrena_cijena_<datum>, barkod,
kategorija_proizvoda, dostupnost
Neto količina se pretvara u osnovnu jedinicu, pa staklenka od 250 g u cjeniku
stoji kao 0,25 / kg, a cijena po jedinici mjere je usporediva među
proizvodima.
Prazan SKU se popunjava ID-em proizvoda, tako da stupac sifra_proizvoda
nikad nije prazan.
Najniža cijena u posljednjih 30 dana
Zadano je zadnja akcijska cijena:
- ručni unos na proizvodu, ako postoji;
- trenutna cijena, dok je proizvod snižen;
- zadnja snižena cijena zabilježena unutar 30 dana;
- redovna cijena, ako u tom razdoblju nije bilo akcije.
Za strogo Omnibus tumačenje — najniža cijena u 30 dana koji su prethodili trenutnom sniženju:
add_filter( 'cjenik_lowest30_use_history', '__return_true' );
Evidencija cijena teče neovisno o tome koji je način odabran, pa se može prebaciti u bilo kojem trenutku bez gubitka podataka.
Povijest cijena prije instalacije nije moguće rekonstruirati. Za ta razdoblja upišite vrijednost ručno na proizvodu ili kroz CSV.
Filtri
| Filtar | Namjena |
|---|---|
cjenik_settings |
postavke i zadane vrijednosti |
cjenik_columns |
stupci CSV-a i njihov redoslijed |
cjenik_units |
jedinice mjere i pretvorba u osnovnu jedinicu |
cjenik_is_working_day |
koji su dani radni |
cjenik_lowest30_use_history |
način izračuna cijene u 30 dana |
cjenik_anchor_date |
datum sidrene cijene |
cjenik_anchor_label, cjenik_lowest30_label |
natpisi uz cijene |
Zahtjevi
WordPress 5.8+, WooCommerce 6.0+, PHP 7.4+.
Licenca
GPL-2.0-or-later.