اتصال وردپرس به کوکار: انتشار خودکار روزانه
اگر می‌خواهید بدون دردسر و هر روز، مقاله‌های سئو‌شده را مستقیم در وردپرس منتشر کنید، اتصال وردپرس به کوکار بهترین گزینه است. در این راهنما، صفر تا صد راه‌اندازی اتصال، از دریافت کلید API تا زمان‌بندی انتشار خودکار، نقشه‌برداری فیلدها و رفع خطا را قدم‌به‌قدم پیش می‌بریم تا همان روز اول خروجی پایدار و قابل‌اعتماد بگیرید.
اتصال وردپرس به کوکار چیست و چه به شما می‌دهد؟
اتصال وردپرس به کوکار یعنی موتور تولید و اجرای محتوا را به‌صورت مستقیم به سایتتان وصل می‌کنید تا مقاله‌های آماده با چک‌لیست کامل سئو، طبق سقف روزانهٔ دلخواه شما، خودکار به وردپرس برسند و به‌صورت پیش‌نویس یا انتشار مستقیم ذخیره شوند. این اتصال هم از طریق افزونهٔ وردپرس و هم با API امکان‌پذیر است و می‌تواند عنوان، متن HTML تمیز، اسلاگ، توضیح متا، دسته‌بندی و برچسب‌ها را بدون دخالت دستی منتقل کند.
پیش‌نیازها و دسترسی‌های لازم
- یک حساب فعال در کوکار و دسترسی به ناحیهٔ ورود.
- نقش مدیر در وردپرس برای نصب افزونه و ایجاد کلید کاربردی.
- دامنهٔ اصلی یا محیط استیجینگ با گواهی SSL معتبر برای ارتباط امن.
- فعال بودن کرون وردپرس یا کرون سیستم‌عامل برای اجرای زمان‌بندی‌ها.
مروری سریع بر معماری اتصال
به‌طور معمول سه مؤلفه داریم: 1) تولید و صف انتشار در کوکار، 2) درگاه API امن برای تحویل مقاله‌ها، 3) دریافت‌کننده در وردپرس (افزونه یا اندپوینت سفارشی) که محتوا را به پست تبدیل می‌کند. جریان داده از کوکار به وردپرس «پوش» یا «پول» است: در حالت پوش، کوکار مقاله را به اندپوینت شما ارسال می‌کند؛ در حالت پول، افزونهٔ وردپرس طبق زمان‌بندی، صف آمادهٔ کوکار را می‌خواند و پست‌ها را می‌سازد.
گام‌به‌گام: راه‌اندازی سریع با افزونه
- نصب افزونه. افزونهٔ اتصال را نصب و فعال کنید. بعد از فعال‌سازی، منوی «کوکار» در پیشخوان ظاهر می‌شود.
- دریافت کلید API. وارد کوکار شوید و از بخش حساب کاربری، کلید API و نشانی پایه را بردارید. اگر آشنا نیستید، سند راهنمای API را ببینید.
- پیکربندی امنیت. کلید را فقط در تنظیمات افزونه وارد کنید. گزینهٔ محدودیت IP را در صورت امکان فعال کنید و دسترسی را به دامنه‌های مشخص محدود نگه دارید.
- نقشه‌برداری فیلدها (Field Mapping). عنوان ← post_title، اسلاگ ← post_name، متن سئو‌شده ← post_content، توضیح متا ← فیلد متای سئو (Yoast/RankMath)، دسته‌ها و برچسب‌ها ← taxonomies. اگر برای تصویر شاخص فیلد جدا دارید، آن را هم مشخص کنید.
- حالت انتشار. بین «پیش‌نویس»، «در انتظار بازبینی» یا «انتشار مستقیم» یکی را انتخاب کنید. پیشنهاد: ابتدا یک هفته روی پیش‌نویس بگذارید تا خروجی را در قالب سایت ببینید.
- زمان‌بندی و سقف روزانه. ساعت انتشار، تعداد روزانه و روزهای هفته را تنظیم کنید. اگر چند زبان یا چند دسته دارید، برای هر استریم تنظیم جدا تعریف کنید.
- تست سلامت اتصال. روی «ارسال پست آزمایشی» بزنید. باید یک پست تست با عنوان و متن نمونه ساخته شود. اگر اروری بود، لاگ افزونه را بررسی کنید.
گام‌به‌گام: یکپارچه‌سازی با API سفارشی
- ایجاد اندپوینت دریافت. در وردپرس، یک روت REST (wp-json) یا یک اندپوینت PHP با احراز هویت هدر Bearer بسازید.
- اعتبارسنجی درخواست. هدر Authorization را برای کلید معتبر بررسی کنید، Body را بر اساس اسکیمای API کوکار (title, slug, contentHtml, excerpt, categories, tags, meta, featured_image) اعتبارسنجی کنید.
- پاکسازی و نگاشت. اسلاگ را یکتا کنید، تگ‌ها را موجود/جدید بسازید، متاها را در فیلدهای سازگار با پلاگین سئو ذخیره کنید.
- ساخت پست و پیوست‌ها. پست را در وضعیت هدف بسازید، تصویر شاخص را از URL امن دانلود و به رسانه اضافه کنید و به پست وصل کنید.
- بازگشت نتیجه. پس از موفقیت، شناسهٔ پست و URL را به کوکار برگردانید؛ در خطاها کد و پیام دقیق بدهید.
نقشه‌برداری فیلدها: پیشنهاد استاندارد
| فیلد کوکار | فیلد وردپرس/سئو | توضیح |
|---|---|---|
| title | post_title | بدون پیشوند اضافه |
| slug | post_name | حروف کوچک و خط تیره |
| contentHtml | post_content | HTML تمیز با تگ‌های مجاز |
| excerpt | post_excerpt | برای آرشیوها و متا |
| meta_title | _yoast_wpseo_title / rank_math_title | قالب عنوان سئو |
| meta_description | _yoast_wpseo_metadesc / rank_math_description | توضیح متای سئو |
| categories | category | ایجاد در صورت نبود |
| tags | post_tag | کاما جدا |
| featured_image | thumbnail_id | دانلود امن و ثبت پیوست |
تنظیمات سئو و خوانایی روی وردپرس
- ساختار پیوند یکتا: روی /%postname%/ بگذارید تا اسلاگ تمیز بماند.
- قالب عنوان و متا: از افزونهٔ سئو قالب‌های پیش‌فرض را ساده کنید تا عنوان‌های ارسالی دست‌نخورده منتشر شوند.
- اسکیما و BreadCrumb: اگر خودکار فعال است، از تداخل با بلوک‌های محتوایی جلوگیری کنید.
- نقشهٔ سایت: بعد از راه‌اندازی، بررسی کنید URLهای جدید در سایت‌مپ دیده می‌شوند.
زمان‌بندی، صف و کنترل کیفیت
برای «انتشار روزانه» بهتر است صف یک تا دو هفته جلوتر پر باشد. کوکار طبق سقف شما هر روز پست را می‌فرستد. شما می‌توانید برای هر دسته زمان متفاوت تعریف کنید (مثلاً اخبار صبح، مقالات راهنما عصر). کنترل کیفیت را با چرخهٔ پیش‌نویس → بازبینی → انتشار خودکار پیاده کنید تا هم سرعت داشته باشید هم ریسک اشتباه پایین بیاید.
امنیت و دسترسی
- کلیدهای محرمانه: فقط در سرور نگه دارید و در قالب‌ها یا JS فرانت‌اند قرار ندهید.
- محدودیت IP و نرخ: درخواست‌ها را به IPهای کوکار محدود و نرخ را محدود کنید تا سوءاستفاده نشود.
- سطح دسترسی: ساخت پست با کاربر سیستمی با حداقل دسترسی انجام شود و تاریخچهٔ تغییرات ثبت شود.
پایداری و پایش
- لاگ کاربردی: زمان ارسال، شناسهٔ پست، خطاها و بازپخش (replay) را لاگ کنید.
- هشدارها: برای شکست انتشار ایمیل/وب‌هوک هشدار بگذارید.
- آزمون بازیابی: سناریوی قطعی موقت را با صف محلی یا صف ابری تست کنید تا محتوای روزانه از دست نرود.
مدیریت تصویر شاخص و رسانه
تصویر شاخص هر مقاله هم‌زمان با تولید محتوا آماده می‌شود. در وردپرس، بررسی کنید اندازه‌های کاستوم قالب تولید شود و فشرده‌سازی به‌صورت WebP یا کیفیت بهینه فعال باشد. نام فایل و متن جایگزین (alt) را از متادیتای ارسال‌شده ست کنید.
اتصال وردپرس به کوکار: خطاهای رایج و رفع آن
- 401 یا 403: کلید نادرست یا محدودیت IP. کلید را نوسازی و IP را به‌روز کنید.
- 409 اسلاگ تکراری: سیاست افزودن پسوند عددی یا بازنویسی خودکار را روشن کنید.
- 429 نرخ بالا: بازهٔ زمان‌بندی را افزایش دهید یا صف را پخش کنید.
- تصویر شاخص ثبت نمی‌شود: دسترسی پوشهٔ آپلودها یا مسدودشدن دانلود از راه دور را بررسی کنید.
بهترین‌عمل‌ها برای انتشار روزانه
- پیش‌نویس هوشمند: انتشار را روی پیش‌نویس شروع و بعد از یک هفته به انتشار خودکار تغییر دهید.
- هم‌نام‌سازی دسته‌ها: دسته‌بندی‌های کوکار و وردپرس را یکسان نگه دارید تا ناوبری سایت مرتب بماند.
- بازنشر و به‌روزرسانی: به‌جای انتشار تکراری، به‌روزرسانی صفحه‌های قدیمی را با شناسه انجام دهید.
- همکاری تیمی: هماهنگی‌ها را در گروه تیم نگه دارید و تغییرات حساس را فقط با تأیید شما اعمال کنید.
چک‌لیست راه‌اندازی سریع
- ورود به حساب و دریافت کلید از ورود.
- نصب افزونه یا پیاده‌سازی اندپوینت طبق راهنمای API.
- نقشه‌برداری فیلدها و تعیین حالت انتشار.
- تست ارسال و بررسی نمایش در قالب.
- تنظیم زمان‌بندی و سقف روزانه در کوکار.
- فعال‌سازی هشدارها و پایش لاگ.
سؤالات متداول
آیا لازم است برای اتصال، قالب یا ساختار سایت را عوض کنم؟
خیر. محتوا به‌صورت HTML تمیز و مطابق با ساختار جاری پست وردپرس تحویل می‌شود و با بیشتر قالب‌ها سازگار است.
می‌توانم انتشار را فقط روی پیش‌نویس نگه دارم؟
بله. در تنظیمات حالت انتشار را «پیش‌نویس» بگذارید تا قبل از انتشار، بازبینی تحریریه انجام شود.
اگر یک روز پست آماده نبود، برنامهٔ روزانه چه می‌شود؟
صف انتشار قابل‌مدیریت است. اگر صف خالی باشد، چیزی منتشر نمی‌شود و می‌توانید با پر کردن صف، برنامه را از سر بگیرید.
ویرایش پست‌های قدیمی چگونه انجام می‌شود؟
کوکار فقط با تأیید شما صفحه‌های قدیمی را به‌روزرسانی می‌کند و همهٔ هماهنگی‌ها در گروه تیم ثبت می‌شود.
آیا امکان اتصال به چند سایت وردپرسی وجود دارد؟
بله. برای هر سایت یک کانکشن و کلید جدا تعریف کنید و سقف روزانهٔ هرکدام را مستقل تنظیم کنید.
جمع‌بندی
با اتصال وردپرس به کوکار، انتشار روزانهٔ مقالات سئو‌شده از یک فرایند دستی و زمان‌بر به یک خط تولید پایدار و قابل‌کنترل تبدیل می‌شود. اگر آماده‌اید اولین مقالهٔ کامل و اتصال فنی را همین امروز راه بیندازید، از کوکار شروع کنید و جزئیات پیاده‌سازی را در راهنمای API ببینید.
