Installation og opsætning

Installation

1. Hent septima-widget.zip hos Septima.
2. Gå i WordPress til Plugins → Tilføj nyt plugin → Upload plugin, vælg zip-filen, og klik Installér nu.
3. Klik Aktivér.

Pluginnet kan også installeres ved at pakke zip-filen ud i wp-content/plugins/septima-widget/.

Pluginnet er oversat til dansk og engelsk. WordPress vælger sproget ud fra sitets eller brugerens sprog.

Opsætning

Gå til Indstillinger → Septima Widget (/wp-admin/options-general.php?page=septima-widget). Normalt angiver du kun Widget Admin-URL; resten læses fra Widget Admin.

Felt	Standard	Beskrivelse
Widget Admin-URL	– (påkrævet)	Adressen på jeres Widget Admin, fx https://widgetadmin.example.dk.
Konfigurationens basis-URL	fra Widget Admin	Offentlig basis-URL for de publicerede widget-konfigurationer.
Widget-scriptets URL	fra Widget Admin	URL til widget.js.
Forhåndsvisningens basis-URL	fra Widget Admin	Hvor forhåndsvisningen i editoren læser den senest gemte konfiguration.
Præfiks for nye widgets	wordpress	Bruges i ID'et for nye widgets, når der ikke er angivet en titel.
Standardhøjde	400px	CSS-højde på widgets uden egen højde. Tom betyder ingen fast højde.
Indsæt script automatisk	til	Indlæser widget-scriptet på sider, der indeholder en widget.

Indstillingerne gemmes i option'en septima_widget_settings.

Indstillinger i wp-config.php

Alle felter kan også angives med en konstant i wp-config.php. En konstant vinder over indstillingen, og feltet er så låst på indstillingssiden. Det er praktisk, når de samme indstillinger skal bruges i flere miljøer.

define( 'SEPTIMA_WIDGET_ADMIN_URL', 'https://widgetadmin.example.dk' );
define( 'SEPTIMA_WIDGET_CONFIG_BASE_URL', '' );
define( 'SEPTIMA_WIDGET_SCRIPT_URL', '' );
define( 'SEPTIMA_WIDGET_PREVIEW_BASE_URL', '' );
define( 'SEPTIMA_WIDGET_NEW_PREFIX', 'wordpress' );
define( 'SEPTIMA_WIDGET_DEFAULT_HEIGHT', '400px' );
define( 'SEPTIMA_WIDGET_AUTO_INJECT', true );

Version og URL'er fra Widget Admin

Septima Widget-versionen (kanalen) angives ét sted: widget-version i Widget Admin-instansens konfiguration. Pluginnet har ingen indbygget version eller URL og peger aldrig af sig selv på Septimas testinstans.

I stedet læser pluginnet GET {Widget Admin-URL}/api/public/info på serveren (uden login). Svaret indeholder widgetVersion, baseUrl, widgetScriptUrl, widgetApiUrl og dataPublicUrl:

Indstilling	Fra Widget Admin
Konfigurationens basis-URL	baseUrl
Widget-scriptets URL	widgetScriptUrl
Forhåndsvisningens basis-URL	dataPublicUrl
WidgetAPI-modulet i forhåndsvisningen	widgetApiUrl

Er kun konfigurationens basis-URL angivet, bliver widget-scriptets URL {konfigurationens basis-URL}/widget.js.

Svaret gemmes og opdateres i baggrunden (WP-Cron) hvert 5. minut. Mislykkes en opdatering, bruges de senest gyldige værdier, og der prøves igen efter 30 sekunder. En ændring af widget-version i Widget Admin når derfor WordPress inden for få minutter.

Værdier, du selv angiver, vinder altid over værdierne fra Widget Admin. Så kan du også bruge en ældre Widget Admin uden /api/public/info: angiv selv konfigurationens basis-URL (og evt. forhåndsvisningens basis-URL og widget-scriptets URL).

Tip: Kender du ikke konfigurationens basis-URL? Åbn en widget i Widget Admin, og kopiér CMS-koden. URL'en før /config/…json er basis-URL'en.

Tabellen Gældende konfiguration nederst på indstillingssiden viser de værdier, der bruges, og deres kilde (Angivet, Fra Widget Admin eller Ukendt), status for seneste opslag og en evt. fejl. Opdatér fra Widget Admin læser oplysningerne igen med det samme.

Kan Widget Admin ikke nås, og er URL'erne ikke angivet, viser indstillingssiden og blokken en advarsel, og der kan ikke indsættes widgets. Hjemmesiden viser stadig widget-elementerne, men uden scriptet.

Skærmbillede