Skip Navigation

This thread is resolved. Here is a description of the problem and solution.

Problem:
The client needed to translate a shortcode from German to French using WPML for a non-compatible plugin and was unsure how to proceed.
Solution:
We guided the client through the process of translating a shortcode using a custom XML configuration. Here are the steps we recommended:
1. Add the new XML configuration by navigating to WPML → Settings → Custom XML Configuration, then click “Save.”
2. Make a minor change to the page containing the shortcode and update the page.
3. Go to the translation editor and change the ID to match the translated version.
It's important to back up the database before making any changes.

If this solution does not resolve your issue, or if it seems outdated or irrelevant to your case, we highly recommend checking related known issues at https://wpml.org/known-issues/, verifying the version of the permanent fix, and confirming that you have installed the latest versions of themes and plugins. If further assistance is needed, please open a new support ticket at WPML support forum.

This is the technical support forum for WPML - the multilingual WordPress plugin.

Everyone can read, but only WPML clients can post here. WPML team is replying on the forum 6 days per week, 22 hours per day.

This topic contains 8 replies, has 0 voices.

Last updated by Andrey 1 week, 3 days ago.

Assisted by: Andrey.

Author Posts
March 19, 2025 at 12:43 pm #16835306

Michael

<b>Background of the issue: </b>
I need to translate a shortcode on the page hidden link from German to French using WPML. I have never done a shortcode translation with WPML for non-compatible plugins, and I need help with it. I am following this documentation: https://wpml.org/documentation/support/language-configuration-files/translate-custom-shortcodes-with-wpml/#:~:text=To%20translate%20shortcodes%20from%20compatible,rest%20of%20your%20page%20contents.

<b>Symptoms: </b>
I am unsure how to translate a shortcode with WPML for non-compatible plugins.

<b>Questions: </b>
How can I translate a shortcode (fluent forms) on my page using WPML for non-compatible plugins? I have a quick video for you here: hidden link

March 19, 2025 at 3:07 pm #16835960

Andrey
Supporter

Languages: English (English ) Russian (Русский )

Timezone: Europe/Kyiv (GMT+03:00)

Thank you for the video and the explanation.

Your steps in the screencast are correct. You will not overwrite any existing XML settings; instead, you'll be adding a new XML configuration. Here’s a more straightforward outline of the steps to follow:

1. Add the new XML configuration by navigating to WPML → Settings → Custom XML Configuration, then click “Save.”

2. Make a minor change to the page containing the shortcode and update the page.

3. Go to the translation editor and change the ID to match the translated version.

Before making any changes, please ensure that you back up your database first.

March 19, 2025 at 4:31 pm #16836554
Michael

Thanks Andrey,

good to know then.
I did as you wrote -but still see no way in the translation editor to edit any "ID".

Also when I tried the trick with make a slightly change to the page (in the orig. language) a 2nd and 3rd time and then go to the translation editor, I get this error - see screenshot attached.

Is this something on the wpml site itself? As when in the translation editor its a hidden link?.... link and not the website url itself.

New threads created by Andrey and linked to this one are listed below:

https://wpml.org/forums/topic/split-failed-to-parse-because-your-job-is-above-file-limit-of-1mb/

Screenshot_10.jpg
March 19, 2025 at 5:04 pm #16836683

Andrey
Supporter

Languages: English (English ) Russian (Русский )

Timezone: Europe/Kyiv (GMT+03:00)

Thank you for your feedback.

Did the ID not appear in the translation editor after the page update? Did you also add the line to the functions.php of your current theme?

Also when I tried the trick with make a slightly change to the page (in the orig. language) a 2nd and 3rd time and then go to the translation editor, I get this error - see screenshot attached.

Is this something on the wpml site itself? As when in the translation editor its a hidden link?.... link and not the website url itself.

This indicates that the page has a lot of data for translation and has exceeded the limit. For example, the issue might be caused by some HTML metadata that could be added to each heading and paragraph on that page or custom CSS data if you added some. So, something besides the text for transaltion could be attached to the translation job and increased it.

If you encounter this issue again, please check the headings and paragraphs, and if you find the same metadata, make sure to delete it. Also, if you paste content, check if any metadata are pasted with it. I hope this helps.

March 19, 2025 at 6:07 pm #16836830

Michael

Thanks Andrey,

yepp I did as you said reg. the [shortcode] issue. See also the video here:
hidden link

I also show you in the clip any possible add. information or html metadata. Its not really much there. Please see for yourself - and kindly let me know in case where I could see that extra HTML metadata to each heading/paragraphs. (after viewing the video)

😊

Cheers,
Michael

March 20, 2025 at 12:52 pm #16840085

Andrey
Supporter

Languages: English (English ) Russian (Русский )

Timezone: Europe/Kyiv (GMT+03:00)

Hello Michael,

Thank you for your explanation. Yes, I was referring to the metadata on the page itself; that might be one reason for the issue, but what you’ve shown looks fine.

Regarding the shortcode, it won’t appear in the Advanced Translation Editor (ATE) until you trigger the translation. Here’s what you can do:

1. Make a minor change to the page that contains the shortcode and update the page.
2. Then, go to the translation editor and change the ID to match the translated version.

Let’s see if the ATE opens following these steps.

As for the issue with the ATE not loading, I’ve opened a new support ticket to avoid confusion. I will reply here: https://wpml.org/forums/topic/split-failed-to-parse-because-your-job-is-above-file-limit-of-1mb/.

March 21, 2025 at 3:05 pm #16845159

Michael

Hi again Andrey,

I did a minor change on the orig. language - page. And then checked on the translated page in regards to the shortcode issue. It did not work.

Meanwhile I did a workaround with a code-snipet for the functions.php. In case its of interest - please see here:

hidden link

Cheers,
Michael

March 21, 2025 at 6:03 pm #16846146

Andrey
Supporter

Languages: English (English ) Russian (Русский )

Timezone: Europe/Kyiv (GMT+03:00)

Hello Michael,

The workaround is good 🙂

Let me check if I can make it display in ATE. In order to be of better help, I need to request temporary access (wp-admin and FTP) to your site—preferably to a test site where the problem has been replicated. When you log in to leave your next reply, you will find the needed fields below the comment area. The information you will enter is private, meaning only you and I can see and access it.

Please include the page where the form is.

March 21, 2025 at 7:15 pm #16846270

Michael

Hi Andrey,

thanks for getting back to me.
I will have you access to the site on Monday. (as I dont have the ftp credentials yet)

Sending you best WE wishes,
Michael

March 21, 2025 at 8:06 pm #16846384

Andrey
Supporter

Languages: English (English ) Russian (Русский )

Timezone: Europe/Kyiv (GMT+03:00)

Thank you, Michael.

I am activating the private message again so you can fill it out on Monday.

Have a nice weekend!

March 26, 2025 at 2:07 pm #16863312

Andrey
Supporter

Languages: English (English ) Russian (Русский )

Timezone: Europe/Kyiv (GMT+03:00)

Thank you, Michael.

No worries at all. I will look into it and let you know as soon as I have more information.

March 26, 2025 at 4:09 pm #16864163

Andrey
Supporter

Languages: English (English ) Russian (Русский )

Timezone: Europe/Kyiv (GMT+03:00)

Hello Michael,

I was able to add the form ID to the translation editor. Actually, you did everything correctly; we just missed a small detail 🙁 We were probably distracted by the issue with the ATE not loading the page where the form is located. I've resolved this problem too and will update you in a separate support ticket.

Here’s what I did:

1. Added back your shortcode: [fluentform id="18"]

2. Updated the original page, which required the translation to be updated, indicated by the round icon.

3. Went to ATE and searched for the ID.

I have uploaded a screenshot for your reference.

Screenshot 2025-03-26 at 17.57.50.png