=== Custom URL Shortener & QR Generator ===
Contributors: hamzashahzad
Tags: url shortener, qr code, shortcode, api, floating widget, admin settings
Requires at least: 5.0
Tested up to: 6.5
Requires PHP: 7.0


Generate QR codes and shorten URLs using the urllink.site API. Use shortcodes anywhere in your posts or pages. Includes a floating widget and admin toggle settings.

== Description ==

**Custom URL Shortener & QR Generator** is a simple and powerful plugin that allows you to shorten URLs and generate QR codes using the [urllink.site](https://urllink.site) API.

This plugin provides a flexible shortcode `[urllink]` which can be used inside posts, pages, or widgets to:
- Shorten URLs
- Generate QR codes
- Display both together in a flexible layout

It also includes:
- Admin settings to control plugin behavior
- A floating widget for easier access

== Features ==
* Shorten URLs using urllink.site
* Generate QR codes on the fly
* Embed using shortcode
* Choose layout direction: row or column
* Display QR code above, below, or beside the shortened link
* Admin toggle settings
* Floating widget display

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Use the shortcode `[urllink]` in any post or page

== Usage ==

Use the `[urllink]` shortcode with attributes:

Example 1 – Shorten a link and generate a QR code:
[urllink link="https://example.com" qrcode="https://example.com"]

Example 2 – Generate only a QR code:
[urllink qrcode="https://example.com"]

Example 3 – Shorten the current page URL:
[urllink link="this"]

Optional attributes:
- `size` (default: 200) – size of the QR code in pixels
- `display` (default: column) – `row` or `column`
- `right` or `top` – position of the QR relative to the link

== Screenshots ==
1. Example output with shortcode
2. QR code only mode
3. Admin settings page
4. Floating widget on frontend

== Changelog ==

= 1.0 =
* Initial release

== Frequently Asked Questions ==

= What API does this plugin use? =
This plugin uses the [urllink.site](https://urllink.site) API for both URL shortening and QR code generation.

= Can I use the shortcode multiple times on a page? =
Yes, the shortcode is designed to work multiple times per page with unique IDs.

= Is this plugin free? =
Yes, it is 100% free and open-source.

== License ==
This plugin is licensed under the GPLv2 or later.
