=== TLY URL Shortener ===
Contributors: tlyshortener
Tags: url shortener, short links, marketing, links, t.ly
Requires at least: 6.3
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate and manage T.LY short links directly inside WordPress for posts, pages, and manually selected external links.

== Description ==

TLY URL Shortener connects WordPress to the T.LY API so editors can create, regenerate, copy, and manage short links without leaving the dashboard.

= Features =

* Settings page under `Settings > T.LY`
* Automatic short-link generation on publish for posts and pages
* Post editor meta box with generate, regenerate, copy, and delete-local actions
* Gutenberg sidebar panel integration
* Manual external-link shortener for selected or pasted external links
* Posts list column and row actions
* Analytics service scaffold for future reporting

= Installation =

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate `TLY URL Shortener` from the Plugins screen.
3. Go to `Settings > T.LY`.
4. Add your T.LY API key.
5. Optionally set a default short domain and enable the workflows you want.

= Hooks used =

* `init`
* `transition_post_status`
* `admin_menu`
* `admin_init`
* `admin_enqueue_scripts`
* `add_meta_boxes`
* `rest_api_init`
* `admin_post_tlyursh_generate_short_link`
* `admin_notices`
* `manage_post_posts_columns`
* `manage_page_posts_columns`
* `manage_post_posts_custom_column`
* `manage_page_posts_custom_column`
* `post_row_actions`
* `page_row_actions`

= Filters provided =

* `tlyursh_supported_post_types`
* `tlyursh_auto_generate_for_post_type`
* `tlyursh_enable_logging`
* `tlyursh_enable_analytics_ui`

= Updating API behavior =

Endpoint paths and response parsing are centralized in:

`src/API/TLYURSH_Api_Client.php`

If the T.LY API changes, update the `ENDPOINTS` map and request/response handling there.

= Screenshots =

1. Settings page with API and automation options
2. Posts list table with the T.LY link column and row actions
3. Post edit screen meta box for copying, regenerating, and shortening links

== Frequently Asked Questions ==

= Does uninstall remove post meta? =

No, not by default. The plugin always removes its options on uninstall. Post meta is only removed if cleanup is explicitly enabled in code through the `cleanup_post_meta` option or the `TLYURSH_REMOVE_POST_META_ON_UNINSTALL` constant.

== External Services ==

This plugin connects to the T.LY API to shorten URLs.

Service: T.LY API
Purpose: URL shortening

Data sent:

* Long URL entered by user
* API key (if configured)

When:

* When user creates a short link

Provider:

T.LY

Terms of Service:

https://t.ly/terms

Privacy Policy:

https://t.ly/privacy

== Changelog ==

= 1.0.0 =

* Initial production-ready release.
