PHP JavaScript CSS HTML CoffeeScript Vue
Latest commit 7a4acfa Jul 13, 2018
Permalink
Failed to load latest commit information.
assets Fixing depenency on Change having an Admin with the edit modal Dec 6, 2017
classes Always log created and deleted events Jun 4, 2018
config Don’t use closures in config file so config:cache works Dec 21, 2017
dist Fixing depenency on Change having an Admin with the edit modal Dec 6, 2017
docs Adding a link to an example webpack config Jun 13, 2018
example Removing nunomaduro/collision because I’m not using it and it require… Jun 2, 2018
lang Don’t show empty quotes if no title Jan 9, 2018
migrations Add locale_group by default to elements Jun 1, 2018
stubs/generate Removing tabs on rules in model stub Sep 11, 2017
tests Always log created and deleted events Jun 4, 2018
views Fixing pagination Dec 13, 2017
.editorconfig Break up rules Nov 15, 2017
.gitattributes Adding .gitattributes to the root Apr 3, 2017
.gitignore Ignoreing uploads dir in example Sep 11, 2017
.gitmodules Removing submodule and pointing to the wiki Jan 12, 2016
.npmignore Adding more files that should be ignored from npm Jan 31, 2017
.travis.yml Re-removing 7.0.15 Jun 4, 2018
LICENSE Switching to MIT license Jan 9, 2017
README.md Adding code coverage badge Mar 24, 2017
composer.json Removing nunomaduro/collision because I’m not using it and it require… Jun 2, 2018
package.json Remove publish scripts Sep 28, 2017
phpunit.xml Add Decoy::hasEl() Aug 29, 2017
webpack.config.coffee Consuming newly minifed, autorunning js by default Oct 21, 2016
yarn.lock Adding missing peer-dependency Sep 11, 2017

README.md

Decoy Build Status Coverage Status

Decoy is a PHP content management written for the Laravel framework that allows you to access your data using standard Laravel Eloquent models.

Screenshots

Screenshot of example projects listing Screenshot of example project edit view Screenshot of example category edit view Screenshot of elements editor

About

Since 2012 and Laravel 3, Bukwild has been maintaining our own content management system that we call Decoy. Decoy is meant to reduce the development effort for implementing content management while being highly flexible. And it helps you generate a great looking, easy to use admin interface; no manual required.

The driving philosophy behind Decoy is that a CMS should share models with your public facing app; your app interacts with data stored with Decoy only through standard Laravel models. This approach makes reading controller code simple (Article::ordered()->take(6)->get()), gives you access to Laravel mutators so you views are human readable ($article->full_date), and allows you to share business logic between admin and public sites. There is no additional templating or querying language to learn. After the CMS is setup, the developer interacts with the data using purely Laravel APIs.

Features

Besides it’s model-centric paradigm, Decoy includes the following features:

  • Great looking, zero-training required design
  • Croppa integration for advanced image support including cropping, setting focal point, and storing alt text
  • Video encoding via Zencoder integration
  • WYSIWYG text editing via Redactor
  • Support for all Laravel relationship types
  • Easy creation of content editing forms using Former
  • Remote file storage (S3, etc) via Upchuck and Flysystem
  • Granular admin permissioning
  • Fully customizable edit views with Bootstrap support
  • Commands panel for executing artisan commands via web UI
  • Cloning of content, even across servers
  • Localization
  • Organized key-value pair type data as Elements
  • Drag and drop ordering of data in list views
  • Built in interface for creating 301 and 302 redirects
  • All configuration stored in the filesystem to keep your team in sync via Git (or whatever VCS)

Implementation

Decoy installs into your app as a composer package and integrates with your project rather than being a standalone install. Decoy shares the Eloquent models of your public site and stores data in regular Laravel migrated tables. Your controllers and views do not need to touch Decoy at all and while your models need to use Decoy’s subclass of Eloquent\Model, there is very little behavior added at model instantiation. In other words, Decoy adds almost no overhead to your public site.

Implementing Decoy to manage model is done through a common MVC pattern that allows for overriding of default behavior at every step:

  • The admin nav, permission levels, localization options, and other settings are stored in Laravel-style php config arrays
  • For each manageable database table / Eloquent model, a Laravel-style controller is created that allows you to override defaults like how the title of the model appears, it’s description, how it can be searched within the admin, and even override any CRUD method (create, update, destroy, etc).
  • You specify validation rules, ordering scopes, and features like which relationships to follow when cloning from the model, adding specifically named properties and methods.
  • Finally, you create a regular Laravel view containing the form that should be shown to the admin during creation and editing of content. This is easier than it sounds through support of Former and many Decoy-unqiue Former fields like our image uploader and wysiwyg types.

Next steps

Interested in giving Decoy a spin? Check out the quick start guide.