use FriendsOfRedaxo\MetaInfoLangFields\MetainfoLangHelper;

// 📄 ARTIKEL-WERTE
$articleTitle = MetainfoLangHelper::getArticleValue($article, 'art_title_lang');
$englishTitle = MetainfoLangHelper::getArticleValue(123, 'art_title_lang', 2); // Artikel-ID + Englisch
$strictTitle = MetainfoLangHelper::getArticleValue($article, 'art_title_lang', null, false); // Ohne Fallback

// 🖼️ MEDIUM-WERTE  
$mediaTitle = MetainfoLangHelper::getMediaValue($media, 'med_title_lang');
$mediaDesc = MetainfoLangHelper::getMediaValue('image.jpg', 'med_description_lang', 2); // Dateiname + Englisch

// 📁 KATEGORIE-WERTE
$categoryTitle = MetainfoLangHelper::getCategoryValue($category, 'cat_title_lang');
$categoryDesc = MetainfoLangHelper::getCategoryValue(456, 'cat_description_lang', 3); // Kategorie-ID + Französisch

// Helper-Klasse verwenden (FriendsOfRedaxo\MetaInfoLangFields Namespace)
use FriendsOfRedaxo\MetaInfoLangFields\MetainfoLangHelper;

// Wert für aktuelle Sprache (Low-Level)
$value = MetainfoLangHelper::getValueForLanguage(
    $article->getValue('art_title_lang'), 
    rex_clang::getCurrentId()
);

// Prüfen ob Übersetzung existiert
if (MetainfoLangHelper::hasTranslationForLanguage($article->getValue('art_title_lang'), 2)) {
    echo 'Englische Übersetzung vorhanden';
}

// Alle Übersetzungen abrufen
$allTranslations = MetainfoLangHelper::normalizeLanguageData($article->getValue('art_title_lang'));
foreach ($allTranslations as $translation) {
    $langName = rex_clang::get($translation['clang_id'])->getName();
    echo $langName . ': ' . $translation['value'] . '<br>';
}

use FriendsOfRedaxo\MetaInfoLangFields\MetainfoLangHelper;

// Artikel-Titel mit automatischem Fallback
$title = MetainfoLangHelper::getArticleValue($this, 'art_title_lang');
if (empty($title)) {
    $title = $this->getName(); // Standard REDAXO-Titel als Fallback
}

// Medienpool-Integration
$media = rex_media::get('hero-image.jpg');
$altText = MetainfoLangHelper::getMediaValue($media, 'med_alt_lang');
$caption = MetainfoLangHelper::getMediaValue($media, 'med_caption_lang');

echo '<img src="' . $media->getUrl() . '" alt="' . rex_escape($altText) . '">';
echo '<figcaption>' . rex_escape($caption) . '</figcaption>';

use FriendsOfRedaxo\MetaInfoLangFields\MetainfoLangHelper;

// Mehrsprachige Navigation
$navigation = rex_navigation::factory();
$navItems = $navigation->get(1, 2); // Kategorie 1, Tiefe 2

foreach ($navItems as $item) {
    $categoryTitle = MetainfoLangHelper::getCategoryValue($item['id'], 'cat_nav_title_lang');
    
    // Fallback auf Standard-Namen wenn kein mehrsprachiger Titel
    if (empty($categoryTitle)) {
        $categoryTitle = $item['name'];
    }
    
    echo '<a href="' . $item['url'] . '">' . rex_escape($categoryTitle) . '</a>';
}

use FriendsOfRedaxo\MetaInfoLangFields\MetainfoLangHelper;

// Nur Deutsche Inhalte anzeigen (kein Fallback)
$germanContent = MetainfoLangHelper::getArticleValue($article, 'art_content_lang', 1, false);

if (!empty($germanContent)) {
    echo '<div class="german-only">' . $germanContent . '</div>';
} else {
    echo '<div class="no-translation">Noch nicht übersetzt</div>';
}