=== Choondal Crop Tool ===
Contributors:      lakshmidas-menon-manikkath
Tags:              photo crop, signature crop, PVC card, ID card, image resize
Requires at least: 5.8
Tested up to:      6.7
Requires PHP:      7.4
Stable tag:        20.26.03.11
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

A professional photo and signature cropping tool for PVC card printing services, built for Akshaya e-Centres and CSC operators.

== Description ==

**Choondal Crop Tool** brings a complete image-cropping workflow to your WordPress website. Designed specifically for Akshaya e-Centre operators and CSC service providers who need precise, print-ready photos and signatures for government ID / PVC card services.

= Key Features =
* **Two modes** – Photo (passport/stamp size) and Signature crop
* **Custom dimensions** – Width × Height in MM, CM, Inches, or Pixels
* **DPI / Resolution control** – Outputs at specified DPI for print accuracy
* **Max file size** – Binary-search JPEG quality to hit target KB
* **Text overlays** – Burn applicant name and date on to the crop
* **Branded watermark** – Centre name watermark (configurable opacity)
* **Live preview** with actual pixel dimensions and file size
* **Download** cropped file directly from the browser
* **Drag-and-drop** image upload support
* **Interactive crop selection** with 8-handle resize and move
* Fully AJAX-based, no page reload needed
* Works with GD (no extra PHP extensions required)
* Shortcode driven – embed anywhere

= Shortcodes =
* `[pvc_crop_tool]` – Full tool with mode switcher
* `[pvc_crop_tool mode="photo"]` – Opens in Photo mode
* `[pvc_crop_tool mode="signature"]` – Opens in Signature mode

= Requirements =
* PHP 7.4+
* GD extension (enabled by default on most hosts)
* WordPress 5.8+

== Installation ==

1. Upload the `pvc-crop-tool` folder to `/wp-content/plugins/`.
2. Activate **PVC Card Pro – Photo & Signature Crop Tool** in *Plugins*.
3. Go to **PVC Crop Tool → Settings** and configure defaults.
4. Add `[pvc_crop_tool]` to any page or post.

== Frequently Asked Questions ==

= What image formats are supported? =
JPEG, PNG, GIF, and WebP (WebP requires PHP 5.4+ GD build with WebP support).

= Can I use it without selecting a crop region? =
Yes. If no region is drawn, the entire image is used as the crop source.

= Where are the cropped files stored? =
In `wp-content/uploads/pvcc-uploads/`. The folder has `Options -Indexes` protection.

= Is this safe for public-facing pages? =
Yes. All uploads are validated by MIME type (using `finfo`), nonce-protected, and stored outside the web-browsable upload path.

== Screenshots ==
1. Frontend crop tool – Photo mode
2. Frontend crop tool – Signature mode (PAN card example)
3. Admin settings panel

== Changelog ==

= 20.26.03.11 =
* Initial release
* Photo & Signature crop modes
* MM / CM / Inches / Pixels unit support
* DPI, Max KB, Text overlay, Watermark
* Drag-and-drop upload, 8-handle selection
* AJAX crop + download

== Author ==

**Lakshmidas Menon Manikkath**
Akshaya e-Centre Choondal, Guruvayoor, Thrissur, Kerala
🌐 [Choondal.com](https://choondal.com) | [Guvr.in](https://guvr.in)
📞 9446666639
