注：python3和Django2.1環境安裝可參考博文《Django基礎-安裝配置》

xadmin2下載安裝

線上安裝(建議)

pip install git+git://github.com/sshwsfc/xadmin.git@django2

或

pip install git+git://github.com/sshwsfc/xadmin.git

下載 xadmin2.0 檔案並解壓

https://github.com/sshwsfc/xadmin

• 1、專案中新建目錄 extra_apps (名稱可自定義)，作為第三方依賴的存放目錄
• 2、選中 extra_apps 目錄，右擊Mark Directory as > Resource Root

環境配置

檢視依賴包命令

pip list

確認是否擁有以下幾種

django-crispy-forms       1.7.2
django-formtools          2.1
django-import-export      1.2.0
django-reversion          3.0.3

配置專案 setting 新增APP

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'APP.apps.AppConfig',
    'xadmin',
    'crispy_forms',
    'reversion',
]
 

配置專案 setting 新增搜尋目錄 extra_apps

STATIC_URL = '/static/'
STATIC_ROOT = 'APP/static'
STATICFILES_DIRS = (
    os.path.join(BASE_DIR,"APP/static/html"),
    os.path.join(BASE_DIR, 'extra_apps'),)

urls 路由新增

from django.contrib import admin
from django.urls import path,re_path
import xadmin

urlpatterns = [
    path('admin/', admin.site.urls),
    re_path('xadmin/',xadmin.site.urls),
]
 

生成資料表

python manage.py makemigrations APP
python manage.py migrate

建立使用者用於測試

python manage.py createsuperuser

至此可以訪問測試了

http://127.0.0.1/xadmin

常見錯誤

render() got an unexpected keyword argument 'renderer'

C:\Users\wefbn\AppData\Local\Programs\Python\Python\lib\site-packages\django\forms\boundfield.py in as_widget, line 93

進入xadmin安裝路徑，編輯C:\Users\administrator\AppData\Local\Programs\Python\Python\Lib\site-packages\django\forms\boundfield.py 第93行註釋掉

# renderer=self.for