Octany-widgetar i WordPress.

Octanys plugin lägger till ett block och en shortcode som bäddar in valfri Octany-widget — gåvoflöden, 1-klick Swish, insamlingsmål, aktivitetsflöden, Pulse, hälsningar, givarportaler och formulär — på sidor och i inlägg. Redaktörer behöver inte behörighet att lägga in skript: pluginet skriver själv embed-snutten och laddar den bara från Octanys egna servrar.

§ 01.7.1 Ladda ner #

§ 01.7.2 Installera och uppdatera #

1. Gå till Tillägg → Lägg till nytt tillägg → Ladda upp tillägg i WordPress-admin.
2. Välj zip-filen du laddade ner och klicka på Installera nu.
3. Klicka på Aktivera.

Pluginet finns inte på WordPress.org, så uppdateringar dyker inte upp i adminpanelen. Ladda ner den nya zip-filen här och ladda upp den på samma sätt när du vill uppdatera — WordPress frågar om den ska ersätta den installerade versionen. Block och shortcodes som redan ligger på dina sidor fortsätter att fungera.

§ 01.7.3 Block #

1. Öppna widgeten i Octany-admin och kopiera dess inbäddningskod.
2. Lägg till blocket Octany-widget i blockredigeraren (under Inbäddningar, eller sök på "octany", "donera" eller "swish").
3. Klistra in inbäddningskoden och klicka på Bädda in.

Blocket läser ut widgettyp, konto, widget-ID, språk och referenser ur inbäddningskoden, så du behöver aldrig skriva in dem för hand. Sedan kan allt ändras i blockets inställningspanel: Typ, Konto-ID och Widget-ID under Widget; Octany-URL, Språk, Referens-ID och Referensnamn under Avancerat. Använd Byt ut i blockets verktygsfält för att klistra in en annan inbäddningskod.

I redigeraren visas en platshållare — själva widgeten renderas när sidan besöks. Blocket stöder bred och full justering samt marginaler.

§ 01.7.4 Shortcode #

För den klassiska redigeraren, sidbyggare, widgetområden eller var som helst där shortcodes fungerar:

[octany type="donate-v1" account="1234" widget="01HXXXXXXXXXXXXXXXXXXXXXXX"]

En shortcode som klistras in i blockredigeraren kan göras om till ett Octany-widget-block via blockets meny Omvandla till — alla attribut följer med.

§ 01.7.5 Widgettyper #

Formulär är det enda undantaget i namngivningen: shortcode-typen är form-v1, loadern heter registration-v1 och api-URL:en får suffixet /forms.

§ 01.7.6 Output och validering #

Blocket och shortcoden renderar samma markup som Octany-admin ger dig — en container och ett modulskript, på plats:

<!-- [octany type="donate-v1" account="1234" widget="01HXXXXXXXXXXXXXXXXXXXXXXX" lang="sv"] -->
<div class="octany-donate" data-widget="01HXXXXXXXXXXXXXXXXXXXXXXX"></div>
<script
  type="module"
  src="https://give.octany.com/donate-v1/loader.js?api=https%3A%2F%2Fapp.octany.com%2Fwidget%2F1234&widget=01HXXXXXXXXXXXXXXXXXXXXXXX&lang=sv"
></script>

Ingenting renderas — inget felmeddelande, ingen tom container — när ett värde saknas eller är ogiltigt:

• type måste vara en av widgettyperna.
• account får bara innehålla siffror.
• widget måste vara 26 bokstäver och siffror.
• url måste, om den anges, vara https:// på octany.com eller en subdomän, utan sökväg, query eller inloggningsuppgifter. localhost är också tillåtet för utveckling.

Ett ogiltigt lang tas bort i stället för att stoppa hela embeden. Referensvärden saneras som ren text.

§ 01.7.7 Filter för utvecklare #

// Tillåt en staging-miljö av Octany utöver produktion.
add_filter('octany_domains', function (array $domains) {
    $domains[] = 'octany.test';

    return $domains;
});