WP Manifestindependent plugin directory
manifest / forms / elementor-bale-notifier

Elementor Bale Notifier

Elementor Pro integration for sending form submissions to Bale Messenger Bot API.

by وحید گودینی · github.com/vahidgoudini/elementor-bale-notifier · website

★ 2stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/vahidgoudini/elementor-bale-notifier/archive/refs/heads/main.zip
Readme github.com/vahidgoudini/elementor-bale-notifier ↗

# Elementor Bale Notifier

English | Persian

WordPress plugin that connects Elementor Pro Forms to the Bale Messenger Bot API and sends instant notifications when a form is submitted.

Features

  • Bale Messenger integration as an Elementor Pro Form Action
  • Custom message templates with dynamic tags
  • Support for users, groups and chats
  • One-click connection testing
  • Submission logging with search, filtering and pagination
  • Configurable log retention
  • Debug mode
  • Persian and RTL support
  • Extensible Provider Interface architecture
  • Form submissions remain successful when Bale API requests fail

Requirements

  • WordPress 6.8+
  • PHP 8.1+
  • Elementor Pro 3.5.0+

Installation

  1. Upload and activate the plugin.
  2. Create a Bale bot through @BotFather.
  3. Send /start to the bot.
  4. Obtain the numeric Chat ID.
  5. Edit an Elementor Pro Form.
  6. Add Bale Messenger under Actions After Submit.
  7. Enter the Bot Token and Recipient ID.
  8. Use Test Connection and save the form.

Message Templates

Supported tags:

[field id="field_id"] [field id="*"] [date] [time] [ip] [site_name] [form_name]

Example:

New Lead

Name: [field id="name"] Phone: [field id="phone"] Email: [field id="email"]

Date: [date] Time: [time]

Logging

The plugin provides a dedicated logging system with:

  • Search
  • Success and failed filtering
  • Pagination
  • Log retention
  • Log clearing

Security

The plugin includes:

  • Nonce verification
  • Capability checks
  • Input sanitization
  • Output escaping
  • Prepared SQL statements
  • WordPress HTTP API

Bot tokens should always be treated as sensitive credentials.

Error Handling

If the Bale API request fails, the Elementor form submission is not considered failed for the visitor. Errors can be recorded in the plugin logs.

Project Structure

admin/ assets/ includes/ languages/ elementor-bale-notifier.php readme.txt uninstall.php

Changelog

1.0.0

  • Initial release
  • Bale Messenger integration with Elementor Pro Forms
  • Dynamic message templates
  • Admin logging panel
  • Search, filtering and pagination
  • Test Connection functionality
  • Persian and RTL support
  • Provider Interface architecture
  • Client IP handling and caching optimizations

License

GPL-2.0-or-later

Author

Vahid Goudini

Website: https://vahidgoudini.ir