Download the PHP package bw/stand-with-ukraine-bundle without Composer
On this page you can find all versions of the php package bw/stand-with-ukraine-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bw/stand-with-ukraine-bundle
More information about bw/stand-with-ukraine-bundle
Files in bw/stand-with-ukraine-bundle
Package stand-with-ukraine-bundle
Short Description A Symfony bundle that provides StandWithUkraine banner and has some built-in features to block access to your resource for Russian-speaking users
License MIT
Informations about the package stand-with-ukraine-bundle
StandWithUkraineBundle
На русском? Смотри README.ru.md
This bundle provides a built-in StandWithUkraine banner for your Symfony application and has some features to block content for Russian-speaking users. Why? Great question! There is a war in Ukraine right now. You can read more about it here.
The initial idea of this bundle is to push Russian-speaking people to think! Almost all Russian media are not independent anymore and spread fake news to their users about what is happening in the world and even in their own country. Everybody has a choice. You can choose different sources in different languages to read the news from many other independent and trusted media around the world, don't limit yourself with Russian language and Russian media only.
Features
Some features included in this bundle:
- Display "StandWithUkraine" banner to show that your website stands united with the people of Ukraine.
- Block content for users who have the preferred language in
Accept-Language
request header set toru
. Basically, affects people who read most of the content in Russian language. Users would be able to access the content only after changing their preferred language to any other language. They still can keep Russian language, but as a secondary one. - Block content for users who are trying to get access from Russian IP addresses, i.e. accessing the content from Russia. Users would be able to access the content only after connecting via a VPN client choosing a location different from Russia region there. It makes things less convenient probably, but if you're using a good VPN client - you get better security, especially if you're connecting from public Wi-Fi spots or do not trust your internet provider.
Installation
Install with Composer:
Then, enable the bundle if you don't use Symfony Flex:
And then activate/deactivate event subscribers in its configuration.
Configuration
Configuration is optional, all options have defaults. But if you want to change it - create
a config file config/services/stand_with_ukraine.yaml
and tweak it. Below you can find
the full configuration example with the default values:
Or you can see it in your terminal, just run:
Testing
For testing purposes, you can easily simulate bad requests to test things manually
on your website in an easy way. To overwrite the actual country code with ru
, use
swu_overwrite_country_code_ru
query parameter, i.e:
https://127.0.0.1:8000/?swu_overwrite_country_code_ru=yes
Also, you can overwrite preferred language with ru
as well, use
swu_overwrite_preferred_lang_ru
query parameter, i.e:
https://127.0.0.1:8000/?swu_overwrite_preferred_lang_ru=yes
The system will thinks that you're sending requests from a Russian IP address or with Russian preferred language correspondingly and behave accordingly your configuration.
That's it!
Thanks for using this bundle! Feel free to create an issue or send a PR if you have any ideas how to improve it. And if you like it - please, share!
All versions of stand-with-ukraine-bundle with dependencies
symfony/dependency-injection Version ^5.4|^6.0
symfony/event-dispatcher Version ^5.4|^6.0
symfony/http-foundation Version ^5.4|^6.0
symfony/http-kernel Version ^5.4|^6.0
symfony/translation Version ^5.4|^6.0
symfony/twig-bundle Version ^5.4|^6.0
twig/twig Version ^3.3