ibrows/simplecms-bundle

Symfony Simple CMS Bundle

IbrowsSimpleCMSBundle - Simple CMS for anyone anywhere

Setup the bundle

1. Fetch the source code
2. Add the namespace to your autoloader
3. Add the bundle to your AppKernel class
4. Add routing
5. Generate Schema
6. Permissions
7. Enjoy

How to use simple CMS

Just add a tag to your twig file to allow user to edit a specific entity type (by default, text & image is provided), _(*1)

Some Examples, _(*2)

``` twig {# add a text with key 'mycustomtextidentifier' #} {{ 'mycustomtextidentifier'|scms('text') }}, <sub>(*3)</sub>

{# add a image with key 'mycustomimageidentifier' #} {{ scms('mycustomimageidentifier','image') }}, <sub>(*4)</sub>

{# add a collections of texts with key 'mycustomtextidentifier' #} {{ 'mycustomtextidentifier'|scms_collection('text') }}, <sub>(*5)</sub>

{# add a collections of images with key 'mycustomimageidentifier' #} {{ scms_collection('mycustomimageidentifier','image') }}, <sub>(*6)</sub>

Advanced examples
-----------------

Single image with `my` class and inline editorstyle (instead of block) and a specific locale (default is the current locale)

``` twig
{{ scms('mycustomidentifier','image',{'inline':true,'attr':{'class':'mycssclass'} },'de_CH'  ) }}

Flexible amount of wysiwyg text elements, <sub>(*7)</sub>

twig {{ scms_collection('mycustomidentifier','text',{'html':true}) }}, <sub>(*8)</sub>

Install & setup the bundle

1. Fetch the source code, <sub>(*9)</sub>

   Add IbrowsSimpleCMSBundle in your composer.json:, <sub>(*10)</sub>

   {
       "require": {
           "ibrows/simplecms-bundle": "*"
       }
   }
   

   Now tell composer to download the bundle by running the command:, <sub>(*11)</sub>

   bash $ php composer.phar update ibrows/simplecms-bundle, <sub>(*12)</sub>

   Composer will install the bundle to your project's ibrows/simplecms-bundle directory., <sub>(*13)</sub>

2. Add the bundle to your AppKernel class, <sub>(*14)</sub>

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

   // app/AppKernerl.php public function registerBundles() { $bundles = array( // ... new Ibrows\SimpleCMSBundle\IbrowsSimpleCMSBundle(), // ... ); // ... }, <sub>(*16)</sub>

   ```, <sub>(*17)</sub>

3. Add routing, <sub>(*18)</sub>

   ``` yaml, <sub>(*19)</sub>

   // app/config/routing.yml, <sub>(*20)</sub>

   IbrowsSimpleCMSBundle: resource: "@IbrowsSimpleCMSBundle/Controller/" type: annotation prefix: /scms, <sub>(*21)</sub>

   use the alias routing

   IbrowsSimpleCMSBundleAlias: resource: . type: ibrows_router prefix: /, <sub>(*22)</sub>

   ```, <sub>(*23)</sub>

4. Generate Schema, <sub>(*24)</sub>

   ``` bash php app/console doctrine:schema:update --force, <sub>(*25)</sub>

   ```, <sub>(*26)</sub>

5. Permissions, <sub>(*27)</sub>

   Get permissions for FileUpload, default folder is web-dir uploads/documents, <sub>(*28)</sub>

Minimal configuration

This bundle requires Nothing !, <sub>(*29)</sub>

Additional configuration

Edit default config

# app/config/conf.yml

    ibrows_simple_cms:
      include_js_libs: true
      upload_dir: 'uploads/documents'
      role: ROLE_IS_AUTHENTICATED_ANONYMOUSLY

Add security per type

# app/config/conf.yml

    ibrows_simple_cms:
      types:
    # defaults
        text: { class: Ibrows\SimpleCMSBundle\Entity\TextContent , type: Ibrows\SimpleCMSBundle\Form\TextContentType, security:{general: ROLE_ADMIN} }
        image: { class: Ibrows\SimpleCMSBundle\Entity\ImageContent, type: Ibrows\SimpleCMSBundle\Form\FileContentType, security:{general: ROLE_ADMIN, show: ROLE_SUPER_ADMIN, create: ROLE_SUPER_ADMIN , edit: ROLE_SUPER_ADMIN , delete: ROLE_SUPER_ADMIN  } }

Edit TinyMCE Options

# app/config/conf.yml

    ibrows_simple_cms:
      wysiwyg:
        theme: 'advanced'
        theme_advanced_buttons1: 'bold,italic,underline,strikethrough,|,justifyleft,justifycenter,justifyright,justifyfull,styleselect,formatselect,fontselect,fontsizeselect'
    # other configs...

Add types

Add / Edit types of Content:, <sub>(*30)</sub>

# app/config/conf.yml

    ibrows_simple_cms:
      types:
        # defaults
        text: { class: Ibrows\SimpleCMSBundle\Entity\TextContent , type: Ibrows\SimpleCMSBundle\Form\TextContentType }
        image: { class: Ibrows\SimpleCMSBundle\Entity\ImageContent, type: Ibrows\SimpleCMSBundle\Form\FileContentType}
        # custom
        mytext: { class: Ibrows\SimpleCMSBundle\Entity\TextContent , type: Ibrows\SimpleCMSBundle\Form\TextContentType , repository: Ibrows\SimpleCMSBundle\Repository\TextContent, label:first}
        mycustomentity: { class: Ibrows\XXXBundle\Entity\YYYContent , type: Ibrows\SimpleCMSBundle\Form\YYYContentType , repository: Ibrows\SimpleCMSBundle\Repository\Content, label:myone}

Your YYYContent Entity have to implement Ibrows\SimpleCMSBundle\Entity\ContentInterface or extend Ibrows\SimpleCMSBundle\Entity\Content or a Child of it. It's also a good idea to extend Ibrows\SimpleCMSBundle\ContentType in your FormType., <sub>(*31)</sub>

Screenshots

, <sub>(*32)</sub>

, <sub>(*33)</sub>

, <sub>(*34)</sub>

TODO

• create the ODM version

AUTHORS

Developed at iBROWS GmbH Zurich: Marc Steiner Dominik Zogg Olivier Kofler, <sub>(*35)</sub>

Twitter: @iBRWOSWEB Web: www.ibrows.ch, <sub>(*36)</sub>