# Actix Admin

The actix-admin crate aims at creating a web admin interface similar to other admin interfaces (such as flask-admin in python).

## Getting Started

• See the example and run with cargo run.

• See the step by step tutorial

  Features

• Async: Builds on sea-orm for the database backend
• Macros: Generate the required implementations for models automatically
• Authentication: optionally pass authentication handler to implement authentication for views
• Supports custom validation rules
• Searchable attributes can be specified

• Supports custom views which are added to the Navbar

  Screenshot

  

  Quick overview

  Required dependencies

  itertools = "0.10.3" sea-orm = { version = "^0.9.1", features = [ "sqlx-sqlite", "runtime-actix-native-tls", "macros" ], default-features = true } actix_admin = { version = "^0.1.0" }

  See inlined steps

  ``` use seaorm::entity::prelude::*; use serde::{Deserialize, Serialize}; use actixadmin::prelude::; use actix_web::web; use actix_web::App; use actix_web::HttpServer; use sea_orm::entity::prelude::; use seaorm::entity::prelude::*; use actixadmin::prelude::; // 1. Import ActixAdmin use actix_admin::prelude::;

  // 2. Use DeriveActixAmin* Macros to implement the traits for the model

  [derive(Clone, Debug, PartialEq, DeriveEntityModel, Deserialize, Serialize,

  DeriveActixAdmin, DeriveActixAdminModel, DeriveActixAdminViewModel )]

  [seaorm(tablename = "comment")]

  pub struct Model { #[seaorm(primarykey)] #[serde(skipdeserializing)] #[actixadmin(primary_key)] pub id: i32, pub comment: String } impl ActixAdminModelValidationTrait for Entity {} impl ActiveModelBehavior for ActiveModel {}

  [derive(Copy, Clone, Debug, EnumIter, DeriveRelation)]

  pub enum Relation { }

  // 3. Add actix-admin to the AppState

  [derive(Clone)]

  pub struct AppState { pub db: DatabaseConnection, pub actix_admin: ActixAdmin, }

  // 4. Implement the ActixAdminAppDataTrait for the AppState impl ActixAdminAppDataTrait for AppState { fn get_db(&self) -> &DatabaseConnection { &self.db }

  fn getactixadmin(&self) -> &ActixAdmin { &self.actix_admin } }

  // 5. Setup the actix admin configuration pub fn createactixadminbuilder() -> ActixAdminBuilder { let commentview_model = ActixAdminViewModel::from(Entity);

  let configuration = ActixAdminConfiguration { enableauth: false, userisloggedin: None, loginlink: None, logoutlink: None, };

  let mut adminbuilder = ActixAdminBuilder::new(configuration); adminbuilder.addentity::(&commentview_model);

  admin_builder }

  // 6. Add to the actix app let actixadmin = createactixadminbuilder().getactixadmin(); //let opt = ConnectOptions::new("sqlite::memory:".toowned()); //let conn = seaorm::Database::connect(opt).unwrap(); //let appstate = AppState { // db: conn, // actixadmin: actix_admin, //};

  HttpServer::new(move || { App::new() //.appdata(web::Data::new(appstate.clone())) .service( createactixadminbuilder().getscope::() ) }); ```

  Access

  The admin interface will be available under /admin/.