اگر چه جوملا ۲٫۵ از فایل‌های زبان در بخش مدیریت و سایت پشتیبانی می‌کند، اما هیچ راهی برای نصب فایل‌های زبان مربوط به الحاقات (کامپوننت، پلاگین ، ماژول) نیست مگر اینکه آنها توسط خود افزونه‌ها نصب شوند.
خوشبختانه ، از جوملا ۱٫۶ به بعد جوملا! برای نصب اینگونه فایل‌ها نیز قدرتمند ظاهر شد.
برای نمونه ما ساختار فایل XML و محتویات فایل زبان را برای نصب مورد بررسی قرار می‌دهیم.
همه فایل‌های زبان در بالای فهرست قرار دارند، اما این مثال نحوه تنظیم فایل‌ها در پوشه‌های زبان را برای استفاده در ‘=folder’ نشان می‌دهد که در فایل XML با برچسب <files> نمایان است.
نمونه پلاگین بسته زبان
فرض کنید شما پلاگین محتوا ‘ganymede’ را می‌خواهید برای ایجاد بسته زبان جدید برای زبان فارسی fa-IR آماده کنید. در اینجا فایل‌های بسته زبان را در پوشه ‘ganymede_fa_IR_language_pack’ نگه می‌دارد.
کدهای زیر را ببینید:
محل نصب فایل ‘ganymede_fa_IR_language_pack.xml’ کاملا مشخص است.
فایل‌های ویژه برای برچسب زبان
شما باید از روی فایل اصلی en-GB یک فایل زبان برای زبان مورد نظر ایجاد کنید. آنها در بخش مدیریت جوملا نصب خواهند شد و محتویات در صفحه نمایش با برچسب زبان مربوطه نمایش داده می‌شود.
فایل ‘en-GB.files_ganymede_en_GB_language_pack.sys.ini’ کلید راهنمای زبان انگلیسی خواهد بود.
فایل ‘fa-IR.files_ganymede_fa_IR_language_pack.sys.ini’ فقط شامل محتویات زبان فارسی خواهد بود.
توجه داشته باشید که نام کلید زبان باید با نام فایل ‘_files’ یکسان باشد.
همانطور که ‘FILES_GANYMEDE_FA_IR_LANGUAGE_PACK’ برای پرونده XML با نام ‘ganymede_fa_IR_language_pack.xml’ می‌باشد.
مثال فایل محتوای پلاگین
شرح فایل به صورت زیر است:
نکته ویژه:
این مثال شامل بروزرسانی فایل‌های زبان از طریق سرورها می‌شود که با یک کلیک امکان پذیر است و از طریق مدیریت افزونه‌ها قابل دسترسی می‌باشد.
چند یادداشت و هشدار:
پس از نصب ، بسته زبان در لیست مدیریت افزونه‌ها (نه مدیریت زبان‌ها) نمایش داده می‌شود.
در این روش نصب ، فایل‌های زبان پلاگین در داخل پوشه پلاگین قرار می‌گیرند. این رویکرد جدید برای قرار گرفتن فرمت فایل‌های زبان از جوملا ۱٫۶ بنا نهاده شد.
فایل زبان ‘fa-IR.files_ganymede_fa_IR_language_pack.sys.ini’ (همینطور فایل زبان انگلیسی آن) نیز در بالاترین سطح پوشه زبان (سایت) قرار می‌گیرد. آنها تنها برای نمایش نام این بسته زبان در مدیریت افزونه‌ها مورد نیاز است.
نسخه انگلیسی زبان بسته فایل باید گنجانده شود. حتی اگر زبان انگلیسی زبان دوم برای بسیاری از سایت‌ها باشد.
ایجاد بسته زبان برای چندین افزونه در یک فایل
این همان چیزی است که می‌تواند برای ایجاد یک زبان خاص برای چندین افزونه در یک بسته زبان مورد استفاده قرار گیرد. برای ایجاد بسته زبان مشابه بالا با اضافه کردن بخش <files> برای هر جزء شامل پلاگین ، کامپوننت و ماژول میسر است. مزیت آن اینست که نسخه‌های زبان خاص در مکان‌های خود بدرستی می‌توانند نصب شوند.
برای مثال قصد داریم برای پلاگین ‘ganymede’ و کامپوننت ‘jupiter’ بسته زبان ایجاد کنیم. ابتدا بسته زبان fa-IR را ایجاد کرده و مطابق زیر دستورات لازم را وارد نمایید:
محتویات فایل xml برای کامپوننت و پلاگین
محتویات فایل jupiter_fa_IR_language_pack.xml بشرح زیر می‌باشد:
نکته: توجه داشته باشید که ما برای فایل‌های زبان، بخش‌های مختلف <files> ایجاد کرده‌ایم، فایل‌های راهنمای مدیریت، فایل‌های زبان سایت، فایل‌های زبان پلاگین، و فایل‌های زبان برای خود بسته نیز ایجاد شده‌اند.
