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

دونوں خصوصیات یہاں ترتیب دی جاتی ہیں:

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 سادہ متنی 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، فائل ID، فائل نام، فائل قسم، ٹیگز، درجہ بندی اور متعلقہ میٹا ڈیٹا شامل ہیں۔

رسائی اصول

تصادفی تصویر 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/۔ جو ڈائریکٹریز کھلی نہیں، وہاں وزیٹرز بلاک ہوتے ہیں۔

عوامی گیلری خصوصیات

خصوصیت	وضاحت
ڈائریکٹریز براؤز کرنا	کھلی ڈائریکٹریز میں فائلیں اور ذیلی ڈائریکٹریز دیکھیں۔
تلاش	فائل نام، فائل ID یا ٹیگز سے تلاش کریں۔
قسم فلٹر	تصاویر، ویڈیوز، آڈیو یا دوسری فائلیں فلٹر کریں۔
ٹیگ فلٹر	منتخب ٹیگز شامل یا خارج کریں۔
سمت فلٹر	افقی یا عمودی تصاویر فلٹر کریں۔
وقت فلٹر	اپ لوڈ وقت کی حد سے فلٹر کریں۔
ایکسٹینشن فلٹر	فائل ایکسٹینشن سے فلٹر کریں۔
لنک کاپی	فائل رسائی لنکس کاپی کریں۔
میڈیا پیش منظر	وزیٹر صفحے پر تصاویر، ویڈیوز اور آڈیو دیکھیں یا چلائیں۔

عوامی گیلری رسائی اصول

عوامی گیلری بھی عوامی رسائی اصولوں کی پیروی کرتی ہے:

اصول	اثر
کھلی ڈائریکٹریز	صرف اجازت یافتہ ڈائریکٹریز دکھائی جاتی ہیں۔
رسائی موڈ	مواد موجودہ عمر درجہ بندی رسائی موڈ کے مطابق فلٹر ہوتا ہے۔
اجازت فہرست موڈ	فعال ہونے پر صرف عوامی رسائی کی اجازت والی فائلیں دکھائی جاتی ہیں۔
بلاک فہرست	بلاک فہرست والی فائلیں چھپی رہتی ہیں۔