XPay WordPress Theme Documentation

نسخه: 5.6.8
آخرین بروزرسانی: ژانویه 2026
وضعیت: 🟢 فعال و در حال توسعه

🎯 درباره این مستندات

این مجموعه شامل مستندات کامل فنی، راهنماهای توسعه، و گزارش‌های بهینه‌سازی قالب وردپرس XPay است که برای استفاده در GitHub Pages طراحی شده است.

📚 دسته‌بندی مستندات

🚀 شروع سریع

ابتدا از اینجا شروع کنید!

• 📖 راهنمای شروع سریع
  • نصب و راه‌اندازی
  • پیکربندی اولیه
  • اولین Template
• 🎯 راهنمای توسعه‌دهندگان
  • افزودن Page Template
  • افزودن Archive Template
  • ساخت Controller جدید
  • کار با View ها

🏗️ معماری و ساختار

• 🔷 معماری MVC
  • ساختار MVC (مشابه Laravel)
  • سیستم Routing
  • Controllers و Views
  • مثال‌های کامل
• 📦 Migration Guide
  • مراحل migration به MVC
  • رفع مشکلات رایج
  • Best Practices

💰 API و Data Management

• � سیستم Cron و Cache قیمت‌ها 🔥 جدیدترین
  • Batch Update System (10 batches, هر 60 ثانیه)
  • Atomic File Write برای جلوگیری از Race Condition
  • Server-Side Rendering برای Popular Coins
  • Action Scheduler Configuration
  • Template جدید popular-coin.php
  • حذف وابستگی به JavaScript/AJAX
  • مستندات کامل با کدهای نمونه
• 💰 سیستم بروزرسانی قیمت‌ها (Price Update API)
  • Real-Time Price Updates (0ms delay)
  • REST API Endpoint (/wp-json/xpay/v1/update-symbol)
  • Intelligent Caching (5 second TTL)
  • Cache-Busting Strategy برای CDN
  • USDT Dependency Management
  • JavaScript Modular Implementation
  • معماری کامل و Flow Diagrams
  • Configuration و Troubleshooting
  • Benchmark و Performance Analysis

⚡ عملکرد و بهینه‌سازی

• � بهینه‌سازی سرعت صفحات Coin 🔥 جدیدترین
  • Request-Level Cache (کاهش 75% API calls)
  • AJAX Price Loader (لود async قیمت‌ها) - PHP-React Data Sync (همگام‌سازی قیمت‌ها) - Batch API Endpoint
  • Skeleton Loading UX
  • کاهش TTFB از 16s به ~2.5s
• �📊 گزارش بهینه‌سازی عملکرد 🆕
  • خلاصه تغییرات
  • نتایج قبل و بعد
  • راه‌حل‌های اعمال شده
  • تست و تأیید
• 🚀 بهینه‌سازی‌های PageSpeed
  • Critical Path Optimization
  • Resource Loading
  • Asset Versioning
  • 2,500+ خطوط مستندات
• ⚡ راهنمای توسعه‌دهندگان PageSpeed 🆕
  • نحوه اضافه کردن CSS جدید
  • نحوه اضافه کردن JavaScript جدید
  • پیکربندی PageSpeedController
  • Automatic Asset Detection
  • Best Practices و Troubleshooting
• ⚡ بهینه‌سازی Forced Reflow
  • تحلیل Reflows
  • Highcharts Optimization
  • React Rendering
  • CSS Containment
• 🎯 بهینه‌سازی Forced Reflow v2 🆕
  • راه‌حل DOMQueue
  • Cached Scroll Position
  • Batch DOM Operations
  • 97% کاهش Reflow
• ⚡ بهینه‌سازی Forced Reflow (Production) 🔥 بروز شده v2.0
  • ReflowOptimizer Module کامل
  • DOM Interceptor برای Override Native Methods
  • Batch DOM Read/Write Operations
  • requestAnimationFrame Scheduling
  • Caching System با Timeout
  • رفع مشکل app-vendor Load Order (جدید)
  • کنترل از PageSpeed Admin
  • کاهش 65-80% reflow time (بروز شده)
  • مستندات کامل API و Usage
• ⚡ بهینه‌سازی Forced Reflow v3.1 🔥 جدیدترین
  • DOM Interceptor v3.1 با Pre-warming
  • LRU Cache با 100ms TTL
  • batchRead() API برای Batch Operations
  • jQuery Integration با Patch Methods
  • Highcharts Optimization با useMemo
  • Swiper Wrapper v3.0 با Debounced Updates
  • کاهش ~75% در Forced Reflow Time
  • مستندات کامل با کدهای نمونه
• 🔧 رفع مشکل ذخیره تنظیمات PageSpeed Admin 🆕
  • فیکس JavaScript با helper function
  • فیکس PHP با filter_var(FILTER_VALIDATE_BOOLEAN)
  • درس‌های آموخته درباره jQuery AJAX و boolean
  • راهنمای تست و Debug
• 🚀 رفع Render Blocking Resources 🔥 جدیدترین
  • Defer برای تمام اسکریپت‌ها (jQuery, Swiper, React bundles)
  • کاهش ~90% در render-blocking time
  • حفظ ترتیب execution با defer
  • صرفه‌جویی ~3,830ms در LCP
• 🚀 بهینه‌سازی جامع Performance 🔥 جدیدترین
  • PerformanceOptimizer Module کامل
  • Lazy Loading برای Scripts, Styles, Images
  • Widget Optimization (Chat, Modal, Price)
  • Font Optimization با font-display: swap
  • Core Web Vitals Monitoring
  • کاهش 55% در LCP، 75% در FID، 80% در CLS
  • راهنمای جامع 600+ خطی
• ⚡ راهنمای سریع Performance 🆕
  • Quick Reference برای PerformanceOptimizer
  • کدهای آماده و مثال‌ها
  • Troubleshooting راه‌حل‌های سریع
  • Checklist قبل از Deploy
• ⚡ بهینه‌سازی INP (Interaction to Next Paint) 🆕
  • INPOptimizer Module کامل
  • Task Scheduler با Priority Queue
  • Long Task Breaking با processInChunks()
  • Component Optimization (Modals, Tooltips, Forms, Search)
  • Event Handler Optimization (Debounce, Throttle)
  • Performance Monitoring (Long Tasks, INP)
  • کاهش 75% در INP، 67% در Long Tasks
  • راهنمای جامع 700+ خطی
• ✅ رفع ارورهای W3C HTML Validation 🆕
  • رفع تمام 24 ارور W3C Validator
  • جابجایی Meta Charset به ابتدای head
  • حذف as attribute از preconnect
  • حذف importance attribute (20 موارد)
  • حذف contain-intrinsic-size CSS
  • Compliance کامل با HTML5 و CSS Standards
  • راهنمای جامع 700+ خطی با تست‌ها
• ✅ رفع ارورهای W3C HTML Validation - Part 2 🔥 جدیدترین
  • رفع تمام 19 ارور باقیمانده در Theme
  • حذف alt از anchor tags (3 موارد)
  • فیکس HTML Structure (div in ul)
  • رفع Duplicate IDs (4 موارد)
  • فیکس Form Attributes و Iframe Standards
  • افزودن sizes به responsive images
  • بهبود Accessibility Score به 98/100
  • مستندات کامل با 10 دسته فیکس
• ⚡ راهنمای سریع INP 🆕
  • Quick Reference برای INPOptimizer
  • کدهای آماده و مثال‌ها
  • Troubleshooting راه‌حل‌های سریع
  • Checklist قبل از Deploy
• ⚡ بهینه‌سازی JavaScript Execution 🆕
  • Code Splitting (8 bundleها)
  • TerserPlugin Optimization
  • کاهش 45% زمان اجرای JS
  • Webpack Tree Shaking
• 🗺️ اتوماسیون Source Maps 🆕
  • ساخت خودکار Source Maps
  • ادغام با AssetVersionManager
  • پشتیبانی 8 Webpack Bundle
  • همگام‌سازی با Browser Cache
• 🎛️ کنترلر PageSpeed
  • API مدیریت PageSpeed
  • پنل ادمین
  • تنظیمات پیشرفته
• 📱 بهینه‌سازی Najva
  • Lazy Loading
  • Performance Tips

🔒 امنیت

• 🛡️ Content Security Policy
  • تنظیمات CSP
  • رفع Violations
  • Best Practices
• 🔒 HSTS Security Policy 🆕
  • HTTP Strict Transport Security
  • پیکربندی Nginx/Apache/cPanel
  • استراتژی استقرار تدریجی
  • راهنمای DevOps و SEO
  • تست و Monitoring
• 🔒 Cross-Origin Policies (COOP/COEP/CORP) 🆕
  • جداسازی Origin و محافظت از Spectre
  • پیکربندی COOP/COEP/CORP
  • راهنمای کامل برای Production
  • تست Pop-ups و OAuth
  • Troubleshooting و Best Practices

🔧 پیکربندی و تنظیمات

• 🌐 تنظیمات CDN
  • پیکربندی CDN
  • Optimization Tips
• ⚡ بهینه‌سازی Cache در CDN 🆕
  • تنظیم Cache Lifetime (1 سال)
  • رفع “Use efficient cache lifetimes”
  • فایل .htaccess برای CDN
  • تست و عیب‌یابی
• 🔒 بهینه‌سازی HTTP Headers 🆕
  • تنظیمات Response Headers
  • HTTP/2 و HTTP/3
  • Brotli Compression
  • Cache-Control Strategy
  • Security Headers (HSTS, CSP, Permissions-Policy)
  • تنظیمات آروان CDN
• 🗺️ تنظیمات Rank Math SEO
  • Schema و JSON-LD
  • Breadcrumb
  • Canonical URLs
• 🔷 مدیریت Schema 🔥 جدیدترین
  • نحوه اضافه کردن Schema جدید
  • نحوه حذف Schema
  • تغییر Schema موجود (Breadcrumb, FAQ, VideoObject)
  • مثال‌های کاربردی (Product, Article, HowTo)
  • تست و اعتبارسنجی با validator.schema.org
  • Best Practices و نکات مهم
• 🌍 GeoLocation
  • تشخیص موقعیت جغرافیایی
  • IP-based Restrictions

🚀 استقرار و CI/CD

• 🚀 راهنمای Deploy
  • GitHub Actions
  • Staging و Production
  • Workflow
• 📋 Deploy سریع
  • دستورالعمل‌های سریع
  • Troubleshooting
• 🔒 تنظیم GitHub Secrets 🆕
  • راهنمای تنظیم FTP Staging و Production
  • Secrets مورد نیاز برای Deploy
  • تست و عیب‌یابی Deploy
  • جداسازی محیط‌های Staging و Production
• 🖥️ Deploy روی cPanel
  • راهنمای cPanel
  • FTP Upload
• 📡 SFTP Sync Tool 🔥 جدیدترین
  • دانلود خودکار فایل‌های تغییر یافته از سرور
  • پشتیبانی از WinSCP و Posh-SSH
  • فیلتر بر اساس تاریخ (7 روز، 30 روز، و…)
  • نمایش لیست تغییرات قبل از دانلود
  • همگام‌سازی با Git
  • راهنمای کامل پیکربندی و عیب‌یابی

🔄 مهاجرت و Redirects

• 🔀 Domain Redirect Fix
  • رفع مشکلات redirect
  • Environment Configuration
• 🔗 SEO Redirects 🔥 بروز شده v1.1.0
  • مدیریت 301 Redirects
  • Rank Math Configuration
  • فیکس Pagination 404 (جدید v5.6.8)
  • بلاک صفحات /page/X بدون محتوا
  • بلاک URLهای غلط مثل /page2

🛠️ ابزارها و Scripts

• ⚙️ Git Functions Guide
  • PowerShell Functions
  • Automation Scripts
• 🗺️ Source Maps
  • تولید Source Maps
  • Debugging

🔧 Accessibility

• ♿ Accessibility Fixes
  • ARIA Labels
  • Keyboard Navigation
  • Screen Reader Support

📋 تاریخچه تغییرات (Changelog)

تمامی تغییرات، بهبودها و اصلاحات در فایل‌های Changelog ثبت شده است:

• 📝 Changelog فارسی
  • تاریخچه کامل تغییرات به فارسی
  • بروزرسانی‌های نسخه‌های مختلف
  • توضیحات تفصیلی هر تغییر
• 📝 Changelog English
  • Complete change history in English
  • Version updates and releases
  • Detailed descriptions

📊 گزارش‌های فنی

گزارش بهینه‌سازی عملکرد (جدید!)

📊 Performance Optimization Report

کامل‌ترین گزارش بهینه‌سازی شامل:

📈 نتایج کلیدی:

| متریک | قبل | بعد | بهبود | |——-|—–|—–|——-| | Forced Reflows | 400ms | <50ms | ✅ 87.5% | | Highcharts | 170ms | <10ms | ✅ 94% | | Console Errors | 12+ | 0 | ✅ 100% | | CSP Violations | 8 | 0 | ✅ 100% |

🎯 بخش‌های گزارش:

1. خلاصه اجرایی - نتایج کلی
2. مشکلات و راه‌حل‌ها - تحلیل دقیق هر مشکل
3. کدهای اعمال شده - مثال‌های واقعی
4. تست و تأیید - نتایج آزمایش
5. پیشنهادات آینده - Next Steps

📖 مطالعه گزارش کامل →

🗂️ ساختار پروژه

xpay_main_theme/
├── 📁 app/
│   ├── Admin/              # پنل مدیریت
│   ├── Controllers/        # کنترلرها
│   ├── Core/              # هسته سیستم
│   ├── Services/          # سرویس‌ها
│   └── Support/           # کلاس‌های کمکی
│
├── 📁 assets/
│   ├── css/               # استایل‌ها
│   ├── js/                # اسکریپت‌ها
│   ├── fonts/             # فونت‌ها
│   └── img/               # تصاویر
│
├── 📁 src/
│   ├── js/                # React/JavaScript
│   ├── components/        # React Components
│   └── css/               # Source Styles
│
├── 📁 views/
│   ├── pages/             # صفحات اصلی
│   ├── partials/          # بخش‌های قابل استفاده مجدد
│   └── admin/             # صفحات ادمین
│
├── 📁 templates/          # Page Templates
├── 📁 docs/               # 📚 مستندات (اینجا هستید!)
│
└── 📄 functions.php       # تنظیمات اصلی WordPress

🔗 لینک‌های مفید

مستندات داخلی

• Changelog فارسی
• Changelog انگلیسی
• README اصلی

ابزارهای توسعه

• PageSpeed Insights
• Chrome DevTools
• Web Vitals Extension

مراجع خارجی

• WordPress Developer Resources
• React Documentation
• Highcharts API
• Content Security Policy

🤝 مشارکت

برای مشارکت در توسعه:

1. Fork کنید
2. Branch جدید بسازید (git checkout -b feature/amazing-feature)
3. Commit کنید (git commit -m 'Add amazing feature')
4. Push کنید (git push origin feature/amazing-feature)
5. Pull Request باز کنید

📞 پشتیبانی

• Website: xpay.co
• Email: support@xpay.co
• Documentation Issues: GitHub Issues

📝 لایسنس

این پروژه تحت لایسنس اختصاصی XPay است.

🏆 مشارکت‌کنندگان

• توسعه دهنده اصلی: Mohammad Salehi
• تیم فنی XPay

📅 تاریخچه بروزرسانی‌ها

نسخه 5.5.8 (7 دسامبر 2025)

• ✅ بهینه‌سازی کامل Forced Reflows
• ✅ رفع مشکلات CSP و CORS
• ✅ پیاده‌سازی Page Loader
• ✅ افزودن CI/CD Pipeline
• ✅ مستندات کامل Performance Report

نسخه 5.5.0-5.5.7

• بهینه‌سازی‌های PageSpeed
• پیاده‌سازی معماری MVC
• تنظیمات Rank Math
• و بیشتر…

📖 مشاهده Changelog کامل →

🎯 Quick Links

📚 پایان صفحه اصلی مستندات

آخرین بروزرسانی: 7 دسامبر 2025

نسخه: 5.5.8

وضعیت: 🟢 Active