shawnsandy/backstory

Backstory

Backstory (beta)

Tell Your Story.

Backstory is a Laravel package for creating and editing, content in your laravel application., _(*1)

Features

• Easily integrate into your application
• WYSIWYG editor powered by CKEditor
• Simple and easy image management
• Dynamic on the fly image resizing using PHPGlide
• OEMBED support
• Easy to customize
• more features coming soon.

Install

• Installs using composer repositories add the following to your composer.json file

``` json, <sub>(*2)</sub>

"repositories": [ { "type": "vcs", "url": "https://github.com/shawnsandy/backstory" } ],, <sub>(*3)</sub>

- Run the composer require to install the package

``` bash

composer require shawnsandy/backstory dev-master

In Laravel 5.5 and higher the package automatically installs itself. If you are running Laravel 5.4 or earlier please follow the instructions below.

• Add the provider to your config\app.php providers.

ShawnSandy\Backstory\BackstoryServiceProvider::class,

• Add the facade to your config/app.php alias.

"Backstory" => ShawnSandy\Backstory\BackstoryFacade::class,

Routes

• Add the route(s) to your routes\web.php

``` php, <sub>(*4)</sub>

Backstory::routes();, <sub>(*5)</sub>

__Optional Routes__



### Images Driver

Add the images driver to the `config\filesystem.php`

``` php

    'images' => [
    'driver' => 'local',
    'root' => base_path('/public'),
    'url' => env('APP_URL').'/public',
    'visibility' => 'public',

Publish vendor assets files

• Publish vendor assets and files

php artisan vendor:publish --tag=backstory-assets

php artisan vendor:publish --tag=backstory-vendor-assets

Migrate

Run php artisan migrate to setup backstory tables, <sub>(*6)</sub>

php artisan migrate

Traits

Add the following traits to your App/User.php, <sub>(*7)</sub>

User extends Authenticatable {
  use  Storify, HasRolesAndAbilities;
    ...
}

Dependencies

Backstory requires the following dependencies, <sub>(*8)</sub>

Img FLY, <sub>(*9)</sub>

Install ImgFly - adds dynamic image resizing download and full instructions, <sub>(*10)</sub>

Installs using composer repositories add the following to your composer.json file, <sub>(*11)</sub>

``` php, <sub>(*12)</sub>

"repositories": [ { "type": "vcs", "url": "https://github.com/shawnsandy/img-fly" } ],, <sub>(*13)</sub>

- Run the composer require to install the package

composer require shawnsandy/img-fly dev-master, <sub>(*14)</sub>

__Larvel Blade Directives__

- Run the composer require to install the package

``` php
composer require appstract/laravel-blade-directives

• Install info please check the repo

Scripts / Styles, <sub>(*15)</sub>

• When adding Backstory to your custom pages add the following to your page umbrellajs and custom scripts to your layout blade

``` blade @stack('scripts') @stack('inline-scripts'), <sub>(*16)</sub>

- Include the scripts on your editor / update blade (view)

``` php
    @include("backstory::partials.scripts")

Demo / Usage

Backstory comes with a prebuilt sample of the application that you can use to demo its functionalities and features. Dive the code for examples on how to integrate backstory in your app (tutorials coming soon)., <sub>(*17)</sub>

• Once installed you can view and create articles by visiting yourapp.com/backstory
• Add some categories-- hit add categories button and add a coupe categories before you continue.
• Click the create new story button
• Now go ahead got ahead and create your story

TODO

• [ ] Add restful api for stories
• [ ] Ajaxify / Reactive forms
• [ ] Add vue/react components
• [ ] Bootstrap 4 views
• [ ] Improve the docs

Change log

Please see CHANGELOG for more information on what has changed recently., <sub>(*18)</sub>

Testing

bash $ composer run phpstan, <sub>(*19)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*20)</sub>

Security

If you discover any security related issues, please email shawnsandy04@gmail.com instead of using the issue tracker., <sub>(*21)</sub>

Credits

• Shawn Sandy

License

The MIT License (MIT). Please see License File for more information., <sub>(*22)</sub>