=== QR Code Generator & Scanner - Dynamic QR Codes for WordPress ===
Contributors: shamim496, selimmw, bdthemes
Donate link: http://bdthemes.com/
Tags: qr code generator, qr code block, dynamic qr code, gutenberg blocks, wordpress qr code
Requires at least: 6.1
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The **QR Code** block helps you create custom QR codes directly on your WordPress website and quickly access links, promotions, or contact info.

== Description ==

**Zolo QR Code** is a comprehensive WordPress plugin that transforms how you connect with your audience through dynamic QR code generation. Supporting 7 different QR code types with extensive customization options, it delivers professional-grade functionality directly within the Gutenberg editor while maintaining complete privacy and optimal performance.

🔍 **Why Choose Zolo QR Code?**

In today's mobile-first world, QR codes bridge physical and digital experiences seamlessly. Zolo QR Code empowers WordPress users with advanced QR code generation capabilities including WiFi networks, contact cards, location sharing, and more - all without external dependencies or performance compromises.

⚡ **Seamlessly Integrated with WordPress**

Zolo QR Code works natively with the Gutenberg block editor, making it incredibly intuitive to use. Simply add the QR code block to any page or post, customize it to match your brand, and publish. The QR codes are generated client-side, ensuring fast loading times and complete privacy for your data.

💼 **Perfect for Businesses and Content Creators**

* **Retailers**: Create QR codes for product information, discounts, or loyalty programs
* **Restaurants**: Link to digital menus, online ordering, or reservation systems
* **Content Creators**: Drive traffic to your social media profiles or exclusive content
* **Event Organizers**: Simplify check-ins, provide venue information, or collect feedback
* **Educators**: Share learning resources, assignments, or classroom materials

🎯 **Boost Your Marketing Strategy**

QR codes are powerful marketing tools that drive engagement across channels. With Zolo QR Code, you can track scans (with premium version), analyze user behavior, and optimize your campaigns for better results. Integrate QR codes into your print materials, packaging, or physical locations to create seamless omnichannel experiences.

== 🔑 Key Features ==

### 🎯 **Multiple QR Code Types**
- 📄 **URL/Text** - Direct links to websites, landing pages, or plain text content
- 📶 **WiFi Networks** - Instant network connection with SSID, password, and security settings
- 👤 **vCard Contact** - Share complete contact information (name, phone, email, organization, website)
- 📱 **SMS Messages** - Pre-filled text messages to specific phone numbers
- 📧 **Email** - Auto-compose emails with recipient, subject, and message body
- ☎️ **Phone Numbers** - Direct dial functionality for click-to-call
- 📍 **Location/GPS** - Geographic coordinates with location names and map integration

### 🎨 **Advanced Customization Options**
- 🌈 **Color Controls** - Customize foreground, background, and eye colors independently
- 📏 **Size & Dimensions** - Flexible sizing with responsive controls (up to 500px)
- 🛡️ **Error Correction Levels** - Choose from L, M, Q, H levels for different reliability needs
- 🎯 **Alignment Controls** - Left, center, right alignment with responsive settings
- 🖼️ **Border Styling** - Complete border controls with radius, width, and style options
- 📐 **Padding Controls** - Precise padding adjustments for perfect placement

### 🖼️ **Logo & Badge System**
- 🏷️ **Custom Badges** - Multiple badge styles with customizable text and icons
- 🎨 **Badge Styling** - Typography, colors, margins, borders, and box shadows
- 📍 **Logo Embedding** - Insert brand logos directly into QR codes (Premium)
- 🔧 **Logo Controls** - Opacity, size, padding style, and positioning options

### 🎨 **Professional Styling Features**
- 👁️ **Eye Customization** - Control corner eye colors and radius for unique designs
- 🎭 **Box Shadow Effects** - Add depth with customizable shadow controls
- 📦 **Wrapper Styling** - Background colors, borders, and padding for containers
- 📝 **Typography Controls** - Advanced text styling for badges and labels
- 📱 **Responsive Design** - Perfect display across all devices and screen sizes

### ⚡ **Technical Excellence**
- 🧩 **Native Gutenberg Integration** - Seamless WordPress block editor experience
- 💻 **Zero External Dependencies** - No third-party API calls or external services
- 🔒 **Complete Privacy Protection** - All data processing happens locally
- 🚀 **Optimized Performance** - SVG output for crisp, scalable graphics
- ⚡ **Lightning Fast Loading** - Minimal impact on page speed
- 🖨️ **Print-Ready Quality** - High-resolution output suitable for both digital and print media

== 🌟 Use Cases ==

### 🏢 **Business & Professional**
* **Digital Business Cards**: Create instant vCard QR codes with complete contact information
* **WiFi Guest Access**: Generate secure network credentials for customers and visitors
* **Location Sharing**: Pinpoint business locations with GPS coordinates and names
* **Email Communications**: Pre-filled contact forms and inquiry emails
* **Customer Support**: Direct phone dial links for immediate assistance

### 📱 **Marketing & Engagement**
* **Social Media Growth**: Drive followers to your profiles and channels
* **Website Traffic**: Direct links to landing pages, products, or special offers
* **SMS Campaigns**: Pre-filled text messages for promotions and updates
* **Event Coordination**: Location details, contact info, and event specifics
* **Product Information**: Detailed specifications, manuals, or support resources

### 🏪 **Retail & E-commerce**
* **Product Catalogues**: Quick access to online product pages and descriptions
* **Digital Receipts**: Email confirmations and transaction details
* **Loyalty Programs**: SMS sign-ups and membership information
* **Store Locations**: GPS navigation to physical store locations
* **Customer Reviews**: Direct links to feedback and review platforms

### 🎓 **Education & Events**
* **Resource Sharing**: Instant access to learning materials and assignments
* **Contact Directory**: Faculty and staff contact information
* **Campus Navigation**: Location-based directions and facility information
* **Event Registration**: Pre-filled forms and contact details
* **Digital Communication**: Streamlined parent-teacher communication channels

== 🔮 Future Development ==

We're committed to continuous improvement of Zolo QR Code. Our roadmap includes:

* Advanced analytics and tracking capabilities
* Integration with popular e-commerce platforms
* Animated QR codes for enhanced engagement
* More design customization options
* Integration with marketing automation tools

== 🛠️ Technical Excellence ==

Built with modern web standards and best practices, Zolo QR Code delivers exceptional performance while maintaining compatibility with all major WordPress themes and plugins. Our clean, efficient code ensures your website remains fast and secure.

**Ready to transform how you connect with your audience?** Install Zolo QR Code today and start creating engaging, functional QR codes in minutes!

== Installation ==

= Plugin Installation Method: =

1. Go to the WordPress dashboard
2. Got to the **Plugins** > **Add New**
3. Type **"QR Code"** in the search box
4. Click on **"Install"** button
5. After install the plugin **Activate** the plugin

= Installation via Zip file: =

1. Download QR Code block **plugin zip** file from WordPress
2. Go to site **Dashboard** > **Plugins** > **Add New** > **Upload Plugins**
3. Select the QR Code zip file and proceed to install
4. Activate QR Code.

== Upgrade Notice ==

There are no requirement for upgrade notice. Just click the update button and updated the plugin.

== Frequently Asked Questions ==

= 🔍 How do I create my first QR code with Zolo QR Code? =

Creating your first QR code is simple:
1. **Install and Activate** the plugin from the WordPress repository
2. **Add the QR Code Block** to any page or post using the Gutenberg editor
3. **Enter your content** (URL, text, phone number, email, etc.) in the block settings
4. **Customize appearance** by adjusting size, colors, and padding
5. **Preview and Publish** your page to make the QR code live

Your QR code is now ready to be scanned by any smartphone camera or QR code reader app!

= 🎨 Can I customize the appearance of my QR codes? =

**Absolutely!** Zolo QR Code offers extensive customization options:
* Change foreground and background colors to match your brand
* Adjust size and padding for perfect placement on your page
* Modify error correction level for better scanning reliability
* Choose between different corner styles for a unique look
* Add a logo or image to the center of your QR code (Premium feature)
* Select from various frame styles and add custom labels (Premium feature)

All customizations maintain full QR code functionality while enhancing visual appeal.

= 📱 Are Zolo QR codes mobile-friendly and responsive? =

**Yes!** All QR codes generated with our plugin are fully responsive and adapt perfectly to any screen size. The SVG format ensures crisp display on high-resolution devices, making them easy to scan from both desktop and mobile devices. We've thoroughly tested scanning compatibility with all major smartphone brands and QR scanner apps.

= 🔒 Is my data secure when using Zolo QR Code? =

**Your data stays private** with Zolo QR Code. Unlike many online QR generators:
* All code generation happens directly in your browser
* No data is sent to external servers
* Your links and information never leave your website
* No third-party tracking or analytics are embedded in your QR codes

This ensures complete data privacy and security for both you and your users.

= ⚡ Will QR codes slow down my WordPress website? =

**Not at all!** Zolo QR Code is engineered for optimal performance:
* Lightweight code with minimal impact on page load time
* No external API calls or dependencies
* SVG format provides excellent quality at small file sizes
* Lazy loading ensures QR codes only render when visible
* Optimized for WordPress core performance standards

Your website speed remains fast and responsive even with multiple QR codes on a single page.

= 🔄 What types of content can I encode in my QR codes? =

Zolo QR Code supports **7 comprehensive data formats**:

**🌐 URL/Text** - Website links, landing pages, or any plain text content
**📶 WiFi Networks** - Complete network credentials including SSID, password, security type (WPA/WEP/No Password), and hidden network support
**👤 vCard Contact** - Professional contact cards with name, phone, email, organization, and website URL
**📱 SMS Messages** - Pre-composed text messages with recipient phone numbers
**📧 Email** - Auto-filled emails with recipient address, subject line, and message body
**☎️ Phone Numbers** - Direct click-to-call functionality for immediate contact
**📍 Location/GPS** - Geographic coordinates with location names for precise mapping and navigation

Each QR code type includes specialized input controls and validation to ensure proper formatting and maximum compatibility across all scanning devices and applications.

= 💻 Does Zolo QR Code work with page builders and themes? =

**Yes!** While Zolo QR Code is built for the Gutenberg editor, it's fully compatible with:
* All standard WordPress themes
* Popular page builders like Elementor, Divi, and Beaver Builder via our shortcode functionality
* WooCommerce product pages
* Membership and LMS plugins
* Custom post types and templates

The plugin adapts to your existing WordPress setup without conflicts.

= 🚀 What are the differences between free and premium versions? =

**🆓 Free Version Includes:**
* **All 7 QR Code Types** - URL/Text, WiFi, vCard, SMS, Email, Phone, Location
* **Advanced Customization** - Colors (foreground, background, eye colors), size controls (up to 500px), error correction levels
* **Professional Styling** - Border controls, border radius, padding, alignment, eye radius customization
* **Badge System** - Basic badge functionality with text customization
* **Complete Privacy** - All local processing, no external API dependencies
* **High-Quality Output** - SVG rendering for crisp, scalable graphics
* **Responsive Design** - Perfect display across all devices

**⭐ Premium Features (via ZoloBlocks):**
* **Logo Embedding** - Insert brand logos directly into QR codes with opacity and positioning controls
* **Advanced Badge Styles** - Multiple badge designs with icons, typography controls, and styling options
* **Wrapper Styling** - Enhanced container styling with box shadows and advanced borders
* **Extended Customization** - Additional design templates and styling presets
* **Priority Support** - Dedicated technical assistance and faster update delivery

= 🔧 How do I troubleshoot if my QR codes aren't scanning properly? =

If you're experiencing scanning issues, try these specific solutions:

**🎨 Visual Settings:**
1. **Check Color Contrast** - Ensure sufficient contrast between Code Color and Background Color
2. **Adjust Eye Color** - Make sure Eye Color contrasts well with the background
3. **Review Size Settings** - QR codes should be at least 240px for digital use, larger for print
4. **Verify Error Correction Level** - Use 'M' (Medium) or 'Q' (Quartile) for better reliability

**📱 Content-Specific Issues:**
* **WiFi QR Codes** - Verify SSID and password are correct; check security type (WPA/WEP/No Password)
* **vCard Contacts** - Ensure name field is filled (required); verify phone/email formats
* **Location QR Codes** - Use decimal degree format for latitude/longitude coordinates
* **Email QR Codes** - Check email format and avoid special characters in subject/body

**🔧 Technical Troubleshooting:**
1. **Test Padding** - Increase padding value if codes appear cramped
2. **Reset Eye Radius** - Set to 0 if scanning apps have difficulty with rounded corners
3. **Verify Content Length** - Very long content may create complex codes that are harder to scan

**📋 Testing Tips:**
* Test with multiple QR scanner apps and devices
* Scan from different distances and angles
* Ensure adequate lighting when scanning physical prints

= 🌐 Can I use Zolo QR codes for marketing campaigns and track their performance? =

**Absolutely!** Zolo QR Code is perfect for marketing campaigns:

**📈 Current Marketing Features:**
* **Campaign-Specific QR Codes** - Create unique codes for different channels (social media, print, email, etc.)
* **Content Targeting** - Direct users to specific landing pages, promotions, or contact forms
* **Brand Consistency** - Customize colors and styling to match your brand identity
* **Multi-Channel Deployment** - Use across digital and print materials simultaneously
* **Professional Appearance** - Badge system with custom text for clear call-to-actions

**🔗 Integration Capabilities:**
* Link to Google Analytics-enabled landing pages for detailed tracking
* Connect with email marketing platforms via email QR codes
* Drive social media engagement through direct profile links
* Support SMS campaigns with pre-filled message content

**📊 Tracking Strategy Tips:**
* Use different landing page URLs for each marketing channel
* Create campaign-specific contact information for lead attribution  
* Implement UTM parameters in your QR code URLs for Google Analytics
* Design A/B testing with different QR code placements and styles

**⭐ Enhanced tracking features may be available in future premium versions.**

== Screenshots ==

1. **Qrcode Interface** - The interactive qrcode that engages visitors.
2. **Settings Page** - Configure your qrcode settings for better customization.
3. **Responsive Design** - The plugin works seamlessly on both desktop and mobile devices

== Changelog ==

  **= 1.1.2 - 21-05-2026 =**
  - Fixed: WordPress latest version compatibility issue

  **= 1.1.1 - 06-04-2025 =**
  - Fixed: Bug and Improve Performance
  - Fixed: Compatibility issue with WordPress 6.9

  **= 1.1.0 - 18-08-2025 =**
  - Initial Released

  **= 1.0.0 - 16-04-2025 =**
  - Initial Released

To build the plugin:

1. Clone the repository.
2. Run `npm install` to install dependencies.
3. Run `npm run build` to compile the plugin.
