# Seamless Social Sharing

**Contributors:** 4pplecore  
**Tags:** social, sharing, share buttons, social media, social sharing  
**Requires at least:** 5.8  
**Tested up to:** 7.0  
**Requires PHP:** 7.4  
**Stable tag:** 1.0.13
**License:** GPLv2 or later  
**License URI:** https://www.gnu.org/licenses/gpl-2.0.html

Social sharing buttons with fine-grained design controls and a modern look.

## Description

Social sharing buttons with fine-grained design controls and a modern look.

You can manage all settings in your Wordpress admin from **Settings → Seamless Social Sharing**.

### Features

- **Icon set** with up-to-date SVGs
- **Networks:** enable only the networks you want; drag to reorder
- **Display on:** Posts and Pages
  - Shortcode support to render the buttons anywhere on your website
- **Placement (default):** before content, after content, or both
- **Per‑post override:** use default, before, after, both, or do not show
- **Appearance (no CSS required):**
  - Display mode (icon only, text only, icon + text)
  - Icon/Text color
  - Background color on/off with configurable border radius
  - Label left margin (when icon is shown)
  - Spacing between buttons
  - Wrapper margins (top/bottom)
- **Behavior:** open share dialog in a new tab (default on)
- **Accessibility:** each button includes an ARIA label and the button html is within a semantic `<ul>`

### Supported Networks

- Facebook
- X (Twitter)
- LinkedIn
- Email
- WhatsApp
- Reddit
- Pinterest
- Telegram
- Instagram
- Mastodon
- Bluesky

## Shortcode

Use the shortcode in post / page content or widgets:

```
[seamless_social_sharing]
```

In PHP templates:

```php
<?php echo do_shortcode('[seamless_social_sharing]'); ?>
```

The shortcode renders buttons using your saved settings.

## Installation

1. Upload the plugin to `/wp-content/plugins/` or install it via the Plugins screen.
2. Activate the plugin.
3. Go to **Settings → Seamless Social Sharing** to configure networks, placement, and styles.

## Release

1. Update the plugin `Version` in `seamless-social-sharing.php`.
2. Update `Stable tag` in `readme.txt`.
3. Commit those changes and push `main`.
4. Create and push a matching Git tag, for example:

```sh
git tag 1.0.12
git push origin 1.0.12
```

The GitHub workflow deploys that tag to WordPress.org SVN. It validates that the Git tag, plugin header version, and `readme.txt` stable tag all match before it copies files to `trunk` and creates the SVN tag.

## Need help / got a feature request?

Go to https://4pplecore.dev.

## Frequently Asked Questions

### Where do the buttons show?

By default they show after the content on posts and pages. You can change the placement in Settings or insert them anywhere with the shortcode.

### How do I change the order of networks?

Use the drag‑and‑drop list in Settings. You can also click the up/down arrows to move items.

### Do I need CSS?

No. The plugin outputs minimal inline styles based on your settings. You can still target the `.asss-share`, `.asss-share__item` and `.asss-share__button` classes in your CSS if you want to customize further.

### Do the links open in a new tab?

Yes by default. Toggle the setting "Open share dialog in a new tab".

## To do

- Light / dark mode
- Add your own buttons to your social networks, render in footer, or anywhere
- Sticky buttons option