timeoutOffline and timeoutLogout

New features to handle chat idles.

timeoutOffline :

You can now set the status of an user as offline after N seconds of inactivity (idle) in your chatadmin config  : timeoutOffline (put 0 if you don’t need that feature)

If user leaves the inactivity, he retries his former status.

 

timeoutLogout

You can also disconnect an user after N seconds of inactivity in your chatadmin config: timeoutLogout (put 0 if you don’t need that feature)

Where to find that option ?

in : chatadmin / config / users management

 

Chat Contest feature

New feature : Chat contest

Roles can now enter a chat contest. A contest is simply when a chatter votes for another chatter.

A chatter can only vote once for another chat. He awards him 1 point.

You can enable a contest in the “roles” chat admin and reset the votes in your chatadmin panel as well.

When a vote is sent, a notification is sent to both users.

In your chatadmin, you also have the TOP 10 votes.

trial version

Message for no registered users

Possible scenario : your website runs a dating site where you can free users (role = guest) and paid users (role = user).

Of course free guest users cannot access all features that a paid user has.

Ex: a guest user cannot request a private chat.

We have 2 ways to solve that:

  1. this feature is hidden to the guest user.
  2. This feature is visible to the guest user, but when he tries to access it, he has a message box that explicitly tells him: “you cannot access that feature”.

The pro of this second solution, is to incite the user to become a paid user on your site.

How to enable this second solution : go to your /chatadmin panel as usually and choose the “trial version chat messages”

If you specify the Url to be rediercted, the user will be redirected to that url, after he shows the message: this url will be probably the “purchase” or “register” page on your website.

adult rooms

New feature: you can now assign rooms as adult room

When a new user enters an adult room, you can choose 3 actions.

These actions are defined in the security panel

You can :

  • do nothing
  • Warn an user it is adult
  • Hide the room if user is minor of 18

The case “Hide the room if user is minor of 18”, implies you know the age of the user. We added the “age” on the registration panel.

If you use JWT to inject your data, then you can use that extra field:

birthyear

to add the year of birth of the user

ex: birthyear:1995

 

You can also use

seenByAdultOnly

that means that this member will be seen only by adults (if seenByAdultOnly=1)

 

start

How to directly enter a room ?

(UPDATED – fixed bug)
New feature: It is now possible to join a particular room directly at login

2 cases

Let suppose you want to join room id : 1620
(you can find out your room id in your chatadmin)

https://html5-chat.com/chat/54/?startRoom=1620

 

  1. if you don’t use JWT authentification, just pass the url parameter startRoom
    ?startRoom=1620
  2. You do use JWT to login, then just inject the parameter: startRoom: id
roomid
Where to find the room id ?

 

so for room : 1620, you just need to add

'startRoom'=>1620

So for instance your JSON will be:

 

$json = json_encode(array('username'=>'myUsername', 'password'=>'myChatAccountPassword', 'gender'=>'male', 'role'=>'user', 
'image'=>base64_encode('https://html5-chat.com/img/malecostume.svg'), 'profile'=>'https://monsite.com/profile/myUserername', 'startRoom'=>1620));
Users

Registered and guest users together !

We have added a new mixed mode to enter the chat.
For now you could Both mode

  • guest : any one can connect to chat and only have to provide the username and the gender
  • user : before an user connects, user must register and provide his data such gender, email, password

We have now a new mode, a mixed mode, that allows to enter as user (providing registered username and password), but also as guest.

mixed mode
mixed mode

How to activate the mixed mode ?

go your chatadmin, chat config, then choose one of the 3 selections in “Enter chat mode” input select.

Note: This of course is useless if you use the jwt authentification, since in JWT, you can explicitly assign an username, gender and role.

rest

REST API for HTML5 chat (updated)

New HTML5 features REST API available (updated Nov 2020)

These features are only for SUBSCRIBED ussers.

-> Log in into your chatadmin / developers panel to get your REST API URL.

We are adding new REST interfaces that allow users to get some informations about their chat.

The pattern is:

https://YOUR_REST_API_LINK:2083/{action}/{webmasterid}/{token}

For now we added these REST APIs:


getNumberUsers: allows to get the number of users in all rooms in chat!

This example is for : webmasterid = 1 token = 999

https://YOUR_REST_API_LINK:2083/getNumberUsers/1/999


getUsers : get all users in all rooms in chat

This example is for : webmasterid = 1 token = 999

https://YOUR_REST_API_LINK:2083/getUsers/1/999


getPerformers : get all performers in a namespace webmasterid (performers = users whose role = ‘performer’)

This example is for : webmasterid = 1 token = 999

https://YOUR_REST_API_LINK:2083/getPerformers/1/999



getOnlinePerformers : get all online performers in a namespace webmasterid (performers = users whose role = ‘performer’)

This example is for : webmasterid = 1 token = 999

https://YOUR_REST_API_LINK:2083/getOnlinePerformers /1/999


getUserStatus: get the status of userid in a namespace webmasterid  (returns: “online” or “offline”  or “busy”)

This example is for : webmasterid = 1 userid= 300

https://YOUR_REST_API_LINK:2083/getUserStatus/1/300


getUsersInRoom: get all users in a room roomid of namespace webmasterid

This example is for : webmasterid = 1 roomid = 50

https://YOUR_REST_API_LINK:2083/getUsersInRoom/1/50/token


getNumberUsersInRoom: return the number of users of a room roomid in namespace webmasterid

This example is for : webmasterid = 1 roomid = 50, token=999

https://YOUR_REST_API_LINK:2083/getNumberUsersInRoom/1/50/999


How to use that in php for instance: (we suppose your YOUR_REST_API_LINK is https://chat.html5-chat.com which can be DIFFERENT on your website: connect to chatadmin -> developers  to get yours)

$numberOfUsers = file_get_contents("https://chat.html5-chat.com:2083/getNumberUsers/1/50/999");

getRooms: return your chat rooms.

This example is for : webmasterid = 1, token=999

https://YOUR_REST_API_LINK:2083/getRooms/1/999


How to use that in php for instance: (we suppose your YOUR_REST_API_LINK is https://chat.html5-chat.com which can be DIFFERENT on your website: connect to chatadmin -> developers  to get yours)

$rooms = json_decode(file_get_contents("https://chat.html5-chat.com:2083/getRooms/1/999"));
print_r($rooms)
award

Promote users in real time and assign roles per room

Promote users in real time and assign roles per room

you can assign roles per user AND per room and you can even do that in real time and be permanent or temporary.

roles-usersWhat you need to know

  1. be sure guest users are disabled. (You cannot assign to guest users since they are temporary users !)
  2. Be sure in your role, you configure the 2 fields:
    “canPromote”: this fields gives the opportunity to that role to assign roles in real time (ex: admin and moderator can promote by default. Other roles should not be able to promote)
    “canBePromoted”: only these roles are eligible to be promoted (ex: admin user should not be promoted : it has already the highest possible rank !)
  3. You can now set a role to a specific user :
    – you can do that within your chatadmin , in users panel
    – You can do that in real time: click on user : you will get the contextual menu. Choose “Promote user” menu item.
    you will get the modal Box that allows to choose the user to be promoted and the list of available roles.promoteUser2promoteUser
ladiesOnly

Ladies welcome

Allow specific room entrance by gender

ladiesHTml5 chat new features allows now to restrict the entrance to a specific room by gender.

Scenario: you want to restrict a room “ladies only”. You can do that thanks to the rooms panel in your chatadmin.

Select the gender (or leave to no restrictions) :

only these genders will have the permission to access that particular room.