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 complete WordPress plugin that connects your website to WhatsApp professionally — floating button, contact form, WooCommerce order notifications, and Telegram alerts, all in one plugin.

WhatsApp Business Hub Pro هي إضافة WordPress تجارية متكاملة تربط موقعك بواتساب بشكل احترافي. زر عائم، نموذج تواصل، إشعارات WooCommerce وتيليجرام — كل ده في إضافة واحدة.

💬

Floating Buttonزر واتساب عائم

Appears on all pages with pulse animation and full customization

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

🔔

Instant Alertsإشعارات فورية

Receive every new order on Telegram or WhatsApp instantly

استقبل كل طلب جديد على تيليجرام أو واتساب فوراً

🛒

WooCommerce

Automatic notifications for every order status change

إشعارات تلقائية لكل حالة طلب للعميل والأدمن

🌐

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مطلوب للترخيص وإشعارات تيليجرام

📦

Installationالتثبيت

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

  1. After purchasing from Codester, download whatsapp-business-hub.zipبعد الشراء من Codester، حمّل ملف 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تفعيل الترخيص

A license is required to unlock all plugin features. Each license works on one site only.

الترخيص مطلوب لتفعيل جميع ميزات الإضافة. كل ترخيص يعمل على موقع واحد فقط.

  1. Go to WhatsApp Hub → License in the admin panelاذهب إلى WhatsApp Hub ← License في لوحة التحكم
  2. Enter your license key in format WBH-XXXX-XXXX-XXXXأدخل مفتاح الترخيص بصيغة WBH-XXXX-XXXX-XXXX
  3. Click Activate — the server verifies automaticallyاضغط تفعيل — السيرفر يتحقق تلقائياً
  4. After activation, all tabs become availableبعد التفعيل ستظهر جميع التبويبات
License auto-renews every 7 days. If the server is unavailable, a 3-day grace period applies.الترخيص يتجدد تلقائياً كل 7 أيام. لو السيرفر مش متاح يوجد grace period مدته 3 أيام.

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

Go to the License tab, click Deactivate, then activate on the new site.

اذهب لتبويب 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

Instant notifications — best for real-time monitoring. Supports custom templates.

إشعارات فورية — الأفضل للمتابعة اللحظية. يدعم قوالب مخصصة.

📱

WhatsApp

Logs a wa.me link in the notification log for manual follow-up.

يسجل رابط wa.me في سجل الإشعارات للمتابعة اليدوية.


🛒

WooCommerceWooCommerce Pro

EventالحدثSent toيُرسل لـDescriptionالوصف
New orderطلب جديدAdminالمشرفInstant alert for every new orderإشعار فوري بكل طلب جديد
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 own device, where the visitor can review and send the message themselves. Automated notifications are handled through Telegram.

لا. لا ترسل الإضافة رسائل واتساب تلقائية. تستخدم الإضافة روابط wa.me الرسمية لفتح واتساب على جهاز الزائر، حيث يمكنه مراجعة الرسالة وإرسالها بنفسه. الإشعارات التلقائية تتم عبر تيليجرام.

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

No. The customer links their Telegram account once through the WooCommerce Thank You page or My Account area. After that, supported future order status notifications are sent automatically through the Customer Telegram Bot. The system supports both registered customers and guests.

لا. يربط العميل حساب تيليجرام الخاص به مرة واحدة فقط من خلال صفحة شكراً لك في 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 on standard WordPress websites without WooCommerce. WooCommerce is required only for order notifications and customer order notifications.

نعم. يمكن استخدام زر واتساب العائم ونموذج التواصل واختصار الزر المضمّن على مواقع ووردبريس العادية بدون 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?٦. كيف أفعّل ترخيص الإضافة؟

After purchasing the plugin on Codester, use the Codester messaging or support system to request your license key. After receiving the key, go to WhatsApp Hub → License, enter the license key, and click Activate License.

بعد شراء الإضافة على Codester، استخدم نظام الرسائل أو الدعم في Codester لطلب مفتاح الترخيص. بعد استلامه، اذهب إلى WhatsApp Hub → License، أدخل المفتاح، واضغط Activate License.

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?فقدت مفتاح الترخيص — ماذا أفعل؟

Contact support at info@noor-dev.top with your Codester order number and we'll resend it.

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



📧

Supportالدعم الفني

📧

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

Email: info@noor-dev.top  ·  Response:الرد: within 24 hoursخلال 24 ساعة

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 Codester order numberرقم طلب الشراء من Codester
  • WordPress and PHP versionsنسخة ووردبريس وPHP
  • Detailed description and any error messagesوصف المشكلة بالتفصيل وأي رسائل خطأ