clubdeuce/wp-share-this

WordPress 的 Share This 库。

0.0.6 2020-02-04 01:25 UTC

This package is auto-updated.

Last update: 2024-09-09 04:22:10 UTC


README

Scrutinizer Code Quality

WP Share-This

此库允许使用 ShareThis 实现分享链接的简单实现。请注意,此库与 ShareThis 或其子公司无任何关联。

安装

包含此库的最简单方法是通过 Composer。只需在项目根目录中运行以下命令(假设 composer.json 就位于那里

composer require clubdeuce/wp-share-this

此库将自动加载,前提是你已在项目中包含了 vendor/autoload.php

你还可以下载此库并手动包含它。

用法

  • 注册服务:WP_Share_This::register_service( 'twitter' )。支持的完整服务列表可以在 这里 找到。
  • 初始化库:WP_Share_This::initialize()
  • 渲染链接:WP_Share_This::the_sharing_links()

方法

参数

以下参数可以针对每个服务指定分享链接 (并非所有项目适用于每个服务)

示例

注册具有独特参数的服务

WP_Share_This::register_service( 'twitter', array(
    'username'    => 'myTwitterHandle',
    'share_count' => false,
) );

WP_Share_This::register_service( 'facebook', array(
    'image' => 'https://example.com/image.png',
);

WP_Share_This::register_service( 'email', array(
    'message' => __( 'Look at this really interesting article I found!', 'txt_domain' ),
) );  

以覆盖默认值的方式渲染链接

WP_Share_This::the_sharing_links( array(
    'share_count' => false,
) );

渲染除当前全局 $post 项之外的文章的分享链接

WP_Share_This::the_sharing_links( array(
    'post' => get_post( $post_id ),
) );

过滤器

此库公开了许多过滤器