Plant Disease Detector

A WordPress plugin that uses AI vision models to detect plant diseases from images. Simply upload a photo of your plant and get instant diagnosis with treatment recommendations.

🌿 Features

• AI-Powered Analysis – Identify plant species and detect diseases using advanced vision AI models
• Multiple AI Providers – Choose between Google AI Studio, Ollama (local), or OpenRouter
• Multilingual Reports – Get analysis results in 20+ languages including Arabic, Spanish, French, Chinese, and more
• Scan History – Logged-in users can view, manage, and delete their past scans
• RTL Support – Full right-to-left language support for Arabic, Persian, and Urdu
• Modern UI – Clean, responsive design with drag-and-drop, paste (Ctrl+V), and click-to-upload support
• Privacy Focused – Scans are stored per-user as custom post types

📦 Requirements

• WordPress 5.0+
• PHP 7.4+
• An API key from one of the supported AI providers

⚙️ Installation

1. Download or clone this repository into your /wp-content/plugins/ directory:

   cd /wp-content/plugins/
   git clone https://github.com/bbioon/plant-disease-detector.git

2. Install Composer dependencies:

   cd plant-disease-detector
   composer install

3. Activate the plugin in Plugins → Installed Plugins

4. Configure your AI provider in Settings → Plant Detector

🔧 Configuration

Navigate to Settings → Plant Detector to configure:

AI Providers

Report Language

Select from 20+ languages for AI-generated reports:

• English, Arabic, Spanish, French, German, Italian, Portuguese
• Russian, Chinese, Japanese, Korean, Hindi, Bengali
• Turkish, Dutch, Polish, Vietnamese, Thai, Indonesian, Persian, Urdu, Swahili

🚀 Usage

Detector Shortcode

Add the plant disease detector form to any page or post:

[plant_disease_detector]

Users can:

• Click to upload an image
• Drag and drop an image
• Paste an image from clipboard (Ctrl+V)

History Shortcode

Display the user's scan history (requires login):

[plant_disease_history]

Features:

• Grid layout with pagination (12 items per page)
• View scan details, descriptions, and treatments
• Delete individual scans

📁 Project Structure

plant-disease-detector/
├── assets/
│   ├── css/
│   │   ├── style.css         # Main detector styles
│   │   └── history.css       # History page styles
│   └── js/
│       ├── script.js         # Detector functionality
│       └── history.js        # History page functionality
├── src/
│   ├── Admin/
│   │   └── Settings.php      # Admin settings page
│   ├── Ajax/
│   │   └── Handler.php       # AJAX request handler
│   ├── Api/
│   │   ├── Client.php        # API client factory
│   │   ├── ProviderInterface.php
│   │   └── Providers/
│   │       ├── GoogleAIProvider.php
│   │       ├── OllamaProvider.php
│   │       └── OpenRouterProvider.php
│   ├── Frontend/
│   │   ├── HistoryPage.php   # History shortcode
│   │   └── Shortcode.php     # Detector shortcode
│   ├── History/
│   │   └── ScanRepository.php # Scan data access
│   ├── PostTypes/
│   │   └── ScanPostType.php  # Custom post type
│   └── Plugin.php            # Main plugin class
├── vendor/                   # Composer dependencies
├── composer.json
└── plant-disease-detector.php # Plugin entry point

🔌 Architecture

The plugin follows a modular, object-oriented architecture:

• Provider Interface Pattern – Easily extend with new AI providers by implementing ProviderInterface
• Repository Pattern – ScanRepository handles all database operations for scans
• Singleton Bootstrap – Plugin class ensures single initialization
• Custom Post Type – Scans stored as pdd_scan posts with meta for analysis data
• PSR-4 Autoloading – Clean namespace structure via Composer

🛡️ Security

• All AJAX requests protected with WordPress nonces
• Input sanitization using WordPress sanitization functions
• Output escaping with esc_html(), esc_attr(), and wp_kses_post()
• Capability checks for admin settings (manage_options)
• User-specific scan access control

🌐 Hooks & Extensibility

Filters

// Modify analysis result before saving
add_filter('pdd_analysis_result', function($result, $image_data) {
    // Customize result
    return $result;
}, 10, 2);

Actions

// After a scan is saved
add_action('pdd_scan_saved', function($post_id, $result) {
    // Custom logic
}, 10, 2);

📝 License

This plugin is licensed under the GPL-2.0-or-later.

👤 Author

Ahmad Wael
Website: www.bbioon.com

Made with 🌱 for plant lovers everywhere