"""
Template tags pour le CMS.
Usage:
{% load cms_tags %}
{% get_setting 'site_email' as email %}
{% get_menu 'header' as nav %}
{% render_menu nav 'nav-class' %}
{% render_section section %}
{% setting_image 'logo' 'logo-class' 'Alt text' %}
"""
from django import template
from django.template.loader import render_to_string
from django.utils.safestring import mark_safe
from cms.context_processors import get_setting as _get_setting, get_menu as _get_menu
from cms.models import Page, Section, Setting, PageSection, PageSectionFieldValue
from traduction.helpers import prefetch_translations
register = template.Library()
# =============================================================================
# Tags pour les Settings
# =============================================================================
@register.simple_tag(takes_context=True)
def get_setting(context, slug, default=''):
"""
Recupere un parametre CMS par son slug.
Utilise la langue courante de la request.
Usage: {% get_setting 'site_email' as email %}
"""
# Recuperer le code de la langue courante
language_code = context.get('current_language_code')
if not language_code:
request = context.get('request')
if request:
language_code = getattr(request, 'current_language_code', None)
return _get_setting(slug, default, language_code=language_code)
@register.simple_tag
def setting_value(slug, default=''):
"""
Retourne la valeur brute d'un parametre (sans formatage).
Usage: {% setting_value 'phone' as phone %}
"""
try:
setting = Setting.objects.get(slug=slug)
return setting.get_raw_value() or default
except Setting.DoesNotExist:
return default
@register.simple_tag
def setting_image(slug, css_class='', alt=''):
"""
Affiche l'image d'un parametre.
Usage: {% setting_image 'logo' 'logo-class' 'Site Logo' %}
"""
try:
setting = Setting.objects.get(slug=slug)
if setting.image:
return mark_safe(
f'
'
)
except Setting.DoesNotExist:
pass
return ''
# =============================================================================
# Tags pour les Menus
# =============================================================================
@register.simple_tag(takes_context=True)
def get_menu(context, slug):
"""
Recupere un menu par son slug avec tous ses elements.
Utilise la langue courante de la request pour les traductions.
Usage: {% get_menu 'header' as nav %}
"""
# Recuperer le code de la langue courante
language_code = context.get('current_language_code')
if not language_code:
request = context.get('request')
if request:
language_code = getattr(request, 'current_language_code', None)
return _get_menu(slug, language_code=language_code)
@register.inclusion_tag('cms/tags/menu.html', takes_context=True)
def render_menu(context, menu, css_class='', item_class='', link_class=''):
"""
Affiche un menu complet avec ses elements imbriques.
Usage: {% render_menu header_menu 'nav-menu' 'nav-item' 'nav-link' %}
"""
if menu is None:
return {
'items': [],
'css_class': css_class,
'item_class': item_class,
'link_class': link_class,
}
return {
'menu': menu,
'items': menu.get_root_items(),
'css_class': css_class,
'item_class': item_class,
'link_class': link_class,
'request': context.get('request'),
}
@register.inclusion_tag('cms/tags/menu_items.html', takes_context=True)
def render_menu_items(context, items, item_class='', link_class='', depth=0):
"""
Affiche une liste d'elements de menu (recursif pour les sous-menus).
Usage: {% render_menu_items nav.get_root_items 'nav-item' 'nav-link' %}
"""
return {
'items': items,
'item_class': item_class,
'link_class': link_class,
'depth': depth,
'request': context.get('request'),
}
# =============================================================================
# Tags pour les Pages et Sections
# =============================================================================
@register.simple_tag(takes_context=True)
def get_page(context, slug):
"""
Recupere une page CMS par son slug.
Prefetch les traductions pour la langue courante.
Usage: {% get_page 'about' as about_page %}
"""
from traduction.helpers import prefetch_translations
try:
page = Page.objects.select_related('template').get(slug=slug, is_active=True)
# Recuperer le code de la langue courante
language_code = context.get('current_language_code')
if not language_code:
request = context.get('request')
if request:
language_code = getattr(request, 'current_language_code', None)
# Prefetch les traductions
prefetch_translations([page], language_code=language_code)
return page
except Page.DoesNotExist:
return None
@register.simple_tag(takes_context=True)
def get_homepage(context):
"""
Recupere la page d'accueil.
Prefetch les traductions pour la langue courante.
Usage: {% get_homepage as home %}
"""
from traduction.helpers import prefetch_translations
try:
page = Page.objects.select_related('template').get(is_homepage=True, is_active=True)
# Recuperer le code de la langue courante
language_code = context.get('current_language_code')
if not language_code:
request = context.get('request')
if request:
language_code = getattr(request, 'current_language_code', None)
# Prefetch les traductions
prefetch_translations([page], language_code=language_code)
return page
except Page.DoesNotExist:
return None
@register.inclusion_tag('cms/tags/section.html', takes_context=True)
def render_section(context, section, extra_class=''):
"""
Affiche une section en utilisant son template.
Usage: {% render_section section 'my-custom-class' %}
"""
return {
'section': section,
'extra_class': extra_class,
'request': context.get('request'),
}
@register.simple_tag(takes_context=True)
def include_section(context, section):
"""
Inclut le template d'une section directement.
Usage: {% include_section section %}
"""
if section and hasattr(section, 'get_template_path'):
try:
# Recuperer le code de langue
request = context.get('request')
language_code = None
if request:
language_code = getattr(request, 'current_language_code', None)
# Traduire la section
prefetch_translations([section], language_code=language_code)
# Construire le contexte en incluant le contexte parent
section_context = context.flatten()
section_context['section'] = section
return render_to_string(
section.get_template_path(),
section_context,
request=request
)
except Exception as e:
import logging
logger = logging.getLogger(__name__)
logger.error(f"Erreur inclusion section {section.name}: {e}")
return f''
return ''
# =============================================================================
# Tags pour les Menus - Helpers
# =============================================================================
@register.filter
def get_item(dictionary, key):
"""
Recupere une valeur dans un dictionnaire par cle.
Usage: {{ my_dict|get_item:key }}
"""
if dictionary is None:
return None
return dictionary.get(key)
@register.filter
def menu_item_attrs(item):
"""
Genere les attributs HTML pour un lien de menu.
Usage:
"""
attrs = []
if item.open_in_new_tab:
attrs.append('target="_blank"')
attrs.append('rel="noopener noreferrer"')
if item.has_children():
attrs.append('aria-haspopup="true"')
attrs.append('aria-expanded="false"')
return mark_safe(' '.join(attrs))
@register.filter
def split(value, separator=','):
"""
Divise une chaine en liste.
Usage:
{% for item in value|split %} {# par defaut: virgule #}
{% for item in value|split:" " %} {# par espace #}
"""
if value:
return [item.strip() for item in str(value).split(separator) if item.strip()]
return []
@register.simple_tag(takes_context=True)
def is_active_menu_item(context, item):
"""
Verifie si un element de menu correspond a la page courante.
Usage: {% is_active_menu_item item as is_active %}
"""
request = context.get('request')
if not request:
return False
current_path = request.path
item_url = item.get_url()
if item_url == current_path:
return True
# Verifie si le chemin courant commence par l'URL de l'item
if item_url and item_url != '/' and current_path.startswith(item_url):
return True
return False
@register.simple_tag(takes_context=True)
def menu_item_class(context, item, active_class='active', has_children_class='has-dropdown'):
"""
Retourne les classes CSS pour un element de menu.
Usage: