Skip to content

Instantly share code, notes, and snippets.

@irandargah-dev
Created June 30, 2026 16:16
Show Gist options
  • Select an option

  • Save irandargah-dev/797d2599c6b64bc7a205ea49b763a831 to your computer and use it in GitHub Desktop.

Select an option

Save irandargah-dev/797d2599c6b64bc7a205ea49b763a831 to your computer and use it in GitHub Desktop.
راهنمای پلاگین «GiveWP» ایران درگاه

ایران‌درگاه برای GiveWP

درگاه کمک‌مالی ایران‌درگاه (IPG v2) برای GiveWP 3.x (Gateway API جدید).

✨ امکانات

  • createPaymentRedirectOffsite، returnFromOffsiteRedirectPaymentComplete با تأیید سمت سرور و مقایسهٔ مبلغ (بدون direct_verify).
  • استرداد کمک مالی (refundDonationPaymentRefunded).
  • آدرس بازگشت امن با generateSecureGatewayRouteUrl، Sandbox/HMAC، واحد پول خودکار.

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

  1. پوشهٔ give-irandargah/ را در wp-content/plugins/ کپی و افزونه را فعال کنید (نیازمند GiveWP 3.x).
  2. Donations › Settings › Payment Gateways › ایران‌درگاه: توکن API، محیط و واحد مبلغ را تنظیم کنید.
  3. درگاه «ایران‌درگاه» را در فهرست درگاه‌های فعال انتخاب کنید.
  4. در پنل ایران‌درگاه، دامنهٔ سایت را به‌عنوان دامنهٔ مجاز ترمینال ثبت کنید. ⚠️ الزامی.

نکته: برای فرم‌های نسخهٔ ۳ (Visual Form Builder) ممکن است نیاز به افزودن یک فایل JS رندر فیلد باشد؛ فرم‌های legacy کامل پشتیبانی می‌شوند.

🧪 تست

محیط را «آزمایشی» بگذارید و با کارت 6037997123456789 (CVV2 123، انقضا 05/12) پرداخت کنید.

مجوز

GPL-2.0-or-later

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment