Django-frontendadmin 技术文档

1. 安装指南

在开始使用 django-frontendadmin 之前，请确保您的环境中已经安装了 Django。

步骤：

1. 将 frontendadmin 添加到您 Django 项目的 INSTALLED_APPS 中。

2. 在您的 settings.py 文件中添加 django.core.context_processors.request 到 TEMPLATE_CONTEXT_PROCESSORS 中。如果此选项不可用，请使用以下配置：

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

3. 在您的 URL 配置文件中包含 frontendadmin 的 URL：

   (r'^frontendadmin/', include('frontendadmin.urls')),
   

4. 在需要使用 frontendadmin 链接的模板中加载 frontendadmin_tags 库。

2. 项目的使用说明

django-frontendadmin 提供了一套模板标签，使得在前端页面中编辑模型数据变得简单而不突兀。以下是使用此项目的快速入门指南：

快速入门：

1. 打开终端，切换到 django-frontendadmin/example_project/ 目录下。
2. 执行 ./manage.py syncdb 命令并创建一个超级用户。
3. 执行 ./manage.py runserver 命令，并在浏览器中访问 http://127.0.0.1:8000/admin/。
4. 使用步骤 2 中提供的用户名和密码进行认证。
5. 访问首页 http://127.0.0.1:8000/ 并开始操作。
6. 享受您的成果。

3. 项目API使用文档

django-frontendadmin 提供了三个模板标签，用于创建、修改或删除对象：

• {% frontendadmin_add queryset_of_objects label_for_link %}
• {% frontendadmin_change object_to_change label_for_link %}
• {% frontendadmin_delete object_to_delete label_for_link %}

假设您有一个博客应用程序并使用通用视图，您的模板可能如下所示：

{% for entry in object_list %}
<div>
  <h2>{{ entry.title }}</h2>
  {{ entry.body }}
  <div>
  {% endfor %}

要实现 frontendadmin 的正确用法，请按照以下方式操作：

{% frontendadmin_add object_list %}
{% for entry in object_list %}
<div>
  <h2>{{ entry.title }}</h2>
  {{ entry.body }}
  {% frontendadmin_change entry %}
  {% frontendadmin_delete entry %}
<div>
{% endfor %}

可以使用自定义标签作为任何标签的最后一个参数：

{% frontendadmin_add object_list '发表一篇博文' %}
{% for entry in object_list %}
<div>
  <h2>{{ entry.title }}</h2>
  {{ entry.body }}
  {% frontendadmin_change entry '编辑这篇文章' %}
  {% frontendadmin_delete entry '永久删除它' %}
<div>
{% endfor %}

frontendadmin 将自动检查当前用户是否有针对给定模型的添加/修改/删除权限。

4. 项目安装方式

关于项目的安装方式，请遵循以下步骤：

1. 下载或克隆 django-frontendadmin 项目。
2. 将项目文件夹添加到您的 Django 项目的 INSTALLED_APPS 列表中。
3. 根据上述安装指南中的步骤配置您的 Django 项目。
4. 开始使用 django-frontendadmin 功能。