تصاویر تصادفی و گالری عمومی

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

System Settings -> Other Settings

API تصاویر تصادفی

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

پس از فعال شدن، از این نشانی استفاده کنید:

https://your-domain.com/random

تنظیمات API تصاویر تصادفی

گزینه	هدف
فعال‌سازی	نقطه پایانی /random را روشن یا خاموش می‌کند. وقتی غیرفعال باشد، دسترسی رد می‌شود.
پوشه‌ها	مشخص می‌کند API تصاویر تصادفی از کدام پوشه‌ها می‌تواند استفاده کند. پوشه‌هایی که اینجا نیستند توسط API قابل استفاده نیستند.
نمونه فراخوانی	پیوندهای API تصاویر تصادفی را می‌سازد که می‌توانید مستقیم کپی کنید.

می‌توانید چند پوشه انتخاب کنید. برای مثال، اگر فقط /landscape/ و /portrait/ مجاز باشند، API تصاویر تصادفی فقط می‌تواند از همان پوشه‌ها و زیرپوشه‌هایشان فایل انتخاب کند.

پارامترهای API تصاویر تصادفی

پارامتر	نمونه	هدف
dir	/landscape/	پوشه تصادفی را مشخص می‌کند.
content	image	نوع رسانه را مشخص می‌کند. از image، video، audio یا ترکیب‌های جداشده با ویرگول استفاده کنید.
orientation	auto	جهت تصویر را فیلتر می‌کند. از portrait، landscape یا auto استفاده کنید.
type	url	قالب بازگشت. مقدار خالی یعنی تغییر مسیر، url نشانی متنی برمی‌گرداند و json خروجی JSON برمی‌گرداند.
origin	1	همراه type=url برای بازگرداندن URL کامل استفاده می‌شود.
age	all-ages,r12	بر اساس رده‌بندی سنی فیلتر می‌کند.
tag	wallpaper,sky	فقط فایل‌هایی را برمی‌گرداند که این برچسب‌ها را دارند.
ex	private	فایل‌هایی را که این برچسب‌ها را دارند کنار می‌گذارد.

قالب‌های بازگشت

بدون type، API مستقیم به URL فایل تصادفی تغییر مسیر می‌دهد.

با type=url، یک URL متنی برمی‌گرداند.

با type=json، اطلاعات فایل را برمی‌گرداند؛ شامل URL فایل، شناسه فایل، نام فایل، نوع فایل، برچسب‌ها، رده‌بندی و فراداده‌های مرتبط.

قوانین دسترسی

API تصاویر تصادفی از قوانین دسترسی عمومی پیروی می‌کند:

قانون	اثر
محدودیت پوشه	فقط فایل‌های داخل پوشه‌های مجاز می‌توانند انتخاب شوند.
فهرست مسدود	فایل‌های موجود در فهرست مسدود از مجموعه تصادفی کنار گذاشته می‌شوند.
حالت فهرست مجاز	وقتی فعال باشد، فقط فایل‌های مجاز برای دسترسی عمومی برگردانده می‌شوند.
رده‌بندی سنی	محتوای R12، R16، R18 و مشابه بر اساس حالت دسترسی فعلی فیلتر می‌شود.

اگر پس از فیلتر کردن هیچ فایلی مطابق نباشد، API هیچ نتیجه مطابقی برنمی‌گرداند.

حافظه پنهان

API تصاویر تصادفی برای افزایش سرعت، مجموعه‌های نامزد هر پوشه را در حافظه پنهان نگه می‌دارد.

پس از تغییر فایل‌ها، ImgHost نسخه حافظه پنهان پوشه را به‌روزرسانی می‌کند و درخواست‌های بعدی مجموعه نامزدها را دوباره می‌سازند. پوشه‌های خالی برای مدت کوتاهی در حافظه پنهان می‌مانند تا پرس‌وجوهای تکراری کمتر شود.

گالری عمومی

گالری عمومی یک صفحه مرور عمومی فقط‌خواندنی برای پوشه‌هایی فراهم می‌کند که اجازه می‌دهید بازدیدکنندگان ببینند.

پس از فعال شدن، بازدیدکنندگان می‌توانند این نشانی را باز کنند:

https://your-domain.com/browse/directory-name

تنظیمات گالری عمومی

گزینه	هدف
فعال‌سازی	گالری عمومی را روشن یا خاموش می‌کند. وقتی غیرفعال باشد، بازدیدکنندگان نمی‌توانند آن را مرور کنند.
حالت بارگذاری تصویر	کنترل می‌کند پیش‌نمایش‌ها از تصاویر اصلی استفاده کنند یا بندانگشتی‌ها.
پوشه‌های باز	مشخص می‌کند بازدیدکنندگان به کدام پوشه‌ها دسترسی داشته باشند.

حالت بارگذاری تصویر

حالت	هدف
اصلی	صفحه بازدیدکننده فایل‌های اصلی را مستقیم بارگذاری می‌کند.
بندانگشتی	صفحه بازدیدکننده برای بارگذاری سریع‌تر بندانگشتی‌ها را ترجیح می‌دهد.

پوشه‌های باز

پوشه‌های باز مشخص می‌کنند بازدیدکنندگان چه چیزی ببینند.

مثال:

/1/,/2/,/landscape/,/portrait/

بازدیدکنندگان سپس می‌توانند به این نشانی‌ها دسترسی داشته باشند:

https://your-domain.com/browse/1
https://your-domain.com/browse/2
https://your-domain.com/browse/landscape
https://your-domain.com/browse/portrait

زیرپوشه‌ها را نیز می‌توان باز کرد، مانند /2026/lucky/. دسترسی بازدیدکنندگان به پوشه‌هایی که باز نیستند مسدود می‌شود.

قابلیت‌های گالری عمومی

قابلیت	توضیح
مرور پوشه‌ها	مشاهده فایل‌ها و زیرپوشه‌ها در پوشه‌های باز.
جست‌وجو	جست‌وجو بر اساس نام فایل، شناسه فایل یا برچسب‌ها.
فیلتر نوع	فیلتر کردن تصاویر، ویدئوها، فایل‌های صوتی یا فایل‌های دیگر.
فیلتر برچسب	شامل کردن یا کنار گذاشتن برچسب‌های انتخاب‌شده.
فیلتر جهت	فیلتر کردن تصاویر افقی یا عمودی.
فیلتر زمان	فیلتر بر اساس بازه زمان بارگذاری.
فیلتر پسوند	فیلتر بر اساس پسوند فایل.
کپی پیوند	کپی کردن پیوندهای دسترسی فایل.
پیش‌نمایش رسانه	مشاهده یا پخش تصاویر، ویدئوها و فایل‌های صوتی در صفحه بازدیدکننده.

قوانین دسترسی گالری عمومی

گالری عمومی نیز از قوانین دسترسی عمومی پیروی می‌کند:

قانون	اثر
پوشه‌های باز	فقط پوشه‌های مجاز نمایش داده می‌شوند.
حالت دسترسی	محتوا بر اساس حالت دسترسی فعلیِ رده‌بندی سنی فیلتر می‌شود.
حالت فهرست مجاز	وقتی فعال باشد، فقط فایل‌های مجاز برای دسترسی عمومی نمایش داده می‌شوند.
فهرست مسدود	فایل‌های موجود در فهرست مسدود پنهان می‌شوند.