Translations Manager for Osclass is a professional standalone admin plugin to create, edit, scan, back up and maintain gettext .po / .mo translation catalogs for Osclass Core, Themes and Plugins — with a modern admin UI (Dashboard, Editor, Configuration, Logs, License, Updates).

What you get

• Dashboard — completion %, missing strings, QA issues, missing catalogs
• Translation editor — search, filters, statistics, import/export
• Source scan — create or refresh catalogs from PHP gettext functions
• Bulk scan — batch job from Dashboard per site language
• Automatic backup — before save, restore per catalog
• Quality checks — placeholders, HTML balance, empty strings
• Optional AI translation — Pollinations, Gemini, Vertex AI, NVIDIA NIM, OpenAI, Groq, OpenRouter (preset models + Custom model ID)
• Translation Memory + glossary for consistent AI output
• Licensed updates — check, download, install, rollback
• Security — CSRF protection, super-admin-only mode, diagnostics
• English and Arabic admin UI included

Typical workflow

1. Install and enable the plugin
2. Add languages in Osclass → Settings → Languages
3. License tab → activate your purchase key
4. (Optional) Configure AI provider and your own API key
5. Open catalog → translate → Save (.mo required for frontend)

What this plugin does NOT do

• Does not auto-translate your site on install
• Does not include free AI API credits — you must provide your own provider key
• Does not replace human review of translations
• Does not scan hardcoded strings not wrapped in gettext functions
• Updates are not from Osclass Market — delivered via the vendor license server

License

One license key per site (typically). Required for AI features and plugin updates. AI API keys stay on your server.

Support

Installation, license activation, and plugin bug fixes. Contact the seller through your Codester purchase page.

AI translation — your own API key required

Important: AI batch translation is optional. The plugin does not include AI API keys or free AI credits. You need:

• A valid Translations Manager license key (from your Codester purchase)
• Your own AI provider API key — billed by the provider (Google, OpenAI, Groq, Pollinations, etc.)

Supported providers: Pollinations, Google Gemini, Vertex AI, NVIDIA NIM, OpenAI, Groq, OpenRouter.

In Configuration → AI Translation, each provider includes a help panel with links to browse official model catalogs and get an API key. Choose a recommended preset model, or use Custom model ID… for newer models not yet in the list.

Manual translation without AI is fully supported — no AI key needed for editing .po/.mo catalogs by hand.

• Standalone Osclass plugin — no core file edits required
• Full catalog management — Core, Themes and Plugins (.po / .mo)
• Modern responsive admin UI — Dashboard, Translations, Configuration, Logs, License, Updates
• Smart translation editor — search, filters (untranslated / issues), per-catalog statistics
• Source scan — create or refresh catalogs from PHP gettext functions
• Bulk scan — batch job from Dashboard per site language
• Import / export — .po, .mo, ZIP archives; copy translations between languages
• Automatic backup — before save, configurable retention, one-click restore
• Quality checks (QA) — placeholders, HTML balance, empty strings
• Dashboard overview — completion %, missing catalogs, attention filters
• Optional AI translation — Pollinations, Gemini, Vertex AI, NVIDIA NIM, OpenAI, Groq, OpenRouter (preset models + Custom model ID)
• BYO AI API key — no AI credits included; you pay the provider directly
• Translation Memory — reuse identical strings across catalogs
• Custom glossary — injected into AI prompts for consistent terminology
• License-gated AI — secure authorization via vendor license server
• Licensed updates — check, download, install, rollback from backup
• Stable / beta update channel — when enabled on your license
• Security — CSRF protection, super-admin-only mode, rate limits
• System diagnostics — PHP limits, writable paths, ZipArchive, cURL status
• Bilingual admin UI — English and Arabic plugin interface

Minimum requirements (plugin install & basic use)

• Osclass 3.x, 4.x or 8.x — working classifieds installation with admin access
• PHP 7.4 or higher (PHP 8.1+ recommended)
• PHP cURL extension — required for license activation/verification and optional AI features
• Gettext PHP library — included with standard Osclass installs (Composer). Required to read/write .po and .mo catalogs
• PHP JSON support — standard in modern PHP (used by admin AJAX)
• Writable folders:
  • oc-content/languages/ (Core catalogs)
  • Theme language folders you edit (e.g. oc-content/themes/your-theme/languages/)
  • Plugin language folders you edit (e.g. oc-content/plugins/plugin-name/languages/)
  • Plugin folder oc-content/plugins/translations_manager/ (backups & logs)
• Modern browser for Osclass admin (Chrome, Firefox, Edge, Safari)
• No Osclass core edits — do not modify oc-includes/ or oc-load.php

Before you translate (Osclass setup)

• Add your site languages first in Osclass → Settings → Languages — the plugin does not create Osclass languages for you
• Open or create the relevant .po catalog, translate, then Save — Osclass frontend uses compiled .mo files, not .po alone
• By default, only the super administrator (admin ID 1) can access this plugin

Recommended server settings

• HTTPS on your site (strongly recommended for license activation and updates)
• PHP max_input_vars — at least 3000 for medium catalogs; 5000+ recommended for large Core/theme catalogs (otherwise Save may fail — diagnostics shown in Configuration)
• PHP memory_limit — 128M or higher recommended for large catalogs and AI batches
• Outbound HTTPS allowed from your server (hosting firewall / proxy must not block API calls)

Additional requirements by feature

• Licensed plugin updates (check / download / install / rollback):
  • Valid purchase license key activated on this site
  • PHP ZipArchive extension (required to install update packages)
  • Outbound HTTPS to the vendor license server
  • Future update packages may require a higher minimum PHP version (shown on the Updates screen before install)
• AI batch translation (optional):
  • Valid purchase license key activated on this site
  • Your own API key from an AI provider (Pollinations, Gemini, OpenAI, Groq, OpenRouter, Vertex AI, NVIDIA NIM, etc.) — AI usage is billed by the provider, not included in the plugin price
  • PHP cURL + outbound HTTPS to your chosen AI provider
• ZIP archive export/import — PHP ZipArchive extension

AI translation — API keys (IMPORTANT — read before purchase)

This plugin does NOT include AI API keys, AI credits, or paid AI usage. AI translation is optional integration only. You must create your own account with an AI provider and enter your own API key in the plugin Configuration. All AI costs are billed directly by the provider to you — not by the plugin seller.

Two separate keys are required for AI features:

1. Translations Manager license key — included with your Codester purchase (one site activation). Used only to authorize AI usage on your site.
2. Your AI provider API key — NOT included. You must obtain it yourself from the provider below.

Supported AI providers in this plugin:

• Pollinations (recommended default)
• Google Gemini (Google AI Studio API key)
• Google Vertex AI / Agent Platform (GCP project + API key or OAuth)
• NVIDIA NIM (NVIDIA API key from build.nvidia.com)
• OpenAI
• Groq
• OpenRouter

Choose a model: In Configuration → AI Translation, each provider shows recommended preset models in a dropdown. Use Custom model ID… only if your model is not in the list — copy the exact ID from the provider model catalog (official links below and inside the plugin admin help panel).

Official provider model catalogs (browse before you choose):

• Pollinations: enter.pollinations.ai
• Google Gemini: Gemini API models documentation
• Vertex AI: Vertex AI models documentation
• NVIDIA NIM: build.nvidia.com/models
• OpenAI: OpenAI models documentation
• Groq: Groq models documentation
• OpenRouter: openrouter.ai/models

The plugin seller does not:

• Supply AI API keys or free AI credits
• Pay your AI provider bills
• Store your AI API key on an external license server (your key stays on your Osclass site)
• Guarantee AI output quality without human review

You can use the plugin without AI — manual translation, source scan, backup, import/export and QA checks work without an AI API key (license still required for plugin updates; AI is optional).

Network access

• License server — required for license activation, verification, AI authorization gate, and plugin updates
• AI provider API — only if you enable AI translation (you choose the provider)
• Shared hosting with blocked curl / outbound HTTPS may prevent license and AI from working

Not required

• Osclass official marketplace account for plugin updates (updates are delivered via the vendor license server)
• Editing Osclass core files
• ZipArchive for basic manual editing and saving of .po/.mo — only needed for updates and ZIP tools

Important notes for buyers

• This is an admin translation tool — it does not auto-translate your public website immediately after install
• Only strings wrapped in gettext functions (__(), _e(), _m(), etc.) can be scanned from source code
• One license key is typically valid for one site/domain activation
• License key is delivered after purchase through Codester — not embedded in the download ZIP

1. Installation

1. Download the ZIP from Codester and extract the folder translations_manager
2. Upload it to: oc-content/plugins/translations_manager/
3. In Osclass admin go to Plugins
4. Find Translations Manager → click Install, then Enable
5. Open the plugin from Configure or the Plugins menu

Do not edit Osclass core files (oc-includes/, oc-load.php).

2. Add site languages first (Osclass)

1. Go to Settings → Languages in Osclass admin
2. Add the languages you need (e.g. Arabic, French, English)
3. The plugin manages translation catalogs — it does not create Osclass languages for you

3. Activate your license

1. Open Translations Manager → License
2. Enter the license key you received after purchase (via Codester message)
3. Click Save license settings or Activate license
4. Click Verify now to confirm the license is active on this site

Note: One license key is typically valid for one site/domain. The license key is stored securely on your server and is never shown in the page source.

4. Translate a catalog (manual — no AI required)

1. Open Dashboard to see completion % and missing catalogs
2. Go to Translations
3. Choose: Language + type (Core / Theme / Plugin)
4. Click Edit on the catalog you want
5. Translate strings in the editor (search, filters: untranslated / issues)
6. Click Save — the plugin writes .po and compiles .mo
7. Clear site cache if you use caching, then check the frontend

Important: Osclass displays translations from .mo files. Saving is mandatory — editing alone is not enough.

5. Create or refresh catalog from source code

1. In the catalog editor, use Create from source or Update from source
2. Or from Dashboard, run Bulk scan for a site language
3. Only strings wrapped in gettext functions (__(), _e(), _m(), etc.) are detected
4. Hardcoded text in PHP files without gettext is not scanned

6. Optional — AI batch translation

IMPORTANT — read before using AI:

• This plugin does NOT include AI API keys or free AI credits
• You must use your own API key from an AI provider — all AI costs are billed by the provider to you
• You also need a valid Translations Manager license activated on this site
• Your AI API key stays on your server — the plugin only checks permission with the license server

Supported AI providers: Pollinations (recommended), Google Gemini, Vertex AI, NVIDIA NIM, OpenAI, Groq, OpenRouter.

How to choose a model:

1. Go to Configuration → AI Translation
2. Select your AI provider
3. Use the help panel below the provider dropdown — it shows direct links to browse models and get an API key
4. Pick a recommended preset from the Model dropdown
5. Only choose Custom model ID… if the model is not in the preset list — copy the exact ID from the provider catalog

AI setup steps:

1. Activate your Translations Manager license (step 3 above)
2. Create an account with your chosen AI provider and generate an API key
3. Go to Configuration → AI Translation
4. Enable AI, select provider, pick preset model or Custom ID
5. Paste your API key → click Test AI connection
6. Open a catalog → use Translate with AI
7. Review all AI output before saving — especially RTL languages, branding and legal text
8. Click Save to write .po and .mo files

7. Backups and restore

• Automatic backup runs before each save (configurable in Configuration → Safety)
• Restore a previous snapshot from the catalog editor backup panel
• Import / export .po, .mo or ZIP from the editor tools

8. Plugin updates (licensed)

1. License must be active on this site
2. Go to Translations Manager → Updates
3. Click Check now
4. Verify, download and install (a backup is created first)
5. Rollback is available from automatic pre-update backups if needed

Updates are delivered via the vendor license server, not the Osclass official marketplace.

9. Troubleshooting

• Changes not visible on frontend → Did you Save? Clear cache. Check active site language.
• AI disabled / license required → Activate license on License tab.
• AI test fails → Check your own API key, model name, and server outbound HTTPS (cURL).
• Wrong model for provider → Pick a preset from the Model dropdown or use Custom with ID from provider catalog.
• Cannot save large catalog → Increase PHP max_input_vars to 5000+ (see Configuration → System diagnostics).
• Cannot install update → Enable PHP ZipArchive. Check folder write permissions.

10. Support

Contact the seller through your Codester purchase page. Include Osclass version, PHP version, plugin version (Configuration → System diagnostics), and steps to reproduce.

Do not share your full license key or AI API keys in public tickets.

Full guide included in the download: INSTALL.txt inside the plugin folder.