```
b) `overflow-x: auto` pada widget-card untuk elak chart clipping:
```html
```
Ini cover semua saiz phone/tablet (below 768px) — content jadi horizontally scrollable dalam card.
---
## 4. Department Index — Parent Row Font Bold
### Problem
Parent rows dalam ContentDirectoryDepartment index tiada visual distinction daripada child rows.
User susah nak beza mana parent, mana child dalam hierarchy.
### Solution
**File:** `resources/views/backend/module/contentDirectoryDepartment/index.blade.php`
Parent rows (where `directory_department_main == 1`) guna class `font-bold`:
```blade
```
Sebelum ni guna `bg-brand-50` (background color) — ditukar ke `font-bold` sebab:
- Lebih standard (parent-child distinction via typography)
- Tak bergantung pada brand color yang mungkin berubah
- Better accessibility — bold lebih dikenali sebagai penanda hierarchy
---
## 5. Cara Tambah Module Baru Ke Global Search
Bila ada module baru, cuma perlu buat **3 perubahan** dalam `GlobalSearchController`:
### Langkah 1 — Import Model
```php
use App\Models\Backend\YourNewModel;
```
### Langkah 2 — Panggil Method Dalam `search()`
```php
// Line ~48, dalam search() method
$this->searchYourModule($q, $results);
```
### Langkah 3 — Create Search Method
```php
protected function searchYourModule(string $q, array &$results): void
{
$items = YourNewModel::where(function ($b) use ($q) {
$b->where('field1', 'LIKE', "%{$q}%")
->orWhere('field2', 'LIKE', "%{$q}%");
})
->limit($this->limit)
->get();
foreach ($items as $m) {
$this->add(
$results,
$m->field1, // label — display text
'Your Module Type', // type — group name dalam dropdown
route('your-module.edit', $m->id) // url — link ke edit page
);
}
}
```
### Rule of Thumb
| Perkara | Kenapa |
|---|---|
| Guna `foreach`, jangan `fn()` arrow function | Arrow function PHP capture `$results` **by value**, jadi perubahan tak sampai ke array asal |
| `$this->limit` (default 5) | Max results per module, elak response terlalu besar |
| Type mesti konsisten | Frontend group guna field `type` — guna nama yang sama untuk grouping proper |
| `&$results` dalam parameter | Pass by reference — penting supaya `add()` ubah array yang sama |
| Jangan lupa refresh cache browser | Alpine mungkin cache response lama |
### Contoh Lengkap
Nak tambah module `ContentPhotoGallery`:
```php
// 1. Import
use App\Models\Backend\ContentPhotoGallery;
// 2. Panggil dalam search()
$this->searchPhotoGalleries($q, $results);
// 3. Method
protected function searchPhotoGalleries(string $q, array &$results): void
{
$items = ContentPhotoGallery::whereHas('translations', fn($b) => $b->where('gallery_translation_title', 'LIKE', "%{$q}%"))
->with('translations')
->limit($this->limit)
->get();
foreach ($items as $m) {
$this->add(
$results,
$m->translations->first()?->gallery_translation_title ?? "Gallery #{$m->gallery_id}",
'Photo Galleries',
route('content-photo-gallery.edit', $m->gallery_id)
);
}
}
```
> **Nota:** Untuk module yang guna `whereHas` (translation table berasingan), arrow function `fn()` kat situ **tak apa** — sebab ia guna dalam query builder, bukan untuk modify `$results`.
### Apa Yang Tak Perlu Diubah
| Komponen | Sebab |
|---|---|
| Frontend Alpine | Auto-group guna field `type` — tak perlu edit |
| Route | Dah ada satu endpoint `/admin/global-search` |
| Permission | Search tak guna permission — accessible to all authenticated admin |
---
## 6. File Index
### New Files
| Path | Description |
|---|---|
| `app/Http/Controllers/Backend/GlobalSearchController.php` | Global search logic — 13 modules |
### Modified Files
| Path | Description |
|---|---|
| `database/seeders/SettingSeeder.php` | Dark mode color defaults (Filament palette) |
| `resources/css/app.css` | Dark mode bottom gap fix; `[x-cloak]` |
| `resources/views/backend/layouts/partials/sidebar.blade.php` | CSS variables for dynamic sidebar colors |
| `resources/views/backend/module/setting/index.blade.php` | Added dark mode color pickers |
| `resources/views/backend/layouts/partials/header.blade.php` | Alpine search component in search bar |
| `resources/views/backend/module/home.blade.php` | Dashboard responsiveness (breakpoint, overflow) |
| `resources/views/backend/module/contentDirectoryDepartment/index.blade.php` | Parent row font-bold |
| `routes/web.php` | Global search API route |
| `public/tailadmin/src/js/index.js` | Removed old search handlers |
| `app/Http/Helpers/SettingHelper.php` | (Unchanged) Existing cache system |