Visning på hjemmesiden

En widget vises som:

<div class="septima-widget"
     data-widget-url="https://septima.dk/widgetadmin3-data/config/mitkort.json"
     style="height:400px"></div>

Blokken tilføjer også WordPress' blokklasser (wp-block-septima-widget og evt. en justeringsklasse). Bredden følger indholdsområdet; blokken understøtter justeringerne Bred bredde og Fuld bredde i temaer, der tillader det.

Automatisk script (standard)

Når Indsæt script automatisk er slået til, indlæser pluginnet widget-scriptet nederst på sider, der indeholder en widget – og kun på dem. Scriptet finder alle elementer med data-widget-url og indlæser widgetsene, også når der er flere på samme side. Widgets skrevet som rå HTML bliver også fundet: i indholdet, i Tilpasset HTML-blokke (også i skabeloner og skabelondele) og i klassiske tekst- og HTML-widgets. Andre steder, fx i en PHP-skabelon, bruges skabelonfunktionerne nedenfor.

Manuelt script og temaskabeloner

Slå Indsæt script automatisk fra, hvis temaet selv skal styre scriptet. Indlæs det så fra temaet, før wp_footer():

septima_widget_enqueue_script();

En widget kan også vises direkte i en temaskabelon:

echo septima_widget( 'mitkort', '500px' );

Styling

.septima-widget { margin: 1.5rem 0; }

Avanceret brug: Septima Widget kan også styres med JavaScript (WidgetAPI), fx for at lytte efter hændelser eller tilføje data. Se dokumentationen af Septima Widget API.

Content Security Policy

Bruger sitet en Content Security Policy, skal følgende tillades:

script-src: domænet for widget-scriptets URL (fx https://septima.dk) og https://widget.cdn.septima.dk
connect-src: domænet for konfigurationens basis-URL og de korttjenester, widgetten bruger
img-src: korttjenesterne (https: er ofte det enkleste)