Разработка компонента joomla3 на практике часть 1

Практический урок по разработке компонента на joomla 3. Теорию затрагивать я не буду. Только практика.

Компонент каталог чего угодно на joomla 3. Назовем его katalog - Каталог товаров. Для joomla компонента нужно придумать английское название - чтобы можно было использовать в разработке.  

Создадим структуру компонента с выводом панели управления в админке.

1. Стуктура компонента:

Создадим две папки site и admin и файл com_katalog.xml

Папка admin имеет содержимое:

2. Содержимое файла com_katalog.xml

Создадим файл sql

 Эти файлы у нас расположены в папке admin install.sql и uninstall.sql

в файл install.sql создадим запросы к созданию нужных нам таблицы в файл uninstall.sql запросы у к удалению этих таблиц  - когда компонент будет удалятся.

Таблица товаров или записей нашего каталога файл install.sql

И файл для удаления этих таблицы uninstall.sql

Далее нужно файлы точек вход в компонент
в папке admin и в папке site создадим файл katalog.php
эти файлы называются также как мы назвали свой компонент на английском языке.

Содержимое файла katalog.php в папке admin

<?php
 defined('_JEXEC') or die;
   
 
  if (!JFactory::getUser()->authorise('core.manage', 'com_katalog')) {
	return JError::raiseWarning(404, JText::_('JERROR_ALERTNOAUTHOR'));
}

// Include dependancies
jimport('joomla.application.component.controller');
// тут подключим вспомогательные файлы для дальнейшей работы над компонентом
require_once( JPATH_COMPONENT.DS.'helpers'.DS.'html'.DS.'filter.php' ); //наши филтры
require_once( JPATH_COMPONENT.DS.'helpers'.DS.'katalog.php' ); //helpers компонента

// Execute the task.
$controller	= JControllerLegacy::getInstance('katalog'); //контроллер
$controller->execute(JFactory::getApplication()->input->get('task'));
$controller->redirect(); 

Следующий обязательный файл controller.php

в предыдущем файле мы сразу указываем контроллер по умолчанию

$controller = JControllerLegacy::getInstance('katalog'); //контроллер

<?php
defined('_JEXEC') or die;
jimport('joomla.application.component.controller');

 
   JSubMenuHelper::addEntry(JTEXT::_('PANEL'), 'index.php?option=com_wine');
   JSubMenuHelper::addEntry(JTEXT::_('Места'), 'index.php?option=com_wine&view=regions');
   JSubMenuHelper::addEntry(JTEXT::_('Маршруты'), 'index.php?option=com_wine&view=products');
 
class KatalogController extends JControllerLegacy
{
	/**
	 * @var		string	The default view.
	 * @since	1.6
	 */
	protected $default_view = 'katalog';


 public function __construct($config = array())
	{
		parent::__construct($config);
 
		 
	}
    
    
	public function display($cachable = false, $urlparams = false)
	{
	 

	 
		$view		= JRequest::getCmd('view', 'katalog');
		$layout 	= JRequest::getCmd('layout', 'default');
		$id			= JRequest::getInt('id');
 

	 		parent::display();

		return $this;
	}
}

Создадим панель управления нашего компонента в админке

папка views  - > katalog

файл view.html.php

<?php
defined( '_JEXEC' ) or die( '=;)' );
jimport( 'joomla.application.component.view');
class  KatalogViewKatalog extends JViewLegacy
{

     function view_disp($tpl = null)
     {
        JToolBarHelper::title(   JText::_( 'PANEL' ), 'generic.png' ); //Название 
        JToolBarHelper::preferences('com_katalog', '400');    //Показываем кнопку настроек справа вверху - настройки редактируются в фaйле config.xml            
      

   	    $model = $this->getModel();
 

        parent::display($tpl);
     }

      
      function display($tpl = null)
         {
     
        switch ($this->getLayout()) {
         
          default:
           $this->view_disp($tpl);
           break;
     }        
        
     }      }

и заключении этой части создаем сам файл вывода панель управления default.php

папка views  -> katalog -> tmpl

В компоненте всегда создаю файл helpers в папке helpers с именем компонента наш будет называться katalog.php

содержимое фaйла

<?php

jimport('joomla.application.component.controller');

jimport( 'joomla.filesystem.folder' ); 

jimport( 'joomla.filesystem.file' );

jimport( 'joomla.mail.helper' );

class KatalogHelper

{

 public static function addSubmenu($vName)

{

JSubMenuHelper::addEntry(

JText::_('Панель управления'),

'index.php?option=com_katalog',

$vName == 'der'

);

}

// Эта функция упрощает вывод картинок из папки assets нашего компонента специально для админки

//самый простой способ вывод это KatalogHelper::I('имя картинки в папке assets/images/');

//также есть способ вывода со стилем так KatalogHelper::I('warehause_7947.png','width:60px'); еще можно передать как переменную ;

$a = KatalogHelper::I('warehause_7947.png','width:60px',true);

function I ($name, $w=null, $v = false, $alt=null)

{

 if (!empty($w))

 {

    $w = 'style="'.$w.'"';

 }

 if (!$v)

echo '<img  alt="'.$alt.'" title="'.$alt.'"   border="0" '.$w.' src="'.JURI::root().'administrator/components/com_katalog/assets/images/'.$name.'" />';

else return '<img border="0" alt="'.$alt.'" title="'.$alt.'" '.$w.' src="'.JURI::root().'administrator/components/com_katalog/assets/images/'.$name.'" />';

}

}

?>