README

Bootstrap Version: 3.3.7

This is a base theme which can be used as-is or extended by other themes.

Installation

Add the require in your composer.json file:

"require": {
  ...
  "paladindigital/laravel-bootstrap": "*"
}

If you dont already have the service provider registered in your config/app.php then add it also

'providers' => [
    ...
    PaladinDigital\LaravelThemes\ServiceProvider::class,
]

Theme Usage

Laravel Support (Task Force Dev package)

If you install the taskforcedev/laravel-support package this provides the ability to set a sitewide master layout which will be used in all views.

This saves you having to set the longform view name in all page templates. Alternatively you could create your own shared data object.

Layouts

master: The master layout uses container-fluid css class for full-width responsive themes.
fixed: This layout uses the container css class which constrains page contents to a fixed width.

Yields

head
meta
styles
navigation
secondary_navigation
content
sidebar
footer

Stacks

widgets
scripts

Page Meta

The following meta tags will be populated if provided by controllers (the easiest way to do this is to create a method on your base controller to populate a shared data object then pass this along with any extra page specific data to your views).

$charset : String (optional), default: UTF-8
$viewport : String (optional), default: width=device-width, initial-scale=1.0
$keywords : Array of keywords or a comma-seperated string.
$description : String
$title : Page title

Navbar

The theme includes a navbar by default in the navigation section, (this can be overridden if desired).

To add menu items to the navbar simple create an array called $menu in the format as per the example below

$menu = [
    
    // Simple Links
    [
        'title' => 'Home',
        'url' => route('home')
    ],
    
    // Dropdowns
    [
        'title' => 'Pages',
        'links' => [
            'title' => 'SubPage',
            'url' => route('subpage.route')
        ]
    ]
];

The navbar also yields both 'navigation' and 'secondary_navigation' sections so you can also add custom html if desired.

The default navbar also uses the navbar-brand class to display your brand, so in order for this to work you should make sure your data also includes the $brand varible (if not set the page will retrieve the value from the app.name config variable).

paladindigital / laravel-theme-bootstrap

Maintainers

Details