README

展示

这是一个用于管理图片画廊的包。画廊是页面，允许您显示图片（例如一个有趣的地方）。

功能

• 默认图片通过设置
• 翻译
• 搜索
• 在编辑表单中预览页面

要求

• PHP >= 7.4
• Sulu >= 2.4
• Symfony >= 5.4
• Composer

安装

安装包

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

composer require pixelopen/sulu-gallerybundle

启用包

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

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

更新模式

bin/console do:sch:up --force

包配置

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

gallery.albums_api:
  type: rest
  prefix: /admin/api
  resource: pixel_gallery.albums_route_controller
  name_prefix: gallery.

gallery.settings_api:
  type: rest
  prefix: /admin/api
  resource: pixel_gallery.settings_route_controller
  name_prefix: gallery.

使用

添加/编辑画廊

转到管理界面中的“画廊”部分。然后点击“添加”。填写您需要使用的信息。

以下是字段列表

• 名称（必填）
• URL（必填且自动根据名称填写）
• 封面
• 图片
• 描述
• 位置

完成填写后，点击“保存”。

您的画廊在网站上还不可见。为了使其可见，请点击“激活？”。现在它应该对访客可见。

要编辑画廊，只需点击您想要编辑的画廊左侧的铅笔。

删除/恢复画廊

有两种删除画廊的方式

• 勾选您想要删除的每个画廊，然后点击“删除”
• 转到画廊的详细信息（见上面部分）并点击“删除”。

在两种情况下，画廊都将被放入回收站。

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

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

设置

此包附带设置。只有一个设置，即默认图片的配置。

要使用设置，您需要在需要的模板中调用 gallery_settings twig 函数。此函数不接受任何参数

使用示例

{% set gallerySettings = gallery_settings() %}
{% if album.cover is not empty %}
    {% set cover = sulu_resolve_media(album.cover.id, 'en' %}
    <img src="{{ cover.thumbnails['991x'] }}" alt="{{ album.name }}">
{% else %}
    {% set default = sulu_resolve_media(gallerySettings.defaultImage.id, 'en' %}
    <img src="{{ default.thumbnails['991x'] }}" alt="Default gallery image">
{% endif %} 

贡献

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