README

贡献者： godaddy, jonathanbardo, fjarrett, eherman24
标签： widget, contact, social, [社交图标](https://wordpress.org/plugins/tags/social icons/), [社交媒体](https://wordpress.org/plugins/tags/social media/), facebook, twitter, instagram, linkedin, pinterest
至少需要 4.4
已测试到 5.7
稳定标签 1.6.2
许可协议： GPL-2.0
许可协议URI： https://gnu.ac.cn/licenses/gpl-2.0.html

使用这些简单的小部件，在您的网站上优雅地展示社交媒体和联系方式。

描述

注意：此插件需要PHP 5.4或更高版本

使用简单易用的组件，在您的网站上优雅地展示社交媒体和联系方式。

联系方式

展示您的联系方式，包括电子邮件地址、电话号码、传真和物理地址（包括地图）。

社交媒体档案

以吸引人、直观的方式展示您的社交媒体档案。

支持30种语言

英语 - 丹麦语 - 德语 - 希腊语 - 西班牙语 - 墨西哥西班牙语 - 芬兰语 - 法语 - 印地语 - 印度尼西亚语 - 意大利语 - 日语 - 韩语 - 马拉地语 - 马来语 - 挪威语 - 荷兰语 - 波兰语 - 巴西葡萄牙语 - 葡萄牙语 - 俄语 - 瑞典语 - 泰语 - 他加禄语 - 土耳其语 - 乌克兰语 - 越南语 - 简体中文 - 香港中文版 - 繁体中文

支持

如果您遇到问题，请在插件支持论坛发布您的问题，我们会很乐意帮助您。记住，您提供的信息越多，我们验证问题就越容易，我们帮助您解决问题的速度就越快！

屏幕截图 - 操作指南
您的主题名称和版本 - 视频教程
您网站上所有活动的插件列表 - 视频教程
复现和验证问题所采取的步骤或详细信息

贡献

本插件的开发是在GitHub上完成的（GitHub链接）。如果您认为您发现了一个错误，或者有一个杀手级功能想法，请在此处打开一个新问题。对现有问题的拉取请求也欢迎！

屏幕截图

联系小部件
社交小部件
显示两个小部件的Twenty Sixteen主题
社交小部件区块设置和图标
联系小部件区块设置
联系小部件区块渲染

常见问题解答

我如何向联系信息小部件添加额外的字段？

向联系信息小部件添加额外的字段就像添加一个WordPress过滤器一样简单。

以下是一个示例

add_filter( 'wpcw_widget_contact_custom_fields', function ( $wpcw_fields, $instance ) {

  $wpcw_fields['cellphone'] = [
    'order'       => 2,
    'label'       => __( 'Cellphone:', 'YOURTEXTDOMAIN' ),
    'type'        => 'text',
    'description' => __( 'A cellphone number that website visitors can call if they have questions.', 'YOURTEXTDOMAIN' ),
  ];

  return $wpcw_fields;

}, 10, 2 );

我如何向社交媒体配置文件小部件添加额外的字段？

社交媒体配置文件小部件需要一组不同的选项，但遵循上述相同的原理。

以下是一个示例

add_filter( 'wpcw_widget_social_custom_fields', function ( $wpcw_fields, $instance ) {

  $wpcw_fields['scribd'] = [
    'icon'      => 'scribd', // See font-awesome icon slug
    'label'     => __( 'Scribd', 'YOURTEXTDOMAIN' ),
    'default'   => 'https://www.scribd.com/username',
    'select'    => 'username',
    'sanitizer' => 'esc_url_raw',
    'escaper'   => 'esc_url',
    'social'    => true,
    'target'    => '_blank',
  ];

  return $wpcw_fields;

}, 10, 2 );

如果您使用Font Awesome v5，则在定义自定义图标时，'solid'和'regular'图标需要'prefix'值。如果省略，则默认添加到图标的'prefix'是'fab'，用于Font Awesome品牌图标。如果您正在添加不是品牌图标的图标，则需要添加前缀。例如，如果您想添加一个毕业帽图标，您需要将'prefix' => 'fas'添加到属性数组中。

以下是在社交媒体配置文件中添加'fas'（实心）图标的示例。

add_filter( 'wpcw_widget_social_custom_fields', function ( $wpcw_fields, $instance ) {

  $wpcw_fields['lattes'] = [
    'icon'      => 'graduation-cap', // See font-awesome icon slug
    'prefix'    => 'fas', // See font-awesome icon prefix
    'label'     => __( 'Service Name', 'YOURTEXTDOMAIN' ),
    'default'   => 'https://example.com/username',
    'select'    => 'username',
    'sanitizer' => 'esc_url_raw',
    'escaper'   => 'esc_url',
    'social'    => true,
    'target'    => '_blank',
  ];

  return $wpcw_fields;

}, 10, 2 );

Font Awesome文件是从哪里提供的？

默认情况下，Font Awesome文件包含在联系小部件中，并在本地提供服务。但是，我们已经包括了一个过滤器，允许从MaxCDN加载Font Awesome文件。

要强制插件从MaxCDN加载文件，您可以在过滤器wpcw_social_icons_use_cdn中返回一个true值。

add_filter( 'wpcw_social_icons_use_cdn', '__return_true' );

变更日志

1.7.0 - 2018年2月20日

修复：修复WordPress 5.3兼容性问题。（用jQuery替换了$）
微调：删除所有PHP数组简写语法引用。（用array()替换了[]）

1.6.2 - 2018年2月20日

微调：调整联系区块依赖关系。

1.6.1 - 2018年12月9日

微调：对联系地图地址进行URI编码。

感谢@EvanHerman

1.6.0 - 2018年12月6日

新功能：引入联系详情区块。
新功能：引入社交媒体配置文件区块。

感谢@EvanHerman

1.5.2 - 2018年6月18日

新功能：引入过滤器wpcw_social_icons_fontawesome_5（默认：false），以在联系小部件中使用Font Awesome 5。
新功能：引入过滤器wpcw_social_icons_use_cdn（默认：false），以从MaxCDN加载Font Awesome v4.7.0文件。
新功能：引入过滤器wpcw_social_icons_cdn_url，以更改默认的Font Awesome CDN URL。
微调：恢复到Font Awesome 4.7.0，并可选择通过过滤器强制加载Font Awesome v5.0.13。（见上文）

感谢@EvanHerman