Stars: 477
Forks: 121
Pull Requests: 22
Issues: 104
Watchers: 61
Last Updated: 2021-10-22 07:04:09
Multilingual CMS built with Laravel 4.2
License: MIT License
Languages: PHP, JavaScript, CSS, HTML, Hack, Shell, Blade, Less
This repository is deprecated, please use the latest TypiCMS.
TypiCMS is a multilingual content management system built with Laravel 4.2. Bower and gulp are used for asset management and the user interface is built with Bootstrap 3 with Less.
This kind of URLs are managed by the CMS:
Modules:
Pages:
Create an empty MySQL database
Create a new project
composer create-project sdebacker/typicms mywebsite
Enter the newly created folder
cd mywebsite
DB migration and seed, user creation, npm installation, bower installation and directory rights
php artisan typicms:install
Go to http://mywebsite.local/admin and log in.
Create an empty database
Download TypiCMS
git clone https://github.com/sdebacker/TypiCMS.git mywebsite
Enter the newly created folder
cd mywebsite
Install dependencies with Composer
composer install
Set a new encryption key
php artisan key:generate
Change the cache prefix in app/config/cache.php
php artisan cache:prefix yourCachePrefix
Rename .env.example to .env
mv .env.example .env
Fill in your database credentials in .env
Migrate and seed the database
php artisan migrate --seed
Set permissions
chmod -R 777 app/storage
chmod -R 777 public/uploads
Go to http://mywebsite.local/admin and log in:
[email protected]
admin
In order to work on assets, you need to install Node.js, Bower and gulp, then cd to your website folder and run these commands:
Install bower packages according to bower.json (directory app/assets/components)
bower install
Install gulp packages according to gulpfile.js (directory node_modules)
npm install
Compile admin and public assets
gulp
Pages are nestable with drag and drop, on drop, URIs are generated and saved in the database. A page has routes for each translation.
Each menu has nestable entries. One entry can be linked to a module, page, URI or URL.
You can get a HTML formated menu with Menus::build('menuname')
.
An icon can easily be added to a menu item by filling the icon class field.
Projects have categories, projects URLs follows this pattern: /en/projects/category-slug/project-slug
Categories have many projects.
Tags are linked to projects and use the Selectize jQuery plugin. The tags moudle has many to many polymorphic relations so it could easily be linked to other modules.
Events have starting and ending dates.
Simple news module with linked files/images galleries.
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 multiple files. It uses DropzoneJS to upload them. Thumbnails are generated on the fly with Croppa.
You can create as many galleries as you want, each gallery has many files. Galleries are linkable to any module item through a polymorphic many to many relation, for now only the news module is properly set up to support galleries.
Sentry 2 is used to manage users, groups and permissions. User registration can be enabled through the settings panel (/admin/settings).
Blocks are useful to display custom content in your views.
You can get the content of a block with Blocks::build('blockname')
.
Translations can be stored in the database through the admin panel (/admin/translations).
You can call DB translation everywhere with Lang::get('db.Key')
, trans('db.Key')
or @lang('db.Key')
.
Route sitemap.xml generates a sitemap file in XML format. To add modules to the site map configure app/config/sitemap.php.
Change website title, and other options trough the settings panel. Settings are saved in the database.
History table records changes and 25 latest records are displayed in the back office’s dashboard. Logged actions are created, updated, deleted, set online and set offline. It works for all modules except users and groups.
Modules that have their own Facade: News, Events, Projects, Places, Partners, Galleries, Blocks, Files and Menus.
In your views, 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 app/TypiCMS/Commands
Initialisation of TypiCMS
php artisan typicms:install
Set cache key prefix in app/config/cache.php
php artisan cache:prefix yourCachePrefix
Initial migration and seed
php artisan typicms:database
Feel free to fork and make pull requests directly on the master branch! TypiCMS follows the PSR-2 standard.
Thanks to elvendor and jekjek for their contributions!
Some admin controllers are actually tested, more tests needed.
TypiCMS is an open-source software licensed under the MIT license.