再來新增一個模組試試看，假設官網要顯示各地辦公室的資訊
來建立辦公室模組，這次選「不用支援多語」
php artisan twill:make:module offices
其餘參數都按照教材輸入
https://twillcms.com/guides/page-builder-with-blade/creating-the-page-module.html
完成之後，看一下 migration 檔案
會發現少了 xxx_translations 那張 table
然後 title 跟 description 出現在 offices 資料表，果然跟之前猜測的一樣！
同樣在 AppServiceProdiver 加入
TwillNavigation::addLink(
NavigationLink::make()->forModule('offices')
);
就可以在後台管理檔案了
接著修改 routes/web.php
Route::get('offices/{slug}', [\App\Http\Controllers\OfficeDisplayController::class, 'show'])->name('frontend.office');
並且新增控制器
<?php
namespace App\Http\Controllers;
use App\Repositories\OfficeRepository;
use Illuminate\Contracts\View\View;
class OfficeDisplayController extends Controller
{
public function show(string $slug, OfficeRepository $officeRepository): View
{
$office = $officeRepository->forSlug($slug);
if (! $office) {
abort(404);
}
return view('site.office', ['item' => $office]);
}
}
就可以在前台查看網頁囉！
目前後台的導覽列，有 Pages 跟 Offices 兩個項目
假設我們想整理一下後台導覽列，把 pages 跟 offices 都視為「About」的資訊，該怎麼做呢？
https://twillcms.com/docs/getting-started/navigation.html
我先試試看只更新 routes，不更新 AppServiceProvider
這樣搞，應該會讓後台壞掉
// TwillRoutes::module('pages');
// TwillRoutes::module('offices');
Route::group(['prefix' => 'about'], function () {
TwillRoutes::module('pages');
TwillRoutes::module('offices');
});
結果打開後台面板，居然沒有故障！
倒是兩個模組，網址前面真的多了 /about
所以 TwillRoutes 不只是對應網址＆控制器的功能
更是會根據 route group 前綴，去更新對應，太神奇了，不知道怎麼寫的？
現在後台導覽只有網址改變，導覽列 UI 結構沒變，還沒完成
我要讓導覽列只剩下 About，然後有次級導覽列
About -> Pages
About -> Offices
我在官網找不到設定方法
https://twillcms.com/docs/getting-started/navigation.html
但是翻閱原始碼之後
https://github.com/area17/twill/blob/3.x/src/View/Components/Navigation/NavigationLink.php
會發現這樣寫即可
public function boot(): void
{
// TwillNavigation::addLink(
// NavigationLink::make()->forModule('pages')
// );
// TwillNavigation::addLink(
// NavigationLink::make()->forModule('offices')
// );
TwillNavigation::addLink(
NavigationLink::make()->forModule('pages')
->title('About')
->doNotAddSelfAsFirstChild()
->setChildren([
NavigationLink::make()->forModule('pages'),
NavigationLink::make()->forModule('offices'),
])
);
}
乍看之下，好像有點複雜，但實際測試一下相關函數的行為，會發現妙不可言！
這種設計給予了工程師極大的自由，可以把導覽列整理成各種樣子！
我真心認為寫出相關類別的工程師，具有非常深厚的功底、經驗！
相關 commit 1 https://github.com/howtomakeaturn/twill-play/commit/87849d8963b10412ccb7f3eaa46204f3202e6c08
相關 commit 2 https://github.com/howtomakeaturn/twill-play/commit/1e441eb81bb24642058d1826fc5b77a3d3873545
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式