Beágyazható névnap modul

A Névnap365 beágyazható modulja külső oldalakba is beilleszthető. A JSON végpont: /widget-data.

1. Gyors indítás

Tedd be ezt a két sort arra az oldalra, ahol meg akarod jeleníteni a modult:

<div data-nevnap365-widget data-mode="today"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Teljes minimál példaoldal

<!DOCTYPE html>
<html lang="hu">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Névnap modul példa</title>
</head>
<body>
  <div data-nevnap365-widget data-mode="today"></div>
  <script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>
</body>
</html>

2. data-* opciók

  • data-mode (globális/canonical): today, yesterday, tomorrow (alap: today)
  • data-mode aliasok (kompatibilitás): mai, tegnap, holnap
  • data-list / data-name-set (globális/canonical): official, extended, both (alap: both)
  • data-list aliasok (kompatibilitás): hivatalos, bovitett, bővitett, bővített, mind
  • data-show-main: 1 vagy 0 (alap: automatikus a data-list alapján)
  • data-show-other: 1 vagy 0 (alap: automatikus a data-list alapján)
  • data-max-other / data-other-count: 0 ... 365 vagy all (alap: 8)
  • data-show-title: 1 vagy 0 (alap: 0)
  • data-show-date: 1 vagy 0 (alap: 1)
  • data-show-main-title: 1 vagy 0 (alap: 0)
  • data-show-other-title: 1 vagy 0 (alap: 0)
  • data-show-other-more: 1 vagy 0 (alap: 0)
  • data-show-source: 1 vagy 0 (alap: 1)
  • data-loading-text: egyedi betöltési szöveg (alap: Névnapok betöltése...)
  • data-title: egyedi cím szöveg (alap: automatikus cím)

3. Példák

Mai névnap

<div data-nevnap365-widget data-mode="today"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Cím megjelenítése (Mai névnapok)

<div data-nevnap365-widget data-mode="today" data-show-title="1" data-title="Mai névnapok"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Csak hivatalos névnapok

<div data-nevnap365-widget data-mode="today" data-list="official"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Csak bővített lista (12 név)

<div data-nevnap365-widget data-mode="today" data-list="extended" data-max-other="12"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Csak bővített lista (összes)

<div data-nevnap365-widget data-mode="today" data-list="extended" data-max-other="all"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Holnapi névnap

<div data-nevnap365-widget data-mode="tomorrow" data-max-other="5"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Holnapi névnap (csak hivatalos)

<div data-nevnap365-widget data-mode="tomorrow" data-list="official"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Tegnapi névnap (csak fő lista)

<div data-nevnap365-widget data-mode="yesterday" data-show-other="0" data-title="Tegnapi névnapok"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Tegnapi névnap (csak bővített, 20 név, canonical kulcsokkal)

<div data-nevnap365-widget data-mode="yesterday" data-list="extended" data-other-count="20"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

Tömör lista (cím, dátum és forrás nélkül)

<div data-nevnap365-widget data-mode="today" data-show-title="0" data-show-date="0" data-show-main-title="0" data-show-other-title="0" data-show-source="0"></div>
<script async src="https://nevnap365.hu/assets/scripts/nevnap-widget.js"></script>

4. API végpont példák

A végpontok közvetlen böngészős megnyitása a hivatalos modul kivételével tiltott.

  • /widget-data?mode=today&show_other=1&max_other=8
  • /widget-data?mode=yesterday&show_other=1&max_other=8
  • /widget-data?mode=tomorrow&show_other=0&max_other=0
  • /widget-data?mode=today&show_other=1&max_other=all

Válasz mezők: mode, label, date_iso, date_display, main[], other[], source_url, source_title.

5. Megjegyzések

  • Időzóna: Europe/Budapest.
  • A modul alapból stílus nélküli HTML-t ad vissza, a kinézetet a beágyazó oldal CSS-e szabja meg.
  • A modul automatikusan forrás linket jelenít meg a Névnap365.hu oldalra.
  • Ha több modult raksz egy oldalra, a scriptet akkor is csak egyszer kell betölteni.