معرفی لیستها
در این داکیومنت، یک بررسی کامل از لیستها ارائه میدهیم و هر بخش از عملکرد آنها در اپلیکیشنساز اپلین را به تفصیل شرح میدهیم.
لیستها آیتمهای محتوایی ساختارمند هستند که میتوانند دارای قالبهای از پیش طراحیشده یا طراحیهای کاملاً اختصاصی شما باشند. این لیستها در کنار هم یک سیستم مدیریت محتوای کامل داخل اپلین ایجاد میکنند و محتوای اپلیکیشن شما را پویا و بهراحتی قابل مدیریت میکنند. شما میتوانید دادههای خود را در قالبهای لیستی افقی یا عمودی نمایش دهید و تمامی محتوا روی سرورهای اپلین ذخیره میشود، با این امکان که در آینده احتمالاً به سیستم غیرمتمرکز مبتنی بر بلاکچین منتقل شود.
ساختار لیستها
ساختار یک لیست حول چند جزء کلیدی شکل گرفته است: لیست تایپها که ساختار دادهها را تعریف میکنند، آیتمهای پویا که بر اساس این ساختار ایجاد میشوند، صفحه ردیفی که هر آیتم را به صورت بصری نمایش میدهد، صفحه اصلی لیست که این آیتمها را میزبانی میکند، و در صورت نیاز، APIهای متصل شده. در این داکیومنت هر یک از این بخشها را بهصورت کامل توضیح میدهیم.
لیست تایپها
هر لیست با لیست تایپ آغاز میشود که بهعنوان طرحواره یا قالب اصلی ساختار داده عمل میکند. لیست تایپ مشخص میکند که هر آیتم محتوایی چه فیلدهایی دارد و چگونه باید نمایش داده شود. برای مثال، یک پست معمولی شامل تصویر، عنوان و متن اصلی است. برای پیادهسازی این موضوع در اپلین، ابتدا یک لیست تایپ با نام Post ایجاد میکنید و فیلدهایی مانند photo، title و text به آن اضافه میکنید. سپس محتوا در این فیلدها قرار میگیرد. علاوه بر این، امکان تعریف دستهبندیهای پست نیز در همان لیست تایپ وجود دارد، هرچند که اجباری نیست.
صفحات لیست
پس از ایجاد لیست تایپ، گام بعدی طراحی قالب بصری برای هر آیتم است. این مرحله مشخص میکند که یک آیتم پست چگونه برای کاربر نمایش داده شود. برای مثال، در صفحهای مانند Main میتوانید یک عنصر تصویری ایجاد کنید که متغیر $photo را نشان دهد، زیر آن یک عنوان H3 قرار دهید که $title را نمایش دهد، و سپس یک پاراگراف برای متن $text اضافه کنید. پس از طراحی این ردیف، صفحه را نامگذاری کرده و به لیست تایپ متصل میکنید. از این لحظه میتوانید هزاران صفحه لیست با همین طراحی ایجاد کنید، که هم از محتوای پویا (آنلاین) و هم از محتوای ایستا (آفلاین) پشتیبانی میکند.
آیتمهای لیست
آیتمهای لیست، همان ورودیهای آنلاین هستند که بر اساس لیست تایپ ایجاد شدهاند. اپلین این امکان را فراهم میکند که انواع آیتمها را ایجاد، درج، ویرایش و مدیریت کنید. برای هر نوع محتوا، مانند پستها، میتوانید آیتمهای آنلاین خود را بسازید و آنها را در صفحات لیست خود نمایش دهید، با کنترل کامل روی محتوا و نمایش آنها.
APIهای لیست
اگر بخواهید دادههای JSON آیتمهای لیست را از یک نقطهی دسترسی خارجی غیر از اپلین دریافت کنید، میتوانید از قابلیت Listing API استفاده کنید. با ایجاد یک API Endpoint میتوانید لیست تایپ خود را به منابع خارجی متصل کنید یا حتی کوئریهای سفارشی بسازید تا مشخص کنید چه آیتمهایی و با چه ویژگیهایی در صفحات شما نمایش داده شوند.