2.1. Installation

2.1.1. Git setup

Step 1. Get Dick

In your terminal, in your WWW or Sites, wherever you store your projects, clone the Dick Github repository:

git clone [email protected]:tabacitu/dick.git new-project-name

Step 2. Rename Dick’s github remote repo as “dick” instead of “origin”

cd new-project-name
git remote rename origin dick

Step 3. Add your own remote as origin (be it Github or Bitbucket)

git remote add origin
[email protected]:tabacitu/new-project-name.git
git push -u origin master

Your project is now setup with both the origin remote (your project) and the dick remote (on github). This way, if you ever want to update your dick installation, you can do:

(don't do this now)

git branch update
git checkout update
git pull dick master

Resolve any conflicts and you’ve got yourself a new Dick. Switch to your master branch and git merge update and you’re good to go.

2.1.2. Laravel installation and configuration

Step 4. Create an .env file after the .env.example in the root folder and fill it with real, accurate information about your server setup. At the very least, you need to change these values:

DB_DATABASE=dick
DB_USERNAME=root
DB_PASSWORD=root

Step 5. Install all dependencies:

composer install

If successful, try accessing your site in the browser. You should be able to see a welcome screen, usually in http://localhost/new-project-name/public

Step 6. Create the basic database tables and basic entries:

php artisan migrate
php artisan db:seed

Then some more tables’ migrations, that are stored in the packages:

php artisan migrate --path=vendor/dick/translationmanager/src/database/migrations
php artisan migrate --path=vendor/dick/settings/src/database/migrations
php artisan migrate --path=vendor/dick/menumanager/src/database/migrations

php artisan db:seed --class="Dick\TranslationManager\database\seeds\LanguageTableSeeder"
php artisan db:seed --class="Dick\Settings\database\seeds\SettingsTableSeeder"

That’s it. Try logging in with user “[email protected]” and password “admin”.

Note:

In case you get any 5xx errors, remember to make public folders writable:

chmod -R o+w storage
chmod -R o+w bootstrap/cache