Добавление нового поля в VirtueMart

Наверное каждый кто когда-либо работал с компонентом Virtuemart замечал, что стандартных полей описания товара слишком мало. Вот и передо мной встала задача реализовать несколько дополнительных полей для вывода их в категории и в карточке товара. Как все умные и в меру ленивые люди (да-да люблю я себя (: ), решил сначала посмотреть, что пишут люди на российских и зарубежных форумах... и, о ужас, все мануалы пишутся только для вирта 1.0, в котором синтаксис координально отличается от версии 1.1. Проскальзывало несколько постов, типа: "Ура, я сумел реализовать сие чудо на вирте 1.1.3". После чего авторы сих познавательных комментов исчезали. Немного подумав и посидев над кодом нашел стабильное решение, которое безотказно работает на версиях 1.1.3 и 1.1.4. Итак приступим:
0. Для реализации нам нужен PhpMyAdmin, Dreamweaver (блокнот тож сойдет) и немного терпения.
1. Открываем базу данных нашего сайта и находим таблицу jos_vm_product. Заходим в нее, выбираем вкладку "Структура". Тут мы видим все поля нашего товара, такие как Артикул, Айди, цена и пр. Спускаемся вниз и находим "Добавить 1 поле(поля)" выбираем правее под каким полем хотим расположить наше будущее творение и жмем Ок. Теперь заполняем: Поле: product_new (можете вставить свое); Длина/значения: 64; Тип: VARCHAR; Сравнение: utf8_general_ci; Null: NOT NULL. Вдаваться в подробности за что отвечает каждая строчка не буду, таких мануалов итак полно. Остальные поля можно оставить пустыми. Сохраняем. Все... первый этап завершен.
2. После создания поля в таблице ее нужно привязать к админке сайта. Для этого идем сюда: administrator/com_virtuemart/html/product.product_form.php. В файле product.product_form.php в районе 197 строки начинается таблица, в которой формируются строки при добавлении нового товара. Оптимальнее всего размещать новое поле под артикулом. Следовательно находим строки:

1. <tr class="row1">
2. <td width="21%" >
3. <div style="text-align:right;font-weight:bold;"><?php echo $VM_LANG->
4. _('PHPSHOP_PRODUCT_FORM_SKU') ?>:</div>
5. </td>
6. <td width="79%">
7. <input type="text" class="inputbox" name="product_sku" value="<?php $db->sp("product_sku"); ?>" size="32" maxlength="64" />
8. </td>
9. </tr>

и после них вставляем:

1. <tr class="row1">
2. <td width="21%" >
3. <div style="text-align:right;font-weight:bold;"><?php echo $VM_LANG->_('PHPSHOP_PRODUCT_FORM_NEW') ?>:</div>
4. </td>
5. <td width="79%">
6. <input type="text" class="inputbox" name="product_new" value="<?php $db->sp("product_new"); ?>" size="32" maxlength="64" />
7. </td>
8. </tr>

Далее заходим в админку виртумарта и видим, что строка появилась, но вот название поля не отображается. Вспомним, что выше мы вставили следующую комбинацию:

1. <?php echo $VM_LANG->_('PHPSHOP_PRODUCT_FORM_NEW') ?>

Значит нам нужно задать это поле в языковом файле, для этого идем в administrator/com_virtuemart/languages/product/russian.php и добавляем под строкой:

1. 'PHPSHOP_PRODUCT_FORM_SKU' => 'Артикул',

вот такую:

1. 'PHPSHOP_PRODUCT_FORM_NEW' => 'Новое поле',

Теперь поле нормально отображается в админке, однако оно не связано с базой данных, в следующем шаге этим мы и займемся.
3. Теперь нам нужно связать наше новое поле с базой данных нашего сайта. Для этого идем в administrator/components/com_virtuemart/classes/ps_product.php находим строчки:

1. // Insert into DB
2. $fields = array ( 'vendor_id' => $vendor_id,
3. 'product_parent_id' => vmRequest::getInt('product_parent_id'),
4. 'product_sku' => vmGet($d,'product_sku'),

сразу под ними вставляем:

1. 'product_new' => vmGet($d,'product_new'),

Такая комбинация встречается в файле 2 раза, первый раз для добавления нового товара (в районе 272 строки), второй раз для его изменения (в районе 473 строки). То бишь если отредактировать только один раз, то новое поле будет добавляться при создании товара, но потом его нельзя будет отредактировать. Теперь можно зайти в админку и попробовать добавить новый товар с новым параметром, затем попробовать его изменить, если все прошло успешно и все данные нормально сохраняются, значит поле успешно связывается с бд.
4. В этом шаге мы начнем реализацию отображения нового поля в категории и карточке товара, для этого предварительно нужно отредактировать 2 файла. Сначала идем в administrator/com_virtuemart/html/shop_browse_queries.php (файл отвечает за включение поля в выборку при обращении к карточке товара или к категории). Находим строчки:

1. $fieldnames = "`product_name`,`products_per_row`,`category_browsepage`,`category_flypage`,`#__{vm}_category`.`category_id`,
2. `#__{vm}_product`.`product_id`,`product_full_image`,`product_thumb_image`,
3. `product_s_desc`,`product_parent_id`,`product_publish`,`product_in_stock`,`product_sku`,`product_url`,

и вставляем `product_new` после `product_sku`. Следовательно у нас должно получиться так:

1. $fieldnames = "`product_name`,`products_per_row`,`category_browsepage`,`category_flypage`,`#__{vm}_category`.`category_id`,
2. `#__{vm}_product`.`product_id`,`product_full_image`,`product_thumb_image`,`product_s_desc`,
3. `product_parent_id`,`product_publish`,`product_in_stock`,`product_sku`,`product_new`,`product_url`,

Сохраняем файл. Теперь идем в administrator/com_virtuemart/html/shop_browse.php (файл отвечает за "заглушку", которую мы будем использовать в карточке товара и в категории, кто не знает, в данном случае заглушка - это пхп функция, которая выводит данные из нашего нового поля непосредственно на сайте). Ищем строки:

1. // Unset these for the next product
2. unset($full_image_width);
3. unset($full_image_height);
4. $products[$i]['product_name'] = shopMakeHtmlSafe( $product_name );
5. $products[$i]['product_s_desc'] = $product_s_desc;
6. $products[$i]['product_details'] = $product_details;
7. $products[$i]['product_rating'] = $product_rating;
8. $products[$i]['product_price'] = $product_price;
9. $products[$i]['product_price_raw'] = $product_price_raw;
10. $products[$i]['product_sku'] = $db_browse->f("product_sku");

и после них добавляем:

1. $products[$i]['product_new'] = $db_browse->f("product_new");

Все, заглушка готова, теперь можно переходить к финальному этапу. Формированию шаблона категории и карточки товара.
5. Открываем components/com_virtuemart/themes/default/templates/browse/ваш шаблон категории. В моем случае это browse_1. В файле можно заметить, что вывод формируется через функции вида <?php echo $product_title ?>, следовательно, чтобы вывести наше новое поле нужно вставить: <?php echo $product_new ?>. В качестве примера выкладываю примерный код шаблона категории:

1. <?php if( !defined( '_VALID_MOS' ) && !defined( '_JEXEC' ) ) die( 'Direct Access to '.basename(__FILE__).' is not allowed.' );
2. mm_showMyFileName(__FILE__);
3. ?>
4. <div class="browseProductContainer">
7. <h1><a title="<?php echo $product_name ?>" href="<?php echo $product_flypage ?>">
8. <?php echo $product_name ?></a>
9. </h1>
10. <table border="1" width="100%" style="text-align:center;">
11. <tr>
12. <td>
13. <script type="text/javascript">//<![CDATA[
14. document.write('<a href="javascript:void window.open(\'<?php echo $product_full_image ?>\', \'win2\', \'status=no,toolbar=no,scrollbars=yes,titlebar=no,menubar=no,resizable=yes,width=<?php echo $full_image_width ?>,height=<?php echo $full_image_height ?>,directories=no,location=no\');">');
15. document.write( '<?php echo ps_product::image_tag( $product_thumb_image, 'class="browseProductImage" border="0" title="'.$product_name.'" alt="'.$product_name .'"' ) ?></a>' );
16. //]]>
17. </script>
18. <noscript>
19. <a href="<?php echo $product_full_image ?>" target="_blank" title="<?php echo $product_name ?>">
20. <?php echo ps_product::image_tag( $product_thumb_image, 'class="browseProductImage" border="0" title="'.$product_name.'" alt="'.$product_name .'"' ) ?>
21. </a>
22. </noscript>
23. </td>
24. <td>
25. <?php echo $product_new ?>
26. </td>
27. <td>
28. <?php echo $product_s_desc ?>
29. </td>
30. <td>
31. <?php echo $product_sku ?>
32. </td>
33. <td>
34. <?php echo $product_price ?>
35. </td>
36. </tr>
37. </table>
38. <br />
39. <span>
40. <?php echo $form_addtocart ?>
41. </span>
43. </div>

С карточкой товара все по аналогии. Всем спасибо за внимание, думаю информация будет полезна для разработчиков Интернет магазинов (: