مستندات توسعه دهندگان

افزونه WordPress

این افزونه بررسی MonoRanks را به داخل WordPress می آورد: امتیازها و اصلاح های سایت در یک صفحه MonoRanks، امتیاز هر صفحه در لیست Posts، ارسال محتوا به MonoRanks، دریافت اصلاح های تأییدشده، و امکان Undo برای هر تغییر.

ویدیوی راهنما

اتصال افزونه وردپرسدیدن در یوتیوبزیرنویس

یوتیوب فقط با زدن پخش بارگذاری می‌شود.

نمایش متن ویدیو

ضبط‌شده در نوامبر ۲۰۲۶ روی یک سایت آزمایشی وردپرس با داده‌های نمونه MonoRanks.

0:00 افزونه
افزونه MonoRanks بررسی سایت را به وردپرس می‌آورد و اصلاح‌های تأییدشده را می‌نویسد.

0:07 نصب
در وردپرس به «افزونه‌ها» و «افزودن افزونه» بروید و MonoRanks را جست‌وجو کنید. «نصب» و بعد «فعال‌سازی» را بزنید. افزونه صفحه خودش را باز می‌کند.

0:17 اتصال
«اتصال» را بزنید و وارد MonoRanks شوید، یا حساب رایگان بسازید. وردپرس از شما تأیید می‌خواهد. اتصال را تأیید کنید. وصل شدید و صفحه‌های منتشرشده فرستاده می‌شوند. بدون تأیید شما چیزی عوض نمی‌شود.

0:34 دیدن امتیازها و صفحه‌ها
بعد از اولین بررسی، این صفحه سلامت سایت، آمادگی برای هوش مصنوعی، کلیک‌ها و اصلاح‌ها را نشان می‌دهد. «صفحه‌های نیازمند اصلاح» فوریت هر صفحه را می‌گوید. فهرست نوشته‌ها هم امتیاز می‌گیرد و نمای «نیازمند توجه» دارد.

0:50 تأیید یک اصلاح
اگر اصلاحی منتظر باشد، تعدادش را می‌بینید. «بررسی اصلاح‌ها» آن‌ها را باز می‌کند. عنوان تازه را ببینید، «اعمال» را بزنید و تأیید کنید. MonoRanks آن را در وردپرس می‌نویسد. بعد صفحه دوباره بررسی می‌شود. اگر قبول شد، کار «رفع شد، تأییدشده» را نشان می‌دهد.

1:07 آمادهٔ اعمال و برگرداندن
اگر اصلاح تأییدشده هنوز نوشته نشده، اینجا منتظر است. «اعمال» را بزنید. هر تغییر تا سی روز قابل برگرداندن است.

نصب و اتصال

  1. در WordPress به Plugins → Add Plugin بروید (در نسخه های قدیمی تر WordPress اسمش Add New است)، MonoRanks را جست وجو کنید، روی Install Now و بعد Activate بزنید. افزونه در WordPress.org هست.
  2. در MonoRanks سایت را باز کنید، به Integrations بروید، روی Connect WordPress و بعد Allow fixes in WordPress بزنید.
  3. WordPress از شما می خواهد MonoRanks را تأیید کنید. روی Yes, I approve of this connection بزنید. اگر افزونه نصب شده ولی غیرفعال باشد، MonoRanks آن را فعال می کند، کلید اتصال را به آن می دهد و اولین همگام سازی محتوا را درخواست می کند. اگر افزونه هنوز نصب نشده باشد، MonoRanks تأیید شما را نگه می دارد و دکمه Finish setup را نشان می دهد: افزونه را نصب کنید و بعد روی همین دکمه بزنید. تأیید دوباره لازم نیست.
  4. صفحه Integrations سایت، اتصال WordPress را متصل نشان می دهد، همراه با نسخه افزونه و زمان آخرین همگام سازی.

اگر غیر از سایت های خودتان سایت های دیگری را هم می توانید باز کنید (کسی سایت هایش را با شما به اشتراک گذاشته)، MonoRanks می پرسد کجا وصل شود.

چه چیزهایی در 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. صفحه های دسته، برچسب و دسته محصول با عنوان سئو و توضیحات متایشان (افزونه 0.1.24). همچنین وضعیت افزونه (نام سایت، نسخه افزونه و WordPress، افزونه سئوی فعال، تعداد هر نوع پست) و اعلان تغییر، وقتی پستی منتشر، به روز یا از حالت انتشار خارج می شود، یا دسته یا برچسبی ویرایش یا حذف می شود.

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

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

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

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

  • صفحه های دسته و برچسب (افزونه 0.1.24). عنوان و توضیحات متای صفحه های دسته، برچسب و دسته محصول در Rank Math یا Yoast SEO نوشته می شوند، با Undo. بدون افزونه سئو فقط توضیحات نوشته می شود (به عنوان توضیح دسته). با افزونه قدیمی تر، MonoRanks می گوید آن را به روز کنید.
  • ویرایش متن صفحه (مثل پاراگراف اول) بعد از ذخیره چک می شود. اگر بلوکی را خراب کرده باشد، برگردانده می شود و دلیلش نمایش داده می شود.
  • افزونه های سئو. عنوان، توضیحات متا، canonical و noindex در فیلدهای Yoast SEO، Rank Math یا The SEO Framework نوشته می شوند، یا از طریق فیلترهای All in One SEO اعمال می شوند؛ اگر افزونه سئویی نباشد، افزونه خودش آن ها را چاپ می کند. اگر افزونه سئوی شما از آن هایی باشد که MonoRanks هنوز نمی تواند در آن بنویسد (SEOPress، Slim SEO، Squirrly SEO، SmartCrawl، WP Meta SEO، SEO SIMPLE PACK)، این چهار نوع اصلاح رد می شوند و MonoRanks آن ها را با برچسب «cannot be written here» و دلیلش نشان می دهد. روی صفحه اصلی ثابت (static front page)، تنظیمات Homepage Settings در The SEO Framework اولویت دارد، پس نوشتن در آنجا با ذکر دلیل رد می شود.
  • کش صفحه. بعد از هر تغییر و هر Undo، افزونه از کش صفحه فعال می خواهد صفحه تغییرکرده را پاک کند: WP Rocket، LiteSpeed Cache، W3 Total Cache، WP Super Cache، SiteGround Optimizer، WP-Optimize، Nginx Helper، Breeze، Kinsta، WP Engine و Pantheon. کش افزونه Cloudflare و کش CDNهای بیرون از WordPress پاک نمی شوند. اگر تغییری نوشته شده باشد ولی هنوز روی صفحه live نباشد، MonoRanks وضعیت «Written, not live» را نشان می دهد و می گوید کش صفحه پاک شده یا نه (از نسخه 0.1.18 افزونه).
  • llms.txt و قوانین خزنده های هوش مصنوعی. افزونه llms.txt تأییدشده را در آدرس /llms.txt تحویل می دهد و طوری علامتش می زند که کش ها نگهش ندارند. قوانین allow یا deny تأییدشده برای خزنده های هوش مصنوعی (GPTBot، ClaudeBot، PerplexityBot، Google-Extended و بقیه) به robots.txt اضافه می شوند. بعد از هر کدام از این دو تغییر، کش /llms.txt یا /robots.txt پاک می شود و MonoRanks فایل را دوباره می خواند.
  • حروف بزرگ و کوچک. بعضی افزونه های سئو حروف بزرگ و کوچک عنوان ها را تغییر می دهند؛ مثلاً تنظیم Capitalize Titles در Rank Math. عنوانی که فقط در حروف بزرگ و کوچک فرق دارد، باز هم live حساب می شود و یادداشتی دلیلش را توضیح می دهد.

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

قطع اتصال

از هر دو طرف می شود: در 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 سمت سرور رندر می شود.

سؤال های رایج

سایتم را کند می کند؟

نه. هیچ اسکریپت یا استایلی به صفحه های شما اضافه نمی کند. در بخش عمومی سایت فقط سه کار می کند: اگر هیچ افزونه سئویی تگ های سئوی تأییدشده را چاپ نکند، خودش چاپشان می کند؛ llms.txt تأییدشده را تحویل می دهد؛ و ریدایرکت های تأییدشده را در همان ابتدای درخواست چک می کند. محتوا در پس زمینه فرستاده می شود: وقتی MonoRanks بخواهد، وقتی چیزی منتشر می کنید، روزی یک بار، و وقتی صفحه ای از MonoRanks را باز می کنید که امتیازهای ذخیره شده اش بیشتر از یک ساعت قدیمی اند.

با کدام افزونه های سئو کار می کند؟

Yoast SEO، Rank Math و The SEO Framework (از نسخه 0.1.15 افزونه): عنوان، توضیحات متا، canonical و noindex تأییدشده در فیلدهای خود همین افزونه ها نوشته می شوند. All in One SEO: این مقدارها از طریق فیلترهایش به آن داده می شوند. بدون افزونه سئو: افزونه خودش این تگ ها را چاپ می کند. اگر افزونه سئوی شما از آن هایی باشد که MonoRanks هنوز نمی تواند در آن بنویسد، مثل SEOPress، Slim SEO یا Squirrly SEO، این چهار نوع اصلاح با ذکر دلیل رد می شوند، صفحه تنظیمات MonoRanks در WordPress هشدار می دهد و MonoRanks آن ها را با برچسب «cannot be written here» نشان می دهد. بقیه اصلاح ها همچنان کار می کنند.

بدون اتصال WordPress هم می شود از MonoRanks استفاده کرد؟

بله. MonoRanks هر سایت عمومی را بررسی می کند. افزونه، اصلاح با یک کلیک و بررسی دوباره در همان روز را اضافه می کند.