Title: WP Engine GeoTarget
Author: WP Engine
Published: <strong>27 Tháng 2, 2015</strong>
Last modified: 3 Tháng 2, 2025

---

Tìm kiếm plugin

![](https://ps.w.org/wpengine-geoip/assets/banner-772x250.jpg?rev=1101492)

![](https://ps.w.org/wpengine-geoip/assets/icon-256x256.png?rev=1101492)

# WP Engine GeoTarget

 Bởi [WP Engine](https://profiles.wordpress.org/wpengine/)

[Tải về](https://downloads.wordpress.org/plugin/wpengine-geoip.1.2.9.zip)

 * [Chi tiết](https://vi.wordpress.org/plugins/wpengine-geoip/#description)
 * [Đánh giá](https://vi.wordpress.org/plugins/wpengine-geoip/#reviews)
 *  [Cài đặt](https://vi.wordpress.org/plugins/wpengine-geoip/#installation)
 * [Nhà phát triển](https://vi.wordpress.org/plugins/wpengine-geoip/#developers)

 [Hỗ trợ](https://wordpress.org/support/plugin/wpengine-geoip/)

## Mô tả

WP Engine GeoTarget integrates with the variables on your WP Engine site to display
content catered to the visitor’s location. With the ability to access variables 
from as broad as country to as specific as latitude and longitude, your website 
can now display geographically relevant content.

#### Geo-Marketing

 * Create marketing campaigns targeted only at certain locations.

#### Localization

 * Redirect incoming traffic to content in the local language or currency.
 * Businesses with local branches can direct customers to a relevant physical location
   or local microsite.

#### Ecommerce

 * Filter out merchandise or services that are not available in a certain locale.
 * Display country-specific shipping, tax, or sales information.

#### Legal Requirements

 * Filter required legal notices from countries for whom those notices may not be
   relevant.

#### * Please Note *

Customers on Premium and Enterprise plans can use this plugin at no additional cost.
If you are on another plan type and would like to use GeoTarget on one of your sites,
you can add it to your plan [here](http://wpengine.com/plans/?utm_source=wpengine-geoip).
This will not function outside of the WP Engine environment.

### Location Variable Shortcodes

You can use any of the following location variable shortcodes to return the various
geographic location the user is visiting your site from:

1) Continent: `[geoip-continent]`

2) Country: `[geoip-country]`

3) Region: `[geoip-region]`

 * In the US region will return States
 * In Canada region will return Provinces
 * Outside the US/CA this will return a Region number. Please note region numbers
   are not unique between countries

4) City: `[geoip-city]`

5) Postal Code: `[geoip-postalcode]`

 * This variable is only available in the US due to limitations with the location
   data GeoTarget uses

6) Latitude: `[geoip-latitude]`

7) Longitude: `[geoip-longitude]`

8) Location: `[geoip-location]`

#### ví dụ

    ```
    Hi, and welcome to [geoip-city]! The place to be in [geoip-region],[geoip-country].
    ```

A visitor from Austin, Texas would see the following:
 Hi, and welcome to Austin!
The place to be in TX, US.

### Localized Content

    ```
    [geoip-content country="US"]Your US specific content goes here[/geoip-content]
    ```

The content shortcode allows you to hide or show specific content based on visitor
geographies:

Below are all the supported geography options, this allows to you SHOW content for
only specific locations:

 * continent
 * country
 * areacode
 * region
 * city
 * postalcode

Below are all the supported negative geography options, this allows to you HIDE 
content for only specific locations:

 * not_continent
 * not_country
 * not_areacode
 * not_region
 * not_city
 * not_postalcode

#### Examples of the Content Shortcode

This will display “Content just for US visitors” strictly for visitors viewing from
the United States.

    ```
    [geoip-content country="US"] Content just for US visitors [/geoip-content]
    ```

This will display “Content just for everyone in Texas and California” strictly for
visitors from Texas and California.

    ```
    [geoip-content region="TX, CA."] Content just for everyone in Texas and California [/geoip-content]
    ```

You can mix and match geography and negative geography options to create verbose
logic in a single shortcode:

    ```
    [geoip-content country="US" not_city="Austin"]Content for US visitors but not for visitors in Austin[/geoip-content]
    ```

#### Limitations

There is a single limitation in the logic that lets you filter content for multiple
geographic areas.

You can progressively limit the area that content is shown in. But once your content
is hidden from an area, a subset of that area can’t be added back in.

For example,
 If I limit my content to Europe, then limit my content from Great 
Britain, I can’t go back and show it to London.

#### Creative Work Arounds

### Limit content to some regions of a country (or some cities of a state)

You want to show an offer for free shipping to every state in the US _but_ Alaska
and Hawaii. You may be inclined to write something like

**BAD**

    ```
    [geoip-content country="US" not_state="AK, HI"]Lorem ipsum dolor sit amet[/geoip-content]
    ```

Instead, show it to all other 48 states

**GOOD**

    ```
    [geoip-content state="AL, AZ, AR, CA, CO, CT, DE, FL, GA, ID, IL, IN, IA, KS, KY, LA, ME, MD, MA, MI, MN, MS, MO, MT, NE, NV, NH, NJ, NM, NY, NC, ND, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VT, VA, WA, WV, WI, WY"]Free shipping on all orders over $50![/geoip-content]
    ```

### Duplicate location names

You want to show discount airfare on a flight to Paris, France. The content should
show to all of the US and France, but not Paris itself.

**BAD**

    ```
    [geoip-content country="US, FR" not_city="Paris"]Fly to Paris for only $199![/geoip-content]
    ```

The problem here is that Paris, Texas will be hidden. The solution? Just have two
geoip-content shortcodes.

**GOOD**

    ```
    [geoip-content country="FR" not_city="Paris"]Fly to Paris for only $199![/geoip-content][geoip-content country="US"]Fly to Paris for only $199![/geoip-content]
    ```

### Adding an area into an omitted region

You want to show an ad written in Spanish to all of South America except for Brazil.
Brasilia, however, has enough Spanish speakers that you want to include Brasilia.

**BAD**

    ```
    [geoip-content continent="SA" not_country="BR" city="Brasilia"]Lorem ipsum dolor sit amet[/geoip-content]
    ```

**GOOD**

    ```
    [geoip-content continent="SA" not_country="BR"]Venta de la Navidad en los adaptadores USB[/geoip-content]



    [geoip-content city="Brasilia"]Venta de la Navidad en los adaptadores USB[/geoip-content]
    ```

### Calculate distance between points

You have a utility function that will calculate the distance from your provided 
lat/lng coordinate to the visitor’s location in either miles or kilometers. This
can be useful for determining approximate distances, as results may be cached at
the state or country level, depending on your configuration.

Example use:

    ```
    $latitude  = 30.268246;
    $longitude = -97.745992;
    $geo = WPEngine\GeoIp::instance();
    if ( false !== $geo->distance_to( $latitude, $longitude ) ) {
        $miles_to_wp_engine = $geo->distance_to( $latitude, $longitude );
    }
    ```

### Testing Parameters

You can use the following URL parameters to test how your localized content will
appear to visitors from various geographic locations. You can add any of the parameters
below to any URL of a page using the GeoTarget shortcodes or API calls:

Spoof visitor from the state of Texas:

    ```
    yourdomain.com/?geoip&region=TX
    ```

Spoof visitor from the United States:

    ```
    yourdomain.com/?geoip&country=US
    ```

Spoof visitor from Austin, Texas

    ```
    yourdomain.com/?geoip&city=Austin
    ```

Spoof visitor from the U.S. zip code 78701:

    ```
    yourdomain.com/?geoip&zip=78701
    ```

Please note: full page redirects and TLD redirects still need to be implemented 
with the necessary API calls.

## Ảnh màn hình

 * [[
 * Authoring a new post with GeoTarget shortcodes
 * [[
 * An example post using GeoTarget shortcodes

## Cài đặt

 1. Upload `wpengine-geoip` to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress

Please view the ‘Other Notes’ tab to see all of the available GeoTarget shortcodes

## Hỏi đáp

1) Will this work outside of the WP Engine hosting account?

No, this will only work within the WP Engine environment. This will not work for
sites hosted on other web hosts.

2) Are there any other restrictions to using this plugin?

Yes. On Startup, Growth, and Scale plans the GeoTarget feature is available as an
add-on. For Business and Premium plans or once you have added the GeoTarget add-
on you will need to reach out to the [Support Team](https://my.wpengine.com/support)
to fully enable GeoTarget for your site.

You can read our full GeoTarget activation guide [here](https://wpengine.com/support/geoip-personalizing-content-based-geography/).

3) What variables do I have access to?

Continent, country, state, city, zip, latitude, longitude.

4) How do I sign up for a WP Engine Account?:

That’s easy! [Signup here](http://wpengine.com/plans/?utm_source=wpengine-geoip).

5) I installed the plugin and used a shortcode or API call and it isn’t working.

Please contact the WP Engine [Support Team](https://my.wpengine.com/support).

## Đánh giá

![](https://secure.gravatar.com/avatar/a0acb93e28a6a0a948c830dbf3ff3ea2b5857beb8ed2ae90cc95386415427eaa?
s=60&d=retro&r=g)

### 󠀁[Works as advertised.](https://wordpress.org/support/topic/works-as-advertised-903/)󠁿

 [matthewstroh](https://profiles.wordpress.org/matthewstroh/) 16 Tháng 5, 2024

Most of the 1-star reviews for this plugin are from people who feel that the plugin
is “misleading” in that it’s only for WP Engine customers. Note that it’s not called“
WP GeoGarget”. It’s not misleading in that the very first sentence on the Details
tab of the plugin says… “WP Engine GeoTarget integrates with the variables on your
WP Engine site to display content catered to the visitor’s location.”For WP Engine
customers, it works perfectly. I’m a little worried that it hasn’t been tested with
the latest 3 major releases of WordPress. That’s my reason for a 4-star rating. 
I’m worried it will break and I’ll have a communications emergency on my hands.

![](https://secure.gravatar.com/avatar/122109d1a3c4318f3538a76af57f6cfe8e3a1314c8db8a18c78e389c3648ab9c?
s=60&d=retro&r=g)

### 󠀁[$](https://wordpress.org/support/topic/16929123/)󠁿

 [vaikis](https://profiles.wordpress.org/vaikis/) 28 Tháng 7, 2023

needs money

![](https://secure.gravatar.com/avatar/d525fa3771b5fe8309985eb7cfbf64994f2627181bf6e7d36c3ea9c453a0ac58?
s=60&d=retro&r=g)

### 󠀁[Misleading](https://wordpress.org/support/topic/misleading-78/)󠁿

 [amjoxe](https://profiles.wordpress.org/amjoxe/) 27 Tháng 10, 2021

Another plugin does not work unless with monthly $$$

![](https://secure.gravatar.com/avatar/dd69a226c5cafb59944b8c83f4c8b9c45397031a023e82d620a39c9ee6a22105?
s=60&d=retro&r=g)

### 󠀁[ONLY for WPEngine Customers](https://wordpress.org/support/topic/only-for-wpengine-customers/)󠁿

 [ayersc3](https://profiles.wordpress.org/ayersc3/) 24 Tháng 1, 2020

In the description the plugin states, “This will not function outside of the WP 
Engine environment.” If you are NOT a WP Engine customer – hosting your WP website
with them – this plugin WILL NOT work. I confirmed with WP Engine sales.

![](https://secure.gravatar.com/avatar/14a56eb5d25af5b62f0f5e10d13b51268ec14c155b0e662cf1c7dabd26653129?
s=60&d=retro&r=g)

### 󠀁[Plugin does not work as expected](https://wordpress.org/support/topic/plugin-does-not-work-as-expected/)󠁿

 [artifex404](https://profiles.wordpress.org/artifex404/) 6 Tháng 3, 2019

After having spent few hours trying to work the plugin’s WPEngine\GeoIp::distance_to()
method I found that the code has logical bug which caused the return of wrong values.
For a product WP Engine is charging $30 / month this is not acceptable. I contacted
the WP Engine support, but they said they do not offer development support, hmmm,
okay!

![](https://secure.gravatar.com/avatar/bfdd92d0d89af2f98ae5a1105c3ad712af7bf9c9bfecc757c010de3fc0b6f7ea?
s=60&d=retro&r=g)

### 󠀁[On their plan only?](https://wordpress.org/support/topic/on-their-plan-only/)󠁿

 [Savemi](https://profiles.wordpress.org/savemi/) 3 Tháng 9, 2016 1 trả lời

Damn. This is exactly what we need, but cant use it with our hosting.

 [ Đọc tất cả 15 đánh giá ](https://wordpress.org/support/plugin/wpengine-geoip/reviews/)

## Người đóng góp & Lập trình viên

“WP Engine GeoTarget” là mã nguồn mở. Những người sau đã đóng góp vào plugin này.

Những người đóng góp

 *   [ WP Engine ](https://profiles.wordpress.org/wpengine/)
 *   [ markkelnar ](https://profiles.wordpress.org/markkelnar/)
 *   [ Steven Word ](https://profiles.wordpress.org/stevenkword/)
 *   [ stephenlin ](https://profiles.wordpress.org/stephenlin/)
 *   [ ryanshoover ](https://profiles.wordpress.org/ryanshoover/)
 *   [ Taylor McCaslin ](https://profiles.wordpress.org/taylor4484/)
 *   [ Nate Gay ](https://profiles.wordpress.org/nateinaction/)

[Dịch “WP Engine GeoTarget” sang ngôn ngữ của bạn.](https://translate.wordpress.org/projects/wp-plugins/wpengine-geoip)

### Muốn tham gia phát triển?

[Duyệt code](https://plugins.trac.wordpress.org/browser/wpengine-geoip/), check 
out [SVN repository](https://plugins.svn.wordpress.org/wpengine-geoip/), hoặc theo
dõi [nhật ký phát triển](https://plugins.trac.wordpress.org/log/wpengine-geoip/)
qua [RSS](https://plugins.trac.wordpress.org/log/wpengine-geoip/?limit=100&mode=stop_on_copy&format=rss).

## Nhật ký thay đổi

#### 1.2.9

 * Updates are now served from WP Engine servers when installed directly. This does
   not apply to WordPress.org installs.
 * Local development fixes.
 * Fix for `wp_localize_script` being called without expected parameter type.
 * Bump for WP 6.6 compatibility.

#### 1.2.8

 * Fix for development sites that call the `continent` method
 * Bump for WP 5.5 compatibility

#### 1.2.7

 * Optimize plugin name rename loop
 * Bump for WP 5.2 compatibility

#### 1.2.6

 * Bump for WP 5.0 compatibility

#### 1.2.5

 * Fix for anchor tag escaping in admin notice
 * Fix issue with code blocks in readme

#### 1.2.4

 * Updating branding to GeoTarget
 * Readme update

#### 1.2.3

 * Bumps version number for WP 4.9 compatibility
 * Updates shortcode usage examples

#### 1.2.2

 * We’re escaping our output. AND we’re escaping our output in a way where the code
   will actually work!
 * We’ve also gotten rid of any bleeding-edge JavaScript. Sure, it’s cool. But a
   plugin that works for everybody is even cooler.

#### 1.2.1

 * When you dismiss the notice on development websites, it stays dismissed. Like
   it should.
 * The readme’s code blocks actually have code in them now. Because what’s the sense
   of a code block without code in it?

#### 1.2.0

 * Adds a utility function for calculating distances
 * Bumps version number for WP 4.5 compatibility

#### 1.1.3

 * Bumps version number for WP 4.4.2 compatibility

#### 1.1.2

 * Fixes logic for nested parameter selectors in content shortcode
 * Now supports nested shortcodes. You can use shortcodes inside the [geoip-content]
   shortcode
 * Updated Documentation
 * Bumps version number for WP 4.3 compatibility

#### 1.1.1

 * Fixes logic for negated parameters in content shortcode
 * Allows the plugin to run on development sites

#### 1.1.0

 * Adds continent shortcode
 * Adds content shortcode for localized geographic content
 * Adds testing parameters to spoof visitor location
 * Bumps version number for WP 4.2.2 compatibility

#### 1.0.2

 * Renames longitude environment variable
 * Bumps version number for WP 4.2 compatibility

#### 1.0.1

 * Changes to readme.txt

#### 1.0.0

 * Initial release

#### 0.7.0

 * Removes plugin dependency management artifacts

#### 0.6.0

 * Add shortcodes for postal code, latitude and longitude.

#### 0.5.0

 * Adds shortcodes for city, region, and country.
 * Displays admin notice when GEOIP environment variables are absent.
 * Formatting updates to readme and file headers.

#### 0.4.0

 * Code cleanup for WordPress coding standards and white space.

#### 0.3.0

 * Change action to react at ‘init’.

#### 0.2.0

 * Add static function and singleton construction.

#### 0.1.0

 * Initial version

## Meta

 *  Phiên bản **1.2.9**
 *  Cập nhật lần cuối **1 năm trước**
 *  Số lượt cài đặt **300+**
 *  Phiên bản WordPress ** 3.0.1 hoặc cao hơn **
 *  Đã kiểm tra lên đến **6.7.5**
 *  Ngôn ngữ
 * [English (US)](https://wordpress.org/plugins/wpengine-geoip/)
 * Thẻ
 * [GeoIP](https://vi.wordpress.org/plugins/tags/geoip/)[geotarget](https://vi.wordpress.org/plugins/tags/geotarget/)
   [localization](https://vi.wordpress.org/plugins/tags/localization/)[wpe](https://vi.wordpress.org/plugins/tags/wpe/)
   [wpengine](https://vi.wordpress.org/plugins/tags/wpengine/)
 *  [Nâng cao](https://vi.wordpress.org/plugins/wpengine-geoip/advanced/)

## Đánh giá

 3.6 trên 5 sao.

 *  [  9 5-star reviews     ](https://wordpress.org/support/plugin/wpengine-geoip/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/wpengine-geoip/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/wpengine-geoip/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/wpengine-geoip/reviews/?filter=2)
 *  [  5 1-star reviews     ](https://wordpress.org/support/plugin/wpengine-geoip/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/wpengine-geoip/reviews/#new-post)

[Xem tất cả đánh giá](https://wordpress.org/support/plugin/wpengine-geoip/reviews/)

## Những người đóng góp

 *   [ WP Engine ](https://profiles.wordpress.org/wpengine/)
 *   [ markkelnar ](https://profiles.wordpress.org/markkelnar/)
 *   [ Steven Word ](https://profiles.wordpress.org/stevenkword/)
 *   [ stephenlin ](https://profiles.wordpress.org/stephenlin/)
 *   [ ryanshoover ](https://profiles.wordpress.org/ryanshoover/)
 *   [ Taylor McCaslin ](https://profiles.wordpress.org/taylor4484/)
 *   [ Nate Gay ](https://profiles.wordpress.org/nateinaction/)

## Hỗ trợ

Có điều gì muốn nói? cần giúp đỡ?

 [Xem diễn đàn hỗ trợ](https://wordpress.org/support/plugin/wpengine-geoip/)