=== AF Translate - In-Dashboard Translation Editor & POT Generator for WordPress ===
Contributors: afthemes
Tags: i18n, l10n, language, multilingual, translation
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.0.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Stop using FTP and Poedit just to fix a typo. Translate themes and plugins entirely inside your dashboard with zero frontend performance bloat.

== Description ==

Stop downloading language files over FTP just to fix a single broken string in Poedit. 

AF Translate eliminates the friction of traditional WordPress localization. Built for developers, translation managers, and agencies, it provides a safe, internal workspace to scan your codebase, compile translation templates, and edit strings natively inside your WordPress administration panels.

=== The Problems AF Translate Solves For You: ===

* **No More Desktop Bottlenecks:** Skip the endless loop of downloading source files, running external software, compiling binary `.mo` outputs, and re-uploading via FTP. Translate on-the-fly right inside your browser.
* **Immunity to Update Data Loss:** Standard translations stored inside theme or plugin folders get permanently wiped out during core repository updates. AF Translate safely isolates your custom translation work in a protected directory, keeping your assets intact forever.
* **Absolute Performance Protection:** Most translation and multilingual utilities heavily overload your database and front-end scripts, devastating your Core Web Vitals. AF Translate operates exclusively inside the admin dashboard (`is_admin()`), loading exactly **zero** scripts, styles, or queries on your public-facing site.
* **Bulletproof Codebase Scanning:** Powered by an intelligent lexical syntax tokenizer engine, the built-in scanner handles everything from traditional assets to modern block structures (like Twenty Twenty-Five) flawlessly, completely bypassing server-level regex tracking limits.

== Installation ==

1. Upload the `af-translate` folder directly to your `/wp-content/plugins/` directory, or install it via the WordPress admin dashboard.
2. Activate the plugin through the **Plugins** panel.
3. Access your clean, unified translation center by clicking the new **AF Translate** menu entry in your sidebar.

== Configuration & Usage Guide ==

Manage your localization assets in minutes:

1. **Target Your Project:** Open the AF Translate dashboard matrix and choose the active theme or plugin you need to modify.
2. **Instant Codebase Crawl:** Run the scanner to instantly map out all translatable text blocks embedded inside your target extension's source directories.
3. **Establish Your Baseline:** If the extension lacks a core fallback mapping file, click **Generate POT** to instantly compile a fresh, clean translation standard template.
4. **Translate Side-by-Side:** Add a native language locale tracker or initialize a custom one. Use the responsive edit matrix to fill out localized rows with clear contextual file lookups.
5. **Secure the Build:** Save your translations. The system automatically updates the `.po` source datasets and compiles clean, production-ready binary `.mo` assets instantly on your disk.

== Frequently Asked Questions ==

= Does this plugin affect frontend loading speeds or Core Web Vitals? =
Absolutely not. Performance protection is built into the foundation of this engine. AF Translate runs strictly behind the scenes in the administrative backend. It introduces zero overhead, scripts, or rendering blocks to your public visitor experience, leaving your site speeds completely untouched.

= Where are the translation PO and MO files stored? =
To protect your hard work from being overwritten, all user-generated translation sets are automatically organized and written to a secure folder within your site’s uploads directory: `wp-content/uploads/af-translate/`. This guarantees your localization assets remain completely unaffected when you update themes or plugins.

= Can I use this plugin to translate an item that does not include a .pot file? =
Yes, this is exactly what it's designed for. The integrated tokenizer parses the extension's raw source file files, identifies core internationalization function wrappers (`__()`, `_e()`, etc.), and builds a fully compatible `.pot` file from scratch with a single click.

= What administrative permissions are required to use this plugin? =
To enforce strict directory protection, prevent unauthorized file injections, and secure core data paths, execution access is limited exclusively to user roles carrying the system-wide `manage_options` capability.

== Screenshots ==

1. **Project Dashboard Matrix:** Overview of active themes, plugins, localized translation sets, progress metrics, and string lists.
2. **All Plugins Lists:** Quick tracking view of your active plugin installations alongside active locale progress percentages.
3. **All Themes Lists:** Unified view showing active theme frameworks, child theme layers, and localized translation tracking logs.
4. **Project Translation Overview:** Granular breakdown of a single target project showing total string volumes, modified milestones, and file paths.
5. **Translation Workspace View:** The interactive editor workspace mapping source text variables alongside user input text fields for rapid editing.
6. **New Language Initializer Panel:** Form interface to map native system locales or declare custom translation language identifiers safely.
7. **Import Language Panel:** Clean interface to upload existing language files directly into your isolated safe space.

== Changelog ==

= 1.0.0 =
* Initial Public Release.
* Integrated memory-safe source code string parsing token architecture.
* Integrated sidebar editor panel with dynamic translation lookup references.
* Implemented path protection mapping strictly inside the WP uploads directory layout for permanent asset retention.
* Hardened internal file system interactions with strict input validation to prevent directory traversal threats.

== Upgrade Notice ==

= 1.0.0 =
Initial distribution release. Install to begin managing your theme and plugin translation assets directly in your administration panels without external tool dependencies.