teltek/resource-bundle

Resource component for Sylius.

dev-master / 0.12.x-dev 2018-10-25 14:54 UTC

Requires

• php: >=5.3.3
• doctrine/doctrine-bundle: ~1.3
• friendsofsymfony/rest-bundle: ~1.5
• jms/serializer-bundle: ~0.13
• sylius/resource: 0.12.*@dev
• sylius/storage: 0.12.*@dev
• symfony/expression-language: ~2.4|~3.4
• symfony/form: ~2.3|~3.4
• symfony/framework-bundle: ~2.3|~3.4
• symfony/twig-bundle: ~2.3|~3.4
• white-october/pagerfanta-bundle: ~1.0
• willdurand/hateoas-bundle: @stable

Requires (Dev)

• doctrine/mongodb-odm: 1.0.*@dev
• doctrine/orm: ~2.3
• doctrine/phpcr-bundle: ~1.1
• phpspec/phpspec: ~2.0
• twig/twig: ~1.11

Suggests

• doctrine/mongodb-odm: 1.0.*@dev
• doctrine/orm: ~2.3
• doctrine/phpcr-bundle: ~1.1

MIT

• Paweł Jędrzejewski
• Sylius project
• Community contributions

• persistence
• storage
• sylius
• resource

README

Easy CRUD and persistence for Symfony2 apps.

During our work on Sylius, we noticed a lot of duplicated code across all controllers. We started looking for good solution of the problem. We're not big fans of administration generators (they're cool, but not for our usecase!) - we wanted something simpler and more flexible.

Another idea was to not limit ourselves to one persistence backend. Initial implementation included custom manager classes, which was quite of overhead, so we decided to simply stick with Doctrine Common Persistence interfaces. If you are using Doctrine ORM or any of the ODM's, you're already familiar with those concepts. Resource bundle relies mainly on ObjectManager and ObjectRepository interfaces.

The last annoying problem this bundle is trying to solve, is having separate "backend" and "frontend" controllers, or any other duplication for displaying the same resource, with different presentation (view). We also wanted an easy way to filter some resources from list, sort them or display by id, slug or any other criteria - without having to defining another super simple action for that purpose.

If these are issues you're struggling with, this bundle may be helpful!

Please note that this bundle is not admin generator. It won't create forms, filters and grids for you. It only provides format agnostic controllers as foundation to build on, with some basic sorting and filter mechanisms.

Sylius

Modern ecommerce for Symfony2. Visit Sylius.org.

phpspec examples

$ composer install
$ bin/phpspec run -f pretty

Documentation

Documentation is available on docs.sylius.org.

Contributing

All informations about contributing to Sylius can be found on this page.

Mailing lists

Users

Questions? Feel free to ask on users mailing list.

Developers

To contribute and develop this bundle, use the developers mailing list.

Sylius twitter account

If you want to keep up with updates, follow the official Sylius account on twitter.

Bug tracking

This bundle uses GitHub issues. If you have found bug, please create an issue.

Versioning

Releases will be numbered with the format major.minor.patch.

And constructed with the following guidelines.

• Breaking backwards compatibility bumps the major.
• New additions without breaking backwards compatibility bumps the minor.
• Bug fixes and misc changes bump the patch.

For more information on SemVer, please visit semver.org website.
This versioning method is same for all Sylius bundles and applications.

MIT License

License can be found here.

Authors

The bundle was originally created by Paweł Jędrzejewski. See the list of contributors.