Description
افزونه رسمی فروشگاه، فروشگاه WooCommerce شما را به Foroshgah.org، سرویس جست‌وجوی محصول و مقایسه قیمت، متصل می‌کند و امکان همگام‌سازی امن اطلاعات محصولات، قیمت، موجودی، تصاویر و کاتالوگ فروشگاه را فراهم می‌سازد.
مدیر فروشگاه با وارد کردن یک کد اتصال یک‌بار مصرف از سرویس فروشگاه، اتصال را تأیید می‌کند. پس از اتصال، افزونه ابتدا یک همگام‌سازی کامل از محصولات انجام داده و سپس تغییرات محصولات را به‌صورت خودکار ارسال می‌کند.
این افزونه برای همگام‌سازی کاتالوگ عمومی محصولات طراحی شده است. محصولات پیش‌نویس، در انتظار بررسی، خصوصی و محصولاتی که در کاتالوگ نمایش داده نمی‌شوند، به‌عنوان اطلاعات کامل کاتالوگ ارسال نخواهند شد. اگر محصولی که قبلاً عمومی بوده از حالت عمومی خارج شود، افزونه فقط اطلاعات شناسایی لازم را برای حذف آن از کاتالوگ ارسال می‌کند.
ویژگی‌ها:
- اتصال یک‌بار مصرف و امن به سرویس فروشگاه.
- همگام‌سازی اولیه و دستی محصولات و متغیرهای عمومی WooCommerce.
- ارسال تغییرات محصول، قیمت، موجودی، وضعیت و حذف محصولات.
- مدیریت صف ارسال اطلاعات با قابلیت تلاش مجدد محدود و مدیریت خطا.
- پشتیبانی از Action Scheduler همراه با امکان استفاده از WP-Cron.
- امضای امن درخواست‌ها و ذخیره رمزگذاری‌شده اطلاعات اتصال.
- حذف اطلاعات ارسال‌شده پس از تحویل موفق برای کاهش نگهداری اطلاعات محلی.
WooCommerce نسخه 8.0 یا بالاتر مورد نیاز است.
External Service
این افزونه برای همگام‌سازی اطلاعات کاتالوگ فروشگاه به سرویس خارجی Foroshgah.org متصل می‌شود. این سرویس از طریق آدرس زیر استفاده می‌شود:
https://foroshgah.org/
در نصب جدید، فعال‌سازی افزونه به‌تنهایی باعث اتصال فروشگاه یا ارسال اطلاعات کاتالوگ نمی‌شود. ارتباط با سرویس خارجی فقط پس از وارد کردن کد اتصال یک‌بار مصرف توسط مدیر فروشگاه و تأیید اتصال آغاز می‌شود.
در زمان اتصال اولیه، افزونه اطلاعات زیر را ارسال می‌کند:
- کد اتصال یک‌بار مصرف.
- آدرس سایت فروشگاه.
- نسخه افزونه.
- نسخه وردپرس.
- نسخه WooCommerce.
پس از اتصال، افزونه اطلاعات عمومی محصولات و متغیرهای قابل ارسال را شامل موارد زیر ارسال می‌کند:
- شناسه محصول و محصول والد.
- SKU محصول.
- نوع محصول و عنوان.
- توضیح کوتاه.
- آدرس محصول.
- وضعیت انتشار و فعال بودن محصول.
- قیمت فعلی، قیمت اصلی، قیمت فروش و واحد پول.
- وضعیت موجودی، مدیریت موجودی و مقدار موجودی.
- آدرس تصاویر اصلی و تصاویر گالری.
- دسته‌بندی‌ها و برچسب‌ها.
- برند.
- GTIN، EAN، UPC، بارکد و MPN در صورت وجود.
- ویژگی‌های محصول و متغیرها.
- وزن و ابعاد.
- متن گارانتی در صورت ثبت در ویژگی‌های محصول.
- تاریخ ایجاد و آخرین تغییرات.
برای درخواست‌های احراز هویت‌شده API، افزونه همچنین شناسه اتصال، توکن اتصال، زمان درخواست، شناسه درخواست یا رویداد و امضای HMAC را در هدرهای HTTP ارسال می‌کند.
این افزونه به‌صورت عمدی اطلاعات سفارش‌های WooCommerce، اطلاعات مشتریان، آدرس مشتریان، اطلاعات پرداخت، رمزهای مدیر سایت، رمزهای برنامه، کلیدهای REST API ووکامرس یا فایل‌های قابل دانلود را ارسال نمی‌کند.
اگر محصول یا متغیری که قبلاً عمومی بوده حذف شود یا دیگر عمومی نباشد، رویداد حذف فقط شامل اطلاعات شناسایی لازم خواهد بود.
سیاست حریم خصوصی Foroshgah.org:
https://foroshgah.org/privacy
شرایط استفاده Foroshgah.org:
https://foroshgah.org/terms
Privacy
The plugin adds suggested privacy-policy text to WordPress’s Privacy Policy Guide. Store operators should review that text together with the Foroshgah.org privacy policy and their own legal requirements before connecting the service.
Privacy policy: https://foroshgah.org/privacy
Terms of use: https://foroshgah.org/terms
Installation
- افزونه را از طریق پیشخوان وردپرس نصب کنید:
مسیر: افزونه‌ها افزودن بارگذاری افزونه
یا فایل افزونه را به‌صورت دستی در مسیر زیر قرار دهید:
/wp-content/plugins/ - پس از نصب، افزونه را از بخش «افزونه‌ها» فعال کنید.
- پس از فعال‌سازی، از بخش «فروشگاه» وارد تنظیمات افزونه شوید.
- کد اتصال یک‌بار مصرف را از پنل فروشگاه دریافت کرده و در افزونه وارد کنید.
- پس از برقراری اتصال، اطلاعات محصولات، قیمت، موجودی و تغییرات فروشگاه به‌صورت خودکار همگام‌سازی خواهد شد.
- در اولین اتصال، منتظر بمانید تا فرآیند همگام‌سازی اولیه محصولات به پایان برسد.
The site must use HTTPS. PHP must provide either Sodium or OpenSSL AES-256-GCM support so the connection token can be stored with authenticated encryption.
FAQ
-
Does the plugin send data immediately after activation?
-
On a fresh installation, no catalog transmission starts until an authorized store administrator explicitly connects the store with a one-time pairing code. If a previously connected installation is reactivated, previously authorized background delivery may resume until the integration is disconnected.
-
Are draft or private products sent to Foroshgah.org?
-
No. Draft, pending, private, and catalog-hidden products are not sent as full catalog payloads. If a product that was previously public becomes non-public, a deletion event containing only identifiers may be sent so it can be removed from the remote catalog.
-
Does the plugin send customer or order information?
-
No. The integration is for product catalog synchronization and does not intentionally transmit WooCommerce orders, customer records, customer addresses, payment data, or administrator credentials.
-
What happens to product payloads stored locally?
-
Pending and retryable messages are kept in the plugin-owned outbox until delivery succeeds or the retry limit is reached. After successful delivery, the stored payload body is cleared while minimal delivery metadata remains until the administrator clears successful history or uninstalls the plugin.
-
How do I stop synchronization?
-
Use the Disconnect action on the plugin page. This removes the local connection credential and stops authenticated catalog delivery. If the remote connection also needs to be revoked, revoke it from the Foroshgah seller service.
-
What happens on uninstall?
-
Uninstall removes plugin-owned options, scheduled jobs, local connection credentials, and the plugin outbox table. It does not delete or modify WooCommerce products, orders, customers, or WooCommerce settings.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Foroshgah – افزونه رسمی فروشگاه” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Foroshgah – افزونه رسمی فروشگاه” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.2.21
- Cleaned up internal legacy CompareHub implementation identifiers without changing persisted scheduler hooks or the external API contract.
- Added backward-compatible migration for legacy connection settings.
- Preserved existing encrypted connection credentials and synchronization state; administrator re-pairing is not required.
-
Preserved legacy scheduled hooks, external API headers, request signing, and credential encryption behavior.
-
Fixed admin CSS loading by matching the correct top-level menu hook.
0.2.19
- Prepared the package for WordPress.org review.
- Documented the Foroshgah.org external service and exact data scope.
- Added WooCommerce as an explicit plugin dependency in the plugin header.
- Aligned the plugin text domain and package slug.
- Restricted full catalog payloads to published, catalog-visible products and eligible variations.
- Non-public product transitions now emit identifier-only deletion events instead of catalog payloads.
- Added WordPress Privacy Policy Guide content and an explicit connection disclosure.
- Cleared successful outbox payload bodies after delivery to reduce local data retention.
- Completed scheduled-job and pairing-error cleanup during uninstall.
0.2.18
- Added resilient full-sync generation and finalization recovery.
- Improved outbox recovery, retry, and schema diagnostics.
- Added secure one-time pairing and authenticated API transport.