Inline Related Posts (IRP) is a lightweight and smart WordPress plugin that automatically displays inline related posts within your content.
It selects relevant posts using simple and effective algorithms and inserts them at specific points in the content to increase user engagement and improve on-site SEO.

---

✨ Features

• 🔹 Automatically displays related posts inline within content
• 🔹 Supports multiple post types (posts, pages, WooCommerce products, etc.)
• 🔹 Filter by categories and tags
• 🔹 Two display styles: Grid (cards) and List (simple)
• 🔹 Customizable number of posts and paragraph position
• 🔹 Theme color and custom CSS class support
• 🔹 Shortcode for manual insertion anywhere in the content
• 🔹 Compatible with Classic Editor and Gutenberg
• 🔹 Lightweight and optimized code

---

⚙️ Installation

1. Upload the plugin folder to:

🧩 Inline Related Posts (IRP)

Inline Related Posts (IRP) یک افزونهٔ سبک و هوشمند برای وردپرس است که مطالب مرتبط را به‌صورت درون‌متن (Inline) در نوشته‌ها و برگه‌ها نمایش می‌دهد.
این افزونه با الگوریتم‌های ساده و مؤثر، محتوای مرتبط را انتخاب کرده و در نقاط مشخصی از متن درج می‌کند تا مدت‌زمان ماندن کاربر در سایت افزایش یابد و بهبود سئوی داخلی حاصل شود.

---

✨ ویژگی‌ها

• 🔹 نمایش پست‌های مرتبط به‌صورت خودکار درون محتوای نوشته
• 🔹 پشتیبانی از چندین نوع پست‌تایپ (نوشته، برگه، محصولات و...)
• 🔹 انتخاب دسته‌ها و برچسب‌های خاص برای فیلتر بهتر
• 🔹 دو استایل زیبا: حالت کارت‌ها (Grid) و فهرستی (List)
• 🔹 تنظیم تعداد پست‌ها و پاراگراف هدف برای درج
• 🔹 رنگ‌بندی دلخواه و امکان تعریف کلاس CSS سفارشی
• 🔹 شورت‌کد اختصاصی برای درج دستی در هر نقطه از محتوا
• 🔹 کاملاً سازگار با ویرایشگر کلاسیک و گوتنبرگ
• 🔹 کدنویسی بهینه و سبک، بدون وابستگی به کتابخانه‌های اضافی

---

⚙️ نصب افزونه

1. پوشهٔ افزونه را در مسیر زیر آپلود کنید:

🛠 راهنمای تنظیمات افزونه Inline Related Posts (IRP)

پس از نصب و فعال‌سازی افزونه، از مسیر
پیشخوان وردپرس → تنظیمات → Inline Related Posts (IRP)
می‌توانید بخش‌های مختلف افزونه را پیکربندی کنید.

در این صفحه، گزینه‌های زیر در دسترس هستند:

---

🔸 نمایش بعد از چندمین پاراگراف

تعیین می‌کند که بلوک مطالب مرتبط بعد از چند پاراگراف از محتوای اصلی نمایش داده شود.
اگر مقدار ۰ وارد شود، افزونه بلوک را در انتهای محتوا درج می‌کند.
در صورتی که از دکمهٔ درج یا شورت‌کد استفاده کنید، این گزینه نادیده گرفته می‌شود.

---

🔸 پست‌تایپ‌ها (Post Types)

می‌توانید مشخص کنید افزونه در کدام نوع نوشته‌ها فعال باشد، مانند:

• نوشته
• برگه
• رسانه
• محصولات ووکامرس
• قالب‌های Listing یا Components

اگر هیچ گزینه‌ای انتخاب نشود، افزونه در همهٔ پست‌تایپ‌ها فعال خواهد بود.

---

🔸 دسته‌ها (Categories)

می‌توانید نمایش مطالب مرتبط را به دسته‌های خاص محدود کنید.
در صورت عدم انتخاب، افزونه در تمام دسته‌ها عمل می‌کند.

مثلاً:

• آموزش
• بررسی تخصصی
• ترفندهای اینستاگرام
• دانلود باکس
• برنامه اندروید

---

🔸 تعداد پست‌ها (Posts Count)

تعداد مطالب مرتبطی که در هر بلوک نمایش داده می‌شود را مشخص می‌کند.
به‌صورت پیش‌فرض: ۴ پست مرتبط نمایش داده می‌شود.

---

🔸 الگوریتم نمایش (Algorithm)

نحوهٔ انتخاب مطالب مرتبط:

• مطالب مشابه: بر اساس دسته‌ها یا برچسب‌های نوشتهٔ جاری.
• تصادفی: نمایش تصادفی از میان پست‌های موجود.

---

🔸 استایل نمایش (Style)

نوع طراحی بلوک مطالب مرتبط را مشخص می‌کند:

• کارت‌ها (شبکه‌ای): نمایش جذاب و تصویری با چینش ستونی.
• فهرستی (ساده): حالت کلاسیک با عنوان و لینک ساده.

---

🔸 رنگ تم (Theme Color)

رنگ اصلی عناصر افزونه (مثل عنوان، لینک‌ها یا دکمه‌ها) را تعیین می‌کند.
نمونه: #0ea5e9

---

🔸 کلاس CSS سفارشی (Custom CSS Class)

اگر می‌خواهید استایل اختصاصی برای بلوک‌ها تعریف کنید، می‌توانید در این بخش نام کلاس CSS خود را وارد کنید.
این ویژگی مخصوص توسعه‌دهندگان و طراحان قالب است.

---

🔸 درج خودکار (Auto Insert)

در صورت فعال بودن، افزونه به‌صورت خودکار بلوک مطالب مرتبط را در محل مشخص‌شده (مثلاً بعد از پاراگراف پنجم) درج می‌کند.
در صورت استفاده از شورت‌کد [irp_related]، این گزینه نادیده گرفته می‌شود.