Manual:Pywikibot/login.py/ar

login.py هو برنامج بايثون يقوم بتسجيل المستخدم الذي يعمل على باي ويكي بوت على النظام الذي يستخدم البيانات والذي يمكن إيجاده في .

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

كيف يعلم أين يسجل الدخول
في ملف user-config.py يوجد ثلاثة مكونات:


 * 1) اللغة: mylang
 * 2) العائلة: family - هذا يشير إلى اسم الويكي، متضمنًا wikipedia أو wiktionary
 * 3) اسم المستخدم: username - يمكن لهذا أن يكون أي مستخدم ولكن ينبغي أن يكون المستخدم المسجل ليعمل بصفته بوت.

حتى تتمكن من تسجيل الدخول إلى جميع المشروعات أو اللغات المذكورة في user-config.py، خيار  يمكن استخدامه، وإن كانت نفس كلمة المرور مستخدمة عبر تلك المشروعات، يمكن دمجها باستخدام   حتى لا يطلب البرنامج لكلمة المرور لكل موقع.

سيسجل الدخول على كل المشروعات في user-config.py، باستخدام نفس كلمة المرور للجميع. حتى الآن، استخدام خيار -pass ليس مدعومًا. (T102477) ينبغي أن تستخدم بدلاً منه password file. قم بإنشاء ملف به نص مثل '("en", "wikipedia", "User", "password")' (يمكنك استخدام أكثر من سطر). ثم، قم بإدخال سطر 'password_file = "path_to_password_file"' في ملف user-config.py الخاص بك. بعد هذا ينبغي أن يستخدم باي ويكي بوت البيانات من هذا الملف حينما يحتاج إلى تسجيل الدخول.

تسجيل الدخول باستخدام أوث
يدعم باي ويكي بوت تسجيل الدخول باستخدام تصديق أوث (OAuth) بدلاً من كلمة المرور. ميزة أوث تحتاج أن يكون مثبتًا على الموقع ومُعدًا بشكل صحيح. أوث أكثر أمانًا (كلمات المرور لا تُرسَل عبر الإنترنت، ويمكن إبطالها في أي وقت، وصلاحيات مستخدم البوت يمكن حظرها) وينبغي عامةً أن يكون مُفضلاً على تسجيل الدخول العادي. انظر لكيفية استخدامه (لا يتضمن login.py).

إن كنت تريد لأي سبب من الأسباب تسجيل الدخول بالتوب في تطبيق أوث متعدد المستخدمين (ليس مستحسنًا، ولكن مثلاً ميدياويكي القديمة قد لا تدعم التطبيقات ذات المالك فقط)، يمكن استخدام login.py لذلك، باستخدام خيار. تتضمن العملية الخطوات التالية:


 * 1) قم بإنشاء تطبيق أوث في  على ميتا إن لم تكن موجودة بعد، وقم بتسجيل مفتاح المستهلك والسر
 * 2) قم بتشغيل
 * 3) قم بإدخال مفتاح المستهلك لأوث
 * 4) قم بإدخال سر المستهلك لأوث
 * 5) قم بتوثيق المستخدم عبر متصفح الويب. قد تحتاج إلى نسخ المسار يدويًا من الطرفية إن كان المتصفح لا يفتح تلقائيًا.
 * 6) قم بإدخال نص استعلام استجابة إلى الطرفية عند نجاح التوثيق. مثلاً: oauth_verifier=xxx&oauth_token=yyy
 * 7) قم بنسخ ولصق مدخل التوثيق المُولَّد في .