thtg88 / mmcms
A headless CMS. With a REST API.
Requires
- php: ^8.0
- anhskohbo/no-captcha: ^3.0
- doctrine/dbal: ^2.9
- fruitcake/laravel-cors: ^2.0
- laravel/framework: ^8.0.0
- laravel/passport: ^10.0
- nesbot/carbon: ^2.0.0
- thtg88/laravel-db-scaffold-commands: ^0.3.0
- thtg88/laravel-exists-without-soft-deleted-rule: ^0.3
- thtg88/laravel-scaffold-commands: ^0.3.0
Requires (Dev)
- brainmaestro/composer-git-hooks: ^2.8
- friendsofphp/php-cs-fixer: ^2.16
- mockery/mockery: ^1.3
- orchestra/testbench: ^6.4
- phpstan/phpstan: ^0.12.14
- phpunit/phpunit: ^9.2
This package is auto-updated.
Last update: 2022-03-29 01:14:36 UTC
README
A headless CMS. With a REST API. mmCMS is a Laravel package that provides a REST interface over creating structured data.
Table of Contents
Installation
composer global require thtg88/mmcms-installer
Make sure to place Composer's system-wide vendor bin directory in your $PATH so the mmcms executable can be located by your system.
This directory exists in different locations based on your operating system;
however, some common locations include:
- macOS:
$HOME/.composer/vendor/bin - Windows:
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin - GNU / Linux Distributions:
$HOME/.config/composer/vendor/binor$HOME/.composer/vendor/bin
You could also find the composer's global installation path by running composer global about and looking up from the first line.
Once installed, the mmcms new command will create a fresh mmCMS installation in the directory you specify. For instance, mmcms new blog will create a directory named blog containing a fresh mmCMS installation with all of mmCMS's dependencies already installed:
mmcms new blog
Configure your database connection as you normally do within Laravel.
Next from your terminal run:
php artisan mmcms:install
Usage
Coming soon!
Development
Clone the repo
# clone the repo $ git clone https://github.com/thtg88/mmcms.git mmcms # create a new Laravel application $ laravel new mmcms-api
Add mmcms as a dependency of your API project in composer.json:
{
...
"repositories": [
{
"type": "path",
"url": "../mmcms"
}
],
"require": {
...
"thtg88/mmcms": "*"
},
...
}
Next from your terminal run:
# Run composer update to bring in mmCMS as dependancy composer update # And install mmCMS php artisan mmcms:install
Tests
mmCMS uses PHPUnit for testing.
You can run the whole tests suite using:
composer run-script test # or composer test # or ./vendor/bin/phpunit
License
mmCMS is open-sourced software licensed under the MIT license.
Security Vulnerabilities
If you discover a security vulnerability within mmCMS, please send an e-mail to Marco Marassi at security@marco-marassi.com. All security vulnerabilities will be promptly addressed.