نسخهٔ کنونی تا ‏۱۸ مارس ۲۰۱۳، ساعت ۰۹:۰۲

مقدمه

در این مقاله آموزش کامپوننت نویسی جوملا خواهید آموخت که چگونه یک model را به کامپوننت مورد استفاده در سایت تان اضافه کنید. در فریم ورک جوملا 2.5 model مسئولیت مدیریت داده‌ها را به عهده دارد. اولین تابعی که برای مدل باید نوشته شود تابع ()get است کار تابع ()get بازگرداندن داده‌ها به فراخوانی کننده آن تابع است. اگر آموزش‌های افزونه نویسی برای جوملا را دنبال کرده باشید حتما می‌دانید که ما برای view از نام HelloViewHello استفاده کردیم، به صورت پیش فرض نام Model همانند View از این قانون پیروی می‌کند و ما نام model مان را HelloModelHello می‌گذاریم.

در پوشه site\models\hello.php فایل hello.php باید شامل کدهای زیر باشد:

<source lang="php" > <?php // No direct access to this file defined('_JEXEC') or die('Restricted access'); // import Joomla modelitem library jimport('joomla.application.component.modelitem'); class HelloModelHello extends JModelItem { protected $msg; public function getMsg() { if(!isset($this->msg)) { $this->msg = 'Hello World Model'; } return $this->msg; } } ?> </source>

سپس HelloViewHello برای استفاده از داده‌های متد get کلاس JView مدل را صدا میزند.

در این مرحله باید کلاس HelloViewHello را در فایل site\views\hello\view.html.php به صورت زیر ویرایش کنیم.

<source lang="php" > <?php //No direct access to this file should be called by Joomla defined('_JEXEC') or die('Restricted Access'); //import joomla controller library jimport('joomla.application.component.view'); class HelloViewHello extends JView { //Overrite JView display method function display($tpl = null) { //Assign data to the view $this->msg = $this->get('Msg'); // Check for errors if(count($errors = $this->get('Errors'))) { JError::raiseError(500,implode('
',$errors)); return false; } //Display the View parent::display($tpl); } } ?> </source>

حال باید فایل helloworld.xml را به گونه ویرایش کنید که شامل قسمت‌های اضافه شده برای بخش مدل نیز باشد.

<source lang="xml" > <?xml version="1.0" encoding="utf-8" ?> <install type="component" version="2.5"> <name>hello</name>

 <creationDate>2013-03-12</creationDate> 
 <author>Shahab Matapour</author> 
 <authorEmail>[email protected]</authorEmail> 
 <authorUrl>http://www.joomlafarsi.com</authorUrl> 
 <copyright>Copyright Info</copyright> 
 <license>License Info</license> 
 <version>1.02</version> 

<description>اضافه کردن مدل به کامپوننت</description> <files folder="site"> <filename>index.html</filename> <filename>hello.php</filename> <filename>controller.php</filename> <folder>views</folder> <folder>models</folder> </files> <administration> <files folder="admin"> <filename>index.html</filename> <filename>hello.php</filename> </files> </administration> </install> </source>

برای ایجاد بسته نصبی از افزونه‌های جوملا از فرمت ZIP استفاده می‌کنیم. جهت ایجاد بسته نصبی از کامپوننت مان باید فایل‌ها زیر را در یک فولدر خارج از جوملا آماده کنیم.

فایل helloworld.xml همانطور که قبلا به آن اشاره کردیم باید شامل کدهای زیر باشد:

<source lang="xml" > <?xml version="1.0" encoding="utf-8"?> <install type="component" version="2.5"> <name>hello</name>

<creationDate>2013-03-12</creationDate> 
<author>Shahab Matapour</author> 
<authorEmail>[email protected]</authorEmail> 
<authorUrl>http://www.joomlafarsi.com</authorUrl> 
<copyright>Copyright Info</copyright> 
<license>License Info</license> 
<version>1.02</version

<description>اضافه کردن مدل به کامپوننت</description> <files folder="site"> <filename>index.html</filename> <filename>hello.php</filename> <filename>controller.php</filename> <folder>views</folder> <folder>models</folder> </files> <administration> <files folder="admin"> <filename>index.html</filename> <filename>hello.php</filename> </files> </administration> </install> </source>

فایل site\hello.php باید شامل کدهای زیر باشد:

<source lang="php" > <?php //No direct access to the file defined('_JEXEC') or die('Restricted Access not allowed'); //import joomla controller library jimport('joomla.application.component.controller'); //get an instance of the controller prefixed by HelloWorld $controller = JController::getInstance('Hello'); //perform the request task $controller->execute(JRequest::getCmd('task')); //Redirect if set by controller $controller->redirect(); ?> </source>

فایل admin\hello.php باید شامل کدهای زیر باشد:

سپس به یک فایل index.html نیاز داریم که در تمامی فولدرهای کامپوننت قرار گیرد.

<source lang="php" > <html><body bgcolor="#FFFFFF"></body></html> </source> فایل site\controller.php باید شامل کدهای زیر باشد <source lang="php" > <?php //No direct access to this file should be called by Joomla defined('_JEXEC') or die('Restricted Access'); //import joomla controller library jimport('joomla.application.component.controller'); class HelloController extends JController { } ?> </source>

فایل site\views\hello\view.html.php باید شامل کدهای زیر باشد:

<source lang="php" > <?php //No direct access to this file should be called by Joomla defined('_JEXEC') or die('Restricted Access'); //import joomla controller library jimport('joomla.application.component.view'); class HelloViewHello extends JView { //Overrite JView display method function display($tpl = null) { //Assign data to the view $this->msg = $this->get('Msg'); // Check for errors if(count($errors = $this->get('Errors'))) { JError::raiseError(500,implode('
',$errors)); return false; } //Display the View parent::display($tpl); } } ?> </source>

فایل site\views\hello\tmpl\default.php باید شامل کدهای زیر باشد:

<source lang="php" > <?php //No direct access to this file should be called by Joomla defined('_JEXEC') or die('Restricted Access'); ?>

<?php echo $this->msg; ?>

</source>

و همچنین اگر تمایل دارید یک نوع منو در مدیریت منو از نوع کامپوننت شما ایجاد شود باید فایل site\views\hello\tmpl\default.xml شامل کدهای زیر باشد:

<source lang="xml" > <?xml version="1.0" encoding="utf-8"?> <metadata> <layout title="New Hello Menu Item"> <message>New Hello Menu Item Desc</message> </layout> </metadata> </source>

و در نهایت فایل site\models\hello.php باید شامل کدهای زیر باشد:

<source lang="php" > <?php // No direct access to this file defined('_JEXEC') or die('Restricted access'); // import Joomla modelitem library jimport('joomla.application.component.modelitem'); class HelloModelHello extends JModelItem { protected $msg; public function getMsg() { if(!isset($this->msg)) { $this->msg = 'Hello World Model'; } return $this->msg; } } ?> </source>

ایجاد فایل helloworld.zip با فایل‌ها و فولدرهایی که در قسمت‌های قبل ایجاد کردیم.

نصب فایل zip شده توسط قسمت مدیریت افزونه‌های جوملا 2.5

نکته : توجه داشته باشید اگر در مراحل قبل کامپوننت را در میان سورس جوملا ساخته و اجرا کرده‌اید قبل نصب فایل zip کامپوننت باید فایل‌های مربوط به افزونه این آموزش را از جوملا پاک کنید و بعد اقدام به نصب فایل zip پکیج شده بکنید.

شما می‌توانید کارکرد این افزونه را با وارد کردن http://localhost/sitename/index.php?option=com_hello در مرورگر چک کنید. اگر عبارت بالا را در آدرس بار مرورگر وارد کنیم باید نتیجه‌ای همانند شکل زیر دریافت کنیم.

جمع آوری شده توسط :شهاب مطاع پور

گروه آموزش - تیم جوملا فارسی

استفاده از مطالب دانشنامه جوملا فارسی - مامبو فارسی با ذکر منبع ( دانشنامه جوملا فارسی ) و لینک مستقیم به http://docs.joomlafarsi.com بلامانع است.