django-madval 0.0.1

A django package to use either persian numbers or comma separated persian numbers on djanog. Also can translating weekdays to persian.

django_madval

A django package to use either persian numbers or comma separated persian numbers on djanog. Also can translating weekdays to persian.

How to use? (چگونه استفاده کنیم؟)

To use this package, do the following

جهت استفاده از این پکیج، مراحل زیر را انجام دهید.

pip install django_madval

In the next step, install the app in your settings.py

در مرحله بعد، در فایل settings.py، اپ را اضافه کنید.

INSTALLED_APPS = [
    # ...
    'django_madval',
    # ...
]

Load madval_persian_translation file in your templates to use translation filters.

برای استفاده از تمپلیت فیلترهای مربوط به تبدیل اعداد به فارسی، فایل madval_persian_translation را لود کنید.

sample in a template file named order_detail.html:

...
{% load madval_persian_translation %}
...

Defined filters so far are "pn" "pnf" "cspn" "p_weekday"

pn stands for persian_numbers

pnf stands for persian_numbers_float

cspn stands for comma_separated_persian_numbers

p_weekday stands for persian_weekday

فیلترهای تعریف شده فعلی، "pn" "pnf" "cspn" "p_weekday" ها هستند.

sample usage in order_detail.html:

{{ order.phone_number|pn }}
{{ order.items.count|pn }}

جهت نمایش ارقام به فارسی و به صورت جدا نشده

---

{{ order.get_total_price|cspn }}

جهت نمایش ارقام به فارسی و ۳ رقم ۳ رقم جدا شده

---

در صورت نیاز می توانید به فیلتر "cspn" ورودی بدهید تا اعداد را به مقدار دلخواه شما جدا کند. مثلا کد زیر اعداد را ۵ رقم ۵ رقم جدا میکند.

{{ order.get_total_price|cspn:5 }}

---

در صورتی که روز هفته را به صورت میلادی (مثلا Tuesday یا Tue) دارید، می توانید با فیلتر p_weekday آن را به سه‌شنبه تبدیل کنید. در مثال زیر از پکیج جلالی نیز استفاده شده است که برای نصب آن باید به مستندات مربوطه مراجعه کنید.

{{ order.datetime_created|to_jalali:'%A'|p_weekday }}

پس از فیلتر "to_jalali:'%A'" که اسم روز هفته را گرفتیم، با استفاده از فیلتر "p_weekday" آن را به روز معادل فارسی تبدیل کردیم.