https://github.com/codeadamca/laravel-blade-cms-journal
A basic journal module for a Laravel CMS.
https://github.com/codeadamca/laravel-blade-cms-journal
blade cms laravel php
Last synced: about 2 months ago
JSON representation
A basic journal module for a Laravel CMS.
- Host: GitHub
- URL: https://github.com/codeadamca/laravel-blade-cms-journal
- Owner: codeadamca
- Created: 2023-03-23T18:24:45.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-26T21:32:44.000Z (over 1 year ago)
- Last Synced: 2025-01-26T22:25:24.345Z (over 1 year ago)
- Topics: blade, cms, laravel, php
- Homepage:
- Size: 2.82 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Journal Module for Laravel CMS
This is a basic journal module developed to work with the Laravel CMS avalable in my [laravel-blade-cms](https://github.com/codeadamca/laravel-blade-cms) repo.
## Database
Before we start coding the list, add, edit, and delete files, we need a table to store our journal entries. Creating a table with testing data requires us to create a migration, model, factory, and add some instructions to our seeding script.
### Migrations
Before we make any files, use the Terminal to change the working directory to your project directory. I am using a Mac and my project folder was on my desktop:
``` sh
cd ~
cd Desktop
cd laravel-blade-cms
```
1. Using the Laravel Artisan tool, create a new migration file:
```sh
php artisan make:migration create_entries_table
```
You will now have a new migration file named `____create_entries_table.php`.
> [!Note]
> Laravel uses a database naming convention named [Eloquent](https://laravel.com/docs/10.x/eloquent). Eloquent states that tables names are lowercase and plural.
2. In the new migration file, change the schema to:
```php
Schema::create('entries', function (Blueprint $table) {
$table->id();
$table->string('title');
$table->text('content');
$table->timestamp('learned_at');
$table->timestamps();
});
```
### Model
We need a new model to define the `entries` table relationships and rules. The model scaffolding that Artisan provides is sufficient.
1. Create a new `Entry` model:
```sh
php artisan make:model Entry
```
2. You will now have a filed named `Entry.php` in the `/app/Models` folder. No changes needed.
### Factory
We need a factory to give Laravel instructions on how to populate the factory table.
1. Creat a new factory:
```sh
php artisan make:factory EntryFactory
```
2. You will now have a filed named `EntryFactory.php` in the `/database/factories` folder. Open this faile and change the definiation method retrn value to:
```php
return [
'title' => $this->faker->sentence,
'content' => $this->faker->paragraph,
'learned_at' => $this->faker->dateTimeThisMonth,
];
```
### Seeding
Lastly we need to give Laravel instructions on how many entries to add.
1. Open up the `DatabaseSeeder.php` file in the `/database/seeders` folder.
2. At the top of the file add the entries model, add this line below `use App\ModelProject;`:
```php
use App\Models\Entry;
```
3. Add some code to remove existing records when seeding it initiated. Add this below `Project::truncate();`:
```php
Entry::truncate();
```
4. Add code to add four fake entries. Add this line under `Project::factory()->count(4)->create();`:
```php
Entry::factory()->count(4)->create();
```
### Execute
Lastly we need to execute our migrations and seeding. Using the Terminal (or GitBash on a Windows machine) run this comment:
```sh
php artisan migrate:fresh --seed
```
If you received no errors, there will be tables with data in your database. OPen up phpMyAdmin to check!
## List
Now that the database is ready and poulated, we need to create the list, add, edit, and delete code. Let's start by adding the list.
### Dashboard
Open up `dashboard.blade.php` in the `resources/views/console/` folder, and add link to manage entries. Add this line after types.
```php
```
Open a browser, login to the CMS, and click `Manage Journal Entries`. You should get a `page not found` error. We need to add some new routes.
### Routes
Open the `web.php` file in the routes folder. Import the `EntriesController` by adding a `use` command to the top of your file.
```php
use App\Http\Controllers\EntriesController;
```
Copy and paste one of the list routes from one of the other modules and update for `entries`.
```php
Route::get('/console/entries/list', [EntriesController::class, 'list'])->middleware('auth');
```
Refresh your browser, and you will get a new error message that states `Controller EntriesController does not exist`.
### Controller and MEthod
Use the Laravel Artisan tool to make a new controller.
```sh
php artisan make:controller EntriesController
```
Refresh the browser and you will get a new error that states `Method EntriesController::list does not exist`.
Open up the new `EntriesCopntroller.php` file. Add a `use` comment too import the Entry model.
```php
use App\Models\Entry;
```
Add a list method. This can be copied from one of the other modules and then adjusted for entries.
```php
public function list()
{
return view('entries.list', [
'entries' => Entry::all()
]);
}
```
Refresh the browser and you will get a new error that states `View [entries.list] not found.`.
### Views
Lastly we need to create a view. In the `resources/views/` folder, create a new folder named `entries` and copy the `list.blade.php` file from one of the other modules, and adjust for entries.
```php
@extends ('layout.console')
@section ('content')
Manage Journal Entries
Title
Date
@foreach ($entries as $entry)
{{$entry->title}}
$entry->learned_at}}
Edit
Delete
@endforeach
@endsection
```
Final we can use the Carbon class to format the date. Switch the line that outputs the date.
```php
{{$entry->learned_at}}
```
With this.
```php
{{\Carbon\Carbon::parse($entry->learned_at)->format('d/m/Y h:i A')}}
```
Refresh your browser.
## Add, Edit and Delete
Using the projects module as a guide, create the add, edit, and delete pages for the entries module.
***
## Repo Resources
* [laravel-blade-cms](https://github.com/codeadamca/laravel-blade-cms)
* [Laravel](https://laravel.com/)
