[PLUGIN] Plugin for Forumotion: Create multilingual topics

 Purpose of this plugin

This amazing plugin for your #forum will allow you to

• Expand your audience
  
• Improve your SEO (Search engine Optimization)
  

Now, thanks to this plugin you will be able to create multi-lingual topics to allow foreign members to perfectly understand your topics. Thanks to our client area you can submit unlimited translations that you can use later on your own forum.

The result ? It doesn't matter the language of the member, you can provide a translated version for each topic if you want !   

How does the Forumotion plugin work?

After the installation of this new plugin (v1.0), on your #forumotion #forum editor you will find a new button  that will allow you to include a new dedicated BBcode in your text area.. wow !


In this example, your [alias] BB code article_one in the topic, will be replaced with the related translation in your translations Cloud client area.   

It is really simple !

• You create a translation in your client area
  
• You submit an alias in your topic
  
• Your members read the version for their own language
  

---

We all hope that Forumotion members will be proud and happy to have this amazing plugin for their Forumotion forums !   
Having a multi-lingual forum is not something for everybody.. but it is something for all Forumotion forum-owners now     


   Take note that this is still the first version of our plugin for Forumotion, this means that we are going to create a more powerful tool for your forum (share your feedbacks, your suggestions etc..)


We have released a plugin that will allow Forumotion forums to create multi-lingual topics  

• Installation of forumotion plugin
  
  
  
  • Creation of a forumotion plugin
    
  • Install your own plugin
    
  • Customization
    
  
  
  
• [url=#tools]How does it work ?[/url]
  
  
  
  • Create your first multi-lingual post
    
  • Selecting the multilingual posts' language
    
  • What if an alias does not exist in my language ?
    
  
  
  

What is a multi-lingual topic ?

A #multilingual topic is a special post in your forum that is available in different languages. This feature will allow new guests that don't speak your forum main-language to undestand your topic content and join the discussion  

---

Installation of forumotion plugin

Creation of a forumotion plugin

• First, you need to create an account on our website at https://www.translationscloud.com/registration.
  Note that an email verification is required. Use a valid email address.
  
  
• Once that your account has been created and it has been verified, login your client area and Go to Dashboard
  
  
  
  
  
• Now go to Modules > Forumotion plugin and you will now see the management tool for your plugin.
  Click on the button to start  
  
  
  
  
  
• You will be required to confirm and verify some information. Here you can find a full explanation of the different contents.
  
  
  
  
  • Verify Api Key and Forum address
    you will need to check if a valid api-key is available and if the forum address corresponds to the one you will use;
    normally you don't have to change anything in this section.
    
    
    
    
    
  • Customization
    
    
    
    • Multilingual icon
      It is possible to set an icon to highlight multilingual contents. By default a light-bulb is displayed. ( )
      
      
    • Permissions
      It is possible to choose who can create multilingual posts choosing between Admins, Admins & Moderators or everyone
      
    
    
    
    
    
    
  • Translations
    Some translations are required for your plugin. You can leave the default-ones or update them.. it is up to you  
    
    
    
    
    
  
  
  
• Once you are sure that everything is okay, click on I confirm these information to create your plugin.
  
  
• On the next page you will see a self-explicative tutorial to install the plugin on your forum
  

Install your own forumotion plugin

• First, go to to your Administration Panel > Templates > General and edit overall_header
  
  
• Search for </head> in your template content
  
  
• Now paste the personal code-snippet right before this tag.
  Your plugin is hosted in our servers for your own security and safety.
  
  
  example:
  
  
  
• Publish your template
  
  
• Congratulations ! You have succesfully installed the forumotion plugin on your forum
  

Customization

According to your forum version, there are some CSS lines to include in your forum stylesheet. So, go to ACP > Display > Colors > Stylesheet (CSS) and include these lines (according to your forum version)

• PunBB
  

  Code:

  .multilingual-post {
    background: #fff;
    border: 1px solid #ccc;
    border-radius: 100%;
    float: left;
    padding: 3px;
    margin: -0.3% 0%;
}

.default_content {
    float: left;
    padding-right: 8px;
}

sceditor-button-alias div {
    background-image: url('https://www.translationscloud.com/fa_sceditor/fa-alias-button.png')!important;
}

alias {
    display: inline-block!important;
    background: #444444;
    color: white;
    font-style: italic;
    font-size: 11px;
    padding: 4px!important;
    border-radius: 2px;
    border-bottom: 2px solid #6D6B6B;
    box-shadow: 0px 0px 1px white;
}

  
  
• Invision / PhpBB3 / PhpBB2
  

  Code:

  .multilingual-post {
    background: #fff;
    border: 1px solid #ccc;
    border-radius: 100%;
    float: left;
    padding: 3px;
}

.default_content {
    float: left;
    padding-right: 8px;
}

.sceditor-button-alias div {
    background-image: url('https://www.translationscloud.com/fa_sceditor/fa-alias-button.png')!important;
}

alias {
    display: inline-block!important;
    background: #444444;
    color: white;
    font-style: italic;
    font-size: 11px;
    padding: 4px!important;
    border-radius: 2px;
    border-bottom: 2px solid #6D6B6B;
    box-shadow: 0px 0px 1px white;
}

  
  

 Explanation of css lines

• .sceditor-button-alias div
  this class refers to the button in your forumotion #editor. By default a cloud icon is set, but you can replace https://www.translationscloud.com/fa_sceditor/fa-alias-button.png at any time
  
  
• multilingual-post
  this class refers to the icon displayed in multilingual posts. See Creating a new multilingual post section for more information.
  
  
• alias
  if an alias is not valid or can not be found in your translation tool, any replacement will take place and a simple alias tag will be displayed. This class allows you to customize the style of a non-valid alias in your posts
  
  example:
  
  

---

How does it work ?

Creating a new multilingual post

Once the installation process is completed, you can start creating your own multilingual posts and topics  

Thanks to our plugin, a special BBcode button is included in your forumotion editor and it will allow you to include an alias in your post


Of course you can write a normal post and having only a part in multilingual.
Once included it will appear as in the example (Source mode / WYSIWYG mode)


Now we are ready to post it  

---

In your topic page the alias will be automatically replaced with the content of your translation! Wow!


An icon that you can set during the plugin creation will be displayed for valid multi-lingual posts. A simple post or a not-valid multilingual post will not be marked with this icon.

Selecting the multilingual posts' language

If you want to modify or select a language for your multilingual posts you can go on your forum to Profile > Preferences


There is no need to save the page: the update is made inasync mode. If you see the green success text, your modification is done !

What if an alias does not exist in my language ?

If an alias is valid, but it is not available for in your language, the default version will be displayed and a special icon will notify you of a multilingual post in default language

---

For extended technical details, customization and generic support, please contact us in our Plugin assistance section

Have a nice day!

@Niko! this looks awesome, I'll have to give it a try when I get the chance !

@Ange Tuteur it would be an honor

hi about other type of sites like MyBB
can you tell me if that will work or what ?
and what changes i might need

Michael_vx wrote:hi about other type of sites like MyBB
can you tell me if that will work or what ?
and what changes i might need

Hello @Michael_vx

well, no problem, I can adapt a plugin for MyBB
I just need the link to your MyBB forum so that I can prepare it

my forum link is
miccsoft.net
i have a language option at the end of the page which will make default texts into English
but that wont change the topics or section names
sorry for delaying my internet is real bad

I will try to see if we can release a version for MyBB

Michael_vx wrote:hi about other type of sites like MyBB
can you tell me if that will work or what ?
and what changes i might need

..by entering the url of the website..gives you the script for your version.
https://www.translationscloud.com/registration

@jessy he refers to the version of the plugin for MyBB forums

Hello @Michael_vx

MyBB plugin is almost ready

Hello,

we have just released a new version for our Forumotion plugin: the version 1.1.0 is now available for all of you !

This version is dedicated for all the administrators that are using FA-Edge, the responsive design developed by @Ange Tuteur. We noticed that there were some problems with the template modifications for this design, and with the increasing use of it, we decided to adapt our plugin too.

How to update my plugin ?

You can either remove your previous plugin and create a new one, OR you can use our new interface to update your plugins.

You just have to go to Client area > Dashboard > Modules > Plugins and you will see:

• The release notes with the updates of the latest plugin
  
• A new button to update your plugin
  

You just have to click on the button "Update to X.X.X" and it will be automatically updated  

Niko! wrote:Hello @Michael_vx

MyBB plugin is almost ready

ok and im waiting
thanks in advance