【snake】Section: 13 Creating a Custom Admin Dashboard
Why Are We Not Using Flask-Admin?
①カスタマイズに関してより知識を深めるため。
②デバッグでテストする際に何千行も書かれた3rd partyを使うべきでない。
③大して難しくない。
Adding the Admin Blueprint Viewing the Main Dashboard
Section12からAdminフォルダーがある。
url_prefix='/admin'を設定することでurlがすべてadminになる。
@admin.before_requestを設定することで、
これより下の＠確認が完了しないとrequestができないようにする。
２６行目のrole_requiredはuserフォルダーのdecolator.pyで設定されている。
３８行目のif文でrolesを確認して、違うroleなら見れないようにする。
views.pyに戻る、
@admin.route('')→が空欄になっているのはprefixでurlを指定しているから。
models.pyでDashboardクラスを確認してみる。
２７行目でcountをして、２８行目で検索をする。
３５行目で結果を反映させる。
Listing Users
９行目はサーチボックス。
１２行目は０で初期設定してある。
６１行目から６４行目は時間表示をさせる。
マウスオーバーさせると詳しい時刻も表示する。
実際にmoment.jsの使い方を説明する。
base.htmlにmoment.jsを埋め込む。
１６行目からjavascriptでfrom.nowが設定されている。
macroで設定がされている。
macroフォルダーのuser.htmlで設定がされている。
もしadminならfa-shieldアイコンで表示する。
レギュラーユーザーならfa-userアイコンで表示する。
macroフォルダーのitem.htmlの
３４行目の{% macro paginate(resource) -%}は非常に重要である。
よくわからん。
views.pyへ戻る、
５５行目の.paginate(page, 50, True)で何人表示させるかを決める。
Editing Users
edit.htmlを開くと{% include 'admin/user/form.html' with context %}とある。
form.htmlを開くと、
endpointって何よ？
biews.pyに戻る、
６４行目で検索して
６５行mでidを発行する。
UserFormがどうのように設定されているかをforms.pyで確認する。
roleを選択できるようにする。
choices=choices_from_dictがどのように設定されているかをlibフォルダーで確認する。
dict=辞書って意味。変更の設定をできるようにする。
forms.pyに戻る
active = BooleanFieldが使われている。
views.pyへ戻る
validate_on_submitでformを確認する
is_last_adminを詳しく見る、
最後のadminか確認するコードが書かれている。
もし最後のadminの場合はflashメッセージを報じさせる
flash('You are the last admin, you cannot do that.', 'error')
Generating Fake Users with the CLI
fake id mの発行方法
以下のコマンドで何をaddできるかを見ることができる。
$ docker-compose exec website snakeeyes add
次のコマンドでuserを100人追加することができる。
$ docker-compose exec website snakeeyes add users
requirement.txtで取り込む。
次にcmdフォルダーのcmd_add.pyを見る。
users functionをみる。かなり大規模だが簡単である。
７４行目で100人追加する。
７５行目の(fake.email())は偽アドレスを生成する。
８１行目はrandom_emailがなくなったらストップする。
８４行目はfake.dateにすることで適当な時間が生成される。
９２行目は９５％がメンバーで生成される。
同じような感じでいろいろ書かれている。
最後はpramsにまとめて_bulk_insertへ送り込む。
bulk_insert functionは一気にデータをinsertしてくれる。
Searching and Sorting Users
Searchはuser/index.htmlで行われている。
３行目でform.pyからfとしてインポートされている。
９行目でmacroが指示されている。
６８行目でsearch formが定義されている。
今回はgetメソッドで定義されている。
getにすることでブックマークや検索ページをブックマークできる。
ここからviews.pyを解説する。
.filter(User.search(request.args.get('q', '')))とあるので
models.pyのsearch functionを確認する。
%{0}%はパーシャルでも検索可能にする。
emailとuserを検索する。その際、ilikeとしている。
また、from sqlalchemy import orでシーコルアルコミーからorをインポートしてる。
or(*search_chain)とすることでmailかuserのどちらとも検索する。
and_だったら、両方に待ちしたものになる。
他にも確認すべきことは色々あるが飛ばす。
Deleting Users
この画面を作る。
statistic/script/main.jsのチェックボックスをカウントする。
checkboxのjsに関してはよくわからん。
javascriptの使い方に関して。
views.pyの/users/bulk_deleteに関して
postリクエストで行う。
get_bulk_action_idsはsqlalcomyにある
get_bulk_action_idsはlibフォルダーのutil_sqlalchemy.pyにある。
