README

展示

一个用于管理目录的Sulu插件。

功能

目录管理
卡片列表（通过智能内容）
预览
翻译
设置
SEO
活动日志
回收站

要求

PHP >= 8.0
Sulu >= 2.4
Symfony >= 5.4
Composer

安装

安装插件

执行以下composer命令，将插件添加到项目的依赖项中

composer require pixelmairie/sulu-directorybundle

启用插件

通过将其添加到项目config/bundles.php文件中注册的插件列表来启用插件

return [
    /* ... */
    Pixel\DirectoryBundle\DirectoryBundle::class => ['all' => true],
];

更新模式

bin/console do:sch:up --force

插件配置

在routes_admin.yaml中定义管理员API路由

directory.directories_api:
  type: rest
  prefix: /admin/api
  resource: pixel_directory.directories_route_controller
  name_prefix: card.

directory.settings_api:
  type: rest
  prefix: /admin/api
  resource: pixel_directory.settings_route_controller
  name_prefix: directory.

用法

添加/编辑一张卡片

进入管理界面中的“目录”部分。然后，点击“添加”。填写您所需字段。

以下是字段列表

名称（必填）
卡片类型（必填）
URL（必填，自动根据标题填写）
徽标
类别（必填）
图片
PDF
YouTube视频ID
网站
电子邮件
电话号码
Facebook
Instagram
Twitter
LinkedIn
描述
位置

完成编辑后，点击“保存”

您的卡片在网站上尚未可见。为了使其可见，请点击“激活？”。现在它应该对访客可见。

要编辑卡片，只需点击左侧的铅笔即可。

类别

如您在前一节中看到，卡片需要一个类别和类型。这些类别和类型需要以非常特定的方式进行创建。

对于类型

您必须创建一个根类别（代表不同的类型），其键必须命名为“types”
然后，在根类别下创建所有所需的类型

对于类别

您必须创建一个根类别，其键必须命名为“categories”
然后，在根类别下创建所有所需的类别

删除/恢复相册

有两种删除卡片的方式

勾选您想要删除的所有卡片，然后点击“删除”
转到卡片的详细页面（参见“添加/编辑新闻”部分）并点击“删除”。

在这两种情况下，卡片将被放入回收站。

要访问回收站，请转到“设置”并点击“回收站”。要恢复卡片，请点击左侧的时钟。确认恢复。您将被重定向到您恢复的卡片的详细页面。

要永久删除卡片，请勾选您想要删除的所有卡片并点击“删除”。

设置

此插件包含设置。要访问插件设置，请转到“设置 > 卡片管理”。

以下是不同设置的列表

地图中心定位
默认图片

如果您有一个显示所有已注册卡片的全球地图，地图中心定位非常有用。有了它，您可以将地图中心定位在特定区域以查看所有卡片。

默认图片在卡片没有标志时很有帮助，例如。

Twig 扩展

此包仅包含一个 Twig 函数

directory_settings()：返回包的设置。不需要任何参数。

使用示例

{% set settings = directory_settings() %}
{% if settings.defaultImage is defined %}
    {% set defaultImage = sulu_resolve_media(settings.defaultImage.id, 'fr') %}
{% endif %}

贡献

您可以为此包做出贡献。您必须做的唯一一件事是遵守我们实施的编码标准。您可以在 ecs.php 文件中找到它们。

pixelmairie / sulu-directorybundle

维护者

详细信息