
Gunfinder-widgeten ger webbplatsägare möjlighet att visa Gunfinders sökresultat på sin egen webbplats. Ett bra exempel är integrationen på Geartester (längst ner på sidan).
Nedan förklarar vi kort hur du kan bädda in Gunfinder-widgeten på din egen webbplats. Processen består i princip av två steg: Först bäddar du in en JavaScript-fil och sedan skriver du lite HTML-kod som JavaScript-filen känner igen och bearbetar.
Följande kodsnutt måste inkluderas antingen i head eller body i HTML-dokumentet:
<script src="https://widgets.gunfinder.de/js/search.js" async></script>
När JavaScript-filen har inkluderats kan du lägga till ett nytt DIV-element. Det måste ha ett attribut med namnet data-gunfinder-search-widget för att kännas igen av JavaScript-koden. Här är ett enkelt exempel:
<div data-gunfinder-search-widget data-gunfinder-search-query="{Suchanfrage}"></div>
Detta startar en sökning efter {Suchanfrage} på Gunfinder och visar resultaten på sidan. data-gunfinder-search-query är det enda obligatoriska attributet. Fler möjliga attribut finns i tabellen nedan. Alla attribut måste ha prefixet data-gunfinder-search-.
| Attribut | Beskrivning | Möjliga värden | Obligatoriskt |
| query | Sökfråga | Text | Ja |
| count | Maximalt antal resultat. Heltal. Standardvärde: 5 | > 0 < 30 | Nej |
| price-min | Minimipris. Heltal. | > 0 < price-max (om angivet) | Nej |
| price-max | Maximipris. Heltal. | > 0 > price-min (om angivet) | Nej |
| condition | Varans skick | new eller used | Nej |
| available | Omedelbart tillgänglig. Standardvärde: false | true eller false | Nej |
| category | Begränsar sökningen till en viss kategori | weapon, ammunition, optics, apparel, equipment | Nej |
| style | Utseende. Se beskrivningen nedan. | JSON-objekt | Nej |
| sources | Kommaseparerad lista med namnen på källorna som ska genomsökas. Som standard genomsöks alla källor. | Kontakta oss | Nej |
| exclude-sources | Kommaseparerad lista med namnen på källorna som inte ska genomsökas. Som standard genomsöks alla källor. | Kontakta oss | Nej |
| marketplace | Om värdet är true visas endast resultat från marknadsplatsen. Om värdet är false visas inga resultat från marknadsplatsen. | true eller false | Nej |
Fler exempel:
<div data-gunfinder-search-widget data-gunfinder-search-query="{Suchanfrage}" data-gunfinder-search-price-min="2500"></div>
<div data-gunfinder-search-widget data-gunfinder-search-query="{Suchanfrage}" data-gunfinder-search-available="true"></div>
Om widgeten inte ska utformas med CSS-regler finns det några enkla variabler som kan skickas till widgeten som ett JSON-objekt för att ändra widgetens utseende.
| Variabel | Beskrivning | Möjliga värden |
| fontSize | Grundläggande teckenstorlek. Påverkar hela widgeten. | Standardvärden för storlekar i CSS |
| itemTitleColor | Färg på annonstiteln | Standardvärden för färger i CSS |
| itemPriceColor | Färg på annonspriset | Standardvärden för färger i CSS |
| moreColor | Text- och kantfärg på knappen ”fler annonser” | Standardvärden för färger i CSS |
Exempel:
<div data-gunfinder-search-widget data-gunfinder-search-query="{Suchanfrage}" data-gunfinder-search-style='{"fontSize": "15px", "itemTitleColor": "red"}'></div>