WooCommerce (Woo) email šablony (předlohy) jsou součástí pluginu pro elektronické obchodování. Je určen pro malé online obchodníky používající WordPress. Zásuvný modul byl uveden 27. září 2011 a rychle si získal oblibu pro svou jednoduchost instalace a přizpůsobení a pro postavení základního produktu na trhu jako freeware (i když mnoho jeho volitelných rozšíření je placených a proprietárních).
Woo byl poprvé vyvinut vývojářem témat WordPress WooThemes, který najal Mikea Jolleyho a Jamese Kostera, vývojáře ze společnosti Jigowatt, aby pracovali na odnoži Jigoshopu, z níž se stal Woo. V lednu 2020 se odhadovalo, že jej používá přibližně 3,9 milionu webových stránek. V listopadu 2014 se v kalifornském San Franciscu konala první konference WooConf, zaměřená na elektronické obchodování pomocí Woo. Zúčastnilo se jí 300 účastníků.
V květnu 2015 společnosti WooThemes a Woo koupila společnost Automattic, provozovatel webu WordPress.com a hlavní přispěvatel do softwaru WordPress. V prosinci 2020 společnost Woo získala MailPoet, populární plugin pro správu newsletterů ve WordPressu.
Obsah
WooCommerce email šablony
Po instalaci CMS Wordpress a instalaci rozšíření eshopu Woo vás v případě, že chcete mít vše pintlich čeká personalizace mailových předloh. Těch Woo obsahuje jedenáct.
Nová objednávka /admin-new-order.php
Stornovaná objednávka /admin-cancelled-order.php
Objednávka selhala /admin-failed-order.php
Objednávka čeká na vyřízení /customer-on-hold-order.php
Zpracovávání objednávky /customer-processing-order.php
Vyřízená objednávka /customer-completed-order.php
Vrácená objednávka /customer-refunded-order.php
Zákaznický doklad / Detaily objednávky /customer-invoice.php
Poznámky zákazníka /customer-note.php
Obnovit heslo /customer-reset-password.php
Nový účet /customer-new-account.php
Z informací na webu či jmen předloh v eshopu Woo se lze domnívat, že e
mailové předlohy jsou v češtině. Pravdou je, že Wordpress i Woo jsou na 99% lokalizovány do češtiny – i když těch cca 7000 řádků překladu (viz soubor woocommerce-cs_CZ.po v třeba Poedit programu) obsahuje řadu chyb, e-mail předloha nikoliv. Pokud používáte českou lokalizaci Wordpress + Woo, předlohy jsou sice překládány ze slovní zásoby obsažené v zmiňované lokalizaci woocommerce-cs_CZ.po. Takto překládáný text působí v mailech jako strojový překlad nigerijského studenta na hoaxové brigádě :) což zjistíte záhy, obvykle po první testovací objednávce.
V nastavení (menu) WooCommerce / Nastavení / E-maily / vedle jména šablony / Spravovat šablonu to, že čeština v mailových šablonách není nezjistíte i proto, že hlášky eshopu jsou umístěny samozřejmě přímo v php kódu.
Překládáme či měníme Woo předlohy
Po rozkliknutí WooCommerce / Nastavení / E-maily / vedle jména šablony / Spravovat šablonu se zobrazí následující text:
HTML šablona Pro přepsání a úpravu této e-mailové šablony zkopírujte woocommerce/templates/emails/admin-new-order.php do složky s vaší šablonou: jméno_šablony/woocommerce/emails/admin-new-order.php Zobrazit šablonu Zkopírovat soubor do šablony
Než dle poučení zkopírujete šablony ze zložky /woocommerce/templates/emails/ do složky vzhledu který používáte, po rozkliknutí (zobrazení) šablony v menu WooCommerce / Nastavení / E-maily / vedle jména šablony / Zobrazit šablonu uvidíte pouze obsah šablony, bez možností tuto editovat.
Obsah (první zmiňované) šablony admin-new-order.php je
<?php
/**
* Admin new order mail
*
* This template can be overridden by copying it to yourtheme/woocommerce/emails/admin-new-order.php.
*
* HOWEVER, on occasion Woo will need to update template files and you
* (the theme developer) will need to copy the new files to your theme to
* maintain compatibility. We try to do this as little as possible, but it does
* happen. When this occurs the version of the template file will be bumped and
* the readme will list any important changes.
*
* @see https://docs.woocommerce.com/document/template-structure/
* @package WooCommerce\Templates\Mails\HTML
* @version 3.7.0
*/
defined( 'ABSPATH' ) || exit;
/*
* @hooked WC_Mails::mail_header() Output the email header
*/
do_action( 'woocommerce_email_header', $email_heading, $email ); ?>
<?php /* translators: %s: Customer billing full name */ ?>
<p><?php printf( esc_html__( 'You’ve received the following order from %s:', 'woocommerce' ), $order->get_formatted_billing_full_name() ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?></p>
<?php
/*
* @hooked WC_Mails::order_details() Shows the order details table.
* @hooked WC_Structured_Data::generate_order_data() Generates structured data.
* @hooked WC_Structured_Data::output_structured_data() Outputs structured data.
* @since 2.5.0
*/
do_action( 'woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email );
/*
* @hooked WC_Mails::order_meta() Shows order meta data.
*/
do_action( 'woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email );
/*
* @hooked WC_Mails::customer_details() Shows customer details
* @hooked WC_Mails::email_address() Shows mail address
*/
do_action( 'woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email );
/**
* Show user-defined additional content - this is set in each email's settings.
*/
if ( $additional_content ) {
echo wp_kses_post( wpautop( wptexturize( $additional_content ) ) );
}
/*
* @hooked WC_Mails::mail_footer() Output the email footer
*/
do_action( 'woocommerce_email_footer', $email );
kde jediný text k překladu je v kódu boldem vyznačený You’ve received the following order from. Po přesunutí / kopirování složky emails včetně nadřazěné složky woocomerce do složky jméno_šablony_kterou_používáte (kupříkladu astra) kde bude ve FTP klientovi vypadat cesta takto
/web_root/wp-content/themes/astra/woocommerce/emails/admin-new-order.php
Načež následně v menu
WooCommerce / Nastavení / Emaily / Jméno šablony / Spravovat
u dalšího načtení stránky (nebo refresh již otevřeného okna) s obsahem předlohy stane aktivním – tedy akceptujícím vkládání textu (i jeho uložení)
Niní bude možné (stejně jako ve Wordpress menu Vzhled / Editor) upravit text mailových předloh přímo v rozhraní vašeho redakčního systému. Tyto úpravy lze následně zapisovat / ukládat tlačítkem Uložit změny – vlevo dolu pod oknem. To znamená předlohu lze lokalizovat do češtiny bez nutnosti používat FTP klient (WinSCP, Filezilla..) :o)
Užitečné
Domovská stránka Woo.
Lokalizace šablony do češtiny.