{"id":376222,"date":"2026-11-19T22:35:21","date_gmt":"2026-11-19T22:35:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/topsms-sms-for-woocommerce\/"},"modified":"2026-11-19T23:00:44","modified_gmt":"2026-11-19T23:00:44","slug":"topsms-cz-order-sms-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/topsms-cz-order-sms-for-woocommerce\/","author":23574470,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.4","stable_tag":"1.0.4","tested":"7.1.5","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"TopSMS.cz Order SMS for WooCommerce","header_author":"TopSMS.cz","header_description":"Sends SMS notifications to customers when a WooCommerce order changes status and optionally alerts the shop owner about new orders. Uses the TopSMS.cz SMS gateway (Czech B2B SMS API).","last_updated":"2026-11-19 23:00:44","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.topsms.cz\/api-integrace\/woocommerce","header_author_uri":"https:\/\/www.topsms.cz","rating":0,"author_block_rating":0,"active_installs":0,"downloads":44,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.3":{"tag":"1.0.3","author":"topsmscz","date":"2026-11-19 22:36:45","revision":3812634},"1.0.4":{"tag":"1.0.4","author":"topsmscz","date":"2026-11-19 23:00:44","revision":3812647}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3812631,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3812631,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3812634,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3812634,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.3","1.0.4"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[38803,711,7711,1201,286],"plugin_category":[41,45],"plugin_contributors":[294044],"plugin_business_model":[],"class_list":["post-376222","plugin","type-plugin","status-publish","hentry","plugin_tags-order-notifications","plugin_tags-sms","plugin_tags-sms-gateway","plugin_tags-sms-notifications","plugin_tags-woocommerce","plugin_category-communication","plugin_category-ecommerce","plugin_contributors-topsmscz","plugin_committers-topsmscz"],"banners":{"banner":"https:\/\/ps.w.org\/topsms-cz-order-sms-for-woocommerce\/assets\/banner-772x250.png?rev=3812634","banner_2x":"https:\/\/ps.w.org\/topsms-cz-order-sms-for-woocommerce\/assets\/banner-1544x500.png?rev=3812634","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/topsms-cz-order-sms-for-woocommerce\/assets\/icon-128x128.png?rev=3812631","icon_2x":"https:\/\/ps.w.org\/topsms-cz-order-sms-for-woocommerce\/assets\/icon-256x256.png?rev=3812631","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>TopSMS.cz Order SMS for WooCommerce connects your shop to the TopSMS SMS gateway, a B2B SMS service operated from the Czech Republic with delivery to all Czech and Slovak mobile networks, Germany, Austria and the rest of the EU, and international destinations.<\/p>\n\n<p>It works with accounts from both TopSMS websites: <a href=\"https:\/\/www.topsms.cz\">TopSMS.cz<\/a> for Czechia and Slovakia (prices in CZK) and <a href=\"https:\/\/topsms.eu\">TopSMS.eu<\/a> for Germany, Austria and the EU (prices in EUR). Use the API key from whichever site you registered on.<\/p>\n\n<p><strong>What it does<\/strong><\/p>\n\n<ul>\n<li>Sends an SMS to the customer's billing phone number when the order changes to a status you enable (processing, completed, on hold, cancelled, refunded, failed, pending, or any custom status).<\/li>\n<li>Optionally sends an SMS to the shop owner about every new order placed at checkout.<\/li>\n<li>Message templates per status with placeholders: <code>{order_number}<\/code>, <code>{first_name}<\/code>, <code>{last_name}<\/code>, <code>{total}<\/code>, <code>{status}<\/code>, <code>{payment_method}<\/code>, <code>{shipping_method}<\/code>, <code>{order_date}<\/code>, <code>{shop_name}<\/code>, <code>{site_url}<\/code>.<\/li>\n<li>Custom Sender ID (the name the customer sees as the sender), once approved for your TopSMS account.<\/li>\n<li>Phone numbers are normalised to international format using the billing country, so numbers such as <code>608 123 456<\/code> or <code>0905 123 456<\/code> are handled.<\/li>\n<li>Sending runs in the background through Action Scheduler, so the checkout never waits for the gateway.<\/li>\n<li>Every attempt is written to the order notes and to a log screen (WooCommerce &gt; SMS log). The log is pruned after a configurable number of days.<\/li>\n<li>Connection check and test SMS button in the settings.<\/li>\n<li>Compatible with High-Performance Order Storage (HPOS) and both the classic and the block checkout.<\/li>\n<\/ul>\n\n<p><strong>Requirements<\/strong><\/p>\n\n<ul>\n<li>WooCommerce 8.0 or newer.<\/li>\n<li>A TopSMS account from topsms.cz or topsms.eu and an API key (created in the TopSMS dashboard, section API). Registration is free; messages are charged to the prepaid credit of your account according to the price list (<a href=\"https:\/\/www.topsms.cz\/cenik\">topsms.cz<\/a> in CZK, <a href=\"https:\/\/topsms.eu\/pricing\">topsms.eu<\/a> in EUR).<\/li>\n<\/ul>\n\n<p><strong>Third-party service<\/strong><\/p>\n\n<p>This plugin relies on the TopSMS.cz SMS gateway, a paid third-party service operated by TopSMS.cz (Vojtech Safar, Prague, Czech Republic). Messages are sent through the TopSMS REST API at <code>https:\/\/www.topsms.cz\/api<\/code>. For every message the plugin transmits the recipient phone number, the message text (which may contain the customer name and order details depending on your templates), the Sender ID and your shop URL (in the User-Agent header). The connection check transmits only your API key. No data is sent unless you enter an API key.<\/p>\n\n<ul>\n<li>Terms of service: <a href=\"https:\/\/www.topsms.cz\/obchodni-podminky\">https:\/\/www.topsms.cz\/obchodni-podminky<\/a><\/li>\n<li>Privacy policy: <a href=\"https:\/\/www.topsms.cz\/zasady-ochrany-osobnich-udaju\">https:\/\/www.topsms.cz\/zasady-ochrany-osobnich-udaju<\/a><\/li>\n<li>Data processing agreement (GDPR): <a href=\"https:\/\/www.topsms.cz\/zpracovatelska-smlouva\">https:\/\/www.topsms.cz\/zpracovatelska-smlouva<\/a><\/li>\n<li>API documentation: <a href=\"https:\/\/www.topsms.cz\/api-integrace\/rest-api\">https:\/\/www.topsms.cz\/api-integrace\/rest-api<\/a><\/li>\n<\/ul>\n\n<p><strong>Developer hooks<\/strong><\/p>\n\n<ul>\n<li><code>topsms_wc_recipient_phone<\/code> (filter): change the recipient number, receives <code>$phone, $order, $status<\/code>.<\/li>\n<li><code>topsms_wc_message_text<\/code> (filter): change the final text, receives <code>$text, $order, $status<\/code>.<\/li>\n<li><code>topsms_wc_should_send<\/code> (filter): return <code>false<\/code> to skip a notification, receives <code>true, $order, $status<\/code>.<\/li>\n<li><code>topsms_wc_sms_sent<\/code> (action): fires after every attempt with <code>$order, $phone, $text, $result<\/code>.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin (WooCommerce must be active).<\/li>\n<li>Register at <a href=\"https:\/\/www.topsms.cz\">www.topsms.cz<\/a> and create an API key in the dashboard, section API.<\/li>\n<li>Go to WooCommerce &gt; Settings &gt; TopSMS, paste the API key and click \"Check connection\".<\/li>\n<li>Enable the order statuses that should trigger an SMS and adjust the templates.<\/li>\n<li>Optionally enable the shop owner notification and enter your phone number.<\/li>\n<li>Send a test SMS to your own number to confirm everything works.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"which%20countries%20can%20i%20send%20to%3F\"><h3>Which countries can I send to?<\/h3><\/dt>\n<dd><p>TopSMS delivers to all Czech and Slovak mobile networks and to international destinations. Prices per destination are listed at https:\/\/www.topsms.cz\/cenik.<\/p><\/dd>\n<dt id=\"how%20is%20a%20message%20priced%3F\"><h3>How is a message priced?<\/h3><\/dt>\n<dd><p>Each SMS part is charged to your TopSMS credit. Plain ASCII messages carry 160 characters per part; messages with characters outside the GSM alphabet (Czech diacritics, emoji) carry 70 characters per part. The settings screen explains this next to the templates.<\/p><\/dd>\n<dt id=\"can%20i%20use%20my%20own%20sender%20name%3F\"><h3>Can I use my own sender name?<\/h3><\/dt>\n<dd><p>Yes. Request a Sender ID in your TopSMS dashboard. Mobile operators approve new sender names in batches, usually a few times per month, so allow one to two weeks. Until it is approved, leave the field empty and the default TopSMS sender is used.<\/p><\/dd>\n<dt id=\"does%20the%20customer%20receive%20the%20same%20status%20twice%3F\"><h3>Does the customer receive the same status twice?<\/h3><\/dt>\n<dd><p>No. Each status is announced once per order, even if the order goes back and forth between statuses.<\/p><\/dd>\n<dt id=\"the%20sms%20was%20not%20sent.%20where%20do%20i%20look%3F\"><h3>The SMS was not sent. Where do I look?<\/h3><\/dt>\n<dd><p>Open the order: the plugin leaves an order note for every attempt, including the gateway error message. WooCommerce &gt; SMS log lists the last 100 messages. WooCommerce &gt; Status &gt; Logs (source \"topsms\") contains failures as well.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20hpos%20and%20the%20block%20checkout%3F\"><h3>Does it work with HPOS and the block checkout?<\/h3><\/dt>\n<dd><p>Yes, both are supported.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Default SMS templates in Czech and German are built in again and used when the site language is Czech or German.<\/li>\n<li>Test SMS message shows the price in the account currency.<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Renamed to TopSMS.cz Order SMS for WooCommerce (new slug) for the WordPress.org directory.<\/li>\n<li>Translations are now delivered through translate.wordpress.org instead of bundled language files.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>German translation (de_DE), including the default SMS templates.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Czech default SMS templates without diacritics: each notification now fits into one SMS (160 characters) instead of two (70 characters with diacritics). Existing custom templates are not changed.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release: customer status notifications, shop owner new-order SMS, templates with placeholders, Sender ID, phone normalisation, background sending, log screen, test button, Czech translation.<\/li>\n<\/ul>","raw_excerpt":"Order status SMS for WooCommerce shops in Czechia, Slovakia and the EU, through the TopSMS gateway (topsms.cz \/ topsms.eu).","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/376222","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=376222"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/topsmscz"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=376222"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=376222"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=376222"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=376222"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=376222"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=376222"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}