General information

The plugin allows you to create one or more redirect rules for your website URLs.

Create a rule in the plugin settings panel at YITH Plugins > GeoIP Language Redirect.

Redirect rules

Each rule will apply to the selected country or, in case the reverse option is selected, it will apply to all countries except for the selected one.

For each rule, you just have to select the origin and the destination address choosing from custom URLs, posts or pages from your website.

By default, redirects are applied to “All devices”, but the plugin allows restricting the redirect only to Mobile or Desktop devices.

Choose the device to use for selected redirect

Read more here about how to create a new redirect rule.

Select the country from which IPs have to be redirected

Each rule has to be associated with a country: this means that only to users from the specified country will be redirected to the new destination URL.

Select country

It works the other way round if you check the option Country Excluded.

Exclude the country

If this option is enabled, users coming from everywhere but the selected country will be redirected. In the above screenshot, everyone will be redirected except for Italian IPs.

How to set up origin and destination URL on redirects

Select the origin page for the redirect rule in question.

Select origin to associate to the rule

You can make a redirect on:

  • the whole website
  • a custom URL (regular expressions included)
  • pages
  • posts
  • product pages
  • category pages
  • tag pages

Users can either be redirected to any page of your site or to a custom URL.

In the latter case, you can use the placeholder %path%, which allows you to retrieve the origin URL dynamically.

Let’s make an example to better understand.

I want that all Italian users landing to mysite.com are redirected to mysite.com/it

I will set up my rule as follows:

  • Origin URL: entire website
  • Destination URL:  %path%/it (this way, we will simply add “/it” to the URL that has been dynamically retrieved through the placeholder)

Placeholder

 

How to redirect users only the first time

On this page, you can read how to use the option “First time redirect” on the rule.

First time redirect

When users visit a certain page for the first time, a cookie is activated on their browser and they are redirected according to the rule settings.

From that moment until the cookie expires, if those users come to visit the same page again, they will not be affected by the redirect.

The cookie duration can be changed in the “Settings” tab in the plugin settings panel.

Cookie duration

 

 

 

How to exclude specific IPs from redirect

All the IP addresses you want to exclude have to be added in YITH Plugins > GeoIP Language Redirect > Settings.

Exclude Ip from redirect

Redirects will not apply to users who visit the website from any of the listed IPs.