Aloia CMS Dashboard

The Aloia CMS Dashboard is a separate package for Aloia CMS and is completely optional. This dashboard gives you a good base to start from. From this base you can add pages and forms for new content types.

Requirements

The requirements for this dashboard are the same as the requirements for the CMS Core.

Installation

You can include this package through Composer using:

composer require roelofjan-elsinga/aloia-cms-gui

and if you want to customize any of the default settings used by this package, you can publish the configuration:

php artisan vendor:publish --provider="AloiaCms\\GUI\\ServiceProvider"

This will create a aloiacmsgui.php in your config folder.

Publishing the assets

If you’ve executed the previous command, to publish the ServiceProvider, you’ve published the required assets already. If you don’t want to publish the ServiceProvider, you can also publish the assets by itself by running:

php artisan aloiacmsgui:publish:assets

This places the assets for the dashboard in public/vendor/aloiacmsgui.

Publishing the secret key

In order to create JWT tokens for authentication, your application needs to use a secret key. First of, add a new entry to your config/app.php file:

return [
    // ... 
    
    'secret' => env('APP_SECRET'),
    
    // ... 
];

Now, you can generate the APP_SECRET key using the following command:

php artisan aloiacmsgui:secret:generate

This will create an entry in your .env file: APP_SECRET=[your-token].

To regenerate this key, you can re-run the command.

Creating a user

You can create a user by running:

php artisan aloiacmsgui:create:account \
  --username=yourusername \
  --password=yourpassword

After this, you’ll be able to log in using the credentials.

Get to your dashboard

Your dashboard is located at /cms/login by default. You can change the prefix in config/aloiacmsgui.php under path.

Editors

By default, two editors are included in this package: CKEditor for HTML pages, and InscrybMDE for Markdown pages.

You can customize which editors you want to use for HTML and Markdown pages by overwriting the views.

Testing

You can run the included tests by running ./vendor/bin/phpunit in your terminal.