پرش به مطلب اصلی

اشتراک‌گذاری متن

این عملکرد یک متن مشخص را با برنامه‌های دیگر به اشتراک می‌گذارد. متن می‌تواند شامل مقدار متغیرها با قالب {{نام‌متغیر}} باشد.

کاربردها

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

تنظیمات

  • متن: محتوایی که در پنجره اشتراک‌گذاری قرار می‌گیرد. متن ثابت و متغیر را می‌توان با هم ترکیب کرد.

استفاده از متغیر در متن

نام متغیر را بین دو آکولاد قرار دهید:

دعوت‌نامه {{sys.user.name}}
لینک اختصاصی: {{shareUrl}}

در لحظه اجرای عملکرد، {{sys.user.name}} و {{shareUrl}} با مقدار فعلی آن‌ها جایگزین می‌شوند و متن نهایی به برنامه مقصد فرستاده می‌شود.

متغیرهای معمولی، متغیرهای سیستمی، داده صفحه و مسیرهای تو‌در‌تو پشتیبانی می‌شوند:

عنوان: {{sys.inPage.data.title}}
محصول فعال: {{sys.user.buys[0].name}}

وجود فاصله داخل آکولادها مجاز است؛ {{ myvar }} و {{myvar}} یکسان هستند. اگر متغیر وجود نداشته باشد یا مقدار آن null باشد، جای آن متن خالی قرار می‌گیرد.

مراحل ساخت اشتراک‌گذاری پویا

  1. عملکرد «اشتراک‌گذاری متن» را به رویداد کلیک ویجت اضافه کنید.
  2. متن ثابت را وارد کنید.
  3. متغیرهای لازم را با قالب {{myvar}} در محل مناسب متن قرار دهید.
  4. مطمئن شوید متغیرها پیش از اجرای عملکرد مقداردهی شده‌اند.
  5. نتیجه را روی دستگاه واقعی و در یکی از برنامه‌های مقصد بررسی کنید.

نکات تکمیلی

  • این عملکرد را به رویدادی وصل کنید که از نظر کاربر قابل پیش‌بینی باشد؛ برای مثال کلیک دکمه، باز شدن صفحه یا تکمیل فرم.
  • برای متغیرهای سیستمی، نام کامل را با پیشوند sys. بنویسید.
  • مقدار لیست و آبجکت به شکل JSON قرار می‌گیرد؛ برای دریافت یک مقدار مشخص، مسیر کامل فیلد را بنویسید.
  • در سناریوهای حساس، برای جلوگیری از اجرای ناخواسته از شرط مناسب استفاده کنید.
  • پنجره اشتراک‌گذاری و برنامه‌های مقصد را روی دستگاه واقعی آزمایش کنید.

خطاهای رایج

  • نوشتن قالب ناقص؛ قالب صحیح {{myvar}} است.
  • استفاده از متغیر ناموجود یا متغیری که هنوز مقداردهی نشده است.
  • اتصال عملکرد به رویداد اشتباه یا تکراری.
  • اجرای عملکرد پیش از عملکرد مقداردهی متغیر.