Difference between revisions of "Developing an MVC Component/Adding backend actions"
From Joomla! Documentation
< J3.x:Developing an MVC Component
Vibhavsinha (talk | contribs) m (→Packaging the component: Added missing links to package files list) |
m (en-GB) |
||
(28 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
− | {{:J3.1:Developing | + | <noinclude><languages /></noinclude> |
+ | {{:J3.1:Developing an MVC Component/<translate><!--T:1--> | ||
+ | en</translate>}} | ||
+ | <translate>== Introduction == <!--T:2--></translate> | ||
+ | <translate><!--T:3--> | ||
+ | This tutorial is part of the [[S:MyLanguage/J3.2:Developing an MVC Component | Developing an MVC Component for Joomla! 3.2]] tutorial. You are encouraged to read the previous parts of the tutorial before reading this.</translate> | ||
− | + | <translate>== Adding a toolbar == <!--T:4--></translate> | |
+ | <translate><!--T:5--> | ||
+ | In Joomla, the administrator interacts generally with components through the use of a toolbar. In the file <tt>admin/views/helloworlds/view.html.php</tt> put this content. It will create a basic toolbar and a title for the component.</translate> | ||
− | + | <translate><!--T:6--> | |
− | + | The arguments used in, for example, JToolBarHelper::addNew is used to set a controller instance which will be used after button is clicked. Further details below in the [[#Adding_specific_controllers | adding specific controllers]] section.</translate> | |
− | |||
− | |||
− | |||
− | |||
− | The arguments used in, for example, JToolBarHelper::addNew is used to set a controller instance which will be used after button is clicked. Further details below in the [[#Adding_specific_controllers | adding specific controllers]] section. | ||
<span id ="admin/views/helloworlds/view.html.php"> | <span id ="admin/views/helloworlds/view.html.php"> | ||
− | + | <tt>admin/views/helloworlds/view.html.php</tt> | |
− | <source lang="php"> | + | <source lang="php" highlight="41,42,55-61"> |
<?php | <?php | ||
+ | /** | ||
+ | * @package Joomla.Administrator | ||
+ | * @subpackage com_helloworld | ||
+ | * | ||
+ | * @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved. | ||
+ | * @license GNU General Public License version 2 or later; see LICENSE.txt | ||
+ | */ | ||
+ | |||
// No direct access to this file | // No direct access to this file | ||
defined('_JEXEC') or die('Restricted access'); | defined('_JEXEC') or die('Restricted access'); | ||
− | |||
− | |||
− | |||
/** | /** | ||
* HelloWorlds View | * HelloWorlds View | ||
+ | * | ||
+ | * @since 0.0.1 | ||
*/ | */ | ||
class HelloWorldViewHelloWorlds extends JViewLegacy | class HelloWorldViewHelloWorlds extends JViewLegacy | ||
{ | { | ||
/** | /** | ||
− | * | + | * Display the Hello World view |
+ | * | ||
* @param string $tpl The name of the template file to parse; automatically searches through the template paths. | * @param string $tpl The name of the template file to parse; automatically searches through the template paths. | ||
* | * | ||
− | * @return | + | * @return void |
*/ | */ | ||
− | function display($tpl = null) | + | function display($tpl = null) |
{ | { | ||
// Get data from the model | // Get data from the model | ||
− | $items = $this->get('Items'); | + | $this->items = $this->get('Items'); |
− | $pagination = $this->get('Pagination'); | + | $this->pagination = $this->get('Pagination'); |
// Check for errors. | // Check for errors. | ||
− | if (count($errors = $this->get('Errors'))) | + | if (count($errors = $this->get('Errors'))) |
{ | { | ||
JError::raiseError(500, implode('<br />', $errors)); | JError::raiseError(500, implode('<br />', $errors)); | ||
+ | |||
return false; | return false; | ||
} | } | ||
− | |||
− | |||
− | |||
// Set the toolbar | // Set the toolbar | ||
Line 56: | Line 64: | ||
/** | /** | ||
− | * | + | * Add the page title and toolbar. |
+ | * | ||
+ | * @return void | ||
+ | * | ||
+ | * @since 1.6 | ||
*/ | */ | ||
− | protected function addToolBar() | + | protected function addToolBar() |
{ | { | ||
JToolBarHelper::title(JText::_('COM_HELLOWORLD_MANAGER_HELLOWORLDS')); | JToolBarHelper::title(JText::_('COM_HELLOWORLD_MANAGER_HELLOWORLDS')); | ||
+ | JToolBarHelper::addNew('helloworld.add'); | ||
+ | JToolBarHelper::editList('helloworld.edit'); | ||
JToolBarHelper::deleteList('', 'helloworlds.delete'); | JToolBarHelper::deleteList('', 'helloworlds.delete'); | ||
− | |||
− | |||
} | } | ||
} | } | ||
Line 69: | Line 81: | ||
</span> | </span> | ||
− | You can find other classic backend actions in the | + | <translate><!--T:7--> |
+ | You can find other classic backend actions in the <tt>administrator/includes/toolbar.php</tt> file of your Joomla installation.</translate> | ||
− | Since the view can perform some actions, we have to add some input data. With your | + | <translate><!--T:8--> |
+ | Since the view can perform some actions, we have to add some input data. With your favourite file manager and editor, put in the file <tt>admin/views/helloworlds/tmpl/default.php</tt></translate> | ||
<span id="admin/views/helloworlds/tmpl/default.php"> | <span id="admin/views/helloworlds/tmpl/default.php"> | ||
− | + | <tt>admin/views/helloworlds/tmpl/default.php</tt> | |
− | <source lang="php"> | + | <source lang="php" highlight="42,50,65,66,67"> |
<?php | <?php | ||
+ | /** | ||
+ | * @package Joomla.Administrator | ||
+ | * @subpackage com_helloworld | ||
+ | * | ||
+ | * @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved. | ||
+ | * @license GNU General Public License version 2 or later; see LICENSE.txt | ||
+ | */ | ||
+ | |||
// No direct access to this file | // No direct access to this file | ||
defined('_JEXEC') or die('Restricted Access'); | defined('_JEXEC') or die('Restricted Access'); | ||
− | |||
− | |||
?> | ?> | ||
− | <form action=" | + | <form action="index.php?option=com_helloworld&view=helloworlds" method="post" id="adminForm" name="adminForm"> |
− | <table class=" | + | <table class="table table-striped table-hover"> |
− | <thead><?php echo | + | <thead> |
− | <tfoot><?php echo $this-> | + | <tr> |
− | <tbody><?php echo $this-> | + | <th width="1%"><?php echo JText::_('COM_HELLOWORLD_NUM'); ?></th> |
+ | <th width="2%"> | ||
+ | <?php echo JHtml::_('grid.checkall'); ?> | ||
+ | </th> | ||
+ | <th width="90%"> | ||
+ | <?php echo JText::_('COM_HELLOWORLD_HELLOWORLDS_NAME') ;?> | ||
+ | </th> | ||
+ | <th width="5%"> | ||
+ | <?php echo JText::_('COM_HELLOWORLD_PUBLISHED'); ?> | ||
+ | </th> | ||
+ | <th width="2%"> | ||
+ | <?php echo JText::_('COM_HELLOWORLD_ID'); ?> | ||
+ | </th> | ||
+ | </tr> | ||
+ | </thead> | ||
+ | <tfoot> | ||
+ | <tr> | ||
+ | <td colspan="5"> | ||
+ | <?php echo $this->pagination->getListFooter(); ?> | ||
+ | </td> | ||
+ | </tr> | ||
+ | </tfoot> | ||
+ | <tbody> | ||
+ | <?php if (!empty($this->items)) : ?> | ||
+ | <?php foreach ($this->items as $i => $row) : | ||
+ | $link = JRoute::_('index.php?option=com_helloworld&task=helloworld.edit&id=' . $row->id); | ||
+ | ?> | ||
+ | <tr> | ||
+ | <td><?php echo $this->pagination->getRowOffset($i); ?></td> | ||
+ | <td> | ||
+ | <?php echo JHtml::_('grid.id', $i, $row->id); ?> | ||
+ | </td> | ||
+ | <td> | ||
+ | <a href="<?php echo $link; ?>" title="<?php echo JText::_('COM_HELLOWORLD_EDIT_HELLOWORLD'); ?>"> | ||
+ | <?php echo $row->greeting; ?> | ||
+ | </a> | ||
+ | </td> | ||
+ | <td align="center"> | ||
+ | <?php echo JHtml::_('jgrid.published', $row->published, $i, 'helloworlds.', true, 'cb'); ?> | ||
+ | </td> | ||
+ | <td align="center"> | ||
+ | <?php echo $row->id; ?> | ||
+ | </td> | ||
+ | </tr> | ||
+ | <?php endforeach; ?> | ||
+ | <?php endif; ?> | ||
+ | </tbody> | ||
</table> | </table> | ||
− | + | <input type="hidden" name="task" value=""/> | |
− | + | <input type="hidden" name="boxchecked" value="0"/> | |
− | + | <?php echo JHtml::_('form.token'); ?> | |
− | |||
− | |||
</form> | </form> | ||
+ | |||
</source> | </source> | ||
</span> | </span> | ||
− | == Adding specific controllers == | + | <translate>== Adding specific controllers == <!--T:9--></translate> |
− | Three actions have been added: | + | <translate><!--T:10--> |
+ | Three actions have been added:</translate> | ||
* ''helloworlds.delete'' | * ''helloworlds.delete'' | ||
* ''helloworld.edit'' | * ''helloworld.edit'' | ||
* ''helloworld.add'' | * ''helloworld.add'' | ||
− | |||
− | These are compound tasks (''controller''.''task''). So two new controllers | + | <translate><!--T:11--> |
+ | These are compound tasks (''controller''.''task''). So two new controllers <tt>HelloWorldControllerHelloWorlds</tt> and <tt>HelloWorldControllerHelloWorld</tt> have to be coded. (To understand the difference between the two types of subcontrollers read more in this article: [[S:MyLanguage/JController_and_its_subclass_usage_overview|subcontrollers...]]).</translate> | ||
<span id="admin/controllers/helloworlds.php"> | <span id="admin/controllers/helloworlds.php"> | ||
− | + | <tt>admin/controllers/helloworlds.php</tt> | |
<source lang="php"> | <source lang="php"> | ||
<?php | <?php | ||
+ | /** | ||
+ | * @package Joomla.Administrator | ||
+ | * @subpackage com_helloworld | ||
+ | * | ||
+ | * @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved. | ||
+ | * @license GNU General Public License version 2 or later; see LICENSE.txt | ||
+ | */ | ||
// No direct access to this file | // No direct access to this file | ||
defined('_JEXEC') or die('Restricted access'); | defined('_JEXEC') or die('Restricted access'); | ||
− | |||
− | |||
− | |||
/** | /** | ||
* HelloWorlds Controller | * HelloWorlds Controller | ||
+ | * | ||
+ | * @since 0.0.1 | ||
*/ | */ | ||
class HelloWorldControllerHelloWorlds extends JControllerAdmin | class HelloWorldControllerHelloWorlds extends JControllerAdmin | ||
Line 123: | Line 195: | ||
/** | /** | ||
* Proxy for getModel. | * Proxy for getModel. | ||
− | * @since | + | * |
+ | * @param string $name The model name. Optional. | ||
+ | * @param string $prefix The class prefix. Optional. | ||
+ | * @param array $config Configuration array for model. Optional. | ||
+ | * | ||
+ | * @return object The model. | ||
+ | * | ||
+ | * @since 1.6 | ||
*/ | */ | ||
− | public function getModel($name = 'HelloWorld', $prefix = 'HelloWorldModel') | + | public function getModel($name = 'HelloWorld', $prefix = 'HelloWorldModel', $config = array('ignore_request' => true)) |
{ | { | ||
− | $model = parent::getModel($name, $prefix, | + | $model = parent::getModel($name, $prefix, $config); |
+ | |||
return $model; | return $model; | ||
} | } | ||
} | } | ||
+ | |||
</source> | </source> | ||
</span> | </span> | ||
<span id="admin/controllers/helloworld.php"> | <span id="admin/controllers/helloworld.php"> | ||
− | + | <tt>admin/controllers/helloworld.php</tt> | |
<source lang="php"> | <source lang="php"> | ||
<?php | <?php | ||
+ | /** | ||
+ | * @package Joomla.Administrator | ||
+ | * @subpackage com_helloworld | ||
+ | * | ||
+ | * @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved. | ||
+ | * @license GNU General Public License version 2 or later; see LICENSE.txt | ||
+ | */ | ||
// No direct access to this file | // No direct access to this file | ||
defined('_JEXEC') or die('Restricted access'); | defined('_JEXEC') or die('Restricted access'); | ||
− | |||
− | |||
− | |||
/** | /** | ||
* HelloWorld Controller | * HelloWorld Controller | ||
+ | * | ||
+ | * @package Joomla.Administrator | ||
+ | * @subpackage com_helloworld | ||
+ | * @since 0.0.9 | ||
*/ | */ | ||
class HelloWorldControllerHelloWorld extends JControllerForm | class HelloWorldControllerHelloWorld extends JControllerForm | ||
{ | { | ||
} | } | ||
+ | |||
</source> | </source> | ||
</span> | </span> | ||
− | == Adding an editing view == | + | <translate>== Adding an editing view == <!--T:12--></translate> |
− | With your | + | <translate><!--T:13--> |
+ | With your favourite file manager and editor, put a file <tt>admin/views/helloworld/view.html.php</tt> containing:</translate> | ||
<span id="admin/views/helloworld/view.html.php"> | <span id="admin/views/helloworld/view.html.php"> | ||
− | + | <tt>admin/views/helloworld/view.html.php</tt> | |
<source lang="php"> | <source lang="php"> | ||
<?php | <?php | ||
+ | /** | ||
+ | * @package Joomla.Administrator | ||
+ | * @subpackage com_helloworld | ||
+ | * | ||
+ | * @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved. | ||
+ | * @license GNU General Public License version 2 or later; see LICENSE.txt | ||
+ | */ | ||
+ | |||
// No direct access to this file | // No direct access to this file | ||
defined('_JEXEC') or die('Restricted access'); | defined('_JEXEC') or die('Restricted access'); | ||
− | |||
− | |||
− | |||
/** | /** | ||
* HelloWorld View | * HelloWorld View | ||
+ | * | ||
+ | * @since 0.0.1 | ||
*/ | */ | ||
class HelloWorldViewHelloWorld extends JViewLegacy | class HelloWorldViewHelloWorld extends JViewLegacy | ||
{ | { | ||
/** | /** | ||
− | * | + | * View form |
− | * @ | + | * |
+ | * @var form | ||
*/ | */ | ||
− | public function display($tpl = null) | + | protected $form = null; |
+ | |||
+ | /** | ||
+ | * Display the Hello World view | ||
+ | * | ||
+ | * @param string $tpl The name of the template file to parse; automatically searches through the template paths. | ||
+ | * | ||
+ | * @return void | ||
+ | */ | ||
+ | public function display($tpl = null) | ||
{ | { | ||
− | // | + | // Get the Data |
− | $form = $this->get('Form'); | + | $this->form = $this->get('Form'); |
− | $item = $this->get('Item'); | + | $this->item = $this->get('Item'); |
// Check for errors. | // Check for errors. | ||
− | if (count($errors = $this->get('Errors'))) | + | if (count($errors = $this->get('Errors'))) |
{ | { | ||
JError::raiseError(500, implode('<br />', $errors)); | JError::raiseError(500, implode('<br />', $errors)); | ||
+ | |||
return false; | return false; | ||
} | } | ||
− | + | ||
− | |||
− | |||
// Set the toolbar | // Set the toolbar | ||
Line 199: | Line 306: | ||
/** | /** | ||
− | * | + | * Add the page title and toolbar. |
+ | * | ||
+ | * @return void | ||
+ | * | ||
+ | * @since 1.6 | ||
*/ | */ | ||
− | protected function addToolBar() | + | protected function addToolBar() |
{ | { | ||
$input = JFactory::getApplication()->input; | $input = JFactory::getApplication()->input; | ||
+ | |||
+ | // Hide Joomla Administrator Main menu | ||
$input->set('hidemainmenu', true); | $input->set('hidemainmenu', true); | ||
+ | |||
$isNew = ($this->item->id == 0); | $isNew = ($this->item->id == 0); | ||
− | + | ||
− | + | if ($isNew) | |
+ | { | ||
+ | $title = JText::_('COM_HELLOWORLD_MANAGER_HELLOWORLD_NEW'); | ||
+ | } | ||
+ | else | ||
+ | { | ||
+ | $title = JText::_('COM_HELLOWORLD_MANAGER_HELLOWORLD_EDIT'); | ||
+ | } | ||
+ | |||
+ | JToolBarHelper::title($title, 'helloworld'); | ||
JToolBarHelper::save('helloworld.save'); | JToolBarHelper::save('helloworld.save'); | ||
− | JToolBarHelper::cancel('helloworld.cancel', $isNew ? 'JTOOLBAR_CANCEL' | + | JToolBarHelper::cancel( |
− | + | 'helloworld.cancel', | |
+ | $isNew ? 'JTOOLBAR_CANCEL' : 'JTOOLBAR_CLOSE' | ||
+ | ); | ||
} | } | ||
} | } | ||
Line 216: | Line 341: | ||
</span> | </span> | ||
− | This view will display data using a layout. | + | <translate><!--T:14--> |
+ | This view will display data using a layout.</translate> | ||
− | Put a file | + | <translate><!--T:15--> |
+ | Put a file <tt>admin/views/helloworld/tmpl/edit.php</tt> containing:</translate> | ||
<span id="admin/views/helloworld/tmpl/edit.php"> | <span id="admin/views/helloworld/tmpl/edit.php"> | ||
− | + | <tt>admin/views/helloworld/tmpl/edit.php</tt> | |
<source lang="php"> | <source lang="php"> | ||
<?php | <?php | ||
+ | /** | ||
+ | * @package Joomla.Administrator | ||
+ | * @subpackage com_helloworld | ||
+ | * | ||
+ | * @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved. | ||
+ | * @license GNU General Public License version 2 or later; see LICENSE.txt | ||
+ | */ | ||
+ | |||
// No direct access | // No direct access | ||
defined('_JEXEC') or die('Restricted access'); | defined('_JEXEC') or die('Restricted access'); | ||
− | + | ||
?> | ?> | ||
<form action="<?php echo JRoute::_('index.php?option=com_helloworld&layout=edit&id=' . (int) $this->item->id); ?>" | <form action="<?php echo JRoute::_('index.php?option=com_helloworld&layout=edit&id=' . (int) $this->item->id); ?>" | ||
Line 248: | Line 383: | ||
<?php echo JHtml::_('form.token'); ?> | <?php echo JHtml::_('form.token'); ?> | ||
</form> | </form> | ||
+ | |||
</source> | </source> | ||
</span> | </span> | ||
− | == Adding a model and modifying the existing one == | + | <translate>== Adding a model and modifying the existing one == <!--T:16--></translate> |
− | The | + | <translate><!--T:17--> |
+ | The <tt>HelloWorldViewHelloWorld</tt> view asks form and data from a model. This model has to provide a ''getTable'', a ''getForm'' method and a ''loadData'' method (called from the ''JModelAdmin'' controller).</translate> | ||
<span id="admin/models/helloworld.php"> | <span id="admin/models/helloworld.php"> | ||
− | + | <tt>admin/models/helloworld.php</tt> | |
<source lang="php"> | <source lang="php"> | ||
<?php | <?php | ||
+ | /** | ||
+ | * @package Joomla.Administrator | ||
+ | * @subpackage com_helloworld | ||
+ | * | ||
+ | * @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved. | ||
+ | * @license GNU General Public License version 2 or later; see LICENSE.txt | ||
+ | */ | ||
+ | |||
// No direct access to this file | // No direct access to this file | ||
defined('_JEXEC') or die('Restricted access'); | defined('_JEXEC') or die('Restricted access'); | ||
− | |||
− | |||
− | |||
/** | /** | ||
* HelloWorld Model | * HelloWorld Model | ||
+ | * | ||
+ | * @since 0.0.1 | ||
*/ | */ | ||
class HelloWorldModelHelloWorld extends JModelAdmin | class HelloWorldModelHelloWorld extends JModelAdmin | ||
{ | { | ||
/** | /** | ||
− | * | + | * Method to get a table object, load it if necessary. |
* | * | ||
− | * @param type The table | + | * @param string $type The table name. Optional. |
− | * @param string | + | * @param string $prefix The class prefix. Optional. |
− | * @param array Configuration array for model. Optional. | + | * @param array $config Configuration array for model. Optional. |
− | * @return JTable A | + | * |
− | * @since | + | * @return JTable A JTable object |
+ | * | ||
+ | * @since 1.6 | ||
*/ | */ | ||
− | public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array()) | + | public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array()) |
{ | { | ||
return JTable::getInstance($type, $prefix, $config); | return JTable::getInstance($type, $prefix, $config); | ||
} | } | ||
+ | |||
/** | /** | ||
* Method to get the record form. | * Method to get the record form. | ||
* | * | ||
− | * @param array $data | + | * @param array $data Data for the form. |
− | * @param boolean $loadData True if the form is to load its own data (default case), false if not. | + | * @param boolean $loadData True if the form is to load its own data (default case), false if not. |
− | * @return mixed A JForm object on success, false on failure | + | * |
− | * @since | + | * @return mixed A JForm object on success, false on failure |
+ | * | ||
+ | * @since 1.6 | ||
*/ | */ | ||
− | public function getForm($data = array(), $loadData = true) | + | public function getForm($data = array(), $loadData = true) |
{ | { | ||
// Get the form. | // Get the form. | ||
− | $form = $this->loadForm('com_helloworld.helloworld', 'helloworld', | + | $form = $this->loadForm( |
− | + | 'com_helloworld.helloworld', | |
− | if (empty($form)) | + | 'helloworld', |
+ | array( | ||
+ | 'control' => 'jform', | ||
+ | 'load_data' => $loadData | ||
+ | ) | ||
+ | ); | ||
+ | |||
+ | if (empty($form)) | ||
{ | { | ||
return false; | return false; | ||
} | } | ||
+ | |||
return $form; | return $form; | ||
} | } | ||
+ | |||
/** | /** | ||
* Method to get the data that should be injected in the form. | * Method to get the data that should be injected in the form. | ||
* | * | ||
− | * @return mixed The data for the form. | + | * @return mixed The data for the form. |
− | * @since | + | * |
+ | * @since 1.6 | ||
*/ | */ | ||
− | protected function loadFormData() | + | protected function loadFormData() |
{ | { | ||
// Check the session for previously entered form data. | // Check the session for previously entered form data. | ||
− | $data = JFactory::getApplication()->getUserState('com_helloworld.edit.helloworld.data', array()); | + | $data = JFactory::getApplication()->getUserState( |
− | if (empty($data)) | + | 'com_helloworld.edit.helloworld.data', |
+ | array() | ||
+ | ); | ||
+ | |||
+ | if (empty($data)) | ||
{ | { | ||
$data = $this->getItem(); | $data = $this->getItem(); | ||
} | } | ||
+ | |||
return $data; | return $data; | ||
} | } | ||
} | } | ||
+ | |||
</source> | </source> | ||
</span> | </span> | ||
− | This model inherits from the ''JModelAdmin'' class and uses its ''loadForm'' method. This method searches for forms in the ''forms'' folder. With your | + | <translate><!--T:18--> |
+ | This model inherits from the ''JModelAdmin'' class and uses its ''loadForm'' method. This method searches for forms in the ''forms'' folder. With your favourite file manager and editor, put a file <tt>admin/models/forms/helloworld.xml</tt> containing:</translate> | ||
<span id="admin/models/forms/helloworld.xml"> | <span id="admin/models/forms/helloworld.xml"> | ||
− | + | <tt>admin/models/forms/helloworld.xml</tt> | |
<source lang="xml"> | <source lang="xml"> | ||
<?xml version="1.0" encoding="utf-8"?> | <?xml version="1.0" encoding="utf-8"?> | ||
Line 331: | Line 497: | ||
<fieldset> | <fieldset> | ||
<field | <field | ||
− | + | name="id" | |
− | + | type="hidden" | |
− | + | /> | |
<field | <field | ||
− | + | name="greeting" | |
− | + | type="text" | |
− | + | label="COM_HELLOWORLD_HELLOWORLD_GREETING_LABEL" | |
− | + | description="COM_HELLOWORLD_HELLOWORLD_GREETING_DESC" | |
− | + | size="40" | |
− | + | class="inputbox" | |
− | + | default="" | |
− | + | /> | |
</fieldset> | </fieldset> | ||
</form> | </form> | ||
Line 348: | Line 514: | ||
</span> | </span> | ||
− | == Packaging the component == | + | <translate><!--T:19--> |
+ | Note: ''COM_HELLOWORLD_HELLOWORLD_GREETING_LABEL'' and ''COM_HELLOWORLD_HELLOWORLD_GREETING_DESC'' are an alias for ''COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL'' and ''COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC'' respectively.</translate> | ||
+ | |||
+ | <translate><!--T:20--> | ||
+ | Here we are using different label and description to convey two different meanings in two different sections, but they can be easily kept equal.</translate> | ||
+ | |||
+ | <translate>== Packaging the component == <!--T:21--></translate> | ||
− | Content of your code directory | + | <translate><!--T:22--> |
+ | Content of your code directory</translate> | ||
* ''[[#helloworld.xml|helloworld.xml]]'' | * ''[[#helloworld.xml|helloworld.xml]]'' | ||
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/helloworld.php|site/helloworld.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/controller.php|site/controller.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/view.html.php|site/views/helloworld/view.html.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/views/helloworld/tmpl/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Using_the_database#site/views/helloworld/tmpl/default.xml|site/views/helloworld/tmpl/default.xml]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_a_view_to_the_site_part#site/views/helloworld/tmpl/default.php|site/views/helloworld/tmpl/default.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/models/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Using_the_database#site/models/helloworld.php|site/models/helloworld.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/language/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|site/language/en-GB/index.html]]'' |
− | * | + | * [[S:MyLanguage/J3.x:Developing an MVC Component/Adding language management#site.2Flanguage.2Fen-GB.2Fen-GB.com_helloworld.ini|site/language/en-GB/en-GB.com_helloworld.ini]] |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Basic_backend#admin/helloworld.php|admin/helloworld.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Basic_backend#admin/controller.php|admin/controller.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Using_the_database#admin/sql/install.mysql.utf8.sql|admin/sql/install.mysql.utf8.sql]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Using_the_database#admin/sql/uninstall.mysql.utf8.sql|admin/sql/uninstall.mysql.utf8.sql]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/sql/updates/mysql/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#admin/sql/updates/mysql/0.0.1.sql|admin/sql/updates/mysql/0.0.1.sql]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Using_the_database#admin/sql/install.mysql.utf8.sql|admin/sql/updates/mysql/0.0.6.sql]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/fields/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Using_the_database#admin/models/fields/helloworld.php|admin/models/fields/helloworld.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Basic_backend#admin/models/helloworlds.php|admin/models/helloworlds.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_backend_actions#admin/models/helloworlds.php|admin/models/helloworld.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/models/forms/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_backend_actions#admin/models/forms/helloworld.xml|admin/models/forms/helloworld.xml]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_backend_actions#admin/controllers/helloworld.php|admin/controllers/helloworld.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_backend_actions#admin/controllers/helloworlds.php|admin/controllers/helloworlds.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/controllers/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/views/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/views/helloworld/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_backend_actions#admin/views/helloworld/view.html.php|admin/views/helloworld/view.html.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Adding_backend_actions#admin/views/helloworld/tmpl/edit.php|admin/views/helloworld/tmpl/edit.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/views/helloworld/tmpl/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/views/helloworlds/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Basic_backend#admin/views/helloworlds/view.html.php|admin/views/helloworlds/view.html.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/views/helloworlds/tmpl/index.html]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Basic_backend#admin/views/helloworlds/tmpl/default.php|admin/views/helloworlds/tmpl/default.php]]'' |
− | * ''[[J3.2: | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/tables/index.html]]'' |
− | * ''[[ | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Using_the_database#admin/tables/helloworld.php|admin/tables/helloworld.php]]'' |
− | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/language/index.html]]'' | |
− | * ''[[ | + | * ''[[S:MyLanguage/J3.2:Developing_an_MVC_Component/Developing_a_Basic_Component#index.html|admin/language/en-GB/index.html]]'' |
− | * ''[[ | + | * ''[[S:MyLanguage/J3.x:Developing an MVC Component/Adding language management#admin.2Flanguage.2Fen-GB.2Fen-GB.com_helloworld.ini|admin/language/en-GB/en-GB.com_helloworld.ini]]'' |
− | * ''[[ | + | * ''[[S:MyLanguage/J3.x:Developing an MVC Component/Adding language management#admin.2Flanguage.2Fen-GB.2Fen-GB.com_helloworld.sys.ini|admin/language/en-GB/en-GB.com_helloworld.sys.ini]]'' |
− | * ''[[#admin | ||
− | |||
− | Create a compressed file of this directory or directly download the [https://github.com/ | + | <translate><!--T:23--> |
+ | Create a compressed file of this directory or directly download the [https://github.com/scionescire/Joomla-3.2-Hello-World-Component/archive/step-9-adding-backend-actions.zip archive] and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.</translate> | ||
<span id="helloworld.xml"> | <span id="helloworld.xml"> | ||
− | + | <tt>helloworld.xml</tt> | |
− | <source lang="xml"> | + | <source lang="xml" highlight="13,69,70"> |
<?xml version="1.0" encoding="utf-8"?> | <?xml version="1.0" encoding="utf-8"?> | ||
− | <extension type="component" version="2 | + | <extension type="component" version="3.2.0" method="upgrade"> |
− | <name> | + | <name>COM_HELLOWORLD</name> |
<!-- The following elements are optional and free of formatting constraints --> | <!-- The following elements are optional and free of formatting constraints --> | ||
− | <creationDate> | + | <creationDate>January 2014</creationDate> |
<author>John Doe</author> | <author>John Doe</author> | ||
<authorEmail>john.doe@example.org</authorEmail> | <authorEmail>john.doe@example.org</authorEmail> | ||
Line 435: | Line 607: | ||
</sql> | </sql> | ||
</uninstall> | </uninstall> | ||
− | <update> <!-- Runs on update; New | + | <update> <!-- Runs on update; New since J2.5 --> |
<schemas> | <schemas> | ||
<schemapath type="mysql">sql/updates/mysql</schemapath> | <schemapath type="mysql">sql/updates/mysql</schemapath> | ||
Line 451: | Line 623: | ||
<folder>views</folder> | <folder>views</folder> | ||
<folder>models</folder> | <folder>models</folder> | ||
− | |||
</files> | </files> | ||
+ | |||
+ | <languages folder="site/language"> | ||
+ | <language tag="en-GB">en-GB/en-GB.com_helloworld.ini</language> | ||
+ | </languages> | ||
<administration> | <administration> | ||
<!-- Administration Menu Section --> | <!-- Administration Menu Section --> | ||
− | <menu>COM_HELLOWORLD_MENU</menu> | + | <menu link='index.php?option=com_helloworld'>COM_HELLOWORLD_MENU</menu> |
<!-- Administration Main File Copy Section --> | <!-- Administration Main File Copy Section --> | ||
<!-- Note the folder attribute: This attribute describes the folder | <!-- Note the folder attribute: This attribute describes the folder | ||
Line 474: | Line 649: | ||
<!-- views files section --> | <!-- views files section --> | ||
<folder>views</folder> | <folder>views</folder> | ||
− | |||
− | |||
<!-- controllers files section --> | <!-- controllers files section --> | ||
<folder>controllers</folder> | <folder>controllers</folder> | ||
− | </files> | + | </files> |
+ | <languages folder="admin/language"> | ||
+ | <language tag="en-GB">en-GB/en-GB.com_helloworld.ini</language> | ||
+ | <language tag="en-GB">en-GB/en-GB.com_helloworld.sys.ini</language> | ||
+ | </languages> | ||
</administration> | </administration> | ||
+ | |||
</extension> | </extension> | ||
</source> | </source> | ||
</span> | </span> | ||
− | {{notice|Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code descprepancies or if editing any of the source code on this page. | + | {{notice|<translate><!--T:24--> |
− | + | Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code descprepancies or if editing any of the source code on this page.</translate>}} | |
− | |||
− | |||
− | |||
− | |||
− | == Contributors == | + | <translate>== Contributors == <!--T:25--></translate> |
*[[User:cdemko|Christophe Demko]] | *[[User:cdemko|Christophe Demko]] | ||
*[[User:oaksu|Ozgur Aksu]] | *[[User:oaksu|Ozgur Aksu]] | ||
*[[User:betweenbrain|Matt Thomas]] | *[[User:betweenbrain|Matt Thomas]] | ||
+ | *[[User:Gunjanpatel|Gunjan Patel]] | ||
+ | *[[User:Scionescire|Scionescire]] | ||
+ | <div class="row"> | ||
+ | <div class="large-6 columns">{{Basic button|<translate><!--T:26--> | ||
+ | S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding language management|Prev: Adding language management</translate>|class=expand success}}</div> | ||
+ | <div class="large-6 columns">{{Basic button|<translate><!--T:27--> | ||
+ | S:MyLanguage/J3.x:Developing_an_MVC_Component/Adding decorations to the backend|Next: Adding decorations to the backend</translate>|class=expand}}</div> | ||
+ | </div> | ||
+ | __NOTOC__ | ||
+ | <noinclude> | ||
+ | <translate> | ||
+ | <!--T:28--> | ||
+ | [[Category:Joomla! 3.x]] | ||
[[Category:Joomla! 3.0]] | [[Category:Joomla! 3.0]] | ||
[[Category:Joomla! 3.1]] | [[Category:Joomla! 3.1]] | ||
[[Category:Joomla! 3.2]] | [[Category:Joomla! 3.2]] | ||
+ | [[Category:Joomla! 3.3]] | ||
+ | [[Category:Joomla! 3.4]] | ||
[[Category:Beginner Development]] | [[Category:Beginner Development]] | ||
[[Category:Component Development]] | [[Category:Component Development]] | ||
+ | [[Category:Tutorials]] | ||
+ | [[Category:Tutorials in a Series]] | ||
+ | </translate> | ||
+ | </noinclude> |
Revision as of 15:48, 19 August 2015
Articles in This Series
- Introduction
- Developing a Basic Component
- Adding a View to the Site Part
- Adding a Menu Type to the Site Part
- Adding a Model to the Site Part
- Adding a Variable Request in the Menu Type
- Using the Database
- Basic Backend
- Adding Language Management
- Adding Backend Actions
- Adding Decorations to the Backend
- Adding Verifications
- Adding Categories
- Adding Configuration
- Adding ACL
- Adding an Install/Uninstall/Update Script File
- Adding a Frontend Form
- Adding an Image
- Adding a Map
- Adding AJAX
- Adding an Alias
- Using the Language Filter Facility
- Adding a Modal
- Adding Associations
- Adding Checkout
- Adding Ordering
- Adding Levels
- Adding Versioning
- Adding Tags
- Adding Access
- Adding a Batch Process
- Adding Cache
- Adding a Feed
- Adding an Update Server
- Adding Custom Fields
- Upgrading to Joomla4
This is a multiple-article series of tutorials on how to develop a Model-View-Controller Component for Joomla! Version.
Begin with the Introduction, and navigate the articles in this series by using the navigation button at the bottom or the box to the right (the Articles in this series).
Introduction[edit]
This tutorial is part of the Developing an MVC Component for Joomla! 3.2 tutorial. You are encouraged to read the previous parts of the tutorial before reading this.
Adding a toolbar[edit]
In Joomla, the administrator interacts generally with components through the use of a toolbar. In the file admin/views/helloworlds/view.html.php put this content. It will create a basic toolbar and a title for the component.
The arguments used in, for example, JToolBarHelper::addNew is used to set a controller instance which will be used after button is clicked. Further details below in the adding specific controllers section.
admin/views/helloworlds/view.html.php
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* HelloWorlds View
*
* @since 0.0.1
*/
class HelloWorldViewHelloWorlds extends JViewLegacy
{
/**
* Display the Hello World view
*
* @param string $tpl The name of the template file to parse; automatically searches through the template paths.
*
* @return void
*/
function display($tpl = null)
{
// Get data from the model
$this->items = $this->get('Items');
$this->pagination = $this->get('Pagination');
// Check for errors.
if (count($errors = $this->get('Errors')))
{
JError::raiseError(500, implode('<br />', $errors));
return false;
}
// Set the toolbar
$this->addToolBar();
// Display the template
parent::display($tpl);
}
/**
* Add the page title and toolbar.
*
* @return void
*
* @since 1.6
*/
protected function addToolBar()
{
JToolBarHelper::title(JText::_('COM_HELLOWORLD_MANAGER_HELLOWORLDS'));
JToolBarHelper::addNew('helloworld.add');
JToolBarHelper::editList('helloworld.edit');
JToolBarHelper::deleteList('', 'helloworlds.delete');
}
}
You can find other classic backend actions in the administrator/includes/toolbar.php file of your Joomla installation.
Since the view can perform some actions, we have to add some input data. With your favourite file manager and editor, put in the file admin/views/helloworlds/tmpl/default.php
admin/views/helloworlds/tmpl/default.php
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted Access');
?>
<form action="index.php?option=com_helloworld&view=helloworlds" method="post" id="adminForm" name="adminForm">
<table class="table table-striped table-hover">
<thead>
<tr>
<th width="1%"><?php echo JText::_('COM_HELLOWORLD_NUM'); ?></th>
<th width="2%">
<?php echo JHtml::_('grid.checkall'); ?>
</th>
<th width="90%">
<?php echo JText::_('COM_HELLOWORLD_HELLOWORLDS_NAME') ;?>
</th>
<th width="5%">
<?php echo JText::_('COM_HELLOWORLD_PUBLISHED'); ?>
</th>
<th width="2%">
<?php echo JText::_('COM_HELLOWORLD_ID'); ?>
</th>
</tr>
</thead>
<tfoot>
<tr>
<td colspan="5">
<?php echo $this->pagination->getListFooter(); ?>
</td>
</tr>
</tfoot>
<tbody>
<?php if (!empty($this->items)) : ?>
<?php foreach ($this->items as $i => $row) :
$link = JRoute::_('index.php?option=com_helloworld&task=helloworld.edit&id=' . $row->id);
?>
<tr>
<td><?php echo $this->pagination->getRowOffset($i); ?></td>
<td>
<?php echo JHtml::_('grid.id', $i, $row->id); ?>
</td>
<td>
<a href="<?php echo $link; ?>" title="<?php echo JText::_('COM_HELLOWORLD_EDIT_HELLOWORLD'); ?>">
<?php echo $row->greeting; ?>
</a>
</td>
<td align="center">
<?php echo JHtml::_('jgrid.published', $row->published, $i, 'helloworlds.', true, 'cb'); ?>
</td>
<td align="center">
<?php echo $row->id; ?>
</td>
</tr>
<?php endforeach; ?>
<?php endif; ?>
</tbody>
</table>
<input type="hidden" name="task" value=""/>
<input type="hidden" name="boxchecked" value="0"/>
<?php echo JHtml::_('form.token'); ?>
</form>
Adding specific controllers[edit]
Three actions have been added:
- helloworlds.delete
- helloworld.edit
- helloworld.add
These are compound tasks (controller.task). So two new controllers HelloWorldControllerHelloWorlds and HelloWorldControllerHelloWorld have to be coded. (To understand the difference between the two types of subcontrollers read more in this article: subcontrollers...).
admin/controllers/helloworlds.php
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* HelloWorlds Controller
*
* @since 0.0.1
*/
class HelloWorldControllerHelloWorlds extends JControllerAdmin
{
/**
* Proxy for getModel.
*
* @param string $name The model name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return object The model.
*
* @since 1.6
*/
public function getModel($name = 'HelloWorld', $prefix = 'HelloWorldModel', $config = array('ignore_request' => true))
{
$model = parent::getModel($name, $prefix, $config);
return $model;
}
}
admin/controllers/helloworld.php
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* HelloWorld Controller
*
* @package Joomla.Administrator
* @subpackage com_helloworld
* @since 0.0.9
*/
class HelloWorldControllerHelloWorld extends JControllerForm
{
}
Adding an editing view[edit]
With your favourite file manager and editor, put a file admin/views/helloworld/view.html.php containing:
admin/views/helloworld/view.html.php
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* HelloWorld View
*
* @since 0.0.1
*/
class HelloWorldViewHelloWorld extends JViewLegacy
{
/**
* View form
*
* @var form
*/
protected $form = null;
/**
* Display the Hello World view
*
* @param string $tpl The name of the template file to parse; automatically searches through the template paths.
*
* @return void
*/
public function display($tpl = null)
{
// Get the Data
$this->form = $this->get('Form');
$this->item = $this->get('Item');
// Check for errors.
if (count($errors = $this->get('Errors')))
{
JError::raiseError(500, implode('<br />', $errors));
return false;
}
// Set the toolbar
$this->addToolBar();
// Display the template
parent::display($tpl);
}
/**
* Add the page title and toolbar.
*
* @return void
*
* @since 1.6
*/
protected function addToolBar()
{
$input = JFactory::getApplication()->input;
// Hide Joomla Administrator Main menu
$input->set('hidemainmenu', true);
$isNew = ($this->item->id == 0);
if ($isNew)
{
$title = JText::_('COM_HELLOWORLD_MANAGER_HELLOWORLD_NEW');
}
else
{
$title = JText::_('COM_HELLOWORLD_MANAGER_HELLOWORLD_EDIT');
}
JToolBarHelper::title($title, 'helloworld');
JToolBarHelper::save('helloworld.save');
JToolBarHelper::cancel(
'helloworld.cancel',
$isNew ? 'JTOOLBAR_CANCEL' : 'JTOOLBAR_CLOSE'
);
}
}
This view will display data using a layout.
Put a file admin/views/helloworld/tmpl/edit.php containing:
admin/views/helloworld/tmpl/edit.php
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access
defined('_JEXEC') or die('Restricted access');
?>
<form action="<?php echo JRoute::_('index.php?option=com_helloworld&layout=edit&id=' . (int) $this->item->id); ?>"
method="post" name="adminForm" id="adminForm">
<div class="form-horizontal">
<fieldset class="adminform">
<legend><?php echo JText::_('COM_HELLOWORLD_HELLOWORLD_DETAILS'); ?></legend>
<div class="row-fluid">
<div class="span6">
<?php foreach ($this->form->getFieldset() as $field): ?>
<div class="control-group">
<div class="control-label"><?php echo $field->label; ?></div>
<div class="controls"><?php echo $field->input; ?></div>
</div>
<?php endforeach; ?>
</div>
</div>
</fieldset>
</div>
<input type="hidden" name="task" value="helloworld.edit" />
<?php echo JHtml::_('form.token'); ?>
</form>
Adding a model and modifying the existing one[edit]
The HelloWorldViewHelloWorld view asks form and data from a model. This model has to provide a getTable, a getForm method and a loadData method (called from the JModelAdmin controller).
admin/models/helloworld.php
<?php
/**
* @package Joomla.Administrator
* @subpackage com_helloworld
*
* @copyright Copyright (C) 2005 - 2015 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
/**
* HelloWorld Model
*
* @since 0.0.1
*/
class HelloWorldModelHelloWorld extends JModelAdmin
{
/**
* Method to get a table object, load it if necessary.
*
* @param string $type The table name. Optional.
* @param string $prefix The class prefix. Optional.
* @param array $config Configuration array for model. Optional.
*
* @return JTable A JTable object
*
* @since 1.6
*/
public function getTable($type = 'HelloWorld', $prefix = 'HelloWorldTable', $config = array())
{
return JTable::getInstance($type, $prefix, $config);
}
/**
* Method to get the record form.
*
* @param array $data Data for the form.
* @param boolean $loadData True if the form is to load its own data (default case), false if not.
*
* @return mixed A JForm object on success, false on failure
*
* @since 1.6
*/
public function getForm($data = array(), $loadData = true)
{
// Get the form.
$form = $this->loadForm(
'com_helloworld.helloworld',
'helloworld',
array(
'control' => 'jform',
'load_data' => $loadData
)
);
if (empty($form))
{
return false;
}
return $form;
}
/**
* Method to get the data that should be injected in the form.
*
* @return mixed The data for the form.
*
* @since 1.6
*/
protected function loadFormData()
{
// Check the session for previously entered form data.
$data = JFactory::getApplication()->getUserState(
'com_helloworld.edit.helloworld.data',
array()
);
if (empty($data))
{
$data = $this->getItem();
}
return $data;
}
}
This model inherits from the JModelAdmin class and uses its loadForm method. This method searches for forms in the forms folder. With your favourite file manager and editor, put a file admin/models/forms/helloworld.xml containing:
admin/models/forms/helloworld.xml
<?xml version="1.0" encoding="utf-8"?>
<form>
<fieldset>
<field
name="id"
type="hidden"
/>
<field
name="greeting"
type="text"
label="COM_HELLOWORLD_HELLOWORLD_GREETING_LABEL"
description="COM_HELLOWORLD_HELLOWORLD_GREETING_DESC"
size="40"
class="inputbox"
default=""
/>
</fieldset>
</form>
Note: COM_HELLOWORLD_HELLOWORLD_GREETING_LABEL and COM_HELLOWORLD_HELLOWORLD_GREETING_DESC are an alias for COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_LABEL and COM_HELLOWORLD_HELLOWORLD_FIELD_GREETING_DESC respectively.
Here we are using different label and description to convey two different meanings in two different sections, but they can be easily kept equal.
Packaging the component[edit]
Content of your code directory
- helloworld.xml
- site/helloworld.php
- site/index.html
- site/controller.php
- site/views/index.html
- site/views/helloworld/index.html
- site/views/helloworld/view.html.php
- site/views/helloworld/tmpl/index.html
- site/views/helloworld/tmpl/default.xml
- site/views/helloworld/tmpl/default.php
- site/models/index.html
- site/models/helloworld.php
- site/language/index.html
- site/language/en-GB/index.html
- site/language/en-GB/en-GB.com_helloworld.ini
- admin/index.html
- admin/helloworld.php
- admin/controller.php
- admin/sql/index.html
- admin/sql/install.mysql.utf8.sql
- admin/sql/uninstall.mysql.utf8.sql
- admin/sql/updates/index.html
- admin/sql/updates/mysql/index.html
- admin/sql/updates/mysql/0.0.1.sql
- admin/sql/updates/mysql/0.0.6.sql
- admin/models/index.html
- admin/models/fields/index.html
- admin/models/fields/helloworld.php
- admin/models/helloworlds.php
- admin/models/helloworld.php
- admin/models/forms/index.html
- admin/models/forms/helloworld.xml
- admin/controllers/helloworld.php
- admin/controllers/helloworlds.php
- admin/controllers/index.html
- admin/views/index.html
- admin/views/helloworld/index.html
- admin/views/helloworld/view.html.php
- admin/views/helloworld/tmpl/edit.php
- admin/views/helloworld/tmpl/index.html
- admin/views/helloworlds/index.html
- admin/views/helloworlds/view.html.php
- admin/views/helloworlds/tmpl/index.html
- admin/views/helloworlds/tmpl/default.php
- admin/tables/index.html
- admin/tables/helloworld.php
- admin/language/index.html
- admin/language/en-GB/index.html
- admin/language/en-GB/en-GB.com_helloworld.ini
- admin/language/en-GB/en-GB.com_helloworld.sys.ini
Create a compressed file of this directory or directly download the archive and install it using the extension manager of Joomla. You can add a menu item of this component using the menu manager in the backend.
helloworld.xml
<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.2.0" method="upgrade">
<name>COM_HELLOWORLD</name>
<!-- The following elements are optional and free of formatting constraints -->
<creationDate>January 2014</creationDate>
<author>John Doe</author>
<authorEmail>john.doe@example.org</authorEmail>
<authorUrl>http://www.example.org</authorUrl>
<copyright>Copyright Info</copyright>
<license>License Info</license>
<!-- The version string is recorded in the components table -->
<version>0.0.9</version>
<!-- The description is optional and defaults to the name -->
<description>COM_HELLOWORLD_DESCRIPTION</description>
<install> <!-- Runs on install -->
<sql>
<file driver="mysql" charset="utf8">sql/install.mysql.utf8.sql</file>
</sql>
</install>
<uninstall> <!-- Runs on uninstall -->
<sql>
<file driver="mysql" charset="utf8">sql/uninstall.mysql.utf8.sql</file>
</sql>
</uninstall>
<update> <!-- Runs on update; New since J2.5 -->
<schemas>
<schemapath type="mysql">sql/updates/mysql</schemapath>
</schemas>
</update>
<!-- Site Main File Copy Section -->
<!-- Note the folder attribute: This attribute describes the folder
to copy FROM in the package to install therefore files copied
in this section are copied from /site/ in the package -->
<files folder="site">
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<folder>views</folder>
<folder>models</folder>
</files>
<languages folder="site/language">
<language tag="en-GB">en-GB/en-GB.com_helloworld.ini</language>
</languages>
<administration>
<!-- Administration Menu Section -->
<menu link='index.php?option=com_helloworld'>COM_HELLOWORLD_MENU</menu>
<!-- Administration Main File Copy Section -->
<!-- Note the folder attribute: This attribute describes the folder
to copy FROM in the package to install therefore files copied
in this section are copied from /admin/ in the package -->
<files folder="admin">
<!-- Admin Main File Copy Section -->
<filename>index.html</filename>
<filename>helloworld.php</filename>
<filename>controller.php</filename>
<!-- SQL files section -->
<folder>sql</folder>
<!-- tables files section -->
<folder>tables</folder>
<!-- models files section -->
<folder>models</folder>
<!-- views files section -->
<folder>views</folder>
<!-- controllers files section -->
<folder>controllers</folder>
</files>
<languages folder="admin/language">
<language tag="en-GB">en-GB/en-GB.com_helloworld.ini</language>
<language tag="en-GB">en-GB/en-GB.com_helloworld.sys.ini</language>
</languages>
</administration>
</extension>
Please create a pull request or issue at https://github.com/joomla/Joomla-3.2-Hello-World-Component for any code descprepancies or if editing any of the source code on this page.