# Introduction to XenForo WebSockets

WebSockets is a protocol designed to exchange information in real time. With it, we can notify users about any events on the forum: alerts, messages, reactions, and so on.

This add-on allows developers to conveniently use this protocol in XenForo.
This means that by configuring this add-on once, other add-ons will be able to use its capabilities without the need for a separate websockets configuration.

# Requirements

  • PHP 7.4 or newer
  • XenForo 2.2.0 or newer

To run websockets server in a docker container:

To run websockets server on the server directly:

  • Python 3.x
  • GIT
  • The gcc compiler and the dependencies for build
  • NPM
  • Node.js LTS (14.x, 16.x, 18.x, so on)

# Installation

  1. Install the add-on by first uploading the files to the server or using the "Install from archive" function in the control panel.
  2. Set up a websocket server.
  3. Grant "Use WebSockets" permission to groups that can connect to the websocket server.

# Installation Service

If you do not want to bother with setting up a websocket server, but would like everything to work on your side without using third-party services, I can offer you a service for setting up a websocket server (opens new window). The cost of the service is $40.

# Technical Details

The add-on is based on the Pusher library.
It uses the Pusher SDK (opens new window) to send messages from the server, and the laravel-echo (opens new window) library to receive messages on the client side.

A copyright will be added to the footer of your site with a link to the developer's site.
Its removal is paid, its cost is $100. You can pay for the removal of the link here (opens new window).
After payment, just disable the Show copyright option in the add-on settings.