1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
"""
Extend or modify the navigation with custom entries.
This extension allows the website administrator to select an extension
which processes, modifies or adds subnavigation entries. The bundled
``feincms_nav`` template tag knows how to collect navigation entries,
be they real Page instances or extended navigation entries.
"""
from django.db import models
from django.utils.translation import ugettext_lazy as _
from feincms.utils import get_object
from feincms._internal import monkeypatch_method
class TypeRegistryMetaClass(type):
"""
You can access the list of subclasses as <BaseClass>.types
"""
def __init__(cls, name, bases, attrs):
if not hasattr(cls, 'types'):
cls.types = []
else:
cls.types.append(cls)
class PagePretender(object):
"""
A PagePretender pretends to be a page, but in reality is just a shim layer
that implements enough functionality to inject fake pages eg. into the
navigation tree.
For use as fake navigation page, you should at least define the following
parameters on creation: title, url, level. If using the translation extension,
also add language.
"""
# emulate mptt properties to get the template tags working
class _mptt_meta:
level_attr = 'level'
def __init__(self, **kwargs):
for k, v in kwargs.items():
setattr(self, k, v)
def get_absolute_url(self):
return self.url
def get_navigation_url(self):
return self.get_absolute_url()
def get_level(self):
return self.level
def get_children(self):
return []
def available_translations(self):
return ()
def get_original_translation(self, page):
return page
class NavigationExtension(object):
"""
Base class for all navigation extensions.
The name attribute is shown to the website administrator.
"""
__metaclass__ = TypeRegistryMetaClass
name = _('navigation extension')
def children(self, page, **kwargs):
"""
This is the method which must be overridden in every navigation extension.
It receives the page the extension is attached to, the depth up to which
the navigation should be resolved, and the current request object if it
is available.
"""
raise NotImplementedError
def navigation_extension_choices():
for ext in NavigationExtension.types:
yield ('%s.%s' % (ext.__module__, ext.__name__), ext.name)
def register(cls, admin_cls):
cls.add_to_class('navigation_extension', models.CharField(_('navigation extension'),
choices=navigation_extension_choices(), blank=True, null=True, max_length=200,
help_text=_('Select the module providing subpages for this page if you need to customize the navigation.')))
@monkeypatch_method(cls)
def extended_navigation(self, **kwargs):
if not self.navigation_extension:
return self.children.in_navigation()
cls = get_object(self.navigation_extension, fail_silently=True)
if not cls or not callable(cls):
return self.children.in_navigation()
return cls().children(self, **kwargs)
admin_cls.fieldsets.append((_('Navigation extension'), {
'fields': ('navigation_extension',),
'classes': ('collapse',),
}))
|
