ShaunSocial docs ShaunSocial user guide
Version 1.5.6
  • 1.5.6 (this version)

ShaunSocial user guide 1.5.6 / AdminCP

Languages and translation

Admin

Your site can speak several languages. This page explains how to add a language and choose the default one, how to change any text of the website (a button, a heading, the copyright line), how to translate the names you create yourself (menu items, categories, block titles), and how to let members translate posts and messages into their own language.

Manage languages#

Last updated: 2026-11-17 · v1.5.6

The list shows every language of your site with its Name, Key (the two-letter language code), RTL, Default and Active, and the actions Edit, Delete and Edit phrase. After installing there is one language, English, which is the default.

AdminCP, Manage Languages: English (default) and Español with Name, Key, RTL, Default, Active and the Edit, Delete and Edit phrase links
AdminCP → Language → Manage Languages: the list of languages with Edit, Delete and Edit phrase. Screenshot taken 2026-11-17.

Add a language#

  1. Open AdminCP → Language → Manage Languages and click Create new.
  2. Fill in the fields:
    FieldWhat it does
    Namethe name members see in the language list, for example Français (required). After saving you can give it a name in each language with Translate
    Keythe two-letter code of the language, for example fr for French or ar for Arabic (required, exactly two letters, see the list of codes linked under the field). It cannot be changed later
    RTLturn on for a language written from right to left, such as Arabic or Hebrew: the whole site is then laid out from right to left for members who use it
    Defaultmake it the language of visitors and of members who never chose one. Turning it on also turns Active on and locks it
    Activeshow it to members. Leave it off (and Default off) while you translate
  3. Click Submit.

    What you should see: "Language has been created." and the new language in the list.

  4. Translate it: click Edit phrase (see Change the texts of the website), then the texts listed below.
  5. When the translation is ready, click Edit, turn on Active and click Submit.

A new language starts in English: its phrases are ShaunSocial's original English phrases (not the English phrases you may have reworded), and every name and text you can translate elsewhere in the AdminCP is a copy of your current English one. Besides the phrases, translate these in the new language:

The Create language window filled in as an example: Name Français, Key fr, RTL off, Default off, Active on, Submit and Cancel
Creating a language: Name, Key, RTL, Default and Active. Screenshot taken 2026-11-17.

Change the default language#

  1. Click Edit next to the language that should become the default.
  2. Turn on Default and click Submit.

    What you should see: when you turn on Default, Active turns on too and can no longer be switched off in the window. After Submit, the list says Yes under Default for that language only.

  • The Default switch of the current default language cannot be turned off: make another language the default instead.
  • Keep the default language active. Before you switch a language off, make another one the default.
  • While only one language is active, its Active switch is not shown.
  • Delete is offered for every language except English and the default language. It asks you to confirm. Members who used a deleted language see the default language.
  • Members whose language you switch off also see the default language until you switch it on again.

How members choose a language#

Members and visitors click the language button in the footer of the website (a globe icon with the name of the current language), or in the footer of the landing page, and pick one of the active languages. A member's choice is saved in their account and also decides the language of the e-mails they receive; a visitor's choice is remembered by their browser. Everyone who never chose sees the default language.

You choose the language of the AdminCP for yourself with Language at the bottom of the AdminCP menu.

Editing phrases and per-item translations#

Last updated: 2026-11-17 · v1.5.6

The texts of your site come from two places:

  • Phrases: every fixed text of the website (buttons, headings, messages, the texts of the designed landing page, the copyright line). You change them per language with Edit phrase. Changing an English phrase is also how you reword a text on an English-only site.
  • Names you create: menu items, block titles, categories and the like. Each has a Translate link where you enter it in every language.

The ShaunSocial mobile apps carry their own texts, which are not edited here.

Change the texts of the website#

  1. Open AdminCP → Language → Manage Languages and click Edit phrase next to the language.

    What you should see: a list with Phrase (the original English text), Value (the text your site shows in this language) and an Edit link on each row.

  2. Type a few words of the text in Search. The list keeps the rows whose phrase or value contains them.
  3. Click Edit on the row, change the text and click Save.

    What you should see: the new value in the row. Members see it on their next page load; press Ctrl+F5 to see it yourself at once.

Keep the words in square brackets or after a colon exactly as they are, for example [siteName], [year] or :count: they are replaced by real values. For example, the copyright line in the footer is the phrase Copyright © [year] [siteName], and the title of the app box on the landing page is Check out our mobile apps!.

If plugins are installed, a list next to Search chooses whose phrases you see: Core (ShaunSocial itself) or one plugin. A text you cannot find under Core may belong to a plugin.

Edit phrase for English: the Search box, the Phrase, Value and Action columns, and the Download translate and Upload translate buttons
Edit phrase: the search box, the Phrase and Value columns, and the Download translate and Upload translate buttons. Screenshot taken 2026-11-17.

Translate many phrases at once with a file#

To translate a whole language, or to have a translator do it, work in a file:

  1. On the Edit phrase screen, choose Core or the plugin in the list, then click Download translate.

    What you should see: your browser saves a .json file with all phrases of that language.

  2. Open the file in a plain text editor (not a word processor). Each line looks like "Site Information": "Site Information",. Change only the text after the colon; never change the part before it, the quotes or the commas.
  3. Click Upload translate, check the Source, choose the file in File Json and click Submit.

    What you should see: "Phrase has been successfully updated." If the file has a mistake you see "The file is in an incorrect format." and nothing is changed: check the quotes and commas near your changes.

  4. Click Clear cache at the top of the AdminCP (see Clearing the cache) so members get the new texts.

Only phrases that already exist are updated; lines with an unknown phrase are ignored. An upgrade adds the new phrases of the new version in English and keeps your translations.

Translate a name or text#

The names you create in the AdminCP are stored once per language. Once such an item is saved, its name field can no longer be typed over; a Translate link appears under it instead:

  1. Open the item (for example Edit on a menu item) and click Translate under the field.

    What you should see: a window with one box per language of your site. The window opens only for admins whose role may manage languages (the Manage Languages permission; super admins always can).

  2. Fill in the box of each language and click Submit. A name cannot be left empty in any language.

    What you should see: "Translation has been successfully updated."

You find Translate on: menu items, block titles and Html Block content in the layout editor, layout page names, language names, genders, countries, states and cities, report and content warning categories, two-factor methods, the warning messages of role permissions, membership packages and plans, and the categories of groups, events, business pages and Marketplace (with the Marketplace attributes and values). Mail templates and static pages are translated in their own forms instead.

The Translate window of the menu item Home: an English box with Home and an Español box with Inicio, Submit and Cancel
The Translate window of a menu item: one box per language. Screenshot taken 2026-11-17.

Auto-translating member content#

Last updated: 2026-11-17 · v1.5.6

When this is on, members see See translation under posts, comments, replies and chat messages written by other people. Clicking it shows the text translated into the language the member uses on your site. The translation is made by Google's translation service, with an API key from your own Google account; Google charges for it by the amount of text translated (see Google's pricing).

Switch it on#

  1. In your Google Cloud account, enable the Cloud Translation API for a project and create an API key for it. Google asks for a billing account.
  2. Open AdminCP → Language → Manage Translation Providers. The list has one provider, Google, with Default Yes. Click Edit.
  3. Paste the key into Api key and click Save Changes.

    What you should see: "Your changes have been saved."

  4. Open AdminCP → Site Settings → General Configuration → Auto translate settings and tick Enable ("Enable auto translate for post, comment, reply and message"). It is off after installing and saves itself.
  5. Sign in as a member whose language differs from the language of a post, and click See translation under it.

    What you should see: the translation below the text, and Hide translation to close it. "API key not valid. Please pass a valid API key" means the key is wrong or not allowed to use the Translation API.

A post by Liam Nguyen with See translation clicked: the Spanish translation shown below the English text, with Hide translation
A post with See translation clicked: the translated text below the original. Screenshot taken 2026-11-17.

What members see#

  • See translation appears under text written by someone else, when there is text to translate. Visitors who are not signed in see it on public posts and comments too; clicking it takes them to the sign-in page.
  • The text is translated into the language the member chose on your site (see How members choose a language), each time they click.
  • Switching Enable off removes the link everywhere.

Change log#

Last updated: 2026-11-17 · v1.5.6

Date (GMT+7)SectionWhat changed
2026-11-17manage-languages, edit-phrases, auto-translateCorrections after review: what Default does to Active, what a new language starts with, members of a switched-off language, the footer language button, Clear cache after an upload, who may open the Translate window, See translation for visitors.
2026-11-17allFirst version for 1.5.6, written from the 1.5.6 code. The steps were read from the code and the screens; adding a language and translating with Google were not run on a live site.