Changeset 3756452

Timestamp:

10/20/2026 10:37:47 AM (27 hours ago)

Author:

webban

Message:

1.0.1: fix three normalizer false positives; guard uninstall; bilingual readme (EN/FA)

Location:

matnban/trunk

Files:

• includes/class-matnban-normalizer.php (modified) (2 diffs)
• matnban.php (modified) (2 diffs)
• readme.txt (modified) (4 diffs)
• uninstall.php (modified) (1 diff)

matnban/trunk/includes/class-matnban-normalizer.php

@@ -193 +193 @@
                         /* «می» به‌عنوان اسم مستقل (ماهِ مِی، جامِ می، قدِ می…) به واژهٔ بعدی نچسبد */
                         $MI_NOUN = '(?<!ماه )(?<!جام )(?<!قد )(?<!باده )(?<!پیمانه )';
-                        $text = preg_replace( '/' . $MI_NOUN . $B . '(ن?می)' . $SP . '(?=[' . $AL . ']{2,})/u', '$1' . $Z, $text, -1, $n );
+                        /* «می را» (می + حرف را): می این‌جا اسم/مفعول است، نه پیشوند فعل — نمی‌چسبد */
+                        $RA = '(?!را(?![' . $AL . ']))';
+                        $text = preg_replace( '/' . $MI_NOUN . $B . '(ن?می)' . $SP . $RA . '(?=[' . $AL . ']{2,})/u', '$1' . $Z, $text, -1, $n );
                         $this->add_stat( 'prefix_mi', $n );
                 }
@@ -208 +210 @@
 
                 if ( $this->on( 'suffix_tar' ) ) {
-                        $text = preg_replace( '/(?<=[' . $AL . '])' . $SP . '(تر|ترین)' . $E . '/u', $Z . '$1', $text, -1, $n );
+                        /* واژهٔ قبلی دست‌کم دو حرف داشته باشد تا «خشک و تر» (تر = خیس) دست نخورد — اصلاح ۱.۰.۱ */
+                        $text = preg_replace( '/(?<=[' . $AL . '][' . $AL . '])' . $SP . '(تر|ترین)' . $E . '/u', $Z . '$1', $text, -1, $n );
                         $this->add_stat( 'suffix_tar', $n );
                 }
 
                 if ( $this->on( 'suffix_verb' ) ) {
-                        $text = preg_replace( '/(?<=ه)' . $SP . '(ام|ای|ایم|اید|اند)' . $E . '/u', $Z . '$1', $text, -1, $n );
+                        /* «که ای کاش»، «چه ای»، «نه ای» ندا/قید است، نه شناسهٔ فعل — اصلاح ۱.۰.۱ */
+                        $text = preg_replace( '/(?<!(?<![' . $AL . '\x{200C}])که)(?<!(?<![' . $AL . '\x{200C}])چه)(?<!(?<![' . $AL . '\x{200C}])نه)(?<=ه)' . $SP . '(ام|ای|ایم|اید|اند)' . $E . '/u', $Z . '$1', $text, -1, $n );
                         $this->add_stat( 'suffix_verb', $n );
                 }

matnban/trunk/matnban.php

@@ -4 +4 @@
  * Plugin URI:        https://webbanwp.ir/
  * Description:       Persian writing & typography assistant — automatic Persian spelling and half-space (ZWNJ) correction, Arabic character cleanup, readability analysis and a site-wide writing health report.
- * Version:           1.0.0
+ * Version:           1.0.1
  * Requires at least: 5.8
  * Requires PHP:      8.1
@@ -19 +19 @@
 }
 
-define( 'MATNBAN_VERSION', '1.0.0' );
+define( 'MATNBAN_VERSION', '1.0.1' );
 define( 'MATNBAN_FILE', __FILE__ );
 define( 'MATNBAN_DIR', plugin_dir_path( __FILE__ ) );

matnban/trunk/readme.txt

@@ -5 +5 @@
 Tested up to: 7.1
 Requires PHP: 8.1
-Stable tag: 1.0.0
+Stable tag: 1.0.1
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
-Persian writing & typography assistant — one-click spelling and half-space (ZWNJ) correction, Arabic character cleanup and readability analysis.
+Persian writing assistant — ZWNJ (half-space) fixes, Arabic character cleanup, readability and a site-wide writing report. دستیار نگارش فارسی وردپرس.
 
 == Description ==
@@ -21 +21 @@
 = Features =
 
-* One-click correction in the post editor — 16+ rules: ZWNJ for verb prefixes (mi, nami, bi) and suffixes (ha, tar, tarin), the ezafe ye, Arabic character and digit conversion to Persian, Persian quotes and punctuation, kashida removal, and cleanup of invisible direction marks (RLM/LRM) that break copied text
+* One-click correction in the post editor — 17 rules: ZWNJ for verb prefixes (mi, nami, bi) and suffixes (ha, tar, tarin), the ezafe ye, Arabic character and digit conversion to Persian, Persian quotes and punctuation, kashida removal, and cleanup of invisible direction marks (RLM/LRM) that break copied text
 * Optional automatic correction on save, or on display (display mode never modifies the database)
 * Persian readability panel in the post editor: sentence-length analysis and keyword density with Persian stemming — the focus keyphrase is read automatically from Yoast SEO or Rank Math when present
 * Site-wide writing health report: scan all posts, list the ones with issues, export to CSV
 * Guidance for Persian-friendly image filenames and alt text
+* Every rule can be switched off individually; the plugin never touches HTML, code, shortcodes, links or English text
 
 All processing happens locally on your site with PHP. This plugin sends no requests to any external service.
 
-A premium version with bulk post fixing, an AI assistant (using your own API key) and a smart English slug generator is sold separately at https://webbanwp.ir/ — the code for those features is not included in this plugin.
+A premium version with bulk post fixing, a 30-day undo, an AI assistant (using your own API key) and a smart English slug generator is sold separately at https://webbanwp.ir/ — the code for those features is not included in this plugin.
+
+= فارسی — معرفی کوتاه =
+
+**متن‌بان** دستیار نگارش فارسی برای وردپرس است؛ همان‌طور که افزونه‌های سئو کارِ کلمهٔ کلیدی را انجام می‌دهند، متن‌بان کارِ نگارش فارسی را انجام می‌دهد.
+
+نگارش فارسی قاعده‌هایی دارد که ویرایشگرهای عمومی بی‌صدا خرابش می‌کنند: نیم‌فاصلهٔ جاافتاده در فعل‌های پیشوندی («می رود»)، حروف عربیِ هم‌شکل با فارسی («ي»، «ك») که جست‌وجو و غلط‌یاب را از کار می‌اندازد، ارقام عربی («٤٥»)، گیومهٔ اشتباه، کشیدهٔ تزئینی، و نشانه‌های جهتِ نامرئی که از پیام‌رسان‌ها کپی می‌شوند. متن‌بان همهٔ این‌ها را اصلاح می‌کند — با یک کلیک، یا خودکار.
+
+= امکانات =
+
+* اصلاح یک‌کلیکی در ویرایشگر مطلب — ۱۷ قاعده: نیم‌فاصلهٔ «می/نمی»، «بی»، «ها»، «تر/ترین»، شناسهٔ فعل و یای میانجی؛ تبدیل حروف و ارقام عربی به فارسی؛ علائم نگارشی و گیومهٔ فارسی؛ حذف کشیده، فاصله‌های تکراری و نویسه‌های نامرئی
+* اصلاح خودکار هنگام ذخیره (اختیاری) یا هنگام نمایش؛ حالت نمایش هیچ تغییری در دیتابیس نمی‌دهد
+* پنل خوانایی فارسی در ویرایشگر: طول جمله، تنوع آغاز جمله‌ها و چگالی کلمهٔ کلیدی با ریشه‌یابی فارسی. کلمهٔ کلیدی به‌طور خودکار از Yoast SEO یا Rank Math خوانده می‌شود
+* گزارش سلامت نگارش کل سایت: اسکن همهٔ مطالب، فهرست مطالب نیازمند توجه، و خروجی CSV
+* راهنمای نام فایل و متن جانشین (alt) تصاویر برای فارسی
+* هر قاعده جداگانه خاموش/روشن می‌شود؛ افزونه هرگز به HTML، کد، شورت‌کد، لینک و متن انگلیسی دست نمی‌زند
+
+همهٔ پردازش‌ها محلی و با PHP روی سایت خودتان انجام می‌شود؛ این افزونه هیچ درخواستی به بیرون نمی‌فرستد.
+
+نسخهٔ حرفه‌ای (اصلاح گروهی کل آرشیو، بازگردانی ۳۰ روزه، دستیار هوش مصنوعی و نامک انگلیسی هوشمند) محصولی جداگانه در https://webbanwp.ir/ است و کد آن در این افزونه نیست.
 
 == Installation ==
@@ -37 +57 @@
 3. In the post editor, open the Matnban panel and click the fix button.
 4. For the site-wide report: Matnban → Site Report → Scan posts.
+
+= نصب به فارسی =
+
+۱. از پیشخوان ← افزونه‌ها ← افزودن، «Matnban» را جست‌وجو و نصب کنید؛ یا فایل zip را بارگذاری کنید.
+۲. به پیشخوان ← متن‌بان بروید و قاعده‌ها را مرور کنید (پیش‌فرض‌ها بر پایهٔ رسم‌الخط استاندارد فارسی است).
+۳. در ویرایشگر مطلب، پنل متن‌بان را باز کنید و دکمهٔ اصلاح را بزنید.
+۴. برای گزارش کل سایت: متن‌بان ← گزارش سایت ← اسکن مطالب.
 
 == Frequently Asked Questions ==
@@ -50 +77 @@
 
 = What is the difference between this and the premium version? =
-This repository version is free and fully functional on its own: manual fixing, automatic fixing, readability analysis and the site report are all included. The premium version (a separate product sold at webbanwp.ir, whose code is not included here) adds bulk fixing, an AI assistant and smart English slugs.
+This repository version is free and fully functional on its own: manual fixing, automatic fixing, readability analysis and the site report are all included. The premium version (a separate product sold at webbanwp.ir, whose code is not included here) adds bulk fixing, a 30-day undo, an AI assistant and smart English slugs.
+
+= متن من جایی ذخیره یا ارسال می‌شود؟ =
+نه. همهٔ اصلاح‌ها با PHP روی سایت خودتان انجام می‌شود و افزونه هیچ درخواست بیرونی ندارد.
+
+= با Yoast SEO یا Rank Math تداخل دارد؟ =
+نه؛ مکمل آن‌هاست. کلمهٔ کلیدی را از هر کدام‌که نصب باشد می‌خواند و تحلیل فارسی را روی همان انجام می‌دهد.
+
+= نیم‌فاصله‌های درست متن من خراب می‌شود؟ =
+نه. نیم‌فاصله‌های استاندارد حفظ می‌شوند؛ فقط شکل‌های نادرست (پیشوندی که با فاصلهٔ معمولی جدا شده) به نیم‌فاصلهٔ درست تبدیل می‌شود.
+
+= تفاوتش با نسخهٔ حرفه‌ای چیست؟ =
+این نسخه رایگان و کامل است: اصلاح دستی، اصلاح خودکار، تحلیل خوانایی و گزارش سایت همه در آن هست. نسخهٔ حرفه‌ای (محصولی جداگانه در webbanwp.ir که کدش اینجا نیست) اصلاح گروهی، بازگردانی ۳۰ روزه، دستیار هوش مصنوعی و نامک انگلیسی هوشمند را اضافه می‌کند.
 
 == Screenshots ==
 
-1. The Matnban panel in the post editor — one-click Persian writing correction and readability analysis
-2. The site-wide writing health report
-3. Writing rules with before/after examples
+1. The Matnban panel in the post editor — one-click Persian writing correction and readability analysis (پنل متن‌بان در ویرایشگر: اصلاح یک‌کلیکی و تحلیل خوانایی)
+2. The site-wide writing health report (گزارش سلامت نگارش کل سایت)
+3. Writing rules with before/after examples (قاعده‌های نگارشی با نمونهٔ پیش و پس از اصلاح)
 
 == Changelog ==
+
+= 1.0.1 =
+* Fixed three false positives that could corrupt correct text:
+  * "خشک و تر" (and similar) is no longer joined into "خشک و‌تر" — the suffix rule now requires a word of at least two letters before "تر/ترین".
+  * "گفت که ای کاش" is no longer changed to "گفت که‌ای کاش" — "که/چه/نه" before "ای/ام/اند" are treated as particles, not verb endings.
+  * "این می را ببین" is no longer changed to "این می‌را ببین" — a bare "می" followed by "را" is a noun, not the verb prefix.
+* Added regression tests for all three cases plus two positive cases that must keep working.
+* Readme is now bilingual (English + Persian).
+
+= 1.0.1 (فارسی) =
+* رفع سه خطای تشخیص که می‌توانست متن درست را تغییر دهد: «خشک و تر»، «گفت که ای کاش» و «این می را ببین» دیگر اصلاح نمی‌شوند.
+* افزودن آزمون رگرسیون برای همان سه مورد، به‌همراه دو نمونهٔ درست که باید همچنان اصلاح شوند.
+* راهنمای افزونه (readme) دوزبانه شد: انگلیسی + فارسی.
 
 = 1.0.0 =
 * Initial release on WordPress.org
 * Conversion of invisible direction marks (RLM/LRM) misused in place of ZWNJ
+
+== Upgrade Notice ==
+
+= 1.0.1 =
+Fixes three false positives that could alter correct text. Recommended update. — رفع سه خطای تشخیص که ممکن بود متن درست را تغییر دهد؛ به‌روزرسانی توصیه می‌شود.

matnban/trunk/uninstall.php

@@ -1 +1 @@
 <?php
+/**
+ * حذف افزونهٔ رایگان متن‌بان.
+ * اگر متن‌بان پرو نصب باشد، تنظیمات و گزارش مشترک پاک نمی‌شود
+ * (پرو همان آپشن‌ها را می‌خواند؛ حذف رایگان نباید داده‌های پرو را نابود کند).
+ */
 if ( ! defined( 'WP_UNINSTALL_PLUGIN' ) ) {
         exit;
 }
-delete_option( 'matnban_settings' );
-delete_option( 'matnban_report' );
-delete_option( 'matnban_scan_progress' );
-delete_option( 'matnban_cron_progress' );
-delete_metadata( 'post', 0, '_matnban_scan', '', true );
-delete_metadata( 'post', 0, '_matnban_in_summary', '', true );
+
+$matnban_keep_shared = false;
+if ( defined( 'WP_PLUGIN_DIR' ) ) {
+        foreach ( array( 'matnban-pro/matnban.php', 'matnban-pro-pro/matnban.php' ) as $matnban_pro_file ) {
+                if ( file_exists( WP_PLUGIN_DIR . '/' . $matnban_pro_file ) ) {
+                        $matnban_keep_shared = true;
+                        break;
+                }
+        }
+}
+if ( function_exists( 'is_plugin_active' ) ) {
+        include_once ABSPATH . 'wp-admin/includes/plugin.php';
+        if ( is_plugin_active( 'matnban-pro/matnban.php' ) ) {
+                $matnban_keep_shared = true;
+        }
+}
+
+if ( ! $matnban_keep_shared ) {
+        delete_option( 'matnban_settings' );
+        delete_option( 'matnban_report' );
+        delete_option( 'matnban_scan_progress' );
+        delete_option( 'matnban_cron_progress' );
+        delete_metadata( 'post', 0, '_matnban_scan', '', true );
+        delete_metadata( 'post', 0, '_matnban_in_summary', '', true );
+}
+
 wp_clear_scheduled_hook( 'matnban_weekly_scan' );
 wp_clear_scheduled_hook( 'matnban_scan_continue' );
 
-$GLOBALS['wpdb']->query( "DELETE FROM {$GLOBALS['wpdb']->options} WHERE option_name LIKE '\_transient\_matnban\_orig\_%' OR option_name LIKE '\_transient\_timeout\_matnban\_orig\_%'" );
+if ( ! $matnban_keep_shared ) {
+        $GLOBALS['wpdb']->query( "DELETE FROM {$GLOBALS['wpdb']->options} WHERE option_name LIKE '\_transient\_matnban\_orig\_%' OR option_name LIKE '\_transient\_timeout\_matnban\_orig\_%'" );
+}