Post Promoter Pro has a large number of Hooks and Filters to allow customization of the functionality as well as extending it’s capabilities. This is a collection of code snippets and tutorials to show you how to get the most out of Post Promoter Pro. If you need more information on Hooks and Filters in WordPress, you can visit the WordPress.org Codex page for a detailed explanation.

Adding Token Replacements for Default Share Text

Instructions on how to add your own token replacements for the default share text. Covers both registering a token as well as replacing it.
Change role for Post Promoter Pro management

By default, Post Promoter Pro’s settings are only manageable by users with the ‘administrator’ role, follow these instructions to change that.

Changelog

2.3.27, October 9, 2019

Fix: Updated timepicker library to fix compatibility with ACF.
Fix: Improved detection of existing sessions when attempting to start a session.

2.3.26, October 9, 2019

Fix: Improved performance of finding image attachment ID when using Twitter Cards.

2.3.25, October 2, 2019

Fix: Updated LinkedIn to use the 2.0 API. Requires disconnecting and reconnecting your account.

2.3.24, August 4, 2019

Fix: Improved compatibility with saving and inserting new posts that was preventing crons from getting scheduled.

2.3.23, June 3, 2019

Fix: Prevent a PHP notice about sessions being able to start.

2.3.22, March 19, 2019

Fix: Corrected an issue causing Facebook to lose it's connection and not allow picking pages.
Fix: Facebook: Removed 'Me' as an option for where to publish as Facebook no longer supports this.
Fix: Corrected some issues with PHP 7.2 compatibility.
Fix: Allow the Local URL admin notice to be permanently dismissed.
Fix: Deleting user meta wasn't being called correctly.

2.3.21, October 9, 2018

Fix: Further stability to the Twitter oAuth process.

2.3.20, August 20, 2018

Fix: Resolved an issue connecting Twitter accounts.

2.3.19, June 21, 2018

Fix: Resolved an issue that caused scheduled share to not be scheduled.

2.3.18, June 18, 2018

Fix: Corrected an issue related to Pinterest data when saving a post.

2.3.17, May 14, 2018

Fix: Prevent share logs from showing in front end search and queries.
Fix: Verify the Pinterest settings are present before saving.
Fix: Correct an issue with the Welcome page with PHP 7.2+

2.3.16 - April 16, 2018

Fix: Corrected incorrect HTML markup in the Pinterest metabox.

2.3.15 - April 9, 2018

Fix: Better compatibility with saving Post Promoter Pro content when saving posts created with page builders.
New: Added support for alt-text on Twitter Card images.
New: Added ability to assign 'Share on Publish' defaults on a per-post type basis.
New: Authors can now opt-in to Retweet any initial or scheduled shares.
New: Added ability to define a Pinterest image for Open Graph.

2.3.14 - January 30, 2018

Fix: Improved the detection for staging sites.
Fix: Attempt to not load Font Awesome if it is already included from another source.
Fix: Set capability required for Post Promoter Pro settings to 'manage_options'.
Tweak: Added a 'Refresh Access' button to the Account list table.

2.3.13 - November 18, 2017

Fix: Possible issue loading translation files when directory has been changed.
Fix: Incorrect spelling of function name.
Tweak: Corrected a reference to 140 characters for Twitter.

2.3.12 - November 8, 2017

New: Support Twitter's new 280 character count.
New: Prevent sharing when a development or staging site is detected.
Fix: Do not show Twitter section on profile editor unless main Twitter account is connected.
Fix: Make the CSS Selectors more specific.

2.3.11 - September 11, 2017

Fix: Prevent possible duplicate scheuled share from being sent.
New: When a post is published or updated (after being published) send a request to Facebook to clear the Open Graph cache.

2.3.10 - March 5, 2017

Fix: Schedule view and dashboard widget using default text instead of custom text.
Fix: Possible fatal error when authorizing LinkedIn on PHP 7.1.
Tweak: Use new delete icon for Facebook and LinkedIn.
New: Add support for beta versions.

2.3.9 - February 6, 2017

Fix: Possible PHP notice when building share message.
Fix: Trashing posts with shares caused PHP warnings.
Tweak: Updated plugin updater class to newest version.

2.3.8 - November 11, 2016

Fix: Existing Twitter character counts were not loaded on initial editing of a post.
Fix: Twitter character count background colors were not correct on initial editing of a post

2.3.7 - November 6, 2016

FIX: If local tokens file is empty, fallback to licensed tokens.
FIX: Old upgrade routine showing on initial installation.
New: Allow duplicating an existing Tweet.
New: Improved meta box UI with new icons.
New: Support pages natively.
New: Save the share_id to the logs as post meta.

2.3.6 - September 19, 2016

FIX: Remove support for Bit.ly avatar.
FIX: Incorrect scope for LinkedIn when using custom API Tokens.
FIX: Update Twitter character counts to ignore images when warning of Tweet length.
FIX: Translation updates and corrections in some missing textdomains.
FIX: Fixed Bit.ly authorization not showing invalid password error.

2.3.5 - July 16, 2016

FIX: Scheduled shares can sometimes be marked as past-share on Facebook and LinkedIn.

2.3.4 - July 11, 2016

NEW: Added a filter for UTM Tag contents to allow customization.
FIX: Delete action from schedule removes post meta but not scheduled event.
FIX: Scheduled Tweets can sometimes be marked as past-share on Twitter.

2.3.3 - July 6, 2016

FIX: On existing posts, removing Share on Publish and changing the post status to Publish in the same action will cause the share to be sent.
FIX: Twitter not always allowing deleting rows.
FIX: Remove extra word 'within' from LinkedIn and Facebook expiring authentication messages.
FIX: First scheduled tweet inputs can be falsely marked with past-share class when using timezones and or greater than GMT.

2.3.2 - July 1, 2016

FIX: Twitter - Card description missing when no excerpt provided and fallback is used.

2.3.1 - June 29, 2016

FIX: Possible fatal error if WP_Logging class is already declared.

2.3 - June 28, 2016

NEW: You can now set your Facebook and LinkedIn shares to be on a schedule instead of just at publishing.
NEW: Notices for Facebook and LinkedIn authorization expiration are now dismissible.
NEW: Your past Tweets are now 'hidden' when editing a post, and can be toggled to show or hide, saving space in the editor screen.
TWEAK: Updated image thumbnail sizes for Twitter, LinkedIn, and Facebook to meet the new standards.
TWEAK: Improved the plugin self-updater to be more efficient.
TWEAK: All API calls are now stored using the WP_Log class, allowing for easier debugging.
FIX: Sometimes presented with an 'invalid argument' when no Tweets are configured for a post.
FIX: Re-authentication dates keep increasing as time goes for Facebook and LinkedIn.
FIX: If WP_Cron is missed, there is a potential for many missed Tweets to go out at once. Only send if it's within an hour.
FIX: Twitter description meta tag was dependent on the post_excerpt.
FIX: Twitter character count colors were inconsistently changing.
FIX: Scheduled shares were being recreated upon update if they were previously deleted.

2.2.11 - February 27, 2016

FIX: Fix type in ppp_manage_options filter to apply to all settings screens

2.2.10 - February 5, 2016

FIX: Check that builder function exists before calling it
FIX: Allow the ppp_manage_options filter to apply to all settings screens

2.2.9 - January 1, 2016

FIX: Conflict with scheduling shares for Events with The Events Calendar

2.2.8 - December 18, 2015

FIX: Invalid markup in Tweet metabox
FIX: Spelling errors
FIX: Properly detect MySQL version from $wpdb instead of deprecated function

2.2.7 - September 22, 2015

NEW: Retweet as Author
TWEAK: Convert H2 tags to H1 for settings
TWEAK: Account list table icon column is too wide
FIX: Unchecking Tweet / Share boxes not respected on draft save
FIX: Apostrophe in name makes page dropdown always show 'Me'
FIX: Character count color indicator incorrect in some situations

2.2.6 - July 16, 2015

FIX: Upcoming Tweets dashboard widget should not be visible to subscribers

2.2.5 - June 15, 2015

FIX: Facebook Post As dropdown showing 'Me' incorrectly
FIX: Inputs with double quotes not showing correctly
NEW: Ability to enable 'Share on Publish' by default for each network

2.2.4 - May 9, 2015

FIX: Twitter character count should be accurate on page load
TWEAK: Account for attached images in Twitter character count warnings
NEW: Twitter Cards now support Creator

2.2.3 - April 26, 2015

NEW: Dashboard widget to show our next X scheduled Tweets
NEW: Added warning when scheduling a Tweet that is within 30 minutes of an existing Tweet
NEW: Added Unit tests
TWEAK: Re-Added and Improved the Tweet Character Counter

2.2.2 - April 9, 2015

FIX: If the expires_in comes back empty, force one
TWEAK: Don't redirect to the about page on dot releases

2.2.1

FIX: Corrected an issue where Titles/Descriptions were escaping out of Twitter Card Meta Tags

2.2

NEW: Free Form Tweet Scheduling
NEW: Twitter Card Support
NEW: Ability to change attached Twitter Images
NEW: Allow local social media tokens
TWEAK: Updated Schedule List View with attached image and better column widths
TWEAK: Updated thumbnail sizes for Twitter and Facebook to new dimensions
FIX: CSS Conflict in the Media List View
FIX: 'Post As' getting reset to 'Me' after re-newing Facebook tokens
FIX: Updated the plugin updater class to the most recent version

2.1.3

FIX: Twitter "Share at time of Publish" content not replacing {post_title} and other tokens

2.1.2

FIX: Facebook and LinkedIn token reminders could show a negative date
FIX: Expiration notices caused PHP notices when disconnected
FIX: Throw a notice up if cURL isn't enabled, and don't load the plugin
FIX: Run the entities and slashes cleanup for Facebook and LinkedIn
FIX: A schedule post that is unscheduled wouldn't delete scheduled shares

2.1.1

FIX: Corrected and made the save_post functions, to save the metabox content, more consistent
FIX: LinkedIn reference on the Facebook metabox
NEW: Added README.txt

2.1

NEW: Facebook Support
UPDATED: Redesigned Account management list with additional column for debugging
UPDATED: Tweet length indicators now account for Featured Images
UPDATED: Moved the plugin to load on plugins_loaded
FIX: Ignore featured image attaching, when no featured image is assigned to post
FIX: LinkedIn Expiration times were incorrect (you may need to disconnect and reconnect LinkedIn)
FIX: Improved Session usage, to help with overall performance
FIX: Any already scheduled shares should be removed when you go back and check to 'not schedule social media for this post'
FIX: Don't stomp on other Dashicons
FIX: Remove the 'autoload' from our ppp_version option
FIX: Stop direct access to core files

2.0.1

FIX: Smarter starting of sessions to be friendly to caching services/layers

2.0

NEW: LinkedIn Support
NEW: WP.me Shortlink Support
NEW: Featured Image Support
TWEAK: Allow a 'None' option for link tracking
TWEAK: Better code organization for easier debugging
TWEAK: Fixing a slight bit of padding on the Twitter Meta Box content
FIX: Correcting an issue with some hosting environments where HTML entities are not decoded
FIX: Bit.ly auth AJAX not working on Network Sites
FIX: Unscheduling already scheduled posts when post is updated to unschedule posts

1.3.0.3

FIX: No more escape characters in strings being shared

1.3.0.2

FIX: Correcting an issue when sharing on publish, when sharing on publish is not selected

1.3.0.1

FIX: Correcting an issue with html character encoding/decoding

1.3

NEW: Share to Twitter on Initial Publish
NEW: Allow number of days to share to be filtered
NEW: Ability to edit the default share text
NEW: Allow days to be enabled and disabled by default
NEW: Identify when two crons are scheduled at the same time
NEW: Bit.ly support
FIX: Better functions to identify when social networks were connected.
FIX: Convert the Analytics to a radio set instead of checkboxes
FIX: Spelling correction on default times

1.2.0.2

FIX: Correcting an issue with the text of an override with no text.

1.2

NEW: Ability to "Share Now" from the schedule view
NEW: Welcome Screen with latest updates
NEW: Added 'ppp_manage_role' filter for the role to see the menu item
NEW: Better handling of the uninstall hook with an opt-in to remove all data
FIX: i18n fixes
FIX: Account for possible race condition in wp-cron

1.1.1

FIX: i18n fixes for incorrect text domain and loading of text domain too late
FIX: Performance improvement when retrieving with social tokens

1.1

NEW: Delete a single scheduled share from the schedule view
NEW: Allow disconnect account from Twitter (instead of only revoking global app access)
FIX: Some characters being encoded when shared

1.0.1.1

FIX: Cease use of closure when getting Google Tag Manager URL to support PHP < 5.3
FIX: Spelling corrections

1.0

Initial Release

Adding Token Replacements for Default Share Text

Change role for Post Promoter Pro management