BlogBundle

El objetivo de este paquete es proporcionar todo lo que necesitas para crear un blog completo o sistema estilo blog. También incluye soporte integrado para el paquete Sonata Admin para ayudarte a levantar y correr rápidamente.

Características actuales:

• Host multiple blogs within a single website.
• Place blogs anywhere within your route hierarchy.
• Sonata Admin integration.

Pending features:

• Full tag support
• Frontend pagination (using knp-paginator)
• RSS/ATOM feed
• Comments
• User support (FOSUserBundle)

Dependencias

• SymfonyCmfRoutingExtraBundle is used to manage the routing.
• PHPCR-ODM is used to persist the bundles documents.

Configurando

The default configuration will work with the cmf-sandbox but you will probably need to cusomize it to fit your own requirements.

Parameters:

• routing_post_controller - specifies which controller to use for showing posts.

• routing_post_prefix - this is the part of the URL which “prefixes” the post slug

  e.g. with the default value the following post URL might be generated: http://example.com/my-blog/posts/this-is-my-post

• blog_basepath - required Specify the path where the blog content should be placed.

• routing_basepath - required Specify the basepath for the routing system.

Ejemplo:

symfony_cmf_blog:
    routing_post_controller: symfony_cmf_blog.blog_controller:viewPost
    routing_post_prefix: posts
    blog_basepath: /cms/content
    routing_basepath: /cms/routes

Nota

In the BlogBundle the controller is a service, and is referenced as such. You can of course specify a controller using the standard MyBundle:Controller:action syntax. See controllers as services in the official sf2 docs.

Enrutando

To enable the routing system to automatically forward requests to the blog controller when a Blog content is associated with a route, add the following under the controllers_by_class section of symfony_cmf_routing_extra in app/config/config.yml:

symfony_cmf_routing_extra:
    ...
    dynamic:
        ...
        controllers_by_class:
            ...
            Symfony\Cmf\Bundle\BlogBundle\Document\Blog: symfony_cmf_blog.blog_controller:listAction

Sonata Admin

The BlogBundle has admin services defined for Sonata Admin, to make the blog system visible on your dashboard, add the following to the sonata_admin section:

sonata_admin:
    ...
    dashboard:
        groups:
            ...
            blog:
                label: blog
                items:
                    - symfony_cmf_blog.admin
                    - symfony_cmf_post.admin

Tree Browser Bundle

If you use the Symfony CMF Tree Browser bundle you can expose the blog routes to enable blog edition from the tree browser. Expose the routes in the fos_js_routing section of app/config/config.yml:

fos_js_routing:
    routes_to_expose:
        ...
        - admin_bundle_blog_blog_create
        - admin_bundle_blog_blog_delete
        - admin_bundle_blog_blog_edit

Integration

Templating

The default templates are marked up for Twitter Bootstrap. But it is easy to completely customize the templates by overriding them.

The one template you will have to override is the default layout, you will need to change it and make it extend your applications layout. The easiest way to do this is to create the following file:

{# /app/Resources/SymfonyCmfBlogBundle/views/default_layout.html.twig #}

{% extends "MyApplicationBundle::my_layout.html.twig" %}

{% block content %}
{% endblock %}

The blog will now use MyApplicationBundle::my_layout.html.twig instead of SymfonyCmfBlogBundle::default_layout.html.twig.

See Overriding Bundle Templates in the Symfony documentation for more information.