Download the PHP package pvtl/voyager-frontend without Composer
On this page you can find all versions of the php package pvtl/voyager-frontend. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package voyager-frontend
This repository is no longer actively maintained
Voyager Frontend
The Missing Frontend for The Missing Laravel Admin.
This Laravel package adds frontend views, routes and assets to a Voyager project.
It comes with a basic structure for frontend layouts (eg. header, footer, etc) and theme assets using the Foundation framework.
Built by Pivotal Agency.
Prerequisites
- PHP >= 7.1.3
- PHP extension
sqlite3
(required forteamtnt/tntsearch
)
- PHP extension
- Node & NPM
- Composer
- Laravel Requirements
Installation
1. Install Laravel + Voyager (Replace the $VARs with your own values)
2. Install Voyager Frontend
Any issues? See the troubleshooting section below.
'Got Cron'?
This is a just a reminder to setup the standard Laravel cron on your server. The Voyager Frontend package has a few scheduled tasks, so relies on the cron running.
Theme Development
SCSS & JS
When you're ready to start styling your frontend, you can use the following commands after making updates to SCSS and/or JS files:
Command | Description |
---|---|
npm run watch |
Watches your /resources/assets for any changes and builds immediately |
npm run dev |
Builds SCSS/JS on demand |
npm run prod |
Builds SCSS/JS on demand, but this time, outputs minified results |
Overriding Views
Let's say you want to update the layout of the frontend header:
- Create the directory
resources/views/vendor/voyager-frontend
- Any files you place in here will replace the default views that comes with this package
- Copy the respective file from
vendor/pvtl/voyager-frontend/resources/views/
(in this case, thepartials/header.blade.php
) into the matching file structure and update
So now you'll have:
And any changes made to header.blade.php
reflect automatically on the site.
Thumbnails / Image Resizing
This package comes with an automatic image resize function. When you reference an image in your front-end blade templates, simply call something like:
"CDN" your images
The function will output an absolute URL, where the hostname will be APP_URL
- however you can add a ASSET_URL
variable to your .env
file to use a different hostname.
Search
Generating Indices
This module contains a scheduled job to regenerate indices which will run automatically once you setup jobs for Laravel. If you need to test and re-generate search indices you can manually run the command php artisan voyager-frontend:generate-search-indices
.
Configuring Search (Using Laravel Scout)
By default this module includes "searching" the "Pages" and "Posts" Models out-of-the-box once you have defined the following variable in your .env
file - check out the Laravel Scout documentation:
You can however extend and define your own "Searchable" Models to include in your search results by attaching the "Searchable" trait to them.
Then you'll be able to hook into the search config and merge your "Searchable" Models in with the config key (preferably using a Servie Provider): scout.tntsearch.searchableModels
.
Your configuration file should contain values similar to this modules scout.php configuration:
Testing
You can test the Pvtl/Test package switching to the packages directory and running tests via composer scripts:
Toubleshooting
Error: Class VoyagerFrontendDatabaseSeeder does not exist
Simply run php artisan voyager-frontend:install
again
Error: The command "npm i ..." failed.
Run npm install
and then try php artisan voyager-frontend:install
again
All versions of voyager-frontend with dependencies
pvtl/voyager-blog Version ^0.2.10
tcg/voyager Version ^1.3
spatie/laravel-sitemap Version ^5.7
teamtnt/laravel-scout-tntsearch-driver Version ^11.0