مدیریت شماره موبایل کاربران وردپرس؛ از ذخیره تا جست‌وجو و پاک‌سازی

وردپرس در اصل برای ایمیل ساخته شده و شماره‌ی موبایل جزو فیلدهای پایه‌ی کاربر نیست. برای همین مدیریت شماره موبایل کاربران وردپرس به تصمیم‌های کوچکی بستگی دارد که اگر از ابتدا درست گرفته نشوند، بعدها به شماره‌های تکراری، قالب‌های ناهمسان و جست‌وجوی ناممکن در پیشخوان می‌انجامند. در این راهنما می‌بینید شماره را کجا و با چه قالبی نگه دارید، چطور از تکرار آن جلوگیری کنید، در فهرست کاربران ستون و جست‌وجو بسازید و کاربران قدیمی را بدون خراب‌کاری پاک‌سازی کنید.

بروزرسانی: زمان مطالعه حدود ۱۱ دقیقه نوشته‌ی تیم فنی فینگت

چرا مدیریت شماره موبایل کاربران وردپرس مسئله‌ی جدی است؟

تا وقتی سایت کوچک است، چند شماره‌ی پراکنده مشکلی ایجاد نمی‌کند. اما با رسیدن به چند هزار کاربر، شماره‌های واردشده در هزار قالب متفاوت ذخیره شده‌اند: ۰۹۱۲… با رقم فارسی، +98912…، 98912… و حتی شماره‌هایی با فاصله و خط تیره. اگر بخواهید یک مشتری را پیدا کنید، یک سفارش را پیگیری کنید یا برای دو حساب مشکوک بررسی کنید، دیگر نمی‌توانید به جست‌وجوی ساده تکیه کنید.

مدیریت شماره موبایل کاربران وردپرس یعنی پاسخ دادن به چهار پرسش از همان ابتدا: شماره کجا نگه داشته شود؟ با چه قالبی؟ چطور درستی و یکتایی آن بررسی شود؟ و مدیر سایت چطور بتواند با آن کار کند؟ پاسخ هر چهار پرسش را در ادامه آورده‌ایم. اگر مدیریت شماره موبایل کاربران وردپرس را از اول سامان بدهید، همه‌ی کارهای بعدی، از ورود با شماره تا پیام‌رسانی، ساده‌تر می‌شود.

چه کسی به این صفحه نیاز دارد؟

فروشگاه‌های ووکامرسی که با مشتری تماس می‌گیرند، سایت‌های عضویتی، کلینیک‌ها و آموزشگاه‌هایی که شماره‌ی مراجع را دارند و هر سایتی که قصد دارد ورود با شماره‌ی موبایل داشته باشد. اگر هنوز نمی‌دانید چرا شماره برای سایت مهم است، راهنمای جمع‌آوری شماره موبایل مشتری را بخوانید.

قاعده‌ی کلی: شماره را همان لحظه‌ی ورود نرمال کنید، نه بعداً. پاک‌سازی دسته‌ای هزاران رکورد همیشه سخت‌تر از جلوگیری از ورود داده‌ی ناهمسان است.

ذخیره شماره موبایل در وردپرس؛ کجا و با چه قالبی؟

برای ذخیره شماره موبایل در وردپرس بهترین جا معمولاً متای کاربر است، یعنی جدول wp_usermeta. هر کاربر یک ردیف با کلیدی مثل mobile دارد. این جایی است که ووکامرس هم برای شماره‌ی صورتحساب (billing_phone) استفاده می‌کند و ابزارهای خروجی و واردکردن وردپرس آن را می‌شناسند. نیازی نیست ستونی به جدول کاربران اضافه کنید؛ این کار با به‌روزرسانی وردپرس ناسازگار می‌شود.

نام کلید متا را سنجیده انتخاب کنید

اگر ووکامرس دارید، از قبل billing_phone را دارید. می‌توانید همان را به‌عنوان منبع حقیقت بگیرید یا کلید جدا مثل mobile بسازید و آن را با billing_phone همگام کنید. مهم این است که یک کلید منبع اصلی باشد و بقیه از آن کپی شوند، وگرنه دو شماره‌ی متفاوت برای یک کاربر خواهید داشت.

قالب واحد

همه‌ی شماره‌ها را با قالب محلی ۱۱ رقمی (09123456789) ذخیره کنید یا همه را با قالب بین‌المللی (989123456789). قالب محلی برای خواندن سریع‌تر و قالب بین‌المللی برای اتصال به سرویس‌های بیرونی ساده‌تر است. هر کدام را انتخاب کنید، به‌صورت ثابت نگه دارید و فقط هنگام نمایش یا ارسال تبدیلش کنید.

نکته‌ی رقم‌های فارسی

کاربر ایرانی ممکن است با کیبورد فارسی شماره را بزند: ۰۹۱۲۳۴۵۶۷۸۹. اگر این مقدار را همین‌طور ذخیره کنید، جست‌وجوی لاتین پیدایش نمی‌کند. رقم‌های فارسی و عربی را پیش از ذخیره به لاتین تبدیل کنید.

نمونه کد: فیلد موبایل در پروفایل و یکسان‌سازی قالب

کد زیر را در یک افزونه‌ی کوچک یا فایل functions.php قالب فرزند بگذارید. یک فیلد موبایل در پروفایل کاربر اضافه می‌کند، شماره را پیش از ذخیره نرمال می‌کند و اگر شماره‌ی تکراری باشد، آن را رد می‌کند.

تابع نرمال‌سازی و اعتبارسنجی شماره
// رقم‌های فارسی/عربی را لاتین می‌کند و قالب را به 09xxxxxxxxx می‌رساند
function fg_normalize_phone($raw) {
    $raw = strtr((string) $raw, [
        '۰' => '0', '۱' => '1', '۲' => '2', '۳' => '3', '۴' => '4',
        '۵' => '5', '۶' => '6', '۷' => '7', '۸' => '8', '۹' => '9',
        '٠' => '0', '١' => '1', '٢' => '2', '٣' => '3', '٤' => '4',
        '٥' => '5', '٦' => '6', '٧' => '7', '٨' => '8', '٩' => '9',
    ]);
    $d = preg_replace('/\D+/', '', $raw);          // فقط رقم
    if (strpos($d, '0098') === 0) $d = substr($d, 4);
    elseif (strpos($d, '98') === 0 && strlen($d) === 12) $d = substr($d, 2);
    if (strlen($d) === 10 && $d[0] === '9') $d = '0' . $d;
    return preg_match('/^09\d{9}$/', $d) ? $d : false;
}
فیلد در صفحه‌ی پروفایل و ذخیره‌ی آن
add_action('show_user_profile', 'fg_phone_field');
add_action('edit_user_profile', 'fg_phone_field');
function fg_phone_field($user) { ?>
    <h3>شماره موبایل</h3>
    <table class="form-table"><tr>
        <th><label for="mobile">موبایل</label></th>
        <td><input type="text" name="mobile" id="mobile" class="regular-text"
            value="<?php echo esc_attr(get_user_meta($user->ID, 'mobile', true)); ?>"></td>
    </tr></table>
<?php }

add_action('personal_options_update', 'fg_phone_save');
add_action('edit_user_profile_update', 'fg_phone_save');
function fg_phone_save($user_id) {
    if (!current_user_can('edit_user', $user_id) || !isset($_POST['mobile'])) return;
    $raw = wp_unslash($_POST['mobile']);
    if (trim($raw) === '') { delete_user_meta($user_id, 'mobile'); return; }
    $phone = fg_normalize_phone($raw);
    if (!$phone) return;                              // قالب نامعتبر: ذخیره نکن
    $dup = get_users([
        'meta_key' => 'mobile', 'meta_value' => $phone,
        'exclude' => [$user_id], 'number' => 1, 'fields' => 'ID',
    ]);
    if ($dup) return;                                 // شماره‌ی کس دیگری است
    update_user_meta($user_id, 'mobile', $phone);
}

این کد عمداً ساده است. در پروژه‌ی واقعی بهتر است برای شماره‌ی نامعتبر یا تکراری، پیام خطا در صفحه نشان دهید. اگر ثبت‌نام از فرم ووکامرس انجام می‌شود، همین تابع نرمال‌سازی را روی قلاب ذخیره‌ی حساب مشتری هم صدا بزنید.

اعتبارسنجی شماره موبایل؛ تا کجا کافی است؟

اعتبارسنجی شماره موبایل دو سطح دارد و باید فرق آن‌ها را بدانید. سطح اول بررسی قالب است: آیا رشته‌ای شبیه شماره‌ی موبایل ایران است؟ این همان کاری است که تابع بالا می‌کند و فقط خطاهای تایپی را می‌گیرد. سطح دوم بررسی مالکیت است: آیا کاربر واقعاً صاحب این شماره است؟ این را فقط یک وارسی زنده، مثل کدی که به شماره می‌رسد، نشان می‌دهد.

بسیاری از سایت‌ها فقط سطح اول را دارند و بعد با شماره‌های بی‌صاحب یا اشتباهی سر و کار پیدا می‌کنند. اگر شماره را برای اطلاع‌رسانی سفارش یا ورود استفاده می‌کنید، سطح دوم لازم است. راهنمای تأیید شماره موبایل روش‌های آن را شرح می‌دهد و جلوگیری از ثبت‌نام فیک نشان می‌دهد چرا فقط قالب‌سنجی کافی نیست.

شماره‌ی تأییدشده را جدا علامت بزنید

پیشنهاد مفید این است که علاوه بر خود شماره، یک متای دوم مثل mobile_verified نگه دارید که زمان یا وضعیت تأیید را نشان دهد. این‌طور وقتی خواستید در مدیریت شماره موبایل کاربران وردپرس فقط به شماره‌های تأییدشده اطلاع‌رسانی کنید، لازم نیست حدس بزنید. اگر کاربر شماره را عوض کرد، وضعیت تأیید را پاک کنید تا شماره‌ی تازه دوباره وارسی شود.

جلوگیری از شماره‌ی تکراری و حساب‌های دوگانه

شماره‌ی موبایل در ایران عملاً شناسه‌ی شخص است. اگر دو حساب یک شماره داشته باشند، یا یک نفر دو حساب ساخته یا کسی شماره‌ی دیگری را وارد کرده است. در هر دو حالت مشکل‌ساز می‌شود: سفارش‌ها بین دو حساب پخش می‌شود، تخفیف‌ها دو بار استفاده می‌شود و پیام‌ها به شخص اشتباه می‌رسد.

یکتایی را در دو لایه برقرار کنید. لایه‌ی اول بررسی هنگام ذخیره است، مثل کد بالا. لایه‌ی دوم گزارش دوره‌ای است که شماره‌های تکراری موجود را نشان دهد. چون وردپرس برای متا قید یکتایی در پایگاه‌داده ندارد، فقط کد برنامه است که جلوی تکرار را می‌گیرد و باید در هر مسیر ثبت‌نام اجرا شود.

وقتی ورود با شماره فعال است

در مدیریت شماره موبایل کاربران وردپرس، اگر ورود با شماره‌ی موبایل را به سایت اضافه کنید، این شماره از یک فیلد اطلاعاتی به «کلید ورود» تبدیل می‌شود. اینجا یکتایی دیگر یک دلخواه نیست و ضرورت است، چون ورود با شماره‌ی تکراری معلوم نمی‌کند باید به کدام حساب برود. نگاه کلی‌تری از این بحث در راهنمای ورود با موبایل در وردپرس آمده است.

ستون موبایل و جست‌وجوی شماره در پیشخوان

وردپرس به‌طور پیش‌فرض در صفحه‌ی «کاربران» فقط نام، ایمیل و نقش را نشان می‌دهد و جست‌وجو هم فقط روی نام و ایمیل کار می‌کند. برای کسی که باید روزی ده بار یک مشتری را از روی شماره پیدا کند، این کافی نیست. کد زیر یک ستون موبایل اضافه می‌کند و جست‌وجوی عددی را روی متا می‌برد.

نمونه کد: ستون موبایل و جست‌وجو

ستون در فهرست کاربران
add_filter('manage_users_columns', function ($cols) {
    $cols['mobile'] = 'موبایل';
    return $cols;
});

add_filter('manage_users_custom_column', function ($out, $col, $user_id) {
    return $col === 'mobile' ? esc_html(get_user_meta($user_id, 'mobile', true)) : $out;
}, 10, 3);
جست‌وجوی کاربر با شماره در پیشخوان
// اگر عبارت جست‌وجو شبیه شماره بود، روی متای mobile جست‌وجو کن
add_action('pre_get_users', function ($q) {
    if (!is_admin() || !$q->get('search')) return;
    $s = trim($q->get('search'), '*');
    $s = fg_normalize_phone($s) ?: preg_replace('/\D+/', '', $s);
    if (preg_match('/^09\d{3,9}$/', $s)) {
        $q->set('search', '');
        $q->set('meta_query', [[
            'key' => 'mobile', 'value' => $s, 'compare' => 'LIKE',
        ]]);
    }
});

جست‌وجو با LIKE روی متا برای چند هزار کاربر سریع است، ولی در چند صد هزار کاربر کند می‌شود. اگر به آن حجم رسیدید، به‌جای متا به یک جدول جدا با ایندکس روی شماره فکر کنید. برای اکثر سایت‌ها این لازم نمی‌شود. اگر پیشخوان کاربران را بیشتر سفارشی می‌کنید، افزونه مدیریت کاربران وردپرس ابزارهای کامل‌تری را مرور می‌کند.

پاک‌سازی شماره‌های قدیمی با WP-CLI

اگر سایت از قبل کاربر دارد و شماره‌ها ناهمسان ذخیره شده‌اند، پیش از هر کاری یک نسخه‌ی پشتیبان از پایگاه‌داده بگیرید. بعد با WP-CLI می‌توانید وضعیت را ببینید و اصلاح کنید.

نمونه فرمان‌ها: بررسی و اصلاح با WP-CLI

بررسی شماره‌ی یک کاربر و پیدا کردن صاحب یک شماره
# شماره‌ی کاربر 15
wp user meta get 15 mobile

# کاربری که این شماره را دارد
wp user list --meta_key=mobile --meta_value=09123456789 --fields=ID,user_login,user_email
اسکریپت یکسان‌سازی دسته‌ای (با wp eval-file)
<?php
// ذخیره به‌عنوان normalize-phones.php و اجرا با: wp eval-file normalize-phones.php
require_once __DIR__ . '/phone-helpers.php'; // همان تابع fg_normalize_phone

$users = get_users(['meta_key' => 'mobile', 'fields' => 'ID', 'number' => -1]);
$seen = [];
foreach ($users as $id) {
    $raw = get_user_meta($id, 'mobile', true);
    $n = fg_normalize_phone($raw);
    if (!$n) { WP_CLI::warning("کاربر $id: قالب نامعتبر ($raw)"); continue; }
    if (isset($seen[$n])) { WP_CLI::warning("کاربر $id: تکراری با {$seen[$n]} ($n)"); continue; }
    $seen[$n] = $id;
    if ($n !== $raw) update_user_meta($id, 'mobile', $n);
}
WP_CLI::success('تمام شد');

اسکریپت بالا شماره‌ی تکراری را خودکار پاک نمی‌کند، فقط گزارش می‌دهد. ادغام یا حذف حساب‌های دوگانه تصمیمی انسانی است، چون هر کدام ممکن است سفارش و سابقه‌ی خودش را داشته باشد.

ورود با شماره و مدیریت کاربران در کنار فینگت

اگر افزونه‌ی فینگت را روی سایت می‌گذارید، شماره‌ی موبایل تأییدشده‌ی کاربر از خود فینگت به سایت می‌رسد: کاربر ورود را در اپ روی گوشی تأیید می‌کند و سایت نام، شماره‌ی تأییدشده و یک شناسه‌ی ثابت دریافت می‌کند. اگر شماره از قبل برای یک حساب موجود ثبت بوده باشد، ورود به همان حساب می‌رود و حساب تازه‌ای ساخته نمی‌شود. به همین دلیل نرمال‌سازی بالا اهمیت دارد: شماره‌ی قدیمی که با قالب دیگری ذخیره شده، ممکن است با شماره‌ی تازه یکی تشخیص داده نشود و کاربر حساب دوم داشته باشد.

چند حد روشن را فراموش نکنید. دکمه‌ی فینگت در فرم ورود ووکامرس خودکار می‌آید و در جاهای دیگر با شورت‌کد finget_login یا ابزارک‌ها اضافه می‌شود؛ در صفحه‌ی wp-login.php و فرم ثبت‌نام خود وردپرس نیست. حساب‌های مدیر هم هرگز با فینگت وارد نمی‌شوند، پس مدیریت کاربران مدیر همان ورود معمول وردپرس باقی می‌ماند. اپ فعلاً برای اندروید است. جزئیات افزونه در افزونه ورود وردپرس آمده است.

حریم خصوصی و دسترسی به شماره‌ها

شماره‌ی موبایل داده‌ی شخصی است و نگهداری آن مسئولیت دارد. در مدیریت شماره موبایل کاربران وردپرس چند اصل ساده از بیشتر مشکل‌ها جلوگیری می‌کند. فقط وقتی شماره بگیرید که کاری با آن دارید. توضیح بدهید برای چه می‌خواهید. دسترسی به فهرست کاربران را به همه‌ی نقش‌ها ندهید، چون هر کسی که بتواند ستون موبایل را ببیند، می‌تواند از آن کپی بگیرد. و پشتیبان‌ها و فایل‌های خروجی را که شماره دارند، مثل خود پایگاه‌داده محافظت کنید.

وردپرس ابزار داخلی خروجی و پاک‌کردن داده‌ی شخصی دارد (در بخش «ابزارها ← خروجی داده‌ی شخصی»). مطمئن شوید متای mobile شما هم در آن‌ها لحاظ می‌شود؛ افزونه‌ها و کد سفارشی خودکار در آن ثبت نمی‌شوند و باید از طریق قلاب‌های حریم خصوصی وردپرس اضافه شوند. اگر قوانین یا قراردادهای پلتفرم‌های شما محدودیتی درباره‌ی نگهداری شماره دارند، با مشاور حقوقی خودتان صحبت کنید؛ این صفحه توصیه‌ی حقوقی نیست.

اشتباه‌های رایج در مدیریت شماره‌ها

ذخیره‌ی شماره با قالب آزاد

اگر هر چه کاربر نوشت ذخیره کنید، یک شماره در ده قالب پراکنده می‌شود و هیچ جست‌وجو یا بررسی تکراری درست کار نمی‌کند.

اعتماد به شماره‌ی بدون وارسی

شماره‌ای که فقط تایپ شده، «شماره‌ی کاربر» نیست؛ فقط یک متن است. برای ارسال پیام یا ورود، وضعیت تأیید را جدا نگه دارید.

افزودن ستون جدید به جدول کاربران

با به‌روزرسانی وردپرس یا مهاجرت سایت از بین می‌رود. متا همان کاری را بدون ریسک انجام می‌دهد.

نشان دادن شماره به نقش‌های بی‌ربط

نویسنده و ویرایشگر معمولاً نیازی به دیدن شماره‌ی مشتری ندارند. نقش‌ها را بسنجید و فقط به کسانی که کار دارند دسترسی بدهید.

اجرای اسکریپت اصلاح بدون پشتیبان

یک اشتباه در شرط ممکن است شماره‌ی همه را خراب کند. همیشه پیش از اجرای دسته‌ای نسخه‌ی پشتیبان بگیرید و اول روی یک کاربر امتحان کنید.

جدا نگه داشتن چند منبع شماره

اگر billing_phone و mobile هر دو دستی ویرایش شوند، با هم نمی‌خوانند. یک منبع را اصلی کنید و بقیه را از آن همگام نگه دارید.

سناریوی نمونه: فروشگاه با چهار هزار مشتری قدیمی

این سناریو فرضی است و فقط ترتیب کارها را نشان می‌دهد.

سناریوی نمونه

نمونه: پاک‌سازی بدون قطع فروش

یک فروشگاه لوازم آشپزخانه چهار سال است ووکامرس دارد و شماره‌ها را از فرم پرداخت می‌گیرد. مدیر فروشگاه می‌بیند حدود یک‌پنجم مشتری‌ها شماره‌ی تکراری یا قالب ناهمسان دارند. او اول پشتیبان می‌گیرد، سپس تابع نرمال‌سازی را در افزونه‌ی کوچکی می‌گذارد تا شماره‌های تازه از همان لحظه درست ذخیره شوند. بعد اسکریپت گزارش را اجرا می‌کند و فهرست شماره‌های تکراری را در یک برگه‌ی ساده می‌گذارد. حساب‌های دوگانه را با کمک پشتیبانی یکی‌یکی بررسی می‌کند و هیچ‌چیز را به‌صورت خودکار حذف نمی‌کند. در پایان، دکمه‌ی ورود با شماره را فعال می‌کند چون حالا هر شماره یک صاحب دارد.

چک‌لیست مدیریت شماره‌ها پیش از شروع

  • کلید متای اصلی مشخص است مثلاً mobile یا billing_phone؛ فقط یکی منبع حقیقت است.
  • قالب واحد انتخاب شده ذخیره با 09xxxxxxxxx یا 989xxxxxxxxx و تبدیل فقط هنگام نمایش.
  • رقم‌های فارسی تبدیل می‌شوند کاربر با هر کیبوردی بنویسد، لاتین ذخیره شود.
  • یکتایی در همه‌ی مسیرهای ثبت‌نام اجرا می‌شود فرم وردپرس، فرم ووکامرس و ویرایش پروفایل هر سه.
  • وضعیت تأیید جدا نگه داشته می‌شود با تغییر شماره، تأیید پاک می‌شود.
  • دسترسی نقش‌ها بازبینی شده فقط کسانی که لازم دارند ستون و خروجی را ببینند.
  • پشتیبان‌گیری پیش از اصلاح دسته‌ای و اجرای اول روی یک کاربر آزمایشی.

پرسش‌های متداول درباره مدیریت شماره موبایل کاربران وردپرس

شماره موبایل کاربران وردپرس کجا ذخیره می‌شود؟

به‌طور پیش‌فرض هیچ‌جا، چون وردپرس فیلد موبایل ندارد. معمولاً آن را در متای کاربر (wp_usermeta) با کلیدی مثل mobile ذخیره می‌کنند. ووکامرس هم شماره‌ی صورتحساب را در billing_phone نگه می‌دارد.

بهترین قالب برای ذخیره شماره موبایل چیست؟

قالب مهم نیست؛ ثبات مهم است. یا همه 09123456789 یا همه 989123456789. رقم‌های فارسی را به لاتین تبدیل کنید و فاصله و خط تیره را بردارید.

چطور از ثبت شماره‌ی تکراری جلوگیری کنم؟

هنگام ذخیره با get_users روی متای mobile بررسی کنید شماره‌ی نرمال‌شده برای کاربر دیگری نباشد. چون وردپرس قید یکتایی پایگاه‌داده برای متا ندارد، این بررسی باید در همه‌ی مسیرهای ثبت‌نام و ویرایش اجرا شود.

چطور در پیشخوان وردپرس کاربر را با شماره‌اش پیدا کنم؟

با قلاب pre_get_users می‌توانید جست‌وجوی پیشخوان را روی متای mobile هم ببرید و با manage_users_columns یک ستون موبایل اضافه کنید. نمونه‌ی کد در همین صفحه آمده است.

اعتبارسنجی شماره موبایل با کد پیامکی لازم است؟

برای قالب‌سنجی نه، برای تأیید مالکیت بله. اگر شماره را برای ورود یا اطلاع‌رسانی به کار می‌برید، وارسی زنده لازم است. ورود با تأیید در اپ فینگت یکی از راه‌هایی است که شماره‌ی تأییدشده را بدون پیامک ورود به سایت می‌رساند.

اگر کاربر قدیمی با شماره‌ی تأییدشده‌ی فینگت وارد شود حساب تازه می‌سازد؟

نه. اگر همان شماره از قبل در سایت ثبت شده باشد، به همان حساب وصل می‌شود. اما اگر شماره‌ی قدیمی با قالب متفاوتی ذخیره شده باشد، ممکن است تطبیق نخورد؛ پس شماره‌های قدیمی را یکسان کنید.

آیا مدیر سایت هم با فینگت وارد می‌شود؟

نه. حساب‌های مدیر هیچ‌وقت با ورود فینگت وارد نمی‌شوند و مدیر با نام کاربری و رمز خودش از wp-login.php وارد می‌شود.