Membuat Block

Pengertian "block" di dalam framework adalah bagian-bagian tertentu yang tersusun untuk membentuk halaman pada website. Jika anda perhatikan halaman pada website ini anda akan menemukan bagian menu di atas, kemudian form pencarian, lalu link navigation di bawah menu, kumpulan link2 pada bagian panel kanan serta footer text di bagian bawah halaman. bagian-bagian tersebut di dalam framework di sebut block.

Untuk membuatnya anda perlu menentukan beberapa hal

Nama block (contoh: "test")
Dependency module jika ada (contoh: "coba")
- Dalam artian block tersebut menampilkan data yg diolah oleh module dalam hal ini adalah "coba

dengan asumsi diatas, maka anda dianggap sudah memliki module dengan nama "coba", sekarang kita akan membuat block dengan nama "test" file yang perlu anda buat adalah: "blocks/test/_switch.php". Dikarenakan test memiliki dependency dengan module "coba" maka yang perlu anda buat tidak lagi "blocks/test/_switch.php" melainkan "blocks/coba_test/_switch.php"
Berikut langkah-langkah yang bisa anda lakukan dalam membuat block

membuat file _switch.php

<?php  if (!defined('_VALID_BBC')) exit('No direct script access allowed');
// Ini adalah text yang akan ditampilkan pada block manager ketika akan menambah block pada template
$array = array(
  'Nama'      => 'Tukang coba',
  'Alamat'    => 'di mana saja',
 'Pekerjaan' => 'berkenala'
 );
include tpl('display.html.php');

Membuat file _setting.php (file setting untuk block)

<?php  if ( ! defined('_VALID_BBC')) exit('No direct script access allowed');

$_setting = array(
  'display' => array(
    'text'   => 'display type',
    'type'   => 'select',
    'option' => array('table', 'ul-li'),
   'tips'   => 'Pilih jenis tampilan yang ingin digunakan untuk menampilkan variable $array'
    )
 );

klik di sini untuk melihat contoh penggunaan variable $_setting di atas. Nama variable untuk setting HARUS bernama $_setting

membuat file display.html.php (TPL File)

<?php  if (!defined('_VALID_BBC')) exit('No direct script access allowed');

if (!empty($array))
{
  if ($config['display']=='table')
  {
   echo table($array);
 }else{
    ?>
   <ul>
      <?php
      foreach ($array as $key => $value)
     {
       ?>
       <li><strong><?php echo $key; ?> : </strong><?php echo $value; ?></li>
       <?php
      }
     ?>
   </ul>
 }
}

jika anda perhatikan ada variable $config yang belum di declare pada _switch.php, Ini dikarenakan dalam block sudah mengandung variable global yang bisa langsung anda manfaatkan. dan klik di sini untuk mempelajari lebih jelas mengenai cara membuat tpl untuk block

Mendaftarkan block "test" ke dalam database

Block yang anda buat tidak akan bisa anda gunakan sebelum anda daftarkan ke dalam framework, cara mendaftarkan block bisa anda lakukan melalui admin panel di menu "Control Panel / Block Manager" tab "Add Block" tombol "Scan New"

Menampilkan block "test" ke template atau layout website

Setelah file block baru yang anda buat telah selesai kemudian anda daftarkan, saat nya anda menampilkan block tersebut ke tampilan website dengan menggunakan admin panel di "Control Panel / Block Manager" atau di "Control Panel / Block Manager / Block Position"