=== Paystar Connect ===
Contributors: dinordigital
Tags: payment gateway, paystar, starshop, woocommerce, gravity forms
Requires at least: 5.8
Tested up to: 6.8
Stable tag: 3.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

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

== Description ==

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

*   ساختار ماژولار و بهینه
*   پنل تنظیمات مرکزی و ساده
*   کدنویسی استاندارد و امن
*   اتصال ووکامرس به درگاه پی استار
*   اتصال گراویتی فرمز به درگاه پی استار
*   پشتیبانی از صفحه تسویه حساب بلوکی ووکامرس
*   پشتیبانی از HPOS ووکامرس
*   تخفیف خودکار برای انتخاب درگاه پی‌استار در تسویه‌حساب
*   باکس معرفی تخفیف و پاپ‌آپ اختیاری سازگار با صفحه‌سازها
*   سایر افزونه‌های پرکاربرد بزودی ...

== Installation ==

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

_روش اول: نصب از طریق پیشخوان وردپرس_

1.  افزونه را از وبسایت پی‌استار، بخش افزونه‌ها به صورت فایل `.zip` دانلود کنید.
2.  وارد پیشخوان وردپرس خود شوید و به مسیر `افزونه‌ها ← افزودن` بروید.
3.  بر روی دکمه "بارگذاری افزونه" کلیک کنید.
4.  فایل `.zip` را که دانلود کرده‌اید انتخاب کرده و بر روی «هم‌اکنون نصب کن» کلیک کنید.
5.  پس از نصب موفق، افزونه را فعال کنید.

_روش دوم: نصب از طریق FTP_

1.  افزونه را از وبسایت پی‌استار، بخش افزونه‌ها دانلود کرده و از حالت فشرده خارج کنید.
2.  پوشه `paystar-connect` را در مسیر `wp-content/plugins/` هاست خود آپلود کنید.
3.  وارد پیشخوان وردپرس شوید و به بخش `افزونه‌ها` بروید.
4.  افزونه **پی‌استار کانکت** را پیدا کرده و آن را فعال کنید.


== Configuration and Usage ==

پس از نصب و فعال‌سازی، برای استفاده از افزونه مراحل زیر را دنبال کنید:

۱. تنظیمات اصلی

1. در صفحهٔ افزونه‌ها، روی «تنظیمات درگاه» کلیک کرده یا از منوی پیشخوان وردپرس ← تنظیمات ← پی‌استار کانکت را انتخاب کنید.
2.  در صفحه باز شده، «شناسه درگاه» و «کلید رمزنگاری» خود را که از پنل پی استار/استارشاپ دریافت کرده‌اید، وارد کنید.
3.  تغییرات را ذخیره کنید. این تنظیمات به صورت سراسری برای تمام ماژول‌ها استفاده می‌شود.

۲. راه‌اندازی برای ووکامرس (WooCommerce)

1.  به مسیر `ووکامرس ← پیکربندی ← پرداخت‌ها` بروید.
2.  در لیست روش‌های پرداخت، «پی‌‌استار» را پیدا کرده و آن را فعال کنید.
3.  افزونه به صورت خودکار از کلیدهای عمومی که در تنظیمات اصلی وارد کرده‌اید استفاده می‌کند و نیاز به پیکربندی دیگری در این بخش نیست.
4.  پس از فعالسازی، روی «مدیریت» کلیک کنید. در اینجا میتوانید این درگاه را فعال/غیرفعال کرده؛ همچنین می‌توانید جزئیات نمایش در صفحهٔ تسویه حساب مانند عنوان درگاه و توضیحات درگاه که کاربر نهایی آن را می‌بیند، تعیین کنید.

برای فعال‌سازی تخفیف انتخاب درگاه، وارد تب «تخفیف پرداخت» در تنظیمات پی‌استار کانکت شوید. مقدار اولیه درصد ۱۰ است و تخفیف روی جمع محصولات پس از کوپن و بدون هزینه ارسال محاسبه می‌شود. رنگ اصلی و ثانویه باکس و پاپ‌آپ از همین تب قابل تنظیم هستند. در قالب‌های سفارشی Elementor و سایر صفحه‌سازها، اگر نمایش خودکار توسط قالب اجرا نشد، حالت «صفحه‌ساز / کد کوتاه» را انتخاب کرده و `[paystar_connect_discount_notice]` را در محل دلخواه قالب محصول قرار دهید.

۳. راه‌اندازی برای گراویتی فرمز (Gravity Forms)

1.  به تنظیمات اصلی گرویتی‌فرم رفته و واحد پولی را «ریال ایران» یا «تومان ایران» انتخاب کنید.
2. سپس به فرم مورد نظر خود بروید و از تب `تنظیمات`، گزینه `فعالسازی پی‌استار کانکت` را تیک بزنید.
3.  پس از فعالسازی، فیلدهای مورد نیاز (در صورت وجود)، مانند نام و نام‌خانوادگی و تلفن و ایمیل را تعیین کنید. 



== Changelog ==
= 3.0.0 =
* Feature: Send payer name, phone, and email with Paystar payment creation requests.
* Fix: Allow failed or cancelled WooCommerce orders to retry payment from the order payment page.
* Feature: Add Paystar transaction inquiry and secure manual WooCommerce order-status synchronization from verified gateway results.
* Compatibility: Provide transaction inquiry and synchronization directly on eligible classic and HPOS WooCommerce order screens.
* Security: Require stored transaction identity, order-level permissions, a fresh server-side inquiry, and downgrade protection before manual synchronization.
* Safety: Treat the gateway INIT state as unpaid or unverified and prevent it from moving an existing order back to pending payment.
* UI: Show the gateway-reported transaction state, clearer inquiry results, WooCommerce comparison states, masked transaction details, and explicit synchronization confirmation.
* Fix: Submit inquiry and synchronization through dedicated admin actions, isolate native WordPress notices, and improve standalone order-screen messages.
* UI: Redesign the administration panel with responsive tabs, branded controls, clearer workflows, and improved button and tab states.
* Security: Keep saved Paystar and Starshop credentials masked, preserve secrets when fields are left blank, and allow intentional reveal through the eye control.
* Fix: Prevent browsers and password managers from treating gateway settings as login credentials or suggesting WordPress account details.
* Fix: Improve settings validation, API error privacy, third-party notice isolation, and compatibility with existing stored settings and payment integrations.
* Feature: Add an optional payment-method discount calculated from product totals after coupons and excluding shipping.
* Feature: Add configurable product notices, an accessible checkout popup, customizable colors and copy, and a shortcode for Elementor and other page builders.
* Compatibility: Support discount calculation and metadata in classic checkout, Checkout Blocks, HPOS, pay-for-order flows, Astra, Elementor, and themes without the standard product-summary hook.
* Fix: Synchronize discounts immediately when shoppers change gateways, remove stale Paystar discount fees, and lock Checkout Blocks submission while totals refresh.
* Fix: Detect Checkout Blocks and Elementor checkout widgets on custom pages and recover cleanly from discount refresh errors.
* Compatibility: Migrate only unchanged legacy discount labels while preserving merchant-customized text and existing order-fee recognition.
* Change: Default fresh installations to the Iran gateway endpoint without overwriting or changing settings on existing installations.

= 2.14.1 =
* Feature: Add option to display Gravity Forms payment selection before form submit button

= 2.13.0 =
* Feature: Add 'referer' in redirecting payment URL.

= 2.12.1 =
* Tweak: Exclude gateway callback URLs from cache.
* Tweak: Improve nonce naming for callback URLs.
* Feature: Add debug mode to the plugin.

= 2.10.6 =
* Feature: Add active installation count
* Feature: Display update message capability

= 2.10.2 =
* Adding the dedicated name and logo of each gateway in the WooCommerce configuration and the checkout page.

= 2.10.1 =
* Fixed a race condition in WooCommerce orders.
* Optimized code for the StarShop service provider (e-commerce integration).

= 2.9.1 =
* Feature: Added support for WooCommerce block-based checkout page
* Feature: Added support for WooCommerce HPOS

= 2.8.1 =
* Feature: Added API v2 support for Starshop Platform
* Feature: Added new synchronization methods for products
* Feature: Added bulk sync capabilities for WooCommerce products
* Feature: Implemented new payment flow system

= 2.7.15 =
* Feature: Added product synchronization for Gravity Forms with Starshop
* Feature: Added product synchronization for WooCommerce with Starshop
* Feature: Enhanced settings panel with new configuration options

= 2.1.0 =
* Feature: Added Starshop Store gateway integration
* Feature: Added synchronization with Starshop Platform

= 1.0.1 =
* Initial release
* Feature: Added Paystar payment gateway for WooCommerce
* Feature: Added Paystar payment gateway for Gravity Forms
