Seller on CodeSeller - Выводит карточку товара с сервиса CodeSeller.ru с актуальной информацией (ценой)

Установка:

Т.к. это дополнение для WordPress плагина WP-Recall, то оно устанавливается через менеджер дополнений WP-Recall.

1. В админке вашего сайта перейдите на страницу "WP-Recall" -> "Дополнения" и в самом верху нажмите на кнопку "Обзор", выберите .zip архив дополнения на вашем пк и нажмите кнопку "Установить".
2. В списке загруженных дополнений, на этой странице, найдите это дополнение, наведите на него курсор мыши и нажмите кнопку "Активировать". Или выберите чекбокс и в выпадающем списке действия выберите "Активировать". Нажмите применить.

Обновление:

Дополнение поддерживает автоматическое обновление - два раза в день отправляются вашим сервером запросы на обновление.
Если в течение суток вы не видите обновления (а на странице дополнения вы видите что версия вышла новая), советую ознакомиться с этой статьёй

Настройки партнерской ссылки

В админке одна настройка: "WP-Recall" -> "Настройки" -> "Настройки Seller on CodeSeller" -> "Впишите ID партнера"
Позволяет вписать свою партнерскую ссылку и получать % с продаж по вашей реф ссылке. Подробней
Вписывать туда число: ваш id зарегистрированного юзера с сервиса CodeSeller.

Как получить id?
1. Заходим на кодеселлер (обязательно залогиненным)
2. Выбираем товар, что участвует в партнерской программе и переходим на его страницу
3. Слева вверху нажимаем "Получить партнерскую ссылку"
4. Копируем первое число (второе id товара. Его вписывать не нужно)
Скриншот

Использование шорткода

В нужном месте впишите шорткод (это может быть текст записи - например после обзора - для того чтобы расположить партнерский блок
Или его можно вписать в виджет "Текст" и расположить в сайдбаре вашего сайта)

[codeseller_product] - шорткод для вывода товаров (если вписать только этот шорткод - мы получим 21 товар, отсортированный по обновлению)

Дополнительные атрибуты шорткода:

Шорткод может принимать атрибуты:
slug - вписывайте, через запятую, слаги (slug) товара (название папки дополнения. Например у дополнения Hello Private Message слаг: hello-private-message)
template - (по умолчанию list) используемый для вывода шаблон. Доступны так же full-width и card
disable_ref - (по умолчанию 0) ставьте 1, чтобы отключить партнерскую ссылку (полезно для авторов дополнений)
filter - (по умолчанию 0) - ставьте 1, чтобы включить над товарами кнопки js-фильтра
author - id автора дополнений (полезно для авторов дополнений)
sort - начальная сортировка списка. Доступные значения update, active-install, downloads, price. По умолчанию сервис отдает по времени обновления допа
premium - ставьте 1, чтобы выбирать товары только с ценой (премиум дополнения)
random - ставьте 1, чтобы выводить дополнения в случайном порядке
number - предельное количество дополнений в удаленном запросе (по умолчанию сервис отдает 21)
limit - но выводить на экран только это значение (полезно для random)
hide_outsale - ставьте значение 0, если нужно отобразить товары снятые с распространения. Их заголовок будет перечеркнут и вместо цены надпись "Снят с продажи"

Примеры:

1. Допустим, мы делаем обзор фриланс биржи, и в конце записи хотим разместить блок с актуальной ценой на нее, и чтобы была включена партнерская ссылка для заработка по партнерской программе.
Шорткод для этого такой:
[codeseller_product template="full-width" slug="freelance-nextgen"]
- Внимание! Если вы затрудняетесь какой slug вписать для товара - вы всегда можете задать этот вопрос автору дополнения в комментариях или ЛС

2. Вывести пару случайных дополнений в сайдбаре.
Для этого впишем к примеру 5 slug, поставим в атрибуте рандом, но для вывода поставим 2:
[codeseller_product template="card" slug="freelance-nextgen,user-info-tab,partners-system,users-market,invest-system" random="1" limit="2"]
- мы запросили нужные нам 5 товаров и ротируем их в случайном порядке выводя по 2

3. Вывести все товары автора и вверху показать js-фильтр
На примере моего аккаунта:
[codeseller_product author="44" filter="1"]
- но сервис кодеселлер по умолчанию отдаст нам только 21 товар. И в этом списке он выведет по умолчанию допы по времени обновления
Снимем это ограничение, и выведем все мои дополнения отсортированные по цене:
[codeseller_product author="44" filter="1" number="100" sort="price"]

4. Если вы автор дополнения - выводить реф ссылку на самого себя нет смысла. Выведем свои товары отключив реф ссылку
[codeseller_product author="44" filter="1" number="100" disable_ref="1"]

5. Вывести все свои премиум дополнения в случайном порядке, отобразив 4-ре
[codeseller_product author="44" template="card" number="100" disable_ref="1" premium="1" random="1" limit="4"]

Таким образом мы можем получить нужный нам набор дополнений. Причем как для своего портфолио (свои дополнения), так и для продвижения по партнерской программе.

Принцип работы:

1. Есть настройка в админке - где вписывается ID партнера для формирования партнерской ссылки (можно отключить - смотри в вкладке "Настройки" доступные атрибуты шорткода)
2. Вписываете шорткод с атрибутами и можно сразу начинать работать

Дополнение, на основе сформированного шорткода, раз в час обращается к api сервиса codeseller. И кеширует полученные данные с удаленного сервера на час.
Админ может увидеть надпись (видна только ему) "Показаны актуальные данные" - это значит что данные только что пришли из сервиса кодеселлер.
Эта же надпись показывается если вы используете предпросмотр записи из админки - пока вы настраиваете шорткод смысла кешировать данные нет.

Благодаря такому кешированию все происходит очень быстро - это не замедляет вашу страницу.

Разное:

Это дополнение использует шаблоны - вы с легкостью можете этим воспользоваться - кастомизировав под себя. Читайте тут как с ними работать.

ToDo:

Приоритет:
** Переработать настройки, позволить выводить по автору или по слагу - с версии v2.0
** Возможность вписать партнерскую ссылку и в шорткоде ее отключать (по умолчанию включена будет) - позволит этому допу работать по партнерской программе - с версии v2.0
** Новый шаблон для вывода в одиночной записи - во всю ширину - с версии v2.0

Второстепенно:
* Сейчас выводятся только дополнения к WP-Recall, в следующих версиях будет вывод вордпресс шаблонов и плагинов (api codeseller пока это не поддерживает)
* Вывод сводной статистики: Кол-во аддонов, плагинов и шаблонов (вкл/выкл)
* Отключение фильтра и сортировки (у кого товаров мало - смысла в нем нет) - с версии v2.0
* Кеширование миниатюр изображений товаров - частично реализовано с версии 2.3 (кеш на клиенте)
* Еще один шаблон вывода (возможность его выбора в атрибуте шорткода) - с версии v2.0

* Поддержка осуществляется в рамках текущего функционала дополнения
* При возникновении проблемы, создайте соответствующую тему на форуме поддержки товара
* Если вам нужна доработка под ваши нужды - вы можете обратиться ко мне в ЛС с техзаданием на платную доработку.

Все мои работы опубликованы на моём сайте и в каталоге магазина CodeSeller.ru