کسٹمائز API آبجیکٹ پر مبنی ہے۔ کسٹمائزر آبجیکٹ کی چار اہم اقسام ہیں: پینلز، سیکشنز، سیٹنگز اور کنٹرولز۔سیٹنگز UI عناصر (کنٹرولز) کو ان سیٹنگز کے ساتھ منسلک کرتی ہیں جو ڈیٹا بیس میں محفوظ کی جاتی ہیں۔سیکشنز اپنی تنظیم کو بہتر بنانے کے لیے کنٹرولز کے لیے UI کنٹینرز ہیں۔پینل سیکشنز کے لیے کنٹینرز ہیں، جس سے متعدد سیکشنز کو ایک ساتھ گروپ کیا جا سکتا ہے۔ہر کسٹمائزر آبجیکٹ کو ظاہر کرنے کے لیے پی ایچ پی کلاس استعمال کی جاتی ہے، اور تمام آبجیکٹس کو کسٹمائز مینیجر آبجیکٹ WP_Customize_Manager کے ذریعے منظم کیا جاتا ہے۔
کسی بھی Customizer آبجیکٹ کو شامل کرنے، ہٹانے یا اس میں ترمیم کرنے کے لیے، اور Customizer مینیجر تک رسائی حاصل کرنے کے لیے، customize_register ہک کا استعمال کریں:
Customizer مینیجر ہر Customizer آبجیکٹ کی قسم کو شامل کرنے (add_)، حاصل کرنے(get_) اور ہٹانے(remove_ ) کے لیے طریقے فراہم کرتا ہے۔ہر ایک آئی ڈی کے ساتھ کام کرتا ہے۔get_ طریقے کنٹرول شامل کرتے وقت مخصوص پیرامیٹرز میں براہ راست ترمیم کرنے کی اجازت دیتے ہیں۔
ترتیبات Settings
سیٹنگزز آپ کے کسٹمائزر آبجیکٹ کا لائیو نظارہ(live-previewing)، محفوظگی(saving) اور صفائی(sanitization ) کو ہینڈل کرتی ہے۔ ہر سیٹنگز کو کنٹرول آبجیکٹ کے ذریعے منظم کیا جاتا ہے۔ نئی سیٹنگز شامل کرتے وقت کئی پیرامیٹرز دستیاب ہیں:
سیٹنگزکی دو بنیادی اقسام ہیں: آپشن(option)اور تھیم موڈ(theme_mod)۔آپشنزبراہ راست ورڈپریس ڈیٹا بیس کے wp_options ٹیبل میں محفوظ کیے جاتے ہیں اور فعال(active) تھیم سے قطع نظر سائٹ پر لاگو ہوتی ہیں۔
عام طور پر، تھیمز کو آپشن کی قسم کو سیٹنگز شامل کرنے سے گریز کرنا چاہیے، خاص طور پر اگر یہ سیٹنگز ضروری نہیں ہیں یا تھیم کی فعالیت یا ظاہری شکل کو نمایاں طور پر متاثر نہیں کرتی ہیں۔ اس کی وجہ یہ ہے کہ بہت زیادہ اختیارات شامل کرنے سے صارفین مغلوب ہو سکتے ہیں، جس سے ان کے لیے تھیم کو مؤثر طریقے سے اپنی مرضی کے مطابق بنانا مشکل ہو جاتا ہے۔اس کے برعکس، تھیم موڈز ایک خاص تھیم کے لیے مخصوص ہیں۔زیادہ تر تھیم کے اختیارات theme_mods ہونے چاہئیں۔
مثال کے طور پر، ایک کسٹم CSS پلگ ان کسٹم تھیم css سیٹنگ کو theme_mod کے طور پر رجسٹر کر سکتا ہے، جس سے ہر تھیم کو CSS قوانین کا ایک منفرد سیٹ رکھنے کی اجازت ملتی ہے۔ اگر آپ تھیمز کو تبدیل کرنے کے بعد واپس سوئچ کرتے ہیں تو CSS کے کھونے کا کوئی اندیشہ نہیں ہوتا ہے.
عام طور پر سیٹنگ کی ڈیفالٹ ویلیو کے ساتھ ساتھ اس کے سینیٹائزیشن کال بیک کو سیٹ کرنا سب سے اہم ہوتا ہے، جو اس بات کو یقینی بنائے گا کہ ڈیٹا بیس میں کوئی غیر محفوظ ڈیٹا محفوظ نہیں ہے۔ عام تھیم کا استعمال:
عام پلگ ان کا استعمال:
نوٹ کریں کہ کسٹمائزر آپشن ٹائپ کا استعمال کی مدد سے سیٹنگز کے لیے بطور کیڈ ایریز(keyed arrays) ذخیرہ کردہ آپشنزکو سنبھال سکتا ہے۔یہ متعدد سیٹنگزکو ایک ہی آپشن میں ذخیرہ کرنے کی اجازت دیتا ہے جو تھیم موڈ نہیں ہے۔اپنی کسٹمائزر آپشنز کی ویلیوز کو بازیافت کرنے اور استعمال کرنے کے لیے، سیٹنگ آئی ڈی(id) کے ساتھ ()get_theme_mod اور ()get_optionفنکشنز استعمال کریں:
نوٹ کریں کہ ()get_theme_mod اور ()get_option کے لیے دوسری دلیل ڈیفالٹ ویلیو ہے، جو سیٹنگ شامل کرتے وقت آپ کے سیٹ کردہ ڈیفالٹ سے مماثل ہونی چاہیے۔
