Vgradnja
Naročnik doda eno vrstico kode; posodobitve widgeta pridejo samodejno
WordPress vtičnik (priporočeno)
- Prenesite ZIP vtičnika.
- V WordPressu: Vtičniki → Dodaj nov → Naloži vtičnik → namesti in aktiviraj.
- Nastavitve → A11y Cloud → vnesite licenčni ključ.
- V portalu dodajte domeno stranke med dovoljene domene.
Vtičnik ima nastavitveno stran, stikalo za vklop in samodejno preverjanje licence. Widget se posodablja prek /w.js, zato vtičnika ni treba posodabljati.
HTML / Wix / Shopify / statične strani
<script src="https://VASA-DOMENA/w.js?k=A11Y-XXXX-XXXX-XXXX" defer></script>
Vstavite v <head>. Ključ ni skrivnost — varnost temelji na dovoljenih domenah.
WordPress brez vtičnika (functions.php)
add_action('wp_enqueue_scripts', function () {
wp_enqueue_script(
'a11y-cloud',
'https://VASA-DOMENA/w.js?k=A11Y-XXXX-XXXX-XXXX',
array(), null, false
);
});Uporabite le, če ne želite namestiti vtičnika.
Lovable / React — komponenta
// src/components/A11yWidget.tsx
import { useEffect } from "react";
export function A11yWidget({ licenseKey }: { licenseKey: string }) {
useEffect(() => {
const s = document.createElement("script");
s.src = "https://VASA-DOMENA/w.js?k=" + encodeURIComponent(licenseKey);
s.defer = true;
document.head.appendChild(s);
return () => {
s.remove();
document.getElementById("a11y-cloud-root")?.remove();
};
}, [licenseKey]);
return null;
}
// v src/routes/__root.tsx znotraj layouta:
// <A11yWidget licenseKey="A11Y-XXXX-XXXX-XXXX" />Deluje v vsaki React aplikaciji (Lovable, Vite, Next). Widget riše svoj UI v Shadow DOM, zato ne vpliva na stile strani.
Verzionirane poti
| Pot | Pomen | Cache |
|---|---|---|
| /w.js | zadnja stabilna verzija | max-age=300 |
| /w-1.js | pripeta glavna verzija 1.x | max-age=3600 |
| /w.css | globalni stili nastavitev | max-age=300 |
Pri strogem CSP naročnika je treba dodati vašo domeno v script-src in style-src.