ساختار استاندارد ماژول جوملا (مثلاً mod_helloworld):

mod_helloworld/
├── mod_helloworld.php (entry point - نقطه ورود)
├── mod_helloworld.xml (manifest - تعریف ماژول و پارامترها)
├── helper.php (کلاس Helper برای منطق)
└── tmpl/
└── default.php (layout - نمایش در فرانت)

فایل mod_helloworld.php:
• بارگذاری helper
• دریافت پارامترها از params
• فراخوانی Helper::getData()
• include layout

فایل mod_helloworld.xml:
• نام، نسخه، توضیحات
• لیست فایل‌ها
• پارامترها (params) برای تنظیمات ماژول

در helper.php کلاس ModHelloworldHelper تعریف می‌کنید:

تابع getData(params):
• پارامترها از تب Options ماژول
• دریافت داده از دیتابیس: استفاده از Factory و DatabaseInterface
• یا از API خارجی
• return آرایه یا آبجکت

در mod_helloworld.php:
data را از Helper::getData(params) بگیرید و layout را include کنید.

استفاده از دیتابیس:
از Factory::getContainer()->get(DatabaseInterface::class) برای اتصال به دیتابیس استفاده کنید. query را با getQuery(true) بسازید.

در tmpl/default.php:

متغیرهای در دسترس:
• params: پارامترهای ماژول
• data یا متغیرهای پاس‌داده‌شده از mod_نام.php

نمایش:
foreach روی data و نمایش هر item با htmlspecialchars برای جلوگیری از XSS

خروجی با echo یا HTML مستقیم. از htmlspecialchars برای جلوگیری از XSS استفاده کنید.

نصب: فایل‌ها را ZIP کنید و از System → Install آپلود کنید. یا پوشه را در /modules قرار دهید.