Documentation
Basic parameters
These are the basic parameters to configure, essential for the video conference to work.
Instance Type: Through this parameter, you can choose which instance to connect the module to. JooJitsi Conferencing can be connected to the free Jitsi-Meet server, to a private instance (your server), or to the "Jitsi as a Service (JaaS)" server.
Recently, the Jitsi team announced a significant change regarding the integration of Jitsi-Meet into web applications. As of April 24, 2023, the latest version of meet.jit.si no longer allows unlimited use of embedding in web applications (video conferences stop after 5 minutes).
The Jitsi team advises users to consider using Jitsi as a Service (JaaS). JaaS is a paid service that offers many more features compared to meet.jit.si, including web hooks, branding, server-side recordings, and many others. The use of JaaS is free up to 25 endpoints per month, after which it starts to be paid with a price of about $0.33 per endpoint per month grouped in different packages.
If your Joomla site currently uses the JooJitsi module to embed Jitsi-Meet, we recommend you start planning the transition to Jitsi as a Service (JaaS). You can find more information about JaaS on the JaaS website.
Depending on the chosen instance, the next parameters to configure are different:
- "Free" Instance
Server Name: Server of the free Jitsi Meet instance to connect the module to. The address of the free public Jitsi server is already set by default.
Jitsi API URL: URL address of the Jitsi APIs. This parameter is also already set by default with the address of the instance of the free public Jitsi server. You will only need to modify it if you intend to connect the module to your private Jitsi instance.
- "Custom" instance
Custom server name: Server della tua istanza privata a cui connettere il modulo.
Custom API URL: URL address of the Jitsi APIs. You will need to enter the URL address of the APIs of your private server.
iss: Enter the "iss" parameter of your private server configuration here.
aud: Enter the "aud" parameter of your private server configuration here.
sub: Enter the "sub" parameter of your private server configuration here.
Encoding mode: Mode 1 creates and encodes headers using the HS256 algorithm and creates and encodes the signature using the hmac algorithm. Mode 2 creates and encodes headers using the RS256 algorithm and the "kid" parameter and creates and encodes the signature using openssl.
Private key: Enter your instance's private key here. Enter the "raw" content of the key, without modifying it.
- "JaaS" instance
JaaS server name: Server of the JaaS instance to connect the module to. The address of the standard 8x8 server is already set by default.
JaaS API URL: URL address of the Jitsi APIs. The address of the standard 8x8 APIs is already set by default.
API Key ID: Enter your JaaS account configuration's API Key ID here.
Note well: it must be of the type vpaas-magic-cookie-62f63b141x9d4172anfacc8474c66798/b754ea and the final part must also be present, the one after the slash (which we indicated in red in the example), otherwise it will not work!
Private key: Enter your instance's private key here. Enter the "raw" content of the key, without modifying it. The lines "-----BEGIN PRIVATE KEY-----" and "-----END PRIVATE KEY-----" must also be included.
The other parameters to configure are common to all instances:
Room name: This is the name that your video conference room will have. This name will be part of the main link that allows all participants to connect. Therefore, to limit the risk of unwanted visitors in your conference, try to choose a more complex name for your room! Spaces between words will be automatically replaced by underscores.
Room subject: Subject of the conference room. This is a simple description that, if you want, can be visible to participants.
Default language: If necessary, you can change the default language of your conference interface here. Only 2-digit language codes are allowed (such as: en, it, es, de, etc...)
Load jQuery: This is used to load the jQuery library in case it is not already loaded by the template in use. If the conference does not open, try enabling this parameter.
jQuery fix: If the conference does not open, try enabling this parameter as well. Sometimes some Joomla templates load the jQuery library after the JooJitsi Conferencing scripts. This parameter allows you to reverse this order and solve any problems of this type.
