Frequently Asked Questions¶
General¶
What is OSGEO-Inject?¶
OSGEO-Inject is a lightweight JavaScript widget that displays OSGeo affiliation badges and announcements on participating project websites.
Is it free to use?¶
Yes, OSGEO-Inject is open source software licensed under the MIT license.
Which projects can use it?¶
Any official OSGeo community project, incubating project, or affiliated project can use OSGEO-Inject after being onboarded.
Technical¶
Why isn't the badge showing?¶
- Check CORS: Your domain must be whitelisted
- Check HTTPS: The badge only works on HTTPS sites
- Check Console: Look for JavaScript errors
- Check Script Tag: Ensure the script is loading
Can I use it on localhost?¶
Yes, localhost is whitelisted for development purposes.
Does it affect page performance?¶
No. The badge: - Loads asynchronously (doesn't block rendering) - Has a tiny footprint (< 15KB total) - Caches aggressively (1 hour for announcements)
Is it accessible?¶
Yes. The badge is WCAG 2.1 AA compliant with: - Keyboard navigation support - Screen reader compatibility - High contrast support - Reduced motion support
Does it track users?¶
The badge sends a single, anonymous tracking request to Matomo containing: - Page URL and title - Hostname - Timestamp
No personal information is collected.
Troubleshooting¶
Badge appears but no announcement¶
The announcement may have expired or not been set. Contact administrators.
Badge is behind other elements¶
Add CSS to increase the z-index:
Badge conflicts with my site's CSS¶
Use more specific selectors or override CSS variables.
How do I get my project onboarded?¶
Contact the OSGEO-Inject administrators with: - Your project name - Your domain(s) - A brief description
Support¶
Where can I get help?¶
How can I contribute?¶
See our Contributing Guide.