افزونهٔ وردپرس و ووکامرس
استعلامهای چکاوت ووکامرس، بدون کدنویسی
دو استعلام کاربردی برای فروشگاههای ایرانی: تکمیل خودکار نشانی از کد پستی، و تطابق شمارهٔ موبایل با کد ملی.
- نسخه: ۱.۱۱.۰
- وردپرس: ۶.۴+
- PHP: ۷.۴+
دانلود و نصب رایگان است. هزینه فقط بابت استعلامهایی است که خودتان روشن میکنید.
نسخهٔ ۱.۱۱.۰ · ۱۱۰ کیلوبایت · مجوز GPLv2
افزونه چه میکند
دو قابلیت، هر کدام برای یک ضرر مشخص که فروشگاههای ایرانی میدهند.
تکمیل خودکار نشانی از کد پستی
مشتری کد پستی را میزند و استان، شهر و نشانی خودکار پر میشود. نتیجهها یک هفته کش میشوند، پس کد پستی تکراری دوباره هزینه نمیبرد.
نشانی غلط یعنی مرسولهٔ برگشتی، و هزینهٔ هر مرسولهٔ برگشتی از صدها استعلام بیشتر است.
جزئیات فنی این سرویستطابق موبایل با کد ملی (شاهکار)
بررسی میشود که شمارهٔ موبایل واقعاً به همان کد ملی تعلق دارد. زمانش را خودتان انتخاب میکنید: پیش از پرداخت در صفحهٔ تسویه، یا پس از پرداخت و پیش از ارسال، بیآنکه فیلدی به صفحهٔ تسویه اضافه شود.
جلوی سفارش جعلی و پرداختدرمحلِ بیصاحب را میگیرد، بدون اینکه نرخ تکمیل خرید پایین بیاید. مشتری عضو فقط یک بار احراز میشود، حتی همان لحظهٔ ثبتنام و همراه کد پیامکیِ افزونهٔ ورود شما، و خریدهای بعدیاش با همان موبایل نه کد ملی میخواهد نه هزینهٔ استعلام دارد.
جزئیات فنی این سرویس
احراز هویت، پیش یا پس از پرداخت
زمانش را در تنظیمات افزونه انتخاب میکنید و هر وقت خواستید عوضش میکنید.
پیش از پرداختپیشفرض
- فیلد کد ملی در صفحهٔ تسویه، با جا، عرض و برچسب قابل تنظیم.
- به انتخاب شما، یا فقط نتیجه روی سفارش ثبت میشود یا سفارشِ ناهمخوان اصلاً ثبت نمیشود.
- برای فروشگاهی که میخواهد پیش از گرفتن پول مطمئن شود.
پس از پرداخت
- صفحهٔ تسویه هیچ فیلد اضافهای ندارد و نرخ تکمیل خرید پایین نمیآید.
- سفارش پرداختشده «در انتظار احراز هویت» میماند تا مشتری کد ملی را در صفحهٔ «سفارش دریافت شد» یا از لینک ایمیل وارد کند؛ لینک ایمیل بدون ورود به حساب هم باز میشود.
- با تطابق، سفارش خودکار «در حال انجام» میشود. با سه بار عدم تطابق نگه داشته میماند و به شما ایمیل میشود تا پیش از ارسال تماس بگیرید.
نصب در سه گام
نصب افزونه
فایل را بگیرید و در وردپرس از «افزونهها ← افزودن ← بارگذاری افزونه» نصب و فعال کنید.
ساخت کلید API
در پنل کسبوکار احرازینو یک کلید بسازید. کلید در سرور خودتان ذخیره میشود و هیچوقت به مرورگر بازدیدکننده نمیرود.
روشنکردن قابلیتها
در «ووکامرس ← تنظیمات ← احرازینو» کلید را بگذارید و هر قابلیتی را که میخواهید، جداگانه روشن کنید.
همهٔ قابلیتها پیشفرض خاموشاند. افزونه تا وقتی خودتان روشنشان نکنید، هیچ فراخوانی نمیزند و هیچ هزینهای نمیسازد. سقف مصرف هم در تنظیمات خود افزونه دست شماست.
هزینه چطور حساب میشود
خودِ افزونه رایگان است و برای همیشه رایگان میماند. آنچه هزینه دارد، هر استعلام است: از موجودی پنل کسبوکارتان کم میشود و قیمتش پیش از فراخوان قطعی است. مصرف را روزبهروز در گزارش پنل میبینید.
پرسشهای پرتکرار
- کلید API من کجا ذخیره میشود؟
در `wp_options` سرور خودتان. هیچوقت به مرورگر بازدیدکننده نمیرود و در هیچ فایل جاوااسکریپتی نیست. با حذف افزونه، کلید هم پاک میشود.
- هزینه چطور حساب میشود؟
هر استعلام از موجودی پنل شما کم میشود و قیمتش پیش از فراخوان قطعی است. مصرف را در [گزارش مصرف](https://ehrazino.com/dashboard/api/reports/) روزبهروز میبینید.
- آیا یک ربات میتواند موجودی من را خرج کند؟
مسیر تکمیل نشانی از صفحهٔ پرداخت صدا زده میشود و برای مهمانها هم باز است، پس سه لایه جلویش گذاشتهایم:
1. **سقف هر بازدیدکننده در ساعت** (پیشفرض ۲۰). 2. **سقف کل فروشگاه در ساعت** (پیشفرض ۲۰۰)، که کران بالای هزینهٔ شما را میبندد، هرچقدر هم ترافیک زیاد شود. 3. **کش هفتگی**: کد پستی تکراری دوباره هزینه نمیبرد.
با پر شدن سقف کل، در پیشخوان اعلان میبینید و در گزارش ثبت میشود. هر دو عدد از تنظیمات قابل تغییرند؛ متناسب با ترافیک واقعی فروشگاه بالا ببرید، ولی آگاهانه.
- کد ملی مشتریها کجا میرود؟
در متای سفارش میماند (برای فاکتور رسمی)، ولی سه جا **نمیآید**: در یادداشت سفارش ماسک میشود، در لاگ نوشته نمیشود، و از پاسخ REST API ووکامرس حذف میشود، چون پیشوند زیرخط فقط از رابط کاربری پنهان میکند و نه از REST.
- دکمهٔ «دریافت خودکار نشانی» هیچ کاری نمیکند، چه کنم؟
اول در **ووکامرس › تنظیمات › احرازینو** دکمهٔ «آزمون اتصال» را بزنید. نتیجهاش صریح میگوید مشکل کجاست و این آزمون هزینهای ندارد.
اگر آزمون سالم بود ولی دکمه در صفحهٔ پرداخت همچنان جواب نمیدهد، معمولاً میزبانی شما مسیر افزونه را بسته است. افزونه سه مسیر دارد و یکی از این سه باید برای بازدیدکنندهٔ بیرونی باز باشد:
1. `/?wc-ajax=ehrazino_lookup_postcode` 2. `/?rest_route=/ehrazino/v1/postcode` 3. `/wp-admin/admin-ajax.php`
اگر بهجای ۴۰۴، خطای **۵۰۲ یا ۵۰۴** میگیرید، معنایش فرق میکند: وردپرس بالا آمده و درخواست وسط کار قطع شده. تنها کار کندِ این مسیر، تماس سرور شما با احرازینو است، پس تقریباً همیشه یعنی سرور فروشگاه به ما نمیرسد. «آزمون اتصال» در تنظیمات، همین را صریح میگوید.
بعضی میزبانها برای «سختکردن وردپرس» کل `/wp-admin/` را میبندند و آن مسیر از مرورگر ۴۰۴ میدهد. وقتی با حساب مدیر وارد باشید، افزونه همین را زیر همان پیام به شما میگوید؛ مشتری آن را نمیبیند. متن را برای میزبان وب خود بفرستید.
- احراز پس از پرداخت دقیقاً چه میکند؟
وقتی درگاه پرداخت (یا پرداخت در محل) میخواهد سفارش را «در حال انجام» کند، افزونه بهجایش وضعیت **«در انتظار احراز هویت»** میگذارد:
1. موجودی انبار مثل همیشه کم میشود و سفارش «پرداختشده» حساب میشود. 2. ایمیل «سفارش تازه» برای شما میرود، و برای مشتری ایمیل «یک قدم تا ارسال سفارش» با لینک وارد کردن کد ملی. این ایمیل در «ووکامرس ← تنظیمات ← ایمیلها» قابل ویرایش یا خاموشکردن است. 3. تطابق کد ملی با موبایل سفارش، سفارش را آزاد میکند و ایمیل «در حال انجام» برای مشتری میرود. 4. مشتری تا سه بار فرصت دارد. کد ملیِ بدشکل نه تلاش حساب میشود و نه هزینه دارد.
لینک ایمیل به یک صفحهٔ سادهٔ مستقل میرود که فقط با همان لینک باز میشود؛ مشتری لازم نیست وارد حسابش شود یا ایمیلش را دوباره بنویسد. این صفحه در موتورهای جستوجو نمایه نمیشود و در کش صفحه هم نمیماند.
اگر شمارهٔ تلفن سفارش موبایل نباشد (مثلاً تلفن ثابت)، تطبیق ممکن نیست؛ سفارش نگه داشته میماند و به شما ایمیل میشود. شمارههایی که با +۹۸ یا ۰۰۹۸ ذخیره شدهاند، درست خوانده میشوند.
در این حالت فیلد تلفن صفحهٔ تسویه اجباری است و فقط شمارهٔ موبایل پذیرفته میشود، چون احراز با همان شماره انجام میشود.
فقط سفارشهایی نگه داشته میشوند که درگاه پرداخت آنلاین یا پرداخت در محل آنها را «در حال انجام» میکند. سفارشی که شما دستی تأیید میکنید (مثل کارتبهکارت یا واریز بانکی) نگه داشته نمیشود، چون تأییدش با خود شماست. تمدید خودکار اشتراک هم نگه داشته نمیشود.
فایلهای دانلودی تا تأیید تحویل نمیشوند. از صفحهٔ سفارش میتوانید درخواست احراز را دوباره برای مشتری بفرستید، یا با تغییر دستی وضعیت به «در حال انجام»، سفارش را بدون احراز آزاد کنید. اگر افزونه غیرفعال شود، سفارشهای منتظر به «در انتظار بررسی» میروند تا از فهرستها گم نشوند.
- با افزونهٔ ورود پیامکی (دیجیتس، ورودک و مانند آنها) کار میکند؟
بله. در تنظیمات «احراز هنگام ساخت حساب» را روشن کنید و «ثبتنام سایت شما با» را روی «افزونهٔ ورود پیامکی» بگذارید. آن افزونه موبایل را با کد پیامکی تأیید میکند و احرازینو همان لحظه پس از ساخت حساب، کد ملی را میپرسد و با همان موبایل تطبیق میدهد.
احرازینو به هیچ افزونهٔ پیامکیِ خاصی وابسته نیست و فقط از قلابهای خود وردپرس استفاده میکند، پس با بهروزرسانی آن افزونه نمیشکند. موبایل از نام کاربری یا تلفن صورتحساب خوانده میشود؛ اگر افزونهٔ شما موبایل را جای دیگری نگه میدارد، نام آن کلید را در «کلید متای موبایل» بنویسید.
- افزونه را چطور بهروز کنم؟
از نسخهٔ ۱٫۸٫۰ به بعد، مثل هر افزونهٔ دیگری: نسخهٔ تازه در «پیشخوان ← بهروزرسانیها» میآید و با یک کلیک نصب میشود؛ میتوانید بهروزرسانی خودکار را هم در صفحهٔ افزونهها روشن کنید. نسخههای پیش از ۱٫۸٫۰ این امکان را ندارند و یک بار باید فایل تازه را از سایت احرازینو دستی بارگذاری کنید.
- با HPOS و چکاوت بلوکی کار میکند؟
بله، هر دو. افزونه سازگاریاش را رسماً اعلام میکند و هیچجا `get_post_meta` روی سفارش صدا نمیزند. از نسخهٔ ۱٫۱۱٫۰ فیلد کد ملیِ «پیش از پرداخت» در چکاوت بلوکی هم هست (ووکامرس ۸٫۹ به بعد) و در بخش «اطلاعات سفارش» میآید؛ برچسب و الزامیبودنش از همان تنظیمهاست. تکمیل خودکار نشانی هنوز فقط روی چکاوت کلاسیک کار میکند. احراز «پس از پرداخت» در هر دو کامل کار میکند.
- مشتری میتواند کد ملیاش را در حساب کاربری ثبت یا ویرایش کند؟
بله، از نسخهٔ ۱٫۱۱٫۰. در تنظیمات «کد ملی در جزئیات حساب مشتری» را روشن کنید تا فیلد کد ملی در «حساب کاربری من ← جزئیات حساب» بیاید. کد ملی فقط وقتی ذخیره میشود که با شمارهٔ موبایل حساب بخواند؛ پس از آن، خریدهای بعدی با همان شماره بدون پرسیدن دوبارهٔ کد ملی انجام میشود. هر ثبت یا تغییر یک استعلام است و پس از سه بار عدم تطابق، فیلد برای آن حساب بسته میشود.
افزونه را بگیرید و در چند دقیقه راه بیندازید
نصب روی وردپرس، بدون کدنویسی. برای گرفتن کلید API هم یک حساب کسبوکار در احرازینو کافی است.
دانلود و نصب رایگان است. هزینه فقط بابت استعلامهایی است که خودتان روشن میکنید.
نسخهٔ ۱.۱۱.۰ · ۱۱۰ کیلوبایت · مجوز GPLv2
