huenisys/tpl

template package for Laravel 5

0.0.2 2017-09-04 11:02 UTC

Requires

• php: >=7.0.0
• illuminate/support: ^5.4

MIT

• huenisys

• laravel
• template package

README

Installation

• $ composer require "huenisys/tpl"
• For development, use autoload-dev instead

"autoload-dev": {
    "classmap": [
        "../laravel-packages/huenisys/tpl/database/seeds",
        "../laravel-packages/huenisys/tpl/database/factories"
    ],
    "psr-4": {
        "Tests\\": "tests/",
        "Huenisys\\Tpl\\": "../laravel-packages/huenisys/tpl/src"
    }
},

• add provider: Huenisys\Tpl\TplServiceProvider::class,
• add alias 'Tpl' => Huenisys\Tpl\Facades\Tpl::class,
• replace guest middleware (app/Http/Kernel.php): 'guest' => \Huenisys\Tpl\Http\Middleware\RedirectIfAuthenticated::class

Steps

• remove Laravel's default root route / in routes/web.php and replace with

Route::get(
 '/', '\Huenisys\Tpl\Http\Controllers\TplPageController@getWelcome'
);

• publish assets: art vendor:publish --tag=tpl-assets --force
• generate public files using Laravel Mix as described below
• update your mailer config
• setup the database as described below

Laravel Mix Steps

• require-dev bootstrap and popper for BS4 in your package.json

"bootstrap": "^4.0.0-beta",
"popper.js": "^1.11.0"

• $ npm install bootstrap popper.js
• add below code in your webpack.mix.js file after commenting out the default

// huenisys/tpl
mix.autoload({
        jquery: ['$', 'window.jQuery',"jQuery","window.$","jquery","window.jquery"],
        'popper.js/dist/umd/popper.js': ['Popper']
    })
    .js(['resources/tpl/assets/js/app-tpl.js'], 'public/js')
   .sass('resources/tpl/assets/sass/app-tpl.scss', 'public/css')
   .copyDirectory('resources/tpl/assets/font-awesome-4.7.0/fonts', 'public/fonts')
   .sass('resources/tpl/assets/font-awesome-4.7.0/scss/font-awesome.scss', 'public/css')
   .copy('resources/tpl/assets/favicon.ico', 'public/favicon.ico')
   .copy('resources/tpl/assets/robots.txt', 'public/robots.txt')
   .copy('resources/tpl/assets/.htaccess', 'public/.htaccess')
   .extract(['jquery','popper.js', 'bootstrap', 'vue'])
   .sourceMaps()
   .version();

• replace favicon.ico with your own
• replace robots.txt as desired. default: seo is off
• $ npm run dev or $ npm run prod

Setup database

• Update .env to use DB_CONNECTION=sqlite, delete all other DB entries
• Do a fresh migration with seeds: $ art migrate:refresh --seeder=TplSeeder