Stars: 1220
Forks: 332
Pull Requests: 67
Issues: 199
Watchers: 76
Last Updated: 2023-08-22 17:00:17
Multilingual CMS built with Laravel.
License: MIT License
Languages: PHP, Shell, Blade, JavaScript
TypiCMS is a modular multilingual content management system built with Laravel. Out of the box you can manage pages, events, news, places, menus, translations, etc.
This kind of URLs are managed by the CMS:
Modules:
Pages:
First install Composer
Create a new project
composer create-project typicms/base mywebsite
Enter the newly created folder
cd mywebsite
Migration of the database, seeding, user creation, npm installation and directory rights
php artisan typicms:install
Note: if you use MariaDB, set 'mariadb' to true in config/typicms.php
Go to http://mywebsite.test/admin and log in.
Assets are managed with Laravel Mix. In order to work on assets, you need to install Node.js, then go to your website folder and run these commands:
Install npm packages (in directory node_modules)
npm install
Compile admin and public assets
npm run dev
This example is for the News module. After these steps, the module will appear in the sidebar of the back office. If you need to customize it, you can publish it!
Install a module with Composer
composer require typicms/news
Add TypiCMS\Modules\News\Providers\ModuleServiceProvider::class,
to config/app.php, before TypiCMS\Modules\Core\Providers\ModuleServiceProvider::class,
Publish the views and migrations
php artisan vendor:publish
Migrate the database
php artisan migrate
Let’s create a module called Cats.
Create the module with artisan:
php artisan typicms:create cats
The module is in /Modules/Cats, you can customize it
Add TypiCMS\Modules\Cats\Providers\ModuleServiceProvider::class,
to config/app.php, before TypiCMS\Modules\Core\Providers\ModuleServiceProvider::class,
Migrate the database
php artisan migrate
Each module can be published.
Pages are nestable with drag and drop, on drop, URIs are generated and saved in the database. Each translation of a page has its own route. A page can be linked to a module. A page can have multiple sections.
Each menu has nestable entries. One entry can be linked to a page or URL.
You can return a HTML formated menu with Menus::render('menuname')
or @menu('menuname')
.
Projects have categories, projects URLs follows this pattern: /en/projects/category-slug/project-slug
Tags are linked to projects and use the Selectize plugin. The tags module has many to many polymorphic relations so a tag can be easily linked to any module.
Events have starting and ending dates.
News module.
Frontend contact form and admin side records management.
A partner has a logo, website URL, title and body content.
The files module allows you to upload and organize images, documents and folders. It works with DropzoneJS for the uploading proccess. Thumbnails are generated on the fly thanks to Croppa.
If you want to store the original images on a storage service such as Amazon s3 and your cropped images on the local disk, set FILESYSTEM_DRIVER=s3
in your .env file and in config/croppa.php set 'src_dir' => 'filesystem.default.driver'
and 'crops_dir' => storage_path('app/public')
.
User registration can be enabled through the settings panel (/admin/settings). Roles and Permissions are managed with spatie/laravel-permission.
Blocks are useful to display custom content in your views.
You can display the content of a block with Blocks::render('blockname')
or @block('blockname')
.
Translations can be stored in the database through the admin panel (/admin/translations).
You can get a translation from the database with the standard Laravel functions: __('Key')
, trans('Key')
or @lang('Key')
.
A sitemap is generated by reading all pages available in your project. The URL is /sitemap.xml.
Change the website title, logo, and other options in the settings panel.
created, updated, deleted, online and offline actions are logged in database. Latest records are displayed in the back office’s dashboard.
Each modules has a facade that give you access to the repository, you can call for example News::latest(3)
to get the three latest news.
Check available methods in each module’s repository.
Commands are located in /vendor/typicms/core/src/Commands
php artisan typicms:install
php artisan typicms:database
This command is triggered by typicms:install
If you want to modify a module, for example to add some fields or a relation, you have to publish it by running:
php artisan typicms:publish <modulename>
The module is now located in the /Modules directory.
These steps will be executed:
composer remove typicms/pages
.When a module is published, it will be tracked by git and you will be able to make changes in /Modules/Modulename directory without loosing changes when running composer update
.
Please see CHANGELOG for more information on what has changed.
Please see CONTRIBUTING for details.
TypiCMS is an open-source software licensed under the MIT license.