Installation & Setup

Installation

Option 1: Via composer

Add the following to your composer.json:

{
    "require": {
        "oggettoweb/messenger": "dev-master"
    },
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/OggettoWeb/messenger"
        }
    ],
    "extra": {
        "magento-root-dir": ".",
        "magento-deploystrategy": "copy"
    }
}

Then install:

$ php composer.phar install

Messenger bin files should be writeable:

$ chmod +x shell/messenger/bin/*

Possibly you may want to add the following to .gitignore to prevent module code from being committed:

/app/code/local/Oggetto/Messenger/
/shell/messenger/

Option 2: Manually

Just download source code and copy it to your Magento directory. Also, download all dependancies listed in composer.json and require them.

WeakRef

Messenger module depends on Zend\StdLib, which in turn depends on PECL weakref module, so you better install it. Common issue when installing WeakRef is missing libpcre3-dev library, so install it before:

$ apt-get install libpcre3-dev
$ pecl install channel://pecl.php.net/weakref-0.2.2

RabbitMQ

By default messenger works with RabbitMQ so you should install it.
Theoretically, any other AMQP server should work, but module has been tested only with RabbitMQ.

Setup

RabbitMQ connection

Once module is installed you should setup RabbitMQ connection:

1. Login to Magento admin
2. Go to System / Configuration
3. Find Messenger Setup tab on the left
4. Expand "RabbitMQ" fieldset and enter connection details.