Nous venons de publier Craftable PRO - la version premium de ce populaire générateur de panneaux d'administration open source Laravel. La version Pro est livrée avec une nouvelle interface utilisateur construite sur Tailwind, elle utilise les derniers Laravel et InertiaJS et est livrée avec de nombreuses nouvelles fonctionnalités.
Bonjour Crafter, bienvenue dans la documentation officielle de Craftable 6 - une boîte à outils open source basée sur Laravel pour créer des interfaces d'administration. C'est un modèle minimaliste de zone d'administration. Un point de départ pour développer des systèmes de back-office, des intranets ou des systèmes CMS.
Vous pourriez l'appeler CMS, mais c'est un système très mince, avec le moins de contenu à gérer possible. Il a :
Nous avons créé une démo pour que vous puissiez jouer sur https://demo.getcraftable.com.
Utilisez ces informations d'identification pour vous connecter :
[email protected]
demo123
Vous pouvez voir une administration de :
admin-generator
translatable
Notre intention était de diviser le tout en plusieurs packages avec le moins de dépendances possible. Voici ce que nous proposons pour le moment :
Craftable utilise tous les packages ci-dessus. Il utilise également d'autres packages tiers (comme spatie/laravel-permission
de Spatie) et fournit une configuration de base par défaut pour accélérer le développement d'une interface d'administration typique.
La fabrication nécessite :
Craftable utilise Laravel, vous devriez donc également vérifier ses exigences. Il est compatible avec Laravel 8 :
Si vous souhaitez démarrer avec un nouveau Laravel, vous pouvez utiliser nos brackets/craftable-installer
qui font toutes les astuces pour vous. Installons-le globalement :
composer global require " brackets/craftable-installer "
Créez une base de données vide de votre choix (PostgreSQL ou MySQL).
Vous pouvez maintenant créer un nouveau projet Craftable :
craftable new my_project
Cela installera Craftable en utilisant la dernière version de Laravel (actuellement 6). Si vous préférez utiliser la dernière version de LTS Laravel (actuellement également la 6), utilisez l'indicateur --lts
:
craftable new --lts my_project
Les commandes vont demander des paramètres de base de données, puis tout configurer (installer toutes les dépendances, publier toutes les configurations importantes du fournisseur, migrer, configurer certaines configurations, la configuration du webpack et exécuter les migrations).
La commande va générer et imprimer le mot de passe du compte administrateur par défaut . Enregistrez ce mot de passe dans votre presse-papiers, nous en aurons bientôt besoin.
Ou bien, vous pouvez utiliser votre application Laravel existante. Commencez par exiger ces deux packages principaux :
composer require brackets/craftable
composer require --dev brackets/admin-generator
Pour installer ce package, utilisez :
php artisan craftable:install
Cela va installer toutes les dépendances, publier toutes les configurations importantes du fournisseur, migrer, configurer certaines configurations, la configuration du webpack et exécuter les migrations.
La commande va générer et imprimer le mot de passe du compte administrateur par défaut . Enregistrez ce mot de passe dans votre presse-papiers, nous en aurons bientôt besoin.
Une fois installé, accédez à votre navigateur vers /admin/login
. Vous devriez pouvoir voir un écran de connexion.
Utilisez ces informations d'identification pour vous connecter :
[email protected]
craftable:install
)Après autorisation, vous devriez pouvoir voir une page d'accueil par défaut et deux éléments de menu :
Vous pouvez trouver la documentation complète de ce package et d'autres packages utilisés par Craftable sur https://docs.getcraftable.com/#/craftable.
À ce stade, vous êtes prêt à commencer à créer votre zone d’administration. Vous souhaitez probablement commencer à créer une interface CRUD typique pour vos modèles éloquents. Vous devriez absolument consulter notre documentation sur le générateur d'administrateur.
Si vous souhaitez plutôt créer une administration personnalisée atypique, vous souhaiterez probablement vous diriger vers le package Admin UI.
Amusez-vous et créez quelque chose de génial !
Déposez un sur le dépôt Github (facultatif)
Avant de contribuer, veuillez lire CONTRIBUTING.md et CODE_OF_CONDUCT.md.
Créez un problème du projet ou une fonctionnalité que vous souhaitez ajouter au projet et obtenez la tâche qui vous est assignée. (Le problème peut être n'importe quelle correction de bug ou n'importe quelle fonctionnalité que vous souhaitez ajouter à ce projet).
Forkez le dépôt sur votre Github.
Clonez le dépôt en accédant à votre client Git local dans un dossier local particulier de votre machine locale en utilisant cette commande avec le lien de votre référentiel forké à la place du lien ci-dessous :
git clone https://github.com/BRACKETS-by-TRIAD/craftable
Créez une branche à l'aide de la commande ci-dessous. git branch <your branch name>
Paiement à votre succursale. git checkout <your branch name>
Ajoutez votre code dans le dossier de votre machine locale. git add .
Validez vos modifications. git commit -m"<add your message here>"
Poussez vos modifications. git push --set-upstream origin <your branch name>
Faites une pull request ! (comparez votre succursale avec la branche principale du propriétaire)
Licence MIT. Reportez-vous au fichier LICENSE pour obtenir plus d'informations.