Za vlasnike stranice

Kupci widget na vašoj stranici

Zatražite API ključ putem kontakta, zatim ugradite kratak dio HTML-a i skriptu. Dizajn i tema u nastavku.

Da biste mogli koristiti Kupci.com widget na svojoj web stranici, potrebno je prvo kontaktirati nas putem kontakt forme kako bismo vam omogućili pristup.

Koraci za integraciju

Nakon što ste nas kontaktirali i dobili API ključ, možete započeti s integracijom widgeta na vašu stranicu. Slijedite ove korake:

Upute za integraciju

Dodajte sljedeći HTML kod na vašu web stranicu gdje želite prikazati Kupci.com widget:


<div id="kupci-com-widget" data-slug="COMPANY_SLUG" data-api-key="COMPANY_KEY" data-design="DESIGN" data-theme="THEME" data-transparent="0" data-variant="VARIANT" data-accent="ACCENT" data-company-name="NAZIV_TVRKE" data-seo-rating="4.8" data-seo-reviews="120">
    <a href="https://kupci.com/recenzije/COMPANY_SLUG" target="_blank" rel="noopener noreferrer">Provjerite recenzije na Kupci.com</a>
</div>
<noscript>
  <p><a href="https://kupci.com/recenzije/COMPANY_SLUG">Provjerite recenzije na Kupci.com</a>. Kad JavaScript ne radi ili je isključen, ostaje ovaj vidljivi link za crawljere i posjetitelje.</p>
</noscript>
<script src="https://kupci.com/widget/int.js" defer></script>

Unutar bloka stalno ostaje barem jedan obični <a> na profil (/recenzije/SLUG) u HTML‑u. Skripta zadržava taj tekst i URL kao SEO „watermark“ ispod prikaza. Neobavezni atributi data-company-name, data-seo-rating, data-seo-reviews daju statični SEO fallback ako API ne odgovori — kratki tekstualni link uz ocjenu ostaje u stranici bez praznog kutija. Neobavezno: atribut data-seo-anchor može zamijeniti tekst vodilje (inače se koristi tekst koji ste stavili unutar <a> ili podrazumijevani primjer iznad).

Također možete dodati više widgeta korištenjem različitog ID-a za svaki widget.


<div id="kupci-com-widget-1" data-slug="COMPANY_SLUG" data-api-key="COMPANY_KEY" data-design="1" data-theme="1" data-transparent="0">
  <a href="https://kupci.com/recenzije/COMPANY_SLUG" target="_blank" rel="noopener noreferrer">Provjerite recenzije na Kupci.com</a>
</div>
<div id="kupci-com-widget-2" data-slug="COMPANY_SLUG" data-api-key="COMPANY_KEY" data-design="2" data-theme="1" data-transparent="1">
  <a href="https://kupci.com/recenzije/COMPANY_SLUG" target="_blank" rel="noopener noreferrer">Provjerite recenzije na Kupci.com</a>
</div>
<script src="https://kupci.com/widget/int.js" defer></script>

Zamijenite COMPANY_SLUG u href i u data-slug te zamijenite COMPANY_KEY s API ključem koji ste dobili od Kupci.com tima.

DESIGN - Odaberite jedan od dizajna prikazanih ispod (1-4):

THEME - Odaberite temu:
1 = Tamna tema (crna pozadina, bijeli tekst)
2 = Svijetla tema (bijela pozadina, crni tekst)

TRANSPARENT - Odaberite želite li transparentnu pozadinu:
0 = ne (zadana vrijednost)
1 = da

VARIANT (neobavezno, zadano classic) - vizualni okvir koji radi unutar istog dizajna 1–4:
classic = klasična kartica s vrhom u brend akcent boji
glass = staklasti sloj (backdrop-filter blur uz padajući fallback)
neo ili brutalist = oštri rubovi i izražen odmak sjene
organic ili organic-soft = veliki radijus, meki gradijent, blaga animacija pojave

ACCENT (neobavezno, zadano startup) - intenzitet brend zelene na rubovima i broju ocjene:
startup = življa zelena
serious = suptilnija, niža saturacija

SEO-ANCHOR (neobavezno) - vlastiti tekst linka kao data-seo-anchor="…"; ako ga nema, koristi se copy iz vašeg <a> elementa ili zadani primjer iz predloška gore.

Živi primjeri (isti widget kao na vanjskoj stranici)

Niže se učitava pravi widget bez API ključa: koriste se ilustrativne ocjene za slug „kupci”. Za svoj profil potreban je osobni ključ koji zatražite putem kontakt forme kao u uvodu.

Dizajn 1, tema 1:

Dizajn 1, tema 2:

Dizajn 2, tema 1:

Dizajn 2, tema 2:

Dizajn 3, tema 1:

Dizajn 3, tema 2:

Dizajn 4, tema 1:

Dizajn 4, tema 2:

Testiranje integracije

Nakon što ste integrirali widget, provjerite prikaz učitavanjem stranice. U slučaju problema obratite se tehničkoj podršci putem kontakt forme.

Zaključak

Integracija Kupci.com widgeta omogućuje vam da jednostavno prikažete recenzije i ocjene za vašu tvrtku direktno na vašoj web stranici.

Kontakt

Ako imate pitanja o integraciji, kontaktirajte nas putem kontakt forme.

Dobrodošli