kaleidoscope/factotum

Laravel-based CMS baked by Kaleidoscope Srl

Factotum 5

Factotum is a Laravel-based open source CMS, that follow a simple rule: We love KISSing the DRY PIE., _(*1)

Laravel Setup

1. Install a fresh Laravel application and configure your .env file with the database keys.

laravel new [project name]

1. Set your web server document root to the public folder

Attention!! Be sure that the bootstrap/cache folder and the storage folder are writable by the web server, _(*2)

1. Set the Laravel Application Key

php artisan key:generate

Factotum Setup

1. Install factotum wia composer:

composer require kaleidoscope/factotum

1. And add these services providers in config/app.php:

'providers' => [
    ...
    Intervention\Image\ImageServiceProvider::class,
    Barryvdh\Debugbar\ServiceProvider::class,
    Kaleidoscope\Factotum\FactotumServiceProvider::class,
    ...
]

Then register Facade class aliases:, _(*3)

'aliases' => [
    ...
    'Image'                       => Intervention\Image\Facades\Image::class,
    'PrintMenu'                   => Kaleidoscope\Factotum\Helpers\PrintMenuHelper::class,
    'PrintCategories'             => Kaleidoscope\Factotum\Helpers\PrintCategoriesHelper::class,
    ...
]

1. Launch the install:

php artisan factotum:install

ENJOY FACTOTUM, _(*4)

You can find the full documentation here: Factotum documentation ., _(*5)

Changing Version from Factotum 1.3 to Factotum 4

1. Change the version in the composer.json from 1.3 to 4.0.0, _(*6)

2. Run these commands:, _(*7)

composer update
php artisan vendor:publish --tag=passport-migrations
php artisan migrate
php artisan passport:install

1. In vendor/kaleidoscope/factotum/FactotumServiceProvider.php comment out these lines:

// __DIR__ . '/public/assets'            => public_path('assets'),
// __DIR__ . '/resources/views/frontend' => resource_path( 'views/frontend' )

then run, _(*8)

php artisan vendor:publish --tag=factotum

1. Rename "content_categories" table to "category_content"., _(*9)

2. Remove "manage_categories" from the "roles" table, _(*10)

Content Migration from Factotum 1.3 to Factotum 4

1. Make a backup copy of your current database, _(*11)

2. Create a new database where the new Factotum will be migrated, _(*12)

3. Configure the .env variables for the new database:, _(*13)

DB_CONNECTION=mysql
DB_HOST=[new database host]
DB_PORT=[new database port]
DB_DATABASE=[new database name]
DB_USERNAME=[new database username]
DB_PASSWORD=[new database password]

1. Configure the .env variables for the previous database:

OLD_DB_CONNECTION=old_fm
DB_HOST=[previous database host]
DB_PORT=[previous database port]
DB_DATABASE=[previous database name]
DB_USERNAME=[previous database username]
DB_PASSWORD=[previous database password]

1. To migrate existing content types and content fields, run:

factotum:migrate-content-type-fields {slug of the Content Type}

1. To migrate existing media run:

factotum:migrate-media

1. To migrate existing contents, run:

factotum:migrate-content-type-fields {slug of the Content Type}

Contributing

Thank you for considering contributing to Factotum!, _(*14)

Security Vulnerabilities

If you discover a security vulnerability within Factotum, please send an e-mail to Filippo Matteo Riggio at filippo@kaleidoscope.it. All security vulnerabilities will be promptly addressed., _(*15)

License

The Factotum CMS is open-sourced software licensed under the MIT license., _(*16)