RSS

Monitor.chat Wordpress Plugin Full Walk Through

All the steps from Trial API Key to Permanent API Key!

🖥 In this video, we go through all of the steps to configure the Monitor.chat Wordpress Plugin. The Monitor.chat plugin sends XMPP instant messages to your mobile device to keep you informed about activity on your Wordpress server.

Plugin Install

In this video, we will review the steps to set up the Monitor.chat Wordpress plugin. The plugin installs and activates like any other wordpress plugin and it is free.

Step 1

In order to receive instant messages from your wordpress server, click the link on the about page to create an xmpp id with e2e.ee, our free-to-use chat service.

Save the details of your XMPP ID in a safe place. We recommend using a password safe like keepass.

e2e.ee will provide you with an account management key. Save your account management key now because the site will never show it to you again. The account management key will allow you to recover your account if you ever lose your password.

Step 2

In step 2 we download and install an XMPP client for our desktop environment. In this example, we use Gajim. This computer already has it installed.

When you open Gajim for the first time, it appears as a clean slate. click “accounts”, “add account”. Input your full xmpp ID and your password. Account is added and you are now connected.

Step 3

Let’s move on to step 3, adding the robot to your contacts.

Click on “accounts”, “add contact…”

Carefully type in or paste in the name of the robot “monitor@noarchive.chat”

Include a nickname if you prefer. Click the button “add” and you are done.

Step 4

Now, we are ready for step 4. Let’s request a monitor.chat api key.

Type in your xmpp id and complete the captcha.

You will immediately receive a message in your xmpp client. Click the link in the message.

Your browser will open with a new tab. The webpage will display your new monitor api key.

This api key is assigned the chatroom trial.moon@e2e.chat.

Scrolling down, we get the details of the monitor.chat.sh script which can be used on any linux server to send you instant messages.

Step 5

Now we are ready for step 5. Scroll up and click the API key tab.

Copy your api key and paste it into the first text box. Choose your preferred method of sending messages. For this test, we use the embedded bash script.

Now that we have an api key, lets view the api key report. You can see that this API key has been used to send one message.

Let’s try a test message. Just click the send test message button, then check your xmpp client.

Now we are ready to enable the different messages we want to receive about activity on wordpress.

The first group of messages are triggered by human interactions with wordpress.

The second group of messages are sent on a schedule.

The final group of messages depend on other plugins.

Let’s test a logout.

It looks like we did not get a message. Is there a problem?

Not really. The message was sent to our chatroom. We need to connect to the chatroom.

In the menu of your xmpp client, find “Start / Join chat”. Type in or paste in your chatroom name. make sure you join as group chat.

Gajim is telling us in this screen that we are going to join a chatroom. perfect!

There! the most recent message was that someone has logged out. That is correct! There are other messages in that chatroom because the service uses shared chatrooms for trial API Keys.

Let’s log back into wordpress and see what happens. We got a new message because we just logged in!

Switching Chatrooms

With a trial API key, you can switch chatrooms. Let’s return to the manage page of the monitor.chat website. From the menu, choose “Manage a Monitor API Key”. Paste your api key into the form and complete the captcha. Scroll down to chatroom and click the modify button. Now just choose another chatroom. Now, in your XMPP client, connect to the new chatroom.

From the monitor.chat plugin, send a test message to your chatroom to verify that it is working properly.

Step 6

It is time for step 6, installing an XMPP client on your mobile device. Here we open the google play store. There are 4 xmpp clients we can recommend for the montor.chat service.

  • Xabber
  • Blabber.im
  • Yax IM and Conversations. All of these work very well. These clients won’t drain your battery or use a lot of bandwidth.

Here, we are going to install conversations.

Add your existing account to the client. type in the xmpp id and the password. We skip adding an avatar, but you can do that if you wish. We allow conversations access to our mobile phone contacts.

The configuration from our previous usage is loaded from the chat server. Our contacts and bookmarks don’t need to be added again.

Those green backgrounds are not my preference. Make sure you go through all of the settings to configure your client to behave just the way you prefer. Here we take out the green. There, that looks great.

Get a Permanent API Key

When you have received 100 messages with the monitor.chat service, you will get a direct message from the robot. The message will tell you that you may request a permanent API Key. You can still send up to 400 more messages with your trial api key, but it is a good idea to get the process started for a permanent api key now.

Visit the monitor.chat management page and in the menu, choose request a monitor api key. Input your xmpp id and complete the captcha.

You will be asked to create a name for your private chatroom. The chatroom name must begin with monitor. You can use dashes or dots as seperators in the name.

After a Few Hours

After a few hours, your chatroom will be created. It is likely that you will begin receiving confusing messages that say “You have messages in group chat”. This is because the chatroom has been created, you are the owner, and it is being tested by the staff of monitor.chat. If you send a message, it may fail as you see here.

To fix this situation, you need to inform your xmpp client that the ID for the chatroom requires a group chat connection.

If you choose “Start / Join” from the menu, and then click the chatroom name, it returns to the failures. So, in the search, type the full name of the chatroom, and select the option to join a group chat. This will bookmark the chatroom and join it correctly.

Your mobile client may have the same problem. This is also easy to fix. Look at your bookmarks. Try sending a message to the chatroom. If your messsage fails, just exit and disconnect by swiping the chatroom name out of the list. Then, return to bookmarks and join again. This time it will join as a chatroom because it is listed in your bookmarks and bookmarks are only for chatrooms.

Permanent API Key Arrives

After your private chatroom is created and tested, you will receive some direct messages from the staff of monitor.chat. These messages will inform you that your private chatroom and your permanent api key are created.

It will be easier to manage these messages from your desktop client. Here, we save the all of the details for our chatroom and api key in keepass to make sure that we don’t lose them. A permanent chatroom has its own Account Management key which can be used to delete the chatroom’s archives.

Now, replace the trial API key with the permanent api key in your wordpress plugin. Congratulations! You have completed all the steps and are a permanent user of monitor.chat

Thank you for watching!