# Modulux Chat Box

A lightweight, privacy-friendly floating Q&A chat box for WordPress.

Modulux Chat Box helps visitors find answers first — before they contact you via WhatsApp or any other channel.

---

## Why this plugin exists

Most chat plugins:
- Open WhatsApp immediately
- Rely on third-party services
- Load heavy icon libraries or frameworks
- Track users without consent

Modulux Chat Box takes a different approach.

**Answer first. Contact second.**

Visitors are encouraged to read your predefined Q&As before messaging you.

---

## Key Features

- Control visibility by post type
- Optionally limit display to specific pages
- Floating launcher button with full styling control
- Custom post type for Questions & Answers
- Searchable Q&A list
- Mandatory confirmation checkbox before contact
- WhatsApp or custom contact URL
- WooCommerce product-aware message templates
- Working hours and offline message support
- Custom open triggers via CSS selector
- Overlay background when open
- Fully multilingual (Polylang / WPML)
- Accessible and keyboard-friendly

---

## Lightweight & Privacy-Friendly

- No external APIs
- No SaaS services
- No tracking or analytics
- No Font Awesome or heavy icon libraries
- No frontend frameworks

Everything runs locally inside WordPress.

---

## Technical Structure

- **PHP**: Settings API, CPTs, sanitization, rendering
- **JavaScript**: Vanilla JS (no dependencies)
- **CSS**: Scoped styles, no global pollution
- **Icons**: WordPress Dashicons or custom image

Frontend assets are loaded only when the plugin is enabled.

---

## Multilingual Support

- Q&As are translatable via Polylang or WPML
- Interface texts are fully translatable
- WPML admin-text configuration included

---

## Installation

1. Upload the plugin to `/wp-content/plugins/modulux-chat-box/`
2. Activate it from the Plugins screen
3. Go to **Settings → Modulux Chat Box**
4. Add your questions under **Chat Q&As**

---

## WooCommerce Integration

On product pages, the contact button can automatically include:
- Product title
- SKU
- Product URL

All message templates are fully customizable.

---

## License

GPLv2 or later  
© Modulux – https://modulux.net