soda-framework/cms

A sweet PHP CMS solution built on Laravel!

Soda CMS

A sweet PHP CMS solution built on Laravel!

Installation

Install easily using the Soda Installer or manually by following these steps:

1. Create new Laravel Project

composer create-project --prefer-dist laravel/laravel app-name "5.3.*"

or

laravel new app-name

2. Require Soda Framework

cd app-name

composer require soda-framework/cms

3. Integrate into Laravel

Add package to providers in /config/app.php

'providers' => [
    Soda\Cms\SodaServiceProvider::class,
]

4. Configure

php artisan soda:setup

or, manually set up database in your .env file.

5. Migrate & Seed

(optional) php artisan session:table

php artisan vendor:publish

php artisan optimize

php artisan soda:install

cms's Issues

Creating a page duplicates its' entries in the Closure Table

When creating a page, the rows for the closure table are duplicated, resulting in a double-up in the pages tableview

CMS Form Validation

Currently pages, blocks and fields allow blank input into fields that required valid values.

Additionally, some descriptive text below these fields, and default values would be handy in guiding the user.

Media Library image manipulation

Install
http://image.intervention.io/

Neat tutorial:
https://sidharath.com/97/jquery-cropper-with-laravel

Dynamic searching/filtering in Page/Block table view

It is commonly requested to be able to filter these views.

Apply permission checks to various routes/views

There are currently permissions in the database for 'can-edit', 'can-add', but these are not applied to routes, form buttons, etc.

Handle CSRF token issues gracefully

Redirect back with input, or to login page. With alert notifying of issue. Reflash previous input

Configurable table-view for DynamicModel columns

Currently all columns in a DynamicModel are listed in a table view for a block. There needs to be a way to configure if columns are displayed or hidden, and potentially a way to alter the way values are displayed in the table-view.

Use custom relationship object for dynamic relations

Allow us to do things such as $page->property->description etc rather than $page->pageAttributes()->description. Will help with caching later on

Re-orderable blocks

Need an option for blocks to enable a 'position' column.

BlockType identifier field not saving

Reported in an old version of the CMS. To be investigated.

Add Field to PageType/BlockTypes

Currently fields cannot be added to types.

Erorr on Install

When after install and i type command

php artisan soda:setup

i get erorr

[Symfony\Component\Debug\Exception\FatalThrowableError]
Class 'Soda\Providers\SodaServiceProvider' not found

Investigate reported issue

Reported bugs:

• Creating a page of a certain type creates duplicated rows in it's associated model tabel
• Fields associated with a page are not saved when creating

Additional Seeds

Once the CMS is in a workable state, we should add some base seeds (for pages, blocks, etc) that can set up a project quickly upon installation.

Status dropdown required for Block/BlockType/Page/PageType

Currently Blocks, BlockTypes, Pages and PageTypes are Statusable, but don't have a field in the CMS to set their status.

Forgotten password functionality

The login page needs functionality to reset a password.

Investigate media not loading for DynamicModel

Bug report of media not loading for DynamicModel.

Worked:

$header = Soda::dynamicModel('soda_header')->first();
$images = Media::where('related_table', $header->getTable())
->where('related_id', $header->id)
->where('related_field', 'image')
->get();

Not working:

$header = Soda::dynamicModel('soda_header')->first();
$images = $header->getMedia('image');

Code Doc Blocks

Documentation is missing from a lot of the code, particularly the FormBuilder/FormField classes.

Investigate gulp issues

Reports of gulp-notify process persisting

Not all pages have/need types

Currently it is required that a page has a type (and hence, a loaded DynamicModel), but this is not always necessary for simple sites.

Link back to Page from PageBlock view

When editing a page's block, you lose your link back to the previous page, making it difficult to get back to what you were editing.

Session not available when searching Page by slug

As session is not available, draft mode status cannot be determined. Instead, we will need to have the slug route within a web middleware.

Steps:

• Generate session on slug route
• Before aborting, reflash session data
• Reflash may need to take place when re-routing with the Controller action?

Improve error reporting

Currently a lot of dd()s throughout the project for debugging errors.

These should be tracked down and throw an exception instead, so we can later update the error handler to return a view reporting the error to the user.