Basic use

Configuration

The FeedBundle needs to be configured to recognized your feeds. This is an exemple of possible configuration:

nekland_feed:
    feeds:
        post:
            class:        Nekland\BlogBundle\Entity\Post
            title:       'My fabulous posts'
            description: 'Here are my very fabulous posts'
            # usally the homepage
            route:       'home'
            language:    'fr'
            filename: "blog.|format|"

In this case we are using a model as item class for the feed. We have to declare it. You must implement ItemInterface:

    class Post implements ItemInterface
    {
        // Implement the needed methods
    }

Configuration is over. You can make feeds when you want. They are generally used in a controller.

Using FeedBundle in a controller

1. Get the feed factory:

    $factory = $this->get('nekland_feed.factory');
   

2. Load a feed:

    // "post" is the name of the feed in the configuration
    $factory->load('post', 'rss_file'); 
    // For this example we are using rss_file but this is the default value, and if you extend the bundle you can use another loader
   

You can also load an atom_file or both (recommanded if you use the AtomInterface).

3. Get the feed (here "post") and add, remove or replace the item you want.

    $feed = $factory->get('post');
    $feed->add($post); // add an ItemInterface
    $feed->remove($id); // Remove an item with his id
    $feed->replace($id, $post); // Replace an item identified by his id with the given item
   

4. Render !

    $factory->render('post', 'rss'); // we want to render the feed into rss format but you can use the atom format