nonoesp / laravel-folio

🍃 A flexible Laravel content management system for developers.

A customizable Laravel content-management system.

You can see it working at Nono.MA, Getting Simple, Burns.art, RCA Media Studies, or Luis Ruiz Padrón.

Installation · Laravel 9.x

• Add alternate VCS repos for packages without Laravel 9.x support to composer.json.

    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/nonoesp/laravel-imgix"
        },
        {
            "type": "vcs",
            "url": "https://github.com/macpaw/laravel-feed"
        } 
    ],

• composer require nonoesp/folio:dev-master
• php artisan folio:install
• php artisan migrate
• php artisan migrate --path=vendor/mpociot/versionable/src/migrations
• Add the following middleware to app/Http/Kernel.php:

    protected $middlewareGroups = [
        'web' => [
            /// nonoesp/folio
            \Nonoesp\Folio\Middleware\SetLocales::class,
        ],
    ];

• Party! 🥳

Build Folio's Assets with Laravel Mix

You can fully customize the JavaScript and SCSS assets.

• Publish Folio's assets
  • php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=dev-assets
• Install npm dependencies
  • npm install nonoesp/folio-scss font-awesome vue vue-resource vue-focus lodash jquery jquery-lazy jquery-unveil validate-js vuedraggable @wordpress/wordcount animate.css
  • npm install
• Build the assets with Laravel Mix and configurate it with webpack.mix.js
  • npm run prod · to build for production
  • npm run dev · to build for development
  • npm run watch · to rebuild on changes with BrowserSync

Customize Folio's Config, Views, Translations & Assets

Configure Folio by publishing config/folio.php.

# Config
php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=config

# Views
php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=views

# Translations
php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=lang

# JavaScript & SCSS assets
php artisan vendor:publish --provider="Nonoesp\Folio\FolioServiceProvider" --tag=dev-assets

Other

• Subscriber email notifications can be configured in folio.subscribers and setting up Amazon SES in services.ses.
• Backups can be configured by adding disks to backup.destination.disks (having those disks configured in filesystems, say Dropbox, DigitalOcean, or AWS S3).

License

Folio is licensed under the MIT license.

Me

Hi. I'm Nono Martínez Alonso (Nono.MA), a creative technologist with a penchant for simplicity.

I host Getting Simple — a podcast about simple living, lifestyle design, technology, and culture — sketch things that call my attention, write about enjoying a slower life, and record creative coding and machine intelligence live streams on YouTube.

Join us on Discord. 🗣

If you find Folio useful in any way, reach out on Twitter at @nonoesp. Cheers!

Elsewhere

🍃 Getting Simple
🎙 Podcast
🗣 Ask Questions
💬 Discord
👨🏻‍🎨 Sketches
✍🏻 Blog
🐦 Twitter
📸 Instagram
📸 YouTube

laravel-folio's Issues

Ctrl-S saves the item

Feature request: when creating/editing an item, override the browser's default behavior and Save the current item instead.

Item deletion

It would be awesome to be able to delete items :)

composer require nonoesp/folio:dev-master -- problem1

When I use the composer command I have a problem

Problem 1
    - Installation request for nonoesp/folio dev-master -> satisfiable by nonoesp/folio[dev-master].
    - nonoesp/folio dev-master requires mpociot/versionable dev-master -> satisfiable by mpociot/versionable[dev-master] but these conflict with your require
ments or minimum-stability.

Textarea on items not expanding on Firefox

On creation/editing of an item, the textarea doesn't automatically expand on Firefox, but rather stays contracted with a scroll bar.

It works fine on Chrome. Tested on Firefox 58.0.2 (Windows 8).

Preview doesn't save the item

When creating/editing an item, if Preview is pressed but content has not been saved, the content is lost.

It would be ideal to have Preview raise an alert that there are unsaved changes, or automatically save before preview, and take advantage of the amazing versioning system... ;)

Non-existing admin item edit route throws an unhandled error

A URL like /admin/item/edit/304 will throw an unhandled error if Folio Item 304 does not exist.

It could just redirect to /admin/items and might be a problem also present in other /admin/item routes.