Reload der Customizer-Vorschau aus der Vorschau heraus anstoßen

Bei meinem Photographus-Theme musste ich aus der Customizer-Vorschau heraus in einem bestimmten Fall die Vorschau neu laden. Nach kurzer Suche bin ich über den Beitrag »Implementing Selective Refresh in the Customizer« von Weston Ruter gestolpert.

Das Problem lässt sich mit einer übersichtlichen Zeile JavaScript lösen:

wp.customize.preview.send('refresh');
Code-Sprache: JavaScript (javascript)

Eigenschaften einer bestehenden Customizer-Control ändern

Hier zeige ich euch kurz, wie ihr die Eigenschaften von bestehenden Customizer-Controls ändern könnt – hilfreich für einen kleinen Denkanstoß war dabei ein Gist von Marcio Duarte.

In meinem konkreten Fall wollte ich der vom Core erzeugten Header-Image-Control einen active_callback mitgeben, um sie nur anzuzeigen, wenn der Nutzer auf einer statischen Startseite ist. Um das zu erreichen, braucht es nur eine Zeile Code:

/** * Set active callback for the header image control. */ $wp_customize->get_control( 'header_image' )->active_callback = 'slug_is_static_front_page';
Code-Sprache: PHP (php)

Entsprechend lassen sich auch die anderen Eigenschaften anpassen – ein paar Beispiele gibt es im oben verlinkten Gist. Der Vollständigkeit halber hier noch die Callback-Funktion:

/** * Check if we are on a static front page. * * @param WP_Customize_Control $control Control object. * * @return bool */ function slug_is_static_front_page( $control ) { /** * Return true if is static front page. */ if ( is_front_page() && is_page() ) { return true; } else { return false; } }
Code-Sprache: PHP (php)

WordPress nachträglich von utf8 auf utf8mb4 umstellen

Beim Update auf WordPress 4.2 wurde der Zeichensatz der Datenbank von utf8 auf utf8mb4 umgestellt (zum Beispiel notwendig für die volle Unterstützung von Emojis), sofern ein paar Voraussetzungen erfüllt waren. Hier zeige ich, wie ihr diese Umstellung manuell vornehmen könnt, wenn ihr bei dem 4.2-Update die Anforderungen noch nicht erfüllt habt. "WordPress nachträglich von utf8 auf utf8mb4 umstellen" Weiterlesen

WordPress-Multisite mit einer Mischung aus Subdomains und Unterverzeichnissen

Bei einer Multisite entscheidet ihr euch ganz am Anfang dafür, ob ihr sie mit Subdomains oder Unterverzeichnissen betreiben möchtet – ein Mix aus beiden Varianten ist nicht ohne Anpassungen möglich. Hier stelle ich euch vor, wie ihr vorgehen müsst, um eine Multisite mit Subdomain- und Unterverzeichnis-Sites zu betreiben. "WordPress-Multisite mit einer Mischung aus Subdomains und Unterverzeichnissen" Weiterlesen

Admin-Notice bei verfügbarem Update von bestimmtem Plugin anzeigen

Für die durch das Plugin German Market erstellten Rechnungen meines Shops nutze ich einen Font den ich nach jedem Plugin-Update erneut integrieren muss, da er nicht standardmäßig in dem Plugin eingebunden ist. Damit ich das nicht (mehr) vergesse, lasse ich mir eine Admin-Notice anzeigen, sobald ein Update für das Plugin verfügbar ist. Das ist nicht besonders schwer und schnell umgesetzt, der komplette Code sieht so aus:

/** * Display admin notice so I remember uploading the Clavo font after updating German Market */ function fbn_german_market_typography_notice() { $update_plugins_transient = get_site_transient( 'update_plugins' ); if ( $update_plugins_transient->response['woocommerce-german-market/WooCommerce-German-Market.php'] ) { add_action( 'all_admin_notices', function () { ?> <div class="notice notice-warning"> <p><strong>Nach dem »German Market«-Update den Clavo-Font für Rechnungen wieder hochladen!</strong></p> </div> <?php } ); } } add_action( 'admin_init', 'fbn_german_market_typography_notice' );
Code-Sprache: PHP (php)

Ich übergebe an den admin_init-Hook die Funktion fbn_german_market_typography_notice(). Darin wird zunächst der Wert des Site-Transients update_plugins in einer Variable gespeichert – in diesem Transient sind Infos zu Plugin-Updates gespeichert. Wenn nun $update_plugins_transient->response['woocommerce-german-market/WooCommerce-German-Market.php'] vorhanden ist, dann ist ein Update für das Plugin verfügbar.

In diesem Fall wird eine Admin-Notice ausgegeben (ich nutze hier all_admin_notices, damit es in einer Multisite nicht nur im Netzwerk-Admin angezeigt wird) die mich hoffentlich zukünftig daran erinnert, den Font für die Rechnungs-PDF wieder hochzuladen … 🙂

Für andere Plugins ist der Array-Schlüssel natürlich ein anderer. Ihr könnt euch einfach per var_dump( $update_plugins_transient ); den Inhalt des Transients ausgeben lassen, um den richtigen Schlüssel zu finden.

PS: Mehr zu Admin-Notices gibt es im Beitrag »Admin Notices in Plugin UIs« von Caspar Hübinger.

Automatische Updates für WordPress-Themes, die nicht im Theme-Verzeichnis sind

Für Themes aus dem WordPress.org-Verzeichnis können Updates automatisch installiert werden, wenn eine neue Version verfügbar ist. Hier zeige ich euch, wie ihr dieses Verhalten für Themes umsetzen könnt, die sich nicht in dem Verzeichnis befinden.

"Automatische Updates für WordPress-Themes, die nicht im Theme-Verzeichnis sind" Weiterlesen

robots.txt für bestimmte Sites einer Multisite anpassen

Die robots.txt einer WordPress-Site wird normalerweise dynamisch generiert. Um die in einer normalen Einzelinstallation zu überschreiben, kann einfach eine statische robots.txt erstellt und auf den Server geladen werden – in einer Multisite würde diese Datei dann aber für alle Seiten gelten, was nicht unbedingt gewünscht ist. Dieser Artikel zeigt euch, wie ihr die robots.txt für einzelne Sites der Multiste anpassen könnt.

"robots.txt für bestimmte Sites einer Multisite anpassen" Weiterlesen

Unabhängig von Steuern immer denselben Endpreis in WooCommerce

Bei meinem kleinen Online-Shop muss ich im Endpreis für Käufer aus der EU den jeweils in ihrem Land gültigen Mehrwertsteuersatz ausweisen. Bei Käufern aus den USA beispielsweise wird aber keine Mehrwertsteuer ausgewiesen. Wenn ich nun in WooCommerce einen Preis von 15 Euro bestimme und einstelle, dass ich Preise inklusive Steuern angebe, dann ist das Standardverhalten wie folgt:

Kunden aus einem Land, für das ein Steuersatz hinterlegt wurde, zahlen 15 Euro inklusive ihres jeweilgen Mehrwertsteuersatzes. Kunden aus Ländern, für die kein Steuersatz hinterlegt wurde, zahlen weniger. Hier wird der Preis glaube ich um den Steuersatz des Shop-Basislands verringert (da bin ich mir aber nicht ganz sicher). Das gewünschte Verhalten ist aber, dass auch diese Kunden 15 Euro bezahlen, nur halt ohne Mehrwertsteuer.

Im WooCommerce-Wiki auf GitHub gibt es dazu eine ziemlich einfache Lösung. Ihr müsst lediglich folgende Zeile in euer Theme oder ein Plugin schreiben:

add_filter( 'woocommerce_adjust_non_base_location_prices', '__return_false' );
Code-Sprache: PHP (php)

ElasticPress: Nur Suchergebnisse anzeigen, die alle Begriffe der Suchanfrage enthalten

Wie im letzten Artikel geschrieben, habe ich seit Kurzem über das ElasticPress-Plugin den Suchserver Elasticsearch im Einsatz. Hier beschreibe ich, wie ihr die von ElasticPress generierte Such-Query so anpassen könnt, dass bei Suchanfragen mit mehreren Begriffen nur Treffer gezeigt werden, bei denen alle Begriffe vorkommen.

"ElasticPress: Nur Suchergebnisse anzeigen, die alle Begriffe der Suchanfrage enthalten" Weiterlesen