A WordPress plugin that adds a floating "Analyze with Perplexity" button when text is selected on your WordPress site. This plugin enhances the reading experience by providing instant AI-powered analysis of selected content.
- Smart Text Selection: Automatically detects when text is selected on your WordPress posts
- Perplexity AI Integration: Opens selected text in Perplexity AI for instant analysis
- Modern Architecture: Built with ES6 modules and modern JavaScript
- Universal Deployment: Works in standard plugins folder, must-use plugins, child themes, or parent themes
- Configurable Positioning: Customizable icon placement with smart viewport boundary detection
- Mobile Support: Touch-friendly interface with responsive positioning
- Debug Mode: Console logging for development and troubleshooting
- Download the plugin files
- Upload to
/wp-content/plugins/perplexity-learn-more/ - Activate through the WordPress admin panel
The plugin automatically detects its environment and works in:
- Must-Use Plugins:
/wp-content/mu-plugins/perplexity-learn-more/ - Child Theme:
/wp-content/themes/your-child-theme/perplexity-learn-more/ - Parent Theme:
/wp-content/themes/your-theme/perplexity-learn-more/
Edit the static variables in the PerplexityTextAnalyzer class:
class PerplexityTextAnalyzer {
// Plugin version
const VERSION = '1.0.2';
// Positioning (pixels)
public static $position_offset_x = 8; // Right offset from selection
public static $position_offset_y = 0; // Vertical offset (negative = up, positive = down)
// Icon appearance
public static $icon_width = 26;
public static $icon_height = 26;
public static $icon_border_radius = 4;
// Behavior
public static $min_text_length = 3; // Minimum characters to trigger
public static $debug = true; // Enable/disable console logging
}- Modular Design: Separate modules for UI, events, actions, positioning, and configuration
- ES6 Modules: Clean imports with dynamic version-based cache busting
- Event-Driven: Uses modern
selectionchangeAPI instead of legacy mouse events - Promise-Based: Asynchronous module loading with error handling
perplexity-learn-more/
├── css/
│ └── perplexity-learn-more.css
├── js/
│ ├── modules/
│ │ ├── actions.js # Perplexity API integration
│ │ ├── config.js # Configuration management
│ │ ├── events.js # Event handling
│ │ ├── index.js # Module coordinator
│ │ ├── positioning.js # Smart positioning logic
│ │ └── ui.js # DOM manipulation
│ └── perplexity-learn-more-modular.js
├── img/
│ └── perplexity-ai-icon.webp
├── perplexity-learn-more.php
└── README.md
Enable debug mode to see detailed console logging:
public static $debug = true;Debug output includes:
- Module loading status
- Text selection events
- Positioning calculations
- Configuration values
The plugin uses a centralized version system:
- Update
const VERSIONin the PHP class - All assets (CSS, JS, modules) automatically use the new version
- Ensures proper cache busting across all environments
- Modern browsers supporting ES6 modules
- Mobile Safari and Chrome for touch events
- Fallback handling for older browsers
Automatically detects environment and constructs correct URLs:
- Handles Windows/Unix path differences
- Works with WordPress multisite
- Supports custom directory structures
- Positions icon at top-right of selected text
- Handles multi-line selections
- Viewport boundary detection prevents off-screen placement
- Responsive positioning for different screen sizes
- Lazy module loading
- Event delegation
- Minimal DOM manipulation
- Efficient positioning calculations
- Chrome 63+
- Firefox 60+
- Safari 11+
- Edge 79+
For detailed documentation, tutorials, and support, visit the official product page.
Contributions are managed on our GitHub repository.
- Fork the GitHub repository
- Create a feature branch
- Make your changes
- Test across different WordPress environments
- Submit a pull request to the GitHub repository
This plugin is licensed under the GPL v2 or later.
The GBTI Network is a professional co-op network where members have opportunities to share profits, publish products, and contribute articles—all powered by community and GitHub sponsorships.
Sponsor our work by becoming a GBTI Network Member (powered by GitHub Sponsorship).
Becoming a GBTI Member unlocks premium tools and perks:
- Access to Growing List of Premium WordPress Plugins
- Private GitHub Repositories with advanced tools and resources.
- Membership Directory Listings (optional)
- Engaging Communities on Private Discord, Reddit, Private Minecraft Server and more.
Follow us on your favorite platforms for updates, news, and community discussions: