سافت جی‌ام
سفارش پروژه
سافت جی‌ام
📞 خط ویژه پشتیبانی: ۰۲۸-۳۳۳۵۷۴۸۷
مشاوره و شروع پروژه
📚 مرکز راهنما، اسناد و رفع خطاهای صوتی‌ساز سافت جی‌ام

مرکز آموزش و مستندات فنی
صوتی‌ساز هوشمند سافت جی‌ام (AI Audio)

راهنمای گام‌به‌گام اتصال افزونه، تنظیمات طلایی سازگاری با افزونه‌های کش (LiteSpeed و WP Rocket)، پاسخ به سوالات متداول و فیلترهای برنامه‌نویسی.

🔍
🚀 شروع سریع ⚡ سازگاری با کش (بسیار مهم) ❓ سوالات متداول & رفع خطا 💻 هوک‌ها و فیلترها 📞 تماس و پشتیبانی

🚀 بخش اول: آموزش شروع سریع (Quick Start)

۱. نحوه دریافت کلید API و قرار دادن آن در افزونه ◀
  1. ابتدا به برگه دریافت کلید API و ثبت‌نام بروید.
  2. دامنه وبلاگ و آدرس ایمیل خود را وارد کرده و دکمه صدور کلید را بزنید.
  3. کلید صادر شده با پیشوند sk_... را کپی کنید.
  4. در پیشخوان وردپرس خود به منوی صوتی‌ساز سافت جی‌ام > تنظیمات بروید و کلید را در فیلد «کلید API» جای‌گذاری نموده و دکمه «ذخیره تنظیمات» را بزنید.
  5. به محض ذخیره، اعتبار هدیه ۵,۰۰۰ کاراکتری به همراه نام دامنه تایید شده در بالای صفحه تنظیمات نمایش داده خواهد شد.
۲. انتخاب صدای گوینده و تست پیش‌نمایش صداها ◀

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

۳. تبدیل مقالات به صوت در ادیتور گوتنبرگ و المنتور ◀

برای صوتی کردن هر مقاله یا برگه:

  • وارد صفحه ویرایش نوشته شوید.
  • در سایدبار سمت چپ (باکس متای صوتی‌ساز سافت جی‌ام)، دکمه بنفش رنگ «تبدیل به صوت با هوش مصنوعی 🎙️» را کلیک کنید.
  • سیستم در عرض ۳ الی ۵ ثانیه متن مقاله را پردازش، اعراب‌گذاری و با صدای گوینده منتخب میکس می‌کند.
  • پلیر شناور لوکس همراه با همگام‌سازی لحظه‌ای کلمات (Karaoke) فوراً روی مقاله منتشر می‌گردد.

⚡ بخش دوم: راهنمای سازگاری با افزونه‌های کش و بهینه‌سازی (بسیار مهم)

⚠️ نکته بسیار مهم برای طراحان و مدیران سایت:
اگر از افزونه‌های کش مانند LiteSpeed Cache یا WP Rocket استفاده می‌کنید، برای اطمینان از عملکرد صددرصدی پلیر شناور، اجرای روان انیمیشن هایلایت کلمات و عبور بدون خطای رسانه در تست Google Rich Results، تنظیمات زیر را در سایت خود اعمال نمایید.
راهنمای تنظیمات افزونه LiteSpeed Cache (لایت‌اسپید کش) ◀

افزونه لایت‌اسپید به صورت پیش‌فرض کدهای جاوااسکریپت را به تاخیر می‌اندازد (Defer/Delay). برای جلوگیری از تداخل:

  1. در پیشخوان وردپرس به منوی LiteSpeed Cache > Page Optimization بروید.
  2. وارد تب JS Settings شوید.
  3. گزینه Load JS Deferred را روی OFF (خاموش) قرار دهید یا در بخش Excludes استثنا کنید.
  4. نام فایل player.js یا کلمه wp-ai-audio را در فیلد JS Excludes وارد کنید.
  5. پیکربندی توصیه شده طلایی:
    • JS Minify: روشن (ON) ✅
    • JS Combine: خاموش (OFF) ❌ (ترکیب فایل‌های JS پلیر را متوقف نکنید)
    • LiteSpeed Cache اصلی: روشن (ON) ✅
راهنمای تنظیمات افزونه WP Rocket (راکت) ◀
  1. در منوی تنظیمات WP Rocket به تب File Optimization بروید.
  2. در بخش JavaScript Files، فایل player.js را در کادر Excluded JavaScript Files وارد نمایید.
  3. اگر گزینه Delay JavaScript Execution فعال است، نام wp-ai-audio را به فهرست استثناها بیفزایید تا پلیر بدون نیاز به اسکرول اولیه کاربر فوراً لود شود.
راهنمای کلودفلر (Cloudflare Rocket Loader) ◀

قابلیت Rocket Loader در کلودفلر با پلیر صوتی‌ساز سافت جی‌ام سازگار است؛ اما در صورتی که هاست اشتراکی بسیار کندی دارید، در بخش Page Rules می‌توانید مسیرهای افزونه صوتی را از Rocket Loader معاف نمایید تا بیشترین ثبات و عملکرد به دست آید.

❓ بخش سوم: حل مشکلات رایج و سوالات متداول (FAQ)

۱. چرا با موجودی صفر ریال، مقالات قبلی همچنان قابل بازسازی هستند؟ ◀

پاسخ: معماری صوتی‌ساز سافت جی‌ام بر پایه «یک‌بار پرداخت، بازپخش ابدی» بنا شده است. تمامی مقالاتی که یک‌بار صوتی شده‌اند، به همراه فایل زمان‌بندی کلمات (Word Timestamps) روی حافظه کش شبکه ابری سافت جی‌ام ذخیره می‌شوند. بازتولید، دانلود یا پخش مکرر این مقالات توسط شما یا میلیون‌ها بازدیدکننده صفر ریال هزینه دارد و فقط برای مقالات جدید از موجودی کسر می‌شود.

۲. علت پخش نشدن صدا در برخی گوشی‌های آیفون (iOS / Safari) چیست؟ ◀

پاسخ: سیستم‌عامل iOS و مرورگر Safari در حالت Low Power Mode (حالت کم‌مصرف باتری) به دلایل امنیتی و کاهش مصرف اینترنت، از پخش خودکار (Autoplay) صوت بدون لمس صریح صفحه توسط کاربر جلوگیری می‌کنند. برای شنیدن صوت در آیفون، کافی است کاربر یک‌بار دکمه شناور پخش را لمس کند تا صدا بدون هیچ وقفه‌ای استریم شود.

۳. نحوه فعال‌سازی و تغییر رنگ هایلایت کلمات (Word-by-word) ◀

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

۴. آیا ذخیره فایل‌های صوتی باعث پر شدن هاست وردپرس من می‌شود؟ ◀

پاسخ: به هیچ عنوان! تمام فایل‌های صوتی با کیفیت بالا روی شبکه توزیع محتوای ابری (CDN) سافت جی‌ام میزبانی می‌شوند و به صورت استریم لحظه‌ای لود می‌گردند. بنابراین حتی صوتی کردن ۱۰,۰۰۰ مقاله هم حتی ۱ مگابایت از فضای هاست شما را اشغال نخواهد کرد.

۵. نحوه قرار دادن پلیر در بخش‌های اختصاصی با شورت‌کد (Shortcode) ◀

شما علاوه بر دکمه شناور گوشه صفحه (FAB)، می‌توانید پلیر صوتی را در هر کجای متن مقاله یا ویجت المنتور قرار دهید:

[ai_audio]

یا برای نمایش پلیر یک مقاله مشخص در برگه‌ای دیگر:

[ai_audio id="123"]
۶. فرآیند شارژ اعتبار چگونه است و چقدر زمان می‌برد؟ ◀

پاسخ: کلیه فرآیند شارژ اعتبار به صورت کاملاً آنلاین، آنی و ۱۰۰٪ خودکار از طریق درگاه پرداخت الکترونیک سامان (سپ - شاپرک) انجام می‌پذیرد. بلافاصله پس از تکمیل پرداخت با هر یک از کارت‌های عضو شتاب، کیف پول متصل به دامنه شما به میزان کاراکتر بسته خریداری‌شده شارژ می‌شود و نیازی به ارسال فیش واریزی، تایید دستی یا تغییر تنظیمات در وردپرس نخواهد بود.

💻 بخش چهارم: فیلترها و کدهای توسعه‌دهندگان (Developer Filters)

اگر می‌خواهید آدرس‌های پیش‌فرض ۳ لینک اصلی افزونه (دریافت کلید، شارژ اعتبار و راهنما) را بدون دستکاری هسته افزونه به آدرس‌های دلخواه خود تغییر دهید، کدهای زیر را در فایل functions.php قالب خود قرار دهید: 

<?php
// تغییر آدرس ثبت نام و کلید API
add_filter('ai_audio_buy_api_key_url', function($url) {
    return 'https://softgm.ir/tts/get-api-key/';
});

// تغییر آدرس شارژ و بسته‌ها
add_filter('ai_audio_recharge_url', function($url) {
    return 'https://softgm.ir/tts/recharge/';
});

// تغییر آدرس مرکز راهنما و مستندات
add_filter('ai_audio_help_url', function($url) {
    return 'https://softgm.ir/tts/help/';
});

📞 بخش پنجم: ارتباط با تیم پشتیبانی فنی

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