WP Manifestindependent plugin directory
manifest / integrations / site-visitor-notification

Site Visitor Notification for Telegram

A lightweight WordPress plugin that sends a Telegram message every time a real visitor lands on your site.

by Denis · github.com/labunets/site-visitor-notification

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/labunets/site-visitor-notification/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/labunets/site-visitor-notification ↗

A lightweight WordPress plugin that sends a Telegram message every time a real visitor lands on your site.

Features

  • Instant Telegram alerts with page URL, referrer, IP, location, and timestamp
  • Bot/crawler filter — common User-Agent keywords are skipped automatically
  • Throttle — suppress repeat notifications from the same IP (configurable, default 30 min)
  • Country filter — optionally restrict notifications to specific countries
  • IP whitelist — permanently ignore IPs or CIDR ranges (your office, home, staging server)
  • Cloudflare-aware — reads CF-Connecting-IP before falling back to other headers
  • Zero dependencies — no composer, no npm, no API keys beyond your Telegram bot token

Requirements

  • WordPress 5.0+
  • PHP 7.4+

Installation

  1. Clone or download this repository.
  2. Copy the site-visitor-notification folder to wp-content/plugins/.
  3. Activate the plugin via Plugins → Installed Plugins.
  4. Open Settings → Visitor Notifications and configure your bot.

Telegram Setup

1. Create a bot

Open Telegram, start a chat with @BotFather, send /newbot, and follow the prompts. Copy the token you receive.

2. Get your Chat ID

Send any message to your bot, then open:

https://api.telegram.org/bot<TOKEN>/getUpdates

Find "chat":{"id":...} in the response. That number is your Chat ID (negative for groups/channels).

3. Configure the plugin

Paste the token and chat ID into Settings → Visitor Notifications and save.

Settings

Setting Description Default
Telegram Bot Token Token from @BotFather —
Chat ID Personal or group chat ID —
Throttle (minutes) Suppress repeat notifications from the same IP 30
Country Filter Only notify for visitors from listed countries Off
Countries Comma-separated country names in English Ukraine
IP Whitelist One IP or CIDR range per line — silently ignored —

IP Whitelist example

203.0.113.5
192.168.1.0/24
10.0.0.0/8

Country filter example

Ukraine, Poland, Germany

Example Notification

🌍 New visitor

📄 Page: https://example.com/about
🔗 From: https://google.com
🌐 IP: 203.0.113.5
📍 Location: Kyiv, Ukraine
🕐 Time: 2026-03-30 14:22 UTC

Privacy

No personal data is stored in the database. The plugin uses short-lived WordPress transients only for throttling (keyed on a hash of the IP). All notification data is sent directly to Telegram.

License

GPL v2 or later