Erweiterung der Übersetzung von benutzerdefinierten Feldern für das Polylang AI Automatic Translation Addon

Robbert Vermeulen

Robbert Vermeulen

· 7 Min. Lesezeit

Ü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

  1. Fügen Sie den Filtercode hinzu mit einer der oben genannten Methoden
  2. Leeren Sie alle Caches (wenn Sie Caching-Plugins verwenden)
  3. Gehen Sie zur Übersetzungsoberfläche in Ihrem WordPress-Adminbereich
  4. Überprüfen Sie, ob Ihre benutzerdefinierten Felder angezeigt werden in den Übersetzungsoptionen
  5. Testen Sie die Übersetzung eines Beitrags/Begriffs mit Ihren benutzerdefinierten Feldern
  6. 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

Robbert Vermeulen

Robbert Vermeulen

Founder of EPIC WP Solutions

Alle Beiträge ansehen →