Интеграция с темой

1. Добавление кнопки «Сравнить» к объявлениям
Разместите этот код внутри цикла обработки объявлений (item.php, item-loop.php или внутри цикла while(osc_has_items())):

<?php if(function_exists(‘osc_compare’)) { echo osc_compare(); } ?>

Здесь отобразится кнопка для добавления/удаления текущего объявления из списка сравнения.
2. Добавление кнопки «Сравнить» в премиум-объявления
Разместите этот код внутри цикла обработки премиум-объявлений (osc_has_premiums):

<?php if(function_exists(‘osc_compare’)) { echo osc_compare(); } ?>

Функция автоматически определяет, является ли объявление обычным или премиум.
3. Отображение страницы сравнения
Страница сравнения автоматически становится доступна по адресу:

https://demo.osclass.su/compare-items

Пользователи также могут получить к нему доступ через плавающую кнопку сравнения или через раздел «Мои сравнения» в пользовательском меню.
4. Страница Мои сравнения
Страница автоматически становится доступной по адресу:

https://demo.osclass.su/my-comparisons

Для авторизованных пользователей в меню пользователя автоматически добавляется ссылка.

Расширенные функции

Получить количество сравнений
Возвращает количество объявлений, находящихся в данный момент в списке сравнения:

<?php echo co_get_compare_count(); ?>

Проверяет, находится ли товар в списке сравнения.
Возвращает true, если объявление уже находится в списке сравнения:

<?php if(co_is_item_in_compare($item_id)) { ?>   <p>Item is in compare list</p> <?php } ?>

Получить массив сравниваемых объявлений
Возвращает массив идентификаторов объявлений в списке сравнения:

<?php $compare_items = co_get_compare_items(); ?> <?php print_r($compare_items); ?>

Отображение плавающей кнопки сравнения
Плавающая кнопка появляется автоматически, когда в списке 2 и более объявлений. Чтобы изменить её положение, используйте настройки, указанные выше.
Для ручного отображения плавающей кнопки:

<?php echo co_floating_button(); ?>

Примеры интеграции
Пример 1: В item-loop.php

<?php while(osc_has_items()) { ?>   <div class=»listing-item»>     <h3><?php echo osc_item_title(); ?></h3>     <?php if(function_exists(‘osc_compare’)) { echo osc_compare(); } ?>   </div> <?php } ?>

Пример 2: В item.php (одиночное объявление)

<?php if(function_exists(‘osc_compare’)) { echo osc_compare(); } ?>

Разместите это в любом месте вашего шаблона item.php.
Пример 3: Индивидуальный стиль кнопки
Переопределите стандартные CSS-стили в вашем файле style.css:

.co_compare_button {   background: #your-color;   border-radius: 5px;   padding: 8px 16px; } .co_compare_button.is_compare {   background: #another-color; }

Часто задаваемые вопросы

В: Как работает список сравнения?
О: Список сравнения хранится в сессии пользователя. Это значит, что он работает без регистрации, но товары будут потеряны при закрытии браузера. Авторизованные пользователи могут сохранять сравнения навсегда.
В: Могут ли пользователи сравнивать товары из разных категорий?
О: Да, пользователи могут добавлять товары из любых категорий. Однако для наилучшего опыта сравнения рекомендуется сравнивать похожие товары из одной категории.
В: Как изменить текст на кнопке сравнения?
О: Вы можете изменить файлы перевода в папке /languages/ или использовать следующий код в вашей теме:

add_filter(‘co_button_text_add’, function($text) {   return ‘My custom text’; });

В: Плагин адаптирован для мобильных устройств?
О: Да, плагин полностью адаптивен и работает на всех устройствах, включая смартфоны и планшеты.
В: Как отключить плавающую кнопку сравнения?
О: Вы можете удалить её, добавив этот код в ваш файл functions.php темы:

remove_action(‘footer’, ‘co_add_floating_button’);

Перевод

Плагин поддерживает несколько языков. Файлы перевода находятся в папке:

oc-content/plugins/osclass_compare/languages/

Чтобы добавить новый язык:
1. Создайте папку с кодом вашего языка (например, «fr_FR»)
2. Скопируйте файл messages.po из папки en_US
3. Отредактируйте переводы
4. Сгенерируйте файл messages.mo с помощью Poedit