راهنمای نصب

نصب SDK ریوو در 5 دقیقه

SDK جاوااسکریپت ریوو را با چند خط کد ساده در وب‌سایت خود نصب کنید

شروع سریع

فقط 3 مرحله ساده تا جمع‌آوری خودکار نظرات!

  1. کلید API خود را از پنل کاربری دریافت کنید
  2. اسکریپت SDK را به صفحه اضافه کنید
  3. عناصر نظرات را نشانه‌گذاری کنید
1

دریافت کلید API

ابتدا به پنل کاربری خود بروید و یک کلید API ایجاد کنید:

  1. به پنل کاربری بروید
  2. به بخش تنظیمات → کلیدهای API بروید
  3. روی دکمه "کلید جدید" کلیک کنید
  4. کلید ایجاد شده را کپی کنید
ایجاد کلید API
2

افزودن اسکریپت SDK

کد زیر را در تگ <head> وب‌سایت خود قرار دهید:

<script src="https://cdn.rivue.app/sdk/v2/rivue.min.js" async></script>

سپس قبل از تگ بستن </body> کد زیر را اضافه کنید:

<script>
  rivue('init', {
    apiKey: 'YOUR_API_KEY_HERE',
    autoStart: true
  });
</script>
3

نشانه‌گذاری نظرات

به عناصر HTML حاوی نظرات کاربران، ویژگی data-rivue-comment اضافه کنید:

<div class="comment" data-rivue-comment>
  <p class="comment-text">نظر کاربر اینجا نوشته می‌شود</p>
  <span class="comment-author">نام کاربر</span>
  <time class="comment-date">2025-01-15</time>
</div>

نمونه کامل

یک مثال کامل از یک صفحه محصول با SDK نصب شده:

<!DOCTYPE html>
<html lang="fa" dir="rtl">
<head>
  <meta charset="UTF-8">
  <title>صفحه محصول</title>
  
  <!-- Rivue SDK -->
  <script src="https://cdn.rivue.app/sdk/v2/rivue.min.js" async></script>
</head>
<body>
  
  <!-- محصول با شناسه -->
  <div class="product" data-product-id="prod_123">
    <h1>محصول فوق‌العاده</h1>
    
    <!-- بخش نظرات -->
    <div class="comments">
      
      <div class="comment" data-rivue-comment>
        <p class="comment-text">کیفیت عالی!</p>
        <span class="comment-author">علی</span>
        <time class="comment-date">2025-01-15</time>
      </div>
      
      <div class="comment" data-rivue-comment>
        <p class="comment-text">قیمت مناسب</p>
        <span class="comment-author">سارا</span>
        <time class="comment-date">2025-01-14</time>
      </div>
      
    </div>
  </div>

  <!-- مقداردهی اولیه Rivue -->
  <script>
    rivue('init', {
      apiKey: 'rv_live_abc123xyz',
      autoStart: true
    });
  </script>
  
</body>
</html>

پیکربندی پیشرفته

حالت جمع‌آوری

انتخاب زمان ارسال نظرات به سرور

pullMode: 'real-time' | 'interval' | 'manual'

تنظیمات حریم خصوصی

کنترل داده‌های جمع‌آوری شده

privacy: { anonymizeAuthor, removePII }

رفع مشکلات

  • • اگر SDK بارگذاری نشد، CSP و ad blocker را بررسی کنید
  • • برای دیباگ، debug: true را فعال کنید
  • • از کنسول مرورگر برای مشاهده خطاها استفاده کنید

مراحل بعدی

مستندات کامل

مطالعه راهنمای جامع SDK

مشاهده

نمونه کدها

مشاهده پروژه‌های نمونه

GitHub

یکپارچه‌سازی SDK

مشاهده آمار و تنظیمات

داشبورد