The forum of the forums
Welcome to the Official Support Forum of Forumotion!

To take full advantage of everything offered by our forum, please log in if you are already a member, or join our community if you've not yet.



Create a free forum like this one.

Forumactif Messenger - Instant Message Application for Forumotion

Page 1 of 3 1, 2, 3  Next

View previous topic View next topic Go down

Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 17th 2017, 7:34 pm

Introduction

In this topic you will learn about Forumactif Messenger and how to install it on your Forumotion forum. Forumactif Messenger is a JavaScript plugin that integrates with your Forumotion forum to enable real time messaging in topics in a minimal design to make the experience more engaging.


CLICK TO VIEW DEMO

Forumactif Messenger is optimized to work on all major forum versions for Forumotion, so long as your forum's templates aren't heavily modified. Additionally Forumactif Messenger is enabled to receive updates from its Github repository to ensure that you are always using the latest version for the best experience. If you're ready to install Forumactif Messenger, move onto the next section or check out the demo by clicking the button above.


Jump to...



Installing

Installing Forumactif Messenger on your forum is super easy. Go to Admin Panel > Modules > JavaScript Codes Management and create a new script with the following settings.

Title : Forumactif Messenger
Placement : In all the pages (or the page you want Forumactif Messenger to appear on)
JavaScript Code : Since the code for Forumactif Messenger is constantly improving, we ask that you copy the latest release from the link below.
https://raw.githubusercontent.com/SethClydesdale/forumactif-messenger/master/fam.js (You can use the shortcut CTRL+A to select the entire code)

Once the code is copied, paste it as the JavaScript Code and save.


Congratulations ! You have now installed Forumactif Messenger on your forum ! :party: Proceed to the next section to learn how to use Forumactif Messenger.


How to Use

If you have successfully installed Forumactif Messenger you should see a new icon in the bottom right hand corner of your forum that looks something like this --> . Clicking this button opens the Forumactif Messenger window, which displays a minimal version of your forum. You may find the interface to be somewhat familiar if you have used an SMS or IM application before.


Go ahead and click through your forums, and find a topic to test out Forumactif Messenger. Once you have opened a topic, you should see a textarea along with 3 buttons at the bottom of the window; these are the message actions. For now, enter you message in the textarea and click the paper plane () or press ENTER to submit your message.

TIP : You can use SHIFT+ENTER to add a line break to your message.

You should have noticed that all this time you navigated through your forum and posted a message without ever leaving the page you are currently on ; this is just one of the many powerful features that Forumactif Messenger provides you with ! Now previously we mentioned 3 buttons for the message actions. You already used one of them, which is for sending messages. The other two buttons allow you to enter emoticons and attach media to your messages. Go ahead and try them out !


Last but not least is interacting with messages ! If you click the username of someone's message it'll add their mention handle to the message box, so you can mention them in your message. Additionally when you hover over any message, message actions will appear below it. These actions allow you to quote, edit, or delete a message, depending on your permissions. Go ahead and give these features a try !


Congratulations ! Now you know how to use Forumactif Messenger for messaging. Victory Next up you will learn about the settings page, which offers you ways to personalize your use of Forumactif Messenger.


Settings

The Settings page of Forumactif Messenger offers various options to personalize your experience. To navigate to the settings page, click the menu icon ("•••") on the Forumactif Messenger toolbar to open the main menu and then the cog icon to open the settings page.


Once on the settings page you will be met with a number of options for personalizing Forumactif Edge. Such as the option to display the window in full screen mode, the option to change the theme to a darker color, or the option to enable a sound notification for messages. As the settings are constantly being expanded upon, it'll be impossible to list them all here, so we invite you to read up on all the settings on our wiki.
https://github.com/SethClydesdale/forumactif-messenger/wiki/Settings


Now that you know how to use the settings page, it's time to learn how you can customize the internal settings for Forumactif Messenger by using the configuration page.


Configuration

The Configuration page is accessible to administrators only, as they are the only members who can update the internal configuration of Forumactif Messenger. To access the Configuration page you must go to the Settings page (see the previous section) and click the Admin Configuration button at the bottom.


The configuration page allows you to change various settings for Forumactif Messenger, from the default chat_page to the entire language interface. Go ahead and give it a try by placing body as the value for Embed Container.


Once you have set the value of Embed Container, scroll to the VERY bottom of the configuration page and click the Update Configuration button. This will generate the updated code for Forumactif Messenger with your configuration settings. Go ahead and replace your Forumactif Messenger JavaScript code with it by going to Admin Panel > Modules > JS Codes Management. Make sure to edit your existing script for Forumactif Messenger and delete the existing JavaScript code. Once the old code is deleted, paste the new code that was given to you in the Configuration page.


If done correctly, Forumactif Messenger should now be embedded at the very bottom of your forum and doesn't require clicking a button to open ! As this was just an example, feel free to go back to the configuration page and delete the contents of Embed Container, if you don't want Forumactif Messenger displaying here. Click here for more information on the embed option.


Well done ! You now know how to use the Configuration page. As there are MANY options for configuring Forumactif Messenger, we invite you to read about all of them on our wiki.
https://github.com/SethClydesdale/forumactif-messenger/wiki/Config

Next up we will learn how to update Forumactif Messenger, which is a very important feature.


Updating

Forumactif Messenger is open source and constantly evolving. For the best experience it's recommended that you update Forumactif Messenger to the latest release whenever it's available. To update Forumactif Messenger click the menu button ("•••"), and click About ("?").


This will take you to the about page, which tells you what version of FAM you're running and the current release on Github. If an update is available a yellow exclamation icon will show and an update button will be available. Click this button to get the latest release from Github.


After a few seconds, the updated code will be available in the textarea. Copy this code and go to Admin Panel > Modules > JavaScript Codes Management and update your Forumactif Messenger script with it. Your configuration settings will be maintained, so don't worry about replacing your existing script.


Once you've saved the updated script, go to about again to confirm that you're running the latest version of Forumactif Messenger. If you are, a blue check mark will display and the update button will display as sync instead. Clicking the sync button will get the latest release from Github again. It's mainly used in cases where you've made internal modifications and want to revert to the default code.


This should be all that you need to know about using Forumactif Messenger, we'll allow you to explore the rest on your own ! Yes If you'd like to help improve Forumactif Messenger, please see the next section.


Contributing

Forumactif Messenger is open source, so anyone can help build and improve it !

  • Got a suggestion, have feedback, or find a bug ? Let us know in this topic with a reply OR on Github by opening a new issue !
  • Are you a developer with a passion for creating Open Source technology and want to improve Forumotion ? Fork the repo on Github and help out with development. See our to do list or contact me to discuss development if you have any queries.

For more information about contributing please see the following pages.


Last edited by Ange Tuteur on July 7th 2017, 8:43 pm; edited 14 times in total
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Milouze14 on May 17th 2017, 7:40 pm

Hello Ange Tuteur,

Since I am on the codings, I am a very great admirer.
Thank you for your work my friend Wink .

a++
avatar
Milouze14
Forumember

Male Posts : 59
Reputation : 18
Language : French
Location : Vendée

http://www.milouze14.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Van-Helsing on May 17th 2017, 8:04 pm

Hello @Ange Tuteur,
It's another amazing project I love it. Hello
avatar
Van-Helsing
Hyperactive

Male Posts : 2366
Reputation : 100
Language : English, Greek

http://helpgr.forumgreek.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 18th 2017, 8:05 pm

Version 0.3.0 of Forumactif Messenger is now available ! This update enables the usage of line breaks in messages, adds a drop down for the emoticon button, makes the timeout config option functional, and more. You can read about all the changes made here :
https://github.com/SethClydesdale/forumactif-messenger/releases/tag/v0.3.0


Check out the following link if you need help updating.
https://github.com/SethClydesdale/forumactif-messenger/wiki/Updating
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by BlackScorpion on May 20th 2017, 3:06 am

This just might eliminate / replace the chat function. thumleft
avatar
BlackScorpion
Graphic Designer
Graphic Designer

Male Posts : 5342
Reputation : 747
Language : English
Location : USA

http://help.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by SLGray on May 20th 2017, 3:44 am

How will this work with blogs and ads?


When your topic has been solved, ensure you mark the topic solved.
Never post your email in public.

avatar
SLGray
Administrator
Administrator

Male Posts : 40897
Reputation : 2776
Language : English
Location : United States

https://fmthemes.forumotion.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 20th 2017, 4:16 am

@BlackScorpion wrote:This just might eliminate / replace the chat function. thumleft
Perhaps, only time will tell. Wink

@SLGray wrote:How will this work with blogs and ads?
Currently it only works with standard categories and forums, though it may work partially on blogs if their selectors are the same, and not at all on ads considering how different the structure of those are. At the moment I'll mostly be focusing on the forums as those are used generally for conversing and are ideal for a chat application. Blog support I may consider if there's a demand for it, as for ads I'm doubtful since there's no ability to converse.

The blogs and ads DO currently show though. I'll plan on filtering those out due to the aforementioned points above. Thanks for asking this question ; it brought a few ideas to mind.
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by SLGray on May 20th 2017, 4:53 am

You're welcome.


When your topic has been solved, ensure you mark the topic solved.
Never post your email in public.

avatar
SLGray
Administrator
Administrator

Male Posts : 40897
Reputation : 2776
Language : English
Location : United States

https://fmthemes.forumotion.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 20th 2017, 9:34 pm

Forumactif Messenger v0.4.0 is now available ! This version introduces tabs and history memory to make navigation easier, along with various fixes. You can find the full list of changes here :
https://github.com/SethClydesdale/forumactif-messenger/releases/tag/v0.4.0

Here's a quick demo of the tab functionality :


Check out the following link if you need help updating.
https://github.com/SethClydesdale/forumactif-messenger/wiki/Updating
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Luffy on May 20th 2017, 9:38 pm

@Ange Tuteur, what does the settings icon do? I tried clicking it but it doesn't do anything.. Confused





avatar
Luffy
Manager
Manager

Male Posts : 4881
Reputation : 500
Language : Greek, English
Location : Greece

http://thinktank.forumotion.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Valoish on May 20th 2017, 9:42 pm

@Luffy; The settings icon isn't functional yet as it hasn't been coded yet but it's meant to give the user the option to customize the messenger - so apply the themes to it, change the bubble color, and set a few other personal preferences c:

Not sure if the option to delete messages will also go in the settings but that's up to Ange :B
avatar
Valoish
Forumember

Female Posts : 291
Reputation : 54
Language : English
Location : NYC

http://www.canvastutorials.org/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 20th 2017, 9:45 pm

@Luffy wrote:@Ange Tuteur, what does the settings icon do? I tried clicking it but it doesn't do anything.. Confused
Like Valoish mentioned It's currently a placeholder for a future update in the navigation menu so it's not functional at this time, same with the attachments button. You can check out some of the future plans I have for it here though :
https://github.com/SethClydesdale/forumactif-messenger/wiki/Todo-List#navigation

I plan on working on either the attachments or settings button next, maybe both. Mr. Green
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Luffy on May 20th 2017, 10:33 pm

Okay thank you both! It was something i was seeing on the messanger and didn't understand its purpose. Razz





avatar
Luffy
Manager
Manager

Male Posts : 4881
Reputation : 500
Language : Greek, English
Location : Greece

http://thinktank.forumotion.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Tonight on May 21st 2017, 2:57 pm

Not so sure if this was a good idea:
Changed message input field to a textarea so it's possible to add line breaks to your messages.
- This changes the message submission shortcut key from ENTER to CTRL+ENTER.
I think that it would be easier for users to send messages with ENTER and add line breaks with SHIFT+ENTER or CTRL+ENTER. Just my thoughts though. Very Happy

Also, there seems to be a small spacing bug in categories/sub-forums:


But other than that, you've made great progress and Messenger is working well, good job!
avatar
Tonight
Forumember

Male Posts : 258
Reputation : 69
Language : Estonian, English, Russian
Location : Estonia

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by jucarese on May 21st 2017, 4:01 pm

Great job friend,Do you plan to implement text colors and other bbcodes like bold italic ,size etc ...?
avatar
jucarese
Active Poster

Male Posts : 1221
Reputation : 22
Language : spanish
Location : Admin Spanish support

http://asistencia.foroactivo.com/u23082

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 21st 2017, 5:00 pm

@Tonight wrote:Not so sure if this was a good idea:
Changed message input field to a textarea so it's possible to add line breaks to your messages.
- This changes the message submission shortcut key from ENTER to CTRL+ENTER.
I think that it would be easier for users to send messages with ENTER and add line breaks with SHIFT+ENTER or CTRL+ENTER. Just my thoughts though. Very Happy

Also, there seems to be a small spacing bug in categories/sub-forums:


But other than that, you've made great progress and Messenger is working well, good job!
Yes, I believe you're right, I've been considering changing the key to submit messages back to enter. I think SHIFT+ENTER would be better suited for creating line breaks, though I may do a little research to see what other developers prefer to use for this first.

Ah yes, I have that noted down in the things that need to be fixed / changed. The time stamps definitely need to be cleaned up, so I'll look into doing that soon.

@jucarese wrote:Great job friend,Do you plan to implement text colors and other bbcodes like bold italic ,size etc ...?
I may consider it, though for the moment the primary focus is on chatting with "simple messages" that don't require heavy formatting.
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by pottermind on May 21st 2017, 5:42 pm

That's super great!!
I have a question. How to make it work only for some certain forums instead of all forum?
avatar
pottermind
New Member

Posts : 1
Reputation : 2
Language : English

http://No.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 21st 2017, 7:06 pm

@pottermind wrote:That's super great!!
I have a question. How to make it work only for some certain forums instead of all forum?
Hi,

See the chat_page option on the config page :
https://github.com/SethClydesdale/forumactif-messenger/wiki/Config

Aside from chat_page, it'll explain other options for configuring Forumactif Messenger as well. I recommend reading over those that interest you.
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 25th 2017, 8:08 pm

Forumactif Messenger version 0.5.0 is now available ! This update enables functionality for attachments, allowing you to add images, GIFs, and videos to your messages. This update also comes with a few other enhancements and fixes. Check out the release notes for the full details !
https://github.com/SethClydesdale/forumactif-messenger/releases/tag/v0.5.0

Here's a quick demo of the attachments functionality :


Check out the following link if you need help updating.
https://github.com/SethClydesdale/forumactif-messenger/wiki/Updating
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Luffy on May 25th 2017, 10:12 pm

Great work Ange!! Excellent work and a great feature.! Smile





avatar
Luffy
Manager
Manager

Male Posts : 4881
Reputation : 500
Language : Greek, English
Location : Greece

http://thinktank.forumotion.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Van-Helsing on May 25th 2017, 10:53 pm

Excellent upgrade Ange, congratulations. cheers
avatar
Van-Helsing
Hyperactive

Male Posts : 2366
Reputation : 100
Language : English, Greek

http://helpgr.forumgreek.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by BlackScorpion on May 26th 2017, 2:30 am

what can i say? Awesome work as always. Thank you for your continued commitment and support to this community. You sir are the man!
avatar
BlackScorpion
Graphic Designer
Graphic Designer

Male Posts : 5342
Reputation : 747
Language : English
Location : USA

http://help.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Goppyrules on May 26th 2017, 4:07 am

you outdid yourself again ange. good job as always!

Goppyrules
Forumember

Posts : 125
Reputation : 2
Language : english

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Tonight on May 27th 2017, 12:09 am

There is one really annoying bug: user A posts, user B posts, user A can't post again (unless he reloads topic).
avatar
Tonight
Forumember

Male Posts : 258
Reputation : 69
Language : Estonian, English, Russian
Location : Estonia

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 27th 2017, 4:00 am

@Tonight thanks I'll look into this ! It appears to be an issue on Firefox from what I can tell ; it happens even after sending a message by yourself. Think It might be an issue with the form data and AJAX submission. I'll review it tomorrow after breakfast. Coffee
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by YoshiGM on May 27th 2017, 4:12 am

Just one word: AWESOME!!!
I think a good option is to have a language configuration... like var_language = 'EN', 'ES', etc..

However.. i'm going to install this chat in my forum and if i found any problem.. i will tell you .

avatar
YoshiGM
Forumember

Male Posts : 668
Reputation : 93
Language : Spanish, English & Italian (16%)
Location : Mexico

http://asistencia.foroactivo.com/u21373

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 27th 2017, 4:17 pm

@Tonight wrote:There is one really annoying bug: user A posts, user B posts, user A can't post again (unless he reloads topic).
@Tonight I've found the root of the problem and you'll be surprised. It wasn't an issue with Firefox as I previously thought, but with a profile preference ; "Display a notification when new replies are written." Luckily it was an easy fix, since I only needed to include a confirmation in the form data. This fix will be live in v0.6.0 ! salut

Thanks again for reporting the bug. Good

@YoshiGM wrote:Just one word: AWESOME!!!
I think a good option is to have a language configuration... like var_language = 'EN', 'ES', etc..

However.. i'm going to install this chat in my forum and if i found any problem.. i will tell you .

@YoshiGM I think that's a great idea. I may be able to include a option like that in a configuration page I was thinking about, however, it'll be a little while before I get around to creating it since I'm still working on the basic functionality. Currently the language data is available in the lang object, so it'll still be possible to translate and even share your translation with others until then. Wink

Thanks a lot ^^
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by YoshiGM on May 27th 2017, 5:56 pm

Yep... Anyways.. i executed your code in my test forum and looks very good Wink
I'm so impressed with this
avatar
YoshiGM
Forumember

Male Posts : 668
Reputation : 93
Language : Spanish, English & Italian (16%)
Location : Mexico

http://asistencia.foroactivo.com/u21373

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on May 29th 2017, 4:04 pm

Forumactif Messenger version 0.6.0 is now available ! This update introduces a media viewer for attachments and images, enables message functionality for guests, adds message recovery for lost messages, and a handful of fixes ! For more details, check out the release notes on Github. Very good
https://github.com/SethClydesdale/forumactif-messenger/releases/tag/v0.6.0

Here's a quick demo of the new media viewer, which allows you to view the full size of images and attachments. No need to squint anymore, guys !


Check out the following link if you need help updating.
https://github.com/SethClydesdale/forumactif-messenger/wiki/Updating
avatar
Ange Tuteur
Forumaster

Male Posts : 13176
Reputation : 2881
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Milouze14 on May 29th 2017, 4:26 pm

Hello Ange Tuteur Hello ,
I just updated this last update and it fully functional my friend, thanks for the work done, you are a true Shakespeare of the script Yes .

Tanks again and i offer you a small coffee Victory .




a++
avatar
Milouze14
Forumember

Male Posts : 59
Reputation : 18
Language : French
Location : Vendée

http://www.milouze14.com/

Back to top Go down

Page 1 of 3 1, 2, 3  Next

View previous topic View next topic Back to top


 
Permissions in this forum:
You cannot reply to topics in this forum