An open API service indexing awesome lists of open source software.

https://github.com/gioxx/yourls-logosuite

Customize your YOURLS admin panel with your own logo and title — effortlessly
https://github.com/gioxx/yourls-logosuite

php yourls yourls-plugin

Last synced: about 1 year ago
JSON representation

Customize your YOURLS admin panel with your own logo and title — effortlessly

Awesome Lists containing this project

README

          

# ⭐ YOURLS Logo Suite

**Customize your YOURLS admin panel with your own logo and title — effortlessly.**
Give your YOURLS install a personal touch that reflects your brand or style.

[![Latest Release](https://img.shields.io/github/v/release/gioxx/YOURLS-LogoSuite)](https://github.com/gioxx/YOURLS-LogoSuite/releases)
[![License](https://img.shields.io/github/license/gioxx/YOURLS-LogoSuite)](LICENSE)

---

## 🚀 Features

- Link to a custom logo (PNG, JPG, SVG)
- Replace the default page title with your own
- Toggle the "(YOURLS)" suffix in the page title
- Live logo preview with error handling
- Admin settings panel with inline tooltips
- Automatic update checker
- Displays the latest changelog from GitHub
- Fully internationalized (i18n-ready)

---

## 🛠️ Installation

1. Download the plugin from [the latest release](https://github.com/gioxx/YOURLS-LogoSuite/releases).
2. Unzip the contents into the `user/plugins/yourls-logo-suite/` directory.
3. Activate the plugin in the YOURLS admin panel.
4. Go to the plugin settings page to configure your custom logo and title.

> **Requires YOURLS 1.9+**

---

## ⚙️ Usage

### Customize the Admin Logo
Paste a direct URL to your logo (or use a hosted file). Supported formats: **PNG, JPG, SVG**.

### Set a Custom Title
Replace the default "YOURLS" browser title with your own — and optionally keep the "(YOURLS)" suffix.

### Reset Anytime
Need to go back to default settings? One click is all it takes.

---

## 🌐 Translation

This plugin is fully localized.
Available languages:
- 🇬🇧 English (default)
- 🇮🇹 Italian

You can contribute new translations via `.po`/`.mo` files inside the `languages/` folder.

---

## 📝 Changelog

See the [CHANGELOG](https://github.com/gioxx/YOURLS-LogoSuite/releases) or open the plugin settings page — the latest release notes are displayed directly there thanks to live GitHub integration.

---

## 📄 License

This plugin is licensed under the [MIT License](LICENSE).

---

## 💬 About

Lovingly developed by the usually-on-vacation brain cell of [Gioxx](https://github.com/gioxx), using ChatGPT to speed up some of the development and correct some rubbish.

---

## 🤝 Contributing

Pull requests and feature suggestions are welcome.
If you find bugs or have feature requests, [open an issue](https://github.com/gioxx/YOURLS-LogoSuite/issues).
If you find it useful, leave a ⭐ on GitHub! ❤️