=== Yektabot ===
Contributors: yektabot
Tags: woocommerce, product sync, instagram, telegram, automation
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.0.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

اتصال ووکامرس به یکتابات برای همگام‌سازی محصولات و اجرای فرایند کامل فروش خودکار در اینستاگرام، تلگرام و پیام‌رسان بله.

== Description ==

افزونه یکتابات فروشگاه ووکامرسی شما را به سرویس یکتابات متصل می‌کند تا فرایند کامل فروش خودکار از طریق گفت‌وگو را در اینستاگرام، تلگرام و پیام‌رسان بله راه‌اندازی کنید.

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

امکانات:

* اتصال فروشگاه ووکامرسی به حساب یکتابات.
* همگام‌سازی خودکار محصولات جدید و تغییرات یا حذف محصولات.
* انتقال محصولات موجود فروشگاه با همگام‌سازی کامل.
* مشاهده وضعیت اتصال و فعالیت‌های همگام‌سازی در پیشخوان وردپرس.
* اتصال مسیرهای پرداخت پشتیبانی‌شده به فرایند فروش یکتابات.
* مدیریت اتصال فروشگاه از پیشخوان افزونه.

برای شروع، ووکامرس را فعال کنید، افزونه را به حساب یکتابات متصل کنید و کانال‌های اینستاگرام، تلگرام یا بله را در پنل یکتابات تنظیم کنید.

== Installation ==

1. ووکامرس را نصب و فعال کنید.
2. پوشه yektabot را در /wp-content/plugins/ بارگذاری کنید، یا ZIP افزونه را از افزونه‌ها ← افزودن ← بارگذاری افزونه نصب کنید.
3. یکتابات را فعال و صفحه آن را در فهرست مدیریت وردپرس باز کنید.
4. توضیحات اتصال و اشتراک‌گذاری داده‌ها را بخوانید و سپس اتصال را آغاز کنید.
5. وارد یکتابات شوید، حساب موردنظر را برای اتصال انتخاب کنید و به وردپرس بازگردید.
6. وضعیت اتصال را بررسی کنید. اگر می‌خواهید کاتالوگ موجود را بفرستید، همگام‌سازی کامل محصولات را آغاز کنید.
7. اگر به مسیر پرداخت نیاز دارید، یک حساب پذیرندگی پشتیبانی‌شده را در ووکامرس تنظیم کنید و تنظیمات پرداخت یکتابات را بررسی کنید.

== Frequently Asked Questions ==

= آیا این افزونه بدون ووکامرس کار می‌کند؟ =

خیر. افزونه برای همگام‌سازی محصولات ووکامرس طراحی شده و از REST API و سامانه وبهوک ووکامرس استفاده می‌کند.

= آیا به حساب یکتابات نیاز دارم؟ =

بله. نصب ووکامرس و داشتن حساب سرویس آنلاین یکتابات ضروری است. افزونه رایگان است؛ استفاده از سرویس ممکن است به اشتراک پولی نیاز داشته باشد. وب‌سایت: https://yektabot.com/ . ساخت حساب: https://app.yektabot.com/ . تعرفه‌ها: https://yektabot.com/prices .

= اتصال از چه دسترسی‌هایی استفاده می‌کند؟ =

فرایند اتصال یک کلید REST API ووکامرس با دسترسی خواندن و نوشتن می‌سازد و consumer key و consumer secret آن را از طریق HTTPS برای مدیریت محصولات و سفارش‌ها با یکتابات به اشتراک می‌گذارد. این دسترسی شامل اطلاعات مشتریان و سفارش‌های در دسترس از API ووکامرس نیز می‌شود. می‌توانید کلید را از ووکامرس ← تنظیمات ← پیشرفته ← REST API لغو کنید.

= چه داده‌هایی با یکتابات به اشتراک گذاشته می‌شود؟ =

ارتباط افزونه با app.yektabot.com پس از اقدام صریح مدیر برای اتصال فروشگاه آغاز می‌شود. در فرایند اتصال، نشانی فروشگاه و بازگشت، مقدار موقت اعتبارسنجی، اطلاعات حساب انتخاب‌شده و کلیدهای API ووکامرس که در پاسخ قبلی توضیح داده شد ارسال می‌شوند. هنگام اتصال، قطع اتصال و ذخیره تنظیمات پرداخت، شناسه حساب و اتصال، نسخه افزونه، نشانی فروشگاه، نام درگاه‌ها، وضعیت فعال بودن پرداخت و نشانی بازگشت نیز برای هماهنگ‌سازی تنظیمات سرویس فرستاده می‌شوند.

پس از اتصال، ایجاد، ویرایش یا حذف محصول باعث ارسال اطلاعات آن به وبهوک یکتابات می‌شود. همگام‌سازی کامل محصولات با درخواست مدیر آغاز می‌شود. داده‌ها شامل محصولات منتشرنشده، شناسه، نام، توضیحات، شناسه کالا، قیمت، موجودی، دسته‌بندی‌ها، ویژگی‌ها، متغیرها و نشانی تصاویر است. بررسی اتصال و گزارش پیشرفت همگام‌سازی نیز با سرویس ارتباط دارند.

هنگام فعال بودن و استفاده از مسیر پرداخت اختیاری، توکن امضاشده پرداخت، نتیجه، نام درگاه، شناسه پرداخت و جزئیات تأیید برای به‌روزرسانی سفارش مرتبط به یکتابات فرستاده می‌شوند. گزارش فعالیت‌ها در پایگاه داده وردپرس ذخیره می‌شود و از صفحه افزونه قابل پاک‌کردن است.

شرایط استفاده و حریم خصوصی یکتابات: https://yektabot.com/terms

= سرویس‌های پرداخت اختیاری چگونه کار می‌کنند؟ =

ارتباط با سرویس پرداخت فقط هنگام انتخاب و استفاده از درگاه مربوط انجام می‌شود. اطلاعات پذیرندگی از تنظیمات موجود درگاه ووکامرس خوانده می‌شود. حساب پذیرندگی لازم است و کارمزدها و شرایط درگاه از افزونه جدا هستند.

زرین‌پال: ایجاد و تأیید پرداخت از طریق api.zarinpal.com انجام می‌شود و مشتری برای پرداخت به https://www.zarinpal.com/ هدایت می‌شود. درخواست شامل شناسه پذیرنده، مبلغ، نشانی بازگشت، توضیح سفارش و در صورت وجود در درخواست امضاشده، شماره موبایل مشتری است. تأیید پرداخت با شناسه پذیرنده، شناسه پرداخت و مبلغ انجام می‌شود. قوانین: https://www.zarinpal.com/terms . حریم خصوصی: https://www.zarinpal.com/policy .

زیبال: ایجاد و تأیید پرداخت و هدایت مشتری برای پرداخت از طریق gateway.zibal.ir انجام می‌شود. درخواست شامل اطلاعات پذیرندگی، مبلغ و نشانی بازگشت است؛ تأیید با اطلاعات پذیرندگی و شناسه پیگیری پرداخت انجام می‌شود. وب‌سایت: https://zibal.ir/ . حریم خصوصی: https://zibal.ir/privacy-policy .

= چگونه همگام‌سازی را متوقف کنم؟ =

از گزینه قطع اتصال در صفحه افزونه یکتابات استفاده کنید و اگر کلید REST API یکتابات همچنان در فهرست ووکامرس باقی مانده، آن را لغو کنید. می‌توانید افزونه را نیز غیرفعال کنید. غیرفعال‌سازی، درخواست حذف داده‌های از قبل ذخیره‌شده در سرویس بیرونی را ارسال نمی‌کند؛ برای چنین درخواست‌هایی با یکتابات تماس بگیرید.

= آیا حساب درگاه پرداخت همراه افزونه ارائه می‌شود؟ =

خیر. درگاه‌های پرداخت سرویس‌های بیرونی اختیاری هستند. به حساب پذیرندگی پشتیبانی‌شده خودتان و تنظیمات درگاه نیاز دارید. کارمزد تراکنش‌ها و شرایط سرویس درگاه از این افزونه جدا است.

= از کجا پشتیبانی بگیرم؟ =

به https://yektabot.com/contact مراجعه کنید. برای درخواست‌های مربوط به حساب سرویس و حریم خصوصی، از طریق همین صفحه با تیم پشتیبانی یکتابات تماس بگیرید.

== Changelog ==

= 2.0.7 =
* بارگذاری فایل‌های محلی مدیریت و پرداخت از طریق APIهای enqueue وردپرس.
* نگهداری اطلاعات Tested up to فقط در فایل readme.
* افزودن بررسی کلید سری و سطح دسترسی به مسیر بازگشت اتصال حساب.

= 2.0.6 =
* آماده‌سازی بسته افزونه و مستندات سرویس برای بررسی WordPress.org.
* حذف آمارگیری خودکار نصب و محدودیت‌های بیرونی نویسنده و مجوز بر قابلیت‌های محلی افزونه.
* جایگزینی منابع بیرونی ظاهر مدیریت با سبک‌های محلی وردپرس.
* توضیح دسترسی‌های اتصال و اشتراک‌گذاری داده‌ها پیش از اتصال فروشگاه.

= 2.0.5 =
* نسخه موجود یکتابات که مبنای ارسال به WordPress.org قرار گرفت.

== Upgrade Notice ==

= 2.0.7 =
هر اتصال حسابی را که پیش از ارتقا آغاز شده و هنوز کامل نشده است، دوباره شروع کنید. این نسخه بارگذاری فایل‌های ظاهری و اسکریپت‌ها، اطلاعات سازگاری و بررسی‌های مسیر بازگشت اتصال را به‌روز می‌کند.
