=== 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.0 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.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