پرش به محتویات

Instagram feed

المان Instagram feed رسانه را از Instagram Graph API با استفاده از یک access token ذخیره‌شده در Bricks → Settings → API keys (instagramAccessToken) بارگذاری می‌کند. بدون token، المان یک placeholder نمایش می‌دهد که از شما می‌خواهد حساب را متصل کنید.

پاسخ‌ها در یک transient cache می‌شوند تا API call‌ها را محدود کنند؛ مدت cache قابل پیکربندی است.

پیش‌نیازها

یک Instagram access token معتبر را در Bricks → Settings → API keys اضافه کنید. پیام info المان در صورت نبود token جهانی، لینک مستقیم به آن صفحه می‌دهد.

چیدمان

  • Columns (number) — تعداد ستون‌های CSS grid برای لیست (ul). Placeholder: 3. بازه معتبر در front end: 1–6.

  • Posts (number) — تعداد پست‌هایی که درخواست می‌شوند (حداقل 1، حداکثر 100). Placeholder: 9.

تصویر

  • Object fit (select) — روی img اعمال می‌شود.

  • Aspect ratio (text) — نسبت ابعاد تصویر.

  • Height، Width (number with units) — ارتفاع و عرض تصویر.

  • Gap (number with units) — فاصله در grid ul.

  • Border (border) — border تصویر.

  • Link (checkbox) — هر تصویر را در یک لینک به permalink اینستاگرام wrap کنید.

کاروسل

استایل‌دهی اختیاری برای badge carousel روی آیتم‌های CAROUSEL_ALBUM:

  • Icon (icon)، Icon color (color)، Icon size (number with units)، Icon position (dimensions).

ویدیو

استایل‌دهی اختیاری برای overlay play video روی آیتم‌های VIDEO:

  • Icon (icon)، Icon color (color)، Icon size (number with units)، Icon position (dimensions).

کپشن

  • Enable (checkbox) — کپشن پست را زیر تصویر نمایش دهید.

وقتی فعال است: Background color، Border، Typography روی .caption.

دنبال کردن

ردیف اختیاری «Follow us» با لینک به instagram.com/{username}:

  • Text (text) — به‌طور پیش‌فرض @yourhandle را ذکر می‌کند؛ با متن یا dynamic data خود جایگزین کنید.

  • Position (select) — top یا bottom.

  • Icon (icon) — پیش‌فرض: لوگوی اینستاگرام.

  • Typography — استایل متن .follow.

کش

  • Duration (select) — 30 minutes، 1 hour، 1 day یا 1 week (به ثانیه ذخیره می‌شود: 1800، 3600، 86400، 604800). پیش‌فرض: ۱ ساعت.

مرجع توسعه‌دهنده

برای JSON schema کامل به Instagram feed Schema مراجعه کنید.