README

该包为使用 shariff 提供了 symfony sonata-project 的包装器。

安装

打开命令行控制台，进入您的项目目录并执行以下命令以下载此包的最新稳定版本

composer require nucleos/shariff-bundle

启用 Bundle

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

// config/bundles.php

return [
    // ...
    Nucleos\ShariffBundle\NucleosShariffBundle::class => ['all' => true],
];

定义缓存、HTTP 客户端和请求工厂

# config/routes/nucleos_shariff.yaml

framework:
    cache:
        pools:
            cache.shariff:
                adapter: cache.adapter.filesystem

nucleos_shariff:
    cache: 'cache.shariff'
    http_client: 'some.http.client'         # e.g httplug.client
    request_factory: 'some.request.factory' # e.g. nyholm.psr7.psr17_factory

资产

建议使用 webpack / webpack-encore 将 shariff.js 和 shariff.css 文件包含在您的页面中。

您可以使用 npm 或 yarn 来加载库

npm install shariff

yarn add shariff

配置 Bundle

创建一个名为 nucleos_shariff.yaml 的配置文件

# config/routes/nucleos_shariff.yaml

nucleos_shariff:
    resource: "@NucleosShariffBundle/Resources/config/routing/backend.yml"

创建一个名为 framework_cache.yaml 的配置文件

framework:
    cache:
        pools:
            cache.shariff:
                adapter: cache.adapter.filesystem

使用

{# template.twig #}

{{ sonata_block_render({ 'type': 'nucleos_shariff.block.share' }, {
    'url': 'https://example.com/site.html'
}) }}

配置 Bundle

您可以全局配置应统计页面点赞或收藏的服务。

nucleos_shariff:
    cache: 'cache.shariff'
    http_client: 'some.http.client'
    request_factory: 'some.request.factory'

    options:
        domains: [ ] # Allow specific domains for shariff
        services: [ 'addthis', 'buffer', 'facebook', 'pinterest', 'reddit', 'stumbleupon', 'vk', 'xing' ]

    services:
        facebook:
            app_id:  "1234567890"
            secret:  "GENERATEDSECRET"
            version: "5.0"

这是 shariff-php 的一个分支，它提供了一个更现代和动态的解决方案。

许可证

该包在 MIT 许可证 下。