TPP Services | سرویس‌های TPP

پلاگین وردپرس سرویس‌های TPP — WordPress plugin for TPP brand services

by TPP · github.com/tobeseuss/tpp-services · website

★ 0stars

0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/tobeseuss/tpp-services/archive/refs/heads/main.zip

Readme github.com/tobeseuss/tpp-services ↗

پلاگین وردپرس مدیریت اطلاعات سرویس‌های اینترنت و تلفن — با ثبت تکی و گروهی (اکسل)، تاریخچه کامل تغییرات، کار آفلاین (PWA) و همگام‌سازی خودکار.

نسخه فعلی: 1.20.0 | پیش‌نیازها: WordPress 5.8+ و PHP 7.4+

✨ امکانات

سرویس‌ها: ثبت تکی و گروهی (اکسل) با تشخیص هوشمند آدرس‌های مشابه، چند سرویس برای هر آدرس، جستجوی زنده اجاکسی، فیلدهای داینامیک قابل افزودن/حذف با دسترسی سطح فیلد
پیشرفت دایری: ۱۶ مرحله با منطق آبشاری + انتخاب چند خرابی برای هر سرویس + تغییر گروهی/تکی
کار آفلاین: اپ PWA فارسی (RTL) با IndexedDB، صف همگام‌سازی و اجرای خوش‌بینانه عملیات + Service Worker با به‌روزرسانی خودکار
تاریخچه و گزارش کار: تاریخچه آبشاری تغییرات با بازگردانی، گزارش کار روزانه/بازه‌ای هر کاربر با تقویم شمسی، گزارش فعالیت جامع
خروجی‌ها: اکسل (نویسنده/خواننده XLSX بومی بدون وابستگی)، PDF دو روشه (TCPDF باندل‌شده + چاپ مرورگر)، بکاپ JSON و SQL/ZIP با بازیابی کامل + پشتیبان خودکار قبل از ایمپورت
پیامک: پنل SMS.ir با قالب‌های پیامک و کپی مشخصات (OMC)
دسترسی‌ها: نقش‌های کاربری داینامیک + پنهان‌سازی خودکار منوها/دکمه‌های بدون دسترسی
بازبینی (۱.۲۰.۰): دسته پیش‌فرض ارجاع «ثبت جهت بازبینی و ویرایش یا تأیید مدیریت» + سجل اقدامات نصاب‌ها با نگه‌داری/بازگردانی یک‌کلیکی
مرکز API: ۲۵+ مسیر REST (tpp/v1) با مستندات کامل برای اتصال افزونه‌های دیگر + شورت‌کد [tpp_services]

📦 نصب

آخرین نسخه را از Releases یا کل این ریپو دانلود کنید.
پوشه tpp-services را در wp-content/plugins/ قرار دهید (یا zip را از افزونه‌ها ← افزودن ← بارگذاری نصب کنید).
افزونه TPP Services | سرویس‌های TPP را فعال کنید.
اپ تحت آدرس /wp-content/plugins/tpp-services/pwa/ در دسترس است؛ در پیشخوان هم لانچر دارد. برای سایت عمومی از شورت‌کد [tpp_services] استفاده کنید.

ارتقا: «جایگزینی نسخه فعلی» از صفحه افزونه‌ها؛ مهاجرت دیتابیس و seedهای نسخه جدید به‌صورت خودکار انجام می‌شود. یک بار اپ را رفرش کنید تا Service Worker جدید فعال شود.

📚 مستندات

فایل	محتوا
README-FA.md	راهنمای کامل فارسی (نصب، استفاده، تنظیمات، پرسش‌های رایج)
DEVELOPERS.md	API پی‌اچ‌پی (`tpp()` container)، هوک‌ها و نکات توسعه
API-DOCUMENTATION.md	مرجع کامل REST API نسخه `tpp/v1`
CONTRIBUTING.md	جریان کاری گیت (کامیت/push هر تغییر)، نسخه‌بندی هشت‌نقطه‌ای و فرایند انتشار Release
readme.txt	استاندارد وردپرس + changelog نسخه‌ها

🗂 ساختار

tpp-services/
├── tpp-services.php        # بوت‌استرپ افزونه + محافظ کپی تکراری
├── uninstall.php           # پاک‌سازی هنگام حذف
├── includes/               # ۳۰ کلاس پی‌اچ‌پی (REST، سرویس‌ها، ایمپورت/خروجی، احراز هویت، ...)
│   ├── tcpdf/              # کتابخانه TCPDF باندل‌شده برای PDF فارسی
│   └── fonts/              # فونت‌های فارسی اختصاصی
├── admin/views/            # لانچر پیشخوان
└── pwa/                    # اپ تحت‌شبکه (PWA): SPA فارسی RTL + Service Worker + IndexedDB

🔒 مجوز

هسته افزونه مطابق هدر فایل اصلی: GPL-2.0+ | کتابخانه TCPDF: LGPL