webburza/sylius-article-bundle

Article bundle for Sylius e-commerce platform.

Sylius Article Bundle

This bundle extends the Sylius e-commerce platform with Article resource, which can be used to publish news, articles, or as a blog. It comes with full multilingual support, the ability to group articles into categories, and the ability to set related products for articles., _(*1)

, _(*2)

Installation

1. require the bundle with Composer:, _(*3)

   $ composer require webburza/sylius-article-bundle
   

2. enable the bundle in app/AppKernel.php:, _(*4)

   public function registerBundles()
   {
   $bundles = array(
     // ...
     new \Webburza\Sylius\ArticleBundle\WebburzaSyliusArticleBundle(),
     // ...
   );
   }
   

3. add configuration to the top of app/config/config.yml:, _(*5)

   imports:
     - { resource: "@WebburzaSyliusArticleBundle/Resources/config/config.yml" }
   

4. register routes in app/config/routing.yml, _(*6)

   webburza_article:
     resource: "@WebburzaSyliusArticleBundle/Resources/config/routing.yml"
   
   webburza_article_front:
     resource: "@WebburzaSyliusArticleBundle/Resources/config/routingFront.yml"
     prefix:  /articles
   

   As you can see, there are two groups of routes, the main resource (administration) routes, and the front-end routes. If you're using the bundle for a blog, or news, you can set the prefix for the routes here, changing it to /blog, or /news., _(*7)

5. The bundle should now be fully integrated, but it still requires database tables to be created. For this, we recommend using migrations., _(*8)

   $ bin/console doctrine:migrations:diff
   $ bin/console doctrine:migrations:migrate
   

   Or if you don't use migrations, you can update the database schema directly., _(*9)

   $ bin/console doctrine:schema:update
   

Configuration

Translations and naming (blog, news, articles...)

The bundle has multilingual support, and language files can be overridden as with any other bundle, by creating translation files in the app/Resources/WebburzaSyliusArticleBundle/translations directory., _(*10)

This also allows for different naming, so if you're using the bundle as a blog, or as a source of latest news, you can replace all mentions of articles with that of blog, news, or something else completely., _(*11)

To get started, check the bundle's main language file in: Resources/translations/messages.en.yml, _(*12)

File repository integration in rich-text editors

The bundle uses rich-text editors (CKEditor) to work with content, which allows the user to work with images in the content as well., _(*13)

By default, this is limited to specifying the URL to the image manually, but if your application integrates a file repository system for editors, such as CKFinder, or the free alternative KCFinder, you can easily add the functionality to allow the users to upload and work with image files directly trough the rich-text editor., _(*14)

To accomplish this, simply fill in the bundle's configuration with your file browser URI's, as seen in the example bellow:, _(*15)

# ...

webburza_sylius_article:
    file_browser:
        browse_url: "/browser/browse.php"
        upload_url: "/uploader/upload.php"

This will add file upload and browse controls to your rich-text editors. For more information, see http://docs.ckeditor.com/#!/guide/dev_file_browse_upload, _(*16)

License

This bundle is available under the MIT license., _(*17)

To-do

• Automated tests