Übersicht
Das Polylang Automatic AI Translation Plugin bietet integrierte Unterstützung für die Übersetzung von benutzerdefinierten Feldern aus beliebten Plugins wie ACF, Yoast SEO, Rank Math und anderen. Für benutzerdefinierte Felder, die mit Ihrem eigenen Code oder spezialisierten Plugins erstellt wurden, müssen Sie jedoch die Funktionalität des Plugins mit den bereitgestellten Filterhooks erweitern.
Warum benutzerdefinierte Felder manuelle Konfiguration benötigen
Das Plugin übersetzt standardmäßig nur explizit konfigurierte benutzerdefinierte Felder, um Folgendes zu verhindern:
- Übersetzung sensibler Daten (API-Schlüssel, Konfigurationswerte)
- Zerstörung der Funktionalität, die von bestimmten Feldwerten abhängt
- Unerwünschte Kosten durch Übersetzung von nicht-textuellem Inhalt
Verfügbare Filter-Hooks
Das Plugin bietet zwei Haupt-Filter-Hooks zur Erweiterung der Unterstützung für die Übersetzung benutzerdefinierter Felder:
1. Post-Meta-Felder-Hook
Hook-Name: pllat_available_post_meta_translation_fields
Zweck: Benutzerdefinierte Felder für Beiträge, Seiten und benutzerdefinierte Beitragstypen hinzufügen
Verwendung:
add_filter('pllat_available_post_meta_translation_fields', function($fields) {
$fields[] = 'your_custom_field_key';
$fields[] = 'another_custom_field';
$fields[] = 'description_field';
return $fields;
});
2. Term-Meta-Felder-Hook
Hook-Name: pllat_available_term_meta_translation_fields
Zweck: Benutzerdefinierte Felder für Kategorien, Tags und benutzerdefinierte Taxonomien hinzufügen
Verwendung:
add_filter('pllat_available_term_meta_translation_fields', function($fields) {
$fields[] = 'category_description';
$fields[] = 'term_subtitle';
$fields[] = 'custom_term_field';
return $fields;
});
Implementierungsmethoden
Methode 1: Theme-Funktionsdatei
Fügen Sie den Filtercode Ihrer aktiven Theme- functions.php Datei hinzu:
// Fügen Sie zu wp-content/themes/your-theme/functions.php hinzu
add_filter('pllat_available_post_meta_translation_fields', function($fields) {
// Fügen Sie Ihre benutzerdefinierten Post-Meta-Felder hinzu
$custom_fields = [
'product_description',
'location_address',
'company_bio',
'custom_excerpt'
];
return array_merge($fields, $custom_fields);
});
add_filter('pllat_available_term_meta_translation_fields', function($fields) {
// Fügen Sie Ihre benutzerdefinierten Term-Meta-Felder hinzu
$custom_term_fields = [
'category_subtitle',
'term_description_extended',
'location_details'
];
return array_merge($fields, $custom_term_fields);
});
Methode 2: Benutzerdefiniertes Plugin
Erstellen Sie ein kleines Plugin, um sicherzustellen, dass die Filter bei Themenwechseln bestehen bleiben:
<?php
/**
* Plugin-Name: Custom Fields Translation Extension
* Beschreibung: Erweitert Polylang AI Translation zur Unterstützung benutzerdefinierter Felder
* Version: 1.0
*/
// Direkten Zugriff verhindern
if (!defined('ABSPATH')) {
exit;
}
class CustomFieldsTranslationExtension {
public function __construct() {
add_filter('pllat_available_post_meta_translation_fields', [$this, 'add_post_meta_fields']);
add_filter('pllat_available_term_meta_translation_fields', [$this, 'add_term_meta_fields']);
}
public function add_post_meta_fields($fields) {
$custom_fields = [
'your_custom_field_1',
'your_custom_field_2',
'product_specifications',
'location_description'
];
return array_merge($fields, $custom_fields);
}
public function add_term_meta_fields($fields) {
$custom_term_fields = [
'category_banner_text',
'term_seo_description',
'location_details'
];
return array_merge($fields, $custom_term_fields);
}
}
new CustomFieldsTranslationExtension();
Identifikation Ihrer benutzerdefinierten Feldschlüssel
Um die korrekten Schlüsselnamen für Ihre benutzerdefinierten Felder zu finden:
Methode 1: Datenbanküberprüfung
-- Für Post-Meta-Felder
SELECT DISTINCT meta_key FROM wp_postmeta WHERE meta_key NOT LIKE '_%' ORDER BY meta_key;
-- Für Term-Meta-Felder
SELECT DISTINCT meta_key FROM wp_termmeta WHERE meta_key NOT LIKE '_%' ORDER BY meta_key;
Methode 2: WordPress Debug
Fügen Sie diesen temporären Code ein, um alle Metafelder für einen bestimmten Beitrag anzuzeigen:
// Temporärer Debug-Code - entfernen, nachdem Felder identifiziert wurden
$post_id = 123; // Ersetzen Sie durch Ihre Beitrag-ID
$meta = get_post_meta($post_id);
error_log(print_r($meta, true));
Methode 3: Quellcodeüberprüfung
Überprüfen Sie Ihre benutzerdefinierte Beitragstyp-Registrierung oder Meta-Box-Erstellungscode für Feldnamen:
// Suchen Sie nach Aufrufen wie:
add_meta_box('my_meta_box', 'Title', 'callback', 'post_type');
update_post_meta($post_id, 'field_name', $value);
get_post_meta($post_id, 'field_name', true);
Best Practices
Richtlinien zur Feldauswahl
- Einschließen: Textfelder, Beschreibungen, Titel, Inhalte für Besucher
- Ausschließen: IDs, URLs, Konfigurationswerte, serialisierte Daten, codierter Inhalt
Code-Organisation
add_filter('pllat_available_post_meta_translation_fields', function($fields) {
$custom_fields = [
// Produktfelder
'product_short_description',
'product_benefits',
// Standortfelder
'location_description',
'opening_hours_note',
// Eventfelder
'event_summary',
'speaker_bio'
];
return array_merge($fields, $custom_fields);
});
Testen Ihrer Implementierung
- Fügen Sie den Filtercode hinzu mit einer der oben genannten Methoden
- Leeren Sie alle Caches (wenn Sie Caching-Plugins verwenden)
- Gehen Sie zur Übersetzungsoberfläche in Ihrem WordPress-Adminbereich
- Überprüfen Sie, ob Ihre benutzerdefinierten Felder angezeigt werden in den Übersetzungsoptionen
- Testen Sie die Übersetzung eines Beitrags/Begriffs mit Ihren benutzerdefinierten Feldern
- Prüfen Sie die übersetzte Version um zu bestätigen, dass die Felder übersetzt wurden
Unterstützte Feldtypen
Das Plugin kann verschiedene benutzerdefinierte Feldtypen übersetzen:
- Textfelder
- Textarea-Felder
- Rich-Text/WYSIWYG-Inhalte
- Einfacher HTML-Inhalt
- Einfache Textbeschreibungen
Fehlerbehebung
Felder erscheinen nicht
- Überprüfen Sie, ob die Feldschlüssel korrekt sind
- Stellen Sie sicher, dass der Filter korrekt eingehängt ist
- Stellen Sie sicher, dass es keine PHP-Fehler in Ihrem Code gibt
- Leeren Sie alle Caches
Felder werden nicht übersetzt
- Bestätigen Sie, dass das Feld übersetzbare Textinhalte enthält
- Überprüfen Sie, ob der Feldwert nicht leer ist
- Stellen Sie sicher, dass Ihr OpenAI-API-Schlüssel funktioniert
- Überprüfen Sie die Übersetzungsprotokolle auf Fehler
Leistungsüberlegungen
- Fügen Sie nur Felder hinzu, die tatsächlich übersetzt werden müssen
- Vermeiden Sie das Hinzufügen von Feldern mit großen Datenmengen
- Betrachten Sie die Kostenimplikationen der Übersetzung vieler Felder