افزونه WordPress

نصب و اتصال

1. در WordPress به Plugins → Add Plugin بروید، MonoRanks را جست‌وجو کنید، روی Install Now و بعد Activate بزنید. افزونه را از WordPress.org هم می‌توانید دانلود کنید.
2. در MonoRanks، Website → Integrations → WordPress → Connect را باز کنید. وقتی WordPress درخواست تأیید داد، MonoRanks را تأیید کنید؛ یا کلید اتصال را کپی کنید و در WordPress در بخش MonoRanks → Settings وارد کنید.
3. صفحه Integrations سایت وضعیت «Connected» را همراه با نسخه افزونه و زمان آخرین همگام‌سازی نشان می‌دهد.

چه چیزهایی در WordPress می‌بینید

افزونه یک منوی MonoRanks به پیشخوان WordPress اضافه می‌کند.

• Overview: امتیاز سلامت فنی و AEO سایت و تغییرشان نسبت به هفته قبل، کلیک‌های جست‌وجو در 28 روز گذشته (از Google Search Console، اگر در MonoRanks وصلش کرده باشید)، صفحه‌هایی که بیشتر از بقیه به رسیدگی نیاز دارند، اصلاح‌هایی که در MonoRanks تأیید کرده‌اید و با یک کلیک اعمال می‌شوند (Apply یا Apply all)، و آخرین تغییرهایی که روی سایت نوشته شده، هرکدام با Undo.
• Settings: وضعیت اتصال، کلید اتصال، زمان آخرین همگام‌سازی، اینکه چه داده‌ای فرستاده و چه داده‌ای دریافت می‌شود، و تاریخچه کامل تغییرها.
• یک ستون MonoRanks در Posts، Pages و بقیه انواع پست: حلقه امتیاز سلامت فنی و AEO هر صفحه. ماوس را روی حلقه ببرید تا اصلاح‌های منتظر، مشکل‌های باز و تاریخ بررسی صفحه را ببینید. خالی بودن حلقه AEO یعنی آن صفحه بررسی نشده، نه اینکه امتیاز پایینی گرفته؛ AEO فقط روی مهم‌ترین صفحه‌های هر بررسی سنجیده می‌شود. ستون بر اساس سلامت فنی مرتب می‌شود و نمای «Needs attention» صفحه‌های منتشرشده با امتیاز زیر 60 را لیست می‌کند.

امتیازها از بررسی هفتگی می‌آیند؛ افزونه آن‌ها را با کلید اتصال از MonoRanks می‌خواند و در WordPress کش می‌کند. در بخش عمومی سایت هیچ درخواستی فرستاده نمی‌شود. اگر کش بیشتر از یک ساعت قدیمی باشد، با باز کردن صفحه MonoRanks امتیازها همان‌جا گرفته می‌شوند؛ پس در سایت‌هایی که WP-Cron خاموش است هم امتیازها می‌رسند و بقیه صفحه‌ها در پس‌زمینه به‌روز می‌شوند. تا وقتی اولین بررسی انجام نشده باشد، همین را در صفحه‌ها می‌بینید.

افزونه چه داده‌ای می‌فرستد

فقط اطلاعات محتوای منتشرشده، روی HTTPS: نوع پست، URL، عنوان، خلاصه 40 کلمه‌ای، نام نویسنده و URL تصویر پروفایلش، دسته‌بندی‌ها، برچسب‌ها، تاریخ‌ها، عنوان سئو، توضیحات متا، URL canonical، وضعیت noindex، و URL تصویرها همراه با متن alt. همچنین وضعیت افزونه (نام سایت، نسخه افزونه و WordPress، افزونه سئوی فعال، تعداد هر نوع پست) و اعلان تغییر، وقتی پستی منتشر، به‌روز یا از حالت انتشار خارج می‌شود.

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

داده‌ای که افزونه با همان کلید از MonoRanks می‌خواند: فقط نتیجه بررسی همین سایت (امتیاز سایت و هر صفحه، مشکل‌های باز، اصلاح‌هایی که تأیید کرده‌اید، کلیک‌های جست‌وجو) برای صفحه‌هایی که بالاتر گفتیم. اصلاح‌های تأییدشده‌ای که هنوز نوشته نشده‌اند هم در این لیست هستند، تا اگر نوشتن از سمت MonoRanks انجام نشد، افزونه خودش اعمالشان کند.

افزونه چه چیزهایی می‌نویسد

فقط چیزهایی که در MonoRanks تأیید می‌کنید (یا از طریق apply در API و MCP): عنوان سئو، توضیحات متا، متن alt تصویر، URL canonical، noindex، ریدایرکت، یک پاراگراف اول که مستقیم جواب را می‌دهد، قوانین robots.txt برای خزنده‌های هوش مصنوعی و فایل llms.txt. هر تغییر در WordPress در بخش MonoRanks → Settings با امکان Undo ثبت می‌شود و صفحه‌های درگیر همان روز دوباره بررسی می‌شوند.

• ویرایش متن صفحه (مثل پاراگراف اول) بعد از ذخیره چک می‌شود. اگر بلوکی را خراب کرده باشد، برگردانده می‌شود و دلیلش نمایش داده می‌شود.
• کش صفحه. بعد از هر تغییر، افزونه از افزونه‌های کش رایج (WP Rocket، LiteSpeed Cache، W3 Total Cache، WP Super Cache، SiteGround Optimizer و بقیه) می‌خواهد کش صفحه تغییرکرده را پاک کنند. اگر تغییری نوشته شده باشد ولی هنوز روی صفحه live نباشد، MonoRanks وضعیت «Written, not live» را نشان می‌دهد و می‌گوید کش صفحه پاک شده یا نه (از نسخه 0.1.18 افزونه).
• حروف بزرگ و کوچک. بعضی افزونه‌های سئو حروف بزرگ و کوچک عنوان‌ها را تغییر می‌دهند؛ مثلاً تنظیم Capitalize Titles در Rank Math. عنوانی که فقط در حروف بزرگ و کوچک فرق دارد، باز هم live حساب می‌شود و یادداشتی دلیلش را توضیح می‌دهد.

افزونه برای نوشتن از Application Password به اسم «MonoRanks» استفاده می‌کند که در WordPress تأییدش می‌کنید. برای متوقف کردن همه تغییرها، آن را در Users → Profile باطل کنید؛ خواندن داده و همگام‌سازی محتوا مثل قبل کار می‌کنند.

قطع اتصال

از هر دو طرف می‌شود: در MonoRanks از Website → Integrations → WordPress → Disconnect، یا در WordPress از MonoRanks → Settings → Disconnect. هر دو روش کلید اتصال این سایت را باطل می‌کنند، امتیازهای کش‌شده را پاک می‌کنند و ارسال همه داده‌ها را متوقف می‌کنند. اگر از سمت WordPress قطع کنید، MonoRanks همان لحظه باخبر می‌شود و سایت آنجا هم دیگر متصل نشان داده نمی‌شود. اگر یک هفته هیچ داده‌ای از سایتی نرسد، MonoRanks خودش اتصال را قدیمی (stale) علامت می‌زند.

برای توسعه‌دهنده‌ها

این افزونه open source است: github.com/monoranks/wordpress-plugin. افزونه از REST API با یک کلید سایت (scopeهای content:write، sites:read، pages:read) استفاده می‌کند و نتیجه‌های بررسی را از endpointهای اتصال که در فایل docs/api.md مخزن توضیح داده شده‌اند می‌خواند. صفحه‌های پیشخوان یک اپ React هستند (Vite، Tailwind و کامپوننت‌هایی به سبک shadcn)؛ ستون Posts با PHP سمت سرور رندر می‌شود.