0.3.5 • Published 1 year ago
medistore-widget v0.3.5
🚀 Medistore product widget
Użycie na stronie html
- Aby uruchomić widget na stronie importujemy plik js:
<script src="https://unpkg.com/medistore-widget@latest/dist/medicover-widget.js" defer></script>
- w miejscu, gdzie ma pojawić się widget dodajemy element:
<div data-medicover="{url_key}"></div>
url-key można pobrac z linka strony, np.
- dla https://www.medistore.com.pl/p/internista/ tekst po /p/ "internista" to url_key dla produktu Internista.
- dla https://www.medistore.com.pl/p/usg-ciazy/ url_key to "usg-ciazy"
Stylowanie
Widget ma zaimplementowane podstawowe style css (glownie ustawienia flex), oraz podstawową responsywność (flex-wrap).
Kazdy element widgetu ma nadana klasę css, można go dodatkowo ostylować.
Dodatkowe opcje
Istnieje mozliwosc konfiguracji kazdego widetu na stronie:
<div data-medicover="{url_key}" data-{opcja}="{wartosc}"></div>
Dostepne opcje:
data-{opcja} | type | domyślna wartość | opis |
---|---|---|---|
data-medicover | string | wartość wymagana | url-key produktu |
data-store | string | "default"(1) | wybrany storecode np. default/synevo |
data-language | pl/en | "pl" | język widgetu |
data-title-tag | string | header | ustawia tag dla nazwy produktu |
data-cta | string | "Kup teraz" | tekst, który pojawi się na przycisku CTA |
data-image | bool | true | pokaz/ukryj zdjęcie |
data-description | bool | true | pokaz/ukryj opis |
data-price | bool | true | pokaz/ukryj cenę |
data-observe | bool | false | odświeża (re-renderuje) widok przy zmianie atrybutu rendered (np. po hydracji ssr) |
data-utm-source | string | wartość opcjonalna | dodaje do url query ?utm_source={{string}} |
data-utm-medium | string | wartość opcjonalna | dodaje do url query ?utm_medium={{string}} |
data-utm-campaign | string | wartość opcjonalna | dodaje do url query ?utm_campaign={{string}} |
(1) "default" odnosi się do medistore.com.pl
np. żeby wyświetlić widget dla produktu internista bez miniaturki:
<div data-medicover="internista" data-image="false"></div>
Renderowanie
Po załadowaniu pliku js każdy poprawnie skonfigurowany element html z url-key w data-medicover uzupełni się danymi produktu.
Istnieje możliwość uruchomienia ładowania widgetu na elementach html załadowanych później (np lazy-load), służy do tego metoda:
window.medistoreWidget.render()