Ninja Quick Contact

Professional floating contact widget for WordPress. Ninja Quick Contact adds a floating button to your site that opens quick contact options such as WhatsApp, phone, email, Telegram, social media, and a map location — with click analytics and marketing pixel events built in.

Features

Core

• Floating contact widget — a responsive floating button with smooth animations.
• Multiple contact methods — phone, WhatsApp, email, Telegram, Facebook, Instagram, Twitter/X, location, and a custom link.
• Admin dashboard — modern interface with a live preview.
• Click analytics — tracks clicks per button, per day, per device, and per browser.
• Pixel events — fire conversion events for Facebook Pixel, Google Analytics 4, TikTok, and Snapchat, or run custom JavaScript.
• Internationalization-ready — English source strings, with an Arabic translation included.
• Fully customizable — colors, icons, positions, and animations.

Widget

• 9 contact button types (phone, WhatsApp, email, Telegram, Facebook, Instagram, Twitter/X, location, custom link).
• 4 corner positions (top-left, top-right, bottom-left, bottom-right).
• 3 animation styles (pulse, bounce, shake) plus "none".
• Official brand colors or custom colors per button.
• Built-in inline SVG icon set (no external icon font required on the frontend).
• Drag-and-drop button ordering and per-button enable/disable.
• Tooltips and full keyboard accessibility.

Analytics

• Real-time click tracking stored in a dedicated table.
• Button performance, device, and browser breakdowns.
• Date-range filtering and CSV export.
• Timeline and performance charts (Chart.js).

Pixel events

• Facebook Pixel, Google Analytics 4, TikTok Pixel, Snapchat Pixel.
• Custom JavaScript execution per button (or all buttons).
• Event-specific configuration.

Installation

1. Upload the plugin folder to /wp-content/plugins/ninja-quick-contact/.
2. Activate the plugin through the Plugins menu in WordPress.
3. Go to Quick Contact → Settings to configure it.
4. Add your phone/WhatsApp/email values, choose a position and animation, and save.
5. View the widget on the frontend.

Configuration

Basic settings

1. Navigate to Quick Contact → Settings.
2. Enable the widget.
3. Choose a position and an animation style.
4. Enable analytics if you want click tracking.

Buttons

1. Click any button to edit its label, icon, color, value, and (for WhatsApp) a default message.
2. Toggle buttons on/off and drag to reorder.

Analytics

• Enable analytics in Settings.
• View reports under Quick Contact → Analytics and export to CSV.

Pixel events

1. Go to Quick Contact → Pixel Events.
2. Add an event, choose a platform and target button, set the event name, and (optionally) custom code.

Requirements

• WordPress 6.0 or higher
• PHP 7.4 or higher

Internationalization

Source strings are in English. Translation files live in /languages/:

• ninja-quick-contact.pot — translation template.
• ninja-quick-contact-ar.po / .mo — Arabic translation.

To add a language, copy the .pot to ninja-quick-contact-<locale>.po, translate it, and compile a .mo.

Notes

• The admin interface loads Font Awesome and Chart.js from public CDNs for icons and charts. The public-facing widget uses bundled inline SVG icons and does not require any external icon font.
• This plugin does not require WooCommerce or any other plugin.

License

This plugin is licensed under the GPLv2 or later. See the LICENSE file for the full text.

Author

Ninja (7ussam) — https://github.com/7ussamninja

Changelog

1.0.0

• Initial release: floating contact widget, 9 button types, admin dashboard, click analytics, pixel events, and Arabic translation.