My manual 📖

Super convenient of course!

Below you will read how I proceed. I have broken this down into separate chapters for you. From installation to activation and placing a language switch. Not found what you were looking for? Go to the FAQ or contact me 🙂

A bookwork 👁️‍🗨️

Feel free to grab a cup of coffee (or tea) with some goodies. I can’t make it more fun, but maybe a little easier 🤎

1. Install and activate the plugin

> Show me more of this

< Please show me less

1. Download the plugin

Seriously? Yes, it’s true. You must install me first so I can start to do my thing. Go to the download page to get my most recent version.

 

Let’s go and download wpMula

2. Install the plugin

Well done, first you have downloaded the plugin files in a zip. Now it’s time to extract the files and put them in the right place. There are multiple ways of doing this.

 

1. Upload the zip of the plugin to your WordPress site.

You can do this under ‘Plugins’ and then go to ‘Add new plugin’. At the top of the screen you will see a button ‘Upload plugin’. After you click on this button you will see the screen below.

You can find the ‘Add New Plugin’ page under ‘Plugins’ in your dashboard (or network dashboard).


https://example.com/wp-admin/plugin-install.php
https://example.com/wp-admin/network/plugin-install.php

2. Use FTP(S) or SFTP

First unzip the plugin files to a directory. Then connect to your site with a FTP client. Navigate to the plugins folder in your site trough the FTP client.  Then drag the ‘wpmula’ folder to the plugins folder. Usally you will find the plugins folder under “/wp-content/plugins/” inside your WordPress installation.

3. Activate the plugin in WordPress

Go to the plugins page of your site, under ‘Plugins’ in your WordPress dashboard. If you already have a multisite, its best to network activate wpMula under the network settings. In the list of plugins I (wpMula) should be visible, like this:

Click on “Activate” and I am activated in your site.


https://example.com/wp-admin/plugins.php
https://ecample.com/wp-admin/network/plugins.php

4. Activate your license

Before you can use my functions you need to activate your license. The following notice will appear in your screen, click on the ‘Activate license’ button to go to the correct page. There will be a form to fill in your license informatie. You can also find this page through the admin menu under ‘wpMula’.

Enter your information here: Email address, license code and product.

If your license information is correct then I will be activated in your site 🙂


https://example.com/wp-admin/admin.php?page=wa-wpmula

2. Configure wpMula

> Show me more of this

< Please show me less

1. Install multisite

If your site is not already a multisite, we need to install it. The multisite function is a core WordPress function, so it is very stable. I need it to make your site multilingual. There are two ways of installing the Multisite:

1. Automatic, make your site writable and I’ll take care of it for you.

If you see the following button and text I can install it for you. Just click ‘Setup multisite and login again’ and your site will become a multisite. After the installation you will be required to login again. This is normal, don’t be scared 🙂

2. Install it manually

Click on the same button but now you have to follow the WordPress steps. This is a little bit more complex, but if you know what you are doing you should be okay. Basic steps are:

  • Deactivate all the plugins in your site
  • Go to ‘Tools’ and then ‘Network setup’
  • Install the multisite and set the correct values in your ‘.htaccess’ and ‘wp-config.php’
  • Login again
  • Reactivate all the plugins in your site

Here is a great guide to install a WordPress multisite.


https://example.com/wp-admin/admin.php?page=wa-wpmula

2. Validate your multisite installation

After this proces your site should be a multisite. To check this you should see ‘My sites’ in the top left screen of your WordPress dashboard.

Under the ‘wpMula’ menu in your site there should be more menu items like ‘Site management’ and ‘Add translation’.

3. Add new languages to WordPress

The next logical step is to install the new languages in WordPress you need for your site. There are two ways to do this:

1. Through my main settings (wpMula)

Click on the wpMula menu item in your admin bar on the left. Then choose a language and click on update, it’s that easy 🙂

2. When you add a new translation to your site

When you add a new translation to your site, you can also choose any (new) language. In the next chapter I will explain how you can add a new translation to your WordPress site.


https://example.com/wp-admin/admin.php?page=wa-wpmula

 

3. Add a new translation (language)

> Show me more of this

< Please show me less

1. Go to ‘Add translation’ under wpMula

To add a new translation to your site you can go to ‘Add translation’ under ‘wpMula’ in your WordPress admin menu.

https://example.com/wp-admin/admin.php?page=add-translations

2. Determine the URL

First determine the URL of the translation you like to add to your site. Usually you choose the prefix of the country/language. For example see the list below for some languages.

1. German
This will be ‘de’ : example.com/de

2. French
This will be ‘fr’ : example.com/fr

3. Spanisch
This will be ‘es’ : example.com/es

4. English
This will be ‘en’ : example.nl/en

5. Dutch
This will be ‘nl’ : example.com/nl

 

The list above is the logical way to do it. But if you want to be creative and do something else, go your own way 🙂

3. Determine the language

The language you choose here will be used for the front-end of the site. This can be a different language then the language you choose on the back-end. Your visitors will see the site in their language, but you can view the back-end in your own language.

Choose your admin language in the new site under ‘Settings’ and then ‘General’.


https://example.com/wp-admin/options-general.php

4. Determine the name

What is the name of your site in the new lanuage? Often the name of your site will not change in a language, because it’s the name of your company. In this case you can enter the same name for te new language.

5. Choose a source

In many cases you want to translate your site in another language without starting from scratch. This is exactly why this option is available, you can create any duplicate of the sites in the multisite. This means you will get an exact copy that you only have to translate in content. Everything else will be available, like: posts, pages, categories, submissions, media etc.

6. Make the magic happen

Before you do this, it is always wise to create a complete backup of your site (files and database). Although all my functions are thoroughly tested (over and over again) there is always the possibility that something can go wrong.

After creating a backup you can click on ‘Add new translation’. After you click on this, pending on the size of the source site, it will take a while to create a new translation.

4. Connect your content

> Show me more of this

< Please show me less

1. How does this work?

In a few words: you connect the content from one site to the other. This works the same for all content types, for example: posts, pages and categories. If you create a duplicate of a site everything will auto connected. So all existing content will be linked to each other automatically. For new content you need to do this yourself 🙂

1. This is how the translation box looks like for a post in the classic editor of WordPress.

2. This is how it looks for a post in the Gutenberg editor of WordPress.

3. This is how the translation box looks for a term (for example a category or post tag).

 

2. Example how to connect your content

Let’s try it out! The steps are simple, type in the title/name you want to connect in the search field. Usually you will search on the title/name of the counterpart in the other language. For example, to find the ‘Example page’ you type ‘ex’.

Under the search field you will see results matchting with ‘ex’. Now you want to select the ‘Example page’ to connect to this page, click on the button ‘Example page’. It is good to know that the search results all filtered on content type. So if you search while editing a page, you will only see pages in de search results.

Now you can click on ‘Update’ to update the page and they will be connected.

 

3. Example how to disconnect your content

To disconnect an object (page, post or category) simply click on the ‘Disconnect’ link in the translation box. After this you can click on ‘Update’ and the objects will nog longer be related to each other. After you update the object the translation box will be clean, like this:

4. Example how to duplicate your content to a different translation

To make translating and duplicating content easy, you can click on ‘Copy to ..’ link. After this you will be redirected to the other language with an exact duplicate of the object (page, post or category). It will also duplicate your media, so this will be available in the other translation. This will save you tons of work 🙂

5. Add a language switch

> Show me more of this

< Please show me less

1. The available options

There are many options available to configure the language switch. For example you can display a flag for another language or just use text label. It is also an option to display the languages in a dropdown. See the wpMula demo as an example.

See the list below for all available options. A few important options you can choose in the wpMula settings.

Language switch options

– format
default : display a short language name (en)
flags : display links with an image
title : show a full language name (English)
flag-title : display an image flag and a full language name (English)
title-flag : display a full language name and an image flag
flag-slug : display an image flag and a short lanuage name (en)
slug-flag : display a short lanuage name (en) and an image flag

– display
default : display alle languages
dropdown : display current language and the rest in a dropdown

– direction
default : margin to the right
left : margin to the left
center : align items center
vertical : show items in a vertical direction

– current
default : hide
true : display current language

– wrapper
default : div
ul : ul

– style
Here you can put your custom css lines

– styles_container_padding
15px

– styles_item_padding
15px

– styles_dropdown_bg
#fff

– styles_dropdown_container_padding
0px

– styles_dropdown_item_padding
5px 15px

– styles_flags
height: 20px; width: auto;

– class
Custom class
– classitem
Custom item class

– classlink
Custom link class

– divider
A divider between languages, for example “|”

2. Shortcode

The most basic way to add a language switch is with a shortcode. This will work in all WordPress sites, because shortcodes are a WordPress core function. The shortcode of wpMula works in the default manner. You can use all options as descriped in the previous article as option=”value”. The default shortcode is:

So you add the options like this:

Using this format the language switch will be displayed as a flag.

3. Widget

Can you pour me some coffee? I am still working on this. Coming soon 🙂

4. Gutenberg block

Can you pour me some coffee? I am still working on this. Coming soon 🙂

6. String translations

> Show me more of this

< Please show me less

1. What are WordPress String Translations?

String translations in WordPress refer to the translation of text strings embedded in the code of themes and plugins. These can be texts displayed on the front-end or in the admin area of the site. Think of buttons, error messages, labels, menu items and other text that the user sees and needs to understand. An example of this is the text below in my own plugin. This text The base language of WordPress is English and the ‘group’ of translations belongs to the ‘wpmula’ plugin.

2. Navigate to String Translations

Navigate to the ‘String translations’ in the submenu under wpMula.

String translations menu

There you will see the startscreen of the translations. Here you can search for the strings you need to translate.

String translations start

3. Add, update or remove translation

Add translation

1. Search for the string your want to translate

For example you want to translate a string that contains the word ‘example’. Then you input ‘In a few words’ in the search field en get some results. In the first column ‘Source’ you will see the ‘source’ text, the original text. In the second column ‘Default translation’ you will see the current translation. In the third column ‘Custom translation’ you can put in your own translation (by default filled with the ‘default’ translation). If you want to save your ‘Custom translation’, click on ‘Save custom translation’.

String tranlations search

2. In this example we will translate the second row in the results. As you can see in the image below, I added the words ‘My custom translation.’.

String tranlations search example

3. After clicking on ‘Save custom translation’ the translation will be visible on the end of the page. And you will see a succes message on top of the page.

String tranlations search result

4. The translation will be visible on the place where it is used. In this example it is visible in WordPress ‘General’ settings page.

String tranlations view

Update translation

Update a translation is very easy, you can do exactly the same as for adding it. If you change the translation, search for it. The only difference is the ‘Update custom translation’ button, so you can see your are ‘updating’ (not adding).

String tranlations update

Remove translation

Removing a translations completly is a simple action. Just scroll to your translation and click on ‘Remove translation’ to remove it.

String tranlations search result

 

7. General

> Show me more of this

< Please show me less

1. View site activations

You can view the sites that have an active license on your account dashboard.

Go to my account dashboard

Make the multilingual leap today

Start your journey in multilingualism and let your site speak all the languages of the world.