With IP Locator, you can output the following items via shortcodes:
To render the IP address detected by IP Locator, use the following shortcode:
To render the country code detected by IP Locator, use the following shortcode:
To render the country name detected by IP Locator, use the following shortcode:
language parameter can be omitted. If so, the country name will be outputted in the visitor language. Otherwise you can specify the following values:
self: renders the country name in the main language of the country;
- a locale id (like
fr_CA): renders the country name in the specified language.
Example, if the detected country is Sweden (country code
Швецияif the user language is
To render the flag of the country detected by IP Locator, use the following shortcode:
[iplocator-flag type="" class="" style="" id="" alt=""]
If you omit all parameters, the flag will be rendered as an emoji but, if you want to render it as an image you have to specify the type as follow:
"image": the flag with a 4:3 w/h ratio
"squared-image": the flag with a 1:1 w/h ratio
To control how the image is rendered, you can specify the following attributes of the image tag:
class: the css class name(s), for example
style: the css style, for example
id: the css id, for example
alt: the alternative text, for example
"this is a country flagr"
IP Locator tries, for each detected country, to "infer" its main language. It isn't an "error-proof" method (as many countries have more than one official language), but it gives significantly good results. To render this language name, use the following shortcode:
language parameter can be omitted. If so, the language name will be outputted in the visitor language. Otherwise you can specify the following values:
self: renders the language name in its own language;
- a locale id (like
fr_CA): renders the language name in the specified language.
Example, if the detected language is Swedish (country code
suecoif the user language is
You can choose to show or hide something, regarding the detected country and/or language. To do so, use the following shortcode:
[iplocator-if country="" not-country="" lang="" not-lang="" do=""] A string or a shortcode [/iplocator-if]
do can be
"show" (to display "A string or a shortcode") or
"hide" (to not display "A string or a shortcode").
not-lang may contain one or more parameters (comma separated) and are cumulative (ie. you can use several of them). You can use any lang identifier or country code.
Note shortcodes can be nested only if they have not the same name (that's a WordPress limitation).
[iplocator-if lang="EN" do="show"] something in english [/iplocator-if]outputs the string "something in english" only for countries having english as main language,
[iplocator-if country="FR,BE,CA" do="show"] [iplocator-flag] [/iplocator-if]outputs flags only if detected country is France, Belgium or Canada,
[iplocator-if not-country="00,A1" do="show"] you're identified [/iplocator-if]outputs the string "you're identified" for everyone except undetected or behind anonymous proxies users,
[iplocator-if not-country="FR" not-lang="EN" do="hide"] something [/iplocator-if]do not output the string "something" for everyone except for French visitors and English-speaking countries ,
[iplocator-if country="A0" do="hide"] Hello, stranger! [/iplocator-if]outputs the string "Hello, stranger!" for everyone who are not on the local network,
PHP Intl extension needs to be activated on your server if you want to use names translation. If this extension is not installed, output of country name and language name will always be in english.
IP Locator uses the ISO 3166-1 alpha-2 standard to handle country codes. This means all the currently defined country codes are supported.
In addition to these codes, IP Locator uses some special codes to handle specific uses-cases:
00: when IP Locator is definitely unable to detect what is the source IP;
01: when source IP is the loopback IP (
::1) which means client and webserver are on the same host;
A0: when the source IP is on a private range which means client and webserver are on the same local area network;
A1: when the source IP is unresolvable because the client is behind an anonymous proxy;
A2: when the source IP is from a satellite provider - stratosphere is not a country 😉
Note for the five codes below, the current language is arbitrary set to
If you think this documentation is incomplete, not clear, etc. Do not hesitate to open an issue and/or make a pull request.
Do you want to make IP Locator a better plugin or improve its API? Whether you are a developer or not, you can help me to do it...
Support & Help
I’ll be glad to help you if you encounter issues with this plugin. Just use the support section of the WordPress directory.