lightspeeddevelopment/lsx-geo-content

LSX Geo Content allows you to serve different content to users based on their locations. This is automatically-detected by checking the users IP address and the Protocol Version (v4 or v6) being used.

dev-master 2024-10-10 01:35 UTC

Requires

• php: >=7.2
• composer/installers: ^2.0.0

Requires (Dev)

• dealerdirect/phpcodesniffer-composer-installer: ^1.0.0
• phpcompatibility/phpcompatibility-wp: ^2.1.0
• phpunit/phpunit: ^8.5
• wp-coding-standards/wpcs: ^3.0
• wpackagist-plugin/tour-operator: ^1.4.1
• wpackagist-theme/lsx: ^3.0

GPL-3.0-or-later

README

LSX Geo Content

Welcome to the LSX Geo Content. The LSX Geo Content plugin detects your IP address and the Protocol Version (v4 or v6) used. Your country code is then determined using the downloaded DB from https://dev.maxmind.com. This is cached for 1 hour.

It is compatible with Caldera Forms plugin, as it allows to pre-populate content based on the location.

Description

The LSX Geo Content plugin detects your IP address and the Protocol Version (v4 or v6) used. Your country code is then determined using the downloaded DB from https://dev.maxmind.com. This is cached for 1 hour.

It is compatible with Caldera Forms plugin, as it allows to pre-populate content based on the location.

Shortcode

You can use any of the following inside a WordPress editor, or a shortcode enabled field.

``[geo_content countr"ZA"] You are in South Africa [/geo_content]

``[geo_content countr"US"] You are in the US [/geo_content]

Template Tags

Replace country code with the 2 digit country code.

• United States ## US
• United Kingdom ## GB
• South Africa ## ZA

<?php if ( lsx_geo_is_country( $country_code ) ) { // Do code } ?>

Caldera Forms

Add in one of the following custom CSS classes to the field you wish to pre-populate. The filters only work with the "text" and "dropdown" type classes.

• .lsx-geo-ip
• .lsx-geo-country
• .lsx-geo-region
• .lsx-geo-zip-code
• .lsx-geo-metro-code
• .lsx-geo-city
• .lsx-geo-latitude
• .lsx-geo-longitude

Nav Menu Filters

Firstly create a menu and assign it to a menu location. You will add a custom link to the menu and several child menu items, so it creates a drop down on the frontend.

• .lsx-geo
• .lsx-geo-parent
• .lsx-geo-default
• .lsx-geo-{country_code} e.g "lsx-geo-za"
• .lsx-geo-ex-{country_code} e.g "lsx-geo-ex-us"

Works with the LSX Theme

Our theme works perfectly with the Geo Content plugin.

It's free, and always will be.

We’re firm believers in open source - that’s why we’re releasing the Geo Content plugin for free, forever.

Support

We offer premium support for this plugin. Premium support that can be purchased via lsdev.biz.

Installation

1. Log in to your WordPress website (www.yourwebsiteurl.com/wp-admin).
2. Navigate to “Plugins”, and select “Add New”.
3. Upload the .zip file you downloaded and click install now.
4. When the installation is complete, Activate your plugin.
5. After installation, you can use the Geo content plugin with shortcakes or directly in to the code or caldera form.

Frequently Asked Questions

Where can I find the Geo Content plugin documentation and user guides?

For help setting up and configuring the Geo Content plugin please refer to our user guide

Where can I get support or talk to other users

For help with add-ons from LightSpeed, see our support package plan

Will the Geo Content plugin work with my theme

No; the Geo Content plugin will not work with any theme, it requires LSX Theme to make it match nicely. Please see our codex for help.

Where can I report bugs or contribute to the project?

Bugs can be reported either in our support forum or preferably on the to Search GitHub repository.

The to Search plugin is awesome! Can I contribute?

Yes you can! Join in on our GitHub repository :)

Like what you see?