dev7ch/vertico

LUYA CMS boilerplate to kickstart your project with Verti theme by HTML5UP.

LUYA CMS Kickstarter - VERTICO

, _(*1)

Features

• Complete LUYA CMS integration
• Fully responsive and ready to use
• Admin area integration
• Customizable blocks with drag 'n' drop support
• Multi level navigation included
• SCSS and Gulp worklfow included

Installation

1.) Create project with composer, fork repository or clone from git

Creating a new project from packagist is recommend., _(*2)

composer create-project dev7ch/vertico

Or you can also clone the git repository into your web root folder., _(*3)

git clone git@github.com:dev7ch/vertico.git vertico

2.) Get all dependencies ready for setup via composer

Navigate to the new created project root., _(*4)

composer install

Find more detailed informations and help at LUYA CMS Install Guide., _(*5)

3.) Rename distributed config files and create database

Navigate from your project root into the configs/ folder., _(*6)

cd configs 

cp env.php.dist env.php 
cp env-local-db.php.dist env-local-db.php 

Create a new, empty database and make sure that in configs/env-local-db.php the user and password for the database connection is properly set., _(*7)

Rename example database in configs folder (optionally):, _(*8)

cp luya_vertico_demo.sql.dist luya_vertico_demo.sql

Import luya_vertico_demo.sql into your previously created database., _(*9)

Of course you can start without a demo DB but it helps to see and understand the features of this theme., _(*10)

4.) Run LUYA CMS setup

As all went fine navigate back to your project root and run the LUYA CMS setup commands., _(*11)

cd ..

./vendor/bin/luya migrate
./vendor/bin/luya import

You could check the health of the cms system like this:, _(*12)

./vendor/bin/luya health

Finally adding a new admin user to your cms is required to log in to the admin interface., _(*13)

If you imported luya_vertico_demo.sql use:, _(*14)

./vendor/bin/luya admin/setup/user

If you started with an empty database simply run:, _(*15)

./vendor/bin/luya admin/setup

Please have a look at the Luya Guide if you have any problems., _(*16)

5.) Done! Login to your new Website

If all went fine and no error's shown in Terminal head over to your new website., _(*17)

• http://localhost/vertico/public_html , _(*18)

• http://localhost/vertico/public_html/admin , _(*19)

Front-End

Vertico is a modern, fully responsive theme by HTML5 UP., _(*20)

Libraries

These frontend libraries are included and available., _(*21)

» jQuery (yii\web\JqueryAsset)
» Fontawesome Icons
» Skell Responsive Framework, _(*22)

Compiling

We have created our own NPM Package that includes our gulp workflow.
Inside the resources/ folder, everything is prepared., _(*23)

cd resources

npm install 
npm install gulp

See zephir/zephir-gulp-workflow for a full documentation of the workflow., _(*24)

Backend

Assets

To speed up your local development you can uncomment the following lines in configs/env-local.php in order to use symlinking your assets instead of copy them every run., _(*25)

'assetManager' => [
    'class' => 'luya\web\AssetManager',
    'linkAssets' => true,
],

Now all assets will be symlinked and not copied., _(*26)

This will also enable CSS instant reload provided by browserSync (gulp)., _(*27)