بعدی »

[امیر حسین آستانه ها]

ارسال شده توسط : سهيل نوين‌فرد

وقتی ما شروع به ساختن یک کامپوننت جدید می‌کنیم، ضروری است که یک جعبه شنی داشته باشیم.  ما باید بیشتر از یک سیستم داشته باشیم تا بتوانیم کامپوننت‌های خود را در آن تست کنیم. به این سیستم دوم که برای تست کردن کامپوننت‌ها به کار می‌رود، جعبه شنی گفته می‌شود.

سریع‌ ترین و راحت‌ترین راه برای تنظیم کردن جعبه شنی یک کامپوننت، ایجاد کردن پوشه‌های کامپوننت در دو بخش کاربری و مدیریت می‌باشد.
 تا هنگامی که جدول‌های کامپوننت (#__components table) مورد ویرایش قرار نگیرند، این تکنیک چند اشکال مهم دارد که از تست کردن جنبه‌های مختلف کد‌های ما جلوگیری خواهد کرد.

راه بهتر ایجاد یک نصب‌کننده اصلی و پایه‌ای برای کامپوننت است تا یک کامپوننت خالی را در اختیار ما قرار دهد. فایل XML نشان داده شده در زیر می‌تواند یک کامپوننت خالی به نام 'New Extension' را برای ما ایجاد کند:

کد:

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE install SYSTEM "http://dev.joomla.org/xml/1.5/component-install.dtd">
<install type="component" version="1.5">
<name>New Extension</name>
<creationDate>MonthName Year</creationDate>
<author>Author's Name</author>
<authorEmail>Author's Email</authorEmail>
<authorUrl>Author's Website</authorUrl>
<copyright>Copyright Notice</copyright>
<license>Component License Agreement</license>
<version>Component Version</version>
<description>Component Description</description>
<administration>
<menu>New Extension</menu>
</administration>
<install />
<uninstall />

</install>

برای استفاده از این کدها، یک فایل XML جدید را ایجاد کنید، سپس با استفاده از رمز کد (اینکود)  UFT-8 کدها را در آن ذخیره کنید.

برای این که کامپوننت شما مناسب و صحیح باشد، باید از نسخه به روز XML استفاده کنید. من نقش فایل XML را به طور دقیق در انتهای مباحث توضیح خواهم داد.

نام کامپوننت تنها شناساگر کامپوننت شماست. وقتی شما نامی برای کامپوننت خود انتخاب می‌کنید، بهتر است مطمئن شوید که این نام قبلا توسط کامپوننت دیگری استفاده نشده است. همچنین این نام در فرم com_parsedname استفاده خواهد شد؛ این کار به صورت خودکار توسط جوملا انجام می‌گیرد. برای مثال، نام 'New Extension' در فرمت com_newextension در همه‌جا مورد استفاده قرار خواهد گرفت.

اولین بار که فایل XML خود را ساختید، این فایل را در یک فرمت آرشیو قرار دهید. این فرمت می‌تواند GZ, TGZ, GZIP, BZ2, TBZ2, TAR, ZIP  یا  BZIP2باشد.  حالا شما می‌تونید با نصب این فایل آرشیو در قسمت نصب/حذف جوملا کار خود را برای گسترش این کامپوننت خالی آغاز کنید.


برای شروع کار، بخش کاربری کامپوننت در پوشه components/com_newextension در مسیر اصلی جوملای شما قرار دارد. در این پوشه، شما به ایجاد فایل اصلی بخش کاربری کامپوننت به نام newextension.php نیاز دارید، هنگامی که در بخش کاربری کامپوننت را فراخوانی می‌کنید، از این فایل اجرا می‌شود.

بخش مدیریت کامپوننت در پوشه administrator/components/com_newextension در مسیر اصلی جوملای شما واقع شده است. در این پوشه شما به ایجاد فایل اصلی بخش مدیریت کامپوننت که admin.newextension.php نام دارد، احتیاج دارید. هنگامی که در بخش مدیریت از کامپوننت استفاده می‌کنید، این فایل به اجرا درمی‌آید.

وقتی برای اولین بار فایل‌ها را ایجاد کردید، در بخش کاربری، منوی کامپوننت خود را به یکی از لیست‌های منو اضافه کنید تا به این وسیله در بخش کاربری به آن دسترسی داشته باشید. برای دسترسی به کامپوننت در بخش مدیریت نیز، لینک کامپوننت در منوی کامپوننت‌ها از قبل موجود است.

 نويسنده: سهيل نوين‌فرد

گروه نرم‌افزاري نوين‌فرد

www.novinfard.com