DokuWiki

Das ODT-Export-Plugin enthält seit Version 2014-10-12 ein Helper-Plugin welches verwendet werden kann um den Farbwert für einen angegebenen CSS-Farbnamen zu ermitteln. Dies ist vor allem beim ODT-Export erforderlich, da ODT keine CSS-Farbnamen versteht. Daher müssen CSS-Farbnamen in ihren zugehörigen Wert umgewandelt werden, bevor sie in einem ODT-Dokument verwendet werden können.

Dies ist ein Beispiel für die Abfrage des Wertes für einen bestimmten Farbnamen:

    $odt_colors = plugin_load('helper', 'odt_csscolors');
    if ($odt_colors != NULL) {
        $value = $odt_colors->getColorValue('red');
 
        // Jetzt ist $value auf '#FF0000' gesetzt und kann weiter verwendet werden...
    }

Bitte beachten Sie, das Groß und Kleinschreibung bei den Farbnamen irrelevant ist. Für lange Namen wie 'LightGoldenRodYellow' können Sie auch 'lightgoldenrodyellow' schreiben, das Ergebnis ist das gleiche. Wenn ein Farbname dem Helper-Plugin unbekannt ist, wird der Default-Wert '#000000' zurückgegeben.

Die Umwandlung wird auch in die andere Richtung unterstützt:

    $odt_colors = plugin_load('helper', 'odt_csscolors');
    if ($odt_colors != NULL) {
        $name = $odt_colors->getValueName('#FF0000');
 
        // Jetzt ist $name auf 'Red' gesetzt und kann weiter verwendet werden...
    }

Wenn ein Farbwert dem Helper-Plugin unbekannt ist, wird der Default-Wert 'Black' zurückgegeben.