Skip to content

barmaandev/inlinedoon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

InlineDoon - WooCommerce Product Slider Plugin

WordPress WooCommerce PHP License

A powerful WordPress plugin for displaying WooCommerce products in beautiful, responsive sliders using Swiper.js. Perfect for showcasing your products anywhere on your website with customizable shortcodes.

🌟 Features

  • 🎯 Easy Shortcode Integration - Display products anywhere with simple shortcodes
  • 📱 Fully Responsive - Optimized for mobile, tablet, and desktop
  • ⚙️ Highly Customizable - Control slides, autoplay, spacing, and more
  • 🔄 Smart Product Selection - Mix specific products with random category products
  • 🚫 Product Exclusion - Exclude specific products from display
  • 📦 Stock Filtering - Show only in-stock products or all products
  • 🌍 RTL Support - Perfect for Persian/Arabic websites
  • 🎨 Beautiful Design - Clean, modern slider interface
  • ⚡ Fast Performance - Lightweight and optimized code
  • 🛡️ Secure - Follows WordPress security best practices

📋 Requirements

  • WordPress 5.0 or higher
  • WooCommerce 3.0 or higher
  • PHP 7.4 or higher

🚀 Installation

Method 1: WordPress Admin (Recommended)

  1. Download the plugin ZIP file
  2. Go to Plugins > Add New > Upload Plugin
  3. Choose the ZIP file and click Install Now
  4. Activate the plugin

Method 2: FTP Upload

  1. Extract the ZIP file
  2. Upload the inlinedoon folder to /wp-content/plugins/
  3. Activate the plugin from Plugins menu

🎯 Quick Start

Basic Usage

[inlinedoon]

Advanced Usage

[inlinedoon cat="electronics" include="123,456" link_text="View All Products" link_url="https://example.com/products"]

📖 Shortcode Parameters

Parameter Description Example
cat Product category slug cat="electronics"
include Specific product IDs (comma-separated) include="123,456,789"
exclude Product IDs to exclude (comma-separated) exclude="123,456"
instock Filter for in-stock products (true/false) instock="true"
link_text Custom "View All" link text link_text="Shop Now"
link_url Custom link URL link_url="https://example.com"

🎨 Examples

Display Electronics Products

[inlinedoon cat="electronics"]

Show Specific Products

[inlinedoon include="123,456,789"]

Custom Link and Text

[inlinedoon cat="books" link_text="Browse All Books" link_url="https://example.com/books"]

Exclude Specific Products

[inlinedoon cat="electronics" exclude="123,456"]

Show Only In-Stock Products

[inlinedoon cat="electronics" instock="true"]

Combined Parameters

[inlinedoon cat="clothing" include="100,200" exclude="300" instock="true" link_text="Shop Collection"]

⚙️ Settings

Access the settings from InlineDoon > Settings in your WordPress admin:

Slider Configuration

  • Mobile Slides: Number of products on mobile devices
  • Tablet Slides: Number of products on tablets
  • Desktop Slides: Number of products on desktop
  • Space Between: Gap between products in pixels
  • Autoplay: Enable/disable automatic sliding
  • Autoplay Delay: Time each slide is displayed
  • Loop: Enable/disable continuous loop
  • RTL: Enable/disable right-to-left direction
  • Stock Filter: Default setting for showing only in-stock products

Access Control

  • Configure which user roles can access the plugin admin
  • Administrator always has full access

🔧 How It Works

  1. Product Selection: The plugin first shows products specified in include parameter
  2. Category Fill: Then adds random products from the specified category
  3. Stock Filter: Only displays products that are in stock
  4. Limit: Maximum 12 products per slider
  5. Swiper Integration: Uses Swiper.js for smooth, responsive sliding

🎨 Customization

CSS Customization

You can customize the slider appearance by editing:

  • assets/css/frontend.css - Main slider styles
  • assets/css/swiper.css - Swiper library styles

JavaScript Customization

The slider behavior can be modified in:

  • assets/js/frontend.js - Frontend slider logic

🐛 Troubleshooting

Slider Not Displaying

  • Ensure WooCommerce is active
  • Check that products exist in the specified category
  • Verify products are in stock

Random Products Not Showing

  • Confirm the category slug is correct
  • Ensure sufficient products exist in the category

Styling Issues

  • Check for theme conflicts
  • Verify CSS files are loading properly
  • Clear any caching plugins

📞 Support

  • Website: webdoon.ir
  • Author: Barmaan Shokoohi
  • Version: 1.0.0

📄 License

This plugin is licensed under the GPL v2 or later.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 Changelog

Version 1.0.0

  • Initial release
  • Basic shortcode functionality
  • Responsive slider design
  • Admin settings panel
  • RTL support
  • Persian language support

این‌لاین دون - پلاگین اسلایدر محصولات ووکامرس

پلاگین قدرتمند وردپرس برای نمایش محصولات ووکامرس در اسلایدرهای زیبا و ریسپانسیو با استفاده از Swiper.js. مناسب برای نمایش محصولات در هر جای وب‌سایت با شورت‌کدهای قابل تنظیم.

🌟 ویژگی‌ها

  • 🎯 ادغام آسان شورت‌کد - نمایش محصولات در هر جای سایت با شورت‌کدهای ساده
  • 📱 کاملاً ریسپانسیو - بهینه‌شده برای موبایل، تبلت و دسکتاپ
  • ⚙️ قابل تنظیم بالا - کنترل اسلایدها، اتوپلی، فاصله و بیشتر
  • 🔄 انتخاب هوشمند محصولات - ترکیب محصولات خاص با محصولات تصادفی دسته‌بندی
  • 🌍 پشتیبانی RTL - مناسب برای وب‌سایت‌های فارسی/عربی
  • 🎨 طراحی زیبا - رابط اسلایدر تمیز و مدرن
  • ⚡ عملکرد سریع - کد سبک و بهینه‌شده
  • 🛡️ امن - از بهترین روش‌های امنیتی وردپرس پیروی می‌کند

📋 پیش‌نیازها

  • وردپرس 5.0 یا بالاتر
  • ووکامرس 3.0 یا بالاتر
  • PHP 7.4 یا بالاتر

🚀 نصب

روش 1: پنل مدیریت وردپرس (توصیه شده)

  1. فایل ZIP پلاگین را دانلود کنید
  2. به افزونه‌ها > افزودن > بارگذاری افزونه بروید
  3. فایل ZIP را انتخاب کرده و نصب را کلیک کنید
  4. پلاگین را فعال کنید

روش 2: آپلود FTP

  1. فایل ZIP را استخراج کنید
  2. پوشه inlinedoon را به /wp-content/plugins/ آپلود کنید
  3. پلاگین را از منوی افزونه‌ها فعال کنید

🎯 شروع سریع

استفاده پایه

[inlinedoon]

استفاده پیشرفته

[inlinedoon cat="electronics" include="123,456" link_text="مشاهده همه محصولات" link_url="https://example.com/products"]

📖 پارامترهای شورت‌کد

پارامتر توضیحات مثال
cat اسلاگ دسته‌بندی محصولات cat="electronics"
include شناسه‌های محصولات خاص (جدا شده با کاما) include="123,456,789"
link_text متن لینک "مشاهده همه" سفارشی link_text="خرید کنید"
link_url آدرس لینک سفارشی link_url="https://example.com"

🎨 نمونه‌ها

نمایش محصولات الکترونیک

[inlinedoon cat="electronics"]

نمایش محصولات خاص

[inlinedoon include="123,456,789"]

لینک و متن سفارشی

[inlinedoon cat="books" link_text="مشاهده همه کتاب‌ها" link_url="https://example.com/books"]

ترکیب پارامترها

[inlinedoon cat="clothing" include="100,200" link_text="خرید از مجموعه"]

⚙️ تنظیمات

از این‌لاین دون > تنظیمات در پنل مدیریت وردپرس به تنظیمات دسترسی پیدا کنید:

پیکربندی اسلایدر

  • اسلایدهای موبایل: تعداد محصولات در دستگاه‌های موبایل
  • اسلایدهای تبلت: تعداد محصولات در تبلت‌ها
  • اسلایدهای دسکتاپ: تعداد محصولات در دسکتاپ
  • فاصله بین: فاصله بین محصولات به پیکسل
  • اتوپلی: فعال/غیرفعال کردن اسلاید خودکار
  • تاخیر اتوپلی: مدت زمان نمایش هر اسلاید
  • حلقه: فعال/غیرفعال کردن تکرار مداوم
  • RTL: فعال/غیرفعال کردن راست به چپ

کنترل دسترسی

  • تنظیم اینکه کدام نقش‌های کاربری به پنل مدیریت پلاگین دسترسی داشته باشند
  • مدیرکل همیشه دسترسی کامل دارد

🔧 نحوه عملکرد

  1. انتخاب محصولات: پلاگین ابتدا محصولات مشخص شده در پارامتر include را نمایش می‌دهد
  2. پر کردن دسته‌بندی: سپس محصولات تصادفی از دسته‌بندی مشخص شده را اضافه می‌کند
  3. فیلتر موجودی: فقط محصولات موجود در انبار را نمایش می‌دهد
  4. محدودیت: حداکثر 12 محصول در هر اسلایدر
  5. ادغام Swiper: از Swiper.js برای اسلاید روان و ریسپانسیو استفاده می‌کند

🎨 سفارشی‌سازی

سفارشی‌سازی CSS

می‌توانید ظاهر اسلایدر را با ویرایش موارد زیر سفارشی کنید:

  • assets/css/frontend.css - استایل‌های اصلی اسلایدر
  • assets/css/swiper.css - استایل‌های کتابخانه Swiper

سفارشی‌سازی JavaScript

رفتار اسلایدر را می‌توان در موارد زیر تغییر داد:

  • assets/js/frontend.js - منطق اسلایدر فرانت‌اند

🐛 عیب‌یابی

اسلایدر نمایش داده نمی‌شود

  • اطمینان حاصل کنید که ووکامرس فعال است
  • بررسی کنید که محصولات در دسته‌بندی مشخص شده وجود دارند
  • مطمئن شوید که محصولات موجود در انبار هستند

محصولات تصادفی نمایش داده نمی‌شوند

  • اسلاگ دسته‌بندی را تأیید کنید
  • اطمینان حاصل کنید که محصولات کافی در دسته‌بندی وجود دارد

مشکلات استایل

  • بررسی تداخل با تم
  • تأیید بارگذاری صحیح فایل‌های CSS
  • کش پلاگین‌ها را پاک کنید

📞 پشتیبانی

  • وب‌سایت: webdoon.ir
  • نویسنده: بارمان شکوهی
  • نسخه: 1.0.1

📄 مجوز

این پلاگین تحت مجوز GPL v2 یا بالاتر منتشر شده است.

🤝 مشارکت

مشارکت‌ها خوشامد است! لطفاً Pull Request ارسال کنید.

📝 تغییرات

نسخه 1.0.1

  • اضافه شدن پارامتر exclude برای حذف محصولات خاص
  • اضافه شدن پارامتر instock برای فیلتر محصولات موجود
  • تنظیمات پیش‌فرض فیلتر موجودی در پنل مدیریت
  • بهبود مستندات و راهنمای استفاده
  • رفع مشکلات جزئی

نسخه 1.0.0

  • انتشار اولیه
  • عملکرد پایه شورت‌کد
  • طراحی اسلایدر ریسپانسیو
  • پنل تنظیمات مدیریت
  • پشتیبانی RTL
  • پشتیبانی زبان فارسی

Releases

No releases published

Packages

 
 
 

Contributors