Laravel 5.6 content management system for starters. For 5.1, 5.2, 5.3, 5.4, and 5.5 check the releases.
- Admin Panel
- Based on AdminLTE theme
- Statistics fetched by Google Analytics API integrated dashboard
- Language management.
- Category and article management
- Page management with nested sets
- Server side oriented datatables
- TinyMCE WYSIWYG editor with photo uploading features
- Front-end
- View articles, categories, pages
- Multi-language support
Clone this repository and install the dependencies.
$ git clone https://github.com/ozdemirburak/laravel-5-simple-cms.git CUSTOM_DIRECTORY && cd CUSTOM_DIRECTORY
$ composer install
Rename the .env.example
to .env
, then create a database and edit the .env
file.
$ mv .env.example .env
$ vi .env
Generate an application key and migrate the tables, then seed.
$ php artisan key:generate
$ php artisan migrate
$ php artisan db:seed
Install node and npm following one of the techniques explained within this link to create and compile the assets of the application.
$ npm install
$ npm run production
Finally, serve the application.
$ php artisan serve
Open http://localhost:8000 from your browser.
To access the admin panel, hit the link
http://localhost:8000/admin from your browser.
The application comes with default user with email address [email protected]
and 123456
.
- Step 1: Download the Repository
- Step 2: Install Dependencies
- Step 3: Create database
- Step 4: Set Configuration
- Step 5: Migrate and Seed
- Step 6: Serve
Either Clone the repository using git clone: git clone https://github.com/ozdemirburak/laravel-5-simple-cms.git CUSTOM_DIRECTORY
or install via zip and extract to any of your folders you wish.
To install the composer dependencies you need to have composer installed,
if you don't have composer installed, then follow these instructions. Then run,
composer install
within your CUSTOM_DIRECTORY
.
To install node and npm follow one of the techniques explained within this link.
Then, to install Laravel project dependencies, run npm install
. Finally to combine the javascript and style files run
npm run dev
. (Note that, on failure you may need to install some dependencies like libpng16-16
).
Rename your .env.example
file as .env
and change the variables as your own. If you have any variables with
any spaces, double quote them, for instance, if you have a variable that equals to John Doe,
use "John Doe" instead.
Finally, to generate a unique application key, run php artisan key:generate
.
Open your .env
file and change the fields corresponding to your own configurations.
All variables with DB_
prefixes relates to your database configuration.
If you want to use the Gmail client to send emails, you need to change the MAIL_USERNAME
variable as your
Gmail username without @gmail.com
and password as your Gmail password, MAIL_FROM_ADDRESS
is your
Gmail account with @gmail.com
and MAIL_FROM_NAME
is your name that is registered to that Gmail account.
To use the Analytics API, follow the instructions explained in detail here.
To migrate the database tables, run php artisan migrate
and to seed the database with some data,
run php artisan db:seed
.
To serve the application, you can use php artisan serve
, then open http://localhost:8000
from your browser. To access the admin panel, hit the link http://localhost:8000/admin
from your browser. The application comes with default user with email address [email protected]
and 123456
.
Lets assume we want to create a new resource for fruits where we'd like to manage our fruits with multi-language support, from our admin panel where will provide its title and content.
$ php artisan cms:generate fruit
Edit the database/migrations/****_create_fruits_table.php
migration file.
<?php
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;
class CreateFruitsTable extends Migration
{
public function up()
{
Schema::create('fruits', function (Blueprint $table) {
$table->increments('id');
$table->unsignedInteger('language_id');
$table->string('slug')->index();
$table->string('title');
$table->text('content');
$table->foreign('language_id')->references('id')->on('languages');
$table->timestamps();
});
}
public function down()
{
Schema::dropIfExists('fruits');
}
}
Then migrate it.
$ php artisan migrate
Afterwards, edit the resources/lang/LANGUAGE_CODE/resources.php
file and add the translation strings for the newly created resource.
'fruit' => [
'all' => 'All Fruits',
'create' => 'Create a Fruit',
'edit' => 'Edit a Fruit',
'fields' => [
'content' => 'Content',
'language_id' => 'Language'
'title' => 'Title'
],
'index' => 'Fruits',
'show' => 'Show a Fruit'
],
After finishing the language parts, check the Fruit model, which is located in app
folder as Fruit.php
.
As we are using slugs, configure the model as below.
<?php namespace App;
use App\Base\SluggableModel;
class Fruit extends SluggableModel {
protected $fillable = ['content', 'language_id', 'title'];
public function language()
{
return $this->belongsTo(Language::class);
}
}
Hence add the relation to Language model that references our fruits.
public function fruits()
{
return $this->hasMany(Fruit::class);
}
Edit the FruitDataTable controller within the Http/Controllers/Api/DataTables
folder.
<?php
namespace App\Http\Controllers\Api\DataTables;
use App\Base\Controllers\DataTableController;
use App\Fruit;
class FruitDataTable extends DataTableController
{
protected $model = Fruit::class;
protected $columns = ['title'];
public function query()
{
$fruits = Fruit::whereLanguageId(session('current_lang')->id);
return $this->applyScopes($fruits);
}
}
Then configure the controller FruitController.php
file located in Controllers folder's Admin sub-folder as below:
<?php
namespace App\Http\Controllers\Admin;
use App\Base\Controllers\AdminController;
use App\Fruit;
use App\Http\Controllers\Api\DataTables\FruitDataTable;
use App\Http\Requests\Admin\FruitRequest;
class FruitController extends AdminController
{
public function index(FruitDataTable $dataTable)
{
return $dataTable->render($this->viewPath());
}
public function store(FruitRequest $request)
{
return $this->createFlashRedirect(Fruit::class, $request);
}
public function show(Fruit $fruit)
{
return $this->viewPath('show', $fruit);
}
public function edit(Fruit $fruit)
{
return $this->getForm($fruit);
}
public function update(Fruit $fruit, FruitRequest $request)
{
return $this->saveFlashRedirect($fruit, $request);
}
public function destroy(Fruit $fruit)
{
return $this->destroyFlashRedirect($fruit);
}
}
Open your FruitRequest.php
file within Requests/Admin
folder and configure it as below or how you wish,
put some validation.
<?php
namespace App\Http\Requests\Admin;
use App\Http\Requests\Request;
class FruitRequest extends Request {
public function rules()
{
return [
'content' => 'required',
'language_id' => 'required|integer',
'title' => 'required|min:3'
];
}
}
Then open your FruitsForm.php
file located in app/Forms
folder and configure it.
<?php
namespace App\Forms\Admin;
use App\Base\Forms\AdminForm;
class FruitsForm extends AdminForm
{
public function buildForm()
{
$this
->add('language_id', 'choice', [
'choices' => $this->data,
'label' => trans('admin.fields.fruit.language_id')
])
->add('title', 'text', [
'label' => trans('admin.fields.fruit.title')
])
->add('content', 'textarea', [
'label' => trans('admin.fields.fruit.content')
]);
$this->addButtons();
}
}
Add the fruit routes, to routes/admin.php
file.
Route::resource('fruit', 'FruitController');
Open the RouteServiceProvider.php
file located in Providers
folder and bind the fruit model.
Route::model('fruit', \App\Fruit::class);
Finally, add the Fruit resource to our menu. To do that, open the resources/views/partials/admin/sidebar.blade.php
partial and add the line below.
@include('partials.admin.nav.dropdown', ['resource' => 'fruit', 'icon' => 'apple'])
Now you have your fruit resource that can be manageable within your admin panel.
I have showed all the required steps in detail for a deployment with Git and Capistrano from scratch on my blog. You can check it on: https://burakozdemir.co.uk/article/deploying-laravel-projects-with-git-and-capistrano-to-nginx-server
Kendi blogumda detaylı olarak bu uygulamayı kurulumundan, sunucuya aktarımına kadar, baştan sona nasıl geliştirdiğimi detaylı olarak anlattım, alttaki linklerden sırasıyla bunlara ulaşabilirsiniz.
- Laravel 5 ile CMS - Kurulum
- Laravel 5 ile CMS - Migration, Seed, Middleware, Elixir, Bower, Gulp, Blade
- Laravel 5 ile CMS - Controller, Model, Request, Provider, Form
- Laravel 5 ile CMS - WYSIWYG Filemanager, Çoklu Dil, Google Analitik API
- Laravel 5 ile CMS - Events, Email ve Frontend
- Laravel 5 ile CMS - FTP veya SSH ile Aktarım (Deployment)
This is free software distributed under the terms of the MIT license.