ebay purchase report

отчет о покупке на ebay

Веб-расширение, которое генерирует компактный отчет об истории покупок на eBay.

История покупок на eBay не выглядит дружелюбной, когда у вас масса покупок и вам интересно увидеть компактный сгруппированный список того, что вы купили, сколько это стоило, сколько отправлено или нет и т. д. Такой список можно легко генерируется путем прохождения DOM страницы, сбора этой информации и, в конечном итоге, распечатки отчета на консоли браузера.

Этот проект предоставляет веб-расширение Firefox|Chrome|Opera (дополнение), которое помогает создавать такой отчет. Отчет создается на новой вкладке в виде HTML-документа.

Требования

Протестировано на Linux с Firefox 45+, Chrome 55+, Opera 36+. Он также должен работать в Windows или MacOS. Не создано и не протестировано на Microsoft Edge, Android или iPhone, но кто знает, возможно, это сработает :-)

Разрешения дополнения

Некоторые функции этого дополнения используют определенные API, поэтому для установки потребуются определенные разрешения. Ниже приведен список этих разрешений и их причины:

• получить доступ к своим данным на .ebay.com/

• ну это очевидно, не так ли?

• загружать файлы, читать и изменять историю загрузок браузера

• на самом деле мы используем только функцию загрузки, чтобы убедиться, что вы можете экспортировать данные отчета в формат CSV|JSON|XML и, тем не менее, загрузить их.

• доступ к вкладкам браузера:

• поскольку отчет загружается в новую вкладку, требуется доступ к вкладкам. Кроме того, для открытия страницы сведений об элементе также потребуется это разрешение.

Обычно вы не беспокоитесь об этом при установке дополнения, не так ли? Если да, то теперь вы это знаете :-)

Установите дополнение

user способ:

• для браузеров Firefox используйте кнопку «Добавить в Firefox» Mozilla.
• для Chrome используйте кнопку Google «ДОБАВИТЬ В CHROME».

Если вы хотите установить/протестировать определенную версию, перейдите в папку dist, загрузите и установите ту версию, которая вам подходит:

1. Загрузите файл дополнения .zip из папки dist.
2. Откройте Инструменты браузера -> Extension | Меню Add-ons
   • В Firefox в правом верхнем углу (рядом с входом Search add-on ) есть раскрывающаяся кнопка tools . Нажмите эту кнопку и выберите Install Add-on From File . Выберите файл, загруженный на шаге (1).
   • В Chrome|Opera просто перетащите ZIP-файл, загруженный по адресу (1), в список Extension . Он автоматически предложит вам Drop to install

Путь developer :

• просмотрите исходный код, соберите пакет самостоятельно, а затем продолжите чтение раздела « How to use it .

Как его использовать

1. Откройте страницу eBay и войдите в систему, используя свою учетную запись eBay.
2. Перейдите в меню «Мой eBay» -> Purchase history .
3. Когда страница загрузится, вы увидите золотую кнопку Quick Report в группе «Заказы»:
4. Нажмите кнопку Quick Report . Откроется новая вкладка, содержащая компактный HTML-отчет об истории ваших покупок на eBay:

Обратите внимание, что в отчет будут включены только видимые элементы. Например, если вы решили отображать только 25 Orders per page , отчет будет включать только эти заказы. Чтобы включить всю историю, убедитесь, что вы выбрали самый большой доступный вариант Orders per page (например, 100).

Показанные столбцы

По умолчанию отчет будет включать следующие столбцы:

• # : индекс строки отчета
• Продавец: идентификатор продавца eBay.
• Дата покупки: информация Order date на eBay.
• Цена товара: значение Item price на eBay.
• Количество: количество товара на eBay.
• Статус доставки: статус доставки товара на eBay.
• Расчетная дата доставки: позиция заказа eBay. Estimated delivery , если доступна.
• Описание товара: описание товара в заказе eBay, указанное в истории покупок.

По умолчанию отчет генерирует промежуточные итоги нижнего колонтитула группы для каждой даты/значения валюты. В этом нижнем колонтитуле группы показано количество товаров в группе, их общая сумма, сколько отправлено/не отправлено, а также средняя цена за товар. В отчете также будет распечатана общая сумма по всему отчету.

Начиная с версии 1.0.7, при наведении указателя мыши на элемент также будет отображаться миниатюра элемента :-)

Сортировать порядок

По умолчанию отчет создается с использованием естественного порядка приобретенных товаров. Если вы хотите отсортировать отчет по определенному столбцу, щелкните значок стрелки, который отображается рядом с именем столбца. Он работает как восходящий, так и нисходящий.

Экспорт данных

Отчет позволяет экспортировать набор данных в форматы JSON и XML с разделителями табуляции. Просто воспользуйтесь ссылкой, указанной в документе отчета.

Предостережение

1. Поскольку надстройка повторяет текущие отображаемые элементы заказа, в отчет будут включены именно те элементы, которые вы видите на текущей странице eBay Purchase History .
2. Если вы хотите открыть страницу сведений об элементе, просто нажмите на него. Надстройка имитирует щелчок соответствующего элемента на странице истории покупок eBay.
3. При взаимодействии с отчетом (сортировка, открытие сведений об элементе и т. д.) убедитесь, что вы не закрываете вкладку/страницу истории покупок eBay, иначе будет показано сообщение об ошибке.

Для разработчиков

Если вы хотите создать форк этого проекта, вас может заинтересовать автоматическая сборка пакетов .zip|.crx|.xpi, верно? Хорошо, самый простой способ сделать это — с помощью инструмента командной строки web-ext Mozilla или, в случае Chrome | Opera, с помощью инструмента командной строки crxmake Chrome.

Команды сборки могут быть инкапсулированы в сценарий оболочки Bourne (который обычно работает в Unix-подобных системах):

 #! /bin/bash

EXT_NAME=ebay_purchase_report_history
EXT_PATH= ${0 %/* } # ;-)
EXT_SRC= $EXT_PATH /src/extension
EXT_DIST= $EXT_PATH /dist
EXT_VER= $( cat $EXT_SRC /manifest.json | grep ' "version" ' | grep -Eow " [0-9.]+ " )

web-ext -s $EXT_SRC -a $EXT_DIST --api-key= < your-addons.mozilla.org-api-key > --api-secret= < your-addons.mozilla.org-api-secret > --id= < your-addons.mozilla.org-api-UUID > sign

crxmake --pack-extension= $EXT_SRC --extension-output= $EXT_DIST / $EXT_NAME - $EXT_VER .crx --key-output= $EXT_DIST / $EXT_NAME - $EXT_VER .pem

Обратите внимание, что в случае Firefox вам следует:

1. сгенерируйте свой ключ API Mozilla (см. --api-key и --api-secret )
2. отправьте вручную только один раз разветвленное дополнение в надстройки Mozilla, также известное как AMO, возьмите недавно сгенерированный UUID дополнения и используйте его в приведенном выше сценарии.

Подробнее читайте на AMO и/или в Google.

Документация

Исходные файлы JavaScript аннотируются в соответствии со спецификацией JSDoc, поэтому исходную документацию можно создавать «на лету» с помощью инструмента {@link http://usejsdoc.org/|JSDoc}.

Чтобы создать документацию JSDoc, вам следует выполнить следующие шаги. Если вы хотите использовать шаблон JSDoc по умолчанию, пропустите шаг (1) ниже.

1. установите предпочитаемый вами JSDoc {@link http://bfy.tw/ABvL|template} (например, npm install {@link https://www.npmjs.com/package/interledger-jsdoc-template|minami} )

• убедитесь, что вы обновили свойство opts.template , указав путь к установленному шаблону JSDoc в файле conf.json проекта.

2. выполните на терминале следующую команду: jsdoc -c path-to-conf.json

• это создаст папку jsdoc , которая будет содержать автоматически созданную документацию JSDoc для исходных файлов JavaScript.

Что дальше

1. Сделайте так, чтобы это работало также для Unpaid items , Canceled items , Canceled invoices и списков истории покупок Returns and canceled orders .