آموزش فارسی کردن پنل ادمین جنگو(Django)

جنگو چیست؟ و دلیل محبوبیتش چیه

جنگو (Django) یک فریم‌ورک وب سطح‌بالا بر پایهٔ پایتون است که بسیاری از قابلیت‌های حیاتی توسعهٔ وب مثل احراز هویت، ORM، مدیریت سشن، امنیت، قالب‌ها و حتی پنل مدیریت آماده را به‌صورت پیش‌فرض فراهم می‌کند.

محبوبیت جنگو فقط به‌خاطر سرعت شروع کار نیست؛ بلکه ترکیب ابزارهای یکپارچه، جامعهٔ فعال و مستندات کامل باعث شده انتخابی مطمئن برای پروژه‌های کوچک تا بزرگ و سازمانی باشد.

معماری داشبورد آن مبتنی بر الگوی MTV است و تمرکزش بر توسعهٔ سریع، نگه‌داری آسان و امنیت بالاست.

نتیجه این مزیت‌ها آن است که می‌توانید محصولی امن و قابل‌اعتماد را در زمان کوتاه‌تری به دست مشتری برسانید. در ادامهٔ مقاله، از همین قابلیت‌های داخلی برای فارسی‌سازی داشبورد بهره می‌بریم تا تجربهٔ کاربری بهتری برای مخاطبان فارسی‌زبان ایجاد کنیم.

چرا فارسی‌سازی داشبورد جنگو مهم است؟

کاربران نهایی که قرار است از این داشبورد استفاده کنند (مانند نویسندگان محتوا، مدیران محصول، پشتیبان‌ها و...) لزوماً تسلط کاملی به زبان انگلیسی ندارند.

از دیدگاه دیگر پنل ادمین، حیاتی‌ترین قسمت هر پروژه است. کوچکترین اشتباه در آن می‌تواند منجر به حذف داده‌ها یا تغییرات ناخواسته شود. برای جلوگیری از این خطاهای پرهزینه، کاربر ادمین باید به طور کامل بر محیط کار تسلط داشته باشد و هیچ ابهامی در معنی منوها، دکمه‌ها و پیغام‌ها وجود نداشته باشد.

استفاده از رابط کاربری به زبان فارسی مزایای زیادی دارد. این مزایا شامل افزایش رضایت کاربران، بهبود تجربه کاربری و کاهش اشتباه است.

📌 از دید کلی ارائه یک پنل مدیریت به زبانی غیر از فارسی، می‌تواند این تصور ناخواسته را ایجاد کند که توسعه‌دهنده به نیازهای بومی کاربران بی‌توجه بوده یا تجربه کافی در طراحی ندارد.

آموزش فارسی کردن پنل ادمین جنگو(Django)

خبر خوب این است که برای فارسی‌سازی پنل ادمین جنگو، اصلاً نیاز به اختراع دوباره چرخ نیست! فریم‌ورک قدرتمند جنگو به صورت داخلی از قابلیت بین‌المللی‌سازی پشتیبانی می‌کند.

جنگو دست شما را کاملاً باز گذاشته است؛ شما می‌توانید در جنگو همه بخش‌های پنل ادمین را به طور کامل فارسی کنید یا اینکه فقط چند بخش خاص را که برای کاربرانتان حیاتی است، ترجمه نمایید.

ما برای درک بهتر این فرآیند، فارسی‌سازی را به ۳ قسمت اصلی تقسیم‌بندی کرده‌ایم که در ادامه هر یک را به طور کامل مورد بررسی قرار می‌دهیم :

#settings.py

LANGUAGE_CODE = 'fa'

USE_I18N = True

#models.py

from django.db import models
from django.utils.translation import gettext_lazy as _
from django.core.validators import RegexValidator

phone_regex = RegexValidator(
	regex=r'^09d{9}$',
	message="شماره موبایل باید با 09 شروع شود و 11 رقم باشد."
)

class Customers(models.Model):
	phoneNumber = models.CharField(_("شماره موبایل"), max_length=11, validators=[phone_regex])
	name = models.CharField(_("نام مشتری"), max_length=155)
	status = models.CharField(_("وضعیت"), max_length=55)

#models.py

from django.db import models
from django.utils.translation import gettext_lazy as _
from django.core.validators import RegexValidator

phone_regex = RegexValidator(
	regex=r'^09d{9}$',
	message="شماره موبایل باید با 09 شروع شود و 11 رقم باشد."
)

class Customers(models.Model):
	phoneNumber = models.CharField(_("شماره موبایل"), max_length=11, validators=[phone_regex])
	name = models.CharField(_("نام مشتری"), max_length=155)
	status = models.CharField(_("وضعیت"), max_length=55)

	class Meta:
		verbose_name = _("مشتری")
		verbose_name_plural = _("مشتری‌ها")

در صورتی که تمام مراحل قبل را به درستی انجام داده باشید، در نهایت یک پنل مدیریت کاملاً فارسی‌شده مشابه تصویر زیر خواهید داشت.

اضافه کردن فایل های static سفارشی

گاهی نیاز دارید چیزی فراتر از پیش‌فرض‌ها بسازید: یک تم اختصاصی برای رابط کاربری، اسکریپتی برای یک رفتار تعاملی خاص، یا ست تصاویر و فونت‌ها برای هویت برند.

جنگو دست شما را باز گذاشته تا هرطور بخواهید ظاهر و رفتار پروژه‌تان را تغییر دهید. در ادامه، قدم‌به‌قدم یاد می‌دهیم چطور فایل‌های استاتیک سفارشی خود را اضافه و مدیریت کنید تا پروژه‌تان دقیقاً همان شکلی شود که می‌خواهید.

📌 لطفاً متن‌های این بخش را با دقت بخوانید و به آدرس‌ها و مسیرها دقیق توجه کنید؛ یک خطای کوچک در نام‌گذاری یا مسیر می‌تواند باعث شود فایل‌های استاتیک بارگذاری نشوند و کدتان کار نکند.

TEMPLATES = [
	{
		"BACKEND": "django.template.backends.django.DjangoTemplates",
		"DIRS": [BASE_DIR / "posts/templates"],   # <--- آدرس فولدر Templates در پروژه شما
		"APP_DIRS": True,
		"OPTIONS": {
			"context_processors": [
				"django.template.context_processors.debug",
				"django.template.context_processors.request",
				"django.contrib.auth.context_processors.auth",
				"django.contrib.messages.context_processors.messages",
			],
		},
	},
]

STATIC_URL = '/static/'
STATICFILES_DIRS = [BASE_DIR / "posts/static"]

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
	# ... بقیه‌ی url ها ...
]

if settings.DEBUG:
	urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

posts/
	templates/
		admin/
			base_site.html
	static/
		css/
			style.css
		js/
			myscript.js

{% extends "admin/base.html" %}
{% load static %}

{% block title %}تایتل جدید پنل ادمین جنگو{% endblock %}

{# --- اضافه کردن فایل css  --- #}
{% block extrastyle %}
	{{ block.super }}
	<link rel="stylesheet" href="{% static 'css/style.css' %}">
{% endblock %}

{# --- اضافه کردن فایل js در صورت نیاز --- #}
{% block extrahead %}
	{{ block.super }}
	<script src="{% static 'js/myscript.js' %}"></script>
{% endblock %}

جمع‌بندی فارسی کردن داشبورد جنگو

یک برنامه‌نویس حرفه‌ای باید توانایی بومی‌سازی و تغییر زبان را در انواع فریم‌ورک‌های مورد استفاده خود را داشته باشد

در این مقاله، به طور کامل و از تمام جنبه‌های ممکن، فرآیند فارسی‌سازی پنل ادمین جنگو را با هم مرور کردیم. از مقدمات گرفته تا اجرای گام‌به‌گام دستورات.

حالا نوبت شماست، الان شما این توانایی را دارید که با صرف کمی زمان، حرفه‌ای‌ترین و کاربرپسندترین پنل مدیریت ممکن را در اختیار کاربران خود قرار دهید.

در این آموزش سعی کردیم از تمام جهات موضوع فارسی‌سازی جنگو رو پوشش بدیم، اگر بخشی از آموزش برایتان مبهم بود، پرسش خود را به صورت تیکت باما در میان بگذارید.

سوالات متداول فارسی‌سازی جنگو

بخش سوالات متداول برای این طراحی شده تا به رایج‌ترین پرسش‌ها درباره فارسی‌سازی پنل ادمین جنگو پاسخ بدهد. مطالعه این قسمت می‌تواند جلوی بسیاری از خطاها را بگیرد و روند کارتان را سریع‌تر و مطمئن‌تر کند، پس با دقت ادامه دهید.