Skip to content

abdulhalim/SimpleGallery

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📸 SimpleGallery – گالری تصاویر پیشرفته و مینیمال برای تایپ‌چو

Typecho

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


✨ ویژگی‌ها

  • ۵ استایل متفاوت گالری
    مینیمال (درخشش حاشیه)، زوم مدرن، لیفت سه‌بعدی، نمای رنگی تدریجی (خاکستری به رنگی) و هنری (چیدمان خلاقانه)

  • واکنش‌گرا (ریسپانسیو) – سازگار با موبایل، تبلت و دسکتاپ

  • لایت‌باکس حرفه‌ای – با استفاده از GLightbox و پشتیبانی از جهت راست‌چین

  • مرورگر تصاویر در ویرایشگر
    بدون نیاز به کدنویسی، پوشه usr/uploads را مرور کنید (حتی زیرپوشه‌های سال/ماه) و چند تصویر را همزمان انتخاب کنید

  • قابل تنظیم از طریق پنل مدیریت
    تعیین استایل پیش‌فرض، تعداد ستون، نسبت تصویر (افقی/عمودی/مربع) و جهت (راست‌چین/چپ‌چین/خودکار)

  • انیمیشن لود متوالی – تصاویر یکی پس از دیگری با تاخیر ظاهر می‌شوند

  • پارامترهای داخل شورت‌کد – امکان تغییر استایل، ستون و نسبت برای هر گالری به صورت جداگانه

  • پشتیبانی کامل از RTL – به‌طور خودکار زبان فارسی را تشخیص می‌دهد


📦 نیازمندی‌ها

  • تایپ‌چو نسخه 1.2 یا بالاتر
  • PHP 7.0 یا بالاتر
  • دسترسی نوشتن روی پوشه /usr/uploads (برای مرورگر تصاویر)

🔧 نصب

  1. فایل پلاگین را دانلود یا کلون کنید.
  2. پوشه SimpleGallery را در مسیر usr/plugins/ تایپ‌چو کپی کنید.
  3. وارد پیشخوان تایپ‌چو شوید → مدیریت پلاگین‌هافعال کردن SimpleGallery.
  4. (اختیاری) تنظیمات دلخواه را در پلاگین‌ها → SimpleGallery انجام دهید.

⚙️ تنظیمات پلاگین

گزینه توضیح
جهت نمایش خودکار (بر اساس زبان سایت)، راست‌چین، چپ‌چین
تعداد ستون پیش‌فرض ۲، ۳ یا ۴
استایل پیش‌فرض مینیمال / زوم مدرن / لیفت مدرن / ریویل مدرن / هنری
شکل پیش‌فرض تصاویر افقی (16:9) / عمودی (9:16) / مربع (1:1)
انیمیشن لود متوالی فعال / غیرفعال
تاخیر انیمیشن میلی‌ثانیه (پیش‌فرض ۱۰۰)

📝 طریقه استفاده

ساختار شورت‌کد

[gallery style="minimal" columns="3" ratio="landscape"]
https://example.com/image1.jpg
https://example.com/image2.jpg
https://example.com/image3.jpg
[/gallery]

تصاویر را می‌توان به صورت آدرس مستقیم (هر آدرس در یک خط) یا به صورت تصاویر مارک‌دون یا تگ <img> درون شورت‌کد قرار داد.
همچنین می‌توانید از ویژگی urls استفاده کنید:

[gallery urls="img1.jpg, img2.jpg, img3.jpg" /]

پارامترهای قابل استفاده

پارامتر مقادیر مجاز پیش‌فرض
style minimal, modern-zoom, modern-lift, modern-reveal, artistic تنظیمات پلاگین
columns 2, 3, 4 (در استایل هنری تأثیری ندارد) تنظیمات پلاگین
ratio landscape, portrait, square تنظیمات پلاگین

نکته: استایل هنری از چیدمان ۳ ستونی با طرحی همچون موزاییک استفاده می‌کند و در موبایل به‌طور خودکار تک ستون می‌شود.

استفاده از دکمه ویرایشگر

  1. در صفحه نوشتن مطلب یا برگه، روی آیکون گالری کلیک کنید.
  2. پنجره مرورگر باز می‌شود – می‌توانید در پوشه usr/uploads حرکت کنید.
  3. روی هر تصویر کلیک کنید تا انتخاب شود (امکان انتخاب چندتایی وجود دارد). پوشه‌ها نیز قابل باز شدن هستند.
  4. برای بازگشت از دکمه «بازگشت» یا قسمت راهنمای مسیر (breadcrumb) استفاده کنید.
  5. در صورت تمایل، آدرس اینترنتی تصاویر خارجی را در قسمت «ورود دستی URL» وارد کنید (هر آدرس در یک خط).
  6. استایل، تعداد ستون و نسبت تصویر مورد نظر را انتخاب کنید.
  7. روی درج گالری کلیک کنید – شورت‌کد ساخته شده به محتوای مقاله اضافه می‌شود.

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

تمام فایل‌های CSS در css/gallery.css و css/editor-modal.css قرار دارند.
می‌توانید آن‌ها را در قالب خود بازنویسی کنید یا مستقیماً در فایل پلاگین تغییر دهید.

تنظیمات لایت‌باکس

لایت‌باکس از CDN بارگیری می‌شود. پلاگین به‌طور خودکار جهت RTL را تشخیص داده و دکمه‌های قبلی/بعدی را اصلاح می‌کند.
برای تغییر تنظیمات لایت‌باکس، فایل js/gallery.js را ویرایش کنید (قسمت GLightbox({ ... })).


❓ عیب‌یابی

مرورگر تصاویر کار نمی‌کند / خطای «پوشه یافت نشد»

  • مطمئن شوید پوشه /usr/uploads وجود دارد و قابل خواندن است.
  • اطمینان حاصل کنید که فایل ajax.php در پوشه پلاگین به درستی قابل دسترسی است. پنجره کنسول مرورگر را باز کنید – باید درخواست‌هایی به .../ajax.php?action=list-images ببینید.
  • در برخی هاست‌ها ممکن است نیاز به تنظیم مجوز پوشه (۷۵۵) باشد.

گالری در لایت‌باکس باز نمی‌شود

  • بررسی کنید که فایل glightbox.min.js در صفحه بارگذاری شده باشد (از طریق View Source).
  • اگر قالب شما لایت‌باکس مخصوص به خود را دارد، ممکن است تداخل ایجاد کند. در این صورت، در قالب خود برای المان‌های دارای کلاس .gallery-link لایت‌باکس را غیرفعال کنید.

دکمه‌های قبلی/بعدی در لایت‌باکس برعکس نشان داده می‌شوند

  • پلاگین به‌طور خودکار فلش‌ها را برای حالت راست‌چین برعکس می‌کند. اگر این اتفاق نیفتاد، در تنظیمات پلاگین جهت را به صورت دستی روی «راست‌چین» قرار دهید.

🙏 سپاسگزاری

  • GLightbox – کتابخانه لایت‌باکس مدرن
  • آیکون‌ها – Feather Icons (از طریق SVG)
  • نویسنده: پوردریایی

About

گالری تصاویر حرفه‌ای و سبک برای تایپ‌چو – با ۵ استایل زیبا، مرورگر داخلی تصاویر، لایت‌باکس مدرن، پشتیبانی از RTL و انیمیشن لود متوالی. به راحتی با شورت‌کد [gallery] گالری بسازید.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors