# yourls/yourls

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/yourls-yourls).**

12,078 stars · 2,071 forks · PHP · MIT

## Links

- GitHub: https://github.com/YOURLS/YOURLS
- Homepage: https://yourls.org
- awesome-repositories: https://awesome-repositories.com/repository/yourls-yourls.md

## Topics

`hacktoberfest` `php` `short-url` `url-shortener` `yourls`

## Description

YOURLS is a self-hosted URL shortening service that provides a platform for creating, managing, and tracking shortened links on a custom domain. Built as a web application, it functions as a redirection engine that processes incoming requests on the host server to perform HTTP redirects while capturing engagement metrics.

The platform distinguishes itself through a modular architecture that allows for extensive customization. Users can modify core functionality or add new capabilities by installing or developing custom plugins, which integrate into the system through a hook-based event model. This extensibility ensures that the service can be adapted to specific branding and operational requirements without altering the underlying source code.

Beyond basic redirection, the system includes comprehensive tools for monitoring link performance, such as tracking historical click data, identifying traffic referrers, and mapping visitor geographic locations. It also provides a standardized interface for external software to interact with the infrastructure, enabling programmatic access to link management and analytics data through a developer-focused API.

## Tags

### Web Development

- [URL Shorteners](https://awesome-repositories.com/f/web-development/url-shorteners.md) — Offers a self-hosted service for creating, managing, and tracking shortened links on a custom domain. ([source](https://yourls.org))
- [Redirection Rules](https://awesome-repositories.com/f/web-development/url-routing/redirection-rules.md) — Handles server-side HTTP redirects and captures engagement metrics including referrer and geographic data.
- [HTTP Redirects](https://awesome-repositories.com/f/web-development/http-redirects.md) — Performs server-side HTTP status code redirects for incoming requests.
- [Extension Support](https://awesome-repositories.com/f/web-development/extension-support.md) — Provides a modular platform that supports custom plugins and external software integration.

### Programming Languages & Runtimes

- [Link Management Platforms](https://awesome-repositories.com/f/programming-languages-runtimes/language-ecosystems-tooling/php-application-frameworks/link-management-platforms.md) — Provides a PHP-based platform for link shortening and visitor analytics.

### Software Engineering & Architecture

- [Hook-Based Plugin Systems](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/plugin-module-systems/modular-plugin-architectures/plugin-based-architectures/hook-based-plugin-systems.md) — Extends core functionality by triggering custom callback functions at predefined lifecycle events.
- [Plugin Extenders](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/extensibility/plugin-architectures/developer-authoring-interfaces/custom-module-implementations/module-functionality-extenders/plugin-extenders.md) — Allows adding new capabilities to the core system via custom code modules without altering source code. ([source](https://yourls.org))
- [Modular Plugin Systems](https://awesome-repositories.com/f/software-engineering-architecture/modular-plugin-systems.md) — Supports extending core functionality through custom modules without modifying the underlying source code.
- [External Application Integrations](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/workflow-automation-integrations/external-application-integrations.md) — Enables external software to programmatically create, manage, and retrieve shortened links and analytics. ([source](https://yourls.org))

### User Interface & Experience

- [Engagement Trackers](https://awesome-repositories.com/f/user-interface-experience/links/engagement-trackers.md) — Tracks historical click data, referrers, and visitor locations to provide actionable engagement insights. ([source](https://yourls.org))

### Part of an Awesome List

- [Official Tools](https://awesome-repositories.com/f/awesome-lists/devtools/official-tools.md) — The core URL shortening engine and management platform.
- [Plugin Extensions](https://awesome-repositories.com/f/awesome-lists/devtools/plugin-extensions.md) — Adds SEO-friendly headers to redirection responses.
- [UI And Customization](https://awesome-repositories.com/f/awesome-lists/devtools/ui-and-customization.md) — Configures the number of links displayed per page.

### Data & Databases

- [Engagement Analytics](https://awesome-repositories.com/f/data-databases/engagement-analytics.md) — Analyzes historical click data and visitor locations to measure user interaction with shared links.

### Development Tools & Productivity

- [Link Management](https://awesome-repositories.com/f/development-tools-productivity/link-management.md) — Provides programmatic access to link management and performance metrics via an API.
- [RESTful APIs](https://awesome-repositories.com/f/development-tools-productivity/api-development-sdks/restful-apis.md) — Exposes core link management and analytics data through standardized HTTP endpoints.