# Blocks
To manage and organize the interface of a complex website, PHPFast Framework will use the method of breaking the interface into independent **Blocks** such as `head`, `header`, `content`, `footer`, etc. This approach makes it easier to manage and reuse these interface components when needed.
With this approach, the separation of interface and logic becomes clear, enhancing reusability, maintainability, and scalability in the future.
## Block Structure
```
ROOT
├── application/ # Application-specific files
│ ├── Blocks/ # UI blocks (footer, header, content)
│ │ ├── Footer/ # Footer block
│ │ ├── Head/ # Head block (meta, CSS, JS)
│ │ ├── Header/ # Header block (nav, logo)
│ │ └── Content/ # Content block
│ │ ├── Views/ # Content layouts
│ │ │ ├── layout_1.php # Layout 1
│ │ │ ├── layout_2.php # Layout 2
│ │ │ └── layout_3.php # Layout 3
│ │ └── ContentBlock.php # Content block logic
│ └── Views/ # Views for frontend and backend
│ ├── Backend/ # Backend views
│ └── Frontend/ # Frontend views (assets, components)
│ ├── Assets/ # Frontend assets (CSS, JS)
│ │ ├── css/ # CSS files
│ │ └── js/ # JS files
│ ├── Component/ # Reusable components (e.g., menu, search)
│ │ ├── menu.php # Menu component
│ │ └── search.php # Search component
│ └── home_index.php # Homepage view
└── system/ # Core framework files
├── Core/ # Core classes for block handling
│ └── BaseBlock.php # Base class for blocks
└── Libraries/ # Helper libraries (rendering, etc.)
└── Render.php # Class for rendering views
```
## Create Structure
* To be able to create a folder automatically, you can learn about it through [`BlockCommand`](https://docs.cmsfullform.com/documents/commands/block-command).
* Or you can create the folder structure in the manual way.
## Call Blocks
Example in `home_index.php`
```php
```
`block()` method in [`Render.php`](https://docs.cmsfullform.com/documents/libraries/render) : The `block()` function receives a block name as a parameter, dynamically constructs the corresponding class name and its path, then processes the data based on predefined properties and delivers it to the specified layout.
## Process
In `ContentBlock.php`
Extends from [`BaseBlock`](https://docs.cmsfullform.com/documents/core/baseblock) to use the pre-defined methods.
```php
setLabel('Content Block');
$this->setName('Content');
$this->setProps([
// layout name: layout_1.php
'layout' => 'layout_1', // Required
]);
$this->usersModel = new UsersModel();
}
public function handleData() {
$users = $this->usersModel->getUsers();
return $users;
}
}
```
In the `ContentBlock` class, the methods `setLabel()`, `setName()`, and `setProps()` are mandatory when initializing a block.
* `setLabel()`: Defines a user-friendly label for the block.
* `setName()`: Sets the internal name used to identify the block in the system.
* `setProps()`: Specifies essential properties such as the required layout file.
These methods ensure that every block is properly defined, named, and configured, making it easier to manage and integrate into different layouts.
The `handle()` method is responsible for processing data and returning the result to the layout defined in `setProps()`. It serves as the core logic handler for the block, ensuring that the necessary data is prepared before rendering.
If a layout is specified in `setProps()`, the method processes data accordingly and returns it to the defined layout. However, if no layout is set, the system will automatically use the default file `default.php` to return the data. This ensures flexibility, allowing blocks to adapt dynamically while maintaining a fallback mechanism for handling data efficiently
## Display data
In `layout_1.php`:
<?php foreach ($users as $user): ?>
<span>ID: <?= $user['id'] ?> </span>
<span>Username: <?= $user['username'] ?> </span>
<span>Email: <?= $user['email'] ?> </span>
<?php endforeach; ?>
`home_index.php` will get the HTML from layout\_1.php