isra00/swahili-geodetect-polylang

Pain point: users in Swahili speaking countries use browsers in English, so Accept-based language detection is broken for them. Solution: this plug-in that overrides Polylang's language detection setting the language = Swahili for users geo-located in Swahili-speaking countries. If a user does not come from a Swahili-speaking country, continue with the usual Polylang language detection logic. This is a Wordpress plug-in that overrides Polylang's default language detection (based on user agent's Accept-Language header) setting the language = Swahili for users geo-located in Swahili-speaking countries, since they usually have the user-agent in English. If the user does not come from a Swahili-speaking country, continue with the usual Polylang language detection logic. ## How to install 1. Clone this repo into `wp-content/plugins/swahili-geodetect-polylang`. 2. Run `composer install`. 3. Download MaxMind's GeoLite2 Country database and name it `GeoLite2-Country.mmdb`. To download it you need a MaxMind API Key, then you can head to a link like this: `download.maxmind.com`. 4. Enable the plugin "Swahili Geo-detect for Polylang" in the plugins section of WP Admin panel. ## FAQ #### Q: Will this plugin be of any use if I don't use Polylang? A: No #### Q: Will this plugin be of any use if I don't expect or care about Swahili speakers? A: No #### Q: Which countries are detected as Swahili speakers? A: Kenya and Tanzania. If you want me to include Congo, please open an issue asking for it. #### Q: Why is `GeoLite2-Country.mmdb` not included in the repo? A: its license does not allow to redistribute the files. #### Q: Why don't you distribute this plugin through Wordpress official plugin repository? A: it would be pointless given the complexity of the installation.