سكربت Python يحوّل ملف منتجاتك إلى CSV لأداة استيراد المنتجات المدمجة في WooCommerce

مثال على النتيجة

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  المجلد: sales/2026-10، عُثر على 9 ملفات
2026-11-02 09:14:03 INFO  shop-01.csv: 1,284 صفًا
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 صفًا
2026-11-02 09:14:04 WARN  shop-07.csv: تُخطّيت 3 صفوف بلا سعر (الأسطر 88، 412، 913)
2026-11-02 09:14:05 INFO  تم: 10,412 صفًا -> report-2026-10.xlsx (الورقتان «المبيعات» و«الإجماليات»)

[columns]
date = التاريخ, تاريخ البيع, اليوم
product = المنتج, الصنف, الاسم
quantity = الكمية, العدد, قطع
price = السعر, سعر الوحدة

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """يقرأ ملف متجر واحد ويمنح أعمدته أسماء أعمدة التقرير."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: لا يوجد عمود لـ «{name}» (جرى البحث عن: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

عن هذه الخدمة

لدى WooCommerce أداة استيراد خاصة بالمنتجات، لكنها تتوقع أعمدتها الخاصة: Type وSKU وName وRegular price وCategories مع > بين المستويات، والصور كروابط، وللملابس أو الخيارات الأخرى منتج رئيسي إضافة إلى صف لكل تنويعة مرتبط عبر Parent. يحوّل سكربت Python هذا قائمة أسعار مورّدك أو تصديرًا من متجر آخر أو جدولك الخاص إلى ذلك الملف. يربط أعمدتك، ويبني الفئات، وبدءًا من الباقة القياسية المنتجات المتغيرة بسمات مثل المقاس واللون، ويسرد الصفوف التي بلا سعر أو SKU أو صورة. يجب أن تكون الصور على روابط يستطيع موقعك تنزيلها. تشغّل أداة الاستيراد في لوحة إدارة WordPress بنفسك؛ ولا نسجّل الدخول إلى موقعك أبدًا. جرّب بضعة منتجات أولًا واحتفظ بنسخة احتياطية من متجرك.

ما المشمول

• ما الذي تحصل عليهأرشيف ZIP يضم سكربت Python وملف README بتعليمات خطوة بخطوة، ومن الباقة القياسية ملف إعدادات بخريطة الأعمدة؛ ويُعرض الكود أيضًا في صفحة الطلب.
• أعمدة WooCommerceكما تتوقعها أداة استيراد المنتجات المدمجة
• تنويعات مرتبطةبدءًا من الباقة القياسية، منتجات رئيسية بمقاسات وألوان
• فئات متداخلةClothes > Women > Dresses، كما يقرؤها WooCommerce
• سرد المشكلاتيُبلَّغ عن الصفوف التي بلا سعر أو SKU أو صورة
• كود مقروءمع تعليقات، ليسهل إضافة عمود لاحقًا

كيف يعمل

1. 1
   الملفاتترسل عينة من ملف منتجاتك وتوضح ما يذهب إلى أين
2. 2
   الكودنكتب السكربت ودليل تشغيله
3. 3
   جرّبهتستورد بضعة منتجات إلى نسخة من متجرك أو موقع تجريبي
4. 4
   التعديلاتتطلب التعديلات ضمن باقتك وترسل أي رسالة خطأ

ما نحتاجه منك

20-30 صفًا من ملف منتجاتك، وكيف تُكتب الخيارات فيه (صف لكل مقاس، أو المقاسات في خلية واحدة)، وشجرة فئاتك، وأين الصور (روابط، أو ملفات موجودة بالفعل في مكتبة وسائط WordPress)، وكيف تُحدد الأسعار. تصدير لبضعة منتجات من متجرك على WooCommerce يساعد على تطابق الأعمدة تمامًا. نظامك: Windows أو macOS أو Linux.

سنسألك:

• ما الملف الذي لديك الآن؟
• هل لمنتجاتك خيارات؟
• ما شجرة فئاتك؟
• أين توجد الصور؟

قارن بين الباقات

الأسئلة والأجوبة

لم تجد إجابتك؟ اسألنا