Simple Socials for WordPress

Easily add social media buttons so content, widgets and anywhere you want.

Simple Socials plugin on a desktop monitor

Licences for this plugin are valid forever - they do not need to be renewed.

SKU: N/A Category: Current: 1.1.12
money-back guarantee sticker


100% No-Risk, Money Back Guarantee!

We're excited to have you experience the power of our plugins. So over the next 14 days, if any Power Plugins aren’t the best fit for your project, simply reach out! We’ll happily refund 100% of your money. No questions asked.

About Simple Socials

Simple Socials is a social media networks widget that automatically uses your settings from existing plugins such as Yoast. Just set your main social media URLs in Yoast and Simple Socials will pick them up and show them on your site. You can also add your own networks and contact methods, such as a phone number, a link to your “contact us” page, or whatever you want.

If you don’t use Yoast, you can still use Simple Socials!

Simple Socials Widget
Simple Social Media Widgets

Changelog: Simple Socials

Version 1.1.12

Released: 2022-03-13

Added the "networks" parameter to the all_social_buttons shortcode so you can specify a space-separated list of social network slugs. If omitted, it defaults to showing all socials (as it did before).

Version 1.1.11

Released: 2022-01-24

Added an option to the widget so you can specify the link target blank, top, etc... with rel="noopener".

Version 1.1.10

Released: 2022-01-07

Minor updates to the CSS.

Older releases

Minor updates and fixes, and two new features to reduce the amount of custom CSS you need to write.

  • Updated the CSS so that social icons work better in the Astra primary menu (as a widget).
  • Added new "Shape" (round|square) option to the widget for button shape.
  • Added new "Spacing" to the widget to control the gap between the buttons.
  • Integrated newest version of Power Plugins updater.
  • Integration with Power Plugins updates.
  • Code refactoring and minor roll-up.
  • Stub
  • Add built-in support for showing a phone number.
  • Small adjustment to the CSS to better v-center FA large icons.
  • Add built-in support for showing default RSS2 feed icon.
  • Add a the social_isenabled$network action to easily disable a social with __return_false.
  • Made the require_once statements more robust in the plugin main file. Only really affects people who use wp-cli to interact with WordPress.
  • Switch between FontAwesome 4 and FontAwesome 5 with a filter.

Important FontAwesome doesn't ship with this plugin. It is assumed that your site already has FA4 or FA5 available.

  • Pick and choose which socials to show in individual widgets.
  • Added smps_get_social_url() to functions.php so you can grab social network
  • URLs from your own code.
  • Minor tweaks and revisions to support the documentation on Power Plugins.
  • Initial build.

Create a Custom Social

To create a custom social, you need to add two hooks in your code. One to add your social to the master list, and the other to provide the URL. In this example, we’ll create a custom social button for Weibo.

In your custom child theme, open functions.php and add the following code:

/**
 * Add Weibo to the list of socials.
 */
function smps_all_socials_custom(array $socials) {
    $socials['weibo'] = array(
        'text' => 'Connect on Weibo',
        'icon' => '<i class="fab fa-weibo"></i>',
    );

    // You can add more socials here...
    // $socials['social-name'] = array(
    //     'text' => 'Tool Tip / Button text',
    //     'icon' => '<i class="fas fa-question"></i>',
    // );

    return $socials;
}
add_filter('all_socials', 'smps_all_socials_custom');

/**
 * Set the URL for the Weibo social.
 */
function smps_social_url_weibo($url) {
    return 'http://weibo.com/yourprofile';
}
add_filter('social_url_weibo', 'smps_social_url_weibo');

Then all you need to do is add a splash of colour. Open your custom child theme’s style.css, add the following:

/**
 * Set the background colour for Weibo social buttons.
 */
.smps-network-weibo {
    background-color: #d1570e;
}

Action & Filter Hooks

Filters you can hook in Simple Socials

HookParametersNotes
all_socials
filter
$all_social_metasReturns a list of all social network metas in an array, whether they social networks are configured, or not.
configured_socials
filter
$configured_socialsLike the all_socials filter, but it only returns socials network metas that have been configured, which means that each social network meta has a value in its “url” key.
social_text_<network>
filter
$labelText used when a social button has its label showing. Also used for screen readers.
social_icon_<network>
filter
$htmlHTML for the social network icon. By default, this is a FontAwesome 5 icon,.
social_url
filter
$url
$network
$social_meta
Return the URL for the for the social media network specified in $network. If the network is not configured, return null/empty.
social_url_<network>
filter
$url,
$social_meta
As above, but with the social media network passed in the filter name instead of as a parameter to the filter.
Simple Socials : WordPress filter hooks

Custom Styling & Icons

By default, Simple Socials uses Font Awesome 5 to draw its icons, but you can change this and override colours, size and layout too.

ImportantBecause most websites already have Font Awesome installed, Simple Socials dos not ship with any icons. If your site doesn’t already use Font Awesome, you’ll either need to add it, or supply your own icons.

Styling the Layout

Example CSS snippets.

/*
 * Change the colour of the email button
 */
.smps-network-email {
    background-color: blue;
}

/*
 * For the Socials widget in the site footer, put a gap of 1em
 * between each button and make the buttons round.
 */
footer .smps-socials ul {
    gap: 1em;
}

footer .smps-social-btn {
    border-radius: 50%;
}

/*
 * Change the large size so the icons aren't not quite-so-big.
 */
.smps-socials.large .smps-social-btn {
    font-size: 14pt;
}

Changing the Icons

Font Awesome 4 & 5

By default, Simple Socials outputs icon HTML snippets for Font Awesome 5. Use the smps_font_awesome_major_version filter to change which version of Font Awesome to use.

// Tell Simple Socials to output icon HTML form FA 4.7
add_filter('smps_font_awesome_major_version', function () {
    return 4;
});

Custom Icons

You can change individual social button icons like this:

// Set a custom icon for the Email button.
function custom_social_icon_email($url) {
    // Get the base URL of our custom child theme.
    $base_uri = get_stylesheet_directory_uri();

    $icon_url = sprintf('<img src="%s" />', esc_url($base_uri . '/email.png'));

    return $icon_url;
}
add_filter('social_icon_email', 'custom_social_icon_email');

…or you could set all the icons in a single filter, like this:

// Override some social icons.
function custom_all_socials(array $socials) {
    // Get the base URL of our custom child theme.
    $base_uri = get_stylesheet_directory_uri();

    $socials['phone']['icon'] =
        sprintf('<img src="%s" />', esc_url($base_uri . '/phone.png'));

    $socials['email']['icon'] =
        sprintf('<img src="%s" />', esc_url($base_uri . '/email.png'));

    $socials['facebook']['icon'] =
        sprintf('<img src="%s" />', esc_url($base_uri . '/facebook.png'));

    return $socials;
}
add_filter('all_socials', 'custom_all_socials');

Social Media Button Shortcodes

Simple Socials comes with a couple of shortcodes so you can sprinkle social media buttons around your site, in the content or in sidebars.

Shortcode: social_button

Add inline social media buttons to your content with a shortcode:

Social media button shortcode
Social media button shortcode
ParameterDescription
network
string : slug
The slug of the (social) network to show, e.g. “facebook”, “email” or “youtube”.
show_icon
bool : default=true
Show the network’s icon?
show_label
bool : default=false
Show the network’s label?
Parameters for the social_button network

Shortcode: all_social_buttons

Add a group of social media buttons as a shortcode:

ParameterDescription
networks
string : slug
A space-separated list of the socials you want to show. If left empty, all configured networks will be shown. Example, “facebook twitter email”
show_icon
bool : default=true
Show the network’s icon?
show_label
bool : default=false
Show the network’s label?
size
string : default=”regular”
Valid values are “regular” or “large”.
orientation
string : default=”vertical”
Valid values are “vertical” or “horizontal”.
class
string
A space-separated list of CSS classes.
Parameters for the all_social_buttons network

Reviews

There are no reviews yet.

Be the first to review “Simple Socials”