FAQ

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 ( $fields, $instance ) {

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

  return $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 ( $fields, $instance ) {

  $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 $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 ( $fields, $instance ) {

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