[cfgeo]
[cfgeo]The Content (accept HTML)[/cfgeo]
Standard Geo Controller shortcode that retrieve geo information and also manipulate with content based on the geo informations.
Parameters
return – (accept: text) – this is return parameter that tell this plugin what information to retrieve. Return properties are:
- ip
- ip_version
- ip_number
- ip_server
- ip_dns_host
- ip_dns_provider
- isp
- isp_organization
- isp_as
- isp_asname
- is_local_server
- continent
- continent_code
- country
- country_code
- country_code_3
- country_code_numeric
- region
- region_code
- district
- city
- postcode
- address
- is_eu
- calling_code
- latitude
- longitude
- timezone
- timezone_offset
- timezone_abbreviation
- timestamp
- timestamp_readable
- current_date
- current_time
- currency
- currency_symbol
- currency_converter
- base_convert
- base_convert_symbol
- is_vat
- vat_rate
- browser
- browser_version
- platform
- is_mobile
- is_proxy
- is_spam
- is_tor
- limited
- gps
- error
- runtime
- status
- official_url
- credit
- version
exclude – (accept: comma separated text) – this parameter gives to shortcode new functionality. If you wrap some content with shortcode and add this parameter with continent, country, region, city name or code, it will hide that content from that setup locations. If location is not matched the content will be shown.
include – (accept: comma separated text) – this parameter gives to shortcode new functionality. If you wrap some content with shortcode and add this parameter with continent, country, region, city name or code, it will show that content from that setup locations. If location is not matched the content will be hidden.
default – (accept: text) – Default text that will be placed if some geo information missing or include/exclude parameter not matched location.
cache – (no values) – This is single property with no values. It was used for the cache support that forcing AJAX requests to get proper geo information. This shortcode can be also automatically added if cache setting is enabled.
- NOTE: -Cache in the some cases not work with include/exclude functionality but in many case it works normally.
- SOLUTION: -If include/exclude fail, we recommended using Geo Banner functionality
ip – (IP address v4 or v6) – This is otional property only. You can use it if you need to quickly check some IP address and retrieve geo information. Including IP property, you will only get information from the IP you provide in this property. In normal cases this is used only for the debugging or testing include/exclude functionality. It also spending your lookup per each refresh if you not using unlimited license.
Return
If attributes are not placed it return visitors IP address, otherwise it return geo information or content based on the geo location.
Transitional and deprecated shortcodes
For the last few years, we’ve been changing the functionality and names of shortcodes. This is a list of deprecated shortcodes that are still supported and working on the same way, but in some new versions can be completely removed.
- [cf_geo]
Examples
Return current visitor IP address:
[cfgeo]
Return only city name:
[cfgeo return="city"] We just found shoes in [cfgeo return="city"] that you can buy for 50% discount.
Return area code by custom defined IP address:
[cfgeo ip="11.23.176.12" return="area_code"]
Exclude some content from specific location
[cfgeo exclude="Toronto"] This text is seeing by everyone except Toronto people [/cfgeo]
Include content for the visitors from specific location:
[cfgeo include="New York, DE"] This text seeing only people from New York and Germany (DE) [/cfgeo]
Experimental BETA shortcode
[geo]
In addition to the standard shortcode, we also have an experimental shortcode that is identical to the one above, just to avoid possible complications with similar plugins, we put it to work as an experimental shortcode that may (but may not) replace the existing one in the future.