README

入门指南

此包使用 Bootstrap 5.1.3 和 jQuery 3.6。

此包包含 2 个视图，以及一套 CSS 和 JS 资产。

• login.html.twig: 简单的页面布局，风格优美。
• base.html.twig: 最小化管理布局。

如何使用

1. 在 AppKernel 或 bundles.php 中启用此包

return [
    Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true],
    ...
    EDC\BaseAdminBundle\EDCBaseAdminBundle::class => ['all' => true],
];

1. 添加配置文件

edc_base_admin:
    site_name: 'Site Title'
    login_check: _route_name_or_url_to_login_check
    logout: _route_name_or_url_to_logout
    admin_home: _route_name_or_url_to_admin_homepage

1. 要显示登录页面，只需创建自己的 login.html.twig 并添加

{% include ('@EDCBaseAdmin/login.html.twig') %}

1. 对于管理布局，创建一个名为例如 layout.html.twig 的模板并添加

{% extends '@EDCBaseAdmin/base.html.twig' %}

{% block title %} _YOUR_CUSTOM_HTML_TITLE_ {% endblock %}

{% block sidebar %}
    _YOUR_CUSTOM_SIDEBAR_MENU_
{% endblock %}

{% block dropdown %}
    _YOUR_CUSTOM_DROPDOWN_MENU_BELOW_USERNAME_
{% endblock %}

{% block footer %}
   _YOUR_CUSTOM_FOOTER_BELOW_USERNAME_
{% endblock %}

1. 最后，对于管理控制面板中的每个页面，您只需要从您的 layout.html.twig 继承。例如，对于 dashboard.html.twig

{% extends 'admin/layout.html.twig' %}

{% block content %}
    _YOUR_DASHBOARD_CONTENT_PAGE_
{% endblock %}

附加功能

表单主题

默认情况下，我们添加了 Bootstrap 5 表单主题，我们还改进了

• VichImageWidget: 添加了 Bootstrap 5 的 "img-thumbnail" 类到图像预览。

• FilepondType: 一个有用的表单抽象类型，帮助我们上传多个（或单个）文件/图像。一个包含 2 个子类的组合类型

  • 子类
    • uploader: FileType 字段用于处理文件上传。
    • files: HiddenType 字段用于处理已上传文件列表。
  • 选项
    • 'multiple' => 允许上传多个文件（布尔值）
    • 'uploadUri' => 请求上传文件的路径（字符串）
    • 'removeUri' => 请求删除文件的路径（字符串）
    • 'files' => 一个简单的数组，包含要显示的图像的路径
    • 'acceptedFileTypes' => 允许的 MIME 类型的列表（以逗号分隔的字符串）