README

Contributors: godaddy, jonathanbardo, fjarrett, eherman24
Tags: widget, contact, social, [social icons](https://wordpress.org/plugins/tags/social icons/), [social media](https://wordpress.org/plugins/tags/social media/), facebook, twitter, instagram, linkedin, pinterest
Requires at least: 4.4
Tested up to: 5.7
Stable tag: 1.6.2
License: GPL-2.0
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Beautifully display social media and contact information on your website with these simple widgets.

Description

Note: This plugin requires PHP 5.4 or higher

Beautifully display social media and contact information on your website with simple, easy-to-use widgets.

Contact Information

Display your contact information including email address, phone number, fax and physical address (including a map).

Social Media Profiles

Display your social media profiles in an attractive, intuitive way.

30 Languages Supported

English - Dansk - Deutsch - Ελληνικά - Español - Español de México - Suomi - Français - हिन्दी - Bahasa Indonesia - Italiano - 日本語 - 한국어 - मराठी - Bahasa Melayu - Norsk bokmål - Nederlands - Polski - Português do Brasil - Português - Русский - Svenska - ไทย - Tagalog - Türkçe - Українська - Tiếng Việt - 简体中文 - 香港中文版 - 繁體中文

Support

If you run into a problem, post your question in the plugin support forum and we would be happy to help. Remember, the more information you can provide up-front, the easier it is for us to verify the problem and the faster we can help!

Screenshot(s) - How-to guide
Name and version of your theme - Video tutorial
List of all active plugins on your site - Video tutorial
Steps taken or details we should know to reproduce and verify the problem

Contributing

Development of this plugin is done on GitHub. If you believe you have found a bug, or have a killer feature idea, please open a new issue there. Pull requests on existing issues are also welcome!

Screenshots

Contact widget
Social widget
Twenty Sixteen theme showing both widgets
Social widget block settings and icons
Contact widget block settings
Contact widget block rendered

Frequently Asked Questions

How do I add additional fields to the Contact Information widget?

Adding additional fields to the Contact Information widget is as simple as adding a WordPress filter.

Here is an example:

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 );

How do I add additional fields to the Social Media Profiles widget?

The Social Media Profiles widget requires a different set of options but follows the same principle as above.

Here is an example:

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 );

If using Font Awesome v5, 'solid' & 'regular' icons require a 'prefix' value when defining the custom icon. If excluded, the default prefix added to icons is 'fab', for the Font Awesome brand icons. If you are adding an icon that is not a brand icon, you will need to add a prefix. For example, if you wanted to add a graduation cap icon you would need to add 'prefix' => 'fas' to the attributes array.

Here is an example of adding a 'fas' (Solid) icon to the social profiles.

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 );

Where are the Font Awesome files served from?

Out of the box the Font Awesome files are bundled in Contact Widgets and served locally. However, we have included a filter to allow Font Awesome files to be loaded from MaxCDN.

To force the plugin to load the files from MaxCDN you can return a true value in the filter wpcw_social_icons_use_cdn.

add_filter( 'wpcw_social_icons_use_cdn', '__return_true' );

Changelog

1.7.0 - February 20th, 2018

Fix: WordPress 5.3 compatibility fixes. (Replaced $ in favor of jQuery)
Tweak: Removed all references of PHP array shorthand syntax. (Replaced [] in favor of array())

1.6.2 - February 20th, 2018

Tweak: Adjust the contact block dependencies.

1.6.1 - December 9th, 2018

Tweak: URI Encode the contact map address.

Props @EvanHerman

1.6.0 - December 6th, 2018

New: Introduce Contact Details block.
New: Introduce Social Profiles block.

Props @EvanHerman

1.5.2 - June 18, 2018

New: Introduce filter wpcw_social_icons_fontawesome_5 (default: false) to use Font Awesome 5 in Contact Widgets.
New: Introduce filter wpcw_social_icons_use_cdn (default: false) to load Font Awesome v4.7.0 files from MaxCDN.
New: Introduce filter wpcw_social_icons_cdn_url to alter the default Font Awesome CDN URL.
Tweak: Revert back to Font Awesome 4.7.0 with the option to force load Font Awesome v5.0.13 via filter (see above).

Props @EvanHerman

1.5.1 - June 14, 2018

Tweak: Added a Font Awesome 5 config file with showMissingIcons set to false, to prevent conflicts with plugins and themes using Font Awesome v4.
Tweak: Filter the social profile fields array before localizing into admin.js, fixing custom social profile icons.

Props @EvanHerman