WhatsApp Business Hub Pro — Documentation v1.0.3
WORDPRESS PLUGIN

WhatsApp Business Hub Pro

Complete setup guide — floating button, contact forms, WooCommerce & Telegram notifications, full Arabic RTL support.

دليل التثبيت والإعداد الكامل — زر عائم احترافي، نماذج تواصل، إشعارات WooCommerce وتيليجرام، دعم كامل للغة العربية.

PHP 7.4+ WordPress 5.5+ WooCommerce Ready RTL / Arabic Telegram Bot Single-site License
🏠

Introductionمقدمة

WhatsApp Business Hub Pro is a WordPress plugin that provides Telegram notifications for WooCommerce orders, plus practical WhatsApp contact tools such as a floating button, contact form, and official wa.me links.

WhatsApp Business Hub Pro هي إضافة WordPress توفر إشعارات Telegram لطلبات WooCommerce، بالإضافة إلى أدوات تواصل عملية عبر WhatsApp مثل الزر العائم ونموذج التواصل وروابط wa.me الرسمية.

💬

Floating Buttonالزر العائم

Appears on all pages with pulse animation and full customization.

يظهر في الصفحات مع تأثير نبض وإمكانية تخصيص كاملة.

🔔

Telegram Order Alertsتنبيهات الطلبات عبر Telegram

Receive WooCommerce order alerts through Telegram.

استقبل تنبيهات طلبات WooCommerce عبر Telegram.

🛒

WooCommerce

Telegram notifications for supported WooCommerce order status changes

إشعارات Telegram لتغييرات حالات طلبات WooCommerce المدعومة.

🌐

Arabic RTLعربي RTL

Full admin panel in Arabic with Cairo font.

لوحة تحكم كاملة بالعربية مع خط Cairo.


✅

Requirementsالمتطلبات

RequirementالمتطلبMinimumالحد الأدنىRecommendedالموصى به
WordPress5.56.0+
PHP7.48.1+
WooCommerce (optional)WooCommerce (اختياري)5.08.0+
Internet connectionاتصال بالإنترنتRequired for license verification & Telegramمطلوب للترخيص وإشعارات تيليجرام
💡 WooCommerce is required only for WooCommerce order notifications. The floating WhatsApp button, WhatsApp contact form, and inline WhatsApp button can work without WooCommerce.يُطلب WooCommerce فقط لتنبيهات طلبات WooCommerce. ويمكن أن يعمل زر WhatsApp العائم ونموذج تواصل WhatsApp وزر WhatsApp المضمن بدون WooCommerce.

📦

Installationالتثبيت

Method 1 — Upload (Recommended)الطريقة الأولى — رفع مباشر (موصى به)

  1. After purchasing the plugin, download the plugin ZIP file and the documentation file from the platform where you completed your purchase. The plugin file is named whatsapp-business-hub.zip.بعد شراء الإضافة، قم بتحميل ملف ZIP وملف التوثيق من المنصة التي أتممت الشراء من خلالها. اسم ملف الإضافة هو whatsapp-business-hub.zip.
  2. In WordPress admin go to Plugins → Add New → Upload Pluginاذهب إلى الإضافات ← إضافة جديدة ← رفع الإضافة
  3. Select the downloaded file and click Install Nowاختر الملف واضغط تثبيت الآن
  4. Click Activate Pluginاضغط تفعيل الإضافة
  5. You'll find WhatsApp Hub in the admin sidebarستجد WhatsApp Hub في القائمة الجانبية

Method 2 — FTPالطريقة الثانية — عبر FTP

  1. Unzip the file on your computerفك ضغط ملف ZIP على جهازك
  2. Upload the whatsapp-business-hub folder to /wp-content/plugins/ارفع مجلد whatsapp-business-hub إلى /wp-content/plugins/
  3. Activate from Plugins in your dashboardفعّل الإضافة من الإضافات في لوحة التحكم
⚠️ Do not modify plugin files directly — edits may be lost on updates.لا تعدّل ملفات الإضافة مباشرة — أي تعديل قد يضيع عند التحديث.

🔑

License Activationتفعيل الترخيص

License keys are issued manually after purchase. Contact us with your purchase order number by email at info@noor-dev.top or via Telegram to receive your unique key. Each key is intended for one website domain.

يتم إصدار مفاتيح الترخيص يدوياً بعد الشراء. تواصل معنا وأرسل رقم طلب الشراء عبر البريد الإلكتروني info@noor-dev.top أو عبر Telegram للحصول على مفتاحك الفريد. كل مفتاح مخصص لدومين موقع واحد.

  1. Go to WhatsApp Hub → License in the WordPress admin panelاذهب إلى WhatsApp Hub ← License في لوحة تحكم WordPress
  2. Enter the license keyأدخل مفتاح الترخيص
  3. Click Activate Licenseاضغط على تفعيل الترخيص
  4. After successful activation, the licensed plugin features become availableبعد نجاح التفعيل، ستصبح ميزات الإضافة المرخصة متاحة
✅ The license is verified periodically every 7 days. If the license server is temporarily unavailable, a 3-day grace period applies.يتم التحقق من الترخيص بشكل دوري كل 7 أيام. وإذا كان سيرفر التراخيص غير متاح مؤقتاً، توجد فترة سماح مدتها 3 أيام.

Transfer to another siteنقل الترخيص لموقع آخر

Each license is intended for one website domain. To move the license to another website, deactivate it from the License tab on the current website first, then activate it on the new website using the same license key, subject to the license terms.

كل ترخيص مخصص لدومين موقع واحد. لنقل الترخيص إلى موقع آخر، قم أولاً بإلغاء تفعيله من تبويب License في الموقع الحالي، ثم فعّله في الموقع الجديد باستخدام مفتاح الترخيص نفسه، وفقاً لشروط الترخيص.


⚙️

General Settingsالإعدادات العامة

SettingالإعدادDescriptionالوصف
Business WhatsApp NumberVisitor-facing number (international format e.g. +201234567890)رقم يظهر للزوار بالصيغة الدولية مثل +201234567890
Admin NumberAdmin number for internal notificationsرقم المشرف لاستقبال الإشعارات الداخلية
Default MessagePre-filled message when visitor taps the buttonالرسالة الافتراضية عند الضغط على الزر
Enable Contact FormEnable or disable the contact form shortcodeتفعيل أو تعطيل shortcode نموذج التواصل
💡 Enter phone numbers in international format without spaces: +201234567890أدخل الأرقام بالصيغة الدولية بدون مسافات: +201234567890

💬

Floating Buttonالزر العائم

OptionالخيارValuesالقيمDescriptionالوصف
PositionالموضعBottom right/left · Top right/leftأسفل يمين/يسار · أعلى يمين/يسارButton position on screenموضع الزر على الشاشة
ColorاللونAny HEX colorأي لون HEXDefault #25D366الافتراضي #25D366
TooltipالتلميحFree textنص حرShown on hoverيظهر عند تمرير الماوس
Pulse animationتأثير النبضOn / OffAnimated glow around the buttonتوهج متحرك حول الزر
Show on mobileإظهار على الجوالOn / OffVisibility on small screensالتحكم في الظهور على الشاشات الصغيرة
Show on desktopإظهار على الكمبيوترOn / OffVisibility on large screensالتحكم في الظهور على الشاشات الكبيرة
Exclude pagesاستثناء صفحاتComma-separated IDsأرقام مفصولة بفاصلة12,34,56
⚠️ Make sure to enter your WhatsApp number in General Settings first — without a number the button won't appear.تأكد من إدخال رقم الواتساب في الإعدادات العامة أولاً — بدون رقم الزر لن يظهر.

🔔

Notificationsالإشعارات

Choose your notification channel from the Notifications tab:

اختر قناة الإشعارات من تبويب Notifications:

✈️

Telegram Bot

Sends Telegram notifications for supported WooCommerce order events and supports customizable message templates.

يرسل إشعارات Telegram لأحداث طلبات WooCommerce المدعومة، ويدعم قوالب الرسائل القابلة للتخصيص.

📱

WhatsApp

Uses official wa.me links for visitor-initiated contact and manual follow-up. It does not send automated outbound WhatsApp messages.

يستخدم روابط wa.me الرسمية للتواصل الذي يبدأه الزائر والمتابعة اليدوية. ولا يرسل رسائل WhatsApp آلية إلى الخارج.


🛒

WooCommerceWooCommerce Pro

EventالحدثSent toيُرسل لـDescriptionالوصف
New orderطلب جديدAdminالمشرفTelegram order alert for new WooCommerce orders, where configuredتنبيه Telegram للمشرف بالطلبات الجديدة حسب الإعدادات
Processingقيد المعالجةCustomerالعميلNotifies customer order is being processedإشعار للعميل بأن طلبه تحت المعالجة
CompletedمكتملCustomerالعميلCompletion notification and thank-youإشعار بإتمام الطلب وشكر العميل
CancelledملغىAdmin + Customerالمشرف + العميلNotifies both parties of cancellationإشعار الطرفين بإلغاء الطلب

Message Template Variablesمتغيرات قوالب الرسائل

VariableالمتغيرValueالقيمة
{order_id}Order numberرقم الطلب
{customer}Customer full nameاسم العميل
{order_total}Order total amountإجمالي الطلب
{items}List of ordered productsقائمة المنتجات
{site_name}Your site nameاسم الموقع
{date}Order dateتاريخ الطلب

📌

Shortcodes

WhatsApp Contact Formنموذج تواصل واتساب

[wbh_contact_form] Displays a contact form — on submit, opens WhatsApp with a pre-filled message. You also receive a Telegram notification. يعرض نموذج تواصل — عند الإرسال يفتح واتساب برسالة جاهزة. وتصلك إشعار على تيليجرام.

Inline WhatsApp Buttonزر واتساب مضمّن

[wbh_whatsapp_button text="Chat with us"] Displays a colored WhatsApp button inside any page or post. يعرض زر واتساب ملوّن داخل أي صفحة أو منشور.
💡 These shortcodes work in any page, post, or WordPress widget area.يمكن وضع هذه الـ shortcodes في أي صفحة أو منشور أو widget.

✈️

Telegram Setupإعداد تيليجرام Pro

  1. Open Telegram and search for @BotFatherافتح تيليجرام وابحث عن @BotFather
  2. Send /newbot and follow the instructions to create a new botأرسل الأمر /newbot واتبع التعليمات لإنشاء بوت جديد
  3. BotFather gives you a Bot Token — copy itسيعطيك BotFather Bot Token — انسخه
  4. Search @userinfobot and send any message to get your Chat IDابحث عن @userinfobot وأرسل له أي رسالة للحصول على Chat ID
  5. In the plugin go to Notifications and select Telegramفي الإضافة اذهب إلى Notifications واختر Telegram
  6. Paste Token and Chat ID then click Send Testالصق الـ Token والـ Chat ID ثم اضغط Send Test
✅ If you receive a test message on Telegram — setup is complete!لو وصلتك رسالة اختبار على تيليجرام — الإعداد مكتمل!

⭐

Free vs Proمجاني مقابل Pro

FeatureالميزةFreePro
Floating WhatsApp buttonزر واتساب عائم✅✅
Color & position customizationتخصيص اللون والموضع✅✅
Arabic RTL supportدعم عربي RTL✅✅
Pulse animation & tooltipتأثير النبض والتلميح✅✅
WooCommerce notificationsإشعارات WooCommerce❌✅
WhatsApp contact formنموذج تواصل واتساب❌✅
Telegram notificationsإشعارات تيليجرام❌✅
Custom message templatesقوالب رسائل مخصصة❌✅
Notification logsسجل الإشعارات❌✅
Domain-locked licenseنظام ترخيص محمي❌✅
PriceالسعرFree$19 one-timeمرة واحدة

❓

Frequently Asked Questionsالأسئلة الشائعة

1. Does this send WhatsApp messages automatically to customers?١. هل ترسل الإضافة رسائل واتساب تلقائياً للعملاء؟

No. WhatsApp Business Hub Pro does not send automated outbound WhatsApp messages. The plugin uses official wa.me links to open WhatsApp on the visitor's device, where the visitor can review and send the message themselves. Automated WooCommerce order notifications are handled through Telegram.

لا. لا ترسل WhatsApp Business Hub Pro رسائل WhatsApp آلية إلى الخارج. تستخدم الإضافة روابط wa.me الرسمية لفتح WhatsApp على جهاز الزائر، حيث يمكنه مراجعة الرسالة وإرسالها بنفسه. تتم معالجة تنبيهات طلبات WooCommerce الآلية عبر Telegram.

2. Does the customer need to connect Telegram for every order?٢. هل يحتاج العميل لربط تيليجرام مع كل طلب؟

No. Customers connect their Telegram account once through the WooCommerce Thank You page or My Account area. After that, they can receive notifications for supported future order status changes while the license is active. Both registered customers and guests are supported.

لا. يربط العملاء حساب Telegram الخاص بهم مرة واحدة من صفحة الشكر الخاصة بـ WooCommerce أو من منطقة حسابي. بعد ذلك، يمكنهم استقبال إشعارات تغييرات حالات الطلبات المستقبلية المدعومة طالما أن الترخيص فعال. يدعم النظام العملاء المسجلين والزوار.

3. Why are there two Telegram bots?٣. لماذا يوجد بوتان لتيليجرام؟

The Administrator Telegram Bot is used for operational notifications to the site administrator, including WooCommerce order information. The Customer Telegram Bot is used for customer-facing notifications. Keeping them separate allows different message content, language settings, and configurations for administrators and customers.

يُستخدم بوت تيليجرام المشرف للإشعارات التشغيلية لمشرف الموقع، بما في ذلك معلومات طلبات WooCommerce. أما بوت تيليجرام العميل فيُستخدم للإشعارات الموجهة للعملاء. يتيح الفصل بينهما محتوى رسائل مختلفاً وإعدادات لغة مستقلة لكلٍّ من المشرف والعميل.

4. Does it work without WooCommerce?٤. هل تعمل الإضافة بدون WooCommerce؟

Yes. The floating WhatsApp button, WhatsApp contact form, and inline WhatsApp button shortcode can be used without WooCommerce. WooCommerce is required only for WooCommerce order notifications.

نعم. يمكن استخدام زر WhatsApp العائم ونموذج تواصل WhatsApp وزر WhatsApp المضمن بدون WooCommerce. ويُطلب WooCommerce فقط لتنبيهات طلبات WooCommerce.

5. Can I use it on multiple sites?٥. هل يمكن استخدامه على أكثر من موقع؟

Each license is domain-locked and intended for use on a single site. The plugin includes a server-side license verification system to control license activation. To move to another site, deactivate the license first from the License tab, then activate it on the new site.

كل ترخيص مرتبط بدومين واحد ومخصص لاستخدامه على موقع واحد. تتضمن الإضافة نظام التحقق من الترخيص على جانب السيرفر. للانتقال لموقع آخر، قم بإلغاء تفعيل الترخيص من تبويب License أولاً ثم فعّله على الموقع الجديد.

6. How do I activate the plugin license?٦. كيف أفعّل ترخيص الإضافة؟

License keys are issued manually after purchase. Contact us with your purchase order number by email at info@noor-dev.top or via Telegram. After receiving the key, enter it under WhatsApp Hub → License and click Activate License. The license is verified periodically every 7 days. If the license server is temporarily unavailable, a 3-day grace period applies.

يتم إصدار مفاتيح الترخيص يدوياً بعد الشراء. تواصل معنا وأرسل رقم طلب الشراء عبر البريد الإلكتروني info@noor-dev.top أو عبر Telegram. بعد استلام المفتاح، أدخله من WhatsApp Hub ← License واضغط على تفعيل الترخيص. يتم التحقق من الترخيص بشكل دوري كل 7 أيام. وإذا كان سيرفر التراخيص غير متاح مؤقتاً، توجد فترة سماح مدتها 3 أيام.

7. Does the plugin support Arabic?٧. هل الإضافة تدعم اللغة العربية؟

Yes. WhatsApp Business Hub Pro includes a full Arabic RTL administration interface with Cairo font support. The interface language follows the WordPress site language configuration where supported. Telegram notification messages can also be configured in Arabic or English independently.

نعم. تتضمن الإضافة واجهة إدارة عربية RTL كاملة مع دعم خط Cairo. تتبع لغة الواجهة إعداد لغة موقع ووردبريس حيثما كان ذلك مدعوماً. كما يمكن ضبط رسائل إشعارات تيليجرام باللغة العربية أو الإنجليزية بشكل مستقل.

8. Does the plugin support WooCommerce order notifications?٨. هل الإضافة تدعم إشعارات طلبات WooCommerce؟

Yes. When WooCommerce is installed and active, the plugin provides administrator and customer Telegram notifications for supported order events including Processing, Completed, and Cancelled.

نعم. عند تثبيت WooCommerce وتفعيله، توفر الإضافة إشعارات تيليجرام للمشرف والعميل لأحداث الطلبات المدعومة، بما فيها: قيد المعالجة، مكتمل، وملغى.

9. Can I customize the notification messages?٩. هل يمكنني تخصيص رسائل الإشعارات؟

Yes. WooCommerce notification templates can be customized for both English and Arabic independently. Templates support dynamic variables including: {order_id}, {customer}, {order_total}, {items}, {site_name}, and {date}.

نعم. يمكن تخصيص قوالب إشعارات WooCommerce بالعربية والإنجليزية بشكل مستقل. تدعم القوالب المتغيرات الديناميكية التالية: {order_id}، {customer}، {order_total}، {items}، {site_name}، و{date}.

10. Is an internet connection required?١٠. هل يُشترط وجود اتصال بالإنترنت؟

Yes. An active internet connection is required for Telegram API communication and online license activation and periodic verification.

نعم. يُشترط وجود اتصال نشط بالإنترنت للتواصل مع Telegram API وتفعيل الترخيص والتحقق منه دورياً.

11. Does the plugin provide a WhatsApp contact form?١١. هل توفر الإضافة نموذج تواصل واتساب؟

Yes. Add the contact form to any page using the shortcode:

نعم. أضف نموذج التواصل إلى أي صفحة باستخدام الاختصار:

[wbh_contact_form]

Visitors can enter their name, email address, and message, then open WhatsApp on their own device with the message prepared for sending.

يمكن للزوار إدخال اسمهم وبريدهم الإلكتروني ورسالتهم، ثم فتح واتساب على أجهزتهم مع الرسالة جاهزة للإرسال.

12. Can I add a WhatsApp button inside my content?١٢. هل يمكنني إضافة زر واتساب داخل المحتوى؟

Yes. Use the inline button shortcode:

نعم. استخدم اختصار الزر المضمّن:

[wbh_whatsapp_button]

This allows the WhatsApp button to be placed in any location where shortcodes are supported.

يتيح هذا الاختصار وضع زر واتساب في أي موقع يدعم الاختصارات.

13. Can I customize the floating WhatsApp button?١٣. هل يمكنني تخصيص زر واتساب العائم؟

Yes. The plugin provides controls for: button position (4 corners), custom button color, tooltip text, pulse animation, desktop and mobile visibility, and page exclusion by page ID.

نعم. توفر الإضافة خيارات تحكم في: موضع الزر (4 زوايا)، لون مخصص، نص تلميح، تأثير النبض، إظهار/إخفاء على الجوال والكمبيوتر، واستثناء صفحات بعينها عبر معرّف الصفحة.

Will this ban my WhatsApp account?هل الإضافة ستسبب حظر حساب واتساب؟

No. The plugin uses official wa.me links only — the same links WhatsApp provides for businesses. No unofficial API, no bulk sending.

لا. الإضافة تستخدم روابط wa.me الرسمية فقط — نفس الروابط اللي واتساب بيوفرها للشركات. لا API غير رسمي ولا رسائل جماعية.

I lost my license key. What do I do?فقدت مفتاح الترخيص — ماذا أفعل؟

If you lose your license key, contact support at info@noor-dev.top with your purchase order number. We will review the request and help you recover the key.

إذا فقدت مفتاح الترخيص، تواصل مع الدعم عبر info@noor-dev.top وأرسل رقم طلب الشراء. سنراجع الطلب ونساعدك في استعادة المفتاح.


📧

Supportالدعم الفني

📧

Get in touchتواصل معنا

Email: info@noor-dev.top  ·  Response:الرد: Support response time may vary depending on time zone and availability.قد يختلف وقت الرد على الدعم حسب فرق التوقيت والتوافر.

LinkedIn: ahmed-hamed-it  ·  Contact Pageصفحة التواصل

💬 Quick contact: Use the floating WhatsApp button on our website to chat with us directly on WhatsApp. تواصل سريع: استخدم زر واتساب العائم في موقعنا للتحدث معنا مباشرة على واتساب.

When contacting support, please include:عند التواصل، يرجى ذكر:

  • Your purchase order numberرقم طلب الشراء
  • Your website domainدومين الموقع
  • WordPress and PHP versionsإصدار WordPress وPHP
  • A clear description of the issue and any error messagesوصف واضح للمشكلة وأي رسائل خطأ