xlabs/followbundle

Follow management bundle

1.0.21 2021-07-08 10:01 UTC

Requires

• php: >=5.6
• predis/predis: ^1.1
• symfony/symfony: >=3.4
• xlabs/rabbitmqbundle: ^1.0

Requires (Dev)

• symfony/asset: ~2.7|~3.0.0
• symfony/console: ~2.8|~3.0.0
• symfony/expression-language: ~2.4|~3.0.0
• symfony/finder: ~2.3|~3.0.0
• symfony/form: ^2.8.23
• symfony/http-kernel: ~2.8|~3.0.0
• symfony/polyfill-intl-icu: ~1.0
• symfony/routing: ~2.2|~3.0.0
• symfony/security: ~2.6|~3.0.0
• symfony/security-acl: ~2.6|~3.0.0
• symfony/stopwatch: ~2.2|~3.0.0
• symfony/templating: ~2.1|~3.0.0
• symfony/translation: ~2.7|~3.0.0
• symfony/var-dumper: ~2.7.16|~2.8.9|~3.0.9
• symfony/yaml: ^2.0.5|~3.0.0

Suggests

• symfony/asset: For using the AssetExtension
• symfony/expression-language: For using the ExpressionExtension
• symfony/finder
• symfony/form: For using the FormExtension
• symfony/http-kernel: For using the HttpKernelExtension
• symfony/routing: For using the RoutingExtension
• symfony/security: For using the SecurityExtension
• symfony/stopwatch: For using the StopwatchExtension
• symfony/templating: For using the TwigEngine
• symfony/translation: For using the TranslationExtension
• symfony/var-dumper: For using the DumpExtension
• symfony/yaml: For using the YamlExtension

MIT

• Xavi Mateos

• xlabs follow bundle

README

A redis driven like engine.

Installation

Install through composer:

php -d memory_limit=-1 composer.phar require xlabs/followbundle

This bundle depends on "xlabs/rabbitmqbundle". Make sure to set it up too.

In your AppKernel

public function registerbundles()
{
    return [
    	...
    	...
    	new XLabs\FollowBundle\XLabsFollowBundle(),
    ];
}

php bin/console doctrine:schema:update --force

Routing

Append to main routing file:

# app/config/routing.yml
  
xlabs_follow_engine:
    resource: "@XLabsFollowBundle/Resources/config/routing.yml"
    #prefix:   /

Configuration sample

Default values are shown below:

# app/config/config.yml
  
x_labs_follow:
    redis_settings:
        host: 192.168.5.23
        port: 6379
        database_id: 7
    _key_namespace: 'xlabs:follow'
    backup: # for mysql backup/restore
        <alias>: <entity_FQCN>

Usage

Append this anywhere in you template

{% include 'XLabsFollowBundle:Follow:loader.html.twig' %}

To see a sample template, check:

XLabsFollowBundle:Follow:example.html.twig

MySQL Backup

Make sure you run the following command. This is the consumer that will save all operations in the project DB.

php bin/console xlabs:follow:mysql_backup --no-debug

If ever Redis lost all the data, you will be able to recover it by issueing the following command:

php bin/console xlabs:follow:restore --no-debug

If you already have data in redis and want to create a mysql backup of it, there´s a sample one-time command you should copy to your project and adapt conveniently:

php bin/console xlabs:follow:initial_backup --no-debug

Event listener

If you want some action to take place whenever a FOLLOW takes place in the frontends, you can create an event listener as follows:

# YourBundle/Resources/config/services.yml
    ...
    xlabs_follow.event_listener:
        class:  YourBundle\EventListeners\YourListener.php
        tags:
            - { name: kernel.event_listener, event: xlabs_follow.event, method: yourListenerMethod }

use Symfony\Component\EventDispatcher\Event;
  
class YourListener extends Event
{
    public function yourListenerMethod(Event $event)
    {
        dump($event->getFollow()); die;
    }
}

The $event variable contains all info about the FOLLOW action that has taken place.

Tweaking

By default, the service uses the user in session. If you ever wanted to use the service on your own by using any specific user performing the FOLLOW action:

$user = $em->getRepository('YourBundle:YourUserEntity')->find(<ID>);
$follow_engine = $container->get('xlabs_follow_engine');
$follow_engine->setUser($user);
$follow_engine->...