manifest / ecommerce / wordpress-zibal-classipress

پلاگین پرداخت زیبال برای کلاسی پرس

پلاگین پرداخت زیبال برای کلاسی پرس | از سری محصولات وب سایت <a href="https://zibal.ir">زیبال</a>

by Abolfazl Abdollahi · github.com/zibalco/wordpress-zibal-classipress · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/zibalco/wordpress-zibal-classipress/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/zibalco/wordpress-zibal-classipress ↗

افزونه درگاه پرداخت زیبال برای ClassiPress

این افزونه درگاه پرداخت زیبال را به تم ClassiPress اضافه می‌کند.

کلاس‌ها و توابع اصلی

کلاس‌ها

Zibal_Gateway - کلاس اصلی درگاه پرداخت
APP_Escrow_Zibal - کلاس پرداخت اسکرو (چند مرحله‌ای)

توابع

Proccess_Zibal_Gateway() - پردازش اصلی پرداخت
Send_to_Zibal_Gateway() - ارسال به درگاه
Return_from_Zibal_Gateway() - بازگشت از درگاه
Appthemes_Fault_Zibal() - مدیریت کدهای خطا

تغییرات کلیدی

1. API Endpoints

Request: https://gateway.zibal.ir/v1/request
Verify: https://gateway.zibal.ir/v1/verify
Payment Page: https://gateway.zibal.ir/start/{trackId}

2. پارامترهای API

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

Request:

{
    "merchant": "merchant_id",
    "amount": amount_in_rials,
    "callbackUrl": "callback_url",
    "description": "description",
    "mobile": "mobile_number"
}

Verify:

{
    "merchant": "merchant_id",
    "trackId": "track_id"
}

3. کدهای وضعیت

100 - موفق
201 - قبلا تایید شده
202 - پرداخت نشده
سایر کدها در تابع Appthemes_Fault_Zibal() تعریف شده‌اند

4. پارامترهای بازگشت

success - وضعیت پرداخت (1 = موفق، 0 = ناموفق)
trackId - شناسه پیگیری تراکنش
refNumber - شماره مرجع (کد رهگیری)

نصب و راه‌اندازی

فایل‌های افزونه را در پوشه wp-content/plugins/ آپلود کنید
از پنل مدیریت وردپرس، افزونه را فعال کنید
به تنظیمات پرداخت بروید و درگاه زیبال را فعال کنید
مرچنت کد خود را از پنل زیبال دریافت و وارد کنید

تنظیمات

نام نمایشی درگاه: عنوانی که به کاربران نمایش داده می‌شود
مرچنت: کد مرچنت دریافتی از زیبال
نام لاتین درگاه: نام استفاده شده در URL (پیش‌فرض: Zibal)
پیام‌های سفارشی: پیام‌های موفق، ناموفق و انصراف

هوک‌های توسعه‌دهنده

// قبل از ارسال به درگاه
do_action('Appthemes_Zibal_Gateway_Payment', $order_id, $options, $escrow, $Description, $Mobile);

// قبل و بعد از بازگشت موفق
do_action('Appthemes_Zibal_Return_from_Gateway_Success_before', $order_id, $options, $escrow);
do_action('Appthemes_Zibal_Return_from_Gateway_Success_after', $order_id, $options, $escrow);

// فیلترها
$Description = apply_filters('Appthemes_Zibal_Description', $Description, $order_id);
$Mobile = apply_filters('Appthemes_Zibal_Mobile', $Mobile, $order_id);

پشتیبانی از Escrow

افزونه از سیستم Escrow (پرداخت چند مرحله‌ای) پشتیبانی می‌کند که برای پروژه‌های فریلنسری مناسب است.

نیازمندی‌ها

WordPress 4.0+
ClassiPress Theme
PHP 5.6+
cURL Extension

لایسنس

GPLv2

توسعه‌دهنده

Abolfazl Abdollahi https://github.com/abolfazlabdollahii