AliLedger

AliLedger is a Chrome extension + self-hosted web viewer for your AliExpress order history. The extension captures your orders as you browse AliExpress and exports them as a CSV; the web viewer lets you search, filter, and manage them with locally cached product images.

Components

Chrome Extension

Intercepts the AliExpress order API as you browse your order history and collects the results in one click. Features:

• Auto-scrolls through all pages of orders automatically
• Exports to CSV with one click
• Built-in order viewer with search, filters, and pagination
• Filters by order tab (All, To Pay, To Ship, Shipped, Processed)
• Badge shows live order count while collecting

See Extension Setup below.

Web Viewer

A self-hosted PHP/MySQL viewer with image caching, category tagging, status tracking, and rich filtering. For full setup instructions see web/README.md.

Extension Setup

Requirements

• Google Chrome (or any Chromium-based browser)

Install

1. Clone or download this repository.
2. Open chrome://extensions and enable Developer mode.
3. Click Load unpacked and select the extension/ directory.

Usage

1. Go to your AliExpress order history.
2. Click the AliLedger extension icon and hit Start.
3. The extension auto-scrolls through all your orders, collecting as it goes.
4. When complete, click Export CSV to download your order data.
5. Import the CSV into the web viewer, or browse directly in the built-in viewer.

Built-in Viewer

The extension includes a local order viewer (no server required). Import a CSV and you get:

Feature	Description
Order grid	Card view with product images, price, store, status
Search & filters	Full-text search, store, category, date range
Status tracking	Colour-coded status dropdown — changes save locally
Snapshot links	One-click link to the AliExpress order snapshot for any item
Categories	Tag orders with custom categories; filter by them instantly
CSV export	Export your orders (including categories) to share or back up

Categories and status changes are stored in your browser's local storage and survive re-imports. Exporting and re-importing preserves your tags.

Web Viewer

The web viewer is a separate PHP application — see web/README.md for setup, configuration, and usage details.

Feature	Description
Order grid	Card view with product images, price, store, status
Search & filters	Full-text search across titles and attributes
Status tracking	Colour-coded status dropdown — changes save to the database
Snapshot links	One-click link to the AliExpress order snapshot for any item
Image caching	Downloads product images to your server so they don't expire
Categories	Tag orders with custom categories; filter by them instantly
Import / Export	Safe re-import with duplicate detection; categories preserved
Password protection	Optional bcrypt-hashed password for the whole site