Modern Clicks Log Viewer Plugin for YOURLS
July 14, 2026 ยท View on GitHub
Displays a premium, fully responsive administration table of detailed click logs, enriched with geolocation and user-agent analysis.
Features
- Responsive Log Table: Modern layout with dynamic search and pagination.
- GeoLite2 Geolocation: Detects visitor country and city using MaxMind GeoLite2 databases.
- Auto-Download GeoIP Database: Automatically downloads and updates the GeoLite2 database without requiring API keys.
- WhichBrowser Agent Parsing: Detailed browser, operating system, and device type detection.
- Custom User Agent Parsing: Easily configure manual regex overrides for custom user agents (e.g. bots, custom clients).
- Collapsible Developer Panel: In-app collapsible developer table displaying the top unparsed user agents directly from your database.
Screenshots
Screenshot(s)
| Modern Clicks Log Table |
|---|
 |
Installation
- Copy or move the
modern-log-viewerdirectory into your YOURLSuser/plugins/directory. - Go to your YOURLS Administration Panel and navigate to Plugins.
- Locate Modern Clicks Log Viewer and click Activate.
In-App Configurations & Control Panel
While the log viewer is active, the following actions and features are available directly on the log viewer page:
| Feature / Action | Type | Default Value | Description |
|---|---|---|---|
Update DB | Button | N/A | Manually triggers an update/download of the GeoLite2 City Database. |
Search Query | Input | "" | Search click logs by keyword, IP address, user agent, or referrer. |
GeoLite2 DB Status | Badge | Status dependent | Displays the current database availability and file size in MB. |
Developer Tools: Unparsed User Agents | Dropdown | Collapsed | Lists the top 30 unparsed user agents with their click counts to help you refine parsing rules. |
Authors
- Bluscream
- Antigravity.AI
Other Plugins
Check out our other YOURLS plugins:
- Manage Protocols: Add, view, toggle, and delete allowed URL protocols.
- Prune Inactive Links: Automatically deletes old links that receive no clicks.
- Public Shortener Front Page: A premium, Turnstile-secured public URL shortener.
- Webhook Notification: Sends a JSON POST webhook notification on new link creation.
AI Disclaimer
This plugin was created and is maintained with the assistance of Antigravity, an agentic AI coding assistant by Google DeepMind.