راهاندازی اتصال وردپرس
این صفحه مراحل وصل کردن یک سایت وردپرسی به اپ، نصب و تنظیم افزونه اختصاصی و رفع اشکالات رایج را توضیح میدهد.
گام ۱: ثبت سایت در پنل
- اپ خود را در پنل باز کنید.
- به تنظیمات اپ ← اتصال به وردپرس بروید.
- روی افزودن سایت بزنید تا فهرست سایتهای وردپرسی باز شود.
- سایت جدید را انتخاب و دو مقدار را وارد کنید:
- نام سایت: فقط برای شناسایی در پنل.
- آدرس سایت: نشانی کامل با
https://.
- ذخیره کنید و سایت را از فهرست کشویی انتخاب سایت به اپ نسبت دهید.
اگر آدرس سایت را بعداً تغییر دهید، نشانی جدید بهطور خودکار روی دستگاههای نصبشده بهروزرسانی میشود و نیازی به ساخت دوباره اپ نیست.
در فهرست سایتها برای هر ردیف سه ابزار وجود دارد:
| ابزار | کار |
|---|---|
| بررسی اتصال | سایت را صدا میزند و امکانات فعال آن را میخواند |
| کلید اتصال | ساخت یا تعویض کلید اتصال افزونه |
| حذف | حذف سایت از فهرست |
در این مرحله اپ میتواند محتوای عمومی سایت را بخواند. برای قابلیتهای حساب کاربری و فروشگاهی، گامهای بعد لازم است.
گام ۲: نصب افزونه روی سایت
نسخه فعلی افزونه: 0.6.2
دانلود افزونه AppEditor برای وردپرس، نسخه 0.6.2
- فایل ZIP را دانلود کنید و آن را باز یا استخراج نکنید.
- در پیشخوان وردپرس به افزونهها ← افزودن افزونه تازه ← بارگذاری افزونه بروید، همین فایل ZIP را انتخاب و نصب کنید.
- افزونه
AppEditor - App Builder for WordPressرا فعال کنید. - در پیشخوان وردپرس منوی اپ ادیتور ظاهر میشود.
فایل دانلودی ساختار استاندارد وردپرس دارد: در ریشه ZIP فقط پوشه appeditor-app-builder قرار گرفته و فایل اصلی افزونه مستقیماً داخل همان پوشه است.
اگر زبان وردپرس فارسی باشد، منوها، تنظیمات و پیامهای افزونه هم فارسی نمایش داده میشوند.
گام ۳: ساخت کلید اتصال
- در پنل اپ ادیتور، در فهرست سایتهای وردپرسی روی ابزار کلید اتصال بزنید.
- کلید ساختهشده را همان لحظه کپی کنید.
پنل فقط خلاصه درهمسازیشده کلید را نگه میدارد و کلید خام هرگز دوباره نمایش داده نمیشود. اگر آن را گم کنید باید کلید تازه بسازید. ساخت کلید جدید، کلید قبلی را بلافاصله باطل میکند و اپهایی که با کلید قدیمی کار میکردند تا ورود کلید جدید در وردپرس، قطع میشوند.
هر سایت کلید جداگانه خود را دارد.
گام ۴: وارد کردن کلید در وردپرس
- در پیشخوان وردپرس به اپ ادیتور ← تنظیمات بروید.
- نشانی API و کلید اتصال را وارد و ذخیره کنید. مقدار پیشفرض نشانی API معمولاً درست است و نیازی به تغییر ندارد.
- روی آزمایش اتصال بزنید.
اگر همهچیز درست باشد، افزونه اطلاعات حساب شما و فهرست قالبهای آماده فعال را از پنل دریافت میکند و وضعیت اتصال به «متصل» تغییر میکند.
گزینه قطع اتصال در وردپرس، کلید را از سمت سرویس اپ ادیتور هم لغو میکند.
گام ۵: ساخت اپ اولیه از داخل وردپرس (اختیاری)
پس از اتصال موفق، از همان صفحه میتوانید:
- نام اپ را وارد کنید.
- یک قالب آماده انتخاب کنید. قالب فروشگاهی فقط برای سایتی قابل انتخاب است که ووکامرس روی آن فعال باشد.
- خروجیهای هدف (اندروید، وب، ویندوز) را انتخاب کنید.
- اپ اولیه را بسازید.
خروجیهای انتخابی همراه اپ ذخیره میشوند، اما تنظیم نام بسته، پلن، ABI، نوع بسته و شروع هر ساخت از داخل پنل اپ ادیتور انجام میشود.
تنظیمات افزونه
در اپ ادیتور ← تنظیمات این گزینهها در دسترس است:
دسترسی عمومی
| گزینه | پیشفرض | توضیح |
|---|---|---|
| فعال بودن API اپ | فعال | با خاموش کردن آن، همه مسیرهای اختصاصی اپ بسته میشوند |
| اجازه ثبتنام از اپ | غیرفعال | علاوه بر این گزینه، تنظیمات ← عمومی ← عضویت وردپرس نیز باید روشن باشد؛ حساب تازه پیش از ورود باید ایمیلش را تأیید کند |
| مبدأهای مجاز | * | فهرست دامنههای مجاز برای درخواست مستقیم مرورگر (خروجی وب) |
نشست کاربر
| گزینه | پیشفرض | توضیح |
|---|---|---|
| مدت اعتبار توکن دسترسی | ۶۰ دقیقه | پس از آن، اپ خودکار توکن را تازه میکند |
| مدت اعتبار توکن تازهسازی | ۳۰ روز | پس از آن، کاربر باید دوباره وارد شود |
| حداکثر نشست همزمان | ۱۰ | تعداد دستگاههای همزمان هر کاربر |
| سقف تلاش ورود | ۱۰ | محدودسازی تلاشهای ناموفق |
ووکامرس
| گزینه | پیشفرض | توضیح |
|---|---|---|
| فعال بودن امکانات ووکامرس | فعال | با خاموش کردن آن، همه سرویسهای فروشگاهی غیرفعال میشوند |
| علاقهمندیها | فعال | فهرست محصولات مورد علاقه کاربر |
ورود با شماره موبایل
| گزینه | پیشفرض | توضیح |
|---|---|---|
| فعال بودن ورود موبایلی | غیرفعال | — |
| ارائهدهنده | Digits | باید از قبل نصب و آزمایش شده باشد |
| اجازه ثبتنام با موبایل | غیرفعال | علاوه بر این گزینه، عضویت خود وردپرس هم باید باز باشد |
| مدت اعتبار کد | ۵ دقیقه | — |
| فاصله ارسال مجدد | ۶۰ ثانیه | — |
| سقف تلاش تأیید | ۵ | — |
کد یکبارمصرف بهصورت خام در پایگاه داده ذخیره نمیشود.
اعلان فایربیس
- در Firebase یک Service Account با دسترسی ارسال پیام بسازید و فایل JSON آن را دریافت کنید.
- محتوای کامل فایل را در بخش اعلانهای فایربیس جایگذاری و گزینه فعالسازی را روشن کنید.
- برای اعلان خودکار سفارش، وضعیتهای موردنظر مانند
processing,completedرا مشخص کنید. - عنوان و متن را با جایگزینهای
{site_name}،{order_number}،{status}و{total}تنظیم کنید. - از صفحه اعلانها میتوانید دستی برای همه دستگاهها یا فقط یک کاربر پیام بفرستید.
اعلان سفارش فقط برای کاربر صاحب سفارش و فقط روی دستگاههایی ارسال میشود که پس از ورود در اپ ثبت شدهاند. کلید خصوصی فایربیس پس از ذخیره دوباره نمایش داده نمیشود.
بررسی امکانات سایت
بعد از اتصال، اپ در زمان اجرا فهرست امکانات سایت را میخواند و در متغیرهای سیستمی قرار میدهد. مهمترینها:
| متغیر | معنی |
|---|---|
sys.wordpress.connected | اتصال به سایت برقرار است |
sys.wordpress.connectorAvailable | افزونه اختصاصی روی سایت نصب و فعال است |
sys.wordpress.features | فهرست امکانات وردپرسی فعال |
sys.woocommerce.available | ووکامرس فعال و در دسترس است |
sys.woocommerce.features | فهرست امکانات فروشگاهی فعال |
فهرست کامل در متغیرهای وردپرس و ووکامرس آمده است.
مقادیر ممکن sys.woocommerce.features:
customer، addresses، locations، orders، guest_order_status، order_cancel، refund_requests، tracking، downloads، favorites، reviews، store_management، store_api_identity، variation_colors، payment_methods؛ و در صورت نصب افزونههای مربوطه subscriptions و bookings.
رنگ تنوع محصولات
افزونه از ویژگیهای دیداری ووکامرس پشتیبانی میکند. برای هر ویژگی رنگ، کد رنگ و ارتباط هر تنوع با رنگهای آن در پاسخ محصول قرار میگیرد تا اپ لازم نباشد نامهایی مانند «قرمز» را حدس بزند.
اطلاعات در بخش extensions.appeditor-app-builder پاسخ استاندارد محصولات قرار میگیرد:
{
"color_attributes": [{ "name": "رنگ", "terms": [{ "name": "قرمز", "color": "#FF0000" }] }],
"variation_colors": [{ "variation_id": 123, "colors": [{ "color": "#FF0000" }] }]
}
اگر افزونه دیگری رنگ را در کلید اختصاصی خود ذخیره میکند، توسعهدهنده میتواند آن کلید را با فیلتر appeditor_product_color_meta_keys معرفی کند.
امنیت
- کلید مدیریتی فروشگاه هرگز داخل برنامه قرار نمیگیرد.
- همه عملیات خصوصی با یک مجوز ورود مستقل مشتری انجام میشود؛ هیچ نشست مدیریتی وردپرس در اختیار اپ قرار نمیگیرد.
- مقادیر حساس مانند رمز عبور در تنظیمات اپ ذخیره نمیشوند؛ در عملکردها فقط نام متغیر را انتخاب میکنید و مقدار آن هنگام اجرا خوانده میشود.
رفع اشکال
| نشانه | علت محتمل | راه حل |
|---|---|---|
| هیچ دادهای نمایش داده نمیشود | REST API سایت بسته است | https://example.com/wp-json/wp/v2/posts را در مرورگر باز کنید؛ باید JSON برگردد |
| بهجای داده، صفحه ورود یا HTML میآید | افزونه امنیتی یا فایروال جلوی REST را گرفته | مسیرهای wp-json را در فهرست سفید افزونه امنیتی بگذارید |
| بخشهای فروشگاهی خالی است | ووکامرس نصب نیست یا در تنظیمات افزونه خاموش است | ووکامرس را فعال و گزینه امکانات ووکامرس را روشن کنید |
| ورود کاربر کار نمیکند | افزونه نصب نیست یا API خاموش است | افزونه را نصب و «فعال بودن API اپ» را روشن کنید |
| ثبتنام خطای دسترسی میدهد | «اجازه ثبتنام از اپ» یا عضویت عمومی وردپرس خاموش است | هر دو گزینه را روشن کنید |
| کاربر تازه نمیتواند وارد شود | ایمیل هنوز تأیید نشده است | ایمیل ورودی و پوشه هرزنامه را بررسی و از عملکرد «ارسال مجدد ایمیل تأیید» استفاده کنید |
| اپ ناگهان از حساب خارج میشود | کلید اتصال تعویض شده یا توکن تازهسازی منقضی شده | کلید جدید را در وردپرس ذخیره کنید |
| فقط در خروجی وب داده نمیآید | محدودیت مبدأ (CORS) | دامنه اپ وب را به «مبدأهای مجاز» اضافه کنید |
| سفارش ثبت میشود ولی پرداخت باز نمیشود | درگاه با رابط جدید ووکامرس سازگار نیست | درگاه دیگری را آزمایش کنید یا مسیر پرداخت را ببینید |
برای دیدن دقیق خطای آخرین عملیات، مقدار sys.wordpress.lastError را در یک ویجت متن نمایش دهید.