Installation

System Requirements

Requirement	Minimum version
WordPress	6.5
PHP	7.4
MySQL	5.7
MariaDB	10.3 (alternative to MySQL)

If you are on PHP 7.3 or older, update PHP before installing — the plugin will not activate on older versions.

Install via WordPress Admin

1. Download the omnalingo.zip file from omnalingo.com.

2. In your WordPress admin, go to Plugins → Add New → Upload Plugin.

3. Click Choose File, select the omnalingo.zip file, then click Install Now.

4. Once the upload finishes, click Activate Plugin.

After activation, WordPress redirects you to the Omnalingo settings page. An Omnalingo menu item also appears in the WordPress admin sidebar.

Tip

If the redirect does not happen, navigate to Omnalingo → Settings manually. This can occur if a caching layer cleared the redirect before it fired.

Install via FTP

1. Unzip omnalingo.zip on your computer.

2. Upload the resulting omnalingo folder to /wp-content/plugins/ on your server using an FTP client.

3. In your WordPress admin, go to Plugins and click Activate next to Omnalingo.

What Happens After Activation

When the plugin activates, it:

• Creates its database tables to store your URL index, scanned strings, and translations.
• Creates a Translator user role for team members who only need to edit translations (not your site content).
• Registers the URL rules that make language-prefixed URLs like /fr/about/ work correctly.

None of your existing content is changed.

Enter Your API Key

1. Go to Omnalingo → Settings → License.

2. Click Generate Free Key to create a free key instantly — no account or credit card required. If you already have a key (for example, after upgrading to Pro), paste it into the field and click Save instead.

The free key gives you one target language and a one-time quota of 2,000 AI-translated words. Manual editing is always unlimited. To unlock more languages and AI auto-translation at scale, upgrade to Pro from within the plugin.

Without a valid API key:

• AI-powered bulk translation is unavailable.
• Manual translation in the visual editor still works.
• Content gathering and scanning work in full.

Add Your First Target Language

1. Go to Omnalingo → Settings → Languages.

2. Click Add Language and select the language you want to translate into.

3. Click Save.

Omnalingo will also download WordPress’s own translation files for that language in the background. This ensures that standard WordPress interface text (date formats, default button labels) appears in the correct language as well.

Verify the Installation

After saving your first target language, go to Omnalingo → Dashboard. You should see:

• Your source language listed in the header area.
• Your target language available in the language selector.
• Controls for Gather Content and Scan Content.

If the dashboard shows an error, check the following:

Symptom	What to check
Dashboard does not load	Deactivate and reactivate the plugin to re-run the database setup
”403 Forbidden” error in the dashboard	A security plugin may be blocking Omnalingo’s internal API — whitelist the omnalingo/v1/ path
Language list is empty	Go to Settings → Languages and confirm a target language has been saved

Next Steps

With the plugin installed and your first language added, follow the Quick Start guide to gather your content, scan your pages, and run your first translation.