پورتال وایت‌لیبل مشتری و موتور گزارش

بله. معیار این است که سایت‌هایی را نگه دارید که مال خودتان نیست. افزونه روی سایت هر مشتری جداگانه نصب می‌شود و همان‌جا سابقه را نگه می‌دارد. گزارش فعالیت به‌تنهایی جواب سؤال «این ماه چه کار کردی» را می‌دهد؛ برند خودتان، آمار بازدید، آپ‌تایم و PDF ماهانه وقتی معنا پیدا می‌کنند که بخواهید همان گزارش را به اسم خودتان به مشتری بدهید.

این قید طراحی افزونه بوده، نه یک ادعای بعدی. ماژولی که خاموش است اصلاً بارگذاری نمی‌شود، چون رجیستری نام کلاس نگه می‌دارد و فقط ماژول فعال ساخته می‌شود. پورتال کوئری زنده نمی‌زند و از یک اسنپ‌شات کش‌شده می‌خواند که TTL آن قابل تغییر است. ساخت PDF روی کرون و پشت قفل اجرا می‌شود. CSS و JS فقط روی صفحات خود افزونه بار می‌شوند و jQuery در کار نیست. عدد و درصدی برای سرعت نمی‌دهم؛ اینها تصمیم معماری است، نه نتیجه یک بنچمارک.

نه، چون چیزی برای دیدن وجود ندارد. هر نصب مستقل است و فقط داده همان سایت را دارد؛ هیچ هاب مرکزی‌ای داده مشتری‌ها را کنار هم جمع نمی‌کند. اگر وایت‌لیبل را روشن کنید و افزونه را از دید مشتری پنهان کنید، او فقط پورتال را می‌بیند و نه صفحات مدیریتی شما. روی دیگر سکه را هم بگویم: به همین دلیل یک داشبورد واحد برای همه مشتری‌هایتان هم وجود ندارد.

هفت ماژول، همه فعال: گزارش فعالیت، سلامت پایگاه داده، پورتال مشتری، آمار بازدید GA4، آپ‌تایم (چه از سرویس پایش چه از هارت‌بیت)، گزارش PDF زمان‌بندی‌شده با ارسال ایمیل، و وایت‌لیبل. به‌علاوه صفحه تنظیمات، مسیرهای REST، ترجمه‌ها و همه هوک‌ها. ماژولی که خاموشش کنید اصلاً بارگذاری نمی‌شود، و جز GA4 و سرویس پایش — که خودتان تصمیم می‌گیرید — افزونه به هیچ جا وصل نمی‌شود.

بسته ۳۰۳ فایل و حدود ۹۴۰ کیلوبایت است، و تقریباً همه‌اش بابت دو چیز است که داخل بسته قرار دارند: کتابخانه mPDF و فونت وزیر متن در دو وزن. mPDF به‌صورت تریم‌شده همراه است — ۳.۸ مگابایت سورس به‌جای ۵۵ — و با یک Autoloader دستی بارگذاری می‌شود تا در زمان اجرا هیچ چیزی نصب نشود. این فایل‌ها فقط وقتی خوانده می‌شوند که واقعاً یک گزارش ساخته شود.

بله، و این با چشم بررسی شده نه با حدس: PDF ساخته شد، به تصویر تبدیل شد و بازبینی شد. فونت وزیر متن داخل بسته است و با useOTL ثبت شده؛ همین یک تنظیم است که باعث می‌شود حروف عربی‑فارسی به هم بچسبند و همان چیزی است که بیشتر افزونه‌ها فراموش می‌کنند. خروجی راست‌چین است، جدول‌ها و خطوط ترکیبی فارسی و لاتین درست خوانده می‌شوند، و شماره صفحه روی LTR قفل شده تا «۱ / ۲» به‌شکل «۲ / ۱» درنیاید.

به یک حساب سرویس گوگل کلاود و فایل کلید آن نیاز دارید، و کسی که به پراپرتی GA4 دسترسی مدیریتی دارد باید ایمیل آن حساب سرویس را به‌عنوان بیننده اضافه کند. معمولاً آن شخص مشتری است، پس این تنها بخشی است که نمی‌توانید یک‌تنه راه بیندازید. افزونه خودش JWT را با دامنه analytics.readonly امضا می‌کند و هیچ SDK گوگلی همراه ندارد؛ کلید خصوصی هم فیلد فقط نوشتنی است و در هیچ پاسخی برنمی‌گردد. اگر دسترسی نگرفتید، این ماژول را خاموش بگذارید و بقیه افزونه سر جایش کار می‌کند.

بله. هر کرون یا مانیتوری را به نقطه پایانی هارت‌بیت وصل کنید و افزونه از فاصله بین پینگ‌ها آپ‌تایم را حساب می‌کند؛ فاصله بیش از دو برابر بازه‌ای که تنظیم کرده‌اید قطعی شمرده می‌شود. آدرس با HMAC-SHA256 روی مهر زمانی امضا می‌شود، مقایسه با hash_equals انجام می‌شود، مهر زمانی باید حدود یک دقیقه به ساعت سرور نزدیک باشد، مهر زمانی آینده رد می‌شود، و هر آدرس امضاشده فقط یک‌بار پذیرفته می‌شود. همین آخری مهم است: بدون آن هر کسی که یک آدرس هارت‌بیت را در لاگ سرور می‌دید می‌توانست تکرارش کند و یک قطعی واقعی را بپوشاند. دستور curl آماده در راهنمای فارسی هست.

هیچ‌چیز، مگر خودتان خواسته باشید. یک گزینه «حذف داده هنگام حذف افزونه» وجود دارد که پیش‌فرض خاموش است، چون حذف و نصب دوباره یک افزونه نباید یک سال گزارش فعالیت را ببرد. غیرفعال‌سازی هم فقط رویدادهای زمان‌بندی‌شده و کش‌ها را پاک می‌کند و به داده دست نمی‌زند. اگر آن گزینه را روشن کنید، حذف افزونه هر دو جدول، تنظیمات و PDFهای ساخته‌شده را پاک می‌کند.

رفع اشکال افزونه، راهنمایی نصب و راه‌اندازی — از جمله تنظیم GA4 و هارت‌بیت — و پاسخ به سؤال‌های استفاده. سفارشی‌سازی، توسعه امکانات جدید و مشکلاتی که از پوسته یا افزونه‌های دیگر می‌آید بیرون از پشتیبانی است و جداگانه توافق می‌شود.