respinar/contao-whatsapp-button

A WhatsApp button bundle for Contao CMS

Maintainers

Package info

github.com/respinar/contao-whatsapp-button

Type:contao-bundle

pkg:composer/respinar/contao-whatsapp-button

Transparency log

Statistics

Installs: 5

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.7.0 2026-04-21 10:52 UTC

Requires

Requires (Dev)

MIT 098d37b49f74c32c15dc5cb60bc0eaf88bcfd30b

bundlewhatsappcontao

Published on Packagist.org on 2026-08-22 10:53 UTC

This package is auto-updated.

Last update: 2026-08-22 10:53:13 UTC

README

Note: This package was renamed from respinar/contao-whatsapp to respinar/contao-whatsapp-button. If you previously used the old package name, update your composer.json accordingly.

A lightweight and versatile Contao bundle that adds a customizable WhatsApp button to your pages. Ideal for businesses, bloggers, or anyone looking to enable fast, direct communication with visitors via WhatsApp. Configure the button effortlessly through Contao’s backend with your phone number, default message, and styling—no coding skills needed!

Features

  • Seamless Integration: Easily add the WhatsApp button to any Contao page or module.
  • Customizable: Set button text, phone number, and default message via page or module settings.
  • Multi-Language Support: Fully translated into English, Persian (Farsi), and German for backend labels and descriptions.
  • Device-Aware Links: Automatically adapts WhatsApp links for mobile (whatsapp://) and desktop (web.whatsapp.com) using PHP-based user-agent detection.
  • Twig-Powered: Modern, secure templating with Contao 5.3’s Twig engine.
  • Flexible Styling: Apply custom CSS classes through Contao’s backend for tailored designs.

Installation

  • Install via Composer: composer require respinar/contao-whatsapp-button
  • Configure in the Contao backend under module and page settings.

Configuration

  1. Module Settings: In the Contao backend, go to "Modules" > "Frontend Modules" > "New", select "Whatsapp" from the "Miscellaneous" category, and configure:
    • WhatsApp Title
    • WhatsApp Number (e.g., +1234567890)
    • Default Message
  2. Page Settings: Optionally override module settings per page under "Site Structure" > "Page Properties" > "WhatsApp Settings".
  3. Add the module to a page layout or article as needed.

Usage

  • The button appears wherever you include the module in your layout or content.
  • Clicking it opens WhatsApp with the configured phone number and message, optimized for the user’s device (mobile app or web interface) via server-side detection.
  • Customize the appearance using CSS classes in the module settings.

Requirements

  • Contao 5.3 or higher
  • PHP 8.3+

License

MIT Contributions and feedback welcome!