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

فرض کنید یک فروشگاه اینترنتی دو زبانه، مثلاً فارسی و انگلیسی، دارید و محصولاتتون رو به دو زبان ارائه می‌کنید. حالا می‌خواید کاربران داخل ایران درگاه پرداخت ریالی مثل زرین‌پال، ملت یا سامان رو ببینن و کاربران کشورهای دیگه به درگاه بین‌المللی مثل PayPal یا Stripe دسترسی داشته باشن.

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

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

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

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

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

آشنایی با هوک woocommerce_available_payment_gateways

برای این کار از woocommerce_available_payment_gateways استفاده می‌کنیم. هوک فیلتر یعنی نقطه‌ای که WooCommerce داده رو در اختیار کد شما می‌ذاره تا قبل از استفاده تغییرش بدید. این فیلتر اجازه می‌ده بعضی از درگاه‌های فعال رو با توجه به شرایط سفارش از فهرست درگاه‌های قابل‌استفاده حذف کنید.

این فیلتر برای ساخت یا ثبت یک درگاه تازه نیست. اگه می‌خواید درگاه پرداخت جدیدی بسازید، باید از فیلتر woocommerce_payment_gateways و یک کلاس مبتنی بر WC_Payment_Gateway استفاده کنید. مقدارهای آرایه $available_gateways هم نمونه‌های درگاه هستن، نه فقط نام‌های متنی ساده.

افزودن کدهای شرطی به‌صورت گام‌به‌گام

گام اول: استفاده از Code Snippets یا افزونه اختصاصی

برای اضافه کردن کد، بهتره از یک افزونه مخصوص نگهداری قطعه‌کد مثل Code Snippets یا یک افزونه اختصاصی ساده استفاده کنید. این روش به قالب وابسته نیست و با تغییر یا به‌روزرسانی قالب، کد شما از بین نمی‌ره. قبل از فعال کردن هر قطعه‌کد هم از سایت نسخه پشتیبان بگیرید و اون رو اول در محیط آزمایشی بررسی کنید؛ چون یک خطای PHP ممکنه سایت رو از دسترس خارج کنه.

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

گام دوم: افزودن هوک پایه

فرقی نمی‌کنه از Code Snippets، افزونه اختصاصی یا functions.phpقالب فرزند استفاده می‌کنید. اول باید فیلتر اصلی رو اضافه کنید تا WooCommerce تابع سفارشی شما رو برای بررسی درگاه‌های قابل‌استفاده اجرا کنه:

add_filter( 'woocommerce_available_payment_gateways', 'mihanwp_conditional_gateway' );

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

گام سوم: ایجاد تابع شرطی و پیدا کردن شناسه درگاه

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

function mihanwp_conditional_gateway( $available_gateways ) {
    // شرط‌های ما اینجا قرار می‌گیرند
    return $available_gateways;
}

متغیر $available_gateways یک آرایه از نمونه‌های درگاه پرداخت در دسترس هست. کلید هر عضو، شناسه همون درگاهه. شناسه‌هایی مثل mellat، zarinpal، paypal، stripe و installment فقط نمونه هستن و ممکنه افزونه درگاه شما شناسه متفاوتی داشته باشه. پس قبل از استفاده از کد، شناسه واقعی رو از مستندات افزونه درگاه پیدا کنید.

برای پیدا کردن شناسه، از print_r() داخل صفحه پرداخت استفاده نکنید؛ چون خروجی مستقیم ممکنه ظاهر صفحه، درخواست‌های AJAX یا Store API رو خراب کنه. Store API همون رابطی هست که بلوک‌های جدید سبد خرید و پرداخت برای جابه‌جایی داده‌ها استفاده می‌کنن. اگه مستندات افزونه شناسه رو نگفته، در یک محیط آزمایشی و با فعال بودن گزارش خطا می‌تونید کلیدهای آرایه رو موقتاً داخل لاگ ثبت کنید:

if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
    error_log( 'Payment gateway IDs: ' . implode( ', ', array_keys( $available_gateways ) ) );
}

بعد از پیدا کردن شناسه‌ها، این کد عیب‌یابی رو حذف کنید و فایل لاگ رو عمومی نکنید.

مثال عملی: غیرفعال کردن درگاه پرداخت برای مهمان‌ها

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

if ( isset( $available_gateways['mellat'] ) && ! is_user_logged_in() ) {
    unset( $available_gateways['mellat'] );
}

کد اول با isset() بررسی می‌کنه که درگاه داخل آرایه هست یا نه. بعد is_user_logged_in() وضعیت ورود کاربر رو بررسی می‌کنه. علامت ! یعنی «نیست»؛ پس اگه کاربر وارد نشده باشه، unset() درگاه رو از فهرست قابل‌نمایش حذف می‌کنه.

شرطی کردن درگاه بر اساس زبان با WPML

اگه سایت چندزبانه شما از WPML استفاده می‌کنه، برای دریافت زبان فعلی بهتره از فیلتر wpml_current_language استفاده کنید. روش قدیمی مبتنی بر ثابت ICL_LANGUAGE_CODE برای کدهای تازه پیشنهاد نمی‌شه. نمونه زیر درگاه‌های ریالی رو در زبان انگلیسی و درگاه‌های بین‌المللی رو در زبان فارسی حذف می‌کنه:

$current_lang = apply_filters( 'wpml_current_language', null );

if ( 'en' === $current_lang ) {
    unset( $available_gateways['mellat'] );
    unset( $available_gateways['zarinpal'] );
}

if ( 'fa' === $current_lang ) {
    unset( $available_gateways['paypal'] );
    unset( $available_gateways['stripe'] );
}

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

شرطی کردن درگاه بر اساس زبان با Polylang

اگه از افزونه رایگان Polylang استفاده می‌کنید، تابع pll_current_language() کد زبان فعلی رو برمی‌گردونه. قبل از اجرای تابع، با function_exists() بررسی می‌کنیم که Polylang فعال باشه:

if ( function_exists( 'pll_current_language' ) ) {
    $current_lang = pll_current_language();

    if ( 'en' === $current_lang ) {
        unset( $available_gateways['mellat'] );
        unset( $available_gateways['zarinpal'] );
    }

    if ( 'fa' === $current_lang ) {
        unset( $available_gateways['paypal'] );
        unset( $available_gateways['stripe'] );
    }
}

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

شرطی کردن درگاه بر اساس مبلغ سبد خرید

فرض کنید می‌خواید یک درگاه اقساطی فقط وقتی نمایش داده بشه که جمع کالاهای سبد خرید به حد مشخصی رسیده. اول باید روشن کنید منظورتون از مبلغ، جمع کالاها قبل از تخفیف، مبلغ بعد از تخفیف یا مبلغ نهایی همراه مالیات و ارسال هست. نمونه زیر از get_cart_contents_total() استفاده می‌کنه؛ یعنی جمع قیمت کالاها بعد از تخفیف و قبل از مالیات و هزینه ارسال:

if ( WC()->cart ) {
    $cart_contents_total = (float) WC()->cart->get_cart_contents_total();
    $minimum_amount      = 2000000;

    if ( $cart_contents_total < $minimum_amount ) {
        unset( $available_gateways['installment'] );
    }
}

عدد 2000000 بر اساس واحد پول تنظیم‌شده در WooCommerce تفسیر می‌شه. این عدد به‌خودی‌خود به معنی دو میلیون تومان نیست؛ ممکنه واحد فروشگاه شما ریال، تومان، دلار یا ارز دیگه‌ای باشه. شناسه installment هم فقط مثاله و باید شناسه واقعی درگاه اقساطی رو جایگزینش کنید.

بررسی کد در پرداخت کلاسیک و پرداخت بلوکی

WooCommerce دو نوع صفحه پرداخت رایج داره: پرداخت کلاسیک که با شورت‌کد ساخته می‌شه و Checkout بلوکی که از بلوک‌های جدید سبد خرید و پرداخت استفاده می‌کنه. فیلتر woocommerce_available_payment_gateways در Store API هم برای تعیین درگاه‌های قابل‌استفاده در نظر گرفته می‌شه، ولی این موضوع به‌تنهایی سازگاری کامل افزونه درگاه با Checkout بلوکی رو تضمین نمی‌کنه.

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

سوالات متداول درباره شرطی کردن درگاه پرداخت ووکامرس

جمع‌بندی و کد نهایی

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

add_filter( 'woocommerce_available_payment_gateways', 'mihanwp_conditional_gateway' );

function mihanwp_conditional_gateway( $available_gateways ) {
    $current_lang = apply_filters( 'wpml_current_language', null );

    if ( isset( $available_gateways['mellat'] ) ) {
        if ( ! is_user_logged_in() ) {
            unset( $available_gateways['mellat'] );
        }

        if ( 'en' === $current_lang ) {
            unset( $available_gateways['mellat'] );
        }
    }

    if (
        isset( $available_gateways['paypal'] ) &&
        'fa' === $current_lang
    ) {
        unset( $available_gateways['paypal'] );
    }

    return $available_gateways;
}

این کد فقط نمایش درگاه‌ها رو فیلتر می‌کنه و جای تنظیمات امنیتی یا محدودیت‌های خود افزونه درگاه رو نمی‌گیره. بعد از هر تغییر، سناریوهای مهم مثل کاربر مهمان، کاربر واردشده، زبان‌های مختلف، مبلغ‌های کمتر و بیشتر از حد تعیین‌شده و هر دو نوع Checkout رو در محیط آزمایشی بررسی کنید. اگه مشکلی دیدید، کد رو غیرفعال کنید و گزارش خطای WooCommerce یا WordPress رو بررسی کنید.

تیم تولید محتوا

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