manifest / content / mrn-wp-content-bridge

MRN Content Bridge

MRN Content Bridge — AI Content Automation for WordPress

by Mehran Marandi · github.com/mehran-mrn/mrn-wp-content-bridge · website

★ 0stars

0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/mehran-mrn/mrn-wp-content-bridge/archive/refs/heads/main.zip

Readme

MRN Content Bridge

افزونه مستقل و ماژولار وردپرس برای دریافت محتوا از Telegram، Bale، RSS و Instagram، پردازش مستقیم یا هوشمند، ساخت نوشته وردپرس، تأیید انسانی و انتشار دوباره مطالب سایت در شبکه‌های اجتماعی.

نسخه فعلی: 1.7.0

حداقل وردپرس: 6.5

حداقل PHP: 8.1

امکانات اصلی

دریافت Telegram و Bale فقط با Long Polling و متد getUpdates؛ بدون Webhook
Worker مستقل از ترافیک سایت با WP-CLI، Cron واقعی سرور و WP-Cron جایگزین
کنترل فشار صف با Batch محدود RSS، سقف Job فعال، بودجه زمانی Worker و توقف خودکار منبع دارای خطای احراز هویت
ابزار تخلیه کامل صف با تأیید صریح مدیر و لغو Workflowهای نیمه‌تمام
قفل Worker، Batch Size، Polling interval، Retry با exponential backoff و زمان آخرین اجرای موفق
پشتیبانی از Text، Link، Photo + Caption، Media Group، Video + Caption، Document، Forwarded Message، Channel Post و Edited Channel Post
دریافت امن لینک مستقیم ویدئو، صوت، PDF، ZIP و RAR از متن پیام تا سقف کمتر از ۹۹ مگابایت و ذخیره در کتابخانه رسانه
ساخت پلیر ویدئو/صوت، نمایشگر مرورگری PDF، کارت دانلود آرشیو و تصویر شاخص از thumbnail پیام‌رسان یا فریم FFmpeg
دریافت تکرارناپذیر RSS/Atom با دسته‌بندی و برچسب‌های پیش‌فرض اختصاصی برای هر فید
دریافت Instagram از API رسمی یا fallback بدون API برای صفحات عمومی، همراه با تصویر، ویدئو و Carousel
شناسه پایدار مبتنی بر permalink برای جلوگیری از ثبت و انتشار تکراری Instagram حتی هنگام جابه‌جایی بین API و fallback
انتخاب نویسنده وردپرس به‌صورت مستقل برای تمام منابع ورودی
مسیر سردبیر اختصاصی Telegram/Bale برای هر منبع Telegram، Bale، RSS یا Instagram؛ بدون ارسال تأیید به افراد نامرتبط
ورود سریع یک‌بارمصرف ۶۰ ثانیه‌ای از گفت‌وگوی خصوصی هر منبع ربات فعال، متصل به حساب نویسنده همان منبع
فرمان /login، پیام «ورود سریع» و دکمه ربات برای ساخت لینک تازه بدون نام کاربری و رمز عبور
استخراج تصویر RSS از enclosure، Media RSS و HTML، انتقال به کتابخانه رسانه و تنظیم خودکار تصویر شاخص
ارسال پیش‌نمایش مطالب RSS به ربات Telegram/Bale و دریافت تأیید، رد یا درخواست اصلاح پیش از انتشار
تجمیع پیام‌های دارای media_group_id در یک Workflow
دانلود فایل با API پلتفرم، کنترل حجم/MIME و ورود امن به Media Library
حالت مستقیم، Rewrite/Translate با OpenAI و پرامپت اختصاصی هر Source
خروجی HTML تمیز و wp_kses_post؛ طراحی آماده برای افزودن Gutenberg renderer
Providerهای مستقل متن و تصویر با Interface و registry قابل توسعه
Responses API برای متن ساختاریافته و Images API برای تولید تصویر
خروجی ساختاریافته شامل عنوان، چکیده، HTML امن، برچسب‌ها، کلیدواژه‌های SEO و پرامپت تصویر
ارسال دسته‌بندی‌های واقعی وردپرس به ربات و توقف انتشار تا انتخاب امن یک دسته‌بندی
Job مستقل برای تولید متن، تصویر، جایگزینی placeholder، تأیید و انتشار اجتماعی
Draft، Pending Review، Publish Immediately و Schedule
تأیید Telegram/Bale با callback token امن و یک‌بارمصرف، allowlist تأییدکننده و Audit Log
بازبینی اختیاری پیش از انتشار در ربات با تأیید، رد یا درخواست اصلاح متنی؛ پیام اصلاح به همان Workflow متصل می‌شود و مطلب تازه نمی‌سازد
حالت اقتصادی تولید تصویر: امکان تولید تصویر AI فقط وقتی ورودی هیچ عکس یا سند تصویری ندارد
متاباکس «MRN Social Publishing» برای متن دستی یا تولید هوشمند مستقل هر پلتفرم
انتشار idempotent و مستقل برای هر مقصد؛ شکست یک مقصد مانع بقیه نیست
LinkedIn OAuth 2.0، Images API و Posts API رسمی
پنل RTL واکنش‌گرا برای Dashboard، Sources، Destinations، Workflows، Approval Queue، Jobs، Logs، AI Providers، Settings و Tools
رابط مدیریت دوزبانه: فارسی/RTL و انگلیسی/LTR بر اساس زبان کاربر وردپرس

نصب

پوشه mrn-content-bridge را در wp-content/plugins/ قرار دهید.
افزونه «MRN Content Bridge» را فعال کنید.
در «Content Bridge ← منابع» Bot Token و Chat/Channel ID را ثبت کنید.
در «AI Providers» در صورت نیاز OpenAI API Key و تنظیمات LinkedIn را ثبت کنید.
Worker واقعی سرور را فعال کنید.

wp mrn-content-bridge worker
wp mrn-content-bridge worker --loop --sleep=5

نمونه Cron واقعی:

* * * * * cd /var/www/html && wp mrn-content-bridge worker --quiet

برای پردازش پیوسته، --loop را زیر Supervisor یا systemd اجرا کنید. WP-Cron فقط جایگزین ساده است.

LinkedIn API مکانیزم getUpdates ندارد. این افزونه برای انتشار از OAuth 2.0 و API رسمی rest/posts استفاده می‌کند. تصویر شاخص ابتدا با Images API آپلود می‌شود.

انتشار شخصی معمولاً به محصول Share on LinkedIn و scope w_member_social نیاز دارد.
انتشار/خواندن سازمانی و خواندن feed به تأیید Community Management API و مجوزهای رسمی سازمان نیاز دارد.
دسترسی نداشتن به این مجوزها در پنل افزونه به‌وضوح نمایش داده می‌شود.
نسخه پیش‌فرض هدر API در این release برابر 202607 و از پنل قابل تغییر است.

مراجع رسمی: LinkedIn OAuth، Posts API، Images API

Instagram

برای هر منبع Instagram سه روش دریافت وجود دارد:

auto: ابتدا API رسمی و در صورت خطا fallback صفحه عمومی
api: فقط API رسمی؛ Access Token الزامی است
public: فقط HTML صفحه عمومی؛ بدون نیاز به Token

fallback عمومی داده JSON جاسازی‌شده در صفحه، لینک‌های Post/Reel و متادیتای Open Graph را بررسی می‌کند. این روش best-effort است و به‌دلیل تغییر HTML، خصوصی بودن حساب، صفحه ورود یا Rate Limit اینستاگرام ممکن است موقتاً چیزی دریافت نکند. برای سرویس پایدار، API رسمی پیشنهاد می‌شود.

OpenAI

Provider متن از Responses API با Structured Outputs استفاده می‌کند و HTML دریافتی پیش از ذخیره با allowlist وردپرس sanitize می‌شود. Provider تصویر جدا است و از Images API استفاده می‌کند. مدل‌ها از پنل قابل تغییرند؛ پیش‌فرض‌های این release:

متن: gpt-5.6-terra
تصویر: gpt-image-2

کلید API رمزنگاری می‌شود و در HTML، JavaScript، REST response یا log نمایش داده نمی‌شود.

مراجع رسمی: OpenAI Responses API، Models، GPT Image 2

توسعه Adapter یا Provider

Adapter جدید باید PlatformAdapterInterface را پیاده کند و از فیلتر mrncb_platform_adapters یا action mrncb_loaded ثبت شود. Providerهای متن و تصویر به‌ترتیب TextProviderInterface و ImageProviderInterface را پیاده می‌کنند.

Hookهای اصلی:

add_filter( 'mrncb_platform_adapters', function ( array $adapters ): array {
    $adapters['custom'] = new CustomAdapter();
    return $adapters;
} );

add_action( 'mrncb_handle_job_custom_job', function ( array $payload ): void {
    // Custom durable job handler.
} );

امنیت و حریم خصوصی

Nonce و capability در تمام عملیات مدیریتی
رمزنگاری credentialها با Sodium secretbox یا AES-256-GCM
حذف credential و Authorization از Log context
محدودیت حجم و MIME فایل ورودی
sanitize کامل HTML هوش مصنوعی
OAuth state یک‌بارمصرف
callback تأیید با HMAC، انقضا و allowlist User ID
idempotency در update، workflow، approval و social destination

تست

composer install
composer lint
composer test

مجوز

GPL-2.0-or-later

سازنده

Mehran Marandi

Read the full README on GitHub →