django-facebox 0.2.1

安装

pip install django-facebox

设置

将facebox添加到INSTALLED_APPS

INSTALLED_APPS += (
    'facebox',
)

确保您有django.template.context_processors.request处理器

TEMPLATES = [
    {
        ...
        'OPTIONS': {
            'context_processors': [
                ...
                'django.template.context_processors.request',
            ],
        },
    },
]

并且只需包含facebox模板

{% include "facebox/facebox_css.html" %} {# Before the closing head tag #}
{% include "facebox/facebox_js.html" %} {# Before the closing body tag #}

在生产服务器上部署时，别忘了运行

python manage.py collectstatic

使用

扩展基本模板以用于ajax请求

{% extends request.is_ajax|yesno:"facebox/base.html,base.html" %}

将rel="facebox"添加到链接中，并将href设置为要显示的页面

<a href="{% url 'remote.html' %}" rel="facebox">Click here</a>

请参阅示例应用程序。此应用程序用于手动测试此包的功能。这也是一个好例子。

您只需要Django 1.4或更高版本来运行它。它可能在旧版本上运行，但没有进行测试。

许可

django-facebox是在BSD许可下发布的。