Wise Chat

FAQ

How to create a channel and open it?

Place the following short code in your page or post:
[wise-chat channel=”My Chat Room”]
or add this PHP snippet in a template file:

or put “Wise Chat Window” widget on the desired sidebar and set the desired channel name in Channel field.

The channel will be created during the first usage and it will be added to the list of channels on Wise Chat Settings page in the Channels tab.

I see “Loading the chat …” and the chat does not show up. What is wrong?

It means that the chat cannot start due to some errors. First, please try to check JS Console (in Chrome of Firefox) in search for any error message. Then please try to fix them. If an error comes from Wise Chat then please let us know it. We will do our best to help you.
Otherwise please contact the support of other plugins / themes that you suspect are causing issues. After fixing all errors in the JS Console the chat should start properly.

If you do not see any errors in the console then please try to disable any security plugin you use. They may be blocking the connection between the chat and your server.
After finding a plugin that is blocking the chat try to add an exception to it. Basically, security plugins should avoid this particular URL:

https://yourdomain/wp-content/plugins/wise-chat/src/endpoints

You may also read this doc.

I have iThemes Security plugin and Wise Chat does not work. How to fix it?

Short answer: WP Dashboard > Security > Settings > Advanced > System Tweaks and uncheck “Disable PHP in Plugins”. Then click Save button.

Advanced answer: Edit .htaccess file and locate “#Disable PHP in Plugins – Security > Settings > System Tweaks > PHP in Plugins” line. Then add a line of code:

RewriteCond %{REQUEST_URI} !/wp-content/plugins/wise-chat/.*$ [NC]
RewriteRule ^wp-content/plugins/.*.(?:php[1-7]?|pht|phtml?|phps).?$ – [NC,F,L]

Less recommended approach: WP Dashboard -> Settings -> Wise Chat Settings -> AJAX Engine and set to Default. This solution is less efficient.

Explanation: Wise Chat executes PHP files directly in /wp-content/plugins/wise-chat/src/endpoints/ultra directory. It is done strictly for performance because the standard admin-ajax.php endpoint is too slow.

How to give access to Wise Chat Settings page to other user roles?

Please add ‘manage_wise_chat_option’ capability to any user role you wish to grant access to Wise Chat Settings page to.
By default only administrators have access to this page.

My messages are not visible until I refresh the page. What is going on?

In order to get new messages the chat is requesting the following URL:

https://yourdomain/wp-content/plugins/wise-chat/src/endpoints

It is very likely the URL is is forbidden in your setup (403 error). It may be caused by a security plugin or theme. A specific configuration of HTTP server (.htaccess file or server settings) may be the reason too. Please ask your server administrator to make the URL accessible.

You may also read this doc.

How to create a password-protected private channel?

First, create a regular channel (see the previous question) and then go to Settings -> Wise Chat Settings page, select Channels tab. In the right to the chosen channel click “Password” link and a form will appear below. Specify the password and confirm it by clicking “Set Password” button. From now the channel is secured and only users that enter valid password are allowed to join.

How to convert a password-protected channel into an open channel?

Go to Settings -> Wise Chat Settings page, select Channels tab. In the right to the chosen channel click “Password” link and a form will appear below. Click “Delete Password” button.

How to install the chat using a widget?

Go to Appearance -> Widgets page, drag and drop “Wise Chat Window” widget on the desired sidebar. The name of the channel can be specified as well.

I can’t see translation for my language. How to localize the chat for end-user?

You can do it by yourself. Go to Settings -> Wise Chat Settings page, select Localization tab and translate texts in each field into your own language. These are all texts that are exposed to end-users.

What about the support for mobile devices and responsiveness?

Wise Chat plugin works on any mobile device that supports Javascript and cookies. The interface is responsive, but you should enable submit button in order an user could send a message. Go to Settings -> Wise Chat Settings page, select Appearance tab and select checkbox “Show Submit Button”.

The chat generates anonymous names for every new user. How to force every user to choose their name on first use?

You can enable a form that appears every time a new user tries to enter the chat. The form displays username field and allows to enter the chat only if the user type his/her name. Settings -> Wise Chat Settings page, select General tab and select option “Force Username Selection”.

How does the bad words filter work?

The plugin has its own implementation of bad words filtering mechanism. Currently it supports three languages: English, Polish and German. It is turned on by default. It detects not only simple words but also variations of words like: “H.a.c_ki.n_g” (assuming that “hacking” is a bad word).

How to mute user? It prevents users from posting messages

Log in as an administrator and go to Settings -> Wise Chat Settings page, select Moderation tab. Enable “Mute Action” option next to the user role you want to add a permission to mute users to. Go to the chat page.
When you move the cursor over a message you will see mute button. This will mute the user who posted the message for 1 day.

Alternatively, you can go to Settings -> Wise Chat Settings page, select Muted Users tab. In “Mute IP” row specify: IP address, duration and finally click “Mute IP” button.

How to get the list of muted users?

Go to Settings -> Wise Chat Settings page and select Muted Users tab.

How to stop muting user?

Go to Settings -> Wise Chat Settings page, select Muted Users tab and then delete the desired user from the list.

How to ban users? It prevents users from accessing the chat

Log in as an administrator and go to Settings -> Wise Chat Settings page, select Moderation tab. Enable “Ban Action” option next to the user role you want to add a permission to ban users to. Go to the chat page.
When you move the cursor over a message you will see ban button. This will ban the user who posted the message.

Alternatively, you can go to Settings -> Wise Chat Settings page and select Banned Users tab. In “Ban IP” row specify the IP address and click “Ban IP” button.

How to get the list of banned users?

Log in as an administrator, go to Settings -> Wise Chat Settings page and select Banned Users tab.

How to remove a banned IP address?

Log in as an administrator, go to Settings -> Wise Chat Settings page, select Banned Users tab and then delete the desired IP address from the list.

How to get some information (e.g. IP address) about an user?

管理者としてログインし、次のコマンドを入力します。
/whois[ユ​​ーザー名]
ここで、「UserName」は選択したユーザーの名前です。

How to prevent from accessing the chat by anonymous users?

Go to Settings -> Wise Chat Settings page, select General tab and check “Disable Anonymous Users” option. From now a visitor has to be logged in as a regular WordPress user in order to access the chat.

How does auto-mute feature work?

There is a counter for each user. Every time an user types a bad word in a message the counter is increased. If it reaches the threshold (by default set to 3) the user is muted for 1 day (the duration is configurable).

How to delete a single message from the channel?

Log in as an administrator. Go to Settings -> Wise Chat Settings, select Moderation tab and enable “Delete Action” option next to the user role you want to add a permission to delete messages to. Go to the chat page.
When you move the cursor over a message you will see delete button. This will delete the message.

Alternatively: add “wise_chat_delete_message” capability to a role you want to have that permission. It could be either standard WordPress role or a custom role.

How does “Enable Images” option actually work?

If you enable “Enable Images” option every link posted in the chat which points to an image will be converted into image. The image will be downloaded into Media Library and then displayed on the chat window. Those downloaded images will be removed from Media Library together with the related chat messages (either when removing all messages or a single one). If an image cannot be downloaded the regular link is displayed instead.

Option “Enable Images” does not work. I see regular hyperlinks instead of images. What is wrong?

The option requires a few prerequisites in order to operate correctly: GD and Curl extensions must be installed, Media Library must operate correctly, posted image link must have a valid extension (jpg, jpeg, gif or png), HTTP status code of the response must be equal 200, image cannot be larger than 3MB (the default limit that can be adjusted in settings). Try to read PHP logs in case of any problems.

What if I would like the images to be opened in a popup layer using Lightbox?

By default all images open using Lightbox 2 library but only if the library is installed within current theme or a dedicated plugin. Without Lightbox 2 each image opens in the new tab / window.

I have installed a plugin containing Lightbox library and newly added messages are not displayed on the Lightbox layer. What is wrong?

If you installed a plugin that incorporates Lightbox library and it still doesn’t work make sure that the plugin uses original Lightbox 2 Javascript library. The chat is compatible only with the original Lightbox 2 library.

Image uploader does not work. What is wrong?

Uploading of images is supported in the following Web browsers: IE 10+, Firefox 31+, Chrome 31+, Safari 7+, Opera 27+, iOS Safari 7.1+, Android Browser 4.1+, Chrome For Android 41+.

How to replace specific phrase in every message posted by users?

You can use filters feature. Go to Settings -> Wise Chat Settings, select Filters tab and add new filter. From now each occurrence of the phrase will be replaced by the defined text in every message that is posted to any chat channel.

Wise Chat plugin is making a lot of HTTP requests. How to improve the performance?

Every few seconds the plugin checks for new messages using AJAX requests. Please check this article for details.

How to customize CSS styles using “Custom CSS Styles” setting?

All CSS classes related to the chat begins with “wc” prefix. Go to Settings -> Wise Chat Settings, select Appearance tab, go to Advanced Customization section. Use “Custom CSS Styles” field to specifiy your own definitions of Wise Chat CSS classes. Valid CSS syntax is required.

How to backup messages posted in a channel? I would like to save all messages for offline reading.

Go to Settings -> Wise Chat Settings, select Channels tab and click “Backup” link next to the desired channel. All messages from the selected channel will be downloaded as a CSV file. You can open it using MS Excel, OpenOffice or any other editor that supports CSV format.

Are old messages being deleted from the chat window?

By default – no, however, you can enable auto-cleaning messages feature. Go to Settings -> Wise Chat Settings, select Channels tab. In the field “Auto-remove Messages” type number of minutes. Messages older than given amount of minutes will be auto-deleted.

How to limit the amount of users that are allowed to enter a channel?

Go to Settings -> Wise Chat Settings, select Channels tab. In the field “Users Limit” type number of users that allow to participate in a channel.

How to reset username prefix (a number that is added to anonymous users name) anonymous users?

Go to Settings -> Wise Chat Settings, select Advanced tab and click “Reset Username Prefix” button.

When I upload an animated GIF the thumbnail is not animated. What is wrong?

WordPress はアニメーション GIF のサイズ変更をサポートしていません。

Why I can change the background color of the chat window, but I cannot change the background color of the input field, buttons or borders?

It is impossible to provide options to customize every aspect of user interface. Please use CSS styles to adjust styles to your needs.

I have uploaded a picture with incorrect orientation and the plugin did not corrected it. What is wrong?

Plugin detects EXIF data in images. If an image doesn’t have this data then nothing will happen. If EXIF data indicates that the orientation is correct then also nothing will happen.

I am experiencing errors like “Fatal error: Call to undefined function openssl_pkey_get_public() (…)”. What is wrong?

PHPインストールのopenssl拡張機能がロードされ、正しく機能することを確認してください。ほとんどの場合、これらのエラーは、opensslモジュールがないことが原因で発生します。

How to send messages using just keyboard in multiline mode?

After you type a message use the key combination: Shift + ENTER