ebay purchase report

eBay 购买报告

生成紧凑的 eBay 购买历史报告的 Web 扩展

当您有大量购买并且您有兴趣查看一个紧凑的分组列表，其中包含您所购买的商品、花费了多少、已发货或未发货等的紧凑分组列表时，eBay 购买历史记录看起来并不友好。通过遍历页面的 DOM 并收集这些信息并最终在浏览器的控制台打印出报告来生成。

该项目提供了一个 Firefox|Chrome|Opera Web Extension（附加组件）来帮助生成此类报告。该报告以 HTML 文档形式在新选项卡中生成。

要求

在 Linux 上使用 Firefox 45+、Chrome 55+、Opera 36+ 进行测试。它应该也可以在 Windows 或 MacOS 上运行。尚未在 Microsoft Edge、Android 或 iPhone 上构建/测试，但谁知道呢，它可能会起作用:-)

附加组件的权限

该插件的某些功能使用某些 API，因此需要一定的安装权限。以下是这些权限的列表及其原因：

• 访问您在.ebay.com/上的数据

• 嗯，这很明显，不是吗？

• 下载文件并读取和修改浏览器的下载历史记录

• 实际上，我们仅使用下载功能来确保您可以将报告数据导出为 CSV|JSON|XML 格式并下载它

• 访问浏览器选项卡：

• 由于报告已加载到新选项卡中，因此需要访问选项卡。此外，打开项目详细信息页面也需要此权限。

通常，当您安装附加组件时，您不会为此烦恼，不是吗？如果你现在知道了:-)

安装附加组件

user方式：

• 对于 Firefox 浏览器，请使用 Mozilla 的“添加到 Firefox”按钮。
• 对于 Chrome，请使用 Google 的“添加到 Chrome”按钮。

如果您想安装/测试某个版本，请转到 dist 文件夹并下载并安装适合您的版本：

1. 从 dist 文件夹下载 .zip 附加文件。
2. 打开浏览器工具-> Extension | Add-ons菜单
   • 在 Firefox 的右上角（靠近Search add-on ）有一个tools下拉按钮。单击该按钮并选择Install Add-on From File 。选择步骤(1)中下载的文件
   • 在 Chrome|Opera 上，只需将在 (1) 下载的 .zip 文件拖放到Extension列表上即可。它会自动建议您Drop to install

developer方式：

• 查看源代码，自己构建包，然后继续阅读How to use it 。

如何使用

1. 打开 eBay 页面并使用您的 eBay 帐户登录
2. 转到我的 eBay -> Purchase history菜单
3. 页面加载时，您会注意到“订单”组框中有一个金色的Quick Report按钮：
4. 单击Quick Report按钮。将打开一个新选项卡，其中包含您的 eBay 购买历史记录的紧凑 HTML 报告：

请注意，报告将仅包含可见项目。例如，如果您选择Orders per page ，则报告将仅包含这些订单。要包含整个历史记录，请确保选择可用的最大Orders per page选项（例如 100）。

显示的列

默认情况下，报告将包括以下列：

• # ：报告行的索引
• 卖家： eBay 卖家的 ID
• 购买日期：eBay Order date信息
• 商品价格：eBay Item price值
• 数量：该商品的 eBay 数量
• 运输状态：eBay 订单的商品运输状态
• 预计交货：eBay 订单商品的Estimated delivery日期（如果有）
• 商品描述：购买历史记录中显示的 eBay 订单的商品描述

默认情况下，报表将为每个日期/货币值生成组页脚小计。该组页脚显示组内的商品数量、总金额、已发货/未发货的数量以及每件商品的平均价格。该报告还将打印整个报告的总计。

从 v1.0.7 开始，当鼠标移到项目上时，它还会显示项目的缩略图:-)

排序顺序

默认情况下，报告是使用所购商品的自然顺序生成的。如果您想按给定列对报告进行排序，请单击列名称附近显示的箭头图标。它既适用于上升也适用于下降。

导出数据

该报告允许您将其数据集导出为制表符分隔的 JSON 和 XML 格式。只需使用报告文档上显示的链接即可。

买者自负

1. 由于该附加组件会迭代当前显示的订单商品，因此报告将准确包含您在当前eBay Purchase History页面中看到的商品。
2. 如果您想打开某个项目的详细信息页面，只需单击该项目即可。该插件将模拟 eBay 购买历史页面中相应商品的点击。
3. 与报告交互（排序、打开商品详细信息等）时，请确保不要关闭 eBay 购买历史记录选项卡/页面，否则将显示错误消息。

对于开发人员

如果您想分叉这个项目，那么您可能会对自动构建 .zip|.crx|.xpi 包感兴趣，对吧？好的，最简单的方法是通过 Mozilla 的 web-ext 命令行工具，或者对于 Chrome|Opera，通过 Chrome 的 crxmake 命令行工具。

构建命令可以封装在 Bourne shell 脚本中（通常在类 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. 生成您的 Mozilla API 密钥（请参阅--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} ）

• 确保使用项目的conf.json文件中已安装的 JSDoc 模板的路径更新opts.template属性

2. 在终端运行以下命令： jsdoc -c path-to-conf.json

• 这将创建一个jsdoc文件夹，其中包含自动生成的 JavaScript 源文件的 JSDoc 文档

下一步是什么

1. 使其也适用于Unpaid items 、 Canceled items 、 Canceled invoices以及Returns and canceled orders购买历史记录列表。