=== Wise Chat === Contributors: marcin.lawrowski Donate link: http://kaine.pl/projects/wp-plugins/wise-chat-donate Tags: chat, plugin, ajax, javascript, shortcode, social, widget, responsive Requires at least: 3.6 Tested up to: 4.2 Stable tag: 1.6.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Just another chat plugin for WordPress. It requires no server, supports multiple channels, bad words filtering, appearance settings, bans and more. == Description == The plugin displays a fully customizable chat window on WordPress pages, posts or templates. = List of features: = * easy installation using widget, shortcode or function (PHP) * fully responsive and mobile ready * no server required * three themes ready to use * multiple channels (chat rooms) support * channels statistics (active users, published messages) * channels moderation (removing single messages) * emoticons support * posting links and images (downloaded and stored into Media Library) * posting pictures from camera (images uploader) * multiple chat instances on the same page * language localization for end-users * custom filters (modifying messages on the fly) * built-in bad words filter (supports English and Polish languages) * flexible cofiguration page (general settings, messages posting control, appearance, channels statistics, bans control and localization) * colors adjustments * blocking IP addresses from posting messages (bans) * auto-blocking IP addresses for abuses (auto-bans) * anonymous users (temporary user name with configurable prefix) * logged in users (WordPress user name) * option to allow access for logged in users only * chat user settings (e.g. name changing) * list of current users * messages history (recently published messages in input field) * Twitter hash tags support All settings are available on `Settings -> Wise Chat Settings` page. **See screenshots for detailed features.** == Installation == 1. Upload the entire `wise-chat` folder to the `/wp-content/plugins/` directory. 1. Activate the plugin through the 'Plugins' menu in WordPress. 1. Place a shortcode `[wise-chat]` in your posts or pages. 1. Alternatively install it in your templates via `` code. 1. Alternatively install it using dedicated widget in `Appearance -> Widgets`, it's called `Wise Chat Window`. = Requirements: = * jQuery JS library (available in most themes) * mbstring PHP extension (in order to use all features of bad words filter) = Post Installation Notices: = * After installation go to Settings -> Wise Chat Settings page, select Localization tab and translate all messages into your own language. * Posting pictures from camera / local storage is limited to the specific range of Web browsers. See FAQ for details. == Frequently Asked Questions == = How can I specify a channel to open? = It can be done via the short code: `[wise-chat channel="my-channel"]` or in PHP: `` or in the widget: set desired channel name in Channel configuration field. = How can I install the chat using the widget? = Go to Appearance -> Widgets page, drag and drop "Wise Chat Window" widget on desired sidebar. Channel name for the widget can be specified as well. = How can I localize the chat for end-user? = Go to Settings -> Wise Chat Settings page, select Localization tab and translate texts in each field into your own language. = What about support for mobile devices? = Wise Chat 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". = How does the bad words filter work? = The plugin has its own implementation of bad words filtering mechanism. Currently it supports two languages: English and Polish. 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). = Are there other shortcode options? = Yes, they are. Here is an example with full range of options: `[wise-chat channel="my-channel" restrict_to_wp_users="0" messages_limit="30" message_max_length="500" allow_post_links="1" allow_post_images="1" enable_images_uploader="1" enable_message_actions="0" enable_twitter_hashtags="1" theme="colddark" background_color="" background_color_input="" text_color="" text_color_logged_user="" chat_width="100%" chat_height="270px" window_title="Wise Chat Room" show_user_name="1" link_wp_user_name="0" link_user_name_template="http://my.website.com/users/{username}/profile" show_message_submit_button="1" allow_change_user_name="1" emoticons_enabled="1" multiline_support="0" show_users="0" filter_bad_words="1" enable_autoban="0" autoban_threshold="3" hint_message="Enter message here" user_name_prefix="Anonymous" message_submit_button_caption="Send" message_save="Save" message_name="Name" message_customize="Customize" message_sending="Sending ..." message_error_1="Only letters, number, spaces, hyphens and underscores are allowed" message_error_2="This name is already occupied" message_error_3="You were banned from posting messages" message_error_4="Only logged in users are allowed to enter the chat" ajax_engine="lightweight" messages_refresh_time="3000"]` = How to ban a user? = Log in as an administrator and type the command: `/ban [UserName] [Duration]` where "UserName" is the choosen user's name and "Duration" is constructed as follows: 1m (a ban for 1 minute), 7m (a ban for 7 minutes), 1h (a ban for one hour), 2d (a ban for 2 days), etc. Notice: IP addresses are actually blocked. Alternatively you can go to Settings -> Wise Chat Settings page, select Bans tab, fill IP address and duration fields and finally click "Add Ban" button. = How to get the list of banned users? = Log in as an administrator and type the command: `/bans` or go to Settings -> Wise Chat Settings page and select Bans tab. = How to remove a ban of an user? = Log in as an administrator and type the command: `/unban [IP address]` or go to Settings -> Wise Chat Settings page, select Bans tab and then delete desired ban from the list. = How can I use the messages history feature? = Click on the message input field and use arrow keys (up and down) to scroll through the history of recently sent messages. = How can I prevent from accessing the chat by anonymous users? = Go to Settings -> Wise Chat Settings page, select General tab and select "Only For Logged In Users" option. = How does auto-ban feature work? = There is a counter for each user. Everytime an user uses a bad word in a message the counter is incremented. If it reaches the threshold (default - 3 abuses) the user is banned for 1 day. = How as an administrator can I delete single message from the channel? = Go to Settings -> Wise Chat Settings, select Messages tab and enable "Enable Admin Actions" option. From now each message in each channel has its own delete button ("X" icon). The button appears only for logged in administrators. = 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, bmp, tiff or png), HTTP status code of the response must be equal 200, image cannot be larger than 2MB. Try to read PHP logs in case of problems. = What if I would like the images to be opened in a popup layer? = By default all images open using Lightbox library but only if the library is installed. Without Lightbox each image opens in the new tab / window. = 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 can I 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 occurence of the phrase will be replaced by desired text in every message that is posted to any chat channel. = Chat window is showing up but it does not work. I cannot receive or send messages. What is wrong? = Ensure that jQuery library is installed in your theme. Wise Chat cannot operate without jQuery. = Wise Chat plugin is making a lot of long-running HTTP requests. How to improve the performance? = Every 3 seconds the plugin checks for new messages using AJAX request. By default admin-ajax.php is used as a backend script and this script has poor performance. However, it is the most compatible solution. If you want to reduce server load try to change "AJAX Engine" property to "Lightweight AJAX". It can be set on Settings -> Wise Chat Settings page, select Advanced tab and then select "Lightweight AJAX" from the dropdown list. This option enables dedicated backend script that has a lot better performance. == Screenshots == 01. Simple configuration 02. Pictures posting, links, customizations, users list 03. Themes comparison: Default, Light Gray, Cold Dark 04. Preview on mobile - Light Gray theme 05. Preview on mobile - Cold Dark theme 06. Settings page - compilation of all tabs == Changelog == = 1.6 = * Three themes * Twitter hash tags support * Custom filters (filtering texts, hyperlinks, e-mails and phrases that match a regular expressions) * Chat window title * Advanced configuration (AJAX engine and refresh time) * Lightweight AJAX engine = 1.5 = * Posting images (stored in Media Library) * Images uploader - posting pictures from camera (in case of mobile devices) or from local storage (in case of desktop) * List of users in the side bar * Flexible messages list on small devices * Option to moderate channels by removing single messages = 1.4 = * Configurable width and height of the chat window * Channels statistics on settings page, including message and active users counters * User name to link conversion template * Emoticons support * Auto-ban feature * Multiline messages support = 1.3 = * Messages history (using arrow keys) in input field * Posting links in chat messages * Linking WP user name to the author page * Fixed bug with duplicated messages in chat window * Message submit button * Rearrangements of the settings page * Language localization of end-user messages and texts * Timezones support * Access only for logged in WP users = 1.2 = * Wise Chat widget * Option to allow unlogged user change his/her name * Option to show user's name * Bans control on settings page * Changing text color of a logged in user = 1.1 = * Minor rearrangements of the settings panel = 1.0 = * Initial version == Upgrade Notice ==