=== درگاه پرداخت شی‌پی برای فرم تماس ۷ ===
Contributors: sheypay
Tags: contact form 7, payment gateway, iran, شی‌پی, درگاه پرداخت
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

پرداخت پس از ارسال فرم‌های Contact Form 7؛ مبلغ ثابت یا از فیلد فرم.

== Description ==

تبی به نام «پرداخت شی‌پی» به ویرایشگر فرم اضافه می‌شود. مبلغ ثابت یا مبلغ یکی از فیلدها (مثلاً یک فهرست انتخابی) را تعیین می‌کنید. پس از ارسال فرم، کاربر به درگاه می‌رود و نتیجه پس از تأیید سمت سرور بالای همان صفحه نمایش داده می‌شود. همهٔ پرداخت‌ها با اطلاعات فرم در فهرست «پرداخت‌های فرم تماس ۷» ثبت می‌شوند.

* تأیید هر پرداخت سمت سرور و با مبلغ ثبت‌شده؛ به پارامترهای آدرس بازگشت اعتماد نمی‌شود.
* وضعیت «در انتظار بانک» پرداخت را ناموفق نمی‌کند و با وب‌هوک امضاشده تکمیل می‌شود.
* حالت آزمایشی با کلید sk_test_ (بدون پول واقعی).

== Installation ==

1. فایل zip را از «افزونه‌ها › افزودن › بارگذاری افزونه» نصب و فعال کنید.
2. در «تنظیمات › شی‌پی · فرم تماس ۷» کلید API و واحد پول را بگذارید و «تست اتصال» را بزنید.
3. فرم را ویرایش کنید، در تب «پرداخت شی‌پی» گزینهٔ پرداخت را روشن و مبلغ ثابت یا نام فیلد مبلغ را وارد کنید.
4. آدرس وب‌هوک صفحهٔ تنظیمات را در پنل شی‌پی ثبت و رمز آن را در افزونه بگذارید.

== Frequently Asked Questions ==

= مبلغ در درگاه ده برابر یا یک‌دهم است. =
«واحد مبلغ فرم‌ها» را با واحدی که در فرم استفاده می‌کنید (تومان یا ریال) یکی کنید.

= خطای «دامنهٔ آدرس بازگشت تأیید نشده است» می‌گیرم. =
آدرس سایت باید روی دامنهٔ تأییدشدهٔ درگاه در پنل شی‌پی باشد. «تست اتصال» دامنهٔ درگاه را نشان می‌دهد.

= پرداخت انجام شده ولی وضعیت «در انتظار» مانده است. =
احتمالاً مشتری به سایت برنگشته. وب‌هوک را در پنل شی‌پی تنظیم کنید تا وضعیت خودکار به‌روز شود.

= پس از ارسال فرم به درگاه نمی‌روم. =
افزونه‌های کش یا بهینه‌سازی JS را بررسی کنید؛ فایل cf7-redirect.js باید روی صفحه بارگذاری شود. اطمینان پیدا کنید فرم با AJAX ارسال می‌شود.

= برای فیلد انتخابی چه بنویسم؟ =
مقدار گزینه‌ها را به شکل «عنوان|مبلغ» بنویسید، مثلاً [select plan "پایه|50000" "ویژه|90000"].

== Changelog ==

= 1.0.0 =
* نسخهٔ اول.
