پلاگین حمایت مالی
افزونه حمایت مالی فارسی برای وردپرس ICSD Donate for Persian
این افزونه چیست؟
ICSD Donate for Persian یک افزونه وردپرسی سبک و کاملاً فارسی است که به شما امکان دریافت کمک مالی آنلاین از بازدیدکنندگان سایتتان را می‌دهد. کافی است یک شرت‌کد ساده ([ICSDDonate]) در هر صفحه‌ای قرار دهید تا فرم پرداخت نمایش داده شود.
این افزونه از دو درگاه پرداخت ایرانی پشتیبانی می‌کند:
- زرین‌پال (ZarinPal) — با REST API نسخه ۴
- سپ / بانک سامان (SEP) — از طریق sep.shaparak.ir
بدون هیچ کتابخانه خارجی، بدون NuSOAP، بدون SOAP — فقط PHP خالص و تمیز.
به درد چه کسانی می‌خورد؟
این افزونه برای هر سایت فارسی‌زبانی که نیاز به دریافت حمایت مالی دارد مناسب است:
وب‌سایت‌های فرهنگی و آموزشی کتابخانه‌های دیجیتال، سایت‌های دانلود کتاب، آرشیوهای صوتی و تصویری، سایت‌های آموزشی رایگان — هر جایی که کاربران مایل به حمایت مالی از تولیدکنندگان محتوا هستند.
سازمان‌های خیریه و مردم‌نهاد موسسات خیریه، کمپین‌های جمع‌آوری کمک، صندوق‌های حمایتی — با فرم ساده و گزارش‌گیری دقیق از تمام تراکنش‌ها.
وبلاگ‌نویسان و تولیدکنندگان محتوا نویسندگان، پادکسترها، ویدئوبلاگرها — هر کسی که محتوای رایگان تولید می‌کند و می‌خواهد دکمه «حمایت مالی» در سایتش داشته باشد.
انجمن‌ها و پروژه‌های متن‌باز پروژه‌های نرم‌افزاری، انجمن‌های آنلاین، ویکی‌های فارسی — برای دریافت کمک هزینه سرور و نگهداری.
سایت‌های مذهبی و مساجد دریافت نذورات و کمک‌های مالی آنلاین با گزارش شفاف.
امکانات و ویژگی‌ها
دو درگاه پرداخت
از بین زرین‌پال و سپ (بانک سامان) انتخاب کنید. تغییر درگاه از تنظیمات ادمین — بدون نیاز به تغییر کد.
داشبورد مدیریتی حرفه‌ای
- کارت‌های آماری: مجموع کمک‌ها، تعداد تراکنش‌های موفق/ناموفق/لغوشده
- نمودار ستونی ۶ ماه اخیر
- حلقه نرخ موفقیت (درصد تراکنش‌های موفق)
- آمار امروز، ۷ روز اخیر، و ۳۰ روز اخیر
- لیست آخرین پرداخت‌های موفق و ناموفق
- رتبه‌بندی برترین حامیان
گزارش تراکنش‌ها با فیلتر پیشرفته
- فیلتر بر اساس وضعیت: موفق، ناموفق، لغوشده، در انتظار
- فیلتر بر اساس بازه زمانی: یک ماه، سه ماه، یک سال، تاریخ سفارشی
- جستجو بر اساس نام حامی
- صفحه‌بندی خودکار
فونت وزیرمتن (لوکال)
فونت Vazirmatn به صورت محلی بارگذاری می‌شود — بدون هیچ درخواست به CDN یا سرور خارجی. حجم فقط ۱۰۸ کیلوبایت.
امنیت
- بررسی Nonce در تمام فرم‌ها
- بررسی سطح دسترسی کاربر (
current_user_can) - کوئری‌های دیتابیس با Prepared Statements
- تمام خروجی‌ها با توابع Escaping وردپرس
واحد پولی
انتخاب بین تومان و ریال — تبدیل خودکار برای API درگاه‌ها.
شرت‌کدهای ساده
| شرت‌کد | عملکرد |
|---|---|
[ICSDDonate] |
نمایش فرم پرداخت |
[ICSDDonateList] |
نمایش لیست حامیان |
سازگاری کامل
- وردپرس ۵.۰ تا ۶.۹
- PHP ۸.۰ و بالاتر (۸.۱، ۸.۲، ۸.۳)
- مهاجرت خودکار از افزونه‌های قبلی (Erima Zarinpal Donate)
کاملاً لوکال
هیچ فایل CSS، JS، یا فونتی از CDN بارگذاری نمی‌شود. تنها درخواست‌های خارجی به API درگاه پرداخت انتخاب‌شده ارسال می‌شود.
نحوه استفاده
- افزونه را نصب و فعال کنید.
- از منوی ICSD Donate > تنظیمات، درگاه مورد نظر را انتخاب و کد پذیرنده (Terminal/Merchant ID) را وارد کنید.
- شرت‌کد
[ICSDDonate]را در هر صفحه یا نوشته قرار دهید. - برای نمایش لیست حامیان، از
[ICSDDonateList]استفاده کنید.
مشخصات فنی
| مشخصه | مقدار |
|---|---|
| نسخه | 3.0.0 |
| حداقل وردپرس | 5.0 |
| تست شده تا | 6.9 |
| حداقل PHP | 8.0 |
| لایسنس | GPLv2 or later |
| درگاه‌ها | ZarinPal (REST API v4), SEP/Saman Bank |
| فونت | Vazirmatn Variable (108 KB, local) |
| CDN | هیچ — کاملاً لوکال |
| Text Domain | icsd-donate-for-persian |
توسعه‌دهنده
شرکت توسعه هوشمند فرش ایرانیان (ICSD) icsd.ir
PHP