=== Geo Controller GPS extension  ===
Contributors: ivijanstefan, creativform
Donate link: https://www.buymeacoffee.com/ivijanstefan
Tags: gps, geolocation, cf-geoplugin, geo-controller, geocoding
Requires at least: 6.0
Tested up to: 6.6
Requires PHP: 7.0
Stable tag: 2.1.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Enable GPS lookup for the Geo Controller plugin and collect geodata from mobile visitors. 

== Description ==

With the Geo Controller GPS Module, users of Geo Controller can track visitors using GPS, enabling accurate location tracking for mobile visitors and resolving location errors effectively.

This plugin integrates seamlessly with Geo Controller, leveraging GPS data to enhance the accuracy of geolocation tracking. By using this module, you can ensure that mobile visitors are precisely located, improving the overall functionality of your geolocation services.

== Installation ==

To utilize the Geo Controller GPS Module, follow these detailed steps:

1. **Prerequisites:**
   - Ensure that you have **[Geo Controller](https://wordpress.org/plugins/cf-geoplugin/)** installed and activated.
   - Verify that you have a valid license (Personal, Freelance, or Business) for Geo Controller.
   - Enable the [Geocoding API](https://developers.google.com/maps/documentation/javascript/geocoding) on your Google Cloud account.
   - Obtain a valid [Google Map API Key](https://developers.google.com/maps/documentation/javascript/get-api-key).

2. **Installation:**
   - Download the Geo Controller GPS Module from the [WordPress Plugin Directory](https://wordpress.org/plugins/cf-geoplugin-gps/).
   - Navigate to your WordPress dashboard.
   - Go to `Plugins > Add New`.
   - Click on the `Upload Plugin` button.
   - Select the downloaded plugin file (`cf-geoplugin-gps.zip`) and click `Install Now`.
   - Once the installation is complete, click `Activate Plugin`.

3. **Configuration:**
   - No additional configuration is required. The plugin automatically integrates with Geo Controller and starts working immediately.
   - The plugin utilizes the Geo Controller API and Google Geocoding API to deliver precise GPS data, ensuring accurate location tracking.
   
= On uninstall =

When you choose to uninstall the Geo Controller GPS extension, it's important to be aware that all data associated with the plugin will be permanently deleted from your WordPress installation. This includes the plugin's setup, license, and any other changes that you have made using the plugin. The plugin will clean everything from your database, and this process is irreversible, meaning that you will not be able to retrieve or restore any of the data that was generated by the plugin. So before you proceed with the uninstallation, it's important to make sure that you have a backup of any important data that you want to keep, or you have an alternative way to store the data.

== Detailed Steps ==

1. **Geo Controller Setup:**
   - If you haven't already, install and activate the **[Geo Controller](https://wordpress.org/plugins/cf-geoplugin/)** plugin.
   - Purchase and activate a valid license according to your needs (Personal, Freelance, or Business).

2. **Google API Configuration:**
   - Log in to your Google Cloud Platform account.
   - Navigate to the API & Services dashboard.
   - Enable the Geocoding API.
   - Navigate to `Credentials` and create a new API key.
   - Restrict the API key to your website's domain for added security.

3. **Installing the GPS Module:**
   - Download the GPS module plugin from the [official repository](https://wordpress.org/plugins/cf-geoplugin-gps/).
   - In your WordPress admin dashboard, go to `Plugins > Add New`.
   - Click `Upload Plugin` and choose the downloaded ZIP file.
   - Click `Install Now`, and after installation, click `Activate`.

4. **Automatic Operation:**
   - The plugin operates automatically, utilizing the Geo Controller API and Google Geocoding API.
   - No additional settings or configurations are required.
   - It begins providing precise GPS data immediately upon activation.

== Additional Notes ==

- **API Limits:** Ensure your Google API usage is within the free tier limits or consider upgrading to avoid disruptions.
- **Support:** For any issues or queries, visit our [support page](https://wpgeocontroller.com/support) or consult the plugin documentation.
- **Updates:** Keep the plugin updated to the latest version for optimal performance and new features.

By following these instructions, you can ensure the Geo Controller GPS Module is installed correctly and begins enhancing your geolocation accuracy without any hassle. Enjoy precise mobile visitor tracking with minimal effort!

== Frequently Asked Questions ==

= Is this plugin free? =

Yes. But you can only use it with a properly licensed version of the Geo Controller. 

= Why must I use Google Map functionality? =

Plugin in the background using Google services to provide proper GPS information.

= Why does the plugin not work on my site? =

There is few reasons:

1. Your Geo Controller license might be invalid or inadequate
2. Your Google Map API Key may be invalid or improperly set up
3. Your Google Account may have restrictions on your domain or not be whitelisted
4. Your site may be hosted on a local computer (localhost)
5. Your visitors might not have GPS enabled or location tracking disabled on their mobile devices.

= Geo Controller GPS extension slows down my site? =

NO, Geo Controller GPS extension uses the asynchronous data reading from API services.

= Why I can't use GPS on the monthly license or limited lookup? =

It is very complicated to get GPS information and this data is sensitive. We must provide secure and unrestricted access to this information and therefore only annual licenses may use this information.

= Does this plugin do visitors tracking? =

No! This plugin cannot be used to track visitors. Plugin only returns some basic geo information and saves to session on the 5 minutes. 

== Changelog ==

= 2.1.4 =
* Added support for the WordPress version 6.6
* Added new optimized Google Map JavaScript code

= 2.1.3 =
* Moved to new domain wpgeocontroller.com

= 2.1.2 =
* Improved caching
* Support for WP version 6.3.x

= 2.1.1 =
* Added alert for the Google Map API key

= 2.1.0 =
* Removed deprecated code
* Improved code for the PHP 8.1
* Included preloader filters `cfgp_gps/preloader`, `cfgp_gps/preloader/default`, `cfgp_gps/preloader/css/enable`, `cfgp_gps/preloader/css` and `cfgp_gps/preloader/html`

= 2.0.9 =
* Fixed critical error on the pluginactivation
* Improved plugin cache
* Improved GPS code

= 2.0.8 =
* Added support for MU plugins

= 2.0.7 =
* Improving code

= 2.0.6 =
* Added new settings
* Added preloader
* Refactoring files
* Improved security

= 2.0.5 =
* Added support for Geo Controller version 8.3.0

= 2.0.4 =
* Added support for WOrdPress version 6.0
* Fixed bugs from previous version
* Optimized PHP code

= 2.0.3 =
* Added support for Geo Controller version 8.2.5
* Added support for WordPress version 6.0

= 2.0.2 =
* Fixed GPS cache
* Fixed objects
* Improved file includes
* Optimized codes
* Improved security

= 2.0.1 =
* Fixed GPS modules
* Fixed JavaScript objects
* Fixed GPS redirections
* Added new shortcodes and objects for the city code, street name and street number

= 2.0.0 =
* Adapted algorithm for new version of Geo Controller 8.0.0 and above

= 1.1.0 =
* Fixed redirection problem
* Improved session control
* Improved GPS localization

= 1.0.10 =
* Fixed issue with `session_write_close()`

= 1.0.9 =
* IMPORTANT UPDATE: Fixed page redirection
* IMPORTANT UPDATE: Fixed API data merging
* IMPORTANT UPDATE: Fixed missing data

= 1.0.8 =
* IMPORTANT UPDATE: Geocode API update
* IMPORTANT UPDATE: Fixed constant refreshing

= 1.0.7 =
* IMPORTANT UPDATE: Multisite support
* IMPORTANT UPDATE: Translation support
* Enhancement: Error logging
* Enhancement: Geo Controller tags

= 1.0.6 =
* Fixed WP_ADMIN_DIR absolute path
* Improved main plugin connection

= 1.0.5 =
* Fixed Geocode API error
* Fixed Geo Controller absolute path
* Fixed JavaScript console log notifications

= 1.0.4 =
* Added WordPress 5.3 support

= 1.0.3 =
* Improved sanitization

= 1.0.4 =
* Added WordPress 5.3 support

= 1.0.3 =
* Improved sanitization

= 1.0.2 =
* Fixed session problem

= 1.0.1 =
* Fixed parent plugin absolute path

= 1.0.0 =
* Adding GPS support for the Geo Controller

== Upgrade Notice ==

= 2.1.4 =
* Added support for the WordPress version 6.6
* Added new optimized Google Map JavaScript code

= 2.1.3 =
* Moved to new domain wpgeocontroller.com

== Other Notes ==

* [Geo Controller Website](https://cfgeoplugin.com/)
* [Documentation](https://cfgeoplugin.com/documentation/)
* [F.A.Q](https://cfgeoplugin.com/faq/)
* [Blog](https://cfgeoplugin.com/blog/)
* [Contact or Support](https://cfgeoplugin.com/contact/)
* [Terms and Conditions](https://cfgeoplugin.com/terms-and-conditions)
* [Privacy Policy](https://cfgeoplugin.com/privacy-policy)

= DONATION =

Enjoy using *Geo Controller*? Please consider [making a small donation](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=creativform@gmail.com) to support the project's continued development.

= TERMS AND CONDITIONS =

BY INSTALLING THIS PLUGIN WE CONSIDER THAT YOU ARE AUTOMATICALLY ACCEPT TERMS AND CONDITIONS OF OUR SERVICES AND AGREE WITH THE PRIVACY POLICY.

Please read these Terms and Conditions ("Terms", "Terms and Conditions") carefully before using the [www.cfgeoplugin.com](https://cfgeoplugin.com) website and the Geo Controller WordPress application (the "Service") operated by Geo Controller.

[Read about Terms and Conditions](https://cfgeoplugin.com/terms-and-conditions)

= PRIVACY POLICY =
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, [www.cfgeoplugin.com](https://cfgeoplugin.com) owned and operated by Geo Controller. 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. Also we respect and take care about Europe General Data Protection Regulation (GDPR) and your freedom and private choices.

[Read about Privacy Policy](https://cfgeoplugin.com/privacy-policy)

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