Skip to content

Otshelnik-Fm/seller-on-codeseller

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Описание:

Дополнение для WordPress плагина WP-Recall

  • С помощью этого дополнения автор товаров, ведущий свои продажи через сервис CodeSeller.ru, сможет вывести актуальную информацию и статистику о своих товарах, на своем сайте или блоге.
  • А любой желающий, с помощью этого дополнения, сможет вывести карточку товара (дополнения к WP-Recall) с сервиса CodeSeller.ru для работы по партнерской программе

Demo:

слева

  • 4-ре рандомных премиум товара выводятся карточкой

Список всех моих дополнений с фильтром


Возможности вывода:

  • Возможность указать свою партнерскую ссылку (на основе partner id)
  • Возможность отключения партнерской ссылки (например если вы выводите свои допы)
  • Множество настроек доступно через атрибуты шорткода
  • Три шаблона вывода карточки товара (list, full-width и card)
  • Получение товара или списка товаров по автору или по slug товара
  • Вкл/выкл js фильтра вверху списка
  • Показ только премиум дополнений (не нулевая цена у товара)
  • Рандомный вывод одного или нескольких товаров

В зависимости от выбранного из 3-х шаблонов выводится:

  • Вывод информации о товаре
  • Вывод текущей версии
  • Вывод совместимости с WP-Recall
  • Вывод миниатюры товара
  • Количество скачиваний
  • Количество активных установок
  • Цена
  • Дата последнего обновления
  • Сортировка и фильтр товаров

Возможности сортировки и фильтра:

  • Сортировка по цене (увеличение/уменьшение)
  • Вывод премиум товаров (только платные)
  • Вывод популярных товаров
  • Сортировка по алфавиту (а-я)

Установка/Обновление

Установка:
Т.к. это дополнение для 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 вписать для товара - вы всегда можете задать этот вопрос автору дополнения в комментариях или ЛС
  1. Вывести пару случайных дополнений в сайдбаре.
    Для этого впишем к примеру 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
  1. Вывести все товары автора и вверху показать js-фильтр
    На примере моего аккаунта:
    [codeseller_product author="44" filter="1"]
  • но сервис кодеселлер по умолчанию отдаст нам только 21 товар. И в этом списке он выведет по умолчанию допы по времени обновления
    Снимем это ограничение, и выведем все мои дополнения отсортированные по цене:
    [codeseller_product author="44" filter="1" number="100" sort="price"]
  1. Если вы автор дополнения - выводить реф ссылку на самого себя нет смысла. Выведем свои товары отключив реф ссылку
    [codeseller_product author="44" filter="1" number="100" disable_ref="1"]

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

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


FAQ:

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

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

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

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

Разное:

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


ToDo:

Приоритет:

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

Второстепенно:

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

Changelog:

2022-06-11
v3.0

  • Товар снятый с продажи имеет перечеркнутое название
    Также в шаблоне list и full-width цена на него не указывается. Вместо этого написано "Снят с продажи"
  • Товар снятый с продажи по умолчанию не показывается в шорткоде. Если нужно включить - в шорткоде ставьте hide_outsale=0
  • В шаблоне full-width выводится пометка если это VIP-товар
  • Добавил noindex внешним ссылкам на магазин
  • Устранил CLS (Cumulative Layout Shift) в браузере
  • Все шаблоны были переработаны - если что-то в них правили - актуализируйте. Вёрстка приведена к соглашению 6px
  • В настройки дополнения добавлена опция скругления краёв карточек
  • Добавлена кнопка фильтра VIP дополнений
  • Обновляемый счетчик если фильтрация по премиум, по vip или сбрасывается

2020-12-01
v2.9

  • Шаблон list претерпел изменения:
    В него добавлена сортировка по скачиваниям, по установкам, новый тип "Показатель отказов (bounce rate)" и сортировка по нему
    Добавлено подсвечивание значений когда нажали сортировку
    Добавлен сверху общий подсчет дополнений в фильтре если их болше 5-ти
    Переделана вёрстка по соглашению 6px
  • Для фильтра используются css-переменные цвета реколл
  • Исправлена ошибка возникающая при минимизации скриптов

2019-11-03
v2.8

  • В шаблоны добавлена поддержка дополнения "Lazy Daisy" (поддержка lazy load - если этот доп включен)
    затронуты все шаблоны в папке templates - если вы их переносили и правили под себя - актуализируйте под себя

2019-10-28
v2.7

  • Небольшие корректировки стилей

2019-10-24
v2.6

  • В шаблоны к картинкам добавлен атрибут loading="lazy" (пока его поддерживает хром). Полезно когда реклама внизу.
    затронуты все шаблоны в папке templates - если вы их переносили и правили под себя - актуализируйте под себя

2019-10-06
v2.5

  • Исправлена ошибка в шаблонах, когда у товара вдруг нет прикрепленного изображения (обложки)
    затронуты все шаблоны в папке templates - если вы их переносили и правили под себя - актуализируйте под себя

2019-05-18
v2.4

  • Исправлена ошибка когда товар снят с продажи
  • В шаблоне list рядом с ценой идет (vip) - если это дополнение закрыто Vip доступом

2018-10-11
v2.3

  • работа над доступностью (accessibility)
  • id блока убрал т.к. на странице может быть множество блоков (вызовов шорткодов)
  • добавил атрибут rel="noopener" внешним ссылкам (безопасность)
  • полностью перешел на реколл анимацию
  • минимизированы скрипт и стили
  • добавил к обложкам товаров их версию - на клиенте сразу заработало кеширование этих обложек (кеш на клиенте)

2018-10-08
v2.2

  • Работа с WP-Recall 16.16

2018-02-27
v2.1

  • Исправлена ошибка в шаблоне list - появляющаяся когда только что загруженное дополнение в каталог CodeSeller еще не имело в значении кол-во активных установок
  • Стили грузятся сверху.
  • Проработана анимация появления при загрузке страницы. Теперь блоки появляются плавней, без дёрганья, в большинстве случаев (для full-width и list шаблонов)

2017-12-27
v2.0.1

  • Небольшие css-фиксы

2017-12-26
v2.0

  • Полностью переписан на ооп и поддерживает api codeseller
  • Увы, 2 прошлых шорткода более не поддерживаются. Все заменилось новым одним. Смотри доступные атрибуты в секции " Настройки"
  • Страница настроек содержит только одну опцию. Остальные убрал. Слаги дополнений теперь вписываются в шорткод
  • Поддерживает формирование партнерской ссылки
  • Новые атрибуты шорткода (вывод по автору, вывод по slug дополнения, выбор шаблона, отключение фильтра, отключение реф ссылки, возможность назначить начальную сортировку, вывод только премиум допов)
  • Новый шаблон вывода (всего их 3)
  • Новый принцип кеширования - использует реколл кеширование
  • Благодаря новому шорткоду и новому принципу кеширования нет проблем как раньше - приходилось или ждать час или принудительно часовой крон дергать
  • Анимация теперь берется из ядра WP-Recall

2017-12-23
v1.0

  • Доп успешно прошел испытания. Присвоил ему версию 1.0.
  • Небольшая файловая реорганизация

2017-12-15
v0.3

  • Внешние ссылки закрыты nofollow
  • Исправлено: всплывающий блок в карточке рандомного товара теперь не ловит курсор. Были залипания

2017-10-19
v0.2

  • Добавлены новые настройки позволяющие грузить ресурсы (js,css) только там, где необходимо.
  • Добавлен шорткод рандомного вывода 4-х премиум (с ценой) дополнений. Шорткод [ofm_addons_random]
  • Если папка xml-файлов была удалена, то при проверке обновления вп-кроном он ее создаст заново.
  • Исправлена ошибка не вывода текста в data атрибуте (по ховеру всплывающий блок) если он содержит кавычки
  • Изменения в верстке и стилях
  • TimeLapse анимация

2017-02-27
v0.1.1

  • Подправил некоторые стили

2016-09-22
v0.1

  • Beta Release

Поддержка и контакты

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

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


Author

Wladimir Druzhaev (Otshelnik-Fm)