Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/godaddy-wordpress/contact-widgets

Beautifully display social media and contact info on your website with these simple widgets.
https://github.com/godaddy-wordpress/contact-widgets
contact-widget gutenberg-blocks gutenberg-compatible social-media widgets wordpress wordpress-plugin wordpress-widget
Last synced: about 7 hours ago
JSON representation
Beautifully display social media and contact info on your website with these simple widgets.
Host: GitHub
URL: https://github.com/godaddy-wordpress/contact-widgets
Owner: godaddy-wordpress
License: gpl-2.0
Created: 2016-03-08T15:24:25.000Z (over 8 years ago)
Default Branch: develop
Last Pushed: 2022-12-06T22:10:49.000Z (almost 2 years ago)
Last Synced: 2024-04-14T20:26:56.942Z (7 months ago)
Topics: contact-widget, gutenberg-blocks, gutenberg-compatible, social-media, widgets, wordpress, wordpress-plugin, wordpress-widget
Language: PHP
Homepage: https://wordpress.org/plugins/contact-widgets/
Size: 4.66 MB
Stars: 14
Watchers: 18
Forks: 16
Open Issues: 24
Metadata Files:
- Readme: readme.md
- Changelog: changelog.txt
- License: license.txt
Awesome Lists containing this project

README

        # Contact Widgets #

![Banner Image](wp-org-assets/banner-1544x500.png)

**Contributors:** [godaddy](https://profiles.wordpress.org/godaddy), [jonathanbardo](https://profiles.wordpress.org/jonathanbardo), [fjarrett](https://profiles.wordpress.org/fjarrett), [eherman24](https://profiles.wordpress.org/eherman24)  

**Tags:**              [widget](https://wordpress.org/plugins/tags/widget/), [contact](https://wordpress.org/plugins/tags/contact/), [social](https://wordpress.org/plugins/tags/social/), [social icons](https://wordpress.org/plugins/tags/social icons/), [social media](https://wordpress.org/plugins/tags/social media/), [facebook](https://wordpress.org/plugins/tags/facebook/), [twitter](https://wordpress.org/plugins/tags/twitter/), [instagram](https://wordpress.org/plugins/tags/instagram/), [linkedin](https://wordpress.org/plugins/tags/linkedin/), [pinterest](https://wordpress.org/plugins/tags/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.

[![Build Status](https://travis-ci.org/godaddy/wp-contact-widgets.svg?branch=master)](https://travis-ci.org/godaddy/wp-contact-widgets) [![License](https://img.shields.io/badge/license-GPL--2.0-brightgreen.svg)](https://github.com/godaddy/wp-contact-widgets/blob/master/license.txt) [![PHP >= 5.4](https://img.shields.io/badge/php-%3E=%205.4-8892bf.svg)](https://secure.php.net/supported-versions.php) [![WordPress >= 4.4](https://img.shields.io/badge/wordpress-%3E=%204.4-blue.svg)](https://wordpress.org/download/release-archive/)  

## 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.

[![Play video on YouTube](https://img.youtube.com/vi/Y3NsrWHd_us/maxresdefault.jpg)](https://www.youtube.com/watch?v=Y3NsrWHd_us)

**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](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-da_DK.po) - [Deutsch](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-de_DE.po) - [Ελληνικά](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-el.po) - [Español](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-es_ES.po) - [Español de México](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-es_MX.po) - [Suomi](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-fi.po) - [Français](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-fr_FR.po) - [हिन्दी](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-hi_IN.po) - [Bahasa Indonesia](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-id_ID.po) - [Italiano](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-it_IT.po) - [日本語](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-ja.po) - [한국어](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-ko_KR.po) - [मराठी](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-mr.po) - [Bahasa Melayu](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-ms_MY.po) - [Norsk bokmål](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-nb_NO.po) - [Nederlands](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-nl_NL.po) - [Polski](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-pl_PL.po) - [Português do Brasil](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-pt_BR.po) - [Português](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-pt_PT.po) - [Русский](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-ru_RU.po) - [Svenska](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-sv_SE.po) - [ไทย](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-th.po) - [Tagalog](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-tl.po) - [Türkçe](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-tr_TR.po) - [Українська](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-uk.po) - [Tiếng Việt](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-vi.po) - [简体中文](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-zh_CN.po) - [香港中文版](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-zh_HK.po) - [繁體中文](https://github.com/godaddy/wp-contact-widgets/blob/master/languages/contact-widgets-zh_TW.po)

**Support**

If you run into a problem, post your question in the [plugin support forum](https://wordpress.org/support/plugin/contact-widgets) 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](https://www.take-a-screenshot.org/)

* Name and version of your theme - [Video tutorial](https://youtu.be/xUVRgorHSyA)

* List of all active plugins on your site - [Video tutorial](https://youtu.be/g3TDziHl7zQ?t=1m51s)

* Steps taken or details we should know to reproduce and verify the problem

**Contributing**

Development of this plugin is done [on GitHub](https://github.com/godaddy/wp-contact-widgets). If you believe you have found a bug, or have a killer feature idea, please [open a new issue](https://github.com/godaddy/wp-contact-widgets/issues) there. Pull requests on existing issues are also welcome!

## Screenshots ##

1. Contact widget

2. Social widget

3. Twenty Sixteen theme showing both widgets

4. Social widget block settings and icons

5. Contact widget block settings

6. 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](https://fontawesome.com/icons/graduation-cap?style=solid) 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](https://github.com/evanherman)

### 1.6.0 - December 6th, 2018 ###

* New: Introduce Contact Details block.

* New: Introduce Social Profiles block.

Props [@EvanHerman](https://github.com/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](https://github.com/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](https://github.com/evanherman)

### 1.5.0 - May 31, 2018 ###

* New: Add support for "Unsplash" (https://unsplash.com/)

* Tweak: Update FontAwesome to 5.0.6

* Tweak: Fix typo in widget descriptions.

Props [@EvanHerman](https://github.com/evanherman), [@fjarrett](https://github.com/fjarrett), [@salvoventura](https://github.com/salvoventura), [@garrett-eclipse](https://github.com/garrett-eclipse)

### 1.4.1 - February 13, 2017 ###

* Tweak: Use FontAwesome 4.7.0

* Fix: Compatibility issues when other plugins add widget form fields

Props [@jonathanbardo](https://github.com/jonathanbardo), [@fjarrett](https://github.com/fjarrett)

### 1.4.0 - January 10, 2017 ###

* New: WordPress 4.7 compatibility

* New: Defer map iframe loading by default

* Tweak: Remove frameborder from map iframes

* Tweak: Add filter to change zoom level of map

* Tweak: Deprecate YouTube link while maintaining backward compatibility

Props [@fjarrett](https://github.com/fjarrett), [@jonathanbardo](https://github.com/jonathanbardo), [@EvanHerman](https://github.com/EvanHerman)

### 1.3.3 - October 14, 2016 ###

* Tweak: Remove edit button during Customize preview

* Fix: Minor bugs

Props [@jonathanbardo](https://github.com/jonathanbardo)

### 1.3.2 - August 16, 2016 ###

* New: WordPress 4.6 compatibility

* New: Add RSS to social networks

* Tweak: Plugin icon update

* Tweak: Update translation

* Fix: Edit button not working

Props [@jonathanbardo](https://github.com/jonathanbardo), [@fjarrett](https://github.com/fjarrett)

### 1.3.1 - June 3, 2016 ###

* New: Language support for Marathi

* New: Add 500px to social networks

Props [@jonathanbardo](https://github.com/jonathanbardo), [@fjarrett](https://github.com/fjarrett), [@salvoventura](https://github.com/salvoventura)

### 1.3.0 - May 19, 2016 ###

* New: Add front-end "Edit" link to quickly edit widgets in the Customizer

* Fix: Use WP-CLI nightlies in tests

Props [@jonathanbardo](https://github.com/jonathanbardo), [@fjarrett](https://github.com/fjarrett)

### 1.2.0 - April 12, 2016 ###

* New: WordPress 4.5 compatibility

* Tweak: Improve widget names

Props [@jonathanbardo](https://github.com/jonathanbardo), [@fjarrett](https://github.com/fjarrett)

### 1.1.0 - March 15, 2016 ###

* New: Support localization on Google Maps

Props [@jonathanbardo](https://github.com/jonathanbardo), [@fjarrett](https://github.com/fjarrett)

### 1.0.4 - March 9, 2016 ###

* Tweak: Language updates

Props [@jonathanbardo](https://github.com/jonathanbardo)

### 1.0.2 - February 24, 2016 ###

* New: Language support for 27 locales

Props [@jonathanbardo](https://github.com/jonathanbardo)

### 1.0.1 - February 24, 2016 ###

* New: Added possibility to add custom fields to contact and social widget

Props [@jonathanbardo](https://github.com/jonathanbardo)

### 1.0.0 - February 23, 2016 ###

* Initial release

Props [@jonathanbardo](https://github.com/jonathanbardo), [@fjarrett](https://github.com/fjarrett)