CUSTOMER BASKET MANAGER V1.0 — TRANSLATOR GUIDE
Author: Mort-Lemur
Licence: GNU GPL version 2 or later

The add-on has one dedicated shared language file covering admin, the Tools
menu, customer basket pages, buttons, placeholders and validation messages.

English source in the package:
  catalog/includes/languages/english/customer_basket_manager.php

Installed English source:
  includes/languages/english/customer_basket_manager.php

To add another language:
1. Copy the English file to the corresponding Phoenix language directory.
   Example for a language whose Phoenix directory is german:
     includes/languages/german/customer_basket_manager.php
2. Keep the filename, opening PHP tag, author/licence header, array keys and
   PHP structure. Translate only the text on the right of each =>.
3. Save as UTF-8 without a BOM. Keep the file without a closing PHP tag.
4. Select that language in Phoenix. The add-on follows the current session's
   language for both admin and shop pages.

The file returns a PHP array, for example:
  'SEARCH' => 'Suchen',
  'QUANTITY' => 'Menge',

Use plain text, not HTML. The add-on escapes translated text when displayed,
including JavaScript copy-button messages. Escape a literal single quote as
\' within a single-quoted PHP value, and a literal backslash as \\.

Keep sprintf placeholders such as %s. For sentences containing several
placeholders, numbered placeholders such as %1$s and %2$s allow reordering.
Use %% for a literal percent sign in a message which also has placeholders.

DATE_TIME_FORMAT uses PHP date() format characters. English defaults to
'd/m/Y H:i' for UK dates. It can be changed in the translated file.

English is always loaded first, with the selected language overriding it.
If the translated file or an individual key is missing, English is used.
Translations are loaded once per request; refresh after editing the file.

Existing custom basket titles, entered product-option text, and old recorded
error messages are saved data and are not rewritten by a language change.
New add-on failures store their language key and formatting arguments so the
admin can read them in the currently selected language.

You do not need to translate SQL, database status values, filenames, PHP
identifiers or any other add-on code. No core language files are modified.
