قیمت سنج (Gheymatsanj) - WordPress Plugin

پلاگین وردپرس برای جستجو و مقایسه قیمت محصولات از طریق API ترب

ویژگی‌ها

• جستجوی محصولات از طریق API ترب
• تنظیمات کامل جستجو (شهر، نوع فروشگاه، مرتب‌سازی)
• پردازش غیرهمزمان جستجوها
• ذخیره نتایج در دیتابیس
• رابط کاربری فارسی
• پشتیبانی از صفحه‌بندی
• پاکسازی خودکار داده‌های قدیمی

نصب

1. فایل‌های پلاگین را در پوشه /wp-content/plugins/gheymatsanj/ قرار دهید
2. از بخش پلاگین‌های وردپرس، پلاگین را فعال کنید
3. جداول دیتابیس به صورت خودکار ایجاد می‌شوند

استفاده

پنل مدیریت

1. به منوی قیمت سنج در پنل مدیریت بروید
2. برای جستجوی جدید، روی جستجوی جدید کلیک کنید
3. فرم جستجو را پر کرده و شروع جستجو را بزنید
4. منتظر تکمیل پردازش بمانید
5. نتایج را در صفحه لیست جستجوها مشاهده کنید

تنظیمات جستجو

• کلمه کلیدی: نام محصول یا کلمه کلیدی مورد نظر
• شهر: شهر مورد نظر برای جستجو (پیش‌فرض: اصفهان)
• نوع فروشگاه: حضوری، آنلاین یا همه
• مرتب‌سازی: بر اساس قیمت، محبوبیت یا تاریخ
• تعداد نتایج: 5 تا 50 محصول

ساختار فایل‌ها

gheymatsanj/
├── gheymatsanj.php (فایل اصلی پلاگین)
├── includes/
│   ├── class-gheymatsanj.php (کلاس اصلی)
│   ├── class-gheymatsanj-activator.php (فعال‌ساز)
│   ├── class-gheymatsanj-deactivator.php (غیرفعال‌ساز)
│   ├── class-gheymatsanj-loader.php (بارگذاری هوک‌ها)
│   ├── class-gheymatsanj-i18n.php (چندزبانه)
│   ├── class-gheymatsanj-api.php (مدیریت API)
│   ├── class-gheymatsanj-database.php (عملیات دیتابیس)
│   └── class-gheymatsanj-cron.php (پردازش غیرهمزمان)
├── admin/
│   ├── class-gheymatsanj-admin.php (بخش مدیریت)
│   ├── css/gheymatsanj-admin.css
│   ├── js/gheymatsanj-admin.js
│   └── partials/
│       ├── gheymatsanj-admin-display.php
│       ├── gheymatsanj-new-search.php
│       └── gheymatsanj-searches-list.php
├── public/
│   ├── class-gheymatsanj-public.php (بخش عمومی)
│   ├── css/gheymatsanj-public.css
│   └── js/gheymatsanj-public.js
└── README.md

جداول دیتابیس

wp_gheymatsanj_searches

جدول ذخیره اطلاعات جستجوها

ستون	نوع	شرح
id	mediumint(9)	شناسه یکتا
query	varchar(255)	کلمه کلیدی جستجو
city	varchar(100)	شهر
shop_type	varchar(20)	نوع فروشگاه
sort_by	varchar(20)	نوع مرتب‌سازی
page_limit	int(11)	تعداد نتایج
status	varchar(20)	وضعیت (pending/processing/completed/failed)
created_at	datetime	تاریخ ایجاد
updated_at	datetime	تاریخ به‌روزرسانی

wp_gheymatsanj_products

جدول ذخیره نتایج محصولات

ستون	نوع	شرح
id	mediumint(9)	شناسه یکتا
search_id	mediumint(9)	شناسه جستجو
product_key	varchar(255)	کلید یکتای محصول
name1	varchar(255)	نام اصلی محصول
name2	varchar(255)	نام فرعی محصول
price	int(11)	قیمت (به تومان)
price_text	varchar(100)	متن قیمت
shop_text	varchar(255)	نام فروشگاه
image_url	text	لینک تصویر
more_info_url	text	لینک اطلاعات بیشتر
web_client_url	text	لینک صفحه محصول
stock_status	varchar(50)	وضعیت موجودی
created_at	datetime	تاریخ ایجاد

API ترب

پلاگین از API زیر استفاده می‌کند:

https://api.torob.com/v4/base-product/search/

پارامترهای قابل استفاده:

• q: کلمه کلیدی جستجو
• city: نام شهر (انگلیسی)
• shop_type: نوع فروشگاه (offline/online/empty)
• sort: نوع مرتب‌سازی (price/-price//-date)
• page: شماره صفحه
• limit: تعداد نتایج در هر صفحه

Cron Jobs

gheymatsanj_process_search

پردازش جستجوهای جدید به صورت غیرهمزمان

gheymatsanj_cleanup_old_searches

پاکسازی روزانه جستجوهای بیشتر از 30 روز گذشته

کلاس‌های اصلی

Gheymatsanj_API

مدیریت ارتباط با API ترب و پردازش نتایج

Gheymatsanj_Database

عملیات دیتابیس (ایجاد، خواندن، به‌روزرسانی، حذف)

Gheymatsanj_Cron

پردازش غیرهمزمان جستجوها

Gheymatsanj_Admin

مدیریت رابط کاربری بخش ادمین

امنیت

• استفاده از nonce برای تأیید درخواست‌ها
• اعتبارسنجی و sanitize کردن تمام ورودی‌ها
• بررسی مجوزهای کاربر
• escape کردن خروجی‌ها

نیازمندی‌ها

• WordPress 5.0 یا بالاتر
• PHP 7.4 یا بالاتر
• دسترسی به اینترنت برای API calls

مجوز

این پلاگین تحت مجوز GPL v2 یا بالاتر منتشر شده است.

پشتیبانی

برای گزارش مشکلات یا درخواست ویژگی‌های جدید، لطفاً با توسعه‌دهنده تماس بگیرید.

تغییرات آینده

• افزودن سایت‌های دیگر علاوه بر ترب
• ایجاد ویجت عمومی
• صادرات نتایج به Excel/CSV
• نمودارهای مقایسه قیمت
• اطلاع‌رسانی تغییر قیمت