Подопытным будет сайт Joomline, который мы перевели на Joomla 3.

На Joomla 2.5 мы использовали свой плагин для получения, вот такого эффекта.

Свой плагин — это конечно хорошо, но когда вам хочется добавить еще одно поле, то вам требуется уже программирование, как на уровне фронта, так на уровне админки. В общем расширяемость такого решения нам не очень нравилась. Кстати об этом я уже писал.

Так бы и оставалось до сих пор если бы не желание перейти на Joomla 3. И вот мы выделили немного времени, начали переход c Joomla 2.5 на Joomla 3. На удивление все расширения, которые были на сайте Joomline отлично продолжили работать на сайте на Joomla 3. Исключение был один модуль, который был несколько топорно написан, скорей с учетом совместимости c Joomla 1.5.

После обновления мы:

1. Установили miniCCK.
2. Создали поля, всего около 12 штук.
3. Задали необходимые значения полям.
4. Определили поля к типу вывода.
5. Написали свой фронт вывода (мы работали с полями как объектами и не использовали встроенный шаблон).

Хотелось бы отметить, что для нормальной работы с плагином у вас должно быть хоть какое-то понятие о PHP, HTML и CSS. Теперь я расскажу о пятом пункте, так как он самый интересный.

Первым делом мы создали собственный шаблон для com_content

site.ru/templates/шаблон_сайта/html/com_content/article/minicck.php

Создали мы из стандартного шаблона com_content — default.php. Кто не понимает о чем, я почитайте в интернете «переопределение шаблонов Joomla».

Переопределили некоторые поля minicck. В примере будет поле чекбокс.

Копируем

site.ru/plugins/system/minicck/fields/mccheckbox/tmpl/default.php

в папку

site.ru/templates/шаблон_сайта/html/plg_system_minicck/fields/mccheckbox/

<?php echo implode(' ', $data); ?>

Мы переопределяли еще и поле mcimage. Делается все аналогично.

Далее мы начали изменять шаблон com_content minicck.php.

Добавляем в него над областью вывода контента следующую конструкцию:

<div class="content_extensions"><table width="100%" class="table_ce"><br />              <tr><br />                <td  rowspan="4" style="height: 150px;" width="200" valign="middle" align="center"><div ><?php echo $this->item->minicck->getFieldValue($this->item->id, 'field1');?></div></td><br />                <td>Версия</td><br />                <td><?php echo $this->item->minicck->getFieldValue($this->item->id, 'field2');?></td><br />                <td>&nbsp;&nbsp;</td><br />                <td><a rel="nofollow" target="_blank" href="<?php echo $this->item->minicck->getFieldValue($this->item->id, 'field6');?>" class="btn   btn-info btn-small btn-w100">Демонстрация</a></td><br />              </tr><br />              <tr><br />                <td>Совместимость</td><br />                <td><?php echo $this->item->minicck->getFieldValue($this->item->id, 'sovmestimostrasshirenija');?></td><br />                <td>&nbsp;&nbsp;</td><br />                <td><a rel="nofollow" target="_blank" href="<?php echo $this->item->minicck->getFieldValue($this->item->id, 'field7');?>" class="btn btn-success btn-small btn-w100">Скачать</a></td><br />                <br />              </tr><br />              <tr><br />                <td>Состав пакета</td><br />                <td><?php echo $this->item->minicck->getFieldValue($this->item->id, 'field3');?></td><br />                <td>&nbsp;&nbsp;</td><br />                <td><a href="<?php echo $this->item->minicck->getFieldValue($this->item->id, 'field10');?>" class="btn   btn-info btn-small btn-w100">Документация</a></td><br />              </tr><br />              <tr><br />                <td>Условия распространения</td><br />                <td><?php echo $this->item->minicck->getFieldValue($this->item->id, 'field5');?></td><br />                <td>&nbsp;&nbsp;</td><br />                <td><a href="<?php echo $this->item->minicck->getFieldValue($this->item->id, 'field11');?>" class="btn   btn-info btn-small btn-w100">Пожертвовать</a></td><br />              </tr><br />            </table></div>

Где код:

<?php echo $this->item->minicck->getFieldValue($this->item->id, 'field11');?>

Отвечает за вывод значение поля. field11 — это id поля.

Собственно на выходе мы получем вот такую картинку:

Для чего нужен пакет установки Joomla?

Сейчас расширения Joomla обычно состоят из набора расширений: модули, плагины, компоненты, библиотеки. Устанавливать весь этот набор по отдельности не удобно, гораздо проще загрузить один архив в инсталлятор Joomla, а он уже все установит, так как надо. Собственно для этого и были придуманы пакеты. Обычно они обозначаются как pkg_ .

Теперь маленькая ремарка. Раньше я воспринимал, установочный пакет, только с точки зрения удобной установки расширений Joomla, с сегодняшнего дня я его еще и воспринимаю, как инструмент удобного удаления расширений Joomla.

Дальше будет немного официальной документации с моими комментариями.

Представим, что у нас есть директория с расширениями:

-- pkg_helloworld.xml
 -- packages <dir>
     |-- com_helloworld.zip
     |-- mod_helloworld.zip
     |-- lib_helloworld.zip
     |-- plg_sys_helloworld.zip
     |-- tpl_helloworld.zip

Над ней мы кладем фаил pkg_helloworld.xml -helloworld — это имя пакета, в котором и содержится вся информация по установке расширения.

  <?xml version=«1.0» encoding=«UTF-8» ?>
 <extension type=«package» version=«1.6»>
 <name>Hello World Package</name>
 <author>Hello World Package Team</author>
 <creationDate>May 2012</creationDate>
 <packagename>helloworld</packagename>
 <version>1.0.0</version>
 <url>http://www.yoururl.com/</url>
 <packager>Hello World Package Team</packager>
 <packagerurl>http://www.yoururl.com/</packagerurl>
 <description>Example package to combine multiple extensions</description>
 <update>http://www.updateurl.com/update</update>
 <files folder=«packages»>
   <file type=«component» id=«helloworld» >com_helloworld.zip</file>
   <file type=«module» id=«helloworld» client=«site»>mod_helloworld.zip</file>
   <file type=«library» id=«helloworld»>lib_helloworld.zip</file>
   <file type=«plugin» id=«helloworld» group=«system»>plg_sys_helloworld.zip</file>
   <file type=«template» id=«helloworld» client=«site»>tpl_helloworld.zip</file>
 </files>
 </extension>

Вот так выглядит фаил pkg_helloworld.xml

Что в этом файле важно?

<extension type=«package» version=«1.6»> — это тип расширения пакет.

<packagename>helloworld</packagename> — собственно само название пакета оно должно совпадать с названием файла pkg_helloworld.xml, то есть правильное название helloworld.

Теперь перейдем к самому телу пакета установки:

 <files folder=«packages»>
   <file type=«component» id=«helloworld» >com_helloworld.zip</file>
   <file type=«module» id=«helloworld» client=«site»>mod_helloworld.zip</file>
   <file type=«library» id=«helloworld»>lib_helloworld.zip</file>
   <file type=«plugin» id=«helloworld» group=«system»>plg_sys_helloworld.zip</file>
   <file type=«template» id=«helloworld» client=«site»>tpl_helloworld.zip</file>
 </files>

На что тут стоит обратить внимание:

<files folder=«packages»> — если папка с расширениями называется «packages», если она называется по другом, то следовательно название надо изменить, если же ее нет, xml установки лежит в одном уровне с расширениями для установке то вся конструкция будет выглядеть вот так:

 <files>
   <file type=«component» id=«helloworld» >com_helloworld.zip</file>
   <file type=«module» id=«helloworld» client=«site»>mod_helloworld.zip</file>
   <file type=«library» id=«helloworld»>lib_helloworld.zip</file>
   <file type=«plugin» id=«helloworld» group=«system»>plg_sys_helloworld.zip</file>
   <file type=«template» id=«helloworld» client=«site»>tpl_helloworld.zip</file>
 </files>

Теперь об самих расширениях:

<file type=«component» id=«helloworld» >com_helloworld.zip</file>

Обязательно надо указать тип расширения «type» — в данном примере этот тип это «component».

Так же следует указать id расширения, его вы можете найти в xml самого расширения, которое устанавливаете.

Специфические параметры для плагинов:

Для плагинов требуется указать группу расширения group=«system».

После того как вы все сделали правильно, вы можете как установить все расширения одной операцией, так и удалить все установленные расширения, удалив просто пакет установки расширения.

Код формы может быть любой, например такой:

<form action="#" class="vacancy_form"> 
                <input type="text" name="l_name" class="a-name" data-validate="validate(required)"> 
                <input type="text" name="f_name" class="b-name" data-validate="validate(required)"> 
                <input type="file" name="resume" data-validate="validate(required)"> 
                <button class="btn yel_btn">Откликнуться</button> 
                <input type="hidden" name="filename" value=""/> 
</form> 

Скрипт:

var iframe = $('<iframe id="upload_iframe" name="upload_iframe" style="width:0;height:0;border:0;"></iframe>'); 
        var hidForm = $('<form style="display:none;" target="upload_iframe" enctype="multipart/form-data" action="/ajax/?function=upload_file" method="post" name="upload-form"/>'); 
        $('body').append(iframe).append(hidForm); 
        iframe.load(function(){ 
            var data = $(this).contents().text(); 
            if (data === undefined || data == '') return; 
            iframe.remove(); 
            hidForm.remove(); 
            data = JSON.parse(data); 
            if (data.error == '1') 
            { 
                alert(data.content); 
                return; 
            } 
            form.find('input[name=filename]').val(data.file); 
            $.ajax({ 
                url: '/ajax/?function=vacancy', 
                type: "POST", 
                dataType:"json", 
                data: form.serialize(), 
                success: function(data){ 
                    ... 
                } 
            }); 
        }); 
        var realFile = form.find('input[name=resume]'), 
            realFileVal = realFile.val(), 
            realFile = form.find('input[name=resume]'), 
            newFile = realFile.clone(); 
        realFile.replaceWith(newFile); 
        hidForm.append(realFile).val(realFileVal); 
        hidForm.submit(); 

Скрипт был почерпнут на просторвх интернета и переделан под свои нужды. Скрипт создает ифрейм и дополнительную форму чтобы не маяться с передачей атрибутов в основную форму. Вспомогательная форма берет из основной инпут файла с его значением, отправляет на сервер строкой hidForm.submit();. После загрузки файла вступает событие  iframe.load, в которое сервер передает информацию о загрузке файла и путь до загруженного файла на сервере, Далее полученный путь прописывается в input[name=filename] и происходит передача основной формы через  $.ajax. На выходе получаем загруженный файл и переданную форму.

Кто видел универсальный модуль Флекси изнутри, тот поймет, почему я не полез в него, а сделал в обход.

Была задача, сделать в модуле табы при нажатии на которые происходила бы новая выборка контента с другими параметрами сортировки или отбора.

Итак, по порядку.

1. Создаем табы по которым будет осуществляться переход, ссылку в табе нужно привести к такому виду:

<a href="#" data-order="popular" data-module="103" class="tabs-nav-link">Топ</a>

где data-order — параметр сортировки в этом табе, data-module — ид модуля (могут быть копии одного модуля, по этому для точного определения нужен именно ид). Получить ид модуля можно так

<?php echo $module->id; ?>

2. Скрипт обрабатывающий аякс (на jQuery):

jQuery(function($) {
  $('.tabs-nav-link').click(function(){
  var module = $(this).attr('data-module');
  var order = $(this).attr('data-order');

  var parent = $(this).parents('div.index-news-contayner');
  $('li.tabs-nav-item', parent).removeClass('tabs-nav-item_state_active');
  $(this).parent().addClass('tabs-nav-item_state_active')
  $.ajax({
  type: "POST",
  url: '/index.php?option=com_flexicontent&controller=other&task=news_ajax&module='+module+'&order='+order,
  dataType: 'html',
  success: function (data){
  $('div.section-unit', parent).html(data);
  }
  });
  return false;
  });
});

Скрипт вешает на ссылку с классом

tabs-nav-link

div.section-unit

Обработчик обращается в контроллер 

other

Тело функции:

function news_ajax(){
  $db = JFactory::getDbo();
  $input = new JInput();
  $moduleId = $input->getInt('module', 0);
  $order = $input->getString('order', 'default');

  $query = $db->getQuery(true);
  $query->select('params');
  $query->from('#__modules');
  $query->where('`id` = ' . $moduleId);
  $db->setQuery($query, 0, 1);
  $result = $db->loadResult();

  $params = new JRegistry();
  $params->loadString($result);

  if($order != 'default'){
  $params->set('ordering', $order);
  }

  $params->set('layout', $params->get('layout', 'default').'-inner');

  require(JPATH_BASE.'/modules/mod_flexicontent/mod_flexicontent.php');
  die;
  }

Как видите все просто, по полученным данным я загружаю параметры модуля, меняю нужные параметры на пришедшие из запроса и вывожу модуль на печать. Стоит отметить что для таких выкрутасов я разбил шаблон модуля на два — обертка с заголовками, табами и т.п. и тело контента, которое подлежит перезагрузке. В основной шаблон подключен шаблон контента, а при перезагрузке я использую только внутренний шаблон, который в функции переназначается. В моем случае это основной — default.php и внутренний — default-inner.php.

Написал функцию, определяющую корневую категорию, пригодна для любого компонента, использующего таблицу категорий Joomla, для хранения своих категорий.

Функция получилась очень простая из-за того, что в категориях использованы nested sets, которые существенно облегчают процесс выборки как вверх так и вниз по дереву.

Тело функции:

function getRootCat($catid){
  static $id;

  if(empty($id)){
  $db = JFactory::getDBO();
  $query = $db->getQuery(true);

  $query->select('parent.id');
  $query->from('#__categories as child');
  $query->from('#__categories as parent');
  $query->where('child.id = '.(int)$catid);
  $query->where('parent.rgt >= child.rgt');
  $query->where('parent.lft <= child.lft');
  $query->where('parent.level = 1');
  $db->setQuery($query);
       $id = $db->loadResult();
  }
  return $id;
  }

Входящий параметр один — ид текущей категории. Выход тоже один — ид корневой категории.