ebay purchase report

eBay 購買報告

產生緊湊的 eBay 購買歷史報告的 Web 擴展

當您有大量購買並且您有興趣查看一個緊湊的分組列表，其中包含您所購買的商品、花費了多少、已發貨或未發貨等的緊湊分組列表時，eBay 購買歷史記錄看起來並不友善。

該專案提供了一個 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購買記錄清單。