# Changelog ## 3.0.0 (Unreleased) - **Breaking changes**: * Callbacks for `converse.on` now no longer receive an event object as first parameter. * The API has been split into public and private parts. The private API methods are now only available to plugins. For more info, read [developer API](https://conversejs.org/docs/html/developer_api.html) and the [plugin_development](https://conversejs.org/docs/html/plugin_development.html) documentation. * To prevent confusion the private, closured object, only available to plugins, has been renamed from `converse` to `_converse`. The public API is accessible via a global `converse` object. * The `keepalive` and `roster_groups` options are now set to `true` by default. - Created a new non-core plugin `converse-muc-embedded` which embeds a single chat room into a page. An example can be found at https://conversejs.org/demo/embedded.html [jcbrand] - Use lodash instead of underscore.js [jcbrand] - Case insensitive matching of moderation commands. [jcbrand] - Add `/subject` as alias to `/topic` [jcbrand] - `allow_chat_pending_contacts` now defaults to `true` [jcbrand] - Improved roster filter UX. [jcbrand] - Render the login form again upon authfail. [jcbrand] - New promises API: [waitUntil](https://conversejs.org/docs/html/developer_api.html#waituntil) [jcbrand] - New configuration setting: [show_chatstate_notifications](https://conversejs.org/docs/html/configuration.html#show-chatstate-notifications) [jcbrand] - New configuration setting: [whitelisted_plugins](https://conversejs.org/docs/html/configuration.html#whitelisted-plugins) [jcbrand] - New configuration setting: [blacklisted_plugins](https://conversejs.org/docs/html/configuration.html#blacklisted-plugins) [jcbrand] - The API now no longer returns wrapped chatboxes (or rooms) but instead a Backbone.View object. This means the API of the returned object has changed. You're still able to do everything from before but now also much more. [jcbrand] - Allow JIDs not on the roster to be invited to a chatroom. [jcbrand] - Bugfix. `TypeError: this.sendConfiguration(...).then is not a function` when an instant room is created. [jcbrand] - Ensure consistent behavior from `show_controlbox_by_default` [jcbrand] - #694 The `notification_option` wasn't being used consistently. [jcbrand] - #770 Allow setting contact attrs on chats.open [Ape] ## 2.0.6 (2017-02-13) - Escape user-generated input to prevent JS-injection attacks. (Thanks to SamWhited) [jcbrand] - #486 Honor existing mam user configuration [throwaway42] - #749 /me will show your contact's name in the sent field [jcbrand] - #774 Browser language (fr-fr or fr) is not detected by default [jcbrand] - #775 Anonymous login form is a text field instead of a push button [jcbrand] ## 2.0.5 (2017-02-01) - #743, #751, #753 Update to Strophe 1.2.12. SASL-EXTERNAL now has reduced priority, so it won't be prioritized above other auth mechanisms. [jcbrand] - #755: create composer.json to add this project in packagist.org [fabiomontefuscolo] - #758: Bugfix. Render all resize drag handles for ChatRoomView. [LeoYReyes] - #762 Allow chatting with users not in your roster. [Ape, jcbrand] - Bugfix. Cancel button shown while registration form is being fetched wasn't working properly. [jcbrand] - Bugfix. Login form wasn't rendered after logging out (when `auto_reconnect` is `true`). [jcbrand] - Bugfix. Properly disconnect upon "host-unknown" error. [jcbrand] - Bugfix. Minimized chats weren't removed when logging out. [jcbrand] - Security fix: Prevent message forging via carbons. (Thanks to ge0rg) [jcbrand] ## 2.0.4 (2016-12-13) - #737: Bugfix. Translations weren't being applied. [jcbrand] - Fetch room info and store it on the room model. For context, see: http://xmpp.org/extensions/xep-0045.html#disco-roominfo [jcbrand] - Bugfix. Switching from bookmarks form to config form shows only the spinner. [jcbrand] - Bugfix. Other room occupants sometimes not shown when reloading the page. [jcbrand] - Bugfix. Due to changes in `converse-core` the controlbox wasn't aware anymore of disconnection or reconnection events. [jcbrand] - Optimize fetching of MAM messages (in some cases happened on each page load). [jcbrand] - Fix empty controlbox toggle after disconnect. [jcbrand] - When inviting someone to a members-only room, first add them to the member list. [jcbrand] - New configuration setting [muc_disable_moderator_commands](https://conversejs.org/docs/html/configuration.html#muc-disable-moderator-commands) [jcbrand] ## 2.0.3 (2016-11-30) - #735 Room configuration button not visible. [jcbrand] - CSS fix for fadeIn animation. [jcbrand] ## 2.0.2 (2016-11-30) - #721 keepalive not working with anonymous authentication [jcbrand] - #723 Bugfix: Arrays in configuration settings were ignored. [jcbrand] - #734 Bugfix. `converse.rooms.open` ignored the `muc_nickname_from_jid` setting. [jcbrand] - Enable new rooms to be configured automatically, with a default config, via `rooms.open`. For details, refer to the [relevant documentation](https://conversejs.org/docs/html/developer_api.html#the-rooms-grouping) [jcbrand] - Bugfix: Chatboxes aren't closed when logging out. [jcbrand] - Bugfix: Trying to save data on the `ControlBox` model before `ChatBoxes` collection has its `browserStorage` configured. Causes `Error: A "url" property or function must be specified`. [jcbrand] - Don't open the controlbox on contact requests. [jcbrand] - Bugfix: Reconnection fails when original connection was never established. [jcbrand] - If a `credentials_url` is provided, then keep on attempting to reconnect when connection is down. [jcbrand] - Remove (undocumented) `callback` config parameter for `converse.initialize`. Instead, `converse.initialize` returns a promise which will resolve once initialization is complete. [jcbrand] - New event ['reconnecting'](https://conversejs.org/docs/html/development.html#reconnecting) [jcbrand] - New configuration setting [allow_bookmarks](https://conversejs.org/docs/html/configuration.html#allow-bookmarks) [jcbrand] - The `rooms.open` API method will no longer maximize rooms that are minimized (unless `maximize: true` is passed in). [jcbrand] ## 2.0.1 (2016-11-07) - #203 New configuration setting [muc_domain](https://conversejs.org/docs/html/configuration.html#muc-domain) [jcbrand] - #705 White content after submitting password on chatrooms [jcbrand] - #712 Controlbox clicks stop responding after auto-reconnect [jcbrand] - Removed shared state between tests. All tests are now isolated. [jcbrand] - Allow the context (i.e. `this` value) to be passed in when registering event listeners with `converse.listen.on` and `converse.listen.once`. [jcbrand] - New event ['rosterContactsFetched'](https://conversejs.org/docs/html/development.html#rosterContactsFetched) [jcbrand] - New event ['rosterGroupsFetched'](https://conversejs.org/docs/html/development.html#rosterGroupsFetched) [jcbrand] - HTML templates are now loaded in the respective modules/plugins. [jcbrand] - Start improving Content-Security-Policy compatibility by removing inline CSS. [mathiasertl] - Add support for XEP-0048, chat room bookmarks [jcbrand] - New configuration setting [connection_options](https://conversejs.org/docs/html/configuration.html#connection-options) [jcbrand] ## 2.0.0 (2016-09-16) - #656 Online users count not shown initially [amanzur] - #674 Polish translation updated [ser] - Backwards incompatible change: the `_super` attribute in plugins is now named `__super__`. [jcbrand] - Continuously attempt to resurrect dead connections when `auto_reconnect` is `true`. [jcbrand] - Update the 'rooms' API to allow user to pass in room attributes. [jcbrand] - New configuration setting [message_storage](https://conversejs.org/docs/html/configuration.html#message-storage) [jcbrand] - Hardcode the storage for roster contacts and chatroom occupants to `sessionStorage`. [jcbrand] - Fixed wrong chat state value, should be `chat`, not `chatty`. See [RFC 3921](https://xmpp.org/rfcs/rfc3921.html#rfc.section.2.1.2.2). [jcbrand] - Adds support for SASL-EXTERNAL. [jcbrand] ## 1.0.6 (2016-08-12) - #632 Offline and Logout states do not properly update once users start chatting. [chrisuehlinger, jcband] - #674 Polish translation updated to the current master. [ser] - #677 Chatbox does not open after close. [jcbrand] - The behavior of `converse.chats.get` has changed. If the chat box is not already open, then `undefined` will be returned. [jcbrand] - Typing (i.e. chat state) notifications are now also sent out from MUC rooms. [jcbrand] - `ChatRoomView.onChatRoomMessageSubmitted` has been renamed to `onMessageSubmitted`, to make it the same as the method on `ChatBoxView`. [jcbrand] - New configuration setting [muc_nickname_from_jid](https://conversejs.org/docs/html/configuration.html#muc-nickname-from-jid) [jcbrand] - New configuration setting [muc_instant_rooms](https://conversejs.org/docs/html/configuration.html#muc-instant-rooms) [jcbrand] ## 1.0.5 (2016-07-28) - In case of nickname conflict when joining a room, allow the user to choose a new one. [jcbrand] - Check whether the user has a reserved nickname before entering a room, and if so, use it. [jcbrand] - Mention someone in your chat room message by clicking on their name in the occupants list. [jcbrand] - #645 When accepting a contact request, the contact didn't appear in the pending contacts group. [jcbrand] - Bugfix: allow multiple MAM queries to be made simultaneously. [jcbrand] ## 1.0.4 (2016-07-26) - Restrict occupants sidebar to 30% chatroom width. [jcbrand] - Made requesting contacts more visible, by placing them at the top of the roster. [jcbrand] - `insertIntoPage` method of `ChatBoxView` has been renamed to `insertIntoDOM`, to make it the same as the method of `ChatRoomView`. [jcbrand] - Render error messages received from the server (for undelivered chat messages). [jcbrand] - Don't hide requesting contacts when filtering by chat state. [jcbrand] - When logging in anonymously, the server JID can now be passed in via `converse.initialize` or via `converse.user.login`. [jcbrand] ## 1.0.3 (2016-06-20) - Update the plugin architecture to allow plugins to have optional dependencies [jcbrand] - Bugfix. Login form doesn't render after logging out, when `auto_reconnect = false` [jcbrand] - Also indicate new day for the first day's messages. [jcbrand] - Chat bot messages don't appear when they have the same ids as their commands. [jcbrand] - Updated onDisconnected method to fire disconnected event even if `auto_reconnect = false`. [kamranzafar] - Bugfix: MAM messages weren't being fetched oldest first. [jcbrand] - Add processing hints to chat state notifications [jcbrand] - Don't use sound and desktop notifications for OTR messages (when setting up the session) [jcbrand] - New config option [default_state](https://conversejs.org/docs/html/configuration.html#default_state) [jcbrand] - New API method `converse.rooms.close()` [jcbrand] - New configuration setting [allow_muc_invites](https://conversejs.org/docs/html/configuration.html#allow-muc-invites) [jcbrand] - Add new event [pluginsInitialized](https://conversejs.org/docs/html/development.html#pluginsInitialized) [jcbrand] - #553 Add processing hints to OTR messages [jcbrand] - #650 Don't ignore incoming messages with same JID as current user (might be MAM archived) [jcbrand] - #656 online users count in minimized chat window on initialization corrected [amanzur] ## 1.0.2 (2016-05-24) - Bugfix. Bind `sendPresence` to the right context. Bug that slipped in during the release of `1.0.1`. [jcbrand] ## 1.0.1 (2016-05-24) - Bugfix. Roster filter sometimes gets hidden when it shouldn't. [jcbrand] - Chat boxes weren't being initialized due to typo. [jcbrand] - Flush request queue just after connection. Solves a problem with PubSub and Prosody, whereby BOSH HTTP responses weren't being received. [jcbrand] ## 1.0.0 (2016-05-03) - Add catalan language [JoseMariaRubioMoral] - Split converse.js up into different plugin modules. [jcbrand] - Better Sass/CSS for responsive/mobile views. New mobile-only build. [jcbrand] - Roster contacts can now be filtered by chat state and roster filters are remembered across page loads. [jcbrand] - Add support for messages with type `headline`, often used for notifications from the server. [jcbrand] - Add stanza-specific event listener `converse.listen.stanza`. As a result `converse.listen.on('message');` has been deprecated, use `converse.stanza.on('message');` instead. [jcbrand] - Emit an event `chatBoxInitialized` once a chat box's initialize method has been called. [jcbrand] - Emit an event `statusInitialized` once the user's own status has been initialized upon startup. [jcbrand] - New config option [chatstate_notification_blacklist](https://conversejs.org/docs/html/configuration.html#chatstate-notification-blacklist) [jcbrand] - New config option [sticky_controlbox](https://conversejs.org/docs/html/configuration.html#sticky-controlbox) [jcbrand] - New config option [credentials_url](https://conversejs.org/docs/html/configuration.html#credentials-url) [jcbrand] - Don't play sound notifications for OTR messages which are setting up an encrypted session. [jcbrand] - Bugfix: RID, SID and JID tokens ignored when `keepalive` set to `true`. [jcbrand] - Removed the `account.logout` API, instead use `user.logout`. [jcbrand] - Use `rel=noopener` with links that contain `target=_blank` to prevent potential phishing attacks. [More info here](https://mathiasbynens.github.io/rel-noopener/) [jcbrand] - #156 Add the option `auto_join_rooms` which allows you to automatically connect to certain rooms once logged in. [jcbrand] - #261 `show_controlbox_by_default` config not working [diditopher] - #443 HTML5 notifications of received messages [jcbrand] - #534 Updated Russian translation [badfiles] - #566 Do not steal the focus when the chatbox opens automatically [rlanvin] - #573 xgettext build error: `'javascript' unknown` [jcbrand] - #577 New config variable [message_archiving_timeout](https://conversejs.org/docs/html/configuration.html#message-archiving-timeout) [jcbrand] - #587 Fix issue when logging out with `auto_logout=true` [davec82] - #589 Save scroll position on minimize and restore it on maximize [rlanvin] - #592 Add random resource for `auto_login`, add method generateResource to generate random resource [davec82] - #598 Add option `synchronize_availability` [davec82] - #600 Fix change xmpp status also on icon-status click [davec82] - #616 converse-otr should depend on converse-minimize [jcbrand] - #609 Remove split of fullname [lixmal] ## 0.10.1 (2016-02-06) - #352 When the user has manually scrolled up in a chat window, don't scroll down on chat event notifications. [jcbrand] - #524 Added [auto_join_on_invite](https://conversejs.org/docs/html/configuration.html#auto_join_on_invite) parameter for automatically joining chatrooms. [ben] - #520 Set specific domain. Two new options [default_domain](https://conversejs.org/docs/html/configuration.html#default_domain) and [locked_domain](https://conversejs.org/docs/html/configuration.html#locked_domain). [jcbrand] - #521 Not sending presence when connecting after disconnection. [jcbrand] - #535 Messages not received when room with mixed-case JID is used. [jcbrand] - #536 Presence not sent out (in cases where it should) after page refresh. [jcbrand] - #540 `bind is not a function` error for plugins without `initialize` method. [jcbrand] - #547 By default the `offline` state is no longer choosable. See [include_offline_state](https://conversejs.org/docs/html/configuration.html#include-offline-state) for details. [jcbrand] - A chatroom invite might come from someone not in your roster list. [ben] - #487 Empty the resources array when the resource is null [rlanvin] - #534 Updated Russian translation [LaconicTranslator] - #555 The status restored from sessionStorage is never updated [jcbrand] - #559 Remove reconnection timer once connected succesfully [m0cs] ## 0.10.0 (2015-11-05) **Note:** *This release drops CSS support for IE8 and IE9.* - #459 Wrong datatype passed to converse.chatboxes.getChatBox. [hobblegobber, jcbrand] - #493 Roster push fix [jcbrand] - #403 emit an event `rosterPush` when a roster push happens [teseo] - #502. Chat room not opened in non_amd version. [rjanbiah] - #505 Typo caused [object Object] in room info [gromiak] - #508 "Is typing" doesn't automatically disappear [jcbrand] - #509 Updated Polish translations [ser] - #510 MUC room memberlist is being cleared with page reload when keepalive option is set. [jcbrand] - Add the ability to also drag-resize chat boxes horizontally. [jcbrand] - Updated Sass files and created a new style. [jcbrand] ## 0.9.6 (2015-10-12) - Bugfix. Spinner doesn't disappear when scrolling up (when server doesn't support XEP-0313). [jcbrand] - #462 Fix MUC rooms with names containing special characters not working [1st8] - #467 Fix outgoing chat messages not having a msgid when being put into sessionStorage [1st8] - #468 Fix [object Object] being sometimes shown as status [1st8] - #472 Fix "Cannot read property 'splitOnce' of undefined" when typing /clear in a chat room. [jcbrand] - #493 Roster wasn't being updated after a Roster push update [teseo, jcbrand] - #496 Bugfix. Pings weren't being sent out. [teseo, jcbrand] - #499 Message not received due to non-unique message ids. [jcbrand] ## 0.9.5 (2015-08-24) - #306 XEP-0313: Message Archive Management [jcbrand] - #439 auto_login and keepalive not working [jcbrand] - #440 null added as resource to contact [jcbrand] - Add new event serviceDiscovered [jcbrand] - Add a new configuration setting [muc_history_max_stanzas](https://conversejs.org/docs/html/configuration.html#muc-history-max-stanzas>). [jcbrand] ## 0.9.4 (2015-07-04) - #144 Add Ping functionality and Pong handler [thierrytiti] - #234, #431 Messages aren't received when the user logs in with a mixed-case JID. [jcbrand] - #367 API methods for changing chat status (online, busy, away etc.) and status message [jcbrand] - #389 Allow login panel placeholders and roster item 'Name' translations. [gbonvehi] - #394 Option to allow chatting with pending contacts [thierrytiti] - #396 Add automatic Away mode and XEP-0352 support [thierrytiti] - #400, #410 Allow offline pretty status and placeholder for "Insert a smiley" to be translated [thierrytiti] - #401 Updated French translation [thierrytiti] - #404 CSS fix: position and width of the div #conversejs [thierrytiti] - #407 CSS: Fonts Path: editabable $font-path via sass/variables.scss [thierrytiti] - #408 MUC: missing toggle call handler and updated documentation about call [thierrytiti] - #413 Auto-detect user's locale to show date and time in the right format [thierrytiti] - #415 closeAllChatBoxes is giving ReferenceError when 2 chats are open [nevcos, jcbrand] - #416 Add icon for XA status [thierrytiti] - #418 Logging out with `auto_reconnect=true` causes reconnection retries [jcbrand] - #420 Updated German translation [1st8] - #427 Converse.js does not subscribe back to a contact not in the roster. [emmanuel-florent] - Add offline pretty status to enable translation [thierrytiti] - Bugfix. ClearSessions during unload event would throw an error when not logged in. [gbonvehi] - Bugfix. Manual login doesn't work when only websocket_url is set and not bosh_service_url. [jcbrand] - Bugfix. Wrong callback argument mapping in XmppStatus initialize: fullname is null [thierrytiti] - CSS fix: room-info bug on hover after room description loaded [thierrytiti] - CSS: Fonts Path: editabable $font-path via sass/variables.scss [thierrytiti] - Chat boxes returned by the API now have an `is_chatroom` attribute [jcbrand] - Decouple automatic away and XEP-0352 support. [jcbrand] - Don't carbon copy OTR messages. [jcbrand] - I18N: Autodetection of User Locale if no i18n setting is set. [thierrytiti] - Refactored in order to remove the strophe.roster.js dependency. [jcbrand] - Refactored the plugin architecture. Add `overrides` convention for automatically overriding converse.js's methods and Backbone views and models. [jcbrand] - With keepalive, don't send out a presence stanza on each page load [jcbrand] ## 0.9.3 (2015-05-01) - Add the ability to log in automatically. [jcbrand] - Remove `type=email` from JID field in login form. Resulting validation error confuses people. [jcbrand] - Add Ukranian translations [Andriy Kopystyansky] - #244 Add the ability to log in anonymously. [jcbrand] - #344 Enable the path to the sound files to be configured [thierrytiti and jcbrand] - #370 Unable to register a new user to ejabberd 2.1.11. [gbonvehi] - #372 Some offline users have a visible empty `