### Djangoxadmin安装教程与问题解决方案
#### 一、安装教程
**1. xadmin下载**
- **源码包下载地址**：通过提供的链接（https://github.com/sshwsfc/xadmin/tree/django2），可以下载到xadmin的最新版本。
**2. 安装xadmin**
- **安装方法一**：使用`pip install`命令来安装xadmin，可以通过下载压缩包后执行安装命令。
```bash
pip install <压缩包路径>
```
- **安装方法二**：将下载的压缩包中的`xadmin`文件夹直接复制到项目的app同级目录下，这种方法更便于后期对xadmin进行自定义或修改。
**3. settings.py配置**
- **注册app**：在项目的`settings.py`文件中，需要将`xadmin`加入到`INSTALLED_APPS`列表中。示例如下：
```python
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'APT_app', # 自定义应用
'xadmin', # 添加xadmin
'crispy_forms', # 添加
'reversion', # 添加(可选)
]
```
- **修改语言**：为了让xadmin支持中文，需要在`settings.py`中设置`LANGUAGE_CODE`为`'zh-hans'`，并将时区设置为`'Asia/Shanghai'`。
```python
LANGUAGE_CODE = 'zh-hans'
TIME_ZONE = 'Asia/Shanghai'
```
**4. urls.py配置**
- 需要在项目的`urls.py`文件中配置xadmin的路由，替换默认的admin路由。示例如下：
```python
from django.urls import path, include
import xadmin
xadmin.autodiscover()
from xadmin.plugins import xversion
xversion.register_models()
urlpatterns = [
path('xadmin/', xadmin.site.urls), # 添加新路由
]
```
**5. 安装依赖包**
- 将下载的压缩包中的`requirements.txt`文件复制到项目的xadmin文件夹同级目录下，并执行以下命令来安装所有依赖：
```bash
pip install -r requirements.txt
```
**6. 数据同步**
- 使用以下命令同步数据库模型：
```bash
python manage.py makemigrations
python manage.py migrate
```
**7. 启动项目**
- 启动项目服务器：
```bash
python manage.py runserver
```
**8. 创建超级用户**
- 使用以下命令创建超级用户：
```bash
python manage.py createsuperuser
```
**9. 注册表**
- 在app中添加一个`adminx.py`文件，用于注册表和全局配置。
- 修改`adminx.py`文件中的配置以满足需求。
#### 二、问题解决方案
**1. 点击添加小组件出错**
- 错误提示：`render() got an unexpected keyword argument 'renderer'`
- 解决办法：打开`xadmin/views/dashboard.py`文件，找到第36行代码，并将其修改为：
```python
def render(self, name, value, attrs=None, renderer=None):
```
**2. 修改app显示的名称**
- 在对应的app下的`apps.py`文件中修改`verbose_name`属性：
```python
class AptAppConfig(AppConfig):
name = 'APT_app'
verbose_name = u'APT组织信息展示'
```
- 在`__init__.py`文件中添加：
```python
default_app_config = 'APT_app.apps.AptAppConfig'
```
**3. 修改登录后的首页路径**
- 打开`xadmin/views/website.py`文件，修改56、57行以改变登录后跳转的页面路径。
**4. 修改xadmin首页左上角标题**
- 编辑`xadmin/templates/xadmin/base_site.html`文件中的相关代码，以更改xadmin首页左上角的标题。
**5. 使用xadmin注销功能**
- 可以直接使用模板标签`{% url 'xadmin:logout' %}`来生成注销链接。
VIP享7折，此内容立减5.97元 
