How-To
How to use Apricot Translate and add your translations
Access Apricot Translate Inspector
The inspector is used to configure Apricot Translate and translate WildApricot system labels. If the inspector button is enabled, you will see it on your webpages in the bottom left (if in public view) or the bottom right. If you do not see the button, it is probably hidden in the settings. In that case, press Ctrl + Option + T on Mac or Ctrl + Alt + T on Windows to open the inspector.
Set Up Your Languages
The inspector panel, click on the Settings button to bring the Settings window. Under Languages, add a row for each language you wish to offer, with the first row being your primary language.
There are three columns of inputs per row, all three are required:
- Column 1 → This is the label for the language that will be used in the language switcher
- Column 2 → This is the tag for the language that will be used to tag content gadgets - avoid special characters and spaces
- Column 3 → This is the label shown before the language switcher, letting people know the switcher's purpose.
If you don't plan on translating your site and are just using Apricot Translate to change system labels in your primary language, you can omit adding additional languages. If no additional languages are selected, the language switcher will not be displayed.
Language Toggle & Inspector Button
If you have more than one language set up, Apricot Translate will show a language switcher - a dropdown list of all your available languages that users can use to switch between languages. By default, this is shown floating at the bottom right of the screen. If you would like to place it in a specific location, add a content or HTML gadget to your page or page template in the location you would like the switcher to appear. In the gadget's settings in the sidebar, expand the Advanced section and add a CSS class name (for example: language_switch).
The Inspector button floats at the bottom right or left of your screen by default, making it accessible to everyone. Only Full WildApricot Administrators can actually save modifications to the website so this is not a security issue - however you can hide this button for everyone by unchecking the Show Inspector Button field in the Settings window. With the button hidden, you can still open the Inspector using the following keyboard shortcuts:
- On MacOS: Ctrl + Option + T
- On Windows: Ctrl + Alt + T
Translating User Content
To translate content you add yourself, add add the content in each of your available languages using separate WildApricot gadgets (and if necessary, WildApricot layouts). You would then add the tag you set up in the step above to tag the related language to the gadget or layout. When not in admin view, only the gadget and layouts for the selected language will be shown. Gadgets and layouts without a language tag will always be shown - omit the tags for content that should not change between languages.
Tags are added by expanding the Advanced section when modifying a gadgets settings in its sidebar. Add the tag to the CSS class input.
Translating Your Menus
To translate your menu items, switch to public view. You may need to be logged in as a member to see all menu items are available.
Launch the inspector, as shown in the first step above. The first option you will see here is Site Menu. Click on this to translate menu items found in all menu gadgets, including the Mobile Panel.
In the Translation window, you will see list of each menu page that you have, as well as an input for the translated text. Leave any field blank to continue using the original text.
Click on the Save button to temporarily store the changes. You can use the language switcher to test your changes if needed. Once you are done making updates for each gadget, click on Commit Changes in the Inspector panel or Commit Now in the Unsaved Changes notice to save the translations to your site. Your translations will not be available to others until you do.
When saving, you will be prompted by WildApricot to login once per session. Translations can only be saved by a Full Administrator.
Translating System Labels (Basic)
To translate the system items in gadgets, switch to public view. You may need to be logged in or logged out as a member, depending on what you would like to translate.
Launch the inspector, as shown in the first step above. Here you will see all the gadgets on the current page that are possible to translate in the side panel. Click on a gadget from the side panel to open the Translation window.
In the Translation window, you will see list of each menu page that you have, as well as an input for the translated text. Leave any field blank to continue using the original text. If the label you wish to translate is not listed, you will need to use the Advanced (see below).
Click on the Save button to temporarily store the changes. You can use the language switcher to test your changes if needed. Once you are done making updates for each gadget, click on Commit Changes in the Inspector panel or Commit Now in the Unsaved Changes notice to save the translations to your site. Your translations will not available to others until you do.
When saving, you will be prompted by WildApricot to log in once per session. Translations can only be saved by a Full Administrator.
Translating System Labels (Advanced)
Some labels cannot be translated under the Basic tab and must be done from the Advanced. The Advanced tab provides the ability to target WildApricot classes with "find-and-replace" and/or "regex" rules. (Note: you may need the assistance of a web developer to update these settings.)
Launch the inspector, as shown in the first step above. Here you will see all the gadgets on the current page that are possible to translate in the side panel. Click on a gadget from the side panel to open the Translation window, from here click on the Advanced tab. On this tab, you will see an Add rule button if the selected gadget has any available classes. Not all gadgets have applicable classes.
When you add a row, you will see five columns:
- Column 1 → This is a dropdown of the available classes for the selected gadget. Select the one that holds the content you wish to change.
- Column 2 → Select from the dropdown which language this rule should apply to.
- Column 3 → Select the function that should be applied. Currently, there are just two available: Replace and Regex:
- Replace: This allows you to search for a word or phrase to update. This is the only one you are likely to use.
- Regex: This allows you to add Regular expressions or Regex patterns. This is a much more advanced feature than most users will not need.
- Column 4 → Enter the text to search for, if using the Replace function. If using the Regex function, enter your pattern here.
- Column 5 → Enter the replacement text for the matched replace text or regex pattern.
Click on the Save button to temporarily store the changes. You can use the language switcher to test your changes if needed. Once you are done making updates for each gadget, click on Commit Changes in the Inspector panel or Commit Now in the Unsaved Changes notice to save the translations to your site. Your translations will not available to others until you do.
When saving, you will be prompted by WildApricot to login once per session. Translations can only be saved by a Full Administrator.
Frequently asked questions
On installation, languages, and control.
Will this change my theme?
No. Apricot Translate sits on top of your existing site and works with all themes and custom designs themes.
Which platforms are supported?
Apricot Translate is only compatible with the WildApricot website platform.
Do you store our content?
No, all translations are stored directly on your website. You retain ownership of any translations made even if you cancel your subscription.
Can you set this up for us?
It's designed to be simple. We're happy to help or complete the install for you — just reach out.
Get Support
Get help with installation, get questions answered, or request our "Do-it-For-You" service.
- Email support: support@ansidmedia.com
Access your Stripe billing portal
We'll email you a secure link — no login required.
If an account exists for that email, we've sent the link.