Administrateur actif

La section Admin est un module commun à la plupart des applications. Pour les applications Rails, nous avons une gemme appelée Active Admin. Cela peut être utilisé pour créer une application à partir de zéro vers des interfaces d'administration avec peu d'effort.

Introduction
C'est un cadre où toutes les tâches administratives peuvent être gérées. Il crée une belle interface d'administration qui vous donne accès à la gestion des données et peut être facilement personnalisée.

Comment installer et configurer ?

First I will be creating three modules for my Rails 5 application.

Artist, Producer and Movie

Relations : artiste.rb has_many :producteur de films.rb has_many :films movie.rb appartient_à :artiste appartient_à :producteur

Ajoutons activeadmin au gemfile et effectuons l'installation du bundle.

gem 'devise' gem 'activeadmin', github : installation du bundle 'activeadmin'

Vous devez ajouter certaines dépendances pour Rails 5. Ajoutez la gemme ci-dessous au fichier gem et effectuez à nouveau l'installation du bundle.

gem 'inherited_resources', github : 'activeadmin/inherited_resources'

Exécutez le générateur pour installer l'administrateur actif. Il crée tous les fichiers administratifs dans le répertoire app/admin. Gemme d'appareil utilisée par l'administrateur actif pour l'authentification.

rails g active_admin: installer

Votre terminal vous invite à configurer manuellement certains paramètres une fois que vous avez exécuté la commande ci-dessus.

Authentification ActiveAdmin

Requires two settings to authenticate and use current user in the application.

To force controller methods to authenticate

config.authentication_method = :authenticate_admin_user!

Pour accéder à l'utilisateur actuel à partir des méthodes

config.current_user_method = :current_admin_user

Both above settings can be set to false to turn off authentication.

Start the rails server and navigate to the http://localhost:3000/admin. Vous pouvez vous connecter en utilisant les informations d'identification suivantes.

Nom d'utilisateur : [email protected] Mot de passe : mot de passe

Le tableau de bord d'administration s'affichera une fois que vous serez connecté avec succès. Le menu supérieur affiche la liste des modèles enregistrés avec l'administrateur actif. Pour l’instant, nous n’avons qu’un seul modèle AdminUser. Ici, vous pouvez créer ou modifier des informations d'administration.

Personnalisation des vues
Ici, nous devons enregistrer nos modèles auprès d'un administrateur actif.

rails génèrent active_admin:resource Artiste rails génèrent active_admin:resource Producteur rails génèrent active_admin:resource Film

Avant cela, ajoutons quelques données à votre base de données.

Seeds.rb a1 = Artist.create !(nom : 'artiste-1') a2 = Artist.create !(nom : 'artiste-2') p1 = Producer.create !(nom : 'producteur-1') p2 = Producer.create !(nom : 'producter-2') Movie.create !(nom : 'movie-1', année_de sortie : 2014, réalisateur : 'director-1', description : 'Lorem Ipsum est simplement un texte factice de l'impression et industrie de la composition.', artiste : a1, producteur : p1)

Exécutez l'application, vous pouvez voir les données sur l'interface et vous pouvez modifier et supprimer les données.

Personnalisation

Par défaut, la ressource sera affichée dans la navigation globale. Il peut être désactivé s'il n'est pas requis dans le menu.

ActiveAdmin.register Film faire le menu fausse fin

Renommez l'étiquette du menu avec l'étiquette requise.

ActiveAdmin.register Étiquette du menu Film : fin de la « Liste des films »

La priorité du menu peut être définie par

ActiveAdmin.register Priorité du menu de réalisation du film : 4 fin

Par défaut toutes les colonnes utilisées pour afficher. Vous pouvez répertorier les colonnes requises dans la méthode d'index utilisée pour l'affichage. Ici, j'ai supprimé les colonnes d'horodatage du fichier admin/movie.rb

index colonne do : colonne nom : colonne de description : colonne année_sortie : colonne directeur : colonne producteur : fin des actions de l'artiste

Vous pouvez personnaliser le nom de la colonne en spécifiant le nom de la colonne avant le champ dans la méthode d'index.

colonne 'Prénom', :name

Sur le côté droit de la page, nous pouvons trouver la section des filtres. Par défaut, l'administrateur actif détecte les relations d'appartenance_à. Nous pouvons personnaliser la section de filtre. 

filtre :producteur, :as => :check_boxes

filtre :artiste, :as => :check_boxes

Personnalisation CSV

Par défaut, l'administrateur actif téléchargera toutes les colonnes affichées au format CSV. Ici, nous pouvons personnaliser les colonnes requises avec les paramètres CSV.

ActiveAdmin.register Film faire csv force_quotes : true, col_sep : ';', column_names : false faire colonne :name column(:artist) { |movie| film.artiste } colonne (:producteur) { |film| film.producteur } fin fin

Même globalement, nous pouvons configurer les paramètres du CSV

# config/initialiseurs/active_admin.rb

# Définir le séparateur du générateur CSV

config.csv_options = { col_sep : ';' }

# Forcer l'utilisation des guillemets

config.csv_options = { force_quotes : vrai }