typicms/base

Multilingual CMS built with Laravel 5

Wednesday, June 13, 2018
by sdebacker@gmail.com
Repository
71 Watchers
618 Stars
7,587 Installations

PHP
0 Dependents
0 Suggesters
170 Forks
1 Open issues
100 Versions
5 % Grown

The README.md

TypiCMS

, _(*1)

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., _(*2)

TypiCMS screenshot , _(*3)

Features
Requirements
Installation
Available modules
- Pages
- Menus
- Projects
- Categories
- Tags
- Events
- News
- Contacts
- Partners
- Files
- Users and roles
- Blocks
- Translations
- Sitemap
- Settings
- History
Facades
Artisan commands
Roadmap
Change log
Contributing
Credits
Licence

Features

URLs

These kind of URLs are managed by the CMS:, _(*4)

Modules:, _(*5)

/en/events/slug-in-english
/fr/evenements/slug-en-francais

Pages:, _(*6)

/en/parent-pages-slug-en/subpage-slug-en/page-slug-en
/fr/parent-pages-slug-fr/subpage-slug-fr/page-slug-fr

Requirements

PHP >= 7.2
MySQL 5.7.8
BCMath PHP Extension
Ctype PHP Extension
JSON PHP Extension
Mbstring PHP Extension
OpenSSL PHP Extension
PDO PHP Extension
Tokenizer PHP Extension
XML PHP Extension

Installation

First install Composer, _(*7)

Create a new project, _(*8)

composer create-project typicms/base mywebsite

Enter the newly created folder, _(*9)
```
cd mywebsite
```
Migration of the database, seeding, user creation, npm installation and directory rights, _(*10)
```
php artisan typicms:install
```

Note: if you use MariaDB, set 'mariadb' to true in config/typicms.php, _(*11)

Go to http://mywebsite.test/admin and log in., _(*12)

Assets

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:, _(*13)

Install npm packages (in directory node_modules), _(*14)
```
npm install
```
Compile admin and public assets, _(*15)
```
npm run dev
```

Locales configuration

Set the locales in config/typicms.php, the first key of this array is the main locale and should be the same as the locale defined in config/app.php.
Set main_locale_in_url in config/typicms.php to true or false.

Installation of a module

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!, _(*16)

Install a module with Composer, _(*17)
```
composer require typicms/news
```
Add TypiCMS\Modules\News\Providers\ModuleServiceProvider::class, to config/app.php, before TypiCMS\Modules\Core\Providers\ModuleServiceProvider::class,, _(*18)
Publish the views and migrations, _(*19)
```
php artisan vendor:publish
```
Migrate the database, _(*20)
```
php artisan migrate
```

Module scaffolding

Let’s create a module called Cats., _(*21)

Create the module with artisan:, _(*22)
```
php artisan typicms:create cats
```
The module is in /Modules/Cats, you can customize it, _(*23)
Add TypiCMS\Modules\Cats\Providers\ModuleServiceProvider::class, to config/app.php, before TypiCMS\Modules\Core\Providers\ModuleServiceProvider::class,
Migrate the database, _(*24)
```
php artisan migrate
```

Available modules

Each module can be published., _(*25)

Pages

Pages are nestable with a 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., _(*26)

Menus

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')., _(*27)

Projects

Projects have categories, projects URLs follows this pattern: /en/projects/category-slug/project-slug, _(*28)

Events

Events have starting and ending dates., _(*30)

News

News module., _(*31)

Contacts

Frontend contact form and admin side records management., _(*32)

Partners

A partner has a logo, website URL, title and body content., _(*33)

Files

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., _(*34)

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')., _(*35)

Users and roles

User registration can be enabled through the settings panel (/admin/settings). Roles and Permissions are managed with spatie/laravel-permission., _(*36)

Blocks

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')., _(*37)

Translations

Translations can be stored in the database through the admin panel (/admin/translations)., _(*38)

You can get a translation from the database with the standard Laravel functions: __('Key'), trans('Key') or @lang('Key')., _(*39)

Sitemap

A sitemap is generated by reading all pages available in your project. The URL is /sitemap.xml., _(*40)

Settings

Change the website title, logo, and other options in the settings panel., _(*41)

History

created, updated, deleted, online and offline actions are logged in database. Latest records are displayed in the back office’s dashboard., _(*42)

Facades

Each module has a facade that gives 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., _(*43)

Artisan commands

Commands are located in /vendor/typicms/core/src/Commands, _(*44)

Installation of TypiCMS

php artisan typicms:install

Initial migration and seed

php artisan typicms:database

This command is triggered by typicms:install, _(*45)

Publish a module

If you want to modify a module, for example to add some fields or a relation, you have to publish it by running:, _(*46)

php artisan typicms:publish <modulename>

The module is now located in the /Modules directory., _(*47)

These steps will be executed:, _(*48)

Publishing of views and migrations for Pages module.
Copying of everything excepted views and migrations from /vendor/typicms/pages/src to /Modules/Pages.
Running 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., _(*49)

Changelog

Please see CHANGELOG for more information on what has changed., _(*50)

Contributing

Please see CONTRIBUTING for details., _(*51)

Credits

License

TypiCMS is an open-source software licensed under the MIT license., _(*52)

The Versions

13/06 2018

dev-master

9999999-dev

Multilingual CMS built with Laravel 5

project base

Multilingual CMS built with Laravel 5

typicms/base

The README.md

TypiCMS

Table of contents

Features

URLs

Requirements

Installation

Assets

Locales configuration

Installation of a module

Module scaffolding

Available modules

Pages

Menus

Projects

Tags

Events

News

Contacts

Partners

Files

Users and roles

Blocks

Translations

Sitemap

Settings

History

Facades

Artisan commands

Installation of TypiCMS

Initial migration and seed

Publish a module

Changelog

Contributing

Credits

License

The Versions

dev-master

The Requires

The Development Requires

by Samuel De Backer

4.0.1

The Requires

The Development Requires

by Samuel De Backer

dev-vue

The Requires

The Development Requires

by Samuel De Backer

4.0.0

The Requires

The Development Requires

by Samuel De Backer

3.0.9

The Requires

The Development Requires

by Samuel De Backer

3.0.8

The Requires

The Development Requires

by Samuel De Backer

3.0.7

The Requires

The Development Requires

by Samuel De Backer

3.0.6

The Requires

The Development Requires

by Samuel De Backer

3.0.5

The Requires

The Development Requires

by Samuel De Backer

3.0.4

The Requires

The Development Requires

by Samuel De Backer