Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
$ composer require dameert/frontend-cmsThis command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.
Then, enable the bundle by adding it to the list of registered bundles
in the app/AppKernel.php file of your project (also enable Assetic):
<?php
// app/AppKernel.php
// ...
class AppKernel extends Kernel
{
public function registerBundles()
{
$bundles = array(
// ...
new Dameert\FrontendCms\DameertFrontendCmsBundle(),
);
// ...
}
// ...
}# app/config/config.yml
dameert_frontend_cms:
content_path: '%content_path%'
template_path: '%template_path%'- content_path: the folder containing the json files which represent the contents of your website.
- template_path: the folder containing the templates that represent your different content types.
# app/config/routing.yml
dameert_frontend_cms:
resource: '@DameertFrontendCmsBundle/Controller/'
type: annotationIn order to edit content via the frontend, the role 'ROLE_FRONTEND_ADMIN' is required. The bundle comes with a predefined User object that can be used for this.
For a quick setup you can use the following configuration:
# app/config/security.yml
security:
providers:
database_provider:
entity:
class: Dameert\FrontendCms\Entity\User
encoders:
Dameert\FrontendCms\Entity\User:
algorithm: bcrypt
cost: 12
firewalls:
# disables authentication for assets and the profiler, adapt it according to your needs
dev:
pattern: ^/(_(profiler|wdt)|css|images|js)/
security: false
main:
anonymous: ~
http_basic: ~
provider: database_provider
logout:
path: /logout
target: /
access_control:
# require ROLE_FRONTEND_ADMIN for /admin*
- { path: ^/admin, roles: ROLE_FRONTEND_ADMIN }Make sure to configure your database:
#app/config/config.yml
doctrine:
dbal:
driver: pdo_sqlite
charset: UTF8
path: '%database_path%'
orm:
auto_generate_proxy_classes: '%kernel.debug%'
naming_strategy: doctrine.orm.naming_strategy.underscore
auto_mapping: trueTo create the database execute in console:
php bin/console d:d:c
php bin/console d:s:u --forceTodo: create first user and admin interface. For now add your user manually in the database and use symfony to encode your password
Pages that are editable should be extend from the base template:
{% extends 'DameertFrontendCmsBundle::base.html.twig' %}The bundle includes jQuery and Bootstrap in it's js and css files. If your project is also using jQuery / Bootstrap then those libraries will be loaded twice on every page.
Our goal is to provide a 'light' version of the base template without jQuery, nor Bootstrap for your content pages. You should add jQuery and Bootstrap yourself on every page, and they will only be loaded once.
The body element in the base template contains data-attributes that are required for the frontend editor to function. When overriding the template, make sure to call the 'frontendEditorAttributes' function with the 'type' variable, containing the template name to use in twig:
<body {{ frontendEditorAttributes(type) }}>The editable parts of content should be tagged with data attributes using the our edit tag function:
<div id="my-content" {{ editable('my-content-field-in-json-file') }}>
...
</div>//Todo break this part down in subsections: //Twig layout //Defining content types //Defining content data //Including the frontend edition (editor & metadata) //Access json stored data in twig