إعداد موقع إدارة Django

يوفر موقع إدارة جانغو واجهة قائمة على الويب للوصول إلى قاعدة البيانات المتصلة بمشروع Django. حتى بالنسبة للمدراء ذوي الخبرة، قد يكون إجراء عمليات قاعدة البيانات CRUD (إنشاء وقراءة وتحديث وحذف) مباشرة على قاعدة بيانات أمرًا صعبًا ويستغرق وقتًا طويلاً، نظرًا للحاجة إلى إصدار أوامر SQL أولية والتنقل في هياكل قاعدة البيانات.

أما بالنسبة للمدراء منعدمي الخبرة قد يكون إجراء عمليات CRUD لقاعدة البيانات مباشرة على قاعدة بيانات أمرًا شاقًا، إن لم يكن مستحيلًا. و لهذا يعمل موقع إدارة جانغو على إصلاح هذه المشكلة.

يمكن لموقع إدارة جانغو أن يعرض جميع هياكل البيانات المتعلقة بمشروع Django المرتبطة بقاعدة بيانات، لذلك من السهل على الخبراء والمبتدئين على حد سواء إجراء عمليات CRUD لقاعدة البيانات.

مع نمو مشروع جانغو، يمكن أن يكون موقع إدارة Django أداة حيوية لإدارة الكم المتزايد من المعلومات في قاعدة البيانات المتصلة بمشروع Django.

تثبيت و إعداد تطبيق موقع إدارة Django

افتراضيًا، يتم تفعيل موقع إدارة جانغو في جميع مشاريع Django. حيث إذا قمت بفتح ملف urls.py لمشروع جانغو، سترى متغير urlpatterns يحتوي على مسار لواجهة إدارة الموقع ('admin/'، admin.site.urls).

يخبر تعريف هذا المسار Django بتفعيل تطبيق موقع الإدارة على دليل /admin/ url (على سبيل المثال http://127.0.0.1:8000/admin/).

كما يمكنك فتح ملف settings.py الخاص بالمشروع ثم انتقل إلى المتغير INSTALLED_APPS. سترى أيضًا السطر django.contrib.admin و الذي يشير إلى تفعيل تطبيق موقع الإدارة لجانغو.

قم بتشغيل خادم الويب للتطوير عن طريق تنفيذ الامر python manager.py runserver. قم افتح المتصفح على الرابط التالي: http://127.0.0.1:8000/admin. ستشاهد شاشة تسجيل الدخول كما في الصورة الموالية:

واجهة موقع إدارة جانغو

بعد ذلك، لنقم بإنشاء مستخدم جانغو برتبة مسؤول للوصول إلى واجهة الإدارة. و لإنشاء مستخدم برتبة مسؤول في Django يمكنك استخدام الأمر createuperuser.

[user@pyarabic ~]$ python manage.py createsuperuser
Username (leave blank to use 'admin'): 
Email address: admin@pyarabic.com
Password: 
Password (again): 
The password is too similar to the email address.
This password is too short. It must contain at least 8 characters.
This password is too common.
Bypass password validation and create user anyway? [y/N]:
Password: 
Password (again): 
Superuser created successfully.

تقوم هذه العملية الأخيرة بإنشاء مستخدم برتبة مسؤول يتم تخزين معلوماته في قاعدة البيانات تحديدا في جدول auth_user.

يمكنك تحديث اسم المستخدم أو كلمة المرور أو البريد الإلكتروني لهذا المستخدم؟ من خلال الانتقال مباشرة إلى جدول قاعدة البيانات وإجراء التحديثات، إلا أنه توجد طريقة أخرى سهلة و أفضل و هي الاعتماد على الواجهة الرسومية للإدارة التي تمنحك رؤية سهلة للغاية لجداول قاعدة البيانات الموجودة في مشروع Django الخاص بك.

أدخل اسم المستخدم وكلمة المرور للمستخدم المسؤول الذي قمت بإنشائه حتى تتمكن من الوصول إلى الصفحة الرئيسية لموقع الإدارة.

واجهة موقع إدارة جانغو

في الصفحة الرئيسية لموقع إدارة Django انقر فوق الرابط “المستخدمون”. و سترى قائمة بالمستخدمين الذين لديهم حق الوصول إلى جانغو. في الوقت الحالي، لن ترى سوى المستخدم المسؤول الذي قمت بإنشائه في الخطوة السابقة.

يمكنك تغيير بيانات اعتماد هذا المستخدم (مثل كلمة المرور أو البريد الإلكتروني أو اسم المستخدم) أو إضافة مستخدمين جدد مباشرة من شاشة موقع إدارة جانغو.

هذه المرونة في تعديل أو إضافة السجلات المخزنة في قاعدة بيانات هي ما يجعل موقع إدارة Django قوي للغاية. على سبيل المثال، إذا قمت بتطوير مشروع مقهى وأضفت تطبيقات مثل المتاجر أو المشروبات أو العملاء، فيمكن للمستخدمين المعتمدين من قبل مسؤول Django إجراء عمليات CRUD على هذه الكائنات (إنشاء متاجر، تحديث المشروبات، حذف العملاء).

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

إعداد وتثبيت تطبيق مستندات موقع مسؤول Django

يحتوي موقع إدارة Django على تطبيق التوثيق الخاص به. لا يوفر تطبيق توثيق موقع إدارة Django معلومات حول تشغيل موقع الإدارة نفسه فحسب، بل يتضمن أيضًا وثائق عامة أخرى حول مرشحات لقوالب Django. والأهم من ذلك، أن تطبيق توثيق موقع مسؤول Django يستكشف الكود المصدري لجميع تطبيقات المشاريع المثبتة لتقديم وثائق حول أساليب وحدة التحكم وكائنات النماذج (أي الوثائق المضمنة في الكود المصدري لملفات application.py وmodels.py).

لتثبيت تطبيق توثيق موقع مسؤول Django، تحتاج أولاً إلى تثبيت حزمة docutils Python مع قيام مدير حزمة pip بتنفيذ الأمر التالي:

python3 -m pip install docutils

بمجرد تثبيت حزمة docutils، يمكنك المتابعة لتثبيت تطبيق توثيق موقع مسؤول جانغو كأي تطبيق آخر.

يجب عليك أولاً إضافة عنوان url للوصول إلى تطبيق وثائق موقع مسؤول Django. افتح ملف urls.py الخاص بالمشروع وأضف الأسطر التالية:

from django.contrib import admin
from django.urls import path, include
from django.views.generic import TemplateView
from coffeehouse.about import views as about_views

urlpatterns = [
    path('',TemplateView.as_view(template_name='homepage.html')),
    path('about/', about_views.contact),
    path('admin/doc/', include('django.contrib.admindocs.urls')),    
    path('admin/', admin.site.urls),
]

يضيف السطر الأول التابع  include إلى عبارة  import من حزمة django.urls، وهو أمر ضروري لتحميل عناوين url المدمجة من تطبيق وثائق موقع المسؤول. بعد ذلك، داخل قائمة urlpatterns يوجد المسار "admin/doc/" الذي يخبر Django بتمكين تطبيق توثيق موقع المسؤول على عنوان http://127.0.0.1:8000/admin/doc/.

بعد ذلك، افتح ملف settings.py وانتقل إلى المتغير INSTALLED_APPS. و أضف السطر django.contrib.admindocs لتفعيل تطبيق وثائق موقع مسؤول Django.

قم بتشغيل خادم الويب التطويري. افتح المتصفح على العنوان http://127.0.0.1:8000/admin/doc/ وسترى صفحة مثل :

الصفحة الرئيسية لموقع إوثائق دارة جانغو

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

اترك تعليقاً

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *

اكتشاف المزيد من بايثون العربي

اشترك الآن للاستمرار في القراءة والحصول على حق الوصول إلى الأرشيف الكامل.

Continue reading

Scroll to Top