Install our plugin on Forumotion forums

Hello Dear Members,

As you may have read in our announcement Launching of Plugin for Forumotion forums that 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
    
  
  
  
• How does it work ?
  
  
  
  • 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 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!