Widget Gunfinder oferuje właścicielom stron internetowych możliwość wyświetlania wyników wyszukiwania Gunfinder na własnej stronie. Dobrym przykładem jest integracja Gunfinder na Geartester (na samym dole strony).
W poniższym opisie krótko wyjaśniono, jak można włączyć widget Gunfinder na swojej własnej stronie. W zasadzie proces składa się z 2 kroków: najpierw włącza się plik JavaScript, a w drugim kroku można napisać minimalny kod HTML, który zostanie rozpoznany i przetworzony przez plik JavaScript.
Włączenie pliku JavaScript
W poniższym fragmencie kodu należy go umieścić w sekcji Head lub Body dokumentu HTML:
<script src="https://widgets.gunfinder.de/js/search.js" async></script>
Umieszczanie fragmentu HTML
Gdy plik JavaScript jest załadowany, można dodać nowy element DIV, który musi mieć atrybut o nazwie data-gunfinder-search-widget, aby został rozpoznany przez kod JavaScript. Oto prosty przykład:
<div data-gunfinder-search-widget data-gunfinder-search-query="{Zapytanie}"></div>
To rozpocznie wyszukiwanie z terminem {Zapytanie} w Gunfinder, a wyniki zostaną wyświetlone na stronie. data-gunfinder-search-query jest jedynym obowiązkowym atrybutem. Inne możliwe atrybuty można znaleźć w poniższej tabeli. Wszystkie atrybuty muszą mieć prefiks data-gunfinder-search-.
Atrybut | Opis | Możliwe wartości | Obowiązkowy |
query | Zapytanie | Tekst | Tak |
count | Maksymalna liczba wyników. Liczba całkowita. Domyślnie: 5 | > 0 < 30 | Nie |
price-min | Minimalna cena. Liczba całkowita. | > 0 < price-max (jeśli podano) | Nie |
price-max | Maksymalna cena. Liczba całkowita. | > 0 > price-min (jeśli podano) | Nie |
condition | Stan artykułu | new lub used | Nie |
available | Dostępny od ręki. Domyślnie: false | true lub false | Nie |
category | Ograniczenie wyszukiwania do określonej kategorii | weapon, ammunition, optics, apparel, equipment | Nie |
style | Stylizacja. Zobacz opis poniżej. | Obiekt JSON | Nie |
sources | Lista nazw źródeł oddzielona przecinkami, które mają być przeszukiwane. Domyślnie przeszukiwane są wszystkie źródła. | Proszę skontaktować się z nami | Nie |
exclude-sources | Lista nazw źródeł oddzielona przecinkami, które nie(!) mają być przeszukiwane. Domyślnie przeszukiwane są wszystkie źródła. | Proszę skontaktować się z nami | Nie |
marketplace | Jeśli true, wyświetla tylko wyniki z rynku. Jeśli false, nie wyświetla wyników z rynku. | true lub false | Nie |
Inne przykłady:
<div data-gunfinder-search-widget data-gunfinder-search-query="{Zapytanie}" data-gunfinder-search-price-min="2500"></div>
<div data-gunfinder-search-widget data-gunfinder-search-query="{Zapytanie}" data-gunfinder-search-available="true"></div>
Stylizacja
Jeśli widget nie ma być stylizowany za pomocą reguł CSS, istnieje kilka prostych zmiennych, które mogą być przekazane do widgetu jako obiekt JSON, aby zmienić wygląd widgetu.
Zmiana | Opis | Możliwe wartości |
fontSize | Podstawowy rozmiar czcionki. Ma wpływ na cały widget. | Standardowe wartości CSS dla rozmiarów |
itemTitleColor | Kolor nagłówka oferty | Standardowe wartości CSS dla kolorów |
itemPriceColor | Kolor ceny oferty | Standardowe wartości CSS dla kolorów |
moreColor | Kolor tekstu i ramki przycisku "więcej ofert" | Standardowe wartości CSS dla kolorów |
Przykład:
<div data-gunfinder-search-widget data-gunfinder-search-query="{Zapytanie}" data-gunfinder-search-style='{"fontSize": "15px", "itemTitleColor": "red"}'></div>