django admin interface

django-admin-interface

Django-Admin-Interfaceは、管理者自体がカスタマイズ可能な最新のレスポンシブフラット管理インターフェイスです。

特徴

• 美しいデフォルトのdjango-theme
• テーマ管理とカスタマイズ（管理者のタイトル、ロゴ、色をカスタマイズできます）
• 応答性
• 関連モーダル（古いポップアップウィンドウの代わりに）
• 環境名/マーカー
• 言語選択
• 折りたたみ可能なアプリ（ナビゲーションバーのアコーディオン）
• 折りたたみ可能なフィールドセットは、崩壊する代わりに初期状態を拡張することができます
• NEW折りたたみ可能なインライン
• NEWタブ付きフィールドセットとインライン
• NEWリストフィルター削除リンク
• NEWリストフィルターは、選択したオプションを強調表示します
• フィルターのドロップダウンをリストします
• リストフィルタースティッキー
• フォームコントロールスティッキー（ページネーションとボタンを保存/削除）
• 互換性 /スタイルの最適化：
  • django-ckeditor
  • django-dynamic-raw-id
  • django-json-widget
  • django-modeltranslation
  • django-rangefilter
  • django-streamfield
  • django-tabbed-admin
  • sorl-thumbnail
• 多くの言語で翻訳： de 、 es 、 fa 、 fr 、 it 、 pl 、 pt_BR 、 ru 、 tr

インストール

• pip install django-admin-interface実行します
• django.contrib.adminの前に、 admin_interfaceとcolorfield settings.INSTALLED_APPSに追加します

 INSTALLED_APPS = (
    #...
    "admin_interface" ,
    "colorfield" ,
    #...
    "django.contrib.admin" ,
    #...
)

X_FRAME_OPTIONS = "SAMEORIGIN"
SILENCED_SYSTEM_CHECKS = [ "security.W019" ]

• python manage.py migrate実行します
• python manage.py collectstatic --clear
• アプリケーションサーバーを再起動します

警告

ポップアップウィンドウの代わりにモーダルを使用したい場合は、 X_FRAME_OPTIONS = "SAMEORIGIN"設定を追加してください。

オプションの機能

フィールドセットを展開するには、崩壊してHideボタンで拡張を開始するには、クラスをクラスに"expanded"します。

 class MyModelAdmin ( admin . ModelAdmin ):
    # ...
    fieldsets = [
        ( "Section title" , {
            "classes" : ( "collapse" , "expanded" ),
            "fields" : (...),
        }),
    ]
    # ... 

オプションのテーマ

このパッケージには、オプションのテーマが備品として出荷され、LoadData Adminコマンドを使用してインストールできます。オプションのテーマはインストール時にアクティブになります。

Djangoテーマ（デフォルト）：

python manage.py loaddata admin_interface_theme_django.jsonを実行します

ブートストラップテーマ：

python manage.py loaddata admin_interface_theme_bootstrap.jsonを実行します

基礎のテーマ：

python manage.py loaddata admin_interface_theme_foundation.jsonを実行します

米国のWebデザイン標準テーマ：

python manage.py loaddata admin_interface_theme_uswds.jsonを実行します

テーマを追加します

PRを送信して、このリポジトリに管理者を介して作成したテーマを追加できます。追加するための手順は次のとおりです。

1. dumpdata adminコマンドを使用してフィクスチャとして正確なテーマをエクスポートします： python manage.py dumpdata admin_interface.Theme --indent 4 -o admin_interface_theme_{{name}}.json --pks=N

2. 生成されたJSONファイルをFIXTURESフォルダーにコピーします（その名前がadmin_interface_theme_で始まることを確認して、他のサードパーティアプリが提供する可能性のあるフィクスチャーとの衝突を避けます） 。

3. フィクスチャからpkを削除し、 activeフィールドがtrueに設定されていることを確認します（このようにして、インストール時にテーマが自動的にアクティブ化されます） 。

4. 上記のセクションを編集して、テーマを文書化します。

サードパーティライブラリにテーマサポートを追加します

次のCSS変数を使用して、既存のサードパーティライブラリにテーマサポートを追加できます。

ヘッダ

• --admin-interface-header-background-color
• --admin-interface-header-text-color
• --admin-interface-header-link-color
• --admin-interface-header-link_hover-color
• --admin-interface-title-color
• --admin-interface-env-color

ロゴ

• --admin-interface-logo-color
• --admin-interface-logo-default-background-image
• --admin-interface-logo-max-width
• --admin-interface-logo-max-height

モジュール /リンク

• --admin-interface-module-background-color
• --admin-interface-module-background-selected-color
• --admin-interface-module-border-radius
• --admin-interface-module-text-color
• --admin-interface-module-link-color
• --admin-interface-module-link-selected-color
• --admin-interface-module-link-hover-color
• --admin-interface-generic-link-color
• --admin-interface-generic-link-hover-color
• --admin-interface-generic-link-active-color

ボタン

• --admin-interface-save-button-background-color
• --admin-interface-save-button-background-hover-color
• --admin-interface-save-button-text-color
• --admin-interface-delete-button-background-color
• --admin-interface-delete-button-background-hover-color
• --admin-interface-delete-button-text-color

関連モーダル

• --admin-interface-related-modal-background-color
• --admin-interface-related-modal-background-opacity
• --admin-interface-related-modal-border-radius
• --admin-interface-related-modal-close-button-display

スクリーンショット

管理者ログイン

管理ダッシュボード

管理者テーマ管理

管理者テーマのカスタマイズ

ローカリゼーション

現時点では、このパッケージは次の言語に翻訳されています： de 、 es 、 fa 、 fr 、 it 、 pl 、 pt_BR 、 tr 。

別の言語に翻訳します

• python -m django makemessages --ignore ".tox" --ignore "venv" --add-location "file" --extension "html,py" --locale "it" （イタリアのローカリゼーションの例）

• admin_interface/locale/it/LC_MESSAGES/django.poで翻訳を更新します

• python -m django compilemessages --ignore ".tox" --ignore "venv"を実行する

翻訳を更新します

プロジェクトにいくつかの変更を行う場合は、翻訳を更新することを忘れないでください。翻訳ファイルが最新でない場合、CIのlintステップは失敗するためです。

• tox -e translationsを実行します

キャッシング

このパッケージでは、キャッシュを使用して、テーマの負荷時間と全体的なパフォーマンスを改善します。 settings.CACHES["admin_interface"]設定を使用して、アプリキャッシングオプションをカスタマイズできます。それ以外の場合は"default"キャッシュが使用されます。

 CACHES = {
    # ...
    "admin_interface" : {
        "BACKEND" : "django.core.cache.backends.locmem.LocMemCache" ,
        "TIMEOUT" : 60 * 5 ,
    },
    # ...
}

警告

このパッケージをdjango-redisで使用する場合、既知の互換性の問題があります。より具体的には、 JSONSerializerを使用して、次のエラーを使用します。TypeRror TypeError: Object of type Theme is not JSON serializable 。この問題を軽減するために、 json Serializerを使用しないこのアプリに特定のキャッシュを使用します

よくある質問

カスタムbase-site.html

私はすでにカスタムbase_site.htmlを持っています、どうすればそれを機能させることができますか？

django-apptemplatesを使用してから、 {% extends "admin_interface:admin/base_site.html" %}をbase_site.htmlに追加できます

カスタムローカルLocaleMiddleware警告

django.middleware.locale.LocaleMiddlewareサブクラスを使用していますが、 django.middleware.locale.LocaleMiddlewareの不必要な警告が表示されます。

あなたは単に警告を無視することができます（これはここで説明されています）

 import warnings

warnings . filterwarnings ( "ignore" , module = "admin_interface.templatetags.admin_interface_tags" )

言語の選択者は表示されません

私は言語Chooserを有効にしましたが、それは管理者には見えません、私は何をすべきですか？

多言語settingsとurls正しく構成する必要があります。

 LANGUAGES = (
    ( "en" , _ ( "English" )),
    ( "it" , _ ( "Italiano" )),
    ( "fr" , _ ( "Français" )),
    # more than one language is expected here
)
LANGUAGE_CODE = "en"
USE_I18N = True
MIDDLEWARE = [
    # ...
    "django.middleware.locale.LocaleMiddleware" ,
    # ...
]

 from django . conf . urls . i18n import i18n_patterns
from django . contrib import admin
from django . urls import include , path

# ...

urlpatterns = [
    path ( "i18n/" , include ( "django.conf.urls.i18n" )),
]
urlpatterns += i18n_patterns ( path ( "admin/" , admin . site . urls ))

モーダルウィンドウでURLを開きます

管理者にいくつかのクロスリンクがあるアプリケーションがあり、同じ/新しいウィンドウの代わりにモーダルウィンドウでそれらを開きたいと思います。どうすればよいですか？

_popup=1 query-stringパラメーターをURLに追加する必要があります。

 url = reverse ( f"admin:myapp_mymodel_change" , args = [ mymodel_instance . pk ])
url = f" { url } ?_popup=1" 

テスト

 # clone repository
git clone https://github.com/fabiocaccamo/django-admin-interface.git && cd django-admin-interface

# create virtualenv and activate it
python -m venv venv && . venv/bin/activate

# upgrade pip
python -m pip install --upgrade pip

# install requirements
pip install -r requirements.txt -r requirements-test.txt

# install pre-commit to run formatters and linters
pre-commit install --install-hooks

# run tests
tox
# or
python runtests.py
# or
python -m django test --settings " tests.settings " 

貢献

貢献はいつでも大歓迎です。高品質のPRを提出するには、次の手順に従ってください。

• sewsue問題を開き、既存の問題を参照していないPRを提出しないでください。
• 変更に取り組むには、将来の回帰を避けるために、変更をテストでカバーすることができます。
• 翻訳ファイルを更新します。
• ？テストを実行して、エラーがないことを確認します。
• ？ Pull-Requestを送信し、 CIに合格した場合にのみ「レビューの準備ができている」とマークします。

ライセンス

MITライセンスの下でリリースされました。

---

サポート

• Githubでこのプロジェクトに出演します
• Githubでフォローしてください
• ？ Twitterでフォローしてください
• ？ Githubで私を後援してください

参照してください

• django-cache-cleaner管理パネルまたは管理コマンドを使用して、キャッシュまたは個々のキャッシュ全体を簡単にクリアします。 ？

• django-colorfield管理者に素敵なカラーピッカーを備えたモデル用のシンプルなカラーフィールド。 ？

• django-extra-settings -django管理者のみを使用して、型付けされた追加設定を構成および管理します。

• django-maintenance-modeメンテナンスモードがオンになっているときに503エラーページが表示されます。 ？

• django-redirects完全な制御でリダイレクト。 ↪↪️

• django-treenodeおそらく、ツリーベースのものに最適な抽象モデル /管理者です。 ？

• python-benedictキーリスト/キーパスサポート、I/Oショートカット（Base64、CSV、JSON、Pickle、Plist、Query-String、Toml、XML、Yaml）および多くのユーティリティ。

• python-codicefiscaleイタリアの財政コードをエンコード/デコード - Codifica/Decodifica del Codice Fiscale。 ?? ？

• python-fontbroフレンドリーなフォント操作。 ？

• python-fsutil怠devsのファイルシステムユーティリティ。 ？