=== Yektabot ===
Contributors: yektabot
Tags: woocommerce, product sync, instagram, telegram, automation
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 3.1.2
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 .

= انتخاب و اتصال محصولات چگونه انجام می‌شود؟ =

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

= هنگام ارتقا از نسخه ۲.۰.۷ چه چیزی تغییر می‌کند؟ =

PHP نسخه ۸٫۱ یا بالاتر لازم است. تنظیمات اتصال فروشگاه حفظ می‌شود، اما برای ادامه همگام‌سازی باید محصولات را با ابزارهای جدید اتصال محصول انتخاب و متصل کنید. پس از ارتقا، وضعیت اتصال محصولات را بررسی کنید.

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

فرایند اتصال یک کلید 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 یکتابات همچنان در فهرست ووکامرس باقی مانده، آن را لغو کنید. می‌توانید افزونه را نیز غیرفعال کنید. غیرفعال‌سازی، درخواست حذف داده‌های از قبل ذخیره‌شده در سرویس بیرونی را ارسال نمی‌کند؛ برای چنین درخواست‌هایی با یکتابات تماس بگیرید.

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

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

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

نویسنده: YektaBot. ایمیل: info@yektabot.com. برای پشتیبانی و درخواست‌های مربوط به حساب سرویس و حریم خصوصی به https://yektabot.com/contact مراجعه کنید.

== Changelog ==

= 3.1.2 =
* اصلاح عرض ستون یکتابات در فهرست محصولات و جلوگیری از متن عمودی و هم‌پوشانی با دسته‌بندی‌ها.
* افزودن ابزارهای اتصال تکی و چندمحصولی، اتصال پیش‌نویس پس از انتشار و تشخیص تغییر ساختار محصول.
* همگام‌سازی دوطرفه قیمت و موجودی محصولات متصل. نیازمند PHP نسخه ۸٫۱ یا بالاتر.
* حفظ اصلاحات نسخه مخزن وردپرس برای رضایت پیش از اتصال و بارگذاری محلی فایل‌های ظاهری و اسکریپت‌ها.
* اعتبارسنجی به‌روزرسانی‌های ورودی محصولات و متغیرها و حفظ اعشار قیمت‌ها.

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

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

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

== Upgrade Notice ==

= 3.1.2 =
PHP نسخه ۸٫۱ یا بالاتر لازم است. تنظیمات اتصال فروشگاه حفظ می‌شود، اما برای ادامه همگام‌سازی باید محصولات را با ابزارهای جدید اتصال محصول انتخاب و متصل کنید. پس از ارتقا، وضعیت اتصال محصولات را بررسی کنید.
