Requirements: EventKoi (Lite or Pro).
EventKoi is fully translation-ready. This guide is for site owners and developers who want to run EventKoi in a language other than English.
How EventKoi translations work
EventKoi uses the standard WordPress translation system. The plugin’s text domain is eventkoi, and a template file listing every translatable string ships with the plugin at languages/eventkoi.pot.
Option 1: Translate with Loco Translate (recommended)
Loco Translate is a free plugin that lets you translate directly in your WordPress dashboard. EventKoi supports both of its save locations out of the box.
- Install and activate Loco Translate from Plugins → Add New.
- Go to Loco Translate → Plugins and click EventKoi.
- Click New language and choose your language, for example Portuguese (Portugal) or Portuguese (Brazil).
- For the location, choose System. This keeps your translations safe when EventKoi updates. The Author location also works.
- Click Start translating and work through the strings. Untranslated strings simply fall back to English, so you do not need to finish everything in one sitting.
- Click Save. Your translations take effect immediately on both the frontend and the admin screens.
Tip: use the search box in Loco’s editor to find a phrase you have seen on your site, such as “Add to calendar”, and translate the strings your visitors see first.
Option 2: Translate with Poedit
Prefer to work offline, or preparing translations for a client site? Use the free Poedit app instead.
- Download and install Poedit from poedit.net.
- Copy the template file from your site:
wp-content/plugins/eventkoi/languages/eventkoi.pot. - In Poedit, choose File → New from POT/PO file and select the template.
- Choose your language when prompted, then translate the strings.
- Save. Poedit generates a
.pofile (editable) and a.mofile (compiled). - Name the files with the plugin slug and your WordPress locale code, for example
eventkoi-pt_PT.poandeventkoi-pt_PT.mofor Portuguese (Portugal), oreventkoi-pt_BR.poandeventkoi-pt_BR.mofor Brazilian Portuguese. - Upload both files to
wp-content/languages/plugins/on your site. Create the folder if it does not exist.
Not sure of your locale code? Check Settings → General → Site Language in WordPress. The code appears in the URL of translation files, or you can look it up in the WordPress locale list at make.wordpress.org/polyglots/teams.
Translating EventKoi Lite via WordPress.org
EventKoi Lite is hosted on the WordPress.org plugin repository, so it also has a community translation project on translate.wordpress.org. If a translation into your language already exists there and has been approved by the language’s translation team, WordPress downloads and applies it automatically. You do not need to install anything or touch any files.
If your language is missing or incomplete, you can contribute translations yourself. Visit the EventKoi Lite translation project on translate.wordpress.org, choose your language, and suggest translations for any untranslated strings. Suggestions are reviewed by that language’s volunteer translation team before they go live, so there can be a delay before your strings appear on your site. If you need a translation immediately, use Loco Translate or Poedit as described above rather than waiting on the review queue.
This route only applies to EventKoi Lite. EventKoi Pro is not distributed through the WordPress.org repository, so Pro translations are always managed with separately.
Set your site language
Translations follow your site language, so make sure it is set correctly under Settings → General → Site Language. EventKoi will then display in that language wherever translations exist.
Troubleshooting
Some strings are still in English
They may not be translated yet. Open your translation in Loco Translate or Poedit, search for the English phrase and add a translation. If the string is missing entirely, update EventKoi to the latest version and refresh the template (in Loco Translate, use Sync on the template screen).
My translations disappeared after updating EventKoi
This happens when translation files are saved inside the plugin folder, which is replaced during updates. Move your .po and .mo files to wp-content/languages/plugins/, or choose the System location in Loco Translate.
The calendar or checkout is still in English but everything else translated
Clear any caching on your site and hard-refresh your browser. EventKoi serves its JavaScript translations from the same file as the rest of the plugin, so once the admin screens translate, the frontend will too after caches are cleared.
Share your translation
Made a full translation? We would love to bundle it or share it with other users in your language. Get in touch and send us your .po file.