CMS Starter

Project ready to deploy, based on the top of [Symfony2][2] and Sonata Project using Th3Mouk extends bundle., _(*1)

This project aims to simplify the use of Sonata CMS for developers and future users, trying to not alter the original flexibility, and to give them new basic tools., _(*2)

, _(*3)

Installation

Via Composer

Go into your project's folder :, _(*4)

``` bash, _(*5)

Example of user's folder

cd ~/projects, _(*6)


Now tell composer to create and download the project:

``` bash
$ composer create-project th3mouk/cms-starter my_project_name

Composer will install the project and his dependencies., _(*7)

The project is now deployed in your folder., _(*8)

Load Fixtures Datas

The project comes with lots of examples fixtures., _(*9)

This allows to create user, medias, CMS pages, menu items... and many mores., _(*10)

To adapt this part to your needs you need referer to the following docs:, _(*11)

The project will not work without executing this command:, _(*12)

``` bash php bin/load_data.php, _(*13)


She allows to reflate all the commands present in the file `bin/load_data.php`

It's also a way to reload your new datas during phases of development.



### Finally

__That's all folks !__

Your project is now fully installed, and functional.

## Update CMSStarter

Only one solution is advised to easily update your project: `cherry pick`

You need to have a remote on your subversion, directly on this repository.
Call it maybe (=D), updates and checkout the master branch.

When there is new releases you have the choice : merging or cherry picking into your project.

## Configuration

### CKEditor

A default configuration with SonataMedia exists in `app/config/config.yml`, delete it to implement your own, like with [FMElfinderBundle](https://github.com/helios-ag/FMElfinderBundle#ckeditor-integration) integration.

## Extend me

### Bundle pack

A fix, a feature, typo or missing docs ?

Submit it and be part of CMS Starter !

This project use:

* [CMSCoreBundle](https://github.com/Th3Mouk/CMSCoreBundle) (The core provide default configuration of CMS and basic dependencies)
* [CMSPageBundle](https://github.com/Th3Mouk/CMSPageBundle) (Extend of [SonataPageBundle](https://github.com/sonata-project/SonataPageBundle))
* [Id4vMenuBundle](https://github.com/Id4v/MenuBundle) (Manageable and customizable menu)


### Install Grunt modules

You must be familiar with [Grunt](http://gruntjs.com/) to add others modules and tasks.

``` bash
npm install

Bower

You must be familiar with Bower to add dependencies, _(*14)

``` bash bower install, _(*15)


#### Style

At each modification of the [LESS](http://lesscss.org/)/CSS, you need
to re-compile `starter.min.css` file.

Run:
``` bash
grunt css

This command make 2 tasks in one: (compression and minimization), _(*16)

Beware, _(*17)

This operation overwritte the web/css/style.css file., _(*18)

You need to modify Gruntfile.js or LESS files in app/Resources/public/less to adapt behaviors on your need., _(*19)

LiveReload, _(*20)

You can also run this task and use LiveReload for reload browser pages instantly at each save of LESS file., _(*21)

``` bash grunt watch, _(*22)


This task run in background and recompile `starter.min.css` each time you save a modification of a LESS file,
in this folder `app/Resources/public/less/`.
Under the hood `grunt watch` launch `grunt css`.

#### Javascripts

In the same way, this command
``` bash
grunt js

Allow to compress and minimize all the javascripts in starter.min.js., _(*23)