"Filter: bricks/query/init_loop_index"

فیلتر bricks/query/init_loop_index، موجود @since 1.11، به شما امکان می‌دهد شاخص حلقه اولیه را هنگام استفاده از انواع Query در Bricks Builder تغییر دهید. این فیلتر به ویژه در مواردی مانند پیمایش بی‌نهایت یا جستجوهای صفحه‌بندی شده، که در آن تنظیم فهرست حلقه صحیح برای نمایش یکپارچه محتوا در چندین صفحه، به ویژه هنگام استفاده از تصاویر یا رنگ‌های پس‌زمینه پویا، بسیار مهم است، مفید است. بدون این قلاب، CSS پویا ایجاد شده ممکن است روی عنصر نادرست هنگام انجام حرکات بی‌نهایت اسکرول یا صفحه‌بندی اعمال شود.

چه زمانی استفاده شود

این فیلتر به ویژه هنگام ایجاد یک نوع درخواست سفارشی با استفاده از قلاب bricks/setup/control_options مفید است. شما می‌توانید منطق خود را برای مدیریت صفحه بندی پیاده سازی کنید و شاخص حلقه اولیه را بر اساس آن تنظیم کنید.

add_filter( 'bricks/query/init_loop_index', function ( $initial_index, $object_type, $query ) {
  // Check if the object type is 'my_custom_query'
  if ( $object_type !== 'my_custom_query' ) {
    return $initial_index;
  }

  // Add your custom logic to modify the initial loop index
  // Example: Calculate based on custom logic
  // $initial_index = custom_logic_to_calculate_index();

  return $initial_index;
}, 10, 3 );