فهرست
• نصب و راه اندازی Install
• تنظیم ارسال پیام از طریق متد ساده Send
• تنظیم ارسال پیام از طریق متد اعتبار سنجی LookUp

آموزش نصب و راه اندازی وب سرویس کاوه نگار روی Woocommerce

1. چگونه افزونه ووکامرس را برای استفاده از وب سرویس کاوه نگار نصب کنیم؟

   1. .ابتدا از طریق منوی " افزونه ها " وارد زیرمنوی "افزودن" میشوید
   2. .سپس در قسمت جستجو عبارت "پیامک" را وارد کنید تا نتایج مربوطه برای شما به نمایش درآیند
   3. آیتم Persian Woocomerce را در بین نتایج مشاهده میکنید، گزینه "هم اکنون نصب کن" را بزنید.
   4. .بعد از نصب شدن، گزینه "فعال نمایید" را بزنید تا ماژول مورد نظر فعال شود
   5. بعد از نصب این افزونه در منوی "ووکامرس فارسی" یک زیرمنو به نام "تنظیمات پیامک" برای شما به نمایش در خواهد آمد.

تنظیم ماژول ووکامرس برای استفاده از متد Send کاوه نگار

1. چگونه ماژول پیامک ووکامرس را برای استفاده از متد Send کاوه نگار تنظیم نماییم؟

   1. با استفاده از مسیر ووکامرس فارسی > تنظمیمات پیامک وارد قسمت تنظیمات ماژول پیامک ووکامرس می شویم.
   2. ابتدا در قسمت "وبسرویس پیامک" پنل "kavenegar.com" را جستجو و سپس انتخاب میکنیم.
   3. در قسمت "نام کاربری وبسرویس" باید کد API_KEY که در قسمت حساب من پنل کاوه نگار وجود دارد را قرار دهید.
   4. قسمت " کلمه عبور وبسرویس " را خالی بگذارید.

   5. نکات:

      در فیلد "شماره ارسال کننده پیامک" شماره ای را وارد نمایید که میخواهید پیام ها از طریق این شماره ارسال شوند.

در صورتی که نیاز به ارسال پیامک به چندین مدیرکل در یک درخواست دارید، باید نسخه موجود در لینک زیر را دانلود نمایید. دانلود افزونه (نسخه نهایی)

تنظیم ماژول ووکامرس برای استفاده از متد اعتبارسنجی (lookup) کاوه نگار

1. چگونه ماژول پیامک ووکامرس را برای استفاده از متد اعتبارسنجی (lookup) کاوه نگار تنظیم نماییم؟

   برای آشنایی بیشتر با نحوه عملکرد متد اعتبارسنجی میتوانید به لینک زیر مراجعه نمایید. مستندات متد اعتبارسنجی

   1. با استفاده از مسیر ووکامرس فارسی > تنظمیمات پیامک وارد قسمت تنظیمات ماژول پیامک ووکامرس می شویم.
   2. ابتدا در قسمت "وبسرویس پیامک" درگاه "Kavenegar.com(lookup)" را جستجو و سپس انتخاب میکنیم.
   3. در قسمت "نام کاربری وبسرویس" باید کد API_KEY که در قسمت حساب من پنل کاوه نگار وجود دارد را قرار دهید.
   4. قسمت " کلمه عبور وبسرویس " را خالی بگذارید.

   5. نکته:

      در فیلد "شماره ارسال کننده پیامک" نیازی به قرار دادن شماره نیست، چون متد اعتبارسنجی ورودی شماره ارسال کننده ندارد و به صورت اتوماتیک سریعترین شماره را جهت ارسال پیام برای شما اختصاص میدهد.
2. چگونه متن پیام را جهت استفاده از متد اعتبارسنجی (lookup) تنظیم کنیم؟

   به عنوان مثال برای زمانی که یک سفارش در سایت ثبت میشود میتوانید یک پیام با ساختار زیر ارسال نمایید.

   سلام مدیر سفارش 1255 ثبت شده است و هم اکنون در وضعیت ثبت سفارش می باشد. تعداد آیتم های سفارش : 6 مبلغ سفارش : 1500000

   1. برای این منظور باید ابتدا یک الگوی اعتبارسنجی در پنل کاوه نگار ایجاد نمایید. ایجاد الگوی اعتبارسنجی
   2. برای اینکه هر token مقدار مورد نظر را از ووکامرس دریافت نماید و هر مقدار در متن الگوی اعتبارسنجی قرار داده شود باید نام شورتکد هر مقدار را در مقابل token مورد نظر قرار دهیم، به مثال زیر توجه نمایید.

مثال:

نام الگوی تایید شده در پنل کاوه نگار:

order

متن الگو (در پنل کاوه نگار):


در این متن سه توکن: token, token2, token3 وجود دارد. به همین علت باید مقدار(شورتکد) هر token را در برابر نام token به علاوه یک علامت "=" قرار دهیم.:

token={order_id}token2={count_items}token3={price}



در مرحله بعد باید نام الگو را به رشته توکن ها اضافه نماییم، برای این منظور باید نام الگو را در مقابل عبارت "=template" در متن پیام قرار دهیم.

نام الگو در پنل کاوه نگار: order
مقدار template= order را به انتهای متن token= {order_id}token2= {count_items}token3= {price} اضافه میکنیم، متن نهایی به صورت زیر می شود.


token={order_id}token2={count_items}token3={price}template=order

نکته:

1. توجه داشته باشید که بعد از نام الگو (در مثال order) هیچ Space(فضای خالی) قرار ندهید.
2. پارامترهایی را در این قسمت قرار دهید که همیشه مقدار دارند و اختیاری نباشند، زمانی که یک شورتکد دارای مقدار نباشد، متن پیام شما ناقص خواهد بود.


در نتیجه بعد از ثبت سفارش، برای مدیر پیام به صورت زیر از طریق خطوط خدماتی ارسال میشود.

سلام مدیر سفارش 1255 ثبت شده است و هم اکنون در وضعیت ثبت سفارش می باشد. تعداد آیتم های سفارش : 6 مبلغ سفارش : 1500000