Category / yourls

by Bradley

Get Real-Time YOURLS Notifications in Discord (YOURLS Discord Notify Plugin)

Get Real-Time YOURLS Notifications in Discord (YOURLS Discord Notify Plugin)

If you run your own URL shortener using YOURLS (Your Own URL Shortener), logging in constantly to check activity gets old fast. New links, clicks, failed logins, or suspicious behavior can easily go unnoticed.

That’s where YOURLS Discord Notify comes in.

This plugin sends real-time YOURLS activity alerts directly to your Discord server, giving you instant visibility into what’s happening with your links — without opening the admin panel.

What YOURLS Discord Notify Does

Once installed, the plugin connects your YOURLS instance to Discord using a webhook and delivers clean, readable notifications for key events.

Core Features

  • 🔗 New Short URL Notifications

  • 👆 Link Click Alerts (with optional cooldown to prevent spam)

  • ✏️ Link Edit & Delete Alerts

  • 🔐 Successful Login Notifications

  • 🚨 Failed Login Alerts (great for security monitoring)

  • 🌍 IP Geolocation Data

    • City, region, country

    • Country flag emoji

    • ISP information

  • 📊 Daily & Weekly Summary Reports

  • ⚙️ Per-Event Enable/Disable Controls

Everything is configurable, so you only get the alerts you actually care about.

Why Use Discord for YOURLS Alerts?

Discord is already where many developers and teams live day-to-day. Instead of email alerts or manually checking logs, you get:

  • Instant visibility

  • Centralized monitoring

  • Easy sharing with teammates

  • Clear audit trail of activity

It turns Discord into a real-time monitoring dashboard for your URL shortener.

Installation (Quick Start)

1. Download the Plugin

Upload the plugin into your YOURLS plugins directory:

cd /path/to/yourls/user/plugins
git clone https://github.com/Bradleycit/yourls-discord-notify.git discord-notify

2. Create a Discord Webhook

In your Discord server:

  1. Go to Server Settings → Integrations → Webhooks

  2. Create a new webhook

  3. Choose the channel for notifications

  4. Copy the webhook URL

3. Activate the Plugin

  • Log in to YOURLS Admin

  • Go to Plugins

  • Activate YOURLS Discord Notify

4. Configure Settings

  • Paste in your Discord webhook URL

  • Enable or disable specific events

  • Adjust click cooldown and display options

  • Save settings

You’re done — notifications will start immediately.

Example Discord Notifications

New Short URL Created

🎉 New URL Created
Short URL: yoursite.com/docker
Destination: https://example.com
Created by: admin

Failed Login Attempt

⚠️ Failed Login Attempt
Username: admin
IP: 203.0.113.42
Location: Nashville, Tennessee 🇺🇸
ISP: Example ISP

Daily Summary Report

📊 Daily Summary (yoursite.com)
Total URLs: 245
New URLs Today: 12
Total Clicks: 1,834
Top Link: /blog – 421 clicks

Advanced Features Worth Noting

Click Rate Limiting

High-traffic links won’t spam your Discord channel. You can define a cooldown window so only meaningful click events are reported.

Geolocation Caching

IP lookups are cached for 24 hours to reduce API usage and improve performance.

Branded Domain Display

Notifications can show your custom YOURLS domain instead of generic system names.

Requirements

Before installing, make sure your server meets these requirements:

  • YOURLS v1.7+

  • PHP 7.0 or newer

  • PHP cURL extension enabled

  • Outbound HTTPS access (for Discord webhooks)

Who This Plugin Is For

  • Developers running private or public YOURLS installs

  • Self-hosters who want real-time monitoring

  • Teams managing marketing or affiliate links

  • Anyone who wants better security visibility

If you care about what your links are doing as it happens, this plugin fits perfectly.

Get the Plugin

You can download or contribute to the project here:

👉 https://github.com/Bradleycit/yourls-discord-notify

by Bradley

YOURLS QR Code Generator Plugin: Branded QR Codes With Logo Upload, Preview, and Download

YOURLS QR Code Generator Plugin: Branded QR Codes With Logo Upload, Preview, and Download

If you run YOURLS (Your Own URL Shortener), you already know the value of clean short links. The next step is making those links instantly usable in the real world—stickers, flyers, business cards, packaging—by generating QR codes that look good and are easy to download.

This plugin adds logo-branded QR codes directly into the YOURLS admin experience, including file upload for your logo, inline previews, a click-to-enlarge popup, a full QR page with size slider, and a one-click download.

What this plugin does

Once installed, you get QR codes for every short link right inside the YOURLS admin UI:

  • Upload a logo file (PNG/JPG/GIF) right in the admin settings (no external image URLs required)

  • Inline mini preview (small QR next to each short URL in the admin list)

  • Click-to-enlarge popup (tap the QR and get a bigger version + download)

  • Dedicated QR page with a size slider (100–500px) and logo toggle

  • Downloads always include the logo (even if the on-screen preview hides it)

It’s designed to be simple: generate a QR fast, download it, and put it on something people can scan.

Requirements

From the repo:

  • YOURLS 1.8+

  • PHP 7.4+

  • Write permissions on YOURLS plugin/logo folders

Installation

High level, the plugin is a standard YOURLS plugin install: place it under user/plugins/ and activate it in the admin panel.

The README’s install section shows the intended flow (download the plugin, move it into the YOURLS plugins directory, then activate in YOURLS Admin → Plugins).

How to use it

1) Upload your logo

In YOURLS admin:

  • Go to Admin → Plugins → QR Code Settings

  • Upload a square PNG for best results (JPG/GIF also supported)

  • Click Upload Logo

2) Generate QR codes from the link list (fastest workflow)

In the main admin URL list:

  • You’ll see a tiny QR icon/preview

  • Click it for a full-size popup

  • Download the QR instantly

3) Use the dedicated QR page (more control)

From the action links:

  • Click “QR”

  • Adjust the size slider (100–500px)

  • Toggle the logo on/off

  • Click Download QR Code

There’s also a clear note in the plugin UX that helps avoid confusion:

The logo appears in the downloaded file, not necessarily in the live preview.

API support (bonus)

The plugin also exposes a simple API-style action endpoint:

GET /yourls-api.php?action=qrcode&shorturl=abc123

And returns a JSON response with a qrcode_url that points to the QR page for that keyword.

Where the logo is stored

The repo documents this folder layout:

user/plugins/qrcode-generator/
├── plugin.php
└── yourls-qr-logo/ ← auto-created: stores uploaded logo
└── logo.png
``` :contentReference[oaicite:17]{index=17}

So after you upload your logo once, the plugin can reuse it for all QR downloads. :contentReference[oaicite:18]{index=18}

---

## Changelog highlights

The README lists a few versions worth calling out:

- **1.6.0**: switched to **file upload** (no more URL-based logo loading)
- **1.6.1 / 1.6.2**: restored popup behavior and clarified that the logo is in the download :contentReference[oaicite:19]{index=19}

---

## Wrap-up

If you’re already using YOURLS, this plugin gives you a clean, “built-in” way to create **good-looking QR codes** for every short link—especially useful when you want to put links into the real world with a bit of branding.