Done \u2014 the button appears on every page (or as configured).<\/li>\n<\/ol>\n\n\nFrom the WordPress dashboard:<\/strong><\/p>\n\n\n- Go to Plugins > Add New.<\/li>\n
- Search for \"TalaDesk\".<\/li>\n
- Click Install Now, then Activate.<\/li>\n
- Go to the TalaDesk menu in your admin sidebar to configure.<\/li>\n<\/ol>\n\n
Manual installation:<\/strong><\/p>\n\n\n- Upload the
taladesk<\/code> folder to \/wp-content\/plugins\/<\/code>.<\/li>\n- Activate through the Plugins screen.<\/li>\n
- Configure under the TalaDesk menu in your admin sidebar.<\/li>\n<\/ol>\n\n\n
\nWhat information does TalaDesk collect?<\/h3><\/dt>\nBy default, nothing. TalaDesk does not collect personal data, track visitors, or contact external servers. All settings are stored in your WordPress options table. The optional click counter lives in the browser's sessionStorage only \u2014 it is never transmitted anywhere. The one exception is the optional \"TalaDesk Account\" tab \u2014 see the next question.<\/p><\/dd>\n
What is the TalaDesk Account feature?<\/h3><\/dt>\nAn optional integration for site owners who have a separate, paid TalaDesk SaaS account. It requires you to explicitly enter your TalaDesk domain and OAuth Client ID\/Secret and click \"Connect\" \u2014 nothing is contacted until you do this. Once connected, the plugin contacts your TalaDesk domain to exchange your credentials for an access token and to fetch the list of available messaging sources and channels, so you can select which one this site should use. Your Client Secret is stored in your WordPress options table in plaintext, the same as every other setting on this page \u2014 protecting your database is the same responsibility as with any other WordPress credential storage. This feature has no effect on the free CTA button, which keeps working exactly as before whether or not you connect an account. If you also use WooCommerce, connecting an account unlocks the \"TalaDesk Messaging\" rules feature \u2014 see the next question.<\/p><\/dd>\n
What is WooCommerce Order Messaging?<\/h3><\/dt>\nAn optional feature, visible under WooCommerce > TalaDesk Messaging, available once a TalaDesk Account is connected. It lets you create rules that send a TalaDesk message when a WooCommerce order changes from one status to another (e.g. \"pending\" to \"processing\"), using a template from your TalaDesk account with WooCommerce order\/customer data (name, email, order number, etc.) mapped into the template's placeholders. This only fires when a rule you've configured matches an order's status change \u2014 it makes no external requests otherwise, and has no effect on any other part of the plugin.<\/p><\/dd>\n
What is the WhatsApp checkout opt-in?<\/h3><\/dt>\nAn optional feature, off by default, that only appears once you've connected a TalaDesk account, chosen a channel, and explicitly enabled it under TalaDesk Account > Checkout Opt-In. When enabled, an unchecked \"Send me order updates via WhatsApp\" checkbox appears on the WooCommerce checkout page. Checking it reveals an optional WhatsApp number field, for cases where the number to message isn't the billing phone already entered (e.g. ordering for a branch but wanting updates on a personal phone) \u2014 leaving it blank just uses the billing phone. Checking the box stores a flag (and number, if given) against that order only; it makes no external request by itself. That flag is then used by \"Customer\"-mode TalaDesk Messaging rules (see \"What is WooCommerce Order Messaging?\" above) to decide whether a given order may be messaged \u2014 an order that didn't opt in is skipped, not messaged, by such rules. \"Custom phone number\"-mode rules are unaffected by this checkbox either way, since those were never about customer consent.<\/p><\/dd>\n
Which messaging services are supported?<\/h3><\/dt>\nThis plugin connects visitors to WhatsApp. Additional services are offered by a separate premium product at taladesk.com.<\/p><\/dd>\n
Can I customize the button colors?<\/h3><\/dt>\nYes \u2014 icon color, text color, and background color are all configurable from the settings page. Each has a color picker with defaults matching the WhatsApp green theme.<\/p><\/dd>\n
What happens when someone clicks the button?<\/h3><\/dt>\nThe button opens WhatsApp in a new tab with your pre-filled message (e.g., wa.me\/27123456789?text=Hi<\/code>). The message template is configured in the settings.<\/p><\/dd>\nHow do public holidays work? Does it contact a holiday service?<\/h3><\/dt>\nNo. Holiday dates are calculated inside the plugin from rules shipped with it (fixed dates, Easter-based dates, \"nth Monday\" rules, and each country's weekend substitute-day rule) \u2014 nothing is fetched from the internet. Supported: Australia (by state\/territory), Canada (by province\/territory), Ireland, Kenya, Nigeria, South Africa, and the United Kingdom (England & Wales, Scotland, Northern Ireland). Each holiday's next date is shown in the settings so you can check it, and any holiday can be unticked.<\/p>\n\n
Some holidays can't be calculated and must be added under Closures & Special Hours: holidays whose dates depend on the moon (e.g. Eid in Kenya and Nigeria), days a government declares at short notice (e.g. election days), and holidays set by yearly proclamation or that only apply to part of a state (e.g. WA King's Birthday, AFL Grand Final Friday). In Canada only holidays that are statutory for the province's general workforce are included.<\/p><\/dd>\n
Does the schedule work with caching plugins?<\/h3><\/dt>\nYes. The button's open\/closed state is decided in the visitor's browser from a schedule embedded in the page, so a page cached during opening hours still shows the closed state after hours (and vice versa). The embedded schedule covers the next 60 days.<\/p><\/dd>\n
Does this work with page builders?<\/h3><\/dt>\nYes \u2014 because TalaDesk hooks into wp_footer<\/code>, it works with all page builders (Elementor, Beaver Builder, Gutenberg, etc.) and any WordPress theme.<\/p><\/dd>\nIs TalaDesk GDPR-compliant?<\/h3><\/dt>\nUsed purely as the free CTA button, TalaDesk makes zero external requests and sets no cookies. The optional click counter uses the browser's sessionStorage which is cleared when the tab closes. No consent banner is required for the free CTA. If you explicitly connect the optional TalaDesk Account feature, your entered credentials are sent to the domain you specify \u2014 see \"What is the TalaDesk Account feature?\" above.<\/p><\/dd>\n
Are there additional features available elsewhere?<\/h3><\/dt>\nYes. taladesk.com offers a separate premium product with extra messaging services and analytics. It is independent of this plugin \u2014 nothing in this plugin is locked or disabled.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.4.0<\/h4>\n\n\n- Added: Public holidays \u2014 choose a country to close the chat on its public holidays, including weekend substitute days: Australia (by state\/territory), Canada (by province\/territory), Ireland, Kenya, Nigeria, South Africa, United Kingdom (by nation). Each holiday can be unticked or given its own button text. Calculated locally; no external requests.<\/li>\n
- Added: Closures & Special Hours \u2014 one-off or yearly closed periods (whole days or specific times), and special opening hours that replace the normal hours on given dates.<\/li>\n
- Added: When Closed \u2014 per reason (outside hours \/ holidays \/ closures), hide the button or show a closed button with its own text, colors and pre-filled message. {name} and {reopen} placeholders, e.g. \"Closed for Christmas Day \u2014 back Monday 9:00 am\". The closed button can be clickable or a message only.<\/li>\n
- Added: Schedule Preview on the settings page \u2014 current status and upcoming holidays\/closures with exactly what visitors will see.<\/li>\n
- Fixed: Opening hours that run past midnight (e.g. 20:00\u201302:00) never showed the button.<\/li>\n
- Fixed: With full-page caching, the button's scheduled visibility was frozen at whatever time the page was cached; the state is now evaluated in the browser and refreshed every minute.<\/li>\n
- Fixed: Invalid active-hours values are now rejected on save instead of stored.<\/li>\n
- Fixed: The click counter no longer throws when browser storage is blocked.<\/li>\n
- Changed: Outside active hours the button is still hidden by default, as before \u2014 existing sites see no change until they opt in to the closed button.<\/li>\n<\/ul>\n\n
1.3.4<\/h4>\n\n\n- Added: Adjustable distance from side edge (0\u2013500 px) \u2014 fine-tune how far the CTA sits from the left or right edge.<\/li>\n
- Changed: Side offset uses a CSS custom property, consistent at all screen sizes (responsive override removed, same as 1.3.3's bottom offset).<\/li>\n<\/ul>\n\n
1.3.3<\/h4>\n\n\n- Added: Adjustable distance from bottom edge (0\u2013500 px) \u2014 push the CTA button up to clear sticky footers, cookie banners, or other bottom-of-page elements.<\/li>\n
- Changed: Bottom offset now uses a CSS custom property so the user's chosen value is consistent at every screen size.<\/li>\n<\/ul>\n\n
1.3.2<\/h4>\n\n\n- Added: The WhatsApp checkout opt-in now reveals a WhatsApp number field once checked, pre-filled from the billing phone already entered \u2014 edit it if updates should go to a different number (e.g. ordering for a branch but wanting updates on a personal phone).<\/li>\n<\/ul>\n\n
1.3.1<\/h4>\n\n\n- Fixed: TalaDesk_Account_Client now targets the confirmed TalaDesk API contract (source\/channel\/template lookups and message sending) instead of placeholder endpoint guesses.<\/li>\n
- Changed: Source and Channel are now selected together immediately after connecting an account \u2014 channels are account-wide, not filtered by source.<\/li>\n
- Changed: Template placeholder mapping in TalaDesk Messaging rules is now positional (Variable 1, 2, 3\u2026) instead of named, matching the real template contract, which has no named placeholders.<\/li>\n<\/ul>\n\n
1.3.0<\/h4>\n\n\n- Added: Optional \"TalaDesk Account\" settings tab \u2014 connect a paid taladesk.com account via OAuth 2.0 Client Credentials to select a messaging source and channel.<\/li>\n
- Added: TalaDesk_Account_Client \u2014 isolated API client for token exchange, source\/channel\/template lookups, and message sending.<\/li>\n
- Added: Optional \"TalaDesk Messaging\" rules under WooCommerce (requires WooCommerce) \u2014 send a TalaDesk message using a chosen template, with placeholders mapped to order\/customer data, when an order transitions between configured statuses.<\/li>\n
- Added: Optional WooCommerce checkout opt-in checkbox (\"Send me order updates via WhatsApp\") \u2014 off by default, requires a separate admin toggle even when an account is connected; reuses the existing billing phone field, no new phone field added.<\/li>\n
- Changed: Settings page now has WhatsApp CTA \/ TalaDesk Account tabs.<\/li>\n
- Changed: \"Customer\"-mode TalaDesk Messaging rules now skip (recorded as a new \"Skipped\" status, not an error) any order that did not opt in at checkout; \"Custom phone number\"-mode rules are unaffected.<\/li>\n
- Fixed: The floating CTA button no longer appears on a fresh install before a Recipient ID (phone number) has been configured.<\/li>\n
- Note: All new features are entirely optional and off by default. External requests only occur if configured and used by the site owner; the free CTA button is unaffected either way.<\/li>\n<\/ul>\n\n
1.2.1<\/h4>\n\n\n- Removed: Disabled \"service\" selector and the non-functional API token field \u2014 no locked or disabled UI remains.<\/li>\n
- Removed: Internal pro-gating function and constant; the plugin is fully functional with no license checks.<\/li>\n
- Removed: WordPress.org directory image assets (banner, icon, screenshots) from the plugin package.<\/li>\n
- Changed: Settings page now shows a single, non-intrusive informational note about the separate premium product.<\/li>\n
- Fixed: Inline SVG output now escaped with wp_kses(); removed inline admin JavaScript.<\/li>\n<\/ul>\n\n
1.2.2<\/h4>\n\n\n- Fixed: Phone sanitization now strips + signs (digits only for WhatsApp wa.me compatibility)<\/li>\n<\/ul>\n\n
1.2.0<\/h4>\n\n\n- Removed: Telegram, Messenger, Signal, and SMS code from the free plugin to comply with WordPress.org guidelines (resolved plugin review blocker).<\/li>\n
- Changed: Messaging service selector replaced with a static WhatsApp display.<\/li>\n
- Changed: build_messaging_url() and get_service_icon() simplified to WhatsApp-only.<\/li>\n<\/ul>\n\n
1.1.4<\/h4>\n\n\n- Fixed: Escaped
$checked<\/code> output in active days field<\/li>\n- Fixed: Removed
Update URI<\/code> header (not permitted on .org)<\/li>\n- Fixed: Removed
load_plugin_textdomain()<\/code> (auto-loaded for .org)<\/li>\n- Fixed: Added
languages\/index.php<\/code> placeholder so domain path resolves<\/li>\n- Updated: Tested up to 7.0<\/li>\n
- Updated: Limited readme tags to 5<\/li>\n<\/ul>\n\n
1.1.3<\/h4>\n\n\n- Added:
load_plugin_textdomain()<\/code> call for translation support<\/li>\n- Added:
Update URI<\/code> header in plugin bootstrap<\/li>\n- Added: Empty
languages\/<\/code> directory for future .mo files<\/li>\n- Updated: Screenshots to reflect latest UI<\/li>\n<\/ul>\n\n
1.1.2<\/h4>\n\n\n- Changed: Messaging service dropdown disabled (WhatsApp only in free tier)<\/li>\n<\/ul>\n\n
1.1.1<\/h4>\n\n\n- Added: Purple Pro CTA banner at top of settings page (links to taladesk.com\/#contact)<\/li>\n
- Updated: Token field description shortened (CTA moved to top banner)<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Added: Master active toggle to turn CTA on\/off<\/li>\n
- Added: Business hours scheduling (day-of-week checkboxes + time range)<\/li>\n
- Added: taladesk.com token field (greyed out, for future Pro API linking)<\/li>\n<\/ul>\n\n
1.0.3<\/h4>\n\n\n- Fixed: Admin menu icon resized to 20x20 (was displaying huge)<\/li>\n<\/ul>\n\n
1.0.2<\/h4>\n\n\n- Changed: Admin menu icon switched to custom PNG icon<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Fixed: Hover text swap not working (JS ran before CTA rendered in DOM)<\/li>\n
- Fixed: Removed line-number artifacts that broke CSS and PHP<\/li>\n
- Removed: Username field (Telegram\/Messenger no longer configurable)<\/li>\n
- Removed: \"Powered by TalaDesk\" branding link<\/li>\n
- Removed:
!important<\/code> from CSS (proper specificity instead)<\/li>\n- Updated: Plugin description and labels streamlined for WhatsApp-only<\/li>\n
- Added: Plugin icon, banner, and screenshots for WordPress.org directory<\/li>\n
- Added: Top-level admin menu with TalaDesk icon (was under Settings)<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial public release.<\/li>\n
- Floating CTA button with configurable messaging service.<\/li>\n
- Support for WhatsApp, Telegram, Messenger, Signal, and SMS.<\/li>\n
- Full color customization (icon, text, background).<\/li>\n
- Optional hover text swap.<\/li>\n
- Position selection (bottom-right \/ bottom-left).<\/li>\n
- Display rules (all pages, homepage, posts, pages, exclude front page).<\/li>\n
- Settings page under Settings > TalaDesk.<\/li>\n
- Lightweight: no JavaScript frameworks, no external requests.<\/li>\n
- Accessibility: ARIA labels, keyboard navigation, focus-visible styles.<\/li>\n<\/ul>","raw_excerpt":"A lightweight floating WhatsApp call-to-action button with scheduling and display rules.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/326186","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=326186"}],"author":[{"embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/taladesk"}],"wp:attachment":[{"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=326186"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=326186"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=326186"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=326186"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=326186"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/et.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=326186"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}