Preisformat im WordPress-Währungsumschalter: Währungscode, Symbol, Trennzeichen
Das Preisformat des WordPress-Währungsumschalters wird an mehreren Stellen festgelegt: Symbol, dessen Position, Cent, Dezimalstellen und Trennzeichen wählen Sie pro Währung, während das benutzerdefinierte Preisformat mit dem Währungscode für alle Währungen gilt. Wenn Sie wissen, welche Einstellung welchen Teil des Preises erzeugt, erhalten Sie $751.45 (CAD), 1.250,00 € oder einen Preis ohne Symbol, ohne zu raten. Den Betrag selbst zu ändern (Runden auf 10 oder auf .99), ist eine andere Aufgabe, die unter umgerechnete Preise runden behandelt wird.
Wie WPCS einen Preis aufbaut
Jeder Shortcode [wpcs_price] wird in vier Schritten ausgegeben:
- Die umgerechnete Zahl wird mit den Einstellungen für Cent, Dezimalstellen (Decimals) und Format der aktuellen Währung formatiert:
751.45. - Das Währungssymbol wird links oder rechts von der Zahl platziert, wie unter Symbolposition (Symbol pos.) festgelegt:
$751.45. - Die Option Benutzerdefiniertes Preisformat (Custom price format) umschließt das Ergebnis, sofern sie ausgefüllt ist, und kann den Währungscode hinzufügen:
$751.45 (CAD). - Alles wird in HTML mit zwei CSS-Klassen eingebettet, und der Filter
wpcs_price_html_tailkann vor dem schließenden Tag weiteres hinzufügen.
<span class="wpcs_price" id="wpcs_..." data-amount="544.53"><span class="wpcs_price_symbol">$</span>751.45 (CAD)</span>
Die Einstellungen befinden sich an zwei Stellen unter Einstellungen (Settings) → Currency Switcher:
| Einstellung | Wo | Gilt für |
|---|---|---|
| Symbol, Symbolposition (Symbol pos.) | Währungszeile, Tab Währungen (Currencies) | Diese Währung |
| Cent anzeigen (Show cents) / Cent ausblenden (Hide cents), Dezimalstellen (Decimals) | Währungszeile | Diese Währung |
| Format (Trennzeichen) | Währungszeile | Diese Währung |
| Dezimaltrennzeichen (Decimal separator), Tausendertrennzeichen (Thousandth separator) | Tab Optionen (Options) | Währungen, deren Format auf default steht |
| Eigene Währungssymbole (Custom money signs.) | Tab Optionen (Options) | Fügt der Symbolliste Symbole hinzu |
| Benutzerdefiniertes Preisformat (Custom price format) | Tab Optionen (Options) | Jeder Preis in jeder Währung |
Symbol und Symbolposition pro Währung
Das Symbol ist ein Dropdown in jeder Währungszeile. Fehlt Ihr Zeichen in der Liste (KSh, S/, GH₵), tragen Sie es auf dem Tab Optionen (Options) unter Eigene Währungssymbole (Custom money signs.) durch Kommas getrennt ein und klicken auf Optionen speichern (Save options); es erscheint dann in der Symbolliste jeder Zeile. Entwickler können die Liste mit dem Filter wpcs_currency_symbols erweitern.
Das danebenliegende Auswahlfeld für die Position hat vier Werte:
- left:
$99.00 - right:
99.00$ - left space:
$ 99.00 - right space:
99.00 €
Das Leerzeichen ist ein geschütztes Leerzeichen, sodass das Symbol nie ohne seine Zahl in die nächste Zeile umbricht.
Den Währungscode nach dem Preis anzeigen
Die Option Benutzerdefiniertes Preisformat (Custom price format) auf dem Tab Optionen (Options) akzeptiert zwei Schlüssel: __PRICE__ ist die Zahl samt ihrem Symbol (bereits positioniert), __CODE__ ist der Code der angezeigten Währung. Lassen Sie das Feld leer, um das Standardformat zu verwenden.
| Benutzerdefiniertes Preisformat | Ergebnis |
|---|---|
__PRICE__ (__CODE__) | $751.45 (CAD) |
__CODE__ __PRICE__ | CAD $751.45 |
__PRICE__ __CODE__, Symbol per CSS ausgeblendet | 751.45 CAD |
Das ist das richtige Werkzeug, wenn sich mehrere Währungen ein Symbol teilen, etwa USD, CAD und AUD. Es gilt für jeden Preis der Website, auch für feste Preise, und lässt sich in den Einstellungen nicht auf einzelne Seiten beschränken. Um den Code nur bei einigen Preisen hinzuzufügen, verwenden Sie das Shortcode-Attribut aus dem Abschnitt über Text nach dem Preis.
Dezimal- und Tausendertrennzeichen pro Währung
Jede Währungszeile hat ein Auswahlfeld Format: default, 1,000.00, 1.000,00, 1 000,00, 1 000.00, 1000,00 und 1000.00. So kann auf derselben Website USD als 1,250.00, EUR als 1.250,00 und CHF als 1 250.00 angezeigt werden. Eine Währung mit default verwendet das globale Dezimaltrennzeichen (Decimal separator) und Tausendertrennzeichen (Thousandth separator) vom Tab Optionen (Options) (Punkt und Komma, sofern Sie sie nicht ändern). Ältere Forenantworten besagen, dass sich Trennzeichen nur für alle Währungen gleichzeitig festlegen lassen; das Auswahlfeld Format pro Währung hat diese Einschränkung abgelöst.
Auch die Anzahl der Dezimalstellen wird pro Währung festgelegt:
- Dezimalstellen: 0 (Decimals: 0) bis Dezimalstellen: 8 (Decimals: 8) legt die Anzahl der Dezimalstellen fest, zum Beispiel 3 für Preise wie 0.084. Das funktioniert nur, solange die Zeile auf Cent anzeigen (Show cents) steht.
- Cent ausblenden (Hide cents) gibt ganze Zahlen aus, unabhängig von Dezimalstellen (Decimals).
- JPY und TWD werden immer ohne Cent ausgegeben.
Diese Einstellungen ändern nur die Darstellung. Der value, den Sie in [wpcs_price value=1250.50] schreiben, verwendet immer einen Punkt für Dezimalstellen und kein Tausendertrennzeichen, unabhängig vom Format der Währungen.
Ein Preis ohne Symbol oder nur das Symbol
[wpcs_price] hat kein Attribut, um das Symbol wegzulassen, aber das Symbol steckt in einem eigenen Element, sodass CSS es ausblenden kann. Für jeden Preis oder nur innerhalb eines Blocks Ihrer Seite:
/* Appearance → Customize → Additional CSS */
.wpcs_price_symbol { display: none; }
/* or only inside an element with the class pricing-table */
.pricing-table .wpcs_price_symbol { display: none; }
Stellen Sie die Symbolposition für diese Währungen auf left oder right, sonst bleibt das geschützte Leerzeichen vor der Zahl stehen.
Wenn Sie die bloße Zahl oder das bloße Symbol als Text benötigen, etwa für ein Formularfeld, ein Data-Attribut oder ein Skript, registrieren Sie zwei kleine Shortcodes. Sie verwenden $WPCS->price(), das den Betrag umrechnet und formatiert (Ihr Rundungsfilter eingeschlossen), und $WPCS->get_currencies() für das Symbol:
/*
* [my_price_number value=100] prints the converted number, e.g. 86.00
* [my_currency_symbol] prints the symbol of the current currency
* Child theme functions.php or a code snippets plugin.
*/
add_shortcode('my_price_number', function ($atts) {
global $WPCS;
$atts = shortcode_atts(array('value' => 0), $atts);
if (empty($WPCS)) {
return '';
}
return esc_html($WPCS->price(floatval($atts['value'])));
});
add_shortcode('my_currency_symbol', function () {
global $WPCS;
if (empty($WPCS)) {
return '';
}
$currencies = $WPCS->get_currencies();
$code = $WPCS->current_currency;
return isset($currencies[$code]) ? wp_kses_post($currencies[$code]['symbol']) : '';
});
Beide werden beim Aufbau der Seite ausgegeben. Steht Ich verwende ein Cache-Plugin auf meiner Website (I am using cache plugin on my site) auf Ja (Yes), zeichnet das Plugin nach dem Laden nur die Elemente .wpcs_price neu, sodass diese beiden auf einer zwischengespeicherten Seite die Währung der zwischengespeicherten Kopie behalten.
Text nach dem Preis hinzufügen
Nach jedem Preis in einer Währung
Der Filter wpcs_price_html_tail fügt HTML innerhalb des Preiselements hinzu. Er läuft für jeden Preis, prüfen Sie daher die Währung:
/*
* WPCS: add a note after every price shown in USD.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('wpcs_price_html_tail', function ($price_html) {
global $WPCS;
if (!empty($WPCS) && $WPCS->current_currency === 'USD') {
$price_html .= ' <span class="my-price-note">excl. VAT</span>';
}
return $price_html;
});
Weil der Text Teil des Preiselements ist, wird er auch auf zwischengespeicherten Seiten korrekt neu gezeichnet.
Nur nach ausgewählten Preisen
WPCS übergibt jedes Attribut von [wpcs_price], auch solche, die es selbst nicht verwendet, zusammen mit der angezeigten Währung an den Filter wpcs_shortcode_price_html_manipulation. Dadurch sind eigene Attribute möglich:
[wpcs_price value=544.53 after=" ({code})"] → $751.45 (CAD)
[wpcs_price value=1.99 after="/yr" after_for="USD"] → $1.99/yr, only in USD
/*
* WPCS: [wpcs_price ... after="text"] adds text after this price only.
* {code} is replaced by the currency code; after_for="USD,CAD" limits it to these currencies.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('wpcs_shortcode_price_html_manipulation', function ($price_html, $atts, $currency) {
if (!is_array($atts) || !isset($atts['after']) || $atts['after'] === '') {
return $price_html;
}
if (!empty($atts['after_for'])) {
$codes = array_map('trim', explode(',', strtoupper($atts['after_for'])));
if (!in_array($currency, $codes, true)) {
return $price_html;
}
}
$text = str_replace('{code}', $currency, $atts['after']);
return $price_html . '<span class="my-price-after">' . esc_html($text) . '</span>';
}, 10, 3);
Der Text wird nach dem Preiselement platziert, und das AJAX-Neuzeichnen für zwischengespeicherte Websites führt diesen Filter nicht aus: Auf einer zwischengespeicherten Seite bleibt er so, wie er beim Zwischenspeichern der Seite war. Für ganze Sätze oder Blöcke, die von der Währung abhängen, siehe Inhalte für die gewählte Währung anzeigen.
Den Preis mit CSS gestalten
Verwenden Sie .wpcs_price für den gesamten Preis und .wpcs_price_symbol für das Symbol; die FAQ zeigt, wie Sie den Preis fett darstellen. Die Dezimalstellen haben kein eigenes Element. Um sie zu gestalten, etwa kleiner und hochgestellt, umschließen Sie sie mit dem Tail-Filter:
/*
* WPCS: wrap the decimal part of every price in <span class="my-price-decimals">.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('wpcs_price_html_tail', function ($price_html) {
global $WPCS;
if (empty($WPCS)) {
return $price_html;
}
$sep = $WPCS->get_decimal_separator($WPCS->current_currency);
if ($sep === '') {
return $price_html;
}
// The separator and the digits after it, outside HTML attributes.
return preg_replace(
'/(\d)' . preg_quote($sep, '/') . '(\d+)(?![^<]*>)/',
'$1<span class="my-price-decimals">' . $sep . '$2</span>',
$price_html,
1
);
});
/* Additional CSS */
.my-price-decimals { font-size: 0.6em; vertical-align: super; }
Preise ohne Cent bleiben unverändert. Um einen Betrag in mehreren Währungen nebeneinander anzuzeigen, verwenden Sie das Attribut fix_currency, beschrieben unter Preise in mehreren Währungen anzeigen.
Wenn sich das Format nicht ändert
- Klicken Sie nach dem Bearbeiten einer Währungszeile auf Optionen speichern (Save options); die Einstellungen der Zeile werden mit der Seite gespeichert, nicht sofort.
- Eine Währung mit Format: default folgt den globalen Trennzeichen auf dem Tab Optionen (Options), sodass eine Änderung der globalen nur diese Währungen betrifft.
- Dezimalstellen (Decimals) hat keine Wirkung, solange die Zeile auf Cent ausblenden (Hide cents) steht, und für JPY und TWD gar keine.
- Leeren Sie den Seiten-Cache und prüfen Sie in einem privaten Fenster: Zwischengespeicherte Seiten behalten das alte Format.
Sieht ein Preis weiterhin falsch aus, posten Sie den Shortcode und einen Screenshot der Währungszeile im WPCS-Support-Forum.