ویجت روی سایت نمایش داده نمی‌شود

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

۱. دامنه در فهرست «دامنه‌های مجاز» نیست

اگر دامنه‌ی سایتتان به «دامنه‌های مجاز» اضافه شده ولی اشتباه تایپ شده (مثلاً بدون www. درحالی‌که سایت با www. باز می‌شود، یا برعکس)، ویجت بارگذاری نمی‌شود. آدرس دقیق سایتی که باز کرده‌اید را با آنچه در تنظیمات ثبت کرده‌اید مقایسه کنید.

۲. کد در جای اشتباهی از HTML قرار گرفته

کد نصب باید دقیقاً قبل از بسته‌شدن تگ </body> باشد. اگر داخل <head> یا وسط محتوای صفحه قرار گرفته، بعضی قالب‌ها ممکن است آن را نادیده بگیرند یا حذف کنند.

۳. کش سایت، نسخه‌ی قدیمی صفحه را نشان می‌دهد

اگر از یک افزونه‌ی کش (مثل سایت‌های وردپرسی با WP Super Cache، W3 Total Cache و مشابه) یا یک CDN استفاده می‌کنید، ممکن است بعد از اضافه کردن کد، همچنان نسخه‌ی کش‌شده‌ی قدیمی صفحه (بدون ویجت) نمایش داده شود. کش سایت را خالی کنید و صفحه را با Ctrl+Shift+R (رفرش کامل، بدون کش مرورگر) دوباره باز کنید.

۴. افزونه‌ی وردپرس نصب شده ولی فعال نشده

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

۵. یک افزونه یا اسکریپت دیگر با ویجت تداخل دارد

ویجت میراکل داخل Shadow DOM اجرا می‌شود تا با استایل سایت شما تداخل نکند، اما بعضی افزونه‌های امنیتی سختگیرانه (که اسکریپت‌های خارجی را مسدود می‌کنند) یا Content Security Policy سفت‌وسخت سایت، می‌توانند جلوی لود شدن اسکریپت را بگیرند. کنسول مرورگر (کلید F12، تب Console) را باز کنید و دنبال خطاهایی با کلمه‌ی miracleai یا Content Security Policy بگردید.

۶. کلید API اشتباه یا غیرفعال است

اگر کد نصب را دستی و بدون کپی مستقیم از داشبورد وارد کرده‌اید، ممکن است کلید API ناقص یا اشتباه کپی شده باشد. دوباره از «تنظیمات → نصب ویجت» کد کامل را کپی کنید.

۷. یک قانون «نمایش صفحات» همین صفحه را عمداً مخفی کرده

اگر ویجت روی همه‌ی صفحات هست ولی دقیقاً روی یک صفحه یا بخش خاص (مثلاً مرکز راهنما یا وبلاگ) دیده نمی‌شود، احتمالاً مشکلی نیست — از «تنظیمات ویجت → تب نمایش صفحات» چک کنید که آیا حالتی غیر از «همه‌ی صفحات» انتخاب شده و آدرس همین صفحه با یکی از الگوهای ثبت‌شده مطابقت دارد یا نه. جزئیات کامل در «نمایش ویجت فقط در صفحات خاص» است.