=== VidLog ===
Contributors: zzraz
Donate link: https://www.paypal.com/donate/?hosted_button_id=4SMV5H3BFFJKQ
Tags: video, analytics, stats, log, views
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

VidLog logs instant video plays in WordPress such as date, IP, country, file, slug, email and referrer.

== Description ==

Do you think it’s hard to understand who watched your videos using Google Analytics?  
Too complicated? Too many menus? Not enough clarity?  
**Then you’ll love VidLog!**

VidLog gives you a **simple, instant log** showing exactly:
- **Who watched** (email, if captured)
- **When they watched** (date/time)
- **Where they came from** (referrer like Google, Facebook etc.)
- **What country they are in**
- **Their IP address**
- The exact **video file** and **slug**

All of this information appears in a clean table inside your WordPress Admin.  
Each month is logged separately — no huge files — and you can **download the logs** anytime.

This plugin is completely free and does **not** require:
- Creating an external account  
- Installing extra software  
- Adding tracking scripts  
- Using third-party analytics services  

VidLog starts tracking the moment a viewer hits **PLAY** — no configuration needed.

---

### Every Tool You Need to Analyze Your Video Views

- Analytics dashboard inside your WP Admin  
- Logs Email, Date, Slug, Media File, IP, Country & Referrer  
- Save reports  
- Export to **CSV & PDF**  
- Select which **Month** to display in the log table  
- Works with free videos or paywalled content  
- As soon as a viewer hits PLAY — it is logged instantly!

---

### The PRO version offers even more advanced reporting:

- All free features included  
- Advanced analytics page  
- Top-10 charts  
- Full logs per:
  - Country  
  - Video  
  - Referrer  

---

### Who’s it for?

VidLog is easy enough for beginners while offering depth for advanced users.

Perfect for:
* Movie streaming sites  
* Video bloggers  
* Tutorial & e-learning sites  
* Membership platforms  
* Any website hosting self-hosted video files  

---

### How to Get Started

1. Go to **Plugins > Add New** in WordPress  
2. Search for **“VidLog”**  
3. Install & activate  
4. Start seeing analytics immediately  

VidLog begins tracking automatically. No JavaScript, no coding, no setup.

> **Note:** VidLog tracks only **self-hosted** videos like `.mp4`, `.webm`, `.mov`, `.m3u8`, etc.  
> It does not track YouTube or Vimeo embeds.

---

== Features ==

| Feature | Basic | PRO |
|:--|:--:|:--:|
| Instant logging when a viewer presses PLAY | ✔ | ✔ |
| Logs Date, IP, Country, Slug, File, Referrer, Email | ✔ | ✔ |
| Select which Month to display in the log table | ✔ | ✔ |
| Delete log entries | ✔ | ✔ |
| Monthly log storage | ✔ | ✔ |
| CSV export | ✔ | ✔ |
| PDF export | ✔ | ✔ |
| Works with any HTML5/self-hosted video player | ✔ | ✔ |
| Logs formats (.mp4, .webm, .mov, .mkv, .m4v, .avi, .m3u8) | ✔ | ✔ |
| Priority updates & bug fixes | ✕ | ✔ |
| Advanced analytics + Top-10 charts | ✕ | ✔ |
| Full country/video/referrer breakdowns | ✕ | ✔ |
| Support duration | 1 month | 6 months |

---

== External Services ==

VidLog connects to two external services in order to provide country and flag information in the video statistics dashboard.

1. IP Geolocation Lookup (ip-api.com)
   - Purpose: Used to convert a visitor’s IP address into a country code and country name. This is required for the “Country” column in the log statistics.
   - Data Sent: The visitor’s public IP address is sent when a new log is created.
   - URL: http://ip-api.com/json/<ip>?fields=countryCode,country
   - Privacy Policy: https://ip-api.com/docs/legal
   - Terms of Use: https://ip-api.com/docs/legal

2. Flag Image Provider (flagcdn.com)
   - Purpose: Used to display a small country flag icon next to each log entry.
   - Data Sent: No personal data is sent by the plugin. The browser simply loads a small PNG flag file, the same way it loads any external image.
   - URL Example: https://flagcdn.com/16x12/{country-code}.png
   - Privacy Policy: https://flagcdn.com/privacy/
   - Terms: https://flagcdn.com/

These services are required for correct operation of the plugin’s statistics reporting.

3. The plugin includes a link in the Upgrade page to:

* **LiseRasmussen.se** – https://www.liserasmussen.se  
  This link is informational only. No user data is sent to any external site.

---

== Frequently Asked Questions ==

= Does it work with YouTube or Vimeo embeds? =  
No. VidLog only tracks **self-hosted** video files such as `.mp4`, `.webm`, `.mov`, etc.

= Does it slow down my site? =  
No — logging is done asynchronously and is extremely lightweight.

= Can I export my logs? =  
Yes — you can export logs to **CSV or PDF**.

---

== Screenshots ==
1. VidLog dashboard with logged views  
2. CSV & PDF export  
3. Monthly log management  
4. PRO analytics with Top-10 charts  

---

== Changelog ==

= 1.0.0 =  
* Initial release under the new name “VidLog”

---

== Credits ==

Developed by Lise Rasmussen  
© 2025 VidLog — All rights reserved.