-
Notifications
You must be signed in to change notification settings - Fork 27
/
readme.txt
276 lines (189 loc) · 15 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
=== Social Sharing Plugin - Social Warfare ===
Contributors: holas84, webinator, warfareplugins, cdegraff1, goqflash, andbalashov
Tags: sharing buttons, social media share, floating share buttons, social sharing plugin, share buttons
Requires at least: 4.5.0
Tested up to: 6.6
Stable tag: 4.5.4
Requires PHP: 5.6
License: GPL v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
The most beautiful, responsive, lightning fast social share buttons built to boost shares and drive more traffic without slowing down your site.
== Description ==
Get more social shares which can lead to more website traffic with the best WordPress social sharing plugin! Built by a group of social media marketing experts and world class developers who are obsessed with performance. Learn more at <a href="https://warfareplugins.com/?utm_medium=repository&utm_campaign=description&utm_source=wordpress_org&utm_content=repo_description" rel="friend" target="_blank">Warfare Plugins</a>.
= WordPress Sharing Plugin =
Most WordPress social sharing plugins slow down your site, are not attractive, and don't work the way you would hope. Social Warfare share buttons are both lightning fast and beautiful.
Not only will it never slow down your website like other sharing plugins, we give you the most attractive share buttons available that look great no matter what screen size or resolution.
> Social Warfare has boosted social shares by **300%** without slowing down my blog.<br>
> Eddie Gear - Professional Blogger
You can choose from the top social networks sharing buttons, including:
* Facebook
* Twitter
* Pinterest
* LinkedIn
* Mix
You can also choose where you want the share buttons to show up. Choose from the following placement options:
* Above the post content
* Below the post content
* Both above and below the post content
* None (or) Manual placement
We also give you the ability to have **floating share buttons** follow your readers down the screen when static (non-floating) buttons are not in view. This way the reader will always have easy access to your share buttons, no matter where they scroll on your page.
> "This is by far the best looking social sharing plugin I have seen on the net!"<br>
> David Foster, Online Personality
= Popular Posts Widget based on Social Share Counts =
Wouldn't you love to show what your most popular posts are based on the number of social shares they've received? Social Warfare allows you to do just that.
You can even choose to display most your popular posts based on which social network they were popular on!
Social Warfare's Popular Posts widget allows you to display and customize the look with:
* Post thumbnail images
* Image and text size
* Custom visual themes
* Custom date range
= Click to Tweet Quotes =
A simple and effective way to create tweetable quotes right inside your posts or pages. This has proven to increase the average number of tweets per article dramatically.
= Use Shortcodes to Manually Place Social Share Buttons Anywhere =
If you want to place buttons in the middle of an article, you can with our `[social_warfare]` shortcode.
What if you wanted to add share buttons to a page but actually have them share out a different page altogether (like being able to share your Subscribe page from your Thank You)? Social Warfare allows you to do this!
If you're experienced with PHP, you can also hook Social Warfare into your theme templates for hyper customization.
= Content Protection =
We've built our highly demanded <a href="https://wordpress.org/plugins/frame-buster/">Frame Buster</a> right into Social Warfare so that you are protected from content hijackers seeking to place their advertisements on top of your content without your permission.
> Social Warfare is by far the best social sharing plugin I've ever used. I recommend it to all of my clients.<br>
> Andrew Wilder, Marketing Consultant
= Premium Social Sharing Options =
_Social Warfare - Pro_ license holders also get access to the following social network share buttons:
* Reddit
* Tumblr
* Yummly
* WhatsApp
* Pocket
* Buffer
* Hacker News
* Flipboard
* Email
In addition to the extra social networks, you can also reactivate, track and display **Twitter tweet counts**!
= Pin All the Images =
Enabling the Image Hover Pin Button will place a "Pin" button over top of every image inside of your content when a reader hovers their mouse over it. This makes every image on your page highly sharable to Pinterest!
= Powerful Share Customization =
Social Warfare is among the pioneers of customizing how your content is shared, particularly with Pinterest. The _Social Warfare - Pro_ add-on allows you to decide exactly which image, title and description appears when your content is shared on sites like Facebook and LinkedIn. This also applies to any other networks that use Open Graph data for social shares.
On top of that, you can upload a **custom Pinterest image** and write a custom description so that when someone clicks the pin button, the exact image you've chosen shows up with exactly the description you've written. No more hoping that your readers choose the best image and write an optimal description for you!
In addition to that, you can also write a custom tweet for when someone clicks on the Twitter button. The exact tweet you wrote will be displayed in the Twitter share box and Social Warfare will automatically add the link to your content and your @username to the end of it.
These capabilities are what professional social media marketers and bloggers have been waiting for.
= Social Warfare - Pro Sharing Options, Custom Design and Placements =
Customize which sharing networks you display, how your buttons look and where they show up.
You can choose from 6 different button shapes, 8 different color themes **plus** the ability to choose custom colors for your buttons. The design combinations are _unlimited_.
You will also get 6 different Click to Tweet styles and an option to create your own style via your theme's CSS.
= Minimum Social Proof =
If you would prefer to only show counts after a certain minimum number of shares has been met (to avoid "negative social proof"), you can do that as well. Or if you'd rather just have no counts showing at all, just turn them off altogether.
= Share Recovery: Your Lost Share Counts Returned! =
Have you ever changed permalink structures, domain prefixes, connection protocols (http-https) or just flat out changed domains and ended up **losing all your social share counts?**
We've built a tool right into Social Warfare called <a href="https://warfareplugins.com/support/recover-social-share-counts-after-changing-permalink-settings/?utm_medium=repository&utm_campaign=description&utm_source=wordpress_org&utm_content=repo_description" target="_blank" rel="friend">Share Recovery</a> which allows you to get back your lost share counts if you've ever had to modify your permalink settings.
= Social Authorship, Twitter Cards, Rich Pins and More =
It's nice to have your stuff shared on social media, it's even nicer when you get mentioned in the social share! With Social Warfare you can ensure that your authorship is always in place, including:
* Facebook author and publisher attribution
* Facebook app link (advanced users)
* Twitter publisher and author attribution
* "via @username" added to the ends of tweets
* "via @username" added to the ends of pin descriptions
You can also activate Twitter Cards (Large Image Cards) so that tweets sent from your site are always media rich and much more likely to get engagement.
Our plugin also ensures that your site is Rich Pin ready so that your Pins look as good as possible.
= Link Shortening, Analytics Campaign and Button-click Tracking =
Shorten shared links automatically using your own Bitly credentials so you can track how many clicks are occurring on your links.
Additionally, if you're a Google Analytics user, you can set up Analytics tracking so that each shared link contains a networks specific UTM tracking code. This way you can track all inbound links that come as a direct result of Social Warfare shares.
You can also activate Event Tracking so that you can also see in Google Analytics exactly how many times your buttons are clicked.
It is without question that Social Warfare is the most powerful social sharing plugin available for WordPress. You get all these premium features while still benefitting from a super-fast, light-weight code base.
= Third-Party Services =
This plugin uses APIs from the following third-party services for sharing content. Please review their terms and privacy policies:
**Bitly**
Why and When We Use Bitly API:
This plugin uses the Bitly API to shorten URLs for shared content. When a user enables the "URL Shortening" option in the plugin settings, the plugin will make requests to the Bitly API to generate shortened URLs.
Data Sent to Bitly:
- URLs to be shortened
- Authentication data (Bitly Access Token)
Impact on User Data:
When using the Bitly API, URLs that users wish to shorten will be sent to Bitly's servers. Users should be aware that the data is transmitted to Bitly, and they should review Bitly's privacy policy to understand how their data is handled.
- [Bitly Service Link](https://bitly.com)
- [Bitly Terms of Service](https://bitly.com/pages/terms-of-service)
- [Bitly Privacy Policy](https://bitly.com/pages/privacy)
**Warfare Plugins**
Why and When We Use Warfare Plugins:
This plugin integrates with the Warfare Plugins API to manage addon license keys and verify the validity of user subscriptions. The API is used when users register or unregister their plugin license.
Data Sent to Warfare Plugins:
- License key
- Site URL
- Plugin version
Impact on User Data:
When using the Warfare Plugins API, the license key and site URL are sent to the Warfare Plugins server to verify the subscription status. Users should be aware that their license key and site URL are transmitted to the server, and they should review Warfare Plugins' privacy policy to understand how their data is handled.
- [Warfare Plugins Service Link](https://warfareplugins.com)
- [Warfare Plugins Privacy Policy](https://warfareplugins.com/privacy-policy)
**Pinterest**
Why and When We Use Pinterest:
This plugin integrates with the Pinterest API to allow users to share content directly to their Pinterest boards. When a user clicks the Pinterest share button, the plugin will generate a request to Pinterest's API to create a new pin.
Data Sent to Pinterest:
- URL of the content to be shared
- Description of the content (if provided)
- Image URL (if specified)
Impact on User Data:
When using the Pinterest API, the URLs, descriptions, and images that users wish to share will be sent to Pinterest's servers. Users should be aware that this data is transmitted to Pinterest, and they should review Pinterest's privacy policy to understand how their data is handled.
- [Pinterest Service Link](https://www.pinterest.com)
- [Pinterest Terms of Service](https://policy.pinterest.com/terms-of-service)
- [Pinterest Privacy Policy](https://policy.pinterest.com/privacy-policy)
== Installation ==
This section describes how to install the plugin.
1. Upload the `social-warfare` directory to your `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Visit the 'Social Warfare' menu item in your admin sidebar
== Frequently Asked Questions ==
= I downloaded this plugin but don't have an Social Warfare - Pro license. How can I get one? =
You can sign up for an Social Warfare premium license by <a href="https://warfareplugins.com/?utm_medium=repository&utm_campaign=description&utm_source=wordpress_org&utm_content=repo_faq" rel="friend" title="Social Warfare Plans and Pricing">visiting our website</a> and choosing the package that best suits your needs.
= How do I use the shortcodes? =
Shortcodes are used like so: [social_warfare]. If you would like to specify a different share URL than the page you are placing the buttons on, you can use this format: [social_warfare post_id="3"] where 3 is the ID number of the post or page you want to have shared.
= Something isn't working as expected. How can I get support? =
We have a growing archive of <a href="https://warfareplugins.com/support/" rel="friend" title="Warfare Plugins Support">Support Articles</a> to help you address most questions and troubleshooting. If you wish to receive email support, you will need a Pro license.
== Screenshots ==
== Notes ==
= Testimonial =
> Social Warfare is by far the best social-sharing-button plugin I've ever used. I recommend it to all of my clients.<br>
> Andrew Wilder, Consultant
> It's a beautiful, super lightweight, and highly customizable plugin. I love everything about it!<br>
> Rebekah Radice, Social Media Strategist
> "This is BY FAR the best looking social sharing plugin I have seen on the net!"<br>
> David Foster, Online Personality
> I use Social Warfare because it's the only sharing plugin that can be customized to blend seamlessly with my branding.<br>
> Andrea Beltrami, Visual Marketer
> Social Warfare has boosted social shares by <strong>300%</strong> without slowing down my blog.<br>
> Eddie Gear - Professional Blogger
> After installing Social Warfare I straight away saw an increase in social shares and traffic.<br>
> Robert Ryan, Professional Web Designer
== Changelog ==
This changelog covers version 4.5.0 and later. The full changelog can be found on our <a href="https://github.com/warfare-plugins/social-warfare/blob/master/CHANGELOG.md" target="_blank">GitHub</a>.
= 4.5.3 (12 Aug 2024) =
* Updated stable tag and version numbers to 4.5.3.
* Updated allowed HTML tags and attributes in `SWP_Header_Output.php` to enhance security and compatibility.
= 4.5.2 (5 Aug 2024) =
* Updated stable tag and version numbers to 4.5.2.
* Changed hook from `wp` to `wp_loaded` for deferred class instantiation to improve performance and compatibility.
* Updated plugin version to 4.5.2.
= 4.5.1 (29 Jul 2024) =
* Updated `.wp-env.json` with social-warfare-pro plugin version 4.5.1.
* Improved security by updating `SWP_Addon.php` to use 'security' instead of 'nonce'.
* Updated `SWP_Options_Page.php` to use translation functions for better internationalization support.
= 4.5.0 (15 Jul 2024) =
* Implemented linting and WP ENV for local development.
* Added PHPCS ruleset.
* Removed coding standards workflow file.
* Added compiled HTML property to `SWP_Notice` class.
* Created and updated CODEOWNERS.
* Removed unnecessary lines and comments.
* Added API URLs array to `SWP_Post_Cache` class.
* Created `dependabot.yml`.
* Updated multiple dependencies and workflows.
* Added Security Policy.
* Refactored PHPDoc comments and auto-registered widget in `SWP_Popular_Posts_Widget`.
* Escaped HTML output in `SWP_Widget.php`.
* Enhanced form rendering in `SWP_Popular_Posts_Widget.php`.
* Updated `meta_key` in `SWP_Popular_Posts_Widget`.
* Optimized settings storage and HTML tag stripping in `SWP_Utility.php`.
* Modified 'excerpt_more' filter.
* Removed screen options tab from the admin page.
* Corrected variable name typo in `SWP_Utility.php`.
* Refactored and improved readability, naming conventions, and security in multiple classes.
* Created persistent notices.
* Updated `README.md`.