MAINHACK

Viewing / Editing File: whatsapp_setup.php

<?php
/**
 * WhatsApp Setup Documentation Page
 * This page provides instructions on how to set up WhatsApp API integration
 */

require_once '../config/config.php';
requireLogin('admin');

$page_title = 'إعداد واتساب';
include '../includes/header.php';
?>

<div class="container-fluid">
    <div class="row">
        
        <div class="col-lg-3 col-md-4 sidebar p-0">
            <div class="d-flex flex-column h-100">
                <div class="p-3 text-white">
                    <h4 class="mb-0">
                        <i class="fas fa-user-shield me-2"></i>
                        لوحة المدير
                    </h4>
                    <small>مرحباً <?php echo $_SESSION['admin_username']; ?></small>
                </div>
                
                <nav class="nav nav-pills flex-column p-3">
                    <a class="nav-link" href="dashboard.php">
                        <i class="fas fa-tachometer-alt me-2"></i>الرئيسية
                    </a>
                    <a class="nav-link" href="stages.php">
                        <i class="fas fa-layer-group me-2"></i>المراحل الدراسية
                    </a>
                    <a class="nav-link" href="grades.php">
                        <i class="fas fa-graduation-cap me-2"></i>الصفوف الدراسية
                    </a>
                    <a class="nav-link" href="subjects.php">
                        <i class="fas fa-book me-2"></i>المواد الدراسية
                    </a>
                    <a class="nav-link" href="teachers.php">
                        <i class="fas fa-chalkboard-teacher me-2"></i>إدارة المعلمين
                    </a>
                    <a class="nav-link active" href="whatsapp_setup.php">
                        <i class="fab fa-whatsapp me-2"></i>إعداد واتساب
                    </a>
                    <div class="mt-auto">
                        <a class="nav-link text-light" href="../logout.php">
                            <i class="fas fa-sign-out-alt me-2"></i>تسجيل الخروج
                        </a>
                    </div>
                </nav>
            </div>
        </div>
        
        
        <div class="col-lg-9 col-md-8 main-content p-4">
            <div class="d-flex justify-content-between align-items-center mb-4">
                <h2>
                    <i class="fab fa-whatsapp me-2 text-success"></i>
                    إعداد واتساب
                </h2>
            </div>
            
            
            <div class="row mb-4">
                <div class="col-md-6">
                    <div class="card">
                        <div class="card-header bg-success text-white">
                            <h5 class="mb-0">حالة الاتصال</h5>
                        </div>
                        <div class="card-body">
                            <?php if (empty(WHATSAPP_TOKEN)): ?>
                                <div class="alert alert-warning">
                                    <i class="fas fa-exclamation-triangle me-2"></i>
                                    لم يتم تكوين واتساب بعد
                                </div>
                                <p class="text-muted">يرجى اتباع التعليمات أدناه لإعداد واتساب</p>
                            <?php else: ?>
                                <div class="alert alert-success">
                                    <i class="fas fa-check-circle me-2"></i>
                                    تم تكوين واتساب بنجاح
                                </div>
                                <p class="text-muted">النظام جاهز لإرسال رسائل واتساب</p>
                            <?php endif; ?>
                        </div>
                    </div>
                </div>
            </div>
            
            
            <div class="card mb-4">
                <div class="card-header">
                    <h5 class="mb-0">
                        <i class="fas fa-book me-2"></i>
                        دليل إعداد واتساب API
                    </h5>
                </div>
                <div class="card-body">
                    <h6 class="text-primary">الخطوة 1: اختيار مزود خدمة واتساب API</h6>
                    <p>يمكنك استخدام أحد المزودين التاليين:</p>
                    <ul>
                        <li><strong>WhatsApp Business API</strong> - الحل الرسمي من فيسبوك</li>
                        <li><strong>Twilio</strong> - <code>https://www.twilio.com/whatsapp</code></li>
                        <li><strong>MessageBird</strong> - <code>https://messagebird.com/whatsapp</code></li>
                        <li><strong>360Dialog</strong> - <code>https://www.360dialog.com</code></li>
                    </ul>
                    
                    <hr>
                    
                    <h6 class="text-primary">الخطوة 2: إنشاء حساب والحصول على API Token</h6>
                    <ol>
                        <li>قم بالتسجيل في الموقع المختار</li>
                        <li>أنشئ تطبيق واتساب جديد</li>
                        <li>احصل على رقم الهاتف المخصص للواتساب</li>
                        <li>انسخ الـ API Token من لوحة التحكم</li>
                    </ol>
                    
                    <hr>
                    
                    <h6 class="text-primary">الخطوة 3: إضافة Token إلى النظام</h6>
                    <p>افتح ملف <code>config/config.php</code> وقم بتعديل السطر التالي:</p>
                    
                    <div class="bg-light p-3 rounded">
                        <code>
                            // قبل التعديل<br>
                            define('WHATSAPP_TOKEN', '');<br><br>
                            
                            // بعد التعديل<br>
                            define('WHATSAPP_TOKEN', 'your_api_token_here');
                        </code>
                    </div>
                    
                    <hr>
                    
                    <h6 class="text-primary">الخطوة 4: تخصيص API URL (اختياري)</h6>
                    <p>إذا كنت تستخدم مزود خدمة مختلف، قم بتعديل URL في نفس الملف:</p>
                    
                    <div class="bg-light p-3 rounded">
                        <code>
                            define('WHATSAPP_API_URL', 'https://your-provider-api-url.com/messages');
                        </code>
                    </div>
                </div>
            </div>
            
            
            <div class="card mb-4">
                <div class="card-header">
                    <h5 class="mb-0">
                        <i class="fas fa-code me-2"></i>
                        أمثلة برمجية
                    </h5>
                </div>
                <div class="card-body">
                    <h6 class="text-primary">مثال لإرسال رسالة باستخدام Twilio:</h6>
                    
                    <pre class="bg-dark text-light p-3 rounded"><code><?php echo htmlspecialchars('
function sendWhatsAppMessage($phone, $message) {
    $accountSid = "YOUR_TWILIO_ACCOUNT_SID";
    $authToken = "YOUR_TWILIO_AUTH_TOKEN";
    $twilioNumber = "whatsapp:+14155238886"; // Twilio Sandbox number
    
    $url = "https://api.twilio.com/2010-04-01/Accounts/$accountSid/Messages.json";
    
    $data = array(
        "From" => $twilioNumber,
        "To" => "whatsapp:+$phone",
        "Body" => $message
    );
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
    curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC);
    curl_setopt($ch, CURLOPT_USERPWD, "$accountSid:$authToken");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $result = curl_exec($ch);
    curl_close($ch);
    
    return $result;
}'); ?></code></pre>
                    
                    <hr>
                    
                    <h6 class="text-primary">مثال لإرسال رسالة باستخدام 360Dialog:</h6>
                    
                    <pre class="bg-dark text-light p-3 rounded"><code><?php echo htmlspecialchars('
function sendWhatsAppMessage($phone, $message) {
    $apiKey = "YOUR_360DIALOG_API_KEY";
    $url = "https://waba.360dialog.io/v1/messages";
    
    $data = array(
        "recipient_type" => "individual",
        "to" => $phone,
        "type" => "text",
        "text" => array("body" => $message)
    );
    
    $headers = array(
        "Content-Type: application/json",
        "D360-API-KEY: $apiKey"
    );
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    
    $result = curl_exec($ch);
    curl_close($ch);
    
    return $result;
}'); ?></code></pre>
                </div>
            </div>
            
            
            <div class="card">
                <div class="card-header">
                    <h5 class="mb-0">
                        <i class="fas fa-test-tube me-2"></i>
                        اختبار الإعداد
                    </h5>
                </div>
                <div class="card-body">
                    <?php if (!empty(WHATSAPP_TOKEN)): ?>
                        <form id="testWhatsAppForm">
                            <div class="row">
                                <div class="col-md-6 mb-3">
                                    <label for="testPhone" class="form-label">رقم الهاتف للاختبار</label>
                                    <input type="tel" class="form-control" id="testPhone" name="phone" 
                                           placeholder="مثال: 201234567890" required>
                                </div>
                                <div class="col-md-6 mb-3">
                                    <label for="testMessage" class="form-label">رسالة الاختبار</label>
                                    <input type="text" class="form-control" id="testMessage" name="message" 
                                           value="رسالة اختبار من نظام إدارة الحضور" required>
                                </div>
                            </div>
                            <button type="submit" class="btn btn-success">
                                <i class="fab fa-whatsapp me-2"></i>إرسال رسالة اختبار
                            </button>
                        </form>
                        
                        <div id="testResult" class="mt-3"></div>
                    <?php else: ?>
                        <div class="alert alert-info">
                            <i class="fas fa-info-circle me-2"></i>
                            يرجى إعداد واتساب أولاً لتتمكن من اختبار الإعداد
                        </div>
                    <?php endif; ?>
                </div>
            </div>
        </div>
    </div>
</div>

<?php include '../includes/footer.php'; ?>

Cancel / Back

[ MAINHACK ]

Viewing / Editing File: whatsapp_setup.php

Server Info

System Features

User Info