README

关于组件

MeisaMenuBundle 是一个帮助用户以简单方式创建多个前端菜单的组件。安装组件后只需三步，即可在您的网站上获得一个酷炫的菜单。

• 此组件服务于最终用户、UI 开发人员和应用程序开发者。
• 您可以轻松配置和管理您的前端菜单。
• 此组件依赖于 SonataAdminBundle。

组件使用步骤

1. 配置路由（开发者角色）。
2. 设置菜单。
3. 在您的主题中使用创建的菜单。

让我们享受乐趣！！！

安装

1. 安装组件

   1. 在您的 composer.json 中添加以下行："mohammedeisa/menu_bundle": "2.0.*@dev"。
   2. 更新 composer。
   3. 在 AppKernel.php 中启用组件，通过添加以下行到 $bundles: "new Meisa\MenuBundle\MeisaMenuBundle()"。

2. 配置组件

   1. 在 config.yml 中，导入包含组件配置的资源。
      - { resource: @MeisaMenuBundle/Resources/config/menu_definition.yml }
   2. 将 - 'MeisaMenuBundle:Form:meisa_link_field.html.twig' 添加到twig表单资源中，如下所示。
      

   twig:
           debug:            "%kernel.debug%"
           strict_variables: "%kernel.debug%"
   
           form:
               resources:
                   - 'MeisaMenuBundle:Form:meisa_link_field.html.twig'
   

   此模板是您应用程序中的一个辅助工具。我将在 Meisa 链接助手 中稍后解释它的好处。

3. 通过添加以下内容到您的 routing.yml 中导入组件路由。

meisa_menu:
        resource: "@MeisaMenuBundle/Controller/"
        type:     annotation
        prefix:   /

1. 在 sonata_admin.yml 中为组件添加管理侧边栏菜单项 {- meisa.menu.config , - meisa.menu.name}，如下所示。

sonata_admin:
        dashboard:
            groups:
                sonata.admin.group.meisa:
                              label: Main
                              icon:  '<i class="fa fa-play-circle"></i>'
                              items:
                                  - meisa.menu.config
                                  - meisa.menu.name

这就完成了！如何使用 Meisa 菜单？

• 此组件在 sonata 侧边栏中注册了两个条目（菜单配置、菜单）。首先，您必须注册您在后续前端菜单中需要使用的所有路由。

1. 点击“配置”并创建新的路由配置。
   路由配置过程。
   
   1. 选择一个路由及其类型，然后保存。
   2. 如果您选择类型为“显示”，您将需要配置每个路由参数。
2. 转到菜单，创建新的菜单，您将在底部看到所有配置已发布。
3. 选择您菜单所需的链接并保存。
4. 保存后，您将在顶部看到菜单名称。
5. 您可以使用此功能在任何前端模板中使用 show_menu 过滤器发布您的菜单。

• 示例用法
  {{ "header_menu"|show_menu|raw }} Meisa 链接助手 -- 这是一个“meisa_link”类型的表单字段助手。您可以在您的 sonata admin 类中的任何表单中使用它。
  示例用法
  $formMapper ->add('link', 'meisa_link', array()); 此链接字段是一个带按钮的文本字段。当您点击此按钮时，将出现一个包含您配置的链接的模态窗口。选择您想要的链接，它将被设置为文本字段中的内容。此字段类型可用于任何组件。