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 3 of 3 Previous  1, 2, 3

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

First topic message reminder :

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 : 13181
Reputation : 2889
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 Bigtuber on July 5th 2017, 10:41 pm

Very nice, Ange! Good

What about to add some hotkeys? E.g. press "F" and FAM will open. Or press the arrows on the keyboard to switch from tab to tab - what do you think?
avatar
Bigtuber
Forumember

Male Posts : 298
Reputation : 19
Language : German, English
Location : Germany

http://kingsroadforum.forumieren.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on July 6th 2017, 5:12 pm

Forumactif Messenger v1.0.1 is now available ! This patch fixes a handful of bugs that were reported recently and also adds in some new language aliases for translations, so be sure to update when you get the chance ! thumleft For more information about this update, please see the release notes below.

  • Fixed send button remaining inactive after pasting content into the message box via context menu.
  • Fixed embed embedding Forumactif Messenger in the body when the specified selector wasn't available.
  • Fixed "open a new tab" overlay overlapping the toolbar and tabs, preventing interaction with them.
  • Fixed previously closed tab still loading its contents even after all tabs were closed.
  • Fixed back button remaining visible after all tabs were closed.
  • Fixed sponsored content displaying as messages in chats.
  • Added the following language aliases for options in admin configuration.
    • config_permission_all
    • config_permission_member
    • config_permission_staff
    • config_channel_production
    • config_channel_developer

Release link : https://github.com/SethClydesdale/forumactif-messenger/releases/tag/v1.0.1


Help
Need help updating Forumactif Messenger ? Visit the guide below !
https://github.com/SethClydesdale/forumactif-messenger/wiki/Updating


@Bigtuber wrote:Very nice, Ange! Good

What about to add some hotkeys? E.g. press "F" and FAM will open. Or press the arrows on the keyboard to switch from tab to tab - what do you think?
@Bigtuber that's a good idea ! I'll add it to the todo list, maybe we can add some shortcuts for the message textarea as well. Neutral
avatar
Ange Tuteur
Forumaster

Male Posts : 13181
Reputation : 2889
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 July 6th 2017, 6:00 pm

Hello Ange Tuteur Hello ,

Hum..

http://help.forumotion.com/t152951p30-forumactif-messenger-instant-message-application-for-forumotion#1050618

Code:
   
config_permission_all
    config_permission_member
    config_permission_staff
    config_channel_production
    config_channel_developer


You were super fast my friend Huzzah .

thank you very much

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 Ange Tuteur on July 7th 2017, 8:57 pm

Hi everyone,

I'm just letting you all know that I've updated the first post with extended information on installing and using Forumactif Messenger. You can view it here :
http://help.forumotion.com/t152951p60-forumactif-messenger-instant-message-application-for-forumotion#1047237

I hope you all enjoy using Forumactif Messenger and have a good weekend ! rock


@Milouze14 wrote:Hello Ange Tuteur Hello ,

Hum..

http://help.forumotion.com/t152951p30-forumactif-messenger-instant-message-application-for-forumotion#1050618

Code:
   
config_permission_all
    config_permission_member
    config_permission_staff
    config_channel_production
    config_channel_developer


You were super fast my friend Huzzah .

thank you very much

a++
No problem, I figured I would fit your request in the next patch since providing customization for the language is a high priority and simple to implement. Smile (much more simple than Forumactif Edge Razz)
avatar
Ange Tuteur
Forumaster

Male Posts : 13181
Reputation : 2889
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 NewFoundStories on August 31st 2017, 9:32 pm

Hi there, I was wondering if this was getting an option for the actual chatbox and private messages??? I think it would be super great if it did as it would allow easy access to both while running about the forums not needing seven tabs open to do it!
avatar
NewFoundStories
Forumember

Female Posts : 59
Reputation : 1
Language : English

http://op-piratenation.forumotion.com/

Back to top Go down

Re: Forumactif Messenger - Instant Message Application for Forumotion

Post by Ange Tuteur on September 15th 2017, 3:33 pm

@NewFoundStories wrote:Hi there, I was wondering if this was getting an option for the actual chatbox and private messages??? I think it would be super great if it did as it would allow easy access to both while running about the forums not needing seven tabs open to do it!
Hi @NewFoundStories,

It's currently possible to integrate the chatbox into Forumactif Messenger by using the initial_tabs configuration option. See "Custom tab content" for a quick example. As for private message support, I have that marked down on the todo list as a future feature. I've been off the project for a little while to relax and study, but whenever I return I'll definitely look into implementing that functionality.
avatar
Ange Tuteur
Forumaster

Male Posts : 13181
Reputation : 2889
Language : EN10, FR5
Location : Macungie, PA

http://fmdesign.forumotion.com

Back to top Go down

Page 3 of 3 Previous  1, 2, 3

View previous topic View next topic Back to top


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