🎉 [ITD] MP3 Audio ایڈآن کی کامیاب ریلیز: ایک تفصیلی سفرنامہ

زینفورو کمیونٹی میں پاکستانی نمائندگی کا ایک اور سنہرا باب

---

📝 تمہیں

الحمدللہ! ہماری جانب سے تیار کردہ [ITD] MP3 Audio ایڈآن کو زینفورو کی آفیشل کمیونٹی پر کامیابی کے ساتھ ریلیز کر دیا گیا ہے۔ یہ ایڈآن XenForo 2.0، 2.1، 2.2 اور 2.3 — تمام اہم ورژنز پر مکمل طور پر کام کرتا ہے۔

اس مضمون میں ہم آپ کو اس پورے سفر کی تفصیل بتائیں گے — آئیڈیا سے لے کر ریلیز تک، چیلنجز سے لے کر ان کے حل تک۔ یہ کہانی صرف ایک ایڈآن کی نہیں، بلکہ لگن، مستقل مزاجی اور سیکھنے کی کہانی ہے۔

---

🎯 ایڈآن کا تصور اور مقصد

کیوں بنایا؟

ہمارے فورم ITDarasgah پر صارفین اکثر MP3 آڈیو فائلز شیئر کرتے ہیں۔ پہلے ہمیں یا تو:

• صرف لنکس شیئر کرنے پڑتے تھے
• یا third-party embed کوڈز استعمال کرنے پڑتے تھے
• جو ہمیشہ کام نہیں کرتے تھے

ہم چاہتے تھے کہ: ✅ صارفین آسانی سے [itdmp3]URL[/itdmp3] لکھ کر آڈیو ایمبیڈ کر سکیں

• کوئی external dependency نہ ہو
• موبائل اور ڈیسکٹاپ دونوں پر بہترین نظر آئے
• XenForo کے native features کا استعمال ہو

اسی ضرورت سے [ITD] MP3 Audio ایڈآن کی بنیاد پڑی۔

---

🛠️ تکنیکی تفصیلات

بنیادی فیچرز:

1. HTML5 Audio Player: جدید براؤزرز کے لیے native controls
2. Responsive Design: موبائل، ٹیبلیٹ، ڈیسکٹاپ — سب پر بہترین
3. Simple BB Code: [itdmp3]https://example.com/audio.mp3[/itdmp3]
4. Editor Toolbar Button: اختیاری، لیکن بہت مفید
5. Zero Dependencies: کوئی external JavaScript یا CSS libraries نہیں
6. Download Option: یوزرز آڈیو ڈاؤن لوڈ کر سکتے ہیں (اگر سرور اجازت دے)

کمپیٹیبلٹی:

XenForo ورژن	حالت
2.0.x	✅ مکمل سپورٹ
2.1.x	✅ مکمل سپورٹ
2.2.x	✅ مکمل سپورٹ
2.3.x	✅ مکمل سپورٹ

---

📅 ترقی کا سفر: مرحلہ بہ مرحلہ

مرحلہ 1: ابتدائی ڈویلپمنٹ (2020)

• BB Code کی بنیادی ساخت تیار کی
• HTML5 audio player کا implementation
• سادہ replacement HTML لکھا

چیلنج:
پہلے ورژن میں صرف XenForo 2.0 اور 2.1 کی سپورٹ تھی۔

---

مرحلہ 2: Editor Icon کا مسئلہ (2024-2025)

جب ہم نے XenForo 2.2 اور 2.3 پر ٹیسٹ کیا، تو ایک بڑا مسئلہ سامنے آیا:

مسئلہ:
ایڈیٹر ٹول بار میں آئیکن نظر نہیں آ رہا تھا۔

وجہ:
ہم نے editor_icon_value="f025" (Font Awesome hexadecimal code) استعمال کیا تھا، جو XenForo 2.2+ میں کام نہیں کرتا۔

حل:
XenForo کی documentation پڑھی اور معلوم ہوا کہ:

• XF 2.2+ میں Font Awesome icon names استعمال کرنے ہوتے ہیں
• جیسے: music, volume-up, headphones
• Hex codes (f025, f028) کام نہیں کرتے

اضافی چیلنج:
آئیکن BB Code میں تو شامل ہو گیا، لیکن toolbar میں نظر نہیں آ رہا تھا۔

حتمی حل:
دو مرحلے کی ضرورت تھی:

1. ACP → Content → BB Codes میں آئیکن سیٹ کریں
2. ACP → Content → BB Code Button Manager میں جا کر بٹن کو toolbar میں drag & drop کریں

---

مرحلہ 3: addon.json کی اپڈیٹ

پرانی addon.json فائل میں کئی تبدیلیاں کرنی پڑیں:

پرانا ورژن:{ "version_string": "2.0.0", "version_id": 2, "description": "Embed remotely hosted MP3 audio to your board" }

نیا ورژن:{

"version_string": "2.1.0",

"version_id": 2010075,

"description": "Embed remotely hosted MP3 audio files with a responsive HTML5 player. Compatible with XenForo 2.0, 2.1, 2.2, and 2.3.",

"require": {

"XenForo/XF": ">=2.0.0 <2.4.0"

}

}

اہم تبدیلیاں:

• Version ID کو YYMMDD فارمیٹ میں تبدیل کیا
• Description کو تفصیلی بنایا
• require فیلڈ شامل کی تاکہ صرف متعلقہ XF ورژنز پر انسٹال ہو
• تمام URLs کو .pk ڈومین پر اپڈیٹ کیا (itdarasgah.pk)

---

مرحلہ 4: برانڈنگ اور لوگو

ہم نے دو مختلف لوگو ڈیزائنز بنائے:

ڈیزائن 1:

• مرکزی میوزک آئیکن
• اوپر اور نیچے ITDarasgah اور Mian Shahid کے لوگوز
• جدید، network-style design

ڈیزائن 2:

• گولڈن فریم کے اندر میوزک آئیکن
• اوپر "Mian Shahid" کا نام
• نیچے ویب سائٹ کا URL

حتمی انتخاب:
ڈیزائن 2 کو منتخب کیا، لیکن فریم کو پتلا کیا تاکہ چھوٹے سائز (64px-96px) میں بھی آئیکن واضح رہے۔

---

مرحلہ 5: Testing Marathon

ہم نے تین مختلف ٹیسٹ بورڈز پر مکمل ٹیسٹنگ کی:

ٹیسٹ بورڈ	XenForo ورژن	PHP ورژن	نتیجہ
Test Board 1	2.1.12	7.4	✅ پاس
Test Board 2	2.2.14	8.0	✅ پاس
Test Board 3	2.3.0	8.1	✅ پاس

ٹیسٹنگ کا عمل:

1. ہر بورڈ پر نئے سرے سے انسٹال کیا
2. BB Code کے ذریعے مختلف MP3 فائلز ایمبیڈ کیں
3. Editor toolbar میں بٹن کی موجودگی چیک کی
4. Mobile devices پر responsive design ٹیسٹ کیا
5. Different browsers (Chrome, Firefox, Safari, Edge) پر چیک کیا

کوئی ایرر نہیں ملا! 🎉

---

مرحلہ 6: "جگاڑ" کا استعمال 😄

ایک دلچسپ واقعہ:
جب ہم اپ گریڈ کرنے لگے، تو XenForo نے ایرر دیا:

The following files are missing: src/addons/ITD/ITDMP3/ITDMP3.png

وجہ:

پرانی فائل کا نام ITDMP3.png تھا، نئی فائل کا نام ITDXF.png تھا۔ XenForo کے database میں پرانی فائل کا ریکارڈ موجود تھا۔

حل:
ہم نے ITDXF.png کی ایک کاپی بنا کر ITDMP3.png نام دے دی — بس XenForo کو مطمئن کرنے کے لیے! 😊

سبق:
کبھی کبھار "جگاڑ" بھی کام آتا ہے! لیکن یہ صرف temporary solution تھا۔

---

مرحلہ 7: Package تیاری

Installable ZIP بنانے کا عمل:

1. ACP → Add-ons → Export کا استعمال کیا
2. تمام options enable کیں:
   • Include data
   • Include assets
   • Include code
3. XenForo نے خودکار طور پر perfect ZIP فائل بنا دی

فائل کا نام:
ITD-MP3-Audio-2.1.0.zip

---

مرحلہ 8: XenForo Resource Manager پر ریلیز

تاریخ: 15-05-2026
Resource ID: #7634

Submission کا عمل:

1. Resource Details:
   • Title: [ITD] MP3 Audio
   • Tagline: Embed remotely hosted MP3 audio with responsive HTML5 player [XF 2.0-2.3]
   • Category: Add-ons [2.x]
   • Version: 2.1.0
2. Description:
   تفصیلی، step-by-step installation guide کے ساتھ
3. Screenshots:
   • Editor toolbar میں بٹن
   • Post میں audio player
   • Mobile view
4. License:
   Community-friendly custom license:
   • ✅ ذاتی اور تجارتی استعمال کی اجازت
   • ✅ Modification کی اجازت
   • ❌ Resale کی ممانعت
   • ❌ Credit ضروری نہیں لیکن appreciated
5. Submit for Review پر کلک کیا

اور پھر...
ریلیز ہو گیا! 🎊

---

🎓 اس سفر سے حاصل شدہ اسباق

1. Documentation کی اہمیت

• XenForo کی official documentation ہمیشہ first reference ہونی چاہیے
• Community forums سے بہت کچھ سیکھنے کو ملا

2. Testing کبھی کافی نہیں

• تین مختلف ورژنز پر ٹیسٹنگ نے بہت سے potential bugs کو روکا
• Real-world scenarios میں ٹیسٹ کرنا ضروری ہے

3. Version Control کا خیال

• version_id کو YYMMDD فارمیٹ میں رکھنا بہترین practice ہے
• ہر چھوٹی تبدیلی کا record رکھیں

4. Community First

• Simple, clear documentation لکھیں
• Support کے لیے ہمیشہ دستیاب رہیں
• Feedback کو positive طور پر لیں

5. برانڈنگ مستقل رکھیں

• ہر ایڈآن میں یکساں design language
• Professional appearance trust بڑھاتا ہے

---

🌟 کامیابی کے اعدادوشمار

ریلیز کے بعد کے پہلے 48 گھنٹے:

• 👀 Views: [235]
• ⬇️ Downloads: [15]
• ⭐ Ratings: [3]
• 💬 Comments: [5]

(یہ اعدادوشمار وقت کے ساتھ اپڈیٹ ہوتے رہیں گے)

---

🙏 شکریہ اور اعترافِ احسان

اس کامیابی میں کئی لوگوں کا تعاون شامل ہے:

1. XenForo Team
   ایسا بہترین forum software بنانے کے لیے
2. XenForo Community
   مسلسل مدد، رہنمائی اور constructive feedback کے لیے
3. ہمارے ITDarasgah فورم کے اراکین
   حوصلہ افزائی اور testing میں مدد کے لیے
4. Alkamunia بلاگ کے قارئین
   آپ کی دعاؤں اور سپورٹ کے بغیر یہ ممکن نہ تھا
5. اللہ تعالیٰ
   جس نے توفیق، صبر اور کامیابی عطا فرمائی

---

🚀 مستقبل کے منصوبے

مختصر المدتی (3-6 ماہ):

1. v2.1.1 - Bug Fixes
   User feedback کی بنیاد پر improvements
2. v2.2.0 - New Features
   • OGG/WAV format support
   • Playlist functionality
   • Custom player themes
3. Documentation Videos
   Urdu/Hindi میں tutorial videos

طویل المدتی (6-12 ماہ):

1. نئے ایڈآنز:
   • Video embed add-on
   • Advanced media gallery
   • SEO optimization tools
2. Premium Resources:
   کچھ advanced features کے ساتھ paid versions
3. Training Program:
   XenForo add-on development کا مکمل کورس

---

💡 دوسرے ڈویلپرز کے لیے مشورے

اگر آپ بھی XenForo کے لیے add-on بنانا چاہتے ہیں، تو یہ مشورے کارآمد ہوں گے:

1. چھوٹی شروعات کریں

• پہلا add-on بہت simple رکھیں
• Complex features بعد میں add کریں

2. Test, Test, Test!

• کم از کم 2-3 different XF versions پر ٹیسٹ کریں
• Clean installation پر test کریں
• Mobile devices پر ضرور چیک کریں

3. Documentation کو نظرانداز نہ کریں

• Clear, step-by-step guide لکھیں
• Screenshots شامل کریں
• FAQ section بنائیں

4. Community سے جڑیں

• XenForo forums پر active رہیں
• دوسروں کے سوالات کے جواب دیں
• Feedback کو dil se لیں

5. صبر اور مستقل مزاجی

• پہلا دن ہی ہزاروں downloads کا انتظار نہ کریں
• Quality پر focus کریں، quantity پر نہیں
• Regular updates جاری رکھیں

---

📞 رابطہ اور سپورٹ

اگر آپ کو اس ایڈآن کے بارے میں کوئی سوال ہے، یا XenForo development میں مدد چاہیے، تو ہم سے رابطہ کریں:

ITDarasgah فورم:
https://itdarasgah.pk/forums/238/

Email:
mmshahid73@gmail.com

XenForo Resource Page:
https://xenforo.com/community/resources/itd-mp3.7634/

---

🎯 اختتامیہ

یہ سفر آسان نہیں تھا، لیکن انتہائی تعلیمی اور rewarding تھا۔ ہر چیلنج نے کچھ نیا سکھایا، ہر مسئلے نے problem-solving skills کو بہتر بنایا۔

ہمारा مقصد صرف ایک ایڈآن بنانا نہیں تھا، بلکہ:

• Quality کا معیار قائم کرنا تھا
• Community کی خدمت کرنا تھی
• Knowledge کو share کرنا تھا
• Inspiration بننا تھا

ہمیں یقین ہے کہ [ITD] MP3 Audio ایڈآن XenForo community کے لیے مفید ثابت ہوگا، اور یہ صرف ہمارے first step ہے — آنے والے وقت میں بہت کچھ لے کر حاضر ہوں گے۔

آپ کی دعاؤں، سپورٹ اور حوصلہ افزائی کا ہمیشہ شکریہ! 🙏

---

📌 فنی معلومات برائے ڈویلپرز

Technical Stack:

• XenForo: 2.0 - 2.3
• PHP: 7.4+
• MySQL: 5.5+
• HTML5 Audio API
• Font Awesome 5/6
• Vanilla JavaScript (no jQuery dependencies)

File Structure:

src/addons/ITD/ITDMP3/ ├── addon.json ├── ITDXF.png ├── bb_codes/ │ └── itdmp3.php ├── phrases/ │ └── itd_mp3_phrases.php └── templates/ └── itd_mp3_player.html

1
2
3
4
5
6
7
8
9

Key Code Snippet:

// BB Code Replacement 'replace_html' => '<div align="center"> <audio controls> <source src="{text}" type="audio/mpeg"> Your browser does not support the audio element. </audio> </div>'

php
1
2
3
4
5
6
7

---

تحریر:
میاں محمد شاہد
Team Leader ITDarasgah & Fouder Alkamunia
XenForo Developer

تاریخ اشاعت:16-05-2026