yogurt-design/vox

Vox is a beautifully designed administration panel for Laravel.


Keywords
admin, cms, panel, laravel, dashboard, vox, cms-vox
License
MIT

Documentation

Total Downloads Latest Stable Version License

Server Requirements

1. PHP >= 7.1.
2. Redis server.
3. OpenSSL PHP Extension.
4. PDO PHP Extension.
5. Mbstring PHP Extension.
6. Tokenizer PHP Extension.
7. XML PHP Extension.
8. Fileinfo Extension.

Supported Image Libraries

1. GD Library (>=2.0).
2. Imagick PHP extension (>=6.5.7).

Installing Vox

PHP 7.1+, a database MySQL server, Composer, and [Laravel 5.5] are required.

  1. First, download the Laravel installer using Composer: composer global require "laravel/installer".
  2. Make sure to place composer's system-wide vendor bin directory in your $PATH so the laravel executable can be located by your system. This directory exists in different locations based on your operating system; however, some common locations include:
    • macOS: $HOME/.composer/vendor/bin.
    • GNU / Linux Distributions: $HOME/.config/composer/vendor/bin.
  3. Once installed, the laravel new command will create a fresh Laravel installation in the directory you specify. For instance, laravel new blog will create a directory named blog containing a fresh Laravel installation with all of Laravel's dependencies already installed:
    • laravel new blog. Alternatively, you may also install Laravel by issuing the Composer create-project command in your terminal:
    • composer create-project --prefer-dist laravel/laravel blog "5.5.*".
  4. After installation is complete, transfer the contents of the folder, in example it is blog, to the website root folder and delete blog.
  5. Change database config:
    • open config/database.php and change connections => mysql => charset from utf8mb4 to utf8.
    • open config/database.php and change connections => mysql => collation from utf8mb4_unicode_ci to utf8_unicode_ci.
  6. Change .env (if you use cyrillic or spaces, wrap the value in "..."):
    • replace http://localhost in APP_URL to your website URL (for example http://example.com). The result should be APP_URL=http://example.com.
    • add below WWW_USER=user and WWW_GROUP=group where user should be the user-owner and group should be the group your user belongs to according to your server settings.
    • add below COMPOSER_HOME=path where path should be root path to your website, for eample /var/www/example/data/www/example.com.
    • change your DB_HOST, DB_DATABASE, DB_USERNAME, and DB_PASSWORD for correct connection to your database MySQL server.
  7. Define the dependency of Vox in your composer.json by runing in console composer require "yogurt-design/vox".
  8. Run the updat command php artisan vox:install