=== TLCode Visitor IP Details ===
Contributors: tiagocoelho2
Tags: ip, user agent, shortcode, widget, admin
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple plugin to display visitor IP information on pages, posts, or widgets via shortcodes, and in the admin dashboard.

== Description ==

**TLCode Visitor IP Details** is a lightweight and straightforward plugin that allows you to display information about your site's visitors using simple shortcodes. Furthermore, it includes a practical widget in the WordPress Dashboard so administrators can quickly view their own current IP and Hostname.

Usage information and the list of shortcodes can be accessed via the **Tools > TLCode Visitor IP Details** menu in the administrative panel.

### Available Shortcodes:
* `[tlcode_visitor_ip_details]` - Shows the visitor's IP address.
* `[tlcode_visitor_ip_details_hostname]` - Shows the Hostname attached to the visitor's IP.
* `[tlcode_visitor_ip_details_useragent]` - Shows the visitor's browser and operating system (User Agent).
* `[tlcode_visitor_ip_details_referrer]` - Shows the referring URL from which the user came.

== Installation ==

1. Upload the plugin folder to the `/wp-content/plugins/` directory of your server, or install directly through the WordPress dashboard in **Plugins > Add New**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Tools > TLCode Visitor IP Details** to see the shortcode documentation.
4. Add the desired shortcodes to your posts, pages, or widgets.

== Frequently Asked Questions ==

= Where do I find the plugin instructions? =
The plugin does not require complex configurations. To see the details and the list of shortcodes, navigate to **Tools > TLCode Visitor IP Details** in the WordPress dashboard.

= Does the plugin save my IP or my visitors' IP in the database? =
No. The plugin only captures and dynamically displays the information at the moment of access on the screen. No data is saved in your site's database.

= Can I use it in Widgets? =
Yes. Since WordPress 4.9, shortcodes work natively in the default text widget.

== Changelog ==

= 1.0.0 =
* Initial release.