Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/mortza214/ai-content-manager/archive/refs/heads/review%2F0.6.1-source-import.zipافزونهای فارسی برای ثبت موضوع، تولید دستی مقاله و نگهداری خروجی در صف WordPress. تبدیل خروجی به پیشنویس و اعمال اطلاعات سئوی Yoast عملیات جداگانهاند؛ هیچ نوشتهای خودکار منتشر نمیشود.
- نسخه افزونه: ۰.۶.۱ (
0.6.1) - نسخه ساختار دیتابیس: ۱.۳.۰ (
1.3.0) - حداقل اعلامشده: WordPress ۶.۰ و PHP ۷.۴؛ اجرای واقعی روی همه این نسخهها تأیید نشده است.
امکانات اجراشده
- سه تب فارسی «تولید محتوا»، «مدیریت صف» و «تنظیمات».
- ثبت یک موضوع یا چند موضوع مستقل با اطلاعات مشترک، کنترل تکرار و اعتبارسنجی ورودی.
- تولید دستی هر مقاله با سرویس واحد OpenAI و نگهداری خروجی ساختاریافته و سابقه مصرف؛ تولید میتواند هزینه API داشته باشد.
- محدودیت درخواست و توکن، رزرو مصرف، گزارش مصرف و بازیابی آیتمهای متوقفشده.
- پیشنمایش خروجی، زبالهدان نرم صف و بازگردانی آیتم؛ محتوای تولیدشده و سابقه مصرف حفظ میشوند.
- ساخت دستی پیشنویس نوشته و برگه، رابطه پایدار با آیتم صف و جلوگیری از ایجاد پیشنویس تکراری. ساخت پیشنویس محصول پشتیبانی نمیشود.
- تخصیص زبان پیشنویس در صورت فعالبودن WPML؛ تولید ترجمه خودکار انجام نمیشود.
- تکمیل اختیاری فیلدهای خالی Yoast هنگام ساخت پیشنویس و مقایسه/اعمال دستی عبارت اصلی و توضیحات متا روی پیشنویس مرتبط.
- اصلاح پیشنهاد عبارت اصلی قدیمی بدون تولید مجدد: پیشنهاد اصلاحشده در
payload.seo_reviewنگهداری میشود وgenerated_outputاصلی برای سابقه حفظ میشود. ابتدا ذخیره پیشنهاد و سپس اعمال از مقایسه تازه انجام میشود. - حفظ مقدار دستی Yoast مگر با انتخاب صریح بازنویسی، تشخیص تعارض از زمان مقایسه، کنترل مجوز و nonce و پردازش مستقل هر فیلد.
موارد هنوز پیادهسازینشده
پردازش خودکار یا زمانبندیشده صف، انتشار خودکار/زمانبندیشده، ساخت تصویر شاخص، پژوهش وب، ممیزی عمومی سئوی نوشتههای موجود و جریان کامل محتوای WooCommerce هنوز اجرا نشدهاند. وجود کلاس یا گزینه رزروشده به معنی فعالبودن این قابلیتها نیست. این مخزن گردشکار استقرار خودکار ندارد.
نصب دستی
۱. ابتدا روی WordPress تستی مستقل و دارای نسخه پشتیبان آزمایش کنید. برای تست اصلاح سئو میتوان از آیتم تولیدشده و پیشنویس موجود استفاده کرد و دسترسی OpenAI را مسدود نگه داشت.
۲. از سورس ZIP محلی بسازید یا پوشه افزونه را با نام ai-content-manager آماده کنید. بسته باید یک ریشه ai-content-manager/ و فایل ai-content-manager.php در آن داشته باشد.
۳. بسته را بهصورت دستی در بخش افزونههای WordPress نصب و فعال کنید. فعالسازی اولیه جدولهای صف و رویداد را میسازد و مجوز مدیریت افزونه را برای مدیر ثبت میکند؛ ارتقای ۰.۶.۰ به ۰.۶.۱ مهاجرت تازهای ندارد. دسترسی هر نقش و مجوز ویرایش نوشته مرتبط همچنان کنترل میشود.
۴. تنظیمات موردنیاز را فقط در رابط مدیریت همان سایت وارد کنید. کلید واقعی، خروجی صف، تنظیمات سایت، cookie یا اطلاعات اتصال را در مخزن یا گزارشها نگذارید. Yoast و WPML اختیاریاند و نبودشان مطابق محدودیت هر مسیر گزارش میشود. هیچ کلید یا اطلاعات ورود واقعی همراه سورس نیست.
این دستورها خودشان نصب، اتصال به سایت یا درخواست OpenAI اجرا نمیکنند.
اجرای آزمونهای محلی
با PHP CLI در ریشه مخزن اجرا کنید؛ این مجموعهها fixture هستند و به WordPress یا MySQL واقعی نیاز ندارند:
php tests/generation.php
php tests/admin.php
php tests/security-budget.php
php tests/workflows.php
php tests/seo.php
php tests/seo-bootstrap.php
node tests/admin-assets.js
برای lint تمام فایلهای PHP در PowerShell:
$files = @(Get-ChildItem ai-content-manager.php, includes, tests -Recurse -File -Filter *.php)
foreach ($file in $files) {
php -l $file.FullName
if ($LASTEXITCODE -ne 0) { throw 'خطای نحوی PHP' }
}
git diff --check
در آمادهسازی این نسخه، ۳۱۷ بررسی PHP با PHP CLI نسخه ۸.۵.۱۲، lint ۴۱ فایل PHP و چهار گروه آزمون JavaScript موفق بودهاند. WordPress، MySQL و Yoast در این تستها شبیهسازی شدهاند. tests/seo-bootstrap.php ورودی و autoloader واقعی همین افزونه را با hookهای شبیهسازیشده آزمایش میکند؛ اجرای HTTP واقعی admin-post.php نیست. هیچ درخواست واقعی OpenAI برای این آزمونها لازم نیست.
تست واقعی WordPress/MySQL/Yoast، مرورگر و ویرایشگر واقعی، indexableهای Yoast، رقابت چندفرایندی و اجرای PHP ۷.۴ در این محیط انجام نشدهاند. قفل افزونه، ویرایشگر عادی WordPress را قفل نمیکند؛ فاصله خواندن تا ذخیره metadata با ویرایش خارجی اتمیک نیست.
ساخت ZIP محلی
در PowerShell از ریشه پروژه اجرا کنید:
powershell -NoProfile -ExecutionPolicy Bypass -File tools/build-zip.ps1
این فرمان مجوز اجرای اسکریپت را فقط برای همان فرایند تعیین میکند و سیاست سیستم را تغییر نمیدهد. اسکریپت، ZIP قبلی محلی را جایگزین میکند؛ به شبکه یا سایت وصل نمیشود. فایل اصلی، includes/، assets/، tests/، README و گزارشهای انتشار با فهرست مجاز بستهبندی میشوند و SHA-256 تمام اعضای بسته با سورس تطبیق داده میشود. .git، تنظیمات شخصی، ابزارهای محلی و اسرار وارد بسته نمیشوند.
خروجی ai-content-manager.zip با .gitignore کنار گذاشته میشود. نسخه جدید ZIP در Git ثبت نمیشود؛ ZIP قدیمی در commit اولیه برای حفظ تاریخچه باقی میماند. حذف ZIP از index، فایل محلی را حذف نمیکند و محتوای تاریخی را پاک نمیکند. پیش از ارسال هر تاریخچه، ZIPهای موجود در آن هم باید بررسی شوند.
وضعیت صفحه سفید و آزمون واقعی
علت قطعی صفحه سفید گزارششده سایت هنوز مشخص نیست و رفع قطعی آن ادعا نمیشود. کاربر بازشدن اخیر صفحه مقایسه را تأیید کرده است؛ ارسال نهایی فرم در محیط واقعی توسط ما آزمایش نشده است.
در نسخه ۰.۶.۱، استفاده از آدرس HTMLشده در هدر redirect اصلاح شده و شکست بازگشت، nonce/مجوز نامعتبر و خطاهای قابل مدیریت پیام فارسی و لینک بازگشت دارند. همچنین فیلد نامعتبر دیگر بهصورت ضمنی از نتیجه حذف نمیشود تا خطا پشت پیام موفقیت پنهان نماند. این اصلاحها، علت صفحه سفید واقعی سایت را اثبات نمیکنند.
راهنمای گامبهگام بررسی عبارت قدیمی، متای برابر، حفظ مقدار دستی، تعارض، POST و redirect و اطلاعات لازم برای تشخیص در گزارش نسخه ۰.۶.۱ آمده است. برای بازتولید واقعی، نسخههای دقیق PHP/WordPress/Yoast، مرحله شکست، زمان، وضعیت HTTP و خطای PHP با نام فایل و خط لازماند. nonce، کلید، cookie، header احراز هویت و متن خصوصی را از هر گزارش ارسالی حذف کنید.
نگهداری سورس و امنیت
فایلهای .env، wp-config.php، کلیدها، dump دیتابیس، backup، log، HAR، cache و تنظیمات شخصی IDE در Git قرار نمیگیرند. .gitignore فایل tracked یا اسرار تاریخی را حذف نمیکند. پیش از commit فهرست staged و diff و پیش از push فایلها و تاریخچه قابل ارسال را جدا بازبینی کنید. بررسی الگویی تضمین نبود همه انواع اسرار نیست؛ اگر کلید واقعی پیدا شد، ارسال را متوقف کنید و بدون تصمیم صاحب مخزن تاریخچه را بازنویسی نکنید.
هیچ GitHub Actions، webhook یا تنظیمی برای انتشار روی WordPress اضافه نشده است. PR فقط برای بررسی سورس است؛ merge، نصب افزونه و تغییر visibility خودکار انجام نمیشوند. ورود Git محلی و دسترسی اتصال GitHub در ChatGPT مستقلاند و باید جدا تأیید شوند.