=== Social Profile Frame Generator – Custom Social Media Frames Creator ===
Contributors: josevarghese
Tags: profile picture, social media frame, event, WordCamp, avatar
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.0
Stable tag: 2.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://buymeacoffee.com/josevarghese

All-in-one profile picture frame generator. Allows users to upload their photo, apply a frame, customize with zoom/rotate/bokeh, and download.

== Description ==
**Profile Frame Generator** is a user-friendly, performance-focused plugin that allows site owners to upload custom PNG frames that users can overlay on their photos to generate social media profile pictures. This plugin easily helps create a social photo without any software on the desktop or mobile.

Sample URL for Social Avatar Profile Frame used by WordCamp Asia 2026 by using this plugin: https://wpasia.org/2026/frame/attendee/

Built for events, campaigns, and brand communities, this plugin is perfect for WordCamp, meetups, or social movement organizers who want to promote a unified visual identity among supporters, attendees, volunteers, and speakers.

### 🎯 Key Features:
- **NEW:** Detailed, responsive frontend UI.
- **NEW:** Split-screen layout for desktop.
- Zoom In/Out controls for precise adjustments.
- Rotate Left/Right controls to fix orientation.
- Bokeh/Blur effect to blur the background image.
- Reset Position button to quickly start over.
- Gravatar support - load user avatar directly from email.
- Custom background color for non-transparent areas.
- Customizable user instructions.
- Upload a transparent PNG frame from the WordPress media library.
- Generate framed profile pictures with an interactive frontend interface.
- Lightweight: CSS/JS loads **only on pages** containing the shortcode.
- Responsive and mobile-ready with intuitive gestures (touch drag/pinch).

### 🛠 How to Use:
1. **Install** the Profile Frame Generator plugin via Plugins > Add New.
2. Navigate to **Dashboard > Profile Frame**.
3. Click **"Select Frame from Media Library"**, choose your PNG frame, and click **Select Frame**.
4. Configure the new control settings (Zoom, Rotate, Bokeh, etc.) as desired.
5. Click the **"Save Settings"** button.
6. Copy the shortcode (e.g., `[profile_frame frame="123"]`) or just `[profile_frame]` to use the default saved frame.
7. Paste the shortcode on any post or page.
8. **Save and view** the page - the frame generator canvas will be visible to users.

### ✨ Frame Interaction & Controls:
Users can customize their image overlay using the following:
- **Zoom Buttons** - Precise zoom control.
- **Rotate Buttons** - Rotate image 90 degrees left or right.
- **Mouse Wheel** - Zoom in/out of the uploaded image.
- **Mouse Drag** - Reposition the image within the frame.
- **Mobile (Pinch to Zoom)** - Two-finger pinch gesture to zoom.
- **Mobile (Rotate)** - Rotate the image left or right using your fingers.
- **Gravatar** - Enter email to auto-load profile picture.

### 🖼 Multiple Frame Support:
To use more than one frame:
- Use `[profile_frame frame="image_id_here"]` where `image_id_here` is the Media Library ID of your PNG frame.
- Each frame must be used on a **separate page**, as only one frame is supported per page.

Example:
- Frame A: `[profile_frame frame="123"]`
- Frame B: `[profile_frame frame="456"]`

> ⚠️ **Performance First:** The plugin **only loads CSS and JS on pages with the shortcode**, ensuring fast load times and minimal impact on your site.

> Note: **WordPress** and **WordCamp** are registered trademarks of the WordPress Foundation. This plugin is not affiliated with or endorsed by WordPress.org or WordCamp. Names used for reference only.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/profile-frame-generator` directory, or install via the WordPress plugin repository.
2. Activate the plugin from the **Plugins** menu in WordPress.
3. Go to **Dashboard > Profile Frame** to configure settings and upload your frame.
4. Copy and paste the shortcode to any post or page.

== Frequently Asked Questions ==

= Can I use more than one frame? =
Yes! Use `[profile_frame frame="image_id_here"]` with the corresponding Media Library image ID. Only one frame per page is supported.

= What format should the frame image be? =
Transparent **PNG** files are required for best results.

= Can users adjust their uploaded images? =
Yes. Users can zoom, reposition, rotate, and fine-tune their uploaded photos to ensure a perfect frame fit.

= Will this plugin slow down my website? =
No. The plugin is lightweight and loads scripts **only on the page** where the shortcode is used.

== Screenshots ==

1. Upload PNG frame via settings and configure advanced controls.
2. User uploads a photo, previews, applies effects like bokeh, and downloads the final image.

== Support ==

For questions, support requests, or feature suggestions, please visit the [support forum](https://wordpress.org/support/plugin/profile-frame-generator/).

If you find this plugin useful, consider [buying me a coffee](https://superwebshare.com/donate) to support development. Thank you!

== Changelog ==

= 2.1.1 =
* Fix: Admin review notice no longer appears on block editor (Gutenberg) post/page screens.

= 2.1.0 =
* New UI with more clean settings page
* Fix: Removed duplicate variable declarations in controls JS that caused strict-mode errors.
* Fix: Added PHP 7.0 version check on activation with a friendly error message.
* Fix: Removed all inline <script> blocks from PHP — JS logic moved to external cacheable files.
* Fix: Removed console.log() debug statements from frontend controls which was added in a previous debugging.

= 2.0.1 =
* Enhanced Settings page
* Fixed FOUC on admin notices.

= 2.0.0 =
* Major Update: New simplified and modern frontend UI.
* Added Zoom In/Out buttons with slider control
* Added Rotate Left/Right buttons
* Added Reset Position button
* Added Bokeh/Blur effect toggle
* Added Gravatar integration
* Added custom background color setting
* Added customizable instructions text
* Added option to select frame from Media Library

= 1.1 =
* Minor enhancements to the settings page

= 1.0.0 =
* Initial release
* Option to select the frame within the settings
* Shortcode support
* Frontend image selection, zoom, and positioning
* Download generated image

== Upgrade Notice ==

= 2.0.0 =
Major Update: This version includes a completely new frontend UI and several new features. We recommend testing on a staging site before updating your live site.