Download the PHP package ikoncept/fabriq without Composer

Fabriq CMS

Installation instructions 💻

Add the customer repository url for the make-user-command in your composer.json file:

Install Fabriq:

If you're planning on using AWS s3:

Install the Mailgun driver

Install Laravel Sanctum as well for authentication

Add the domain to the .env file:

Publish the configurations:

Setup your database using the .env

Modify the user model 🧘

The user model need to extend the Fabriq\Models\User::class

Run the fabriq:install command:

This command will publish front end assets and views. It will also run the migrations

Important Delete the files app.js and bootstrap.js in the resources/js directory

Run pnpm install and pnpm production to build assets

Auth configuration 🗝

Laravel v11 and above

[!NOTE] On Laravel 11 and up the step below is not necessary since the files are overwritten when installing

Laravel below v11

Enable the Laravel Sanctum middleware in app\Http\Kernel.php

Register routes 🛣

[!NOTE] On Laravel 11 and up the this is not necessary since the files are overwritten when installing

Register the routes that makes sense for your app. See below examples

Create your first user in the database, or by using a package like michaeldyrynda/laravel-make-user

Publishing assets 🗄️

Assets can be published using their respective tags. The tags that are available are:

• config - The config file
• fabriq-translations - Translations for auth views and validation messages
• fabriq-frontend-assets - Front end build system and Vue project files
• fabriq-views - Blade views and layouts

You can publish these assets using the command below:

If you want to overwrite your old published assets with new ones (for example when the package has updated views) you can use the --force flag

Note Above tags have been published when the fabriq:install was run

Broadcasting 📢

Fabriq leverages laravel/echo as a front end dependency to communicate with a pusher server. This package is preconfigured to use Ikoncept's own websocket server, but a pusher implementation can be swapped in.

To enable semi automatic prescense broadcasting go to the /resources/js/plugins/index.js and un-comment the the line for Laravel Echo:

If the Laravel Echo plugin isn't imported it will not be enabled.

Don't forget to add the proper .env variables:

If you want to have a presence channel for a specific page, simply add it to the route:

If you want to have a broadcast channel for a specific page, simply add it to the route:

When the broadcast middleware is applied it will listen to updated, created and deleted events. Which is useful for index views when live updates are needed.

Updating ♻️

You can publish new front end assets with the php artisan fabriq:update command. This command will publish new front end assets and run migrations.

Done? 🎉

That should be it, serve the app and login at /login

License

The MIT License (MIT). Please see License File for more information.

Testing