Skip Navigation
Home » WPML Documentation » Compatibility Documentation » Using the Bloom Email Opt-In Plugin with WPML

Using the Bloom Email Opt-In Plugin with WPML

Kathy Banach
Updated
October 18, 2024

The Bloom plugin allows you to add email opt-in forms to your website. You can then connect these forms to your email marketing or email newsletter software. Using WPML, you can translate the opt-in forms you create with Bloom, making it easier to separate your contacts based on language.

Check out our blog for a comparison of recommended email marketing and lead generation tools for multilingual sites.

Getting Started

Start by installing and activating the following: 

  • Bloom plugin (a premium email opt-in plugin that comes with the Elegant Themes membership package)
  • WPML core plugin and the WPML String Translation add-on

If you’re new to WPML, check out our Getting Started Guide. It offers a comprehensive guide of the different translation options you can use.

Connecting to an Email Marketing Software

Before you can create opt-in forms with Bloom, you need to connect Bloom to your email marketing software. To learn more, see the basic overview of the Bloom plugin.

The Bloom plugin allows you to connect multiple accounts, so you can choose to have separate contact lists for each of the languages on your site. You can then connect your multilingual campaigns to any of the email lists you set up.

WPML works fine with all of the email marketing softwares Bloom allows you to connect with. For the purpose of this tutorial, we connected to a MailChimp account.

Translation Methods for Opt-In Forms Created with Bloom

Bloom allows you to create 6 opt-in types: 

  • Pop-up
  • Fly-in
  • Below post
  • Inline
  • Locked Content
  • Widget

The translation workflow depends on:

  • The opt-in type
  • Whether you want to translate the opt-in forms or create different opt-in forms per language

Below, we’ll walk you through all the translation options you can use.

Displaying Opt-In Forms On Specific Posts and Pages Across Different Languages

Bloom allows you to show each of the opt-ins you create on your entire site, or on specific posts and pages. You can configure this in the Display Settings for every opt-in form you build.

The settings you configure in the Display On section are automatically applied to all of your site’s languages. Let’s say you create an opt-in form and choose to display it on post. In this case, the opt-in form will be automatically displayed on all the posts in all your site’s languages.

However, you can also configure specific opt-ins to appear on, or be excluded from specific posts and/or pages on your website:

  • Display On These Pages allows you to select the pages you want to display the opt-in on
  • Display On These Posts allows you to select the posts you want to display the opt-in on
  • Do Not Display On These Pages allows you to choose the pages you do not want to display the opt-in on
  • Do Not Display On These Posts allows you to specify the posts you do not want to display the opt-in on

If you want an opt-in form to be displayed on, or excluded from a specific post or page in both your site’s default and secondary languages, you first need to translate that post or page.

You will then be able to use the dropdown menus in each configuration section to select the exact posts and pages in your default and secondary languages you want the opt-in form to be displayed on or excluded from.

Selecting the specific posts in default and secondary languages to display the opt-in form on

Displaying Opt-In Forms in Specific Categories Across Different Languages

Bloom also allows you to display opt-in forms on specific category pages. You can configure this in the Display On These Categories section in Display Settings.

Bloom only allows you to select from categories created in your site’s default language. If you want the opt-in to appear on a category page in your site’s secondary language, you will need to translate the category ID. Please note that before you can translate the category ID, you need to translate the category terms.

For demonstration purposes, we created a pop-up opt-in form and configured it to appear only in our DIY category. In the steps below, we’ll first show you how to get the ID of a category in your site’s default and secondary languages. Then, we’ll show you how to translate the category ID in String Translation. 

  1. In your site’s default language, go to Posts → Categories and Edit the specific category you want to get the ID for. Make a note of the ID number in the post’s URL.
Making a note of the category ID in the default language
  1. Use the language switcher in your top admin bar to switch to your site’s secondary language. You should see a different category ID number in the post’s URL. Make a note of it.
Making a note of the category ID in the secondary language
  1. Go to WPML → String Translation and use the In domain dropdown menu to search for strings in the admin_texts_et_bloom_options domain. You can also use the search bar to search for the category ID in your site’s default language.
Searching for the default language category ID in String Translation
  1. Click on the plus icon next to the string and add the category ID in your site’s secondary language. Hit enter to save the translation.
Translating the category ID in String Translation

Translating Pop-Up, Fly-In, and Below Post Opt-In Forms

When you are done creating a pop-up, fly-in, or below post opt-in, follow the steps below to translate it:

  1. Go to WPML → Theme and plugins localization and scroll down to the Strings in the plugins section.
  2. Check the box next to Bloom and click on Scan selected plugin for strings. 

Once scanning is complete, navigate to WPML → String Translation:

  1. Use the In domain dropdown menu to search for strings within the bloom domain.
  2. Click the plus icon next to the string you want to translate. If the text is wrapped in HTML tags, make sure to include them in the translated version as well. When you’re done, hit enter to save the translation.
Translating the pop-up opt-in form texts in String Translation

Creating and Displaying Different Pop-Up, Fly-In, and Below Post Forms Per Language

You can create different pop-up, fly-in, and below post opt-in forms in each of your site’s languages. You can then choose the exact posts or pages on which you want to display each of the forms you create.

To do this:

  1. Go to Bloom → Optin Forms and click on the New Optin button. 
  2. Select the opt-in type and set up your opt-in form. Then, create the form’s content in your site’s secondary language.
Creating a fly-in opt-in form in the site’s secondary language
  1. In Display Settings, define the pages and posts in your secondary language you want to display the opt-in forms on.
Selecting the secondary language posts and pages to display the opt-in form on

Once you Save the form, view the post or page with the form on the front-end. You should be able to see your opt-in form.

An opt-in form in the secondary language on the front-end

Translating Inline and Locked Content Opt-In Forms

The inline and locked content opt-in form types allow you to create your own opt-in shortcode, which can then be used in any post or page on your website.

You can translate the inline or locked content opt-ins you create in your site’s default language by following a two-step process:

  • Translate the post or page you added the shortcode to 
  • Translate the opt-in form texts in String Translation

Below, we’ll walk you through both parts of the process. For the purposes of this tutorial, we created an inline opt-in form. You can follow the same steps to translate your locked content opt-ins. 

To translate the post or page you added the opt-in shortcode to:

  1. Edit your post or page. In the right sidebar, locate the Language box and click on the plus icon next to the language you want to translate the page into.
Clicking the plus icon to translate the post
  1. You’ll be taken to the Advanced Translation Editor. Click on the plus icon next to the optin_id and then press the copy icon to copy the opt-in form ID into your secondary language. 
Copy the optin form ID into your secondary language
  1. Translate the rest of the content and click on the Complete button when you’re done.

To translate the form texts:

  1. Go to WPML → String Translation and use the display filter at the top of the page to search for the texts you want to translate in the bloom domain. 
  2. Click on the plus icon next to the texts you want to translate. If the text is wrapped in HTML tags, make sure to copy them over to the translation.Then, hit enter to save the translation.
Translating the inline opt-in form texts in String Translation

Creating and Displaying Different Inline and Locked Content Opt-In Forms Per Language

In Bloom → Optin Forms, you can manually create different inline and locked content opt-in forms in each of your site’s languages. In this case, each of the opt-in forms you create will have a different form ID. 

It is important that you make a note of the form ID for each language. This is because you will need to translate the optin_id to make sure each opt-in form displays on the post or page in the corresponding language.

Once you create a post or page and add the shortcode with the default language optin form ID to it, follow the steps below:

  1. From the Language box in the right sidebar, click the plus icon next to the language you want to translate the page into.
Clicking the plus icon to translate the page
  1. You’ll be taken to the Advanced Translation Editor. Click on the plus icon next to the optin_id and then enter the form ID of the inline or locked content opt-in form in the corresponding secondary language.
Translating the optin form ID
  1. Translate the remaining content and click on the Complete button when you’re done.

On the front-end, you should see the opt-in form in the same language as your post or page.

Inline opt-in form displayed on a post in the site’s default language

Inline opt-in form displayed on a post in the site’s secondary language

Translating Widget Opt-In Forms

With the Bloom plugin, you can create opt-in forms which can be placed in any widget area on your website. 

Once you create a widget opt-in in your site’s default language, go to WPML → String Translation:

  1. Using the display filter at the top of the page, search for the strings you want to translate in the bloom domain.
  2. Click on the plus icon next to the string you want to translate. Remember to copy over the HTML tags. Then, press enter to save the translation.
Translating the opt-in widget texts in String Translation

Please note that if you can’t find the text you want to translate in the String Translation table, you may need to go to WPML → Theme and plugins localization and scan the Bloom plugin for strings. 

Creating and Displaying Different Widget Opt-In Forms Per Language

In Bloom → Optin Forms, you can manually create different widgets in each of your site’s languages. 

To choose where to display each widget:

  1. Go to Appearance → Widgets.
  2. Insert the Bloom block and use the Select Optin dropdown menu to add the widget of your choice.
Adding a Bloom block-based widget
  1. In the right sidebar, navigate to the Block tab and use the Display on language dropdown menu to select the language you want to display the widget on.
Selecting the language to display the widget on
  1. Update the changes. The widget will only be displayed in the language you selected. If needed, you can add another widget to the same widget area and select a different language for it.

Known Issues

There are no unresolved compatibility issues between this plugin and WPML. Search all known issues.

Getting Help From Our Technical Support

For more help translating your site built using HubSpot and WPML, visit WPML’s support forum.

Alternative Email Marketing Plugins

WPML is compatible with various other email marketing and lead generation WordPress plugins. Visit our Best Email Marketing & Lead Generation guide to learn more about our recommended solutions.