django-mobileadmin 0.5.2

下载 & 安装

从应用程序网站获取源代码

http://code.google.com/p/django-mobileadmin/

要安装 mobileadmin，请按照以下步骤操作

1. 遵循 INSTALL.txt 文件中的说明

2. 将 'mobileadmin' 添加到您的Django站点 INSTALLED_APPS 设置中。它可能看起来像这样

   INSTALLED_APPS = (
      # ...
      'mobileadmin',
   )

3. 确保您已安装了管理贡献应用。

4. 将 'mobileadmin.context_processors.user_agent' 添加到您的 TEMPLATE_CONTEXT_PROCESSORS 设置中。它应该看起来像这样

   TEMPLATE_CONTEXT_PROCESSORS = (
      'django.core.context_processors.auth',
      'django.core.context_processors.debug',
      'django.core.context_processors.i18n',
      'django.core.context_processors.media',
      'django.core.context_processors.request',
      'mobileadmin.context_processors.user_agent',
   )

使用

由于 mobileadmin 遵循Django管理界面的理念，您可以轻松重用现有的管理设置

您使用默认或自定义ModelAdmin类为每个模型，您想要在管理界面中可编辑，并使用您的URLconf连接Django的默认AdminSite实例。

如果情况是这样，您可以通过使用mobileadmin的独立管理站点实例和其autoregister()函数来重用这些ModelAdmin（子）类。

1. 在您的根URLconf中——在Django的admin.autodiscover()调用行下方——导入mobileadmin并调用函数mobileadmin.autoregister()

   # urls.py
   from django.conf.urls.defaults import *
   from django.contrib import admin
   
   admin.autodiscover()
   
   import mobileadmin
   mobileadmin.autoregister()
   
   urlpatterns = patterns('',
       ('^admin/(.*)', admin.site.root),
   )

   这将注册您的现有管理配置到mobileadmin。

2. 扩展urlpatterns以将默认的MobileAdminSite实例与您喜欢的URL挂钩，例如/ma/。添加

   urlpatterns += patterns('',
       (r'^ma/(.*)', mobileadmin.sites.site.root),
   )

   mobileadmin现在正在复制所有常规管理功能，并使用适用于您使用的移动设备的模板。

3. 在您的URLConf中将handler404和handler500变量设置为mobileadmin提供的视图

   handler404 = 'mobileadmin.views.page_not_found'
   handler500 = 'mobileadmin.views.server_error'

   这是必需的，以便根据您移动设备上的浏览器用户代理加载404.html和500.html模板。它自动回退到Django的默认错误处理器。

扩展 mobileadmin

mobileadmin附带一组默认模板和模式，用于识别不同的设备和平台

• Mobile Safari（iPhone/iPod touch）

但它是为了扩展而设计的。

由于模板加载取决于请求客户端的用户代理，mobileadmin告诉Django在尝试渲染默认管理视图时查找三个模板

1. mobileadmin/USER_AGENT_NAME/VIEW_TEMPLATE.html

2. mobileadmin/VIEW_TEMPLATE.html

3. admin/index.html

..其中

• USER_AGENT是用户代理的简称

• VIEW_TEMPLATE是渲染模板的名称

例如，如果您尝试使用iPhone访问登录视图，将会尝试加载以下三个模板

1. mobileadmin/mobile_safari/login.html

2. mobileadmin/login.html

3. admin/index.html

..其中mobile_safari是默认设备模式之一，而login.html是所需的模板。

MOBILEADMIN_USER_AGENTS = {
    'my_user_agent': r'.*MyUserAgent.*',
}

from mobileadmin import sites

class MyMobileAdminSite(sites.MobileAdminSite):
    # define here whatever function you want
    pass

from django.contrib.admin import sites
from mobileadmin.decorators import mobile_templates

class MyAdminSite(sites.AdminSite):

    def index(self, request, extra_context=None):

        # self.index_template is already automatically set here
        # do something cool here

        return super(MyAdminSite, self).index(request, extra_context)
    index = mobile_templates(index)

MOBILEADMIN_TEMPLATE_MAPPING = {
    'index': ('index_template', 'index.html'),
}

from mobileadmin import options
from myproject.myapp.models import Author

class MobileAuthorAdmin(options.MobileModelAdmin):
    pass
mobileadmin.sites.site.register(Author, MobileAuthorAdmin)

# urls.py
from django.conf.urls.defaults import *
from django.contrib import admin
import mobileadmin

admin.autodiscover()

urlpatterns = patterns('',
    ('^admin/(.*)', admin.site.root),
    (r'^ma/(.*)', mobileadmin.sites.site.root),
)

媒体路径

请随意使用一些小助手来找到 mobileadmin 的媒体目录的路径。如果您正在使用 Django（或任何其他 Python 软件）来提供静态文件（在生产环境中不应这样做），只需使用例如：

from mobileadmin.conf import settings

mobileadmin_media_path = settings.MEDIA_PATH
mobileadmin_media_prefix = settings.MEDIA_PREFIX

现在您已经拥有 mobileadmin 媒体目录的完整（平台无关）路径，变量 mobileadmin_media_path 中，以及 mobileadmin 媒体的默认 URL 前缀（'/mobileadmin_media/'）在 mobileadmin_media_prefix 中。就像 ADMIN_MEDIA_PREFIX 但用于 mobileadmin 应用程序的 media 目录。

当然，您可以选择在 Django 站点的 settings.py 文件中设置 MOBILEADMIN_MEDIA_PREFIX 来覆盖默认的 URL 前缀。请使用尾部斜杠。这使得更新 mobileadmin 对您来说更容易，因为您现在不必担心媒体目录的不同位置。

from mobileadmin.conf import settings

urlpatterns += patterns('django.views.static',
    (settings.MEDIA_REGEX, 'serve', {'document_root': settings.MEDIA_PATH}),
)

支持

请将您的 问题和问题 留在指定的 Google Code 网站 上。