Title: Chatrix Author: Automattic Published: Bélú 16, 2022 Last modified: Igbe 17, 2025 --- Ṣàwárí àwọn plugin ![](https://s.w.org/plugins/geopattern-icon/chatrix.svg) # Chatrix Láti ọwọ́ [Automattic](https://profiles.wordpress.org/automattic/) [Ṣe ìgbàsílẹ̀](https://downloads.wordpress.org/plugin/chatrix.0.9.2.zip) * [Àwọn àlàyé](https://yor.wordpress.org/plugins/chatrix/#description) * [Àwọn àgbéyẹ̀wò](https://yor.wordpress.org/plugins/chatrix/#reviews) * [Ìdàgbàsókè](https://yor.wordpress.org/plugins/chatrix/#developers) [Ìrànlọ́wọ́](https://wordpress.org/support/plugin/chatrix/) ## Àpèjúwe Easily add a [Matrix](https://matrix.org) client to WordPress pages, either through the Block Editor, or as a _popup_. ### Feedback welcome If you have any feedback or questions about Chatrix, please do talk to plugin maintainers at [#chatrix:matrix.org](https://matrix.to/#/#chatrix:matrix.org). ## Àwọn àwòrán ìbòjú [[ [[ [[ [[ [[ ## Àwọn ìdí Plugin yìí pèsè 1 ìdí. * Chatrix Matrix client ## FAQ ### How can I install this plugin on my site? This plugin can be used in two distinct ways: 1. By adding a block to a page through the block editor 2. By selecting pages in which a _popup_ will be displayed. You configure this through` Settings -> Chatrix`. ### Is there a more flexible way to configure the popup? Yes. Instead of configuring the _popup_ through `Settings -> Chatrix`, you can configure it through code, by using the `chatrix_instances` filter: ``` // functions.php add_filter( 'chatrix_instances', function ( array $default_instances ) { // The key is an instance_id, the value array is the config for that instance. // Set 'pages' to an array of the ids of the pages which should show chatrix. // You can also set 'pages' to 'all' which results in that instance always being used. // Only one instance can be shown on a given page. return array( 'foo' => array( 'homeserver' => 'https://foo.com', 'room_id' => '!id:foo.com', 'pages' => 'all', ), 'bar' => array( 'homeserver' => 'https://bar.com', 'room_id' => '!id:bar.com', 'pages' => array(1, 2, 3), ), ); } ); ``` ### How can I configure WordPress user accounts to register and login on Matrix homeserver? The plugin will respect the login methods configured on the Matrix homeserver. For example, if the homeserver has both password and SSO login enabled, both options will be available to the user. In light of the [plan for Matrix to replace their user management with Open ID Connect (OIDC)](https://areweoidcyet.com/), we recommend to use a Single-Sign On (SSO) flow by configuring [Open ID Connect login on Synapse](https://matrix-org.github.io/synapse/latest/openid.html) and use the [OpenID Connect Server WordPress plugin](https://wordpress.org/plugins/openid-connect-server/). The flow will then be as follows: When logging into your homeserver, it will redirect you to your own WordPress login page and ask you to authorize the login by the click of a button, and then relay your information to the homeserver. YouÌtumọ̀ Yorùbá:’ ll be redirected back to your WordPress page and Chatrix will receive the login information and you can start chatting. Later, when Matrix makes the switch to OIDC, you are already prepared and can continue to use this setup. ## Àwọn àgbéyẹ̀wò ![](https://secure.gravatar.com/avatar/e297d1e69d55d4cfcd98b473490f9d30ca7c5393d69ab1c78c641f54d67e1d75? s=60&d=retro&r=g) ### 󠀁[A great start for such an early version (0.4.0)](https://wordpress.org/support/topic/a-great-start-for-such-an-early-version-0-4-0/)󠁿 [Julian Foad](https://profiles.wordpress.org/julianfoad/) Ṣẹrẹ 1, 2023 2 àwọn ìdáhùn IÌtumọ̀ Yorùbá: ’ve been eagerly awaiting a matrix chat box. (And also matrix based comments Ìtumọ̀ Yorùbá: — look up Cactus Comments for that.) A review of my first experience setting it up. I first tried the option to make it appear as an icon on all blog pages. This Chatrix plugin at early version 0.4.0 provides a pop-up generic matrix chat box, in which a viewer can log in to their existing matrix account, and chat with other matrix users, no matter whether inside or outside wordpress in the same way as using any generic matrix messaging client. This early version doesnÌtumọ̀ Yorùbá: ’t seem to integrate with wordpress beyond appearing on the page. First, it doesnÌtumọ̀ Yorùbá: ’t seem to have a way to re-use the viewerÌtumọ̀ Yorùbá: ’s wordpress login to help with logging in to a matrix account, either in the sense of acting as an OIDC provider or in the sense of simplifying the UX when viewerÌtumọ̀ Yorùbá: ’s matrix account is on the same domain as the blog, like might be typical in an organization or family server setup, nor in having an ability to integrate with a local matrix server and offer to create a matrix account for the visitor who doesnÌtumọ̀ Yorùbá: ’t have one. All these things could be good to see in future. Once logged in to a matrix account, in the pop-up version it didnÌtumọ̀ Yorùbá: ’t seem to take notice of the plugin configuration setting for default room: once I logged into my matrix account, I saw a list of all my current room memberships and had to find or create a suitable chat room on my own. However, when inserted as a block, with a particular matrix room chosen in the blpck settings, then the chat did load the specified room. In both pop-up and block modes, the matrix room currently has to be specified as a matrix room-id string (starting with exclamation mark) which is a bit awkward but only for the blog admin; that doesnÌtumọ̀ Yorùbá:’ t affect the viewer. A minor improvement would be to allow a room “alias” (the user- friendly identifier starting with a hash character). This matrix chat currently allows just plain text and attchments, none of the rich text and other features that other matrix clients can do. ThatÌtumọ̀ Yorùbá: ’s not inappropriate start, but soon it will need some options such as to limit the possible uploads, further customise the appearance, and have a way to introduce the viewer to the author of the blog. All in all, plenty of room for improvement but a good start for such an early version. [ Ka gbogbo àgbéyẹ̀wò 1 ](https://wordpress.org/support/plugin/chatrix/reviews/) ## Àwọn Olùkópa & Olùgbéejáde “Chatrix” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí. Àwọn Olùkópa * [ Automattic ](https://profiles.wordpress.org/automattic/) * [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/) * [ Alex Kirk ](https://profiles.wordpress.org/akirk/) * [ Ashish Kumar (Ashfame) ](https://profiles.wordpress.org/ashfame/) * [ Paulo Pinto ](https://profiles.wordpress.org/psrpinto/) A ti túmọ̀ “Chatrix” sí àwọn èdè agbègbè 2. Ọpẹ́lọpẹ́ fún [àwọn atúmọ̀ èdè](https://translate.wordpress.org/projects/wp-plugins/chatrix/contributors) fún àwọn ìkópa wọn. [Túmọ̀ “Chatrix” sí èdè rẹ.](https://translate.wordpress.org/projects/wp-plugins/chatrix) ### Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè? [Ṣàwárí koodu](https://plugins.trac.wordpress.org/browser/chatrix/), ṣàyẹ̀wò [ibi ìpamọ́ SVN](https://plugins.svn.wordpress.org/chatrix/), tàbí ṣe àgbékalẹ̀ sí [àkọsílẹ̀ ìdàgbàsókè](https://plugins.trac.wordpress.org/log/chatrix/) nípasẹ̀ [RSS](https://plugins.trac.wordpress.org/log/chatrix/?limit=100&mode=stop_on_copy&format=rss). ## Àkọsílẹ̀ àwọn àyípadà ### 0.9.2 * Fix Chatrix iframe not loading in Gutenberg editor [#256](https://github.com/Automattic/chatrix/pull/256) ### 0.9.1 * We now donÌtumọ̀ Yorùbá: ’t enqueue scripts in embeds [#249](https://github.com/Automattic/chatrix/pull/249) * It is now possible to disable service worker at runtime [#243](https://github.com/Automattic/chatrix/pull/243) ### 0.9.0 * Chatrix is now a single-session client. The session picker is no longer displayed[ [#239](https://github.com/Automattic/chatrix/pull/239)]. This fixes [#236](https://github.com/Automattic/chatrix/issues/236) [#224](https://github.com/Automattic/chatrix/issues/224) [#200](https://github.com/Automattic/chatrix/issues/200). ### 0.8.3 * Improve the view for rooms that are you not a member of (Upgraded our HydrogenÌtumọ̀ Yorùbá: ’s fork to [latest](https://github.com/Automattic/hydrogen-web/compare/chatrix-0.8.0...Automattic:hydrogen-web:chatrix-0.8.3)) ### 0.8.2 * Fix issues with single-room mode and guest login [[#222](https://github.com/Automattic/chatrix/pull/222)] ### 0.8.1 * Correctly remember last url when multiple blocks are on the same page [[#217](https://github.com/Automattic/chatrix/pull/217)] ### 0.8.0 * Fix issue when chatrix plugin is not installed in the default location [[#205](https://github.com/Automattic/chatrix/pull/205)] * Fix issue with z-index of the popup [[#207](https://github.com/Automattic/chatrix/pull/207)] * Fix issue that prevented navigating away from the _unknown room_ screen [[#213](https://github.com/Automattic/chatrix/pull/213)] * Allow multiple blocks on the same page or on different browser tabs (behind feature flag, still unstable) [[#214](https://github.com/Automattic/chatrix/pull/214)] ### 0.7.1 * Fix button text from ‘Login’ to ‘Log In’ * Meta changes for WP.org plugins repo ### 0.7.0 * Implement Room Previews (Peeking) functionality [[#199](https://github.com/Automattic/chatrix/pull/199)] * Disable restoration to last screen when in Single room mode [[#196](https://github.com/Automattic/chatrix/pull/196)] * Switch to our HydrogenÌtumọ̀ Yorùbá: ’s fork (ahead of v0.3.8) as dependency which includes un-merged upstream contributions - Fix query params in SSO - Allow create room screen to be closed on smaller width screens - Ensure Service worker is started before anything else - Fix bug in normalization of homeserver - Room Previews (Peeking) support - Fix loading of messages & timelines in some cases ### 0.6.0 * Support for multiple blocks on the same page [[#175](https://github.com/Automattic/chatrix/pull/175)] * Support room alias in configuration [[#179](https://github.com/Automattic/chatrix/pull/179)] * Fixed a bug where port wasnÌtumọ̀ Yorùbá: ’t allowed in homeserver in configuration[ [#184](https://github.com/Automattic/chatrix/pull/184)] * Provide a filter to choose to not load the logout script if required [[#165](https://github.com/Automattic/chatrix/pull/165)] ### 0.5.1 * Fix issue that caused popup configuration to be ignored [[#173](https://github.com/Automattic/chatrix/pull/173)] ### 0.5.0 * Logout and delete data when user logs out of WordPress [[#150](https://github.com/Automattic/chatrix/pull/150), [#153](https://github.com/Automattic/chatrix/pull/153)] * Improvements to single room mode [[#151](https://github.com/Automattic/chatrix/pull/151)] - Add a Settings entry to the options menu of the room - Closing the Settings screen navigates to configured `roomId` - Closing the Room (timeline) screen navigates to session picker - Hide the left panel completely * Fix issue that caused Chatrix to not load in certain conditions [[#160](https://github.com/Automattic/chatrix/pull/160)] * Allow setting a unit for certain styling options (previously was always `px`)[ [#154](https://github.com/Automattic/chatrix/pull/154)] ### 0.4.0 * Prevent data corruption when more than one Chatrix instance (block or Popup) is active, either in multiple browser tabs or windows, or in the same page [[#75](https://github.com/Automattic/chatrix/pull/75)] * Allow setting the height of the block from the block editor [[#135](https://github.com/Automattic/chatrix/pull/135)] * Allow styling the blockÌtumọ̀ Yorùbá: ’s border from the block editor [[#139](https://github.com/Automattic/chatrix/pull/139)] * Styling and layout improvements and fixes in pre-session screens (session selection, login, logout) [[#134](https://github.com/Automattic/chatrix/pull/134)] * Reduce plugin size by 50%, from 12MB to 6MB [[#143](https://github.com/Automattic/chatrix/pull/143)] * Update to Hydrogen [0.3.5](https://github.com/vector-im/hydrogen-web/releases/tag/v0.3.5) - Fix issue that prevented opening rooms with slashes in the room ID [[#451](https://github.com/vector-im/hydrogen-web/issues/451)] - Improve date headers in room timeline [[#938](https://github.com/vector-im/hydrogen-web/pull/938)] - Provide basic UI to join room [[#870](https://github.com/vector-im/hydrogen-web/pull/870)] - Fix an error that can stop sync [[#885](https://github.com/vector-im/hydrogen-web/pull/885)] - Fetch missing e2ee devices when verifying message sender [[#913](https://github.com/vector-im/hydrogen-web/pull/913)] - Fix message verification not working in rooms where we havenÌtumọ̀ Yorùbá:’ t sent a message yet [[#920](https://github.com/vector-im/hydrogen-web/pull/920)] - Various maintenance fixes ### 0.3.9 * Initial public release ## Àkójọpọ̀ Meta * Ẹ̀yà **0.9.2** * Ìgbàgbọ́hùn tó kẹ́yìn **ọdún 1 sẹ́yìn** * Àwọn ìgbéwọlẹ̀ tó ṣiṣẹ́ **20+** * Ẹ̀yà WordPress ** 6.0 tàbí ju bẹ́ẹ̀ lọ ** * Dánwò dé **6.8.5** * Ẹ̀yà PHP ** 7.4 tàbí ju bẹ́ẹ̀ lọ ** * Àwọn èdè * [English (US)](https://wordpress.org/plugins/chatrix/), [German](https://de.wordpress.org/plugins/chatrix/), àti [Swedish](https://sv.wordpress.org/plugins/chatrix/). * [Túmọ̀ sí èdè rẹ](https://translate.wordpress.org/projects/wp-plugins/chatrix) * Àwọn àmì * [chat](https://yor.wordpress.org/plugins/tags/chat/)[matrix](https://yor.wordpress.org/plugins/tags/matrix/) * [Ìwòye Tó Péye](https://yor.wordpress.org/plugins/chatrix/advanced/) ## Àwọn ìbò 3 lára àwọn ìràwọ̀ 5. * [ 0 5-star reviews ](https://wordpress.org/support/plugin/chatrix/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/chatrix/reviews/?filter=4) * [ 1 3-star review ](https://wordpress.org/support/plugin/chatrix/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/chatrix/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/chatrix/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/chatrix/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/chatrix/reviews/) ## Àwọn Olùkópa * [ Automattic ](https://profiles.wordpress.org/automattic/) * [ WordPress.org ](https://profiles.wordpress.org/wordpressdotorg/) * [ Alex Kirk ](https://profiles.wordpress.org/akirk/) * [ Ashish Kumar (Ashfame) ](https://profiles.wordpress.org/ashfame/) * [ Paulo Pinto ](https://profiles.wordpress.org/psrpinto/) ## Ìrànlọ́wọ́ Nǹkan wà tí o fẹ́ sọ? Ṣé o nílò ìrànlọ́wọ́? [Wo àpéjọ ìrànlọ́wọ́](https://wordpress.org/support/plugin/chatrix/)