Skip to content

Latest commit

 

History

History
109 lines (63 loc) · 3.41 KB

README.md

File metadata and controls

109 lines (63 loc) · 3.41 KB

Kunstmaan Bundles Standard Edition

Welcome to the Kunstmaan Bundles Standard Edition - a fully-functional CMS (content management system) based on Symfony2 that you can use as the skeleton for your websites.

This document contains information on how to download, install, and start using the Kunstmaan Bundles CMS.

  1. Installing the Kunstmaan Bundles SE

As both the Kunstmaan Bundles and Symfony use Composer to manage its dependencies, the recommended way to create a new project is to use it.

If you don't have Composer yet, download it following the instructions on http://getcomposer.org/ or just run the following command:

curl -s http://getcomposer.org/installer | php

Then, use the create-project command to generate a new Symfony application:

php composer.phar create-project kunstmaan/bundles-standard-edition path/to/install -s dev

Composer will install the Kunstmaan Bundles CMS and all its dependencies under the path/to/install directory.

  1. Checking and configuring your website

Before starting coding, make sure that your local system is properly configured for Symfony and the Kunstmaan Bundles.

Execute the check.php script from the command line:

php app/check.php

The script returns a status code of 0 if all mandatory requirements are met, 1 otherwise.

Access the config.php script from a browser:

http://localhost/path/to/app/web/config.php

If you get any warnings or recommendations, fix them before moving on.

You should also make sure you have nodejs, Sass, Bower and Grunt installed.

brew install node
gem install sass # maybe you need sudo...
npm install -g bower
npm install -g grunt
  1. Generating your website

First of, generate the bundle for your website.

app/console kuma:generate:bundle

Next up, generate the default website setup.

app/console kuma:generate:default-site

To get started with Behat tests, you can generate custom tests for your admin interface by running the following.

app/console kuma:generate:admin-tests

Now that all your code is generated, let's make sure all frontend assets are available

bower install
npm install
grunt build
app/console assets:install
app/console assetic:dump

And create the database and fill it using the fixtures

app/console doctrine:schema:create
app/console doctrine:fixtures:load
  1. Browsing the CMS administration pages

Congratulations! You're now ready to use the Kunstmaan Bundles CMS. Browse to:

http://localhost/path/to/app/en/admin

Log in using admin/admin.

  1. Doing more than the default pages and pageparts

You can also generate a news area using the ArticleBundle. Or any section based on a list with detail view (FAQ, Lexicon, Blog, etc)

app/console kuma:generate:article

Often you also have some entities that you need to administer (e.g. News authors)

# Generate the entity
app/console kuma:generate:entity

# Generate an adminlist for this entity
app/console kuma:generate:adminlist

And a Elastic Search bases search engine?

app/console kuma:generate:searchpage

Enjoy!