Osclass Translations Manager with AI Editor

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