WP Manifestindependent plugin directory
manifest / ecommerce / woocommerce-cjenik-hr

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

★ 0stars
0forks

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.zip

WordPress/WooCommerce plugin za javnu objavu cjenika, sidrenu cijenu i najnižu cijenu u posljednjih 30 dana.

Plugin radi tri stvari:

  1. 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.
  2. Objavljuje cjenik. Svakog radnog dana zapisuje CSV pod propisanim nazivom datoteke i čuva prethodne verzije javno dostupnima.
  3. 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

  1. Kopirajte mapu cjenik-hr u wp-content/plugins/ i aktivirajte plugin.
  2. Proizvodi → Cjenik: ispunite adresu i oznaku objekta. Ostalo ima razumne zadane vrijednosti — adresa se preuzima iz WooCommerce postavki trgovine, marka iz naziva web-mjesta.
  3. Kliknite Objavi cjenik sada i provjerite naziv datoteke i sadržaj.
  4. 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:

  1. ručni unos na proizvodu, ako postoji;
  2. trenutna cijena, dok je proizvod snižen;
  3. zadnja snižena cijena zabilježena unutar 30 dana;
  4. 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.