{"id":387093,"date":"2026-10-18T08:18:51","date_gmt":"2026-10-18T08:18:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/alharthiweb-order-alerts\/"},"modified":"2026-10-18T08:18:44","modified_gmt":"2026-10-18T08:18:44","slug":"alharthiweb-order-alerts","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/alharthiweb-order-alerts\/","author":23368791,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.4","stable_tag":"1.1.4","tested":"7.1.3","requires":"6.4","requires_php":"7.4","requires_plugins":null,"header_name":"Alharthiweb Order Alerts","header_author":"Moayad Alharthi","header_description":"Send clear WooCommerce order summaries to your team through your own Telegram bot.","assets_banners_color":"1e2c5f","last_updated":"2026-10-18 08:18:44","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/alharthiweb.com\/plugins\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":85,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.4":{"tag":"1.1.4","author":"moayyedalharthi","date":"2026-10-18 08:18:44","revision":3752748}},"upgrade_notice":{"1.1.0":"<p>Deactivate the original WC Order Telegram Alert before installing. Connection settings migrate to encrypted storage; retain the matching WordPress security keys. Downgrading to the old plugin requires re-entering credentials.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3752748,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3752748,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3752748,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3752748,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3752748,"resolution":"1","location":"assets","locale":"","width":1425,"height":1878},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3752748,"resolution":"2","location":"assets","locale":"","width":1425,"height":2337}},"screenshots":{"1":"Connect your Telegram bot and send a test.","2":"Choose order information and inspect delivery diagnostics."}},"plugin_section":[],"plugin_tags":[212469,38803,9171,286],"plugin_category":[45],"plugin_contributors":[285842],"plugin_business_model":[],"class_list":["post-387093","plugin","type-plugin","status-publish","hentry","plugin_tags-order-alerts","plugin_tags-order-notifications","plugin_tags-telegram","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-moayyedalharthi","plugin_committers-moayyedalharthi"],"banners":{"banner":"https:\/\/ps.w.org\/alharthiweb-order-alerts\/assets\/banner-772x250.png?rev=3752748","banner_2x":"https:\/\/ps.w.org\/alharthiweb-order-alerts\/assets\/banner-1544x500.png?rev=3752748","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/alharthiweb-order-alerts\/assets\/icon-128x128.png?rev=3752748","icon_2x":"https:\/\/ps.w.org\/alharthiweb-order-alerts\/assets\/icon-256x256.png?rev=3752748","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/alharthiweb-order-alerts\/assets\/screenshot-1.png?rev=3752748","caption":"Connect your Telegram bot and send a test."},{"src":"https:\/\/ps.w.org\/alharthiweb-order-alerts\/assets\/screenshot-2.png?rev=3752748","caption":"Choose order information and inspect delivery diagnostics."}],"raw_content":"<!--section=description-->\n<p>Your store orders, straight to your team. Employees can read products, quantities and variations inside Telegram without signing into WordPress.<\/p>\n\n<p>Connect one bot, save one destination, send a test, then enable notifications. New orders can include unpaid and Cash on Delivery orders; these alerts are not payment confirmations.<\/p>\n\n<p>Free includes one destination, background new-order delivery, bounded retries, duplicate prevention, delivery diagnostics, field selection and optional Kikote delivery-location links. There is no monthly notification quota.<\/p>\n\n<p>Select customer notes, name, telephone, email, address and registered extra checkout fields only when your team needs them. Personal details are off by default. Empty fields are omitted; legitimate zero values and Unicode content are preserved. Phone\/email text can be copied; automatic linking depends on the recipient's Telegram client.<\/p>\n\n<p>Pro adds multiple destinations, team presets, status-change alerts, flat order rules, per-destination privacy and allowlisted plain-text message templates. Pro implementation is distributed separately and is not included in the WordPress.org Free package.<\/p>\n\n<p>This plugin is independently developed by Alharthiweb and is not affiliated with Telegram, WooCommerce or Automattic.<\/p>\n\n<h4>External services and privacy<\/h4>\n\n<p>Telegram Bot API: https:\/\/api.telegram.org\/ is required for configured notification functionality. Nothing is sent to Telegram merely by activating this plugin. When you authorize and verify a bot, its credentials identify the bot to Telegram. Discovery checks webhook status and briefly reads pending updates to find your explicit pairing command without acknowledging them. Existing webhooks are never removed. Use a dedicated bot or enter a Chat ID manually.<\/p>\n\n<p>Tests send synthetic text. Enabled background notifications send your destination ID and selected order fields: order number\/time\/status, products\/variations\/quantities, totals\/currency\/payment and any optional customer, address, note, registered field or location data you enable. Telegram processes and stores messages under its own policies. Do not send payment credentials or unnecessary personal data.<\/p>\n\n<p>Telegram terms: https:\/\/telegram.org\/tos\/bot-developers\nTelegram privacy: https:\/\/telegram.org\/privacy<\/p>\n\n<p>Google Maps: if you enable delivery location and valid Kikote coordinates exist, the message includes a https:\/\/www.google.com\/maps\/ link. Google receives the location when a recipient opens that link. The plugin does not contact Google, geocode addresses or require a Google API key.\nGoogle privacy: https:\/\/policies.google.com\/privacy\nGoogle terms: https:\/\/policies.google.com\/terms<\/p>\n\n<p>Freemius: the Pro package uses the official Freemius SDK for licensing, account management and updates after you choose Connect Freemius &amp; Activate License. Freemius receives license, account and site information; Telegram credentials and order messages are not sent to Freemius. The Free workflow does not require a Freemius connection or optional telemetry.\nFreemius privacy: https:\/\/freemius.com\/privacy\/\nFreemius terms: https:\/\/freemius.com\/terms\/<\/p>\n\n<p>Configuration is encrypted using AES-256-GCM and a key derived from your WordPress security keys. Keep wp-config.php security keys with protected backups. Changing them makes existing encrypted configuration unreadable until the matching keys are restored. Delivery diagnostics store order IDs, opaque destination IDs, status codes and timestamps, not message bodies, tokens or full customer records. Diagnostics expire after 30 days. Disabling the plugin stops processing; uninstall preserves settings by default. Define ALHWOA_DELETE_DATA as true in wp-config.php before uninstall to remove this plugin's settings and diagnostics. WooCommerce orders and messages already sent to Telegram are not deleted. Manage Telegram messages separately and disclose your store's data sharing in its privacy policy.<\/p>\n\n<h4>Source code<\/h4>\n\n<p>assets\/admin.js and assets\/admin.css are the complete maintained source. No compilation, minification, package manager or external CDN is used. The bundled Freemius WordPress SDK is distributed with its readable source and GPL license; upstream source: https:\/\/github.com\/Freemius\/wordpress-sdk (tag 2.13.4). No vendor files are patched.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce. PHP OpenSSL and mbstring are required for encrypted settings and Unicode messages.<\/li>\n<li>Install Alharthiweb Order Alerts and open WooCommerce &gt; Order Alerts.<\/li>\n<li>Create a bot with Telegram's BotFather and authorize the connection using its Bot Token.<\/li>\n<li>Start the bot in your private chat or add it to your team group. Use safe pairing or enter the Chat ID. Channels require permission for the bot to post.<\/li>\n<li>Send Test, choose the information to share, then enable notifications.<\/li>\n<li>Ensure WordPress cron or a real cron runner processes WooCommerce Scheduled Actions.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20accepted%20mean%20an%20employee%20read%20the%20message%3F\"><h3>Does accepted mean an employee read the message?<\/h3><\/dt>\n<dd><p>No. It means Telegram accepted the request. Timeouts or interrupted sends can produce an uncertain result. Check the destination before a manual retry to avoid duplicates. Exactly-once delivery is not guaranteed by the Telegram API.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20delivery%20fails%3F\"><h3>What happens when delivery fails?<\/h3><\/dt>\n<dd><p>Explicit transient rejections and rate limits receive up to three attempts. Permanent errors need configuration repair. An uncertain response is not blindly retried. Diagnostics distinguish accepted, failed, retrying, paused and uncertain outcomes.<\/p><\/dd>\n<dt id=\"can%20i%20keep%20using%20my%20existing%20bot%3F\"><h3>Can I keep using my existing bot?<\/h3><\/dt>\n<dd><p>Yes, through manual Chat ID entry. Safe discovery requires a dedicated bot: an existing webhook or competing polling client may prevent discovery. No webhook is removed or reconfigured.<\/p><\/dd>\n<dt id=\"can%20employees%20read%20orders%20without%20wordpress%20access%3F\"><h3>Can employees read orders without WordPress access?<\/h3><\/dt>\n<dd><p>Yes. Selected products, variations, quantities and other details are in the message. The optional manager link still requires an authorized WordPress login. Long messages are visibly shortened to Telegram's limit; staff should check remaining order details when that notice appears.<\/p><\/dd>\n<dt id=\"how%20are%20old%20settings%20upgraded%3F\"><h3>How are old settings upgraded?<\/h3><\/dt>\n<dd><p>Deactivate WC Order Telegram Alert before activating this plugin. Its bot token and Chat ID are copied to verified encrypted storage, then the migrated plaintext credentials are retired. Unrelated legacy settings are preserved. Existing customer-name sharing is retained and disclosed. New personal fields stay off. Returning to the original plugin requires re-entering its connection. Historical orders are not imported.<\/p><\/dd>\n<dt id=\"what%20happens%20without%20pro%20entitlement%3F\"><h3>What happens without Pro entitlement?<\/h3><\/dt>\n<dd><p>The selected Free fallback destination continues receiving new-order summaries. Team configuration is retained, but extra destinations, status alerts, rules and custom templates require Pro entitlement. Use License &amp; Account to view the provider's actual license and renewal status.<\/p><\/dd>\n<dt id=\"does%20kikote%20need%20to%20be%20active%3F\"><h3>Does Kikote need to be active?<\/h3><\/dt>\n<dd><p>No. When enabled, the integration reads valid saved lpac_latitude\/lpac_longitude values (with compatibility for older prefixed values). Missing or invalid coordinates hide the location action. No map or geocoding service is called by this plugin.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.4<\/h4>\n\n<ul>\n<li>Sanitize the settings nonce before verification and accept only known, correctly shaped form fields.<\/li>\n<li>Preserve multiline templates, Unicode text and existing destination settings.<\/li>\n<li>Use the original Alharthiweb Order Alerts artwork in the licensing interface.<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Add concise in-plugin BotFather and private\/group connection instructions with safe command copy and recovery.<\/li>\n<li>Remove persistent completed-migration narration while preserving settings, consent and prior sharing choices.<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>Make Pro information and state-aware license activation\/account access discoverable beside the product heading. Explicit licensing consent and the main Telegram workflow are preserved.<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Prevent a PHP function collision when another edition is already loaded. The activation notice now safely preserves the active edition and settings.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Productized release with encrypted legacy migration, English-first settings, background delivery, diagnostics, field privacy and optional Kikote location links.<\/li>\n<li>Separate Pro distribution adds team routing, status alerts, rules and safe templates.<\/li>\n<\/ul>","raw_excerpt":"Send clear WooCommerce order summaries to your team through your own Telegram bot, with background delivery and privacy controls.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/387093","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=387093"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/moayyedalharthi"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=387093"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=387093"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=387093"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=387093"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=387093"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=387093"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}