README

此包为 Sulu CMS 提供生成图片占位符的功能。

安装

您可以通过 Composer 安装此包。

composer require olivier127/sulu-picture-placeholder-generator-bundle

配置

安装此包后，您可以在您的 Symfony 应用程序中进行配置。将以下配置添加到您的 config/packages/olivier127_place_holder_generator.yaml 文件中，以设置默认值。

olivier127_place_holder_generator:
  lorempicsum:
    seed: <a string>
    id: <a integer>
  placehold:
    text: <60 characters max>
    text_font: <inside ['lato', 'montserrat', 'oswald', 'pt-sans', 'roboto', 'lora', 'open-sans', 'playfair-display', 'raleway', 'source-sans-pro', 'oswald']>
    background_color: <css code color or hexa like FFFFFF>
    text_color: <css code color or hexa like FFFFFF>

对于 lorem picsum，您不能同时指定 seed 和 id。您只能指定必需的参数。

olivier127_place_holder_generator:
  placehold:
    background_color: orange

详见： https://placehold.co/ 和 https://picsum.photos/

Twig 扩展

此包提供了两个 Twig 扩展： sulu_generate_placeholder 和 sulu_generate_picture。

用法

sulu_generate_placeholder

此 Twig 函数使用配置的占位符生成器生成占位符。选项将覆盖包配置。

{% set placeholder = sulu_generate_placeholder('thumbnail') %}
<img src="{{ placeholder }}" alt="Placeholder Image">

{% set placeholder = sulu_generate_placeholder('thumbnail', { 'text': 'Sulu CMS', 'text_font': 'lato' }) %}
<img src="{{ placeholder }}" alt="Placeholder Image">

{% set placeholder = sulu_generate_placeholder('thumbnail', { 'background_color': 'ccc', 'text_color': '000' }) %}
<img src="{{ placeholder }}" alt="Placeholder Image">

options 参数使用与 placehold 相同的配置。

sulu_generate_picture

此 Twig 函数使用配置的图片生成器生成图片。选项将覆盖包配置。

{% set picture = sulu_generate_picture('thumbnail') %}
<img src="{{ picture }}" alt="Generated Picture">

{% set picture = sulu_generate_picture('thumbnail', { 'seed': '123456' }) %}
<img src="{{ picture }}" alt="Generated Picture">

{% set picture = sulu_generate_picture('thumbnail', { 'id': 100 }) %}
<img src="{{ picture }}" alt="Generated Picture">

options 参数使用与 lorempicsum 相同的配置。