{"id":257387,"date":"2026-04-28T20:22:08","date_gmt":"2026-04-28T20:22:08","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/arabic-search-enhancement\/"},"modified":"2026-04-28T20:21:49","modified_gmt":"2026-04-28T20:21:49","slug":"arabic-search-enhancement","status":"publish","type":"plugin","link":"https:\/\/snd.wordpress.org\/plugins\/arabic-search-enhancement\/","author":14205090,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.4.8","stable_tag":"1.4.8","tested":"6.9.4","requires":"5.0","requires_php":"7.4","requires_plugins":null,"header_name":"Arabic Search Enhancement","header_author":"yasircs4","header_description":"Improves WordPress search for Arabic content by normalizing Arabic text variations, diacritics, and letter forms","assets_banners_color":"154c5b","last_updated":"2026-04-28 20:21:49","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/maisra.net\/arabic-search-enhancement","header_author_uri":"https:\/\/maisra.net\/","rating":5,"author_block_rating":0,"active_installs":0,"downloads":89,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.4.8":{"tag":"1.4.8","author":"yasircs4","date":"2026-04-28 20:21:49"}},"upgrade_notice":{"1.4.8":"<p>First WordPress.org release with finalized compliance metadata and runtime cleanup.<\/p>","1.4.7":"<p>Critical search logic fix and compliance updates.<\/p>","1.4.6":"<p>Minor fix for debug logging compliance.<\/p>","1.4.5":"<p>Final compliance update addressing all identified automated scan errors.<\/p>","1.4.4":"<p>Comprehensive security and coding standards compliance update.<\/p>","1.4.3":"","1.4.2":"<p>Resolved translation comment issues. Ready for review.<\/p>","1.4.1":"<p>Addresses automated scan rejection regarding load_plugin_textdomain() call. This version is ready for re-submission.<\/p>","1.4.0":"<p>Final compliance update for WordPress.org submission. Includes security hardening and code quality improvements.<\/p>","1.3.0":"<p>WordPress.org compliance update. All security and code quality issues resolved. This version is fully compliant with WordPress Plugin Directory guidelines and ready for approval.<\/p>","1.1.0":"<p>Major update with complete rewrite. Backup your site before upgrading. New features include performance improvements, better admin interface, and full Arabic language support.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3517783,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3517783,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3517783,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3517783,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.8"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3517783,"resolution":"1","location":"assets","locale":"","width":1440,"height":900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3517783,"resolution":"2","location":"assets","locale":"","width":1440,"height":900},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3517783,"resolution":"3","location":"assets","locale":"","width":1440,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3517783,"resolution":"4","location":"assets","locale":"","width":1440,"height":900}},"screenshots":{"1":"Admin settings page with configuration options","2":"Search results showing improved Arabic matching","3":"Self-test functionality verifying normalization","4":"RTL interface for Arabic administrators"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1113,99,46330,5811,944],"plugin_category":[48],"plugin_contributors":[261318],"plugin_business_model":[],"class_list":["post-257387","plugin","type-plugin","status-publish","hentry","plugin_tags-arabic","plugin_tags-multilingual","plugin_tags-normalization","plugin_tags-rtl","plugin_tags-search","plugin_category-language-tools","plugin_contributors-yasircs4","plugin_committers-yasircs4"],"banners":{"banner":"https:\/\/ps.w.org\/arabic-search-enhancement\/assets\/banner-772x250.png?rev=3517783","banner_2x":"https:\/\/ps.w.org\/arabic-search-enhancement\/assets\/banner-1544x500.png?rev=3517783","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/arabic-search-enhancement\/assets\/icon-128x128.png?rev=3517783","icon_2x":"https:\/\/ps.w.org\/arabic-search-enhancement\/assets\/icon-256x256.png?rev=3517783","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/arabic-search-enhancement\/assets\/screenshot-1.png?rev=3517783","caption":"Admin settings page with configuration options"},{"src":"https:\/\/ps.w.org\/arabic-search-enhancement\/assets\/screenshot-2.png?rev=3517783","caption":"Search results showing improved Arabic matching"},{"src":"https:\/\/ps.w.org\/arabic-search-enhancement\/assets\/screenshot-3.png?rev=3517783","caption":"Self-test functionality verifying normalization"},{"src":"https:\/\/ps.w.org\/arabic-search-enhancement\/assets\/screenshot-4.png?rev=3517783","caption":"RTL interface for Arabic administrators"}],"raw_content":"<!--section=description-->\n<p><strong>Arabic Search Enhancement<\/strong> 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.<\/p>\n\n<h4>Key Features<\/h4>\n\n<ul>\n<li><strong>Smart Arabic Text Normalization<\/strong> - Removes diacritics and normalizes letter forms for comprehensive search results<\/li>\n<li><strong>Elementor Search Widget Support<\/strong> - Full compatibility with Elementor's search widgets and AJAX functionality<\/li>\n<li><strong>Multi-term Search Support<\/strong> - Handles multiple Arabic search terms with intelligent AND logic<\/li>\n<li><strong>Performance Optimized<\/strong> - Built-in caching system for fast repeated searches<\/li>\n<li><strong>RTL Interface Support<\/strong> - Complete right-to-left admin interface for Arabic users<\/li>\n<li><strong>Configurable Settings<\/strong> - Full admin panel for customizing search behavior<\/li>\n<li><strong>Developer Friendly<\/strong> - Built with SOLID principles and modern PHP practices<\/li>\n<\/ul>\n\n<h4>Search Improvements<\/h4>\n\n<p><strong>Before<\/strong>: Searching for \"\u0645\u0643\u062a\u0648\u0628\" won't find \"\u0645\u064e\u0643\u0652\u062a\u064f\u0648\u0628\" (with diacritics)\n<strong>After<\/strong>: Smart normalization finds all variations automatically<\/p>\n\n<p><strong>Before<\/strong>: \"\u0627\u0644\u0643\u062a\u0627\u0628\" won't match \"\u0623\u0644\u0643\u062a\u0627\u0628\" (different Alef forms)\n<strong>After<\/strong>: All Alef variations (\u0623 \u0625 \u0622 \u0671) treated as same letter<\/p>\n\n<h4>Normalization Rules<\/h4>\n\n<ol>\n<li><strong>Diacritics Removal<\/strong>: All Tashkeel marks (\u064e \u064f \u0650 \u0651 \u0652 \u064b \u064c \u064d etc.)<\/li>\n<li><strong>Alef Unification<\/strong>: \u0623 \u0625 \u0622 \u0671 \u2192 \u0627<\/li>\n<li><strong>Taa Marbuta<\/strong>: \u0629 \u2192 \u0647<\/li>\n<li><strong>Yaa Normalization<\/strong>: \u0649 \u2192 \u064a<\/li>\n<li><strong>Hamza Variations<\/strong>: \u0624 \u2192 \u0648, \u0626 \u2192 \u064a<\/li>\n<li><strong>Tatweel Removal<\/strong>: \u0640 (kashida)<\/li>\n<\/ol>\n\n<h4>Technical Highlights<\/h4>\n\n<ul>\n<li><strong>SQL-level Processing<\/strong> - Database queries optimized for Arabic text<\/li>\n<li><strong>Intelligent Caching<\/strong> - Performance monitoring and optimization<\/li>\n<li><strong>WordPress Integration<\/strong> - Uses WordPress hooks and APIs properly<\/li>\n<li><strong>Security First<\/strong> - Input sanitization and output escaping<\/li>\n<li><strong>Translation Ready<\/strong> - Full internationalization support<\/li>\n<\/ul>\n\n<h4>Perfect For<\/h4>\n\n<ul>\n<li>Arabic news websites and blogs<\/li>\n<li>Educational institutions with Arabic content<\/li>\n<li>Government websites in Arabic-speaking countries<\/li>\n<li>E-commerce sites with Arabic product descriptions<\/li>\n<li><strong>Elementor-powered websites<\/strong> with Arabic search functionality<\/li>\n<li>Any WordPress site serving Arabic-speaking users<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<ul>\n<li>The plugin does not transmit search data or analytics to any external servers; all processing and storage stay inside your WordPress database.<\/li>\n<\/ul>\n\n<h3>Technical Details<\/h3>\n\n<h4>System Requirements<\/h4>\n\n<ul>\n<li>WordPress 5.0 or higher<\/li>\n<li>PHP 7.4 or higher<\/li>\n<li>MySQL 5.6 or higher<\/li>\n<\/ul>\n\n<h4>Architecture<\/h4>\n\n<ul>\n<li>Built with SOLID principles<\/li>\n<li>PSR-4 autoloading<\/li>\n<li>Dependency injection<\/li>\n<li>Interface-based design<\/li>\n<li>Comprehensive error handling<\/li>\n<\/ul>\n\n<h4>Performance<\/h4>\n\n<ul>\n<li>SQL-level normalization<\/li>\n<li>Intelligent caching system<\/li>\n<li>Minimal resource usage<\/li>\n<li>Database query optimization<\/li>\n<\/ul>\n\n<h3>Support<\/h3>\n\n<p>For support, bug reports, or feature requests, please contact the developer or visit the plugin support forum.<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>This plugin collects and stores anonymous search analytics data to improve search functionality. The following information is collected:<\/p>\n\n<ul>\n<li>Search queries (anonymized and used for statistics only)<\/li>\n<li>Search result counts and language detection<\/li>\n<li>Search timestamps (for trend analysis)<\/li>\n<\/ul>\n\n<p><strong>No personal information is collected<\/strong>, including:\n* User names, emails, or IP addresses\n* Personal identifiable information (PII)\n* User browsing behavior outside of search functionality<\/p>\n\n<p>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.<\/p>\n\n<p>For complete privacy transparency, you may review the source code at the plugin repository.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/arabic-search-enhancement<\/code> directory, or install the plugin through the WordPress plugins screen directly.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress<\/li>\n<li>Navigate to Settings &gt; Arabic Search to configure the plugin (optional)<\/li>\n<li>Run the self-test to verify everything is working correctly<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20work%20with%20all%20arabic%20dialects%3F\"><h3>Does this work with all Arabic dialects?<\/h3><\/dt>\n<dd><p>Yes! The plugin normalizes standard Arabic text patterns that are common across all Arabic dialects and Modern Standard Arabic.<\/p><\/dd>\n<dt id=\"will%20this%20slow%20down%20my%20website%3F\"><h3>Will this slow down my website?<\/h3><\/dt>\n<dd><p>No, the plugin is performance-optimized with intelligent caching. Search queries are processed at the database level for maximum efficiency.<\/p><\/dd>\n<dt id=\"can%20i%20customize%20which%20post%20types%20are%20searched%3F\"><h3>Can I customize which post types are searched?<\/h3><\/dt>\n<dd><p>Absolutely! The admin panel allows you to select exactly which post types should be included in enhanced searches.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20other%20search%20plugins%3F\"><h3>Does it work with other search plugins?<\/h3><\/dt>\n<dd><p>The plugin modifies WordPress core search functionality, so compatibility with other search plugins depends on their implementation. Test thoroughly if using multiple search plugins.<\/p><\/dd>\n<dt id=\"is%20it%20translation%20ready%3F\"><h3>Is it translation ready?<\/h3><\/dt>\n<dd><p>Yes! The plugin includes complete Arabic translations and RTL interface support. Additional languages can be added easily.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.4.8<\/h4>\n\n<ul>\n<li><strong>Fix:<\/strong> Addressed manual review feedback (Review 3.8RC1).<\/li>\n<li><strong>Fix:<\/strong> Corrected placement of <code>namespace<\/code> declarations in PHP files.<\/li>\n<li><strong>Fix:<\/strong> Updated option names to use strict prefixing (<code>arabseen_<\/code>).<\/li>\n<li><strong>Update:<\/strong> Excluded documentation folder to prevent external link flags.<\/li>\n<li><strong>Update:<\/strong> Cleaned release metadata and removed development-only submission tooling from the runtime package.<\/li>\n<\/ul>\n\n<h4>1.4.7<\/h4>\n\n<ul>\n<li><strong>Fix:<\/strong> Critical issue where search terms were being discarded in query generation.<\/li>\n<li><strong>Update:<\/strong> Improved file path handling for better WordPress standard compliance.<\/li>\n<li><strong>Update:<\/strong> Removed custom translation build scripts in favor of native system.<\/li>\n<\/ul>\n\n<h4>1.4.6<\/h4>\n\n<ul>\n<li><strong>Fix:<\/strong> Suppressed <code>error_log<\/code> warning in <code>SearchQueryModifier.php<\/code> (already wrapped in <code>WP_DEBUG<\/code>).<\/li>\n<li><strong>Note:<\/strong> Text domain is correctly set to <code>arabic-search-enhancement<\/code>. Mismatches in automated scans are due to the review environment's folder naming (e.g., adding version suffix).<\/li>\n<\/ul>\n\n<h4>1.4.5<\/h4>\n\n<ul>\n<li><strong>Fix:<\/strong> Resolved remaining <code>WordPress.DB.PreparedSQL.NotPrepared<\/code> errors by ensuring literal SQL strings are passed to <code>$wpdb-&gt;prepare()<\/code>.<\/li>\n<li><strong>Fix:<\/strong> Confirmed resolution of <code>WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound<\/code> in build scripts.<\/li>\n<li><strong>Clarification:<\/strong> The <code>TextDomainMismatch<\/code> errors are considered false positives, as the plugin correctly uses <code>arabic-search-enhancement<\/code> as its text domain.<\/li>\n<\/ul>\n\n<h4>1.4.4<\/h4>\n\n<ul>\n<li><strong>Fix:<\/strong> Resolved <code>PreparedSQL.NotPrepared<\/code> issues by explicitly inlining SQL query strings.<\/li>\n<li><strong>Fix:<\/strong> Addressed <code>NamingConventions.PrefixAllGlobals<\/code> warnings in translation build scripts.<\/li>\n<li><strong>Fix:<\/strong> Handled <code>DirectDatabaseQuery<\/code> and <code>UnescapedDBParameter<\/code> warnings for core plugin functionality.<\/li>\n<\/ul>\n\n<h4>1.4.3<\/h4>\n\n<ul>\n<li><strong>Fix:<\/strong> Resolved <code>WordPress.DB.PreparedSQL.NotPrepared<\/code> issues by inlining SQL queries into <code>$wpdb-&gt;prepare()<\/code> calls.<\/li>\n<\/ul>\n\n<h4>1.4.2<\/h4>\n\n<ul>\n<li><strong>Fix:<\/strong> Added missing translator comments to resolve automated check errors.<\/li>\n<\/ul>\n\n<h4>1.4.1<\/h4>\n\n<ul>\n<li><strong>Fix:<\/strong> Removed discouraged <code>load_plugin_textdomain()<\/code> call as translations are handled automatically by WordPress.org for hosted plugins.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li><strong>Compliance Update<\/strong> - Final WordPress.org Plugin Directory compliance fixes<\/li>\n<li><strong>Security Hardening<\/strong> - Addressed all Plugin Check errors and warnings<\/li>\n<li><strong>Code Quality<\/strong> - Improved adherence to WordPress Coding Standards<\/li>\n<li><strong>Ownership<\/strong> - Verified ownership and updated contact information<\/li>\n<li><strong>Fixes<\/strong> - Resolved output escaping, nonce verification, and database query issues<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>WordPress.org Plugin Directory compliance fixes<\/li>\n<li><strong>Proper Output Escaping<\/strong> - All translation functions now use esc_html_e() and esc_html__()<\/li>\n<li><strong>Asset Enqueuing<\/strong> - Removed inline styles\/scripts, implemented proper wp_enqueue_* functions<\/li>\n<li><strong>Ownership Verification<\/strong> - Updated Plugin URI, Author, and Contributors to yasircs4<\/li>\n<li><strong>Security Enhancements<\/strong> - Improved input sanitization and output escaping<\/li>\n<li><strong>Code Quality<\/strong> - Full compliance with WordPress Coding Standards<\/li>\n<li><strong>Performance<\/strong> - Optimized asset loading and caching<\/li>\n<li><strong>Documentation<\/strong> - Updated all version references and documentation<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Complete rewrite with modern architecture<\/li>\n<li><strong>Elementor Search Widget Compatibility<\/strong> - Full support for Elementor's search widgets and AJAX requests<\/li>\n<li><strong>Enhanced Search Detection<\/strong> - Supports custom query variables (search_term, custom_search)<\/li>\n<li><strong>Frontend AJAX Support<\/strong> - Works with Elementor Pro search forms and live search features<\/li>\n<li><strong>Filterable Action Support<\/strong> - Extensible via <code>arabic_search_enhancement_frontend_ajax_actions<\/code> filter<\/li>\n<li>Improved performance with intelligent caching<\/li>\n<li>Better error handling and validation<\/li>\n<li>SOLID principles implementation<\/li>\n<li>Enhanced admin interface with self-test<\/li>\n<li>Multi-term search support with AND logic<\/li>\n<li>Full Arabic language support with RTL interface<\/li>\n<li>Complete internationalization system<\/li>\n<li>Translation files (PO\/MO\/JSON) included<\/li>\n<li>Production-ready with comprehensive testing<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Basic Arabic text normalization<\/li>\n<li>Simple search query modification<\/li>\n<\/ul>","raw_excerpt":"Enhances WordPress search for Arabic content by normalizing text variations, diacritics, and letter forms for better search results.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/257387","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=257387"}],"author":[{"embeddable":true,"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/yasircs4"}],"wp:attachment":[{"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=257387"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=257387"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=257387"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=257387"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=257387"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/snd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=257387"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}