JBZoo / Zoo

https://jbzoo.ru/docs
Admin
JBZoo is an application for the Joomla CMS, built upon the Zoo component, providing tools to create...
Tokens:35,100
Snippets:166
Trust Score:6.4
Update:1 year ago
Show doc for...
Tokens:
Raw
### Example of JBPrice Plain Variation Setup

Source: https://jbzoo.ru/docs/jbprice-plain

This illustrates how to set up specific variations for a product within the JBPrice Plain element. It demonstrates defining distinct attributes like color, discount, size, SKU, stock, and price for each variation, allowing for dynamic price adjustments based on user selection.

```text
Product Material Creation:
- Discount: 99.9%
- Image: [Product Image]
- SKU: tshirt-first-base
- Balance: infinite
- Base Price: 10 usd

Variation Setup (e.g., Black T-shirt):
- Color: black
- Discount: 90%
- Size: s
- SKU: tshirt-first-black-s
- Balance: 500
- Price: 15 eur
```

--------------------------------

### JBZoo File Paths for Flat Type Setup

Source: https://jbzoo.ru/docs/catalog-real-estate

This section lists the specific file paths within the JBZoo installation that need to be copied from a demo package to set up the 'flat' (real estate) item type. These paths cover templates, column renderers, CSS styles, configuration files for fields, and positions.

```plaintext
/media/zoo/applications/jbuniversal/templates/catalog/renderer/item/flat/
/media/zoo/applications/jbuniversal/templates/catalog/renderer/item_columns/flat.php
/media/zoo/applications/jbuniversal/assets/css/jbzoo.flat.css
/media/zoo/applications/jbuniversal/types/flat.config
/media/zoo/applications/jbuniversal/templates/catalog/renderer/item/positions.config
```

--------------------------------

### JBZoo Templating: Rendering Layout Files (PHP)

Source: https://jbzoo.ru/docs/how-make-element-example

Demonstrates how to check for and render a layout file in JBZoo templating. This example shows buffering and including a specific PHP file (_default.php) with variables passed to it, separating presentation logic from PHP code.

```php
// Проверяем существует ли файл
if ($layout = $this->getLayout('_default.php')) {
    // Буферизация и подключение файла _default.php
    return $this->renderLayout($layout, array(
                  'one' => 'var1',
                  'two' => 'var2'
    ));
}

```

--------------------------------

### Using Route Helper in PHP

Source: https://jbzoo.ru/docs/basic-api-jbzoo-and-zoo

Illustrates how to use the 'route' helper to generate a URL for a specific item. This example shows accessing the route helper through the application instance and calling its 'item' method with an item object to get the item's URL.

```php
/*
   Calls the item method from /administrator/components/com_zoo/helpers/route.php
   This is how you get a link to a material object when you have the necessary instance.
*/
$itemUrl = $this->app->route->item($item);
echo '<a href='.$itemUrl.'>Link to page</a>';
```

--------------------------------

### Configure Layout Positions (XML)

Source: https://jbzoo.ru/docs/catalog-real-estate

This XML file configures various layout positions for different templates (full, teaser, submission, related, compare, favorite) within the JBZoo application. It allows customization of position names for display in the control panel.

```xml
<?xml version="1.0" encoding="utf-8"?>
<!--
    JBZoo App is universal Joomla CCK, application for YooTheme Zoo component
    @package     jbzoo
    @version     2.x Pro
    @author      JBZoo App http://jbzoo.com
    @copyright   Copyright (C) JBZoo.com,  All rights reserved.
    @license     http://jbzoo.com/license-pro.php JBZoo Licence
    @coder       Denis Smetannikov <denis@jbzoo.com>
-->
<renderer>
    <positions layout="full">
       <position name="title">Title</position>
       <position name="gallery">Gallery</position>
       <position name="text">Text</position>
       <position name="properties">Properties</position>
       <position name="price">Price</position>
       <position name="agent">Agent</position>
       <position name="map">Map</position>
       <position name="favourite">Favourite</position>
       <position name="related">Related</position>
       <position name="comments">Comments</position>
    </positions>
    
    <positions layout="teaser">
         <position name="image">Image</position>
        <position name="price">Price</position>
        <position name="beds">Beds</position>
        <position name="baths">Baths</position>
        <position name="address">Address</position>
        <position name="year">Year Built</position>
        <position name="sqft">Sq Ft</position>
        <position name="save">Save</position>
        <position name="additionally">Additionally</position>
        <position name="type">Type</position>
        <position name="agent">Agent</position>
        <position name="compare">Compare</position>
        <position name="date">Date</position>
        <position name="marked">Marked</position>
    </positions>
    
    <positions layout="submission">
        <position name="main">Main</position>
        <position name="properties">Properties</position>
    </positions>
    
    <positions layout="related">
        <position name="main">Main</position>
        <position name="properties">Properties</position>
    </positions>
    <positions layout="compare">
        <position name="fields">Fields</position>
    </positions>

    <positions layout="favorite">
        <position name="title">Title</position>
        <position name="image">Image</position>
        <position name="properties">Properties</position>
        <position name="text">Text</position>
        <position name="meta">Meta</position>
    </positions>
</renderer>
```

--------------------------------

### Render Teaser Category Template (PHP)

Source: https://jbzoo.ru/docs/catalog-real-estate

This PHP code defines the `teaser.php` template for category pages. It renders various positions like image, price, beds, baths, and allows conditional rendering based on the presence of certain positions, such as baths.

```php
<?php
/**
 * JBZoo App is universal Joomla CCK, application for YooTheme Zoo component
 *
 * @package     jbzoo
 * @version     2.x Pro
 * @author      JBZoo App http://jbzoo.com
 * @copyright   Copyright (C) JBZoo.com,  All rights reserved.
 * @license     http://jbzoo.com/license-pro.php JBZoo Licence
 * @coder       Denis Smetannikov <denis@jbzoo.com>
 */
// no direct access
defined('_JEXEC') or die('Restricted access');
?>
<div class="realty-row item_<?php echo $item->id; ?> <?php echo ($isMarked) ? 'marked-element' : ''; ?>">
    <div class="teaser-image">
        <div class="mark-vip"></div><?php echo $this->renderPosition('image'); ?></div>
    <div class="main-info">
        <?php echo $this->renderPosition('price'); ?>
        <div class="rooms clearfix">
            <div
                class="beds <?php if (!$this->renderPosition('baths')): ?>no-baths<?php endif; ?> <?php if (!$this->renderPosition('baths')): ?>no-beds<?php endif; ?>">
                <div class="value-beds marked-realty"><?php echo $this->renderPosition('beds'); ?></div>
                <div class="label-beds"><?php echo JText::_('JBZOO_TMPL_FLAT_PROPS_BEDS'); ?></div>
            </div>
            <?php if ($this->checkPosition('baths')):
                ?>
                <div class="baths">
                    <div class="value-baths marked-realty"><?php echo $this->renderPosition('baths'); ?></div>
                    <div class="label-baths"><?php echo JText::_('JBZOO_TMPL_FLAT_PROPS_BATHS'); ?></div>
                </div>
            <?php endif;
            ?>
        </div>
```

--------------------------------

### Create Flat Item Renderer Template (JBZoo _flat.php)

Source: https://jbzoo.ru/docs/catalog-real-estate

This PHP snippet provides the basic structure for a '_flat.php' template file within the JBZoo Joomla CCK. It defines a title for a list of flat items using a language constant. This file should be placed in the specified catalog renderer path.

```php
<?php
/**
 * JBZoo App is universal Joomla CCK, application for YooTheme Zoo component
 *
 * @package     jbzoo
 * @version     2.x Pro
 * @author      JBZoo App http://jbzoo.com
 * @copyright   Copyright (C) JBZoo.com,  All rights reserved.
 * @license     http://jbzoo.com/license-pro.php JBZoo Licence
 * @coder       Denis Smetannikov <denis@jbzoo.com>
 */
// no direct access
defined('_JEXEC') or die('Restricted access');
?>
<div class="listings-title"><?php echo JText::_('JBZOO_TMPL_FLAT_LISTINGS'); ?></div>
```

--------------------------------

### Define Favorite Layout Metadata (XML)

Source: https://jbzoo.ru/docs/catalog-real-estate

This XML snippet defines a 'favorite' layout with a name and description. It's intended to be placed within the `<metadata>` tags in `metadata.xml` if no other code exists.

```xml
<layout name="favorite">
    <name>Favorite</name>
    <description>Layout for element favorite</description>
</layout>
```

--------------------------------

### JBZoo ElementJBInt Class Definition (PHP)

Source: https://jbzoo.ru/docs/how-make-element-example

Defines the ElementJBInt class, extending ElementRepeatable and implementing iRepeatSubmittable. It includes methods for checking if a value is set, retrieving search data, rendering edit forms, rendering the element, rendering for submission, and validating input.

```php
// Запрещаем прямой доступ к файлу
defined('_JEXEC') or die('Restricted access');
// Регистрируем ElementRepeatable class
App::getInstance('zoo')->loader->register('ElementRepeatable', 'elements:repeatable/repeatable.php');
class ElementJBInt extends ElementRepeatable implements iRepeatSubmittable
{
    /**
     * Checks if the repeatables element's value is set.
     */
    public function _hasValue($params = array())
    {
        $value = $this->get('number');
        return !empty($value);
    }
    /**
     * Get elements search data.
     * @return null | int
     */
    public function _getSearchData()
    {
        return (int) $this->get('number');
    }
    /**
     * Renders the edit form field.
     * @return string HTML
     */
    public function _edit()
    {
        if ($layout = $this->getLayout('edit.php')) {
            return $this->renderLayout($layout);
        }
        return false;
    }
    /**
     * Render
     * @param array $params
     * @return null | string HTML
     */
    public function _render($params = array())
    {
        if ($layout = $this->getLayout($params->get('template', 'default.php'))){
            return $this->renderLayout($layout);
        }
        return false;
    }
    /**
     * Renders the element in submission.
     * @param array $params submission parameters
     * @return null | string HTML
     */
    public function _renderSubmission($params = array())
    {
        return $this->_edit($params);
    }
    /**
     * Validates the submitted element
     * @param AppData $value  value
     * @param AppData $params submission parameters
     * @return array
     * @throws AppValidatorException
     */
    public function _validateSubmission($value, $params)
    {
        $value = $this->app->validator->create('integer',
            array(
                'required' => $params->get('required')
            )
        )->clean($value->get('number'));
        return array('number' => $value);
    }


```

--------------------------------

### Accessing the Zoo App Instance in PHP

Source: https://jbzoo.ru/docs/basic-api-jbzoo-and-zoo

Demonstrates two common methods to obtain an instance of the Zoo application class, which serves as the entry point for accessing framework functionalities. It's important to note that these methods return a reference, not a copy, meaning changes affect the global instance.

```php
// In any code location (even Joomla), the argument is always the same and denotes the global namespace in Zoo.
$app = App::getInstance('zoo');

// Code executed in the context of any framework entity
$app = $this->app;
```

--------------------------------

### System Cache Management (JBZoo-based) (PHP)

Source: https://jbzoo.ru/docs/basic-api-jbzoo-and-zoo

Provides a simplified interface for caching data using JBZoo's cache wrapper. It allows getting cached data by key and group, and setting new data with an optional group. This is a convenience layer over the Zoo cache system.

```php
$key = 'Переменная, которая отвечает за уникальность значения кеша';  // ключ кеша
$group  = 'папка_группы_кеша';

// проверяем актуальность
if (!($result = $this->app->jbcache->get($key, $group))) {

    // сложные вычисления
    $result = 2 + 2 * 2;

    // сохраняем результат
    $this->app->jbcache->set($key, $result, $group);
}
```

--------------------------------

### Spotlight and Lightbox Integration (HTML)

Source: https://jbzoo.ru/docs/widgetkit-spotlight

This example shows how to combine the Spotlight widget with the Lightbox feature. Hovering over the image triggers a Spotlight effect, while clicking opens the image in a Lightbox modal. This provides a dual-layer interactive experience for users.

```html
<a data-spotlight="effect:bottom;" data-lightbox="on" href="/images/picture.jpg">
    <img alt="picture" src="/images/picture.jpg" height="130" width="200" />
    <div class="overlay">Два виджета</div>
</a>
```

--------------------------------

### PrivatBank API Integration Example (Conceptual)

Source: https://jbzoo.ru/docs/cart-currency-elements

This conceptual example outlines how to interact with the PrivatBank API to retrieve currency exchange rates. PrivatBank offers an API for its services, and this snippet shows a potential way to fetch currency data. The actual implementation requires consulting PrivatBank's API documentation for the correct endpoints and response formats.

```javascript
async function getPrivatBankRates() {
  const url = 'https://api.privatbank.ua/p24api/pubinfo?exchange&json&coursid=5'; // Example API endpoint for USD/UAH
  try {
    const response = await fetch(url);
    const data = await response.json();
    // Process the rates data, e.g., find USD to UAH rate
    const usdRate = data.find(item => item.ccy === 'USD' && item.base_ccy === 'UAH');
    console.log('USD to UAH rate:', usdRate.buy, '/', usdRate.sale);
    return data;
  } catch (error) {
    console.error('Error fetching PrivatBank rates:', error);
    return null;
  }
}
```

--------------------------------

### JBInt Element XML Manifest for Zoo/JBZoo

Source: https://jbzoo.ru/docs/how-make-element-example

This XML file defines the 'jbint' element for Zoo and JBZoo. It specifies the element's type, group, author details, version, and configuration parameters for editing and rendering, including template selection and number separation options.

```xml
<?xml version="1.0" encoding="utf-8" ?>
<!--
 type  - Тип элемента. Он должен быть уникальным. 
 group - Группа элемента. Группа определяется позицией при создании новых элементов.
-->
<element type="jbint" group="JBZoo">
    <name>JBInt</name>
    <author>A. Oganov</author>
    <creationDate>2014 April</creationDate>
    <copyright>Copyright (C)</copyright>
    <authorEmail>email автора</authorEmail>
    <authorUrl>url автора</authorUrl>
    <version>1.0</version>
    <params>
 <!--  Параметры выводятся при создании элемента, конфиг элемента -->
              <param name="ajax" type="text" default="ajax" label="Default text" />
    </params>
    <params group="render">
	<!-- параметры выводятся в настройках шаблона вывода - full, teaser и т.д. -->
        <param name="template" type="zoolist" default="default" label="Chose template">
            <option name="JBZOO_ELEMENT_STANDART">default.php</option>
            <option name="JBZOO_ELEMENT_THOUSAND">thousand.php</option>
        </param>
        <param name="separated_by" type="zoolist" default="Space" label="Separated by"
               description="CHOOSE_SEPARATOR_REPEATED_ELEMENTS">
            <option name="Space"><![CDATA[separator=[ ]]]></option>
            <option name="Break"><![CDATA[separator=[<br />]]]></option>
            <option name="Span"><![CDATA[tag=[<span>%s</span>]]]></option>
            <option name="Paragraph"><![CDATA[tag=[<p>%s</p>]]]></option>
            <option name="Div"><![CDATA[tag=[<div>%s</div>]]]></option>
            <option name="List Item"><![CDATA[tag=[<li>%s</li>]]]></option>
            <option name="Unordered List"><![CDATA[tag=[<li>%s</li>] enclosing_tag=[<ul>%s</ul>]]]></option>
            <option name="Ordered List"><![CDATA[tag=[<li>%s</li>] enclosing_tag=[<ol>%s</ol>]]]></option>
            <option name="Warp Item"><![CDATA[tag=[<article class="item">%s</article>]]]></option>
        </param>
    </params>
</element>
```

--------------------------------

### Include Tooltip Styles and Initialize Widget Globally

Source: https://jbzoo.ru/docs/customize-like-demo-2

This example demonstrates how to include tooltip styles and initialize the widget globally within the UIkit initialization function. This ensures tooltips are available across the entire template, not just on specific pages. It utilizes JBZoo's asset management.

```php
use Joomla\Registry\Registry;

// Include standard JBZoo styles
$this->jbassets->css('general.less');

// Initialize tooltip widget for all elements with class '.your-class-name'
$this->jbassets->widget('tooltip', array(
    '.your-class-name',
    'tooltip'
));
```

--------------------------------

### YML Export Positions Configuration (XML)

Source: https://jbzoo.ru/docs/yandex-market

This XML snippet defines the available positions for the YML export layout in JBZoo. It lists various fields like title, price, properties, image, description, vendor, and country of origin, making them configurable within the JBZoo interface for different item types. This file is essential for mapping content elements to the YML output.

```xml
<positions layout="ymlexport">
   <position name="title">Title</position>
   <position name="price">Price</position>
   <position name="properties">Properties</position>
   <position name="image">Image</position>
   <position name="description">Description</position>
   <position name="vendor">Vendor</position>
   <position name="country_of_origin">Country of origin</position>
 </positions>

```

--------------------------------

### Image Resizing with Zoo and JBZoo Helpers in PHP

Source: https://jbzoo.ru/docs/basic-api-jbzoo-and-zoo

Compares and demonstrates two approaches to resizing images: the built-in Zoo 'resizeImage' function for absolute paths and the JBZoo 'jbimage->resize' wrapper for relative paths. The JBZoo wrapper returns an object with detailed information about the resized image.

```php
// Built-in function for resizing images (only full (absolute) paths)
$thumbFullpath = $this->app->zoo->resizeImage($OriginalFullpath, $width, $height);

// JBZoo wrapper, which can handle relative paths, but returns an object
$thumbInfo = $this->app->jbimage->resize($OriginalPath, $width, $height);

// Result of the JBZoo wrapper
$thumbInfo->orig; // Full path to the original file
$thumbInfo->origUrl; // Full path to the original file for the website (URL)
$thumbInfo->path; // Full path to the thumbnail
$thumbInfo->rel; // Relative path to the thumbnail
$thumbInfo->url; // Full path to the thumbnail for the website (URL)
$thumbInfo->height; $thumbInfo->width; // Thumbnail height and width
```

--------------------------------

### PHP Template for Real Estate Item Display (JBZoo)

Source: https://jbzoo.ru/docs/catalog-real-estate

This PHP code snippet modifies the 'full.php' template file for the JBZoo catalog application. It structures the display of real estate item details, including title, gallery, properties, agent information, description, related properties, and a map. It utilizes Joomla's rendering positions and JBZoo's specific functionalities for a dynamic layout.

```php
<!-- Объявление переменной для карты -->
<?php $map = JString::trim($this->renderPosition('map'));?>
<!-- Заголовок страницы (по умолчанию берется из заголовка материала) -->
<?php if ($this->checkPosition('title')) : ?>
	<h1 class="title"><?php echo $this->renderPosition('title'); ?></h1>
<?php endif; ?>
<!-- / Заголовок страницы -->
<!-- Основная информация сверху с изображением и свойствами справа в виде таблички -->
<div class="clearfix top-info">
    <?php if ($this->checkPosition('gallery')) : ?>
        <div class="full-gallery">
            <?php echo $this->renderPosition('gallery'); ?>
        </div>
    <?php endif; ?>
    <div class="features">
        <?php if ($this->checkPosition('properties')) : ?>
            <div class="price-flat clearfix">
                <?php echo $this->renderPosition('price'); ?>
            </div>
            <ul class="properties">
               <?php echo $this->renderPosition('properties', array('style'=>'list')); ?>
            </ul>
            <div class="favourite">
                <?php echo $this->renderPosition('favourite'); ?>
            </div>
        <?php endif; ?>
    </div>
</div>
<div class="clear clr"></div>
<!-- / Основная информация сверху →
<!-- Вкладки -->
<div id="tabs">	 
    <!-- Шапка вкладок (можете поменять заголовки здесь на свои) -->
    <ul>
        <li><a href="/<?php echo JUri::getInstance()->toString();?>#tab-overview">Overview</a></li>
        <li><a href="/<?php echo JUri::getInstance()->toString();?>#tab-agent">Listing Agent</a></li>
        <?php if ($map) : ?><li><a href="/<?php echo JUri::getInstance()->toString();?>#tab-location">Location</a></li><?php endif; ?>
        <li><a href="/<?php echo JUri::getInstance()->toString();?>#tab-comments">Comments</a></li>
    </ul>
    <!-- Вкладка с описанием объекта недвиждимости и похожими на него объектами -->
    <div id="tab-overview">
        <div class="full-info-realty">
            <?php if ($this->checkPosition('text')) : ?>
                <div class="text-property description-block">
                    <h3>Description</h3>
                    <?php echo $this->renderPosition('text'); ?>
                </div>
            <?php endif; ?>
            <?php if ($this->checkPosition('related')) : ?>
                <h3>More Similar Properties</h3>
                <div class="related-property">
                    <?php echo $this->renderPosition('related'); ?>
                </div>
            <?php endif; ?>
        </div>
        <div class="clear clr"></div>
    </div>
    <!-- Вкладка с информацией о продавце (риэлторе) -->
    <div id="tab-agent">
        <div class="agent-description description-block">
            <?php echo $this->renderPosition('agent'); ?>
        </div>
    </div>
    <!-- Вкладка с Google картой -->
    <?php if ($map) : ?>
        <div id="tab-location">
            <?php echo $this->renderPosition('map'); ?>
        </div>
    <?php endif; ?>
    <div id="tab-comments">
        <div class="comments-property">
            <?php echo $this->renderPosition('comments'); ?>
        </div>
    </div>
</div>
<!-- / Вкладки -->
<!-- Подключение скриптов -->
<?php $this->app->jbassets->jQueryUi(); ?>
<script>
jQuery(function($) {
    $('#tabs').JBZooTabs({
        onTabShow: function (index) {
            var map = $('.googlemaps > div:first');
            if (map.length) {
                map.data('Googlemaps').refresh();
            }
        }

```

--------------------------------

### YML Export Layout Metadata (XML)

Source: https://jbzoo.ru/docs/yandex-market

This XML snippet defines the metadata for the 'ymlexport' layout in JBZoo. It specifies the layout name as 'Yml Export' and provides a description indicating its purpose for the YML export controller. This metadata helps in identifying and managing the layout within the JBZoo application settings.

```xml
<layout name="ymlexport">
   <name>Yml Export</name>
   <description>Layout for controller ymlexport</description>
 </layout>

```

--------------------------------

### YML Export Template for Product Items (PHP)

Source: https://jbzoo.ru/docs/yandex-market

This PHP code snippet is a template for generating YML export data for product items in JBZoo. It includes fields like URL, price, currency, category, picture, name, vendor, description, and country of origin. It checks for the existence of price and allows conditional rendering of other fields based on defined positions. Dependencies include JBZoo's YML helper class and item parameters.

```php
<?php
/**
 * JBZoo App is universal Joomla CCK, application for YooTheme Zoo component
 *
 * @package jbzoo
 * @version 2.x Pro
 * @author JBZoo App http://jbzoo.com
 * @copyright Copyright (C) JBZoo.com, All rights reserved.
 * @license http://jbzoo.com/license-pro.php JBZoo Licence
 * @coder Vitaliy Yanovskiy <joejoker@jbzoo.com>;
 */
// no direct access
defined('_JEXEC') or die('Restricted access');
$yml = $this->app->jbyml;
?>
<?php if($item_params['price'][$item->id] !=0 || !empty($item_params['price'][$item->id])) : ?>
   <offer id="<?php echo $item->id ?>" available="<?php echo $yml->replaceSpecial($item_params['available'][$item->id]); ?>">
       <url><?php echo $yml->replaceSpecial($item_params['link'][$item->id]);?></url>
      <?php if ($this->checkPosition('price')) : ?>
       <price><?php echo $item_params['price'][$item->id]; ?></price>
       <?php endif; ?>
      <currencyId><?php echo $item_params['currencyId'][$item->id]; ?></currencyId>
       <categoryId><?php echo $item_params['categoryId'][$item->id]; ?></categoryId>
      <?php if ($this->checkPosition('image')) : ?>
       <picture><?php echo $item_params['picture'][$item->id];?></picture>
       <?php endif; ?>
      <?php if ($this->checkPosition('title')) : ?>
       <name><?php echo $yml->replaceSpecial($item->name); ?></name>
       <?php endif; ?>
      <?php if ($this->checkPosition('vendor')) : ?>
       <vendor><?php echo $yml->replaceSpecial($this->renderPosition('vendor')) ?></vendor>
       <?php endif; ?>
      <?php if ($this->checkPosition('description')) : ?>
       <description><?php echo $yml->replaceSpecial($this->renderPosition('description')) ?></description>
       <?php endif; ?>
      <?php if ($this->checkPosition('country_of_origin') && !empty($item_params['country'][$item->id])) : ?>
       <country_of_origin><?php echo $yml->replaceSpecial($item_params['country'][$item->id]); ?></country_of_origin>
       <?php endif; ?>
      <?php if ($this->checkPosition('properties')) : ?>
       <?php echo $this->renderPosition('properties', array('style' => 'jbxml')) ?>
       <?php endif; ?>
    </offer>
<?php endif;

```

--------------------------------

### CSV File Structure Example

Source: https://jbzoo.ru/docs/how-to-config-import

Example of how data is structured within a CSV file for import. It highlights the use of delimiters and enclosures to separate and contain data fields. Each line represents a distinct record, such as an article or category.

```text
Field1,Field2,Field3
"Value1A","Value2A","Value3A"
"Value1B","Value2B","Value3B"
```

--------------------------------

### ECB.europa.eu API Integration Example (Conceptual)

Source: https://jbzoo.ru/docs/cart-currency-elements

This conceptual example demonstrates fetching currency exchange rates from the European Central Bank's API. The ECB provides an API for accessing daily euro foreign exchange reference rates. The code would involve making an HTTP request and parsing the resulting XML data.

```javascript
async function getEcbRates() {
  const url = 'https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml'; // Example API endpoint
  try {
    const response = await fetch(url);
    const xmlText = await response.text();
    // Parse the XML text to extract rates
    const parser = new DOMParser();
    const xmlDoc = parser.parseFromString(xmlText, 'text/xml');
    const rates = {};
    const timeSeries = xmlDoc.getElementsByTagName('Cube')[0];
    for (let i = 0; i < timeSeries.childNodes.length; i++) {
      const node = timeSeries.childNodes[i];
      if (node.nodeType === 1 && node.getAttribute('currency')) {
        rates[node.getAttribute('currency')] = parseFloat(node.getAttribute('rate'));
      }
    }
    console.log(rates['USD']);
    return rates;
  } catch (error) {
    console.error('Error fetching ECB rates:', error);
    return null;
  }
}
```

--------------------------------

### Identify Duplicate jQuery Initialization in HTML

Source: https://jbzoo.ru/docs/conflicts-and-errors-in-javascript

This example demonstrates how to view the source code of a webpage (Ctrl+U) to identify multiple or conflicting jQuery script inclusions. It highlights which script (file #2 in the example) should be prioritized for correct widget functionality. This helps in finding extraneous script connections from third-party extensions or templates.

```html
<script src="path/to/your/jquery.js"></script>
<script src="path/to/another/jquery.js"></script>
<script src="path/to/jbzoo/jquery.js"></script>
<script src="path/to/widget/script.js"></script>
```

--------------------------------

### Get Full Path to Helper File (PHP)

Source: https://jbzoo.ru/docs/basic-api-jbzoo-and-zoo

Retrieves the full system path to a helper file using a virtual path key. It automatically searches registered real paths for the specified key and returns the first found file path. This is useful for dynamically accessing system files without hardcoding their locations.

```php
$helperPath = $this->app->path->path('helper:jbcart.php');
dump($helperPath); // полный путь до файла jbcart.php
```

--------------------------------

### Render Item Properties in PHP (JBZoo Teaser)

Source: https://jbzoo.ru/docs/catalog-real-estate

This snippet demonstrates how to render various item properties within a JBZoo template using PHP. It checks for the existence of specific positions before rendering them, ensuring a clean output. Language variables are used for localized display of property labels.

```php
<?php
echo $this->renderPosition('save');
?>

<div class="listing-date"><?php echo $this->renderPosition('date'); ?></div>
<p class="address"><?php echo $this->renderPosition('address'); ?></p>

<?php if ($this->checkPosition('year')) : ?>
    <div>
        <?php echo JText::_('JBZOO_TMPL_FLAT_PROPS_YEARBUILD'); ?>
        <span><?php echo $this->renderPosition('year'); ?></span>
    </div>
<?php endif; ?>
<?php if ($this->checkPosition('sqft')) : ?>
    <div>
        <?php echo JText::_('JBZOO_TMPL_FLAT_PROPS_SQFT'); ?>
        <span><?php echo $this->renderPosition('sqft'); ?></span>
    </div>
<?php endif; ?>
<?php if ($this->checkPosition('compare')) : ?>
    <div class="realty-compare">
        <?php echo $this->renderPosition('compare'); ?>
    </div>
<?php endif; ?>

<?php if ($this->checkPosition('type')) : ?>
    <div>
        <?php echo JText::_('JBZOO_TMPL_FLAT_PROPS_TYPEBUILD'); ?>
        <span><?php echo $this->renderPosition('type'); ?></span>
    </div>
<?php endif; ?>
<?php if ($this->checkPosition('additionally')) : ?>
    <div>
        <?php echo JText::_('JBZOO_TMPL_FLAT_PROPS_ADDITION'); ?>
        <span><?php echo $this->renderPosition('additionally'); ?></span>
    </div>
<?php endif; ?>
<?php if ($this->checkPosition('agent')) : ?>
    <div class="agent-info">
        <?php echo JText::_('JBZOO_TMPL_FLAT_PROPS_LISTING'); ?><?php echo $this->renderPosition('agent'); ?>
    </div>
<?php endif; ?>
```

--------------------------------

### Include Static Assets and Libraries (PHP)

Source: https://jbzoo.ru/docs/basic-api-jbzoo-and-zoo

Manages the inclusion of various static assets like JavaScript and CSS, along with their dependencies. It can automatically load libraries such as jQuery, jQuery UI, fancybox, and more. It also allows adding global PHP variables to the HTML document and including specific JS/CSS files using virtual paths.

```php
// включение различных библиотек
$this->app->jbassets->jQuery();
$this->app->jbassets->jQueryUI();
$this->app->jbassets->fancybox();
$this->app->jbassets->tablesorter();
$this->app->jbassets->chosen();
$this->app->jbassets->datepicker();
// итд, полный список методов внутри хелпера

// добавить глобальную переменную из PHP в документ HTML
$this->app->jbassets->addVar($varName, $value);

// подключить файл статики, используется виртуальный путь (из хелпера path)
$this->app->jbassets->js('<путь до файла JS>');
$this->app->jbassets->js('<путь до файла CSS>');
```

--------------------------------

### Render Favorite Item List Template (JBZoo favorite.php)

Source: https://jbzoo.ru/docs/catalog-real-estate

This PHP snippet defines the template structure for a list of favorite items in JBZoo. It conditionally renders the item title, image, properties, text content, and metadata based on the availability of specific positions. Includes basic styling for alignment and clearing floats.

```php
<?php
/**
 * JBZoo App is universal Joomla CCK, application for YooTheme Zoo component
 *
 * @package     jbzoo
 * @version     2.x Pro
 * @author      JBZoo App http://jbzoo.com
 * @copyright   Copyright (C) JBZoo.com,  All rights reserved.
 * @license     http://jbzoo.com/license-pro.php JBZoo Licence
 * @coder       Denis Smetannikov <denis@jbzoo.com>
 */
// no direct access
defined('_JEXEC') or die('Restricted access');
?>
<?php if ($this->checkPosition('title')) : ?>
    <h2 class="item-title"><?php echo $this->renderPosition('title'); ?></h2>
<?php endif; ?>

<?php if ($this->checkPosition('image')) : ?>
    <div class="item-image align-left">
        <?php echo $this->renderPosition('image');?>
    </div>
<?php endif; ?>

<?php if ($this->checkPosition('properties')) : ?>
    <ul class="item-properties">
        <?php echo $this->renderPosition('properties', array('style' => 'list'));?>
    </ul>
<?php endif; ?>

<?php if ($this->checkPosition('text')) : ?>
    <?php echo $this->renderPosition('text', array('style' => 'block')); ?>
<?php endif; ?>

<?php if ($this->checkPosition('meta')) : ?>
    <ul class="item-metadata">
        <?php echo $this->renderPosition('meta', array('style' => 'list'));?>
    </ul>
<?php endif; ?>
<div class="clear clr"></div>
```

--------------------------------

### JBPrice Plain Price Calculation Logic

Source: https://jbzoo.ru/docs/jbprice-plain

This section explains the price calculation for the JBPrice Plain element, especially when multiple variations exist. It shows how the system prioritizes variation-specific prices and discounts over base prices, with examples for different scenarios like feature inclusion/exclusion and undefined prices.

```text
Base Price: 20 eur, Base Discount: 10%

Variation 1 (No USB/Charger):
- Price: 10 eur
- Discount: 5%
- Calculated Price: 10 eur - 5% = 9.5 eur

Variation 2 (With Case):
- Price Adjustment: +5 eur
- Base Price + Adjustment: 20 eur + 5 eur = 25 eur
- Calculated Price: 25 eur - 10% = 22.5 eur

Variation 3 (No Flash Card):
- Price: Not specified
- Discount: 0%
- Calculated Price: Uses base price (20 eur) with 0% discount.
```

--------------------------------

### Retrieving Database Items and Categories in PHP

Source: https://jbzoo.ru/docs/basic-api-jbzoo-and-zoo

Shows how to fetch specific item and category objects from the database using their respective IDs. This utilizes the 'table' helper accessed via the application instance to interact with the data layer.

```php
$item = $this->app->table->item->get(42);
$category = $this->app->table->category->get(42);
```

--------------------------------

### CBR.ru API Integration Example (Conceptual)

Source: https://jbzoo.ru/docs/cart-currency-elements

This is a conceptual example of how an application might interact with the CBR.ru API to fetch currency exchange rates. The actual implementation would involve making HTTP requests to the specified API endpoint and parsing the response, typically in XML format. This service relies on the external API provided by the Central Bank of the Russian Federation.

```javascript
async function getCbrRates() {
  const url = 'https://www.cbr-xml-daily.ru/daily_json.js'; // Example API endpoint
  try {
    const response = await fetch(url);
    const data = await response.json();
    // Process the rates data here
    console.log(data.Valute.USD.Value);
    return data.Valute;
  } catch (error) {
    console.error('Error fetching CBR rates:', error);
    return null;
  }
}
```

--------------------------------

### Embed Local Video File with Media Player Widget

Source: https://jbzoo.ru/docs/widgetkit-media-player

This code example shows how to embed a video file hosted on your website using the Media Player widget. You need to provide the local path to the video file along with the desired width and height for the player.

```html
<video src="/video/ваше_видео.mp4" width="500" height="300"></video>
```

--------------------------------

### XML File Currency Service Configuration Example

Source: https://jbzoo.ru/docs/cart-currency-elements

This snippet illustrates the structure of an XML file used by the localxml currency service. It defines currency exchange rates relative to EUR. Ensure the file is placed in a suitable location and the path is correctly specified in the JBZoo settings. Missing currencies will fall back to a default value.

```xml
<config>
  <currency>
    <USD>0.92</USD>
    <GBP>0.81</GBP>
    <CNY>6.65</CNY>
  </currency>
  <default>1.0</default>
</config>
```

--------------------------------

### Generate SEF URLs (PHP)

Source: https://jbzoo.ru/docs/basic-api-jbzoo-and-zoo

Generates Search Engine Friendly (SEF) URLs for various items within the JBZoo framework. It can create links for materials by their ID, categories by their ID, and the front page of an application. It relies on fetched item or category data to construct the appropriate URL.

```php
// как по ID материала получить ссылку на материал
$item = $this->app->table->item->get(42);
$url = $this->app->route->item($item);

// как по ID категории получить ссылку
$category = $this->app->table->category->get(42);
$url = $this->app->route->category($category);

// главная страница каталога
$url = $this->app->route->frontpage($application_id);
```

--------------------------------

### Обновление JBZoo: Замена файлов плагина system/jbzoo

Source: https://jbzoo.ru/docs/upgrade-from-free-to-pro-version

Этот код заменяет файлы jbzoo.php и jbzoo.xml в директории /plugins/system/jbzoo на новые из распакованного архива JBZoo Pro. Это необходимо для корректной работы плагина после обновления.

```bash
В директории /plugins/system/jbzoo замените файлы jbzoo.php и jbzoo.xml на те, которые находятся в распакованном архиве у вас на компьютере — в папке packages\plg_sys_jbzoo.
```

--------------------------------

### Настройка RewriteBase в .htaccess для устранения ошибок

Source: https://jbzoo.ru/docs/installing-jbzoo

Этот фрагмент кода демонстрирует, как исправить файл .htaccess для корректного запуска сайта JBZoo, если возникают ошибки 500 или белый экран. Он показывает, как установить параметр RewriteBase, указывающий на поддиректорию сайта.

```apache
RewriteBase /<имя папки сайта>
```

--------------------------------

### Get JBZoo Basket URL (PHP)

Source: https://jbzoo.ru/docs/basic-api-jbzoo-and-zoo

Generates a specific URL for the JBZoo shopping cart page. This function takes the menu item ID and application ID as parameters to construct the correct URL for the basket.

```php
$basketUrl = $this->app->jbrouter->basket($menuItemid, $appId);
```

--------------------------------

### Обновление JBZoo: Экспорт каталога в JSON

Source: https://jbzoo.ru/docs/upgrade-from-free-to-pro-version

Этот фрагмент описывает процесс экспорта данных каталога из JBZoo Free в формате JSON. Этот файл затем будет использоваться для импорта данных в новую версию JBZoo Pro.

```bash
Зайдите в настройки вашего каталога и экспортируйте его в формате JSON.
```

--------------------------------

### Render Realty Listings in PHP

Source: https://jbzoo.ru/docs/catalog-real-estate

This PHP snippet utilizes the `implode` function to concatenate elements from the `$vars['objects']` array, separated by newlines. It is intended for displaying realty listings. Ensure that `$vars['objects']` is properly populated before execution.

```php
<?php echo implode(" \n", $vars['objects']); ?>
```

--------------------------------

### Обновление JBZoo: Копирование модулей

Source: https://jbzoo.ru/docs/upgrade-from-free-to-pro-version

Этот код демонстрирует процесс копирования папок с модулями из архива JBZoo Pro в директорию /modules на сервере. После копирования модули необходимо установить через менеджер расширений Joomla.

```bash
В директорию /modules скопируйте все папки с модулями из архива.

В административной части сайта зайдите в _Расширения_ > _Менеджер расширений_ > _Поиск_ и нажмите на кнопку _Найти_. В результатах поиска должны отобразиться только что скопированные модули, отметьте все и нажмите _Установить_. После этого новые модули станут доступны в Менеджере расширений (модули корзины, фильтрации и т.д.).
```
Tokens:
Raw