Download the PHP package pixelant/pxa-site-choice-recommendation without Composer
On this page you can find all versions of the php package pixelant/pxa-site-choice-recommendation. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pixelant/pxa-site-choice-recommendation
More information about pixelant/pxa-site-choice-recommendation
Files in pixelant/pxa-site-choice-recommendation
Package pxa-site-choice-recommendation
Short Description Suggest localized version of site depends on user location and user language.
License GPL-2.0+
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package pxa-site-choice-recommendation
Site choice recommendation
What does it do?
Suggest localized version of site depends on user location and user language. It will show bar on top of the page with possibility to choose site language. Select box options are sorted by priority calculated by checking user location and accept language.
Note: To get option based on user location, a EventListner needs to be created in a separate extension.
How to install it
Like a regular extension you need to do a few steps.
- Composer install
composer require pixelant/pxa-site-choice-recommendation - Go to extension manager to isntall extension.
- Include TypoScript. There are two options to include:
- Site choice recommendation - default configuration required for extension to work
- Site choice JS and CSS assets - will include Js and Css libs
Extension plugins
Extension has two plugins:
- Choice bar extension - Loaded by ajax to propose user to change site version. Can't be added on a page.
- Site choice recommendation splash page - Use as page content in order to show for user ALL available choices. Just select corresponding site choice configuration in order to show it's options.
How to create site choice configuration
Create new record "Site Choice Configuration". It could be created in any storage folder. "Site Choice Configuration" tabs: Main "General" tab:
- Name - just whatever you want
- Connect to sites - choose rootpages where bar should appear
- Max Items - maximum items in select box in bar
- Splash pages links - splash page link for every root page. Each root page might have it's own splash page.
"Choices" tab include available site choices for bar and splash page. Each site choice require next configration fields:
-
Title - title of choice. It's text area because it could have different versions(localizations) of title. You could specify different localization versions each in new row in a format "Title text|locale":
- Flag - flag icon to show in select box and splash page
- Select country - select country. This field represents ISO code (for ex. "us" for USA). This code will be used when check if choice match by user IP. ISO codes
- Select language - select language from list. This field represents short ISO code (for ex. "en" for English). This code will be used for check by user language.
- Link - if choice target to external url
- Language layer - if choice should lead to site langauge layer. Link need to be empty if language layer is used.
Expected results
After TypoScript is included and Site Choice Configuration is connected to root page, you should get bar with proposal of best matching country / region based on location. Note: bar will remain invisible in case you already has visited website localization version that best match you location/language.
Enable choices based on user location
Extension has "built in" support to suggest options based on user location.
To enable it, you will need to create a EventListner in a separate extension and also download GeoLite2-Country.mmdb from MaxMind, available from https://www.maxmind.com.
Example:
1. Registering the event listener
Following is an example of how to enable the IPDetecor.
In file your_extension_name/Configuration/Services.yaml file add following:
2. The event listener class
Create file your_extension_name/Classes/EventListener/IpDetectorFactoryEvent.php file add following:
3. GeoLite2-Country dababase
Download GeoLite2-Country.mmdb from MaxMind and save in folder: your_extension_name/Resources/Private/GeoIp2/GeoLite2-Country.mmdb.
