kirschbaum/laravel-spark-pages

There is no license information available for the latest version (v0.3) of this package.

Easy CMS-like page creation and editing for Laravel Spark

v0.3 2017-08-03 01:17 UTC

This package is auto-updated.

Last update: 2021-10-31 00:18:54 UTC


README

Compatibility

Laravel Spark Laravel Spark Pages Laravel
0.4.x 0.3.x 5.4.*
0.3.x 0.3.x 5.4.*
0.2.x 0.2.x 5.3.*
0.1.x 0.1.x 5.2.*

Overview

This package adds a simple CMS-like page system to Laravel Spark. It allows developers and non-technical users to add and edit pages (articles, blog posts, FAQ's etc.) very quickly and without the need for a deployment.

Alt text

We have purposely chosen not to overcomplicate this add-on. If your product is successful and you end up needing more bells and whistles you may want to look into building your own solution. This is meant as a minimally viable solution that can be used until the product is worth investing more resources into.

Note that this package is under active development. Feel free to open an issue and/or submit a pull request if you see anything amiss.

Features

  • The ability to add/edit/delete pages is restricted to users with email addresses in the spark developers array.
  • Provides simple Summernote WYSIWYG editor.
  • Provides a simple editable sidebar.
  • A user with appropriate permissions will see a create button in the dropdown options list. If the user is on a page that can be edited, an edit link will be visible.
  • Only pages that a marked published will be visible to non-developers.
  • Ability to delete pages (note that this is a hard delete).
  • All views can be customized by editing the view file found in resources/views/vendor/laravel-spark-pages/.
  • Supports nested folder structure slugs (e.g. /blog/my-awesome-post)

Basic Installation

Add the package to your existing Spark installation:

composer require kirschbaum/laravel-spark-pages

Add the following to the providers array in config/app.php. This provider must be registered as the last service provider on the providers array:

Kirschbaum\LaravelSparkPages\PagesServiceProvider::class

Publish migrations:

php artisan vendor:publish --provider="Kirschbaum\LaravelSparkPages\PagesServiceProvider" --tag='migrations'

Run migrations:

php artisan migrate

Publish assets:

php artisan vendor:publish --provider="Kirschbaum\LaravelSparkPages\PagesServiceProvider" --tag='assets'

Add the following line to resources/assets/js/app.js:

require('./laravel-spark-pages-components/delete-button');

Compile your assets:

npm run dev

Adding an "Add Page" Dropdown Menu Link

If you'd like to add a link in your developer's dropdown menu, you can do that by adding the below "Add Page" link to your resources/views/vendor/spark/nav/developer.blade.php file:

<!-- Kiosk -->
<li>
    <a href="/spark/kiosk">
        <i class="fa fa-fw fa-btn fa-fort-awesome"></i>Kiosk
    </a>
    <a href="/pages/create">
        <i class="fa fa-fw fa-btn fa-plus"></i>Add Page
    </a>
</li>

Alt text

Editing the Sidebar

The template for the sidebar is located at resources/views/vendor/laravel-spark-pages/sidebar.blade.php. Modify this file to your heart's content.

Editing Pages

Navigate to the page you want to edit. If the user you are logged in as has their email address in the Spark developers array then you will see an admin section in the sidebar with the link "Edit this page".

Alt text

Roadmap

  • Build in SEO tools.
  • List view for pages.
  • Ability to have multipe types of sidebars and select which to use on a page-by-page basis.