WP News Audio Pro

Enterprise-level WordPress plugin - Convert posts to audio with premium animated player, bulletproof security, and multi-language TTS support.

✨ Premium Features

🎵 Ultra-Premium Audio Player

• Draggable - Move player anywhere on screen, position saved
• Minimizable - Shrinks to floating FAB with pulse glow animation
• Keyboard Shortcuts - Full keyboard control (Space, arrows, M, Esc)
• Glassmorphism Design - Modern blur effects and gradient animations
• Smooth Animations - Cubic-bezier transitions throughout
• Auto-Resume - Remembers playback position
• Time Remaining - Shows how much time is left
• Article Title - Displays in player header
• Mobile Gestures - Touch-optimized for mobile devices

🔐 Military-Grade Security

• License-First Architecture - No features without activation
• Domain Fingerprinting - License tied to specific domain
• HMAC Signatures - Tamper-proof license validation
• File Integrity - SHA-256 checksums of critical files
• Nulled Detection - Scans for pirated patterns
• Anti-Bypass - Blocks filter hijacking and GPL auto-activation
• Remote Validation - Daily license verification with Envato API
• Auto-Deactivation - Immediate shutdown on security breach

🎙️ Advanced TTS Features

• 🌍 Multi-Language Support - 8+ languages (English, Spanish, French, German, Arabic, Hindi, Chinese)
• 🎚️ Voice Customization - Speed, pitch, and volume controls
• 🎵 Multiple Engines - eSpeak (offline), ResponsiveVoice, Google TTS
• 💾 Smart Caching - Auto-cleanup of old audio files
• 📱 Responsive - Works perfectly on all devices

🎨 Premium UI/UX

• Animated Popup - Modern, user-friendly interface
• Theme Switcher - Light/dark mode support
• Progress Indicators - Gradient animated progress bar
• Glow Effects - Buttons with hover animations
• Mobile Optimized - Touch gestures and responsive design

📧 Integrated Support

• Email Support - info.geniusplugtechnology@gmail.com
• WhatsApp Support - +880 1761 487193
• Support Portal - https://geniusplug.com/support/
• Help Everywhere - Support cards in admin, error messages, emails

📦 Installation

From CodeCanyon

1. Download from CodeCanyon
2. Upload to /wp-content/plugins/
3. Activate plugin
4. Enter license key
5. Configure settings

Manual Installation

# Clone repository
git clone https://github.com/Geniusplug/wp-news-audio-pro.git

# Copy to WordPress plugins directory
cp -r wp-news-audio-pro /path/to/wordpress/wp-content/plugins/

# Or create symbolic link for development
ln -s $(pwd)/wp-news-audio-pro /path/to/wordpress/wp-content/plugins/

🔧 Configuration

Navigate to News Audio Pro in WordPress admin:

General Settings

• Enable Popup - Toggle popup display on/off
• Auto-play - Automatically play audio on page load
• Default Language - Select TTS language
• Player Position - Choose popup, fixed bottom, or inline

Audio Settings

• Voice Engine - Select eSpeak, ResponsiveVoice, or Google TTS
• Speech Speed - Adjust playback speed (0.5x to 2.0x)
• Pitch - Modify voice pitch (0.5 to 2.0)
• Volume - Set default volume (0 to 100)
• Audio Format - Choose MP3 or WAV
• Cache Duration - Days to keep audio files

License

• Enter CodeCanyon purchase code
• Activate for current domain
• View activation status
• Note: Without license activation, NO features are available

⌨️ Keyboard Shortcuts

The premium audio player supports full keyboard control:

Key	Action
Space	Play/Pause
←	Rewind 10 seconds
→	Forward 10 seconds
↑	Volume up
↓	Volume down
M	Mute/Unmute
Esc	Close player

🛡️ Security Features

License Enforcement

• Complete feature lockdown without valid license
• Admin shows only license page when unlicensed
• Frontend completely disabled
• All AJAX and REST API endpoints blocked

Anti-Piracy Protection

• Domain fingerprinting (cannot copy to different domain)
• HMAC signature verification
• File integrity monitoring (SHA-256 checksums)
• Nulled script detection
• GPL bypass blocker
• Daily remote validation

What Happens on Security Breach

1. Plugin features immediately deactivated
2. Admin receives email alert
3. Security notice shown in admin
4. License revoked
5. Support contact information displayed

📧 Support & Contact

Need help? Our support team is ready to assist:

• Email: info.geniusplugtechnology@gmail.com
• WhatsApp: +880 1761 487193
• Support Portal: https://geniusplug.com/support/

About

• Plugin version and changelog
• Author information
• Documentation and support links

🛠️ Development

Prerequisites

• WordPress 5.0+
• PHP 7.4+
• MySQL 5.6+ or MariaDB 10.1+

Server Requirements for eSpeak

Ubuntu/Debian:

sudo apt-get install espeak

CentOS/RHEL:

sudo yum install espeak

macOS:

brew install espeak

File Structure

/wp-news-audio-pro/
├── wp-news-audio-pro.php          # Main plugin file
├── uninstall.php                   # Cleanup on uninstall
├── README.txt                      # WordPress format
├── README.md                       # GitHub format
├── LICENSE                         # GPL v2 license
├── CHANGELOG.txt                   # Version history
├── /assets/
│   ├── /css/
│   │   ├── admin-style.css        # Admin panel styles
│   │   ├── frontend-style.css     # Popup and player styles
│   │   ├── player-premium.css     # Premium glassmorphism styles
│   ├── /js/
│   │   ├── admin-script.js        # Admin functionality
│   │   ├── frontend-script.js     # Popup and player JS
│   │   ├── player-draggable.js    # Drag functionality
│   │   ├── player-keyboard.js     # Keyboard shortcuts
│   ├── /images/
│   │   ├── icon-128x128.svg       # Plugin icon
│   │   ├── icon-256x256.svg       # Large icon
│   │   ├── banner-772x250.svg     # Banner image
├── /includes/
│   ├── class-plugin-core.php      # Core functionality
│   ├── class-tts-engine.php       # Text-to-speech engine
│   ├── class-license-manager.php  # License verification with security
│   ├── class-license-guard.php    # Feature lockdown system
│   ├── class-security-scanner.php # Nulled detection & integrity
│   ├── class-admin-settings.php   # Admin panel
│   ├── class-frontend-popup.php   # Popup modal
│   ├── class-audio-player.php     # Audio player
├── /languages/
│   ├── wp-news-audio-pro.pot      # Translation template

🎯 Usage

Testing Mode (Development)

For development and testing on localhost, use the test license code:

// In WordPress admin, go to News Audio Pro → License
// Enter this code: WNAP-DEV-TEST-2025
// Works ONLY on localhost (valid for 90 days)

For production sites, you'll need a valid CodeCanyon purchase code.

API Token Configuration (Optional)

For additional security, you can move the API token to wp-config.php:

// Add to wp-config.php (more secure than hardcoding in plugin)
define('WNAP_API_TOKEN', 'your_envato_api_token_here');

// Get your token from: https://build.envato.com/create-token/
// Required permissions: View and search Envato sites

Default Settings

After activation, the plugin automatically sets these defaults:

• Button Display: Enabled on posts, pages, and home page
• TTS Engine: Web Speech API (free, unlimited, no setup required)
• Popup: Disabled by default (floating button enabled)
• Auto-play: Disabled

Basic Usage

1. Activate the plugin
2. Enter license key (required for all features)
3. Configure settings in admin panel
4. Visit any single post page
5. Popup will appear automatically (if licensed)
6. Click "Listen to Audio" to generate and play

Premium Player Features

• Drag: Click and hold the drag handle at the top to move the player
• Minimize: Click the minimize button to shrink to FAB
• Keyboard: Use shortcuts (Space, arrows, M, Esc) for control
• Auto-Resume: Player remembers your position automatically

For Developers

Hooks and Filters

// Modify default settings
add_filter('wnap_default_settings', function($settings) {
    $settings['speech_speed'] = 1.5;
    return $settings;
});

// Customize popup display condition
add_filter('wnap_show_popup', function($show, $post_id) {
    // Custom logic here
    return $show;
}, 10, 2);

// Modify processed content before TTS
add_filter('wnap_process_content', function($content, $post_id) {
    // Custom processing
    return $content;
}, 10, 2);

Programmatic Audio Generation

// Generate audio for a post
$tts_engine = new WNAP_TTS_Engine();
$settings = get_option('wnap_settings');
$content = get_post_field('post_content', $post_id);

$audio_url = $tts_engine->generate_audio(
    $post_id,
    $content,
    'en-US',
    $settings
);

📝 Requirements

• WordPress: 5.0 or higher
• PHP: 7.4 or higher
• MySQL: 5.6+ or MariaDB 10.1+
• Optional: eSpeak for offline TTS

🤝 Support

For support, please contact:

• Email: info.geniusplugtechnology@gmail.com
• WhatsApp: +880 1761 487193
• Support Portal: https://geniusplug.com/support/

📦 CodeCanyon Submission Checklist

Before submitting to CodeCanyon, ensure:

Functionality

• [x] Button appears on all posts by default
• [x] Web Speech API works immediately (no setup required)
• [x] Test code works on localhost
• [x] Real license verification works on live sites
• [x] Proper default settings on activation

Code Quality

• [x] All strings wrapped in __() for translation
• [x] All inputs sanitized (sanitize_text_field(), sanitize_email(), etc.)
• [x] All outputs escaped (esc_html(), esc_attr(), esc_url())
• [x] All database queries use $wpdb->prepare()
• [x] Proper nonce verification on all AJAX actions
• [x] Capability checks on all admin actions

Security

• [x] API token can be configured via wp-config.php
• [x] No hardcoded secrets in code
• [x] GPL license headers in all PHP files
• [x] Proper error handling (no fatal errors)

Documentation

• [x] Complete README with installation instructions
• [x] Clear testing instructions for localhost
• [x] API token configuration guide
• [x] Support contact information

📄 License

This project is licensed under GPL v2 or later - see LICENSE file for details.

Copyright (C) 2025 Geniusplug

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

🙏 Credits

• Author: Geniusplug
• Plyr.js: https://plyr.io - Modern HTML5 media player
• eSpeak: http://espeak.sourceforge.net - Open-source TTS
• WordPress: https://wordpress.org - CMS platform

🔄 Changelog

1.0.0 (2025-01-20)

Initial Release

• Multi-language TTS support (8 languages)
• Animated popup modal
• Modern audio player with Plyr.js
• License verification system
• Admin settings panel
• Smart audio caching
• Responsive design
• Translation ready
• Auto cleanup functionality

🚀 Roadmap

• [ ] Support for custom post types
• [ ] Additional TTS engines (Amazon Polly, Azure)
• [ ] Batch audio generation
• [ ] Advanced customization options
• [ ] WordPress Gutenberg block
• [ ] Shortcode support
• [ ] Widget support
• [ ] Analytics and tracking

👥 Contributing

This is a commercial plugin. For feature requests or bug reports, please contact support.

⚠️ Disclaimer

This plugin requires a valid CodeCanyon license for production use. The license verification system ensures compliance with Envato's licensing terms.

📞 Contact

Geniusplug

• Website: https://yoursite.com
• Email: support@yoursite.com
• GitHub: @Geniusplug

---

Made with ❤️ by Geniusplug