walkerchiu/php-site-cms

v1.0.0 2022-08-29 13:19 UTC

Requires

• php: ^7.3
• walkerchiu/php-account: ^1.0
• walkerchiu/php-morph-address: ^1.0
• walkerchiu/php-morph-image: ^1.0
• walkerchiu/php-morph-nav: ^1.0
• walkerchiu/php-morph-registration: ^1.0
• walkerchiu/php-role: ^1.0

Suggests

• walkerchiu/php-api: ^1.0
• walkerchiu/php-morph-board: ^1.0
• walkerchiu/php-morph-category: ^1.0
• walkerchiu/php-morph-comment: ^1.0
• walkerchiu/php-morph-link: ^1.0
• walkerchiu/php-morph-tag: ^1.0
• walkerchiu/php-newsletter: ^1.0

MIT

• Walker Chiu

README

php-site-cms is a Laravel library for dealing with site management.

Installation

Use the package manager composer to install php-site-cms.

composer require walkerchiu/php-site-cms

Usage

Package settings

# CLI

# Publish this package settings
php artisan vendor:publish

# Overwrite default settings
vi config/wk-site-cms.php

# Overwrite translations
cd resources/lang/vendor/php-site-cms
vi ...

# Overwrite views
cd resources/views/vendor/php-site-cms
vi ...

# See migrations
cd database/migrations
cat ...

Core settings

# CLI

# Overwrite default settings
vi config/wk-core.php

# See class section
# See table section

Migrations

# CLI

# Generate a database migration
php artisan make:migration

# Run all of your outstanding migrations
php artisan migrate

# See which migrations have run thus far
php artisan migrate:status

How to use

Entity

In fact, this usage is not limited to Entity, and other usages such as Repository and Service are also similar.

You can view the source code to understand the methods provided by these classes.

# PHP

# Use directly
# You can find more settings in config/wk-core.php
use WalkerChiu\SiteCMS\Models\Entities\Site

Site::all();

# PHP

# Use core setting
# You can find more settings in config/wk-core.php
use Illuminate\Support\Facades\App;

App::make(config('wk-core.class.site-cms.site'));

FormRequest

# PHP

# controller

# You can find more information in Models/Forms folder
use WalkerChiu\SiteCMS\Models\Forms\SiteFormRequest

/**
 * Store a newly created resource in storage.
 *
 * @param  \WalkerChiu\SiteCMS\Models\Forms\SiteFormRequest  $request
 * @return \Illuminate\Http\Response
 */
public function store(SiteFormRequest $request)
{
    # ...
}

Middleware

# PHP

# route.php

# You can find more information in Middleware folder
use Illuminate\Support\Facades\Route;

Route::group(['middleware' => ['wkSiteEnable']], function() {
    # ...
});

Useful commands

# CLI

# Truncate all tables of this package
php artisan command:SiteCMSCleaner

# Initialize the site
php artisan command:SiteCMSInitializer

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License