Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository

CF GeoPlugin

Create Dynamic Content, Banners and Images on Your Website Based On Visitor Geo Location By Using Shortcodes With CF GeoPlugin.

The CF GeoPlugin is FREE plugin which allows you to attach content, geographic information and Google maps to posts, pages, widgets and custom templates by using shortcodes and user IP address. It also lets you to specify a default geographic location for your entire WordPress blog. This plugin is also great for SEO and increasing conversions on your blog or landing pages.


This plugin is compatible with any Wordpress installation, also compatible with Contact Form 7 and support Cloudflare.

CF GeoPlugin 4.2.x Features

  • Geo Banner - Allows you to place dynamic content, images, videos and pages using shortcodes for specfic audience target by geo location
  • Geo Plugin - Allows you to attach geographical information inside your content
  • Google Map - Allows you to attach Google Map inside content
  • Geo Defender - Allows you to block acces on blog from specific location

Usage & Example

Basics usage and example:

[cf_geo return="region"]
[cf_geo ip="" return="area_code"]
[cf_geo exclude="Toronto"] This text is seeing by everyone except Toronto people [/cf_geo]
[cf_geo include="New York"] This text seeing only people from New York [/cf_geo]

Usage & Example

GEO PLUGIN: -Usage is simple. After installation and activation, in your post you just need to insert [cf_geo] shortcode and that's it. Enter a shortcode as this and it returns and display IP adress to a visitor. If you like to display region (for example California for users who are from California), you just need to use return attribute in your shortcode like this: [cf_geo return="region"]. By changing the return settings, you can display any information from list above. Each user who comes to the site will see information related to their area.

If you whant to track some custom IP and return some information from that IP, you can do that by adding one optional attribute ip like on example [cf_geo ip="" return="area_code"] what will return area code from that IP address.

If you like to ad default values to your shortcode if data is empty you need to add extra attribute in your shortcode like this example [cf_geo return="country_code" default="US"] what will return US if geoplugin can't locate country code.

GOOGLE MAP: -If you whant to place simple google map in your post or page, you just need to place shortcode [cf_geo_map] and your visitor will see own city on google map by default.

Like example, you can display own company street address inside Google map like this: [cf_geo_map longitude="-74.0059" latitude="40.7128" zoom="15"] and pointer will show your street and place where you work.

Google map also allow you to use HTML inside map and display info bar:

[cf_geo_map longitude="-74.0059" latitude="40.7128" zoom="15" title="My Company Name"] 
   <h3>My Company Name<h3> 
   <p>No Name Street 35, New York, USA</p> 
   <p>We have what you need</p> 

With this plugin you can easy setup your google map.

GEO BANNER: -With this plugin you have also ability to make a dynamic content (text, images, banners, videos...) and to target your messages to people from certain regions, track IP address, setup WordPress to work on user's timezone, etc. The possibilities are huge, you can increase conversions, use this plugin like support for your custom template, build your own plugin and use CF GeopLugin like additional option, etc.

You just need to create a new banner, place your content, select rules (country, region, city) save your banner, after that in your page pickup banner shortcode and place inside content.

Info & Contact

Please visit our website and fell free to contact us. We will provide for you all services what you need.

Also please inform us if any errors occure via contact form on our website with message subject: CF GEOPLUGIN SUPPORT

Thank you for your concern!

~ Your CF GeoPlugin Team

Author Ivijan-Stefan Stipic
Contributors ivijanstefan
Tags automatic banner, banner, block region, block spam, block visitors, business, contact form, conversion, conversion plugin, defender, dynamic keyword, exclude, exclude content, find ip, geo, geo banner, geo content. include content, geo image, geo target, geolocation, geoplugin, geotarget, gmap, gmaps, google map, include, ip, ip finder, ip location, local, location, market, marketing, position, positioning, region, seo, SEO tool, tag, target, user experience, ux plugin
  1. cf-geoplugin screenshot 1

    CF GeoPlugin Available shortcodes and values

  2. cf-geoplugin screenshot 2

    CF Google Map shortcodes and setup

  3. cf-geoplugin screenshot 3

    CF Geo Defender setup

  4. cf-geoplugin screenshot 4

    CF GeoPlugin global setup

  5. cf-geoplugin screenshot 5

    Debug Mode for CF GeoPlugin and IP Lookup

  6. cf-geoplugin screenshot 6

    Adding shortcode in text editor

  7. cf-geoplugin screenshot 7

    Admin bar quick links

  8. cf-geoplugin screenshot 8

    Example 1

  9. cf-geoplugin screenshot 9

    Example 2

  10. cf-geoplugin screenshot 10

    Example 3

You only need to install the CF GeoPlugin through the WordPress plugins screen directly or download ZIP file, unpack and upload plugin folder to the /wp-content/plugins/ directory.

Afterwards, activate the plugin through the 'Plugins' screen in WordPress, go to your area and use the Settings->CF GeoPlugin to see all available shortcodes and settings.


  • New Include/Exclude functionality
  • New Cloudflare functionality
  • New PHP developers function for getting geodata
  • New advanced DNS lookup
  • Added AJAX Option Saving


  • Fix bugs inside decodings


  • Fixed data insetration
  • Fixed IP session


  • Fixed issue with CF GeoBanner


  • Added new support for older version of WordPress
  • Changed some file hierarchy
  • Fixed uninstall issues


  • Added TinyMCE support
  • Fixed runtime display


  • Added new language support
  • Added no-conflict functionality
  • Fixed DNS Lookup
  • Added new translations


  • Switch on new CDN server


  • Fixed issue with WordPress versions below 4.4.0


  • Added new CDN service
  • Fixed premium plugin issue
  • Fixed Google Map issue


  • Removed all old services
  • Installed new CF GeoPlugin API service
  • Added compact dashboard
  • Added Geo Banner
  • Added error reporting
  • Added helpers and explanations
  • Added language support for translations
  • Added algorithm for Lazy Loading
  • Added DNS checker

Can I use CF GeopPlugin inside custom template?

Yes! You can! You just need to follow instructions from your admin panel area and use the Settings->CF GeoPlugin to see all available shortcodes and settings.

Can GeoPlugin slow down my site?

NO, CF GeoPlugin uses the asynchronous data reading from API services. After loading, all data is stored in a session. That session is stored until IP is changed. When user's IP changes, the plugin reads new data and stores in the new session.

Can I set the different value if shortcode shows no results?

YES, just add the attribute default in shortcode and corresponding text like this:

[cf_geo return="city" default="Your Default Text"]

How to include CF GeopPlugin in PHP?

In PHP you need to use WordPress function do_shortcode() like this example:

<?=do_shortcode('[cf_geo return="city"]'); ?>

How to use CF GeoPlugin inside ContactForm7?

Sometimes you need to include other HTML, CSS and JavaScript, and jQuery codes inside ContactForm7. Sometimes you need to insert a geolocation in input fields. This is not easy but here is one example with jQuery:

[text* city placeholder "* City Name"]

    var city = '[cf_geo return="city"]';

This code will auto fill value of CF7 city field when a visitor visits the contact page (look screenshots).

Are there any limitations on the number of lookup?

NO! CF GeoPlugin is made to provide minimum requests per user (1 request per session) and keep real information until IP is dynamicly changed or session expire.

Our new API are made to provide accurate information to our users 24/7 all days in year with no limitations for free*.

**NOTE: We reserve the right to change this decision in one moment and in the near future lookup for some specific information charge in monthly or annual basis. Please look Terms and Conditions in Other Notes.*

CF GeoPlugin don't display information

  • It might be an error with the provider's (geoPlugin, GeoBytes and Google Maps APIs) network or API and CF GeoPlugin can't display information by own.
  • Look inside CF GeoPlugin for all available shortcodes and settings,
  • Look inside CF GeoPlugin->Settings and enable/disable and check all options (SSL, proxy, etc),
  • Some people use a special software to hide IP address via proxy and geoplugin can't look deeper to get accurate location,
  • Look into error.log file to see if a problem is in CF GeoPlugin
  • Some servers not allow access to geoplugin sites and maby you need to use proxy setings inside plugin to enable tracking
  • You reach some API limitations

Please inform us if any of these errors occure via contact form on our website with message subject: CF GEOPLUGIN SUPPORT

Other Notes

Plugin Links


Enjoy using CF GeoPlugin? Please consider making a small donation to support the project's continued development.


Please read these Terms and Conditions ("Terms", "Terms and Conditions") carefully before using the website and the CF GeoPlugin WordPress application (the "Service") operated by CF GeoPlugin.

Your access to and use of the Service is conditioned on your acceptance of and compliance with these Terms. These Terms apply to all visitors, users and others who access or use the Service.

By installing CF GeoPlugin, accessing or using the Service you agree to be bound by these Terms. If you disagree with any part of the terms then you may not install, access and use the Service.

Purchases: CF GeoPlugin uses a combination of free services that return information about the locations. Some countries do not provide all information via IP and some providers use PROXY which can made this records inaccurate or some information missing. We work to bypass that but on this moment CF GeoPlugin has arround 95-98% of accuracy in all countries. America, Canada, United Kingdom, Australia, Germany and other bigger countries have arround 97-100% of accuracy. Also some shared hosting can't read client IP what made this plugin unusefull.

Therefore, WE DO NOT GUARANTEE that the plugin will work well on every WordPress installation, server and device. You use this plugin as it is, at your own risk and we have no responsibility for further problems or how they happen.

For now all lookup are free and with no limitations but we reserve the right to change this decision in the near future and lookup for some specific information charge in monthly or annual basis. If you wish to purchase premium version, monthly or annual plan for lookup you may be asked to supply certain information via Amazon, PayPal or Credit Card relevant to your Purchase. Premium version is designed to give you the option to change certain sensitive information, use more options and better content formatting and is charged only once. Monthly or annual plan enable all lookup unlimited in the purchase period.

Price for premium version is $32 once per website and you will get all options in plugin unlocked with new features. Monthly and annual plan unlocks special lookup for additional fields in the plugin that are locked. At any moment, you have the option to remove your subscription and stop using the plugin.

Content: Our Service allows you to post, link, store, share and otherwise make available certain information, text, graphics, videos, or other material ("Content"). We have no responsibility about your content.

Links To Other Web Sites: Our Service may contain links to third­party web sites or services that are not owned or controlled by CF GeoPlugin.

CF GeoPlugin has no control over, and assumes no responsibility for, the content, privacy policies, or practices of any third party web sites or services. You further acknowledge and agree that CF GeoPlugin shall not be responsible or liable, directly or indirectly, for any damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods or services available on or through any such web sites or services.

Changes: We reserve the right, at our sole discretion, to modify or replace these Terms at any time. If a revision is material we will try to provide at least 30 (change this) days' notice prior to any new terms taking effect. What constitutes a material change will be determined at our sole discretion.

Contact Us: If you have any questions about these Terms, please contact us.


We respect your privacy and take protecting it seriously. This Privacy Policy covers our collection, use and disclosure of information we collect through our website and service, owned and operated by CF GeoPlugin. It also describes the choices available to you regarding our use of your personal information and how you can access and update this information. The use of information collected through our service shall be limited to the purpose of providing the service for which our Clients have engaged us.

By using CF GeoPlugin you accept our privacy policy: CF GeoPlugin respects the privacy of the individuals who visit our website. No information regarding your personal information will be shared with 3rd parties.

Cookies: Using this plugin you can be registered by using cookies in your Web browser to anonymously collect statistical data regarding your visit, such as IP address, country, city, Web browser and other non-identifying data.

Advertisements: This plugin may display advertisements and CF GeoPlugin is not responsible for their content.

Use of user data: Any data left and collected with this plugin will can be used solely for statistical purposes and improvement of services we offer.

DART cookies: We may use DART cookies which are used to show advertisements based on your browsing history and they are part of the Google DoubleClick services. DART cookies are known as impersonalized cookies that cannot access your personal data such as phone number, credit card or other.

Content policy: All content on CF GeoPlugin is made by expert staff with extensive experience, often obtained in professional practice; all content on this plugin site is protected by copyright laws, and unauthorized selection, copying, arrangement, distribution is prohibited and may be punishable according to copyright law.Where copyright is infringed, the copyright owner may bring a legal action against the infringer to recover damages; “damages” is monetary compensation paid to the copyright owner for loss suffered in respect of the infringement.

Linked websites: Our content may contain links to other third-party websites beyond our control and therefore out of our policy.

Children’s privacy policy: CF GeoPlugin is perfectly safe for children above 13 years of age.

Disclaimer: We do not guarantee that procedures presented on CF GeoPlugin will work properly on your computer, smartphone or any other device. Success rate depends on operating system, user approach and expertise, and other factors therefore we accept no responsibility for any loss or damage, whether direct or indirect and however caused (including through negligence) that you may suffer in connection with your use of this site or any linked website.

For further questions and clarifications, do not hesitate to contact us and we will reply back to you within 48 hours.

Version 4.2.0

Requires WordPress version: 3.0 or higher

Compatible up to: 4.7.2

Last Updated 08 Feb 2017

Date Added: 21 Dec 2015

Plugin Homepage


5 stars
4 ratings


Not Enough Data

Works: 0
Broken: 0