دردشة AJAX
الخامس 0.8.7 مستقل ( blueimp.net / اياكس / )
جدول المحتويات
متطلبات
تركيب
تكوين وتخصيص
سجلات
الخط الساخن
مقبس خادم
دعم
تبرع
ترخيص
هذه هي بذاتها نسخة من أجاكس الدردشة blueimp المصممة لتشغيل من تلقاء نفسه، دون تطبيق ويب آخر.
إذا كنت تريد دمج AJAX دردشة مع واحد من المنتديات التي ندعمها، نعود واختيار الإصدار الصحيح.
هذا الإصدار هو جيد لتخصيص التكامل الخاصة بك، أو استخدام من تلقاء نفسها.

أجاكس لتقف على "جافا سكريبت غير المتزامنة و XML".
يستخدم الدردشة العميل أجاكس (المتصفح) جافا سكريبت الاستعلام عن خادم الويب للحصول على التحديثات.
بدلا من تقديم صفحة HTML كاملة يتم إرسال البيانات المحدثة فقط في تنسيق XML.
باستخدام جافا سكريبت صفحة الدردشة يمكن تحديث دون الحاجة لإعادة تحميل الصفحة بأكملها.
يستخدم PHP للتواصل مع قاعدة البيانات ومصادقة المستخدمين.
متطلبات
خادم الجانبية   من جانب العميل
PHP> = 5
ماي> = 4
روبي> = 1.8 (اختياري)    تشغيل الجافا سكريبت
تمكين الكوكيز
فلاش البرنامج المساعد> = 9 (اختياري)
تركيب
تحميل الإصدار المفضل لديك من أجاكس الدردشة وبفك الملف على جهاز الكمبيوتر الخاص بك.
قبل أن تبدأ
من أجل تعديل ملفات PHP ستحتاج إلى محرر نص جيد. يجب عدم استخدام ويندوز المفكرة، الدفتر أو Microsoft Word لتحرير ملفات PHP. وستكون هذه البرامج تضيف شيئا يسمى ترتيب البايت علامة (BOM) إلى ملفات و هذا قد يمنع دردشة يعمل بشكل صحيح. نوصي باستخدام المفكرة + + ( http://notepad-plus-plus.org ) لتحرير كافة الملفات. كما أن لديها مصلحة لون الترميز ملفاتك حتى تتمكن من تحريرها بسهولة أكبر.
إذا كنت تحصل على رسالة خطأ مثل " لا يمكن تعديل معلومات رأس - رؤوس ارسلت بالفعل "فمن المحتمل أنك قد استخدمت أحد البرامج المذكورة أعلاه لتعديل الملفات.
تكوين إعدادات قاعدة بيانات
الشيء الأول والأكثر أهمية ما عليك فعله هو أن تخبر أجاكس الدردشة كيفية الاتصال إلى قاعدة البيانات. يجب أن يكون موجودا هذا، وجميع الإعدادات الأساسية داخل ملف ليب / ملف config.php . تحتاج إلى إنشاء هذا الملف. مثال ملف config.php يمكن العثور على الملف في ليب / config.php.example التي يتم شحنها مع الدردشة. تكرار هذا الملف وحفظه ك ملف config.php (أو مجرد حذف سبيل المثال من نهاية اسم الملف.) ثم ملء التالية على الأقل أربعة حقول في الملف:


$ التكوين ['dbConnection'] ['المضيف'] = your_database_hostname '؛
$ التكوين ['dbConnection'] ['المستخدم'] = your_database_username '؛
$ التكوين ['dbConnection'] ['تمرير'] = ' your_database_password ' ؛
$ التكوين ['dbConnection'] ['اسم'] = ' your_database_name '؛
يكفي أن أقول تحتاج هذه المعلومات. التحدث إلى مزود الاستضافة إذا كنت لا تعرف.
في معظم الحالات، سوف تعمل مع دردشة فقط هذه الحقول ملء ويمكنك المضي قدما إلى الخطوة التالية.
إذا لا يستخدم المضيف mysqli سوف تحتاج إلى تغيير حقل نوع الاتصال:
$ التكوين ['dbConnection'] ['نوع'] = فارغة؛
إذا تم تعيين هذا إلى "فارغة" الافتراضي إلى "mysqli" إذا القائمة، وإلا ل"الخلية". في معظم الحالات يمكن ترك هذا المجال لاغيا. يمكنك الرجوع صلة اتصال قاعدة بيانات موجودة أو كائن من خلال تغيير: $ التكوين ['dbConnection'] ['صلة'] = فارغة؛ إذا تم تعيين هذه لاغية، اتصال قاعدة بيانات جديدة تم إنشاؤه.



اختر إعدادات القناة الخاصة بك
تحرير ملف ليب / بيانات / channels.php.
قدمنا ​​لكم مع قناتين عينة، واسمه العام والخاص. . يمكنك إضافة الخاصة بك، أو ترك الأمر كما هو
القنوات اتبع الشكل التالي:
$ قنوات [
قناة معرف
] = '
اسم القناة
'؛
يجب أن يكون لكل قناة قناة رقم معرف فريد واسم فريد. مسافة بيضاء في أسماء قناة سيتم تحويلها إلى تسطير "_".

إضافة المستخدمين الخاصة بك
تحرير المستخدمين في ليب / بيانات / users.php .
متابعة المستخدمين على الشكل التالي:
$ مستخدمين [ هوية المستخدم ] = مجموعة ()؛
$ مستخدمين [ هوية المستخدم ] ['userRole'] = AJAX_CHAT_ROLE ؛
$ مستخدمين [ هوية المستخدم ] ['اسم المستخدم'] = اسم المستخدم '؛
$ مستخدمين [ هوية المستخدم ] [' كلمة '] =' كلمة السر للمستخدم '؛
$ مستخدمين [ هوية المستخدم ] ['قنوات'] = مجموعة ( يسمح هويات قناة )؛

. يجب أن يكون لكل مستخدم عدد هوية المستخدم فريدة من نوعها واسم فريد
للمستخدم الأول في القائمة (مستخدم معرف 0) يستخدم لإعدادات المستخدم الضيف. وسوف جميع مستخدمين الضيوف من الوصول إلى القنوات المحددة لهذا المستخدم ودور المستخدم AJAX_CHAT_GUEST.
يمكن للمستخدمين المسجلين لديها أدوار المستخدمين AJAX_CHAT_USER، AJAX_CHAT_MODERATOR أو AJAX_CHAT_ADMIN. (هذا هو حالة الأحرف، اكتب بالضبط)
قائمة القنوات مستخدم لديه حق الوصول إلى يمكن تعيين لكل مستخدم على حدة. يتم فصل هوية القناة بفواصل. على سبيل المثال: مجموعة (0،1،23)؛ يسمح قنوات 0، 1 و 23.
سيتم تحويل المسافات البيضاء في أسماء المستخدمين لتسطير "_".
تحميلها على الخادم الخاص بك
تحميل المجلد دردشة على الخادم الخاص بك في مكان ما في وثيقة الجذر:
مثل http://example.org/path/to/chat/
إنشاء جداول قاعدة البيانات
هناك نوعان من الخيارات المتاحة لك لإنشاء قاعدة البيانات. الأولى، وعادة ما يكون الخيار الأسهل، لتشغيل برنامج التثبيت النصي المضمنة مع أجاكس الدردشة. بدلا من ذلك، يمكنك استخدام أداة قاعدة بيانات مثل بريس لإنشاء الجداول يدويا.
لاستخدام برنامج التثبيت النصي، يمكنك زيارة الموقع التالي في المتصفح: http://example.org/path/to/chat/install.php أين "http://example.org/path/to/chat/" هو URL الحقيقي إلى دليل الدردشة.

لتثبيته يدويا باستخدام بريس أو أداة مماثلة، نسخ محتويات chat.sql الملف وتشغيله باعتباره والاستعلام.
أي من هذه الطرق سوف إنشاء الجداول يحتاج قاعدة البيانات لتخزين رسائل الدردشة وغيرها من المعلومات.
حذف برنامج التثبيت النصي
حذف ملف install.php من الدليل دردشة على الخادم الخاص بك. أيضا قد قمت بحذف الملف chat.sql .
Congradulation! هل أنت الفائز!
ياي! الانتهاء من ذلك! لاختبار الدردشة الخاصة بك، انتقل إلى URL دردشة في مستعرض: http://example.org/path/to/chat/index.php
أنت الآن حرة لتخصيص دردشة لمواصلة تناسب احتياجاتك.
تكوين وتخصيص
ملفات التكوين
أجاكس الدردشة تماما للتخصيص ويحتوي على اثنين من ملفات التكوين:
ليب / ملف config.php : يحتوي هذا الملف على خيارات التكوين الأساسية للدردشة. خيارات أساسية لتكوين قاعدة بيانات، والأمن، واللغات المتاحة، وغيرها، وجدت هنا.
شبيبة / config.js : هذا الملف يحتوي على إعدادات العميل أن تغيير الخيارات الافتراضية للمستخدمين الخاص بك في الدردشة. العديد من هذه الإعدادات يمكن تغييرها من قبل المستخدمين في خياراتهم ولكن ليس بعض (مثل معدل التحديث) يمكن.
وعلق كل من هذه الملفات بشكل جيد مع المعلومات حول ما يعني الإعدادات.
تخصيص تخطيط
تخطيط أجاكس الدردشة تماما للتخصيص باستخدام CSS (صفحات متعاقب النمط).
AJAX دردشة يأتي مع مجموعة محددة مسبقا من الأساليب. لإضافة نمط خاص بك، قم بما يلي:
إضافة ملف CSS جديد (على سبيل المثال mystyle.css) عن طريق نسخ واحدة من الأنماط الموجودة من الدليل CSS.
تعديل الملف الخاص بك (المغلق / mystyle.css) وضبط إعدادات CSS ترضيك.
إضافة اسم طريقتك بدون ملحق الملف إلى الأساليب المتاحة في ليب / ملف config.php:
/ / الأنماط المتوفرة:
$ التكوين ['styleAvailable'] = مجموعة ('mystyle'، 'البيج'، 'الأسود'، 'الرمادي' )؛
نمط / / الافتراضي:
$ التكوين ['styleDefault'] = 'mystyle'؛




لمزيد من تخصيص تخطيط يمكنك ضبط ملفات القالب في ليب / قالب /.
تأكد من أنك تقوم بإنشاء XHTML صالحة، وإلا سوف تنتج أخطاء في المتصفحات الحديثة.
ويرجع ذلك إلى صفحة المحتويات من نوع هذا بمثابة "التطبيق / XHTML + XML".
باستخدام هذا نوع المحتوى يحسن الأداء عند التعامل مع طراز كائن المستند ( DOM).
إذا كان لسبب لا يمكنك إنشاء XHTML صالحة يمكنك فرض HTML نوع المحتوى.
تحرير ليب فقط / ملف config.php وتعيين الخيار التالي:
$ التكوين ['contentType'] = 'نص / أتش تي أم أل "؛

ضبط إعدادات اللغة
أجاكس الدردشة يأتي مع اثنين من الدلائل ملف اللغة:
شبيبة / انج / : يحتوي هذا الدليل على ملفات اللغة المستخدمة لتوطين رسائل الدردشة. هذه هي ملفات جافا سكريبت مع التمديد ". شبيبة".
ليب / انج / : يحتوي هذا الدليل على ملفات اللغة المستخدمة لإخراج القالب. هذه هي ملفات PHP مع التمديد ". فب".
يتم تضمين العديد من اللغات بالفعل مع التحميل ويمكنك تخصيص لهم عن طريق تحرير هذه الملفات.
لكل لغة، تحتاج ملف في كل من هذه الدلائل، مع رمز اللغة كاسم ملف (مثل en.js وen.php) ..
ويستخدم رمز اللغة التالية معايير ISO 639.
ملفات للالإنكليزية (رمز اللغة "EN") هي التعريب شبيبة / انج / en.js و ليب / انج / en.php .
إذا قمت بإنشاء التوطين الخاصة بك، يجب وضع الملفات في المجلدات الصحيحة ثم قم بإجراء تغييرين لملف config.php:
إضافة رمز اللغة (. هذا يجب أن يطابق اسم الملف الذي اخترته للغة تذكر لاستخدام الفواصل بشكل صحيح لفصل رموز لغة متعددة):
$ التكوين ['langAvailable'] = مجموعة ('أون')؛

إضافة اسم اللغة (وهذا هو ما يراه المستخدمون في القائمة المنسدلة لاختيار اللغة):
$ التكوين ['langNames'] = مجموعة ('أون' => 'اللغة الإنجليزية')؛

لتجنب الأخطاء، يجب عليك اتباع هذه القواعد:
تأكد من تشفير الملفات الخاصة بك في توطين UTF-8 (بدون علامة ترتيب البايت).
لا تستخدم كيانات HTML في ملفات الترجمة الخاصة بك.
لا تقم بإزالة أي "٪ S" داخل ملفات اللغة جافا سكريبت - تمتلئ هذه مع البيانات الديناميكية.
مضيفا الميزات
تم تصميم AJAX الدردشة مع العديد من السنانير وتجاوزات المتاحة لتحسين الوظائف الأساسية دون الحاجة لك لتحرير الملفات الأساسية. مع ندرستادينغ المتوسطة من PHP وجافا سكريبت يمكنك تعديل دردشة لتلائم الاحتياجات الخاصة بك.
ننظر لها من خلال بعض الأمثلة المتاحة في ويكي: https://github.com/Frug/AJAX-Chat/wiki/General-modifications
سجلات
الوصول إلى السجلات
افتراضيا، دردشة AJAX بتخزين كافة رسائل الدردشة في قاعدة البيانات
للوصول إلى سجلات لديك لإضافة وجهة نظر المعلمة GET = سجلات لرابط الدردشة (إضافة عرض = سجلات إلى نهاية عنوان الموقع؟):
على سبيل المثال http://example.org/path/to/chat/؟view=logs
إذا كنت لا بالفعل تسجيل الدخول، لديك لتسجيل الدخول كمسؤول للوصول إلى السجلات.
وجهة نظر سجل تمكنك من مراقبة أحدث رسائل الدردشة على جميع القنوات.
ومن الممكن أيضا لعرض سجلات غرف خاصة ورسائل خاصة.
لديك الخيار لتحديد سجلات حسب التاريخ والوقت وسلاسل البحث.
مرشح بحث يقبل التعابير العادية نمط الخلية كما هو موضح هنا: http://dev.mysql.com/doc/refman/5.1/en/regexp.html
يمكنك البحث عن البرامج المتكاملة، وذلك باستخدام بناء الجملة التالي: IP = 127.0.0.1
الخط الساخن
أجاكس الدردشة هي أيضا قابلة للاستخدام كما الخط الساخن - وهذا هو دليل مختصر حول كيفية إعداده:
الخط الساخن الأنماط
أضف السطر التالي إلى أنماط (CSS) لجميع الصفحات التي تعرض الخط الساخن:
@ رابط الاستيراد ("http://example.org/path/to/chat/css/shoutbox.css")؛

استبدال http://example.org/path/to/chat/ مع عنوان URL للدردشة.
تعديل المغلق / shoutbox.css ترضيك.
الخط الساخن وظيفة
إضافة الدالة التالية إلى رمز PHP الخاصة بك:
<؟ فب
وظيفة getShoutBoxContent () {
/ / URL إلى الدليل دردشة:
إذا (! تعريف ('AJAX_CHAT_URL')) {
   تعريف ('AJAX_CHAT_URL'، '/ دردشة /.')؛
}

/ / مسار إلى دليل دردشة:
إذا (! تعريف ('AJAX_CHAT_PATH')) {
   تعريف ('AJAX_CHAT_PATH'، realpath (dirname (_SERVER $ ['SCRIPT_FILENAME']) '/ الدردشة') '/'.)؛
}

/ / التحقق من صحة المسار إلى الدردشة:
إذا كان (@ is_file (AJAX_CHAT_PATH. 'ليب / classes.php')) {
   
   / / وتشمل مكتبات الفئة:
   require_once (AJAX_CHAT_PATH. 'ليب / classes.php')؛
   
   / / تهيئة الخط الساخن:
   $ = ajaxChat CustomAJAXChatShoutBox جديدة ()؛
   
   / / تحليل والعودة محتوى القالب الخط الساخن:
   العودة $ ajaxChat-> getShoutBoxContent ()؛
}

العودة فارغة؛
}
؟>
تأكد AJAX_CHAT_URL ونقطة AJAX_CHAT_PATH إلى الدليل دردشة.
الخط الساخن الناتج
عرض المحتوى الخط الساخن باستخدام وظيفة الخط الساخن:
<div style="width:200px؛"> <فب صدى getShoutBoxContent ()؟؛ ؟> </ DIV>

مقبس خادم
باستخدام تكنولوجيا أجاكس وحده العملاء دردشة ديك لسحب التحديثات من الملقم بشكل دائم.
ويرجع ذلك إلى كونه AJAX تكنولوجيا الإنترنت وHTTP بروتوكول كونه عديم الجنسية.
دفعت الأحداث من جانب الخادم تحتاج إلى اتصال مأخذ دائمة أو طويلة الأمد بين العملاء والخادم.
هذا يتطلب إما خادم HTTP مخصص (وتسمى "المذنب") أو ملقم مأخذ مخصص آخر.
دردشة AJAX يستخدم جسرا جافا سكريبت لفلاش لتأسيس اتصال مأخذ دائم من جانب العميل.
الجسر جافا سكريبت لفلاش يتطلب البرنامج المساعد فلاش => 9 مثبتة على متصفح المستخدم.
سوف عملاء دون هذا الشرط يرتد إلى سحب الخادم للحصول على التحديثات.
هذا الجزء من الإعداد هو اختياري ويعني للمستخدمين ذوي الخبرة فقط.
تركيب
ويتم تنفيذ الخادم مأخذ القادمة مع أجاكس الدردشة في روبي.
عليك أن تكون قادرا على تشغيل برنامج نصي روبي كخدمة لتشغيل الخادم المقبس.
لتكون قادرة على بدء تشغيل الخدمة، ملفات البرامج النصية في مقبس / الدليل يجب أن تكون قابل للتنفيذ:
$ التصريح + X خادم
التصريح $ + س server.rb

"الخادم" هو السيناريو باش بسيطة لتشغيل وإيقاف الخدمة.
"server.rb" هو النصي الملقم مأخذ روبي.
"server.conf" هو ملف التكوين - ويفسر كل وضع مع تعليق.
لبدء تشغيل خدمة، تنفيذ "الخادم" النصي مع المعلمة "بداية":
$. بداية / الخادم

هذا سيخلق ملفين إضافية:
"server.pid" يحتوي على معرف العملية من الخدمة.
شغل "server.log" مع سجل خادم المقبس.
لمراقبة سجلات الخادم مأخذ، يمكنك استخدام "ذيل" القيادة المدرجة في معظم توزيعات جنو / لينكس:
$ الذيل و server.log

افتراضيا يتم تسجيل الأخطاء فقط وبدء / إيقاف الملقم.
للحصول على سجلات أكثر تفصيلا تكوين مستوى سجل عن طريق تحرير ملف التكوين.
لإيقاف الخدمة، تنفيذ "الخادم" النصي مع "وقف" المعلمة:
$. محطة / الخادم

إذا تم تشغيل الملقم مأخذ، لديك لتمكين الخيار التالي في ليب / ملف config.php:
$ التكوين ['socketServerEnabled'] = صحيح؛


هذا يحكي النصي دردشة من جانب الخادم إلى بث رسائل الدردشة عبر خادم المقبس.
دردشة عملاء سوف تأسيس اتصال دائم إلى خادم مأخذ للاستماع للرسائل الدردشة.
افتراضيا فقط العملاء المحليين (127.0.0.1، :: 1) قد بث الرسائل.
قد سمحت لعملاء بث رسائل أيضا التعامل مع المصادقة القناة.
إذا كان الملقم المقبس الخاص بك يعمل على مضيف آخر يجب عليك تعيين الخيار broadcast_clients إلى خدمة الدردشة IP .
باستخدام ملقم مأخذ يزيد وقت الاستجابة وتحسين أداء الخادم في نفس الوقت.
ضوابط فلاش
منذ 9.0.115.0 فلاش وجميع الإصدارات فلاش 10، تغيرت أذونات لإنشاء مآخذ باستخدام فلاش.
الآن على إذن صريح (باستخدام XML-جملة) مطلوب لإنشاء اتصالات مأخذ التوصيل.
وفي الحالة الراهنة، فإن الخادم المقبس لا تعمل مع أحدث إصدارات فلاش.
سوف تحصل على "خطأ أمان فلاش" في المستعرض.
والحل هو استخدام ملقم ملفات السياسة التي سيستمع إلى وصلات في الميناء 843 في الخادم.
في كل مرة يحاول عميل للاتصال دردشة، فإن العميل فلاش يطلب الإذن السياسة إلى الخادم.
خادم ملفات السياسة للتحميل من http://ammonlauritzen.com/FlashPolicyService-09b.zip
وهي تعمل مع وFF3 IE7 (لم تختبر بعد في المتصفحات الأخرى).
وثمة تفسير أكثر تفصيلا يمكن الاطلاع هنا:
* http://ammonlauritzen.com/blog/2007/12/13/new-flash-security-policies/
* http://ammonlauritzen.com/blog/2008/04/22/flash-policy-service-daemon/
أدوبي الرسمية الوثائق:
* http://www.adobe.com/devnet/flashplayer/articles/fplayer9_security.html
* http://www.adobe.com/devnet/flashplayer/articles/fplayer9_security_04.html
 
دعم
الرجاء عدم الكتابة في المشروعات الإنمائية مع أسئلة الدعم.
لمزيد من التوثيق وبعض الأمثلة، وتحقق من ويكي جيثب .
بالنسبة لمسائل الدعم العام استخدام مجموعة جوجل لدينا .
لتقارير الشوائب محددة وقائمة القضايا العالقة عرض المشروع جيثب لدينا .
تبرع
تسهم التبرعات لنمو وتطوير هذا المشروع وتحظى بتقدير دائما.
إرسال 
أنا على gittip في https://www.gittip.com/Frug
ترخيص
يتم تحريرها Bluimp في أجاكس الدردشة بموجب ترخيص معهد ماساتشوستس للتكنولوجيا التعديل.
يجب عليك أيضا العثور على هذا الترخيص المضمنة مع التحميل من هذا المشروع.