ebay purchase report

تقرير شراء موقع ئي باي

ملحق ويب يُنشئ تقريرًا مضغوطًا عن تاريخ الشراء على موقع eBay

لا يبدو سجل الشراء على موقع eBay سهلاً عندما يكون لديك عدد كبير من المشتريات وتكون مهتمًا برؤية قائمة مجمعة مدمجة لما اشتريته، وكم تكلفته، وعدد الشحنات التي تم شحنها أم لا، وما إلى ذلك. يمكن بسهولة إنشاء مثل هذه القائمة يتم إنشاؤها عن طريق اجتياز DOM الخاص بالصفحة وجمع هذه المعلومات وطباعة تقرير في النهاية على وحدة تحكم المتصفح.

يوفر هذا المشروع ملحق Firefox|Chrome|Opera Web Extension (وظيفة إضافية) يساعد في إنشاء مثل هذا التقرير. يتم إنشاء التقرير في علامة تبويب جديدة كمستند HTML.

متطلبات

تم اختباره على Linux مع Firefox 45+، Chrome 55+، Opera 36+. يجب أن يعمل أيضًا على نظام التشغيل Windows أو MacOS. لم يتم تصميمه/اختباره على Microsoft Edge أو Android أو iPhone ولكن من يدري، ربما يعمل :-)

أذونات الوظيفة الإضافية

تستخدم بعض وظائف هذه الوظيفة الإضافية واجهات برمجة تطبيقات معينة، وبالتالي تتطلب أذونات معينة للتثبيت. فيما يلي قائمة بهذه الأذونات وسببها:

• الوصول إلى البيانات الخاصة بك على .ebay.com/

• حسنا هذا واضح، أليس كذلك؟

• تنزيل الملفات وقراءة وتعديل سجل تنزيل المتصفح

• في الواقع، نحن نستخدم فقط وظيفة التنزيل للتأكد من أنه يمكنك تصدير بيانات التقرير إلى تنسيق CSV|JSON|XML ومع ذلك يمكنك تنزيلها

• الوصول إلى علامات تبويب المتصفح:

• نظرًا لأنه تم تحميل التقرير في علامة تبويب جديدة، يلزم الوصول إلى علامات التبويب. علاوة على ذلك، فإن فتح صفحة تفاصيل العنصر سيتطلب أيضًا هذا الإذن أيضًا.

عادة لا تهتم بهذا عند تثبيت وظيفة إضافية، أليس كذلك؟ إذا كنت تفعل ذلك الآن فأنت تعرف ذلك :-)

قم بتثبيت الوظيفة الإضافية

طريقة user :

• بالنسبة لمتصفحات Firefox، استخدم زر Mozilla's Add to Firefox.
• بالنسبة لمتصفح Chrome، استخدم زر Google ADD TO 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. انتقل إلى My 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
• التسليم المقدر: تاريخ Estimated delivery لعنصر طلب eBay، إذا كان متاحًا
• وصف العنصر: وصف عنصر طلب 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 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} )

• تأكد من تحديث خاصية 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 .