Arabic Search Enhancement

Beschrijving

Arabic Search Enhancement is a production-ready WordPress plugin that dramatically improves search functionality for Arabic content. It addresses the common problem where Arabic searches fail due to variations in diacritics, letter forms, and typing styles.

Key Features

  • Smart Arabic Text Normalization – Removes diacritics and normalizes letter forms for comprehensive search results
  • Elementor Search Widget Support – Full compatibility with Elementor’s search widgets and AJAX functionality
  • Multi-term Search Support – Handles multiple Arabic search terms with intelligent AND logic
  • Performance Optimized – Built-in caching system for fast repeated searches
  • RTL Interface Support – Complete right-to-left admin interface for Arabic users
  • Configurable Settings – Full admin panel for customizing search behavior
  • Developer Friendly – Built with SOLID principles and modern PHP practices

Search Improvements

Before: Searching for “مكتوب” won’t find “مَكْتُوب” (with diacritics)
After: Smart normalization finds all variations automatically

Before: “الكتاب” won’t match “ألكتاب” (different Alef forms)
After: All Alef variations (أ إ آ ٱ) treated as same letter

Normalization Rules

  1. Diacritics Removal: All Tashkeel marks (َ ُ ِ ّ ْ ً ٌ ٍ etc.)
  2. Alef Unification: أ إ آ ٱ ا
  3. Taa Marbuta: ة ه
  4. Yaa Normalization: ى ي
  5. Hamza Variations: ؤ و, ئ ي
  6. Tatweel Removal: ـ (kashida)

Technical Highlights

  • SQL-level Processing – Database queries optimized for Arabic text
  • Intelligent Caching – Performance monitoring and optimization
  • WordPress Integration – Uses WordPress hooks and APIs properly
  • Security First – Input sanitization and output escaping
  • Translation Ready – Full internationalization support

Perfect For

  • Arabic news websites and blogs
  • Educational institutions with Arabic content
  • Government websites in Arabic-speaking countries
  • E-commerce sites with Arabic product descriptions
  • Elementor-powered websites with Arabic search functionality
  • Any WordPress site serving Arabic-speaking users

External Services

  • The plugin does not transmit search data or analytics to any external servers; all processing and storage stay inside your WordPress database.

Technical Details

System Requirements

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • MySQL 5.6 or higher

Architecture

  • Built with SOLID principles
  • PSR-4 autoloading
  • Dependency injection
  • Interface-based design
  • Comprehensive error handling

Performance

  • SQL-level normalization
  • Intelligent caching system
  • Minimal resource usage
  • Database query optimization

Support

For support, bug reports, or feature requests, please contact the developer or visit the plugin support forum.

Privacy

This plugin collects and stores anonymous search analytics data to improve search functionality. The following information is collected:

  • Search queries (anonymized and used for statistics only)
  • Search result counts and language detection
  • Search timestamps (for trend analysis)

No personal information is collected, including:
* User names, emails, or IP addresses
* Personal identifiable information (PII)
* User browsing behavior outside of search functionality

All data collection can be disabled through the plugin settings. Data is stored locally in your WordPress database and is not transmitted to external servers.

For complete privacy transparency, you may review the source code at the plugin repository.

Schermafbeeldingen

  • Admin settings page with configuration options
  • Search results showing improved Arabic matching
  • Self-test functionality verifying normalization
  • RTL interface for Arabic administrators

Installatie

  1. Upload the plugin files to the /wp-content/plugins/arabic-search-enhancement directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Navigate to Settings > Arabic Search to configure the plugin (optional)
  4. Run the self-test to verify everything is working correctly

FAQ

Does this work with all Arabic dialects?

Yes! The plugin normalizes standard Arabic text patterns that are common across all Arabic dialects and Modern Standard Arabic.

Will this slow down my website?

No, the plugin is performance-optimized with intelligent caching. Search queries are processed at the database level for maximum efficiency.

Can I customize which post types are searched?

Absolutely! The admin panel allows you to select exactly which post types should be included in enhanced searches.

Does it work with other search plugins?

The plugin modifies WordPress core search functionality, so compatibility with other search plugins depends on their implementation. Test thoroughly if using multiple search plugins.

Is it translation ready?

Yes! The plugin includes complete Arabic translations and RTL interface support. Additional languages can be added easily.

Beoordelingen

28 april 2026
هذه الاضافة هي ما كان يفتقده البحث باللغة العربية في ووردبريس
Lees 1 beoordeling

Bijdragers & ontwikkelaars

“Arabic Search Enhancement” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

Vertaal “Arabic Search Enhancement” in je eigen taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

1.4.8

  • Fix: Addressed manual review feedback (Review 3.8RC1).
  • Fix: Corrected placement of namespace declarations in PHP files.
  • Fix: Updated option names to use strict prefixing (arabseen_).
  • Update: Excluded documentation folder to prevent external link flags.
  • Update: Cleaned release metadata and removed development-only submission tooling from the runtime package.

1.4.7

  • Fix: Critical issue where search terms were being discarded in query generation.
  • Update: Improved file path handling for better WordPress standard compliance.
  • Update: Removed custom translation build scripts in favor of native system.

1.4.6

  • Fix: Suppressed error_log warning in SearchQueryModifier.php (already wrapped in WP_DEBUG).
  • Note: Text domain is correctly set to arabic-search-enhancement. Mismatches in automated scans are due to the review environment’s folder naming (e.g., adding version suffix).

1.4.5

  • Fix: Resolved remaining WordPress.DB.PreparedSQL.NotPrepared errors by ensuring literal SQL strings are passed to $wpdb->prepare().
  • Fix: Confirmed resolution of WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound in build scripts.
  • Clarification: The TextDomainMismatch errors are considered false positives, as the plugin correctly uses arabic-search-enhancement as its text domain.

1.4.4

  • Fix: Resolved PreparedSQL.NotPrepared issues by explicitly inlining SQL query strings.
  • Fix: Addressed NamingConventions.PrefixAllGlobals warnings in translation build scripts.
  • Fix: Handled DirectDatabaseQuery and UnescapedDBParameter warnings for core plugin functionality.

1.4.3

  • Fix: Resolved WordPress.DB.PreparedSQL.NotPrepared issues by inlining SQL queries into $wpdb->prepare() calls.

1.4.2

  • Fix: Added missing translator comments to resolve automated check errors.

1.4.1

  • Fix: Removed discouraged load_plugin_textdomain() call as translations are handled automatically by WordPress.org for hosted plugins.

1.4.0

  • Compliance Update – Final WordPress.org Plugin Directory compliance fixes
  • Security Hardening – Addressed all Plugin Check errors and warnings
  • Code Quality – Improved adherence to WordPress Coding Standards
  • Ownership – Verified ownership and updated contact information
  • Fixes – Resolved output escaping, nonce verification, and database query issues

1.3.0

  • WordPress.org Plugin Directory compliance fixes
  • Proper Output Escaping – All translation functions now use esc_html_e() and esc_html__()
  • Asset Enqueuing – Removed inline styles/scripts, implemented proper wp_enqueue_* functions
  • Ownership Verification – Updated Plugin URI, Author, and Contributors to yasircs4
  • Security Enhancements – Improved input sanitization and output escaping
  • Code Quality – Full compliance with WordPress Coding Standards
  • Performance – Optimized asset loading and caching
  • Documentation – Updated all version references and documentation

1.1.0

  • Complete rewrite with modern architecture
  • Elementor Search Widget Compatibility – Full support for Elementor’s search widgets and AJAX requests
  • Enhanced Search Detection – Supports custom query variables (search_term, custom_search)
  • Frontend AJAX Support – Works with Elementor Pro search forms and live search features
  • Filterable Action Support – Extensible via arabic_search_enhancement_frontend_ajax_actions filter
  • Improved performance with intelligent caching
  • Better error handling and validation
  • SOLID principles implementation
  • Enhanced admin interface with self-test
  • Multi-term search support with AND logic
  • Full Arabic language support with RTL interface
  • Complete internationalization system
  • Translation files (PO/MO/JSON) included
  • Production-ready with comprehensive testing

1.0.1

  • Initial release
  • Basic Arabic text normalization
  • Simple search query modification