GP Social Share

Description

This plugin uses hooks append social share icons to your content.

It uses the if_single() WordPress hook to ensure only fires on all single posts or the included WooCommerce hooks.

Configured shared content:

Image = post featured Image – full url
Title = post title
Content = the first 40 words of the content
URL = the post permalink

Social Media Channels

These are the social channels currently supported by the plugin
* Facebook
* Twitter
* Google+
* Pinterest
* LinkedIn
* WhatsApp
* Email

Customisations

If you want to find custom icons, I recommend you check out https://iconmonstr.com

To use Iconmonstr SVG code
1. Search for your required icon
1. Click on the icon you like
1. Ensure SVG is selected
1. Agree to the license conditions
1. Click on Embed
1. Ensure Inline is selected
1. Highlight the displayed SVG code
1. Copy and paste the code into the relevant icon section
1. Save Changes at the bottom of the page

You can add more sharing using the following function and modifying it as required

function add_extra_icons($social_links) {

    $title = get_the_title();
    $url = urlencode( get_permalink() );
    $excerpt = wp_trim_words( get_the_content(), 40 );
    $thumbnail = get_the_post_thumbnail_url( 'full' );
    $author_id=$post->post_author;
    $author = get_the_author_meta( 'display_name' , $author_id );
    // Swap your svg code
    $icon = '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M14.238 15.348c.085.084.085.221 0 .306-.465.462-1.194.687-2.231.687l-.008-.002-.008.002c-1.036 0-1.766-.225-2.231-.688-.085-.084-.085-.221 0-.305.084-.084.222-.084.307 0 .379.377 1.008.561 1.924.561l.008.002.008-.002c.915 0 1.544-.184 1.924-.561.085-.084.223-.084.307 0zm-3.44-2.418c0-.507-.414-.919-.922-.919-.509 0-.923.412-.923.919 0 .506.414.918.923.918.508.001.922-.411.922-.918zm13.202-.93c0 6.627-5.373 12-12 12s-12-5.373-12-12 5.373-12 12-12 12 5.373 12 12zm-5-.129c0-.851-.695-1.543-1.55-1.543-.417 0-.795.167-1.074.435-1.056-.695-2.485-1.137-4.066-1.194l.865-2.724 2.343.549-.003.034c0 .696.569 1.262 1.268 1.262.699 0 1.267-.566 1.267-1.262s-.568-1.262-1.267-1.262c-.537 0-.994.335-1.179.804l-2.525-.592c-.11-.027-.223.037-.257.145l-.965 3.038c-1.656.02-3.155.466-4.258 1.181-.277-.255-.644-.415-1.05-.415-.854.001-1.549.693-1.549 1.544 0 .566.311 1.056.768 1.325-.03.164-.05.331-.05.5 0 2.281 2.805 4.137 6.253 4.137s6.253-1.856 6.253-4.137c0-.16-.017-.317-.044-.472.486-.261.82-.766.82-1.353zm-4.872.141c-.509 0-.922.412-.922.919 0 .506.414.918.922.918s.922-.412.922-.918c0-.507-.413-.919-.922-.919z"/></svg>';
    $extra_icons = array(
        '<a href="https://reddit.com/submit?url={' . $url . '}&title={' . $title . '}" class="add-share" title="' . __( 'Add this post!', 'gp-social' ) . '">' . $icon . '</a>',
    );

    // combine the two arrays
    $social_links = array_merge($extra_icons, $social_links);

    return $social_links;
}
add_filter('add_social_icons', 'add_extra_icons');

You can add prefix text like this

function prefix_text($content) {
    $content = 'Social Share This';
    return $content;
}
add_filter( 'add_social_prefix', 'prefix_text' );

Screenshots

  • Icon SVG code options
  • Colour options
  • Settings

Installation

Ensure GeneratePress is your current active theme

  1. Upload the plugin files to the /wp-content/plugins/plugin-name directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Appearance->GP Social Share screen to add your own SVG code for the icons and choose your hook placement

FAQ

Can I use outside of hooks

You can use the following shortcode
[gp-social]

Nothing happens when I activate the plugin

Ensure you have the GeneratePress Theme active.

Do I have to use the premium version of the GeneratePress Theme?

No. This plugin works with the theme and does not require the premium plugin.

What if the hook I want to use isnt in the option, want it in multiple locations or want to apply some condtional logic?

You can use the following action to display the social share options whenever/wherever you like, just change out the_hook_you_require for the one you want to use

add_action( 'the_hook_you_require','add_social_icons' );
Can I display the amount of times my post has been shared?

No. This plugin does not use any API’s or receive any data from the shared content. It is intentionally built to be light weight.

Can I change the default links?

Yes. All the social media links are customisable with their own function.
* Facebook = gp_social_facebook_link
* Twitter = gp_social_twitter_link
* Google+ = gp_social_google_link
* Pinterest = gp_social_pinterest_link
* LinkedIn = gp_social_linkedin_link
* WhatsApp = gp_social_whatsapp_link

an example would look like this

function gp_social_twitter_link() {

    $title = get_the_title();
    $url = urlencode( get_permalink() );

    $icon = '<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewBox="0 0 24 24"><path d="M12 0c-6.627 0-12 5.373-12 12s5.373 12 12 12 12-5.373 12-12-5.373-12-12-12zm6.066 9.645c.183 4.04-2.83 8.544-8.164 8.544-1.622 0-3.131-.476-4.402-1.291 1.524.18 3.045-.244 4.252-1.189-1.256-.023-2.317-.854-2.684-1.995.451.086.895.061 1.298-.049-1.381-.278-2.335-1.522-2.304-2.853.388.215.83.344 1.301.359-1.279-.855-1.641-2.544-.889-3.835 1.416 1.738 3.533 2.881 5.92 3.001-.419-1.796.944-3.527 2.799-3.527.825 0 1.572.349 2.096.907.654-.128 1.27-.368 1.824-.697-.215.671-.67 1.233-1.263 1.589.581-.07 1.135-.224 1.649-.453-.384.578-.87 1.084-1.433 1.489z"/></svg>';
    $link = '<a href="https://twitter.com/share?url=' . $url . '&text=' . $title . '" class="tw-share" title="' . __( 'Tweet this post!', 'gp-social' ) . '">' . $icon . '</a>';

    return $link;
}
Can I change the email body?

Yes. Just add a function called gp_social_email_body which returns your body content.

Can I use the media uploader to upload SVG icons?

No. WordPress has SVG disabled by default due to potential security issues, the decision was made to support this and stick to inline SVG code.

Reviews

October 21, 2019
Thank you for a simple, beautiful, lightweight social share plugin. And compatible one of my favorite theme/frameworks (GeneratePress).
September 8, 2019
I'm totally impressed by this simple plugin that Is customizable in its icons by pasting directly SVG code, position of the elements and labels. Works like a charme with Generatepress; it's a must on each website I design. Great job Jon!
May 5, 2019
Величезне дякую автору! Дуже якісно зроблено і дуже продумано.
July 28, 2018
Lightweight, does what it says, author is highly responsive to support requests and feature requests. Highly recommended.
Read all 8 reviews

Contributors & Developers

“GP Social Share” is open source software. The following people have contributed to this plugin.

Contributors

Translate “GP Social Share” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.2

Updated settings page extensions
fixed wp_debug error

1.1.4

Fixed bug for incorrect twitter
Fixed deprecated get_the_author function
Fixed bug with undefined index when debug is active
Fixed potential bug with is_plugin_active(‘woocommerce/woocommerce.php’) check and changed to class_exists( ‘WooCommerce’ )
Update Meta Box

1.1.3

Fixed bug where not pulling images when used in hook outside the loop

1.1.2

Fixed missing file

1.1.1

Added ability to choose WooCommerce hooks if WooCommerce is active

1.1.0

Added ability to change default links

1.0.9

Accidently left a var_dump output

1.0.8

Added switch to disable hooks so can use own and/or shortcode functions

1.0.7

Add prefix text support

1.0.6

Can now remove svg code from backend to remove from frontend rather than using css to hide unwanted social profiles

1.0.5

Fixed folders not uploaded for 1.0.4

1.0.4

Fixed bug with shortcode
Added colour styling support
Improved backend UI

1.0.3

Added shortcode support

1.0.2

Added support for custom email body

1.0.1

Wrapped functions in class for conflict support
Updated readme
Added WhatsApp support
Added hook option to display icons
Converted jQuery to vanilla JS

1.0

This version allows you to paste in your own SVG icon code

0.5

  • Initial Build