README

• 关于
  • 演示
  • 使用的包
• 要求
• 安装
  • 新项目
  • 添加到现有项目
• 基础
• 文档
• 下一步是什么？

关于

嗨，Craftable开发者，欢迎来到Craftable 5的官方文档——一个基于Laravel的开源工具包，用于构建管理界面。它是一个简约的管理区域模板。它是开发后台系统、内部网络或CMS系统的起点。

你可以称之为CMS，但这是一个非常精简的版本，尽量减少需要管理的内容。它具有

• UI - 基于 CoreUI 的精美管理模板（http://coreui.io/）
• CRUD 生成器
• 授权、我的个人资料和用户 CRUD
• 翻译管理器
• 其他辅助工具，快速启动新的管理区域（媒体库、管理员列表等）

演示

我们在https://demo.getcraftable.com为你创建了一个演示。

使用以下凭据登录

• 邮箱： demo@getcraftable.com
• 密码： demo123

您可以看到以下管理功能

• 文章 - 这是使用 admin-generator 包生成的标准 CRUD
• 可翻译文章 - 这是 translatable eloquent 模型的展示
• 管理访问 - 是对用户（您现有的 eloquent 模型）管理进行扩展的 CRUD
• 翻译 - 您可以在此管理数据库中存储的翻译

组件构成

我们的目的是将所有内容拆分成多个包，尽可能减少依赖。这是我们目前提供的内容

• 管理UI - 管理模板（CoreUI 资产、blades、Vue）
• 管理生成器 - Eloquent 模型的 CRUD 生成器
• 管理认证 - 能够登录管理区域
• 可翻译 - 能够拥有可翻译的内容（扩展 Laravel 的默认本地化）
• 管理列表 - 能够快速为 Eloquent 模型构建管理列表的查询
• 媒体库 - 能够将媒体附加到 eloquent 模型
• 管理翻译 - 翻译管理器（带有 UI）

Craftable 使用上述所有包。它还使用一些其他第三方包（如 Spatie 的 spatie/laravel-permission）并提供了一些基本的默认配置，以加快典型管理界面的开发。

要求

Craftable 需要

• PHP 7.2+
• 支持的数据库
  • MySQL 5.7+
  • PostgreSQL 9.5+
• npm 5.3+
• node 8.4+

Craftable 使用 Laravel，因此您也应该查看其要求。它与 Laravel 6 兼容

• https://laravel.net.cn/docs/6.x/installation#server-requirements

安装

新的 Craftable 项目

如果您想从头开始使用Laravel，可以使用我们的savannabits/craftable-installer，它会为您完成所有操作。让我们全局安装它。

composer global require "savannabits/craftable-installer"

创建一个空数据库（PostgreSQL或MySQL）。

现在您可以创建一个新的Craftable项目

craftable new my_project

这将使用最新的Laravel版本（目前为6）安装Craftable。如果您想使用最新的LTS Laravel版本（目前也是6），请使用--lts标志

craftable new --lts my_project

该命令将询问数据库设置，然后设置一切（安装所有依赖项，发布所有重要供应商配置，迁移，设置一些配置，Webpack配置并运行迁移）。

命令将生成并打印默认管理员账户的密码。将此密码保存到您的剪贴板，我们很快就会用到。

将Craftable添加到现有项目

或者，您也可以使用现有的Laravel应用程序。从这些两个主要包开始

composer require savannabits/craftable
composer require --dev savannabits/admin-generator

要安装此包，请使用

php artisan craftable:install

这将安装所有依赖项，发布所有重要供应商配置，迁移，设置一些配置，Webpack配置并运行迁移。

命令将生成并打印默认管理员账户的密码。将此密码保存到您的剪贴板，我们很快就会用到。

基础

安装完成后，导航到浏览器中的/admin/login。您应该能看到登录界面。

使用这些凭据登录

• 电子邮件：administrator@savannabits.sk
• 密码：使用剪贴板中的密码（在craftable:install命令的末尾打印出来）

授权后，您应该能看到默认主页和两个菜单项

• 管理访问
• 翻译

文档

您可以在https://docs.getcraftable.com/#/craftable找到此包和Craftable使用的其他包的完整文档。

下一步是什么？

到目前为止，您已经准备好开始构建您的管理区域了。您可能想要为您的Eloquent模型构建一个典型的CRUD界面。您绝对应该查看我们的Admin Generator文档。

如果您更愿意创建一些非典型自定义的管理界面，那么您可能想查看Admin UI包。

享受乐趣，创造一些惊人的东西！

许可证

MIT许可证。有关更多信息，请参阅LICENSE文件。