Revive Social Documentation

Revive Social allows you to automatically share your WordPress posts on Facebook and X (formerly known as Twitter).

Summary

1. Getting Started: Installation and Activation

2. Connecting to your Facebook Account

3. Connecting to your X (Twitter) Account

4. Configuring the General Settings

1. Getting Started: Installation and Activation

Navigate to Dashboard > Plugins > Add New, search for Revive Social, and install and activate the plugin.

2. Connecting to your Facebook Account

1. Navigate to the Revive Social Dashboard and click on the Facebook button.

2. Click on the Sign in to Facebook button.

3. In the new screen, add your Facebook credentials or choose your Facebook account, in case you are already logged in.

a) If you didn’t previously log in to your Facebook account in that browser, you will be asked to enter your credentials.

b) If you’ve previously logged in to Facebook in the current browser, you will be prompted with the current logged-in credentials.

c) In case your Facebook account isn’t connected to any Facebook Page, the authorization will fail. Make sure you add one or multiple Facebook Pages, as mentioned here.

d) If your account is connected to one or more Facebook Pages, in the Authorization process, you will be prompted to select which Page/Pages you want to share to.

e) After that, the Authorization process should proceed, and the window should automatically close in a few seconds.

f) After the authorization is completed, you will be able to see the connected Facebook Pages in the Revive Social dashboard.

3. Connecting to Your X (Twitter) Account

1. Navigate to the Revive Social Dashboard and click on the X (Twitter) button.

2. You will be prompted to enter the API Key and API secret key from your X(Twitter) app. If you don’t have an app, follow the next steps to find out how to create one.

3. Log in to X(Twitter) Developer. Use the same credentials as for your X(Twitter) account.
4. You will be prompted with some premium plans, but you also have the option to sign up for a free account at the bottom of the page. Click on that link.

5. Add your own use case for the app (there is no right or wrong answer here; it must be at least 250 characters long), toggle all required boxes, and click on the Submit button.

6. Once the app is created, you need to use the default Project or create a new Project. For the Project of your choice, click on the Keys and tokens tab to get your API key and API secret key.

7. Click on the Regenerate button, near the Consumer Keys.

8. Copy the API Key and API Key Secret values and click on the Yes, I saved them button.

9. Now, for the same Project, click on the Settings tab. Under authentication settings, click on the Set up button.

10. For App permissions, choose Read and Write, and for Type of App, choose Web App, Automated App, or Bot.

11. Under App info, add your own site details, by following this exact structure:

Callback/Redirect URL: https://example.com/wp-admin/admin.php?page=TweetOldPost

Website URL: https://example.com

12. Save the Client ID and Client Secret values and click on Done.

13. Go back to the Revive Social dashboard and add your API Key and API Secret Key, from Step 8.

14. Authorize the app in Revive Social.

15. Once the authorization is completed, your X ( Twitter ) should be listed in Revive Social’s dashboard.

🧩 Plugin Tabs

• Accounts - Connect your desired social accounts.
• General Settings - Contains general settings of the plugin, such as the post types to share, categories and tags to exclude, etc.
• Post Format - Contains settings on how exactly posts are shared to your different social accounts, for example with or without hashtags.
• Custom Schedule (PRO) - Used to set a fixed sharing time or custom sharing intervals.
• Manage Queue (PRO) - Allows you to see your upcoming posts to be shared; it's also possible to edit these posts before they get sent out from this tab. Editing the posts in the Manage queue is only possible in PRO.
• Sharing Log - From this tab you could see the status messages from your shares and see if there were any errors during sharing.

⚙️ Plugin Settings Explained

This is the accounts tab; from here, you can attach your social profiles. 

The Revive Social plugin allows you to share posts on the most popular social media platforms. However, there are some limitations regarding the number of  social media accounts available in the free version, so you can have only one Facebook page and one Twitter account. 

4. Configuring the General Settings

As their name suggests, all options from the General Settings tab apply across all connected social media accounts.

Here is a breakdown of them:

• Minimum Interval Between Shares 

This value is set in hours and represents the time interval between which posts are shared using Revive Social.

For example, set the Minimum Interval Between Shares to 4 hours to avoid spamming.

• Minimum Post Age

This value is set in days, and represents the minimum “age” (the time interval since their publish date) of posts which are shared using Revive Social.

For example, set the Minimum Post Age to 30 days so new posts aren't shared immediately.

• Share More Than Once 

Toggle for continuous sharing ( If all available posts have been shared to your active accounts, we will automatically restart the sharing ).

This option can be useful for sites with a large number of posts. By the time Revive Social shares all posts, it’s perfectly fine to share the older ones again without your followers wondering why a post is being shared again.

• Taxonomies

In WordPress, taxonomies are Categories and Tags. Custom taxonomies can also be added using custom code or dedicated plugins.

Under this Taxonomies control, you have the option to select specific categories and/or tags. 

If the Exclude? option is disabled, Revive Social will share posts just from the selected taxonomies.

If the Exclude? option is enabled, Revive Social will share posts from all other taxonomies, other than the selected ones

• Enable Google Analytics Tracking

Check this option to add UTM campaign tags to your shared URLs, so you can monitor traffic from your Google Analytics dashboard.

• Enable Instant Sharing Feature (Post on Publish)

When the Enable Instant Sharing Feature (Post on Publish) is enabled, a new Revive Social icon will be available for all posts, at the top of the post editor.

Once clicked on, you will find options for Instant Share and Manual Share.

a) Instant Sharing

Select the social network where you want to share the post, and click on the Share Now button.

b) Manual Sharing

Just click on one of the icons, and a new page will open where you can manually share the current post.

• Enable Instant Sharing By Default

When the Enable Instant Sharing Feature (Post on Publish) option presented before is enabled, a new Enable Instant Sharing By Default option becomes available.

When Enable Instant Sharing By Default is enabled, the social networks are already selected by default, in the Instant Sharing section. But this happens just for newly created posts. For already existing posts, this won’t apply.

• Housekeeping

When this option is enabled, all saved settings will be deleted when the Revive Social plugin is deleted.

• Contributing

If this option is enabled, you agree to send anonymous data to help us understand how you use the Revive Social plugin. More details can be found here.

Post Format

Some of these options bring up new options when selected, and some of these are self-explanatory so we will go through those which might not be so obvious.

These changes are saved per social profile, so if you have more than one social profile be sure to adjust their settings accordingly by selecting the one you want to edit from the left:

As you can see from above, there are two profiles, LinkedIn and Twitter; selePost Title

1. Post Content
2. Post Title and Content
3. Custom Field

If you select " Custom Field" from the Post Content Area, then you would enter the name of the custom field you would like to fetch content from in this textbox; this procedure would apply to all other custom field options.

• Maximum Chars - Enter the maximum length of the share. It is important to note that this value could go above 140 for networks that support it such as Facebook or LinkedIn but for Twitter, the max is 140 characters, including the link.
• Additional Text - Use this textbox to add additional text to your share; the text in this box always takes precedence, so if you set the max length to 10, your post content is "Title Only", and your additional text is "testing", the plugin will make sure that your additional text is displayed even though it means cutting off characters from the title.
• Use URL Shortener - Revive Social could automatically shorten your URLs on the fly while sharing. Use this option if you have a long domain name and long post names and are sharing to networks such as Twitter.

Custom Schedule

There are two types of scheduling available:

• Recurring

Just like before you could set these settings per social profile, so you could have Twitter sharing every 2 hours and LinkedIn every 8 hours.

• Fixed

You could choose to share every certain number of hours (every 2 hours, every 2 1/2 hours (2.5) etc.) or you could create a custom schedule.

In the above image, we have chosen to post from this profile (the one selected on the left) every day of the week at 09:30 AM and at 02:05 AM. You could add as many post times as you wish; please keep in mind that these posts may not always fire at the exact time you set but will be accurate by a few minutes more or less.

Sharing Queue

The post queue lets you see the upcoming posts to be shared and their content and images; if you select to share them with featured images, click the pencil icon to edit the post or the trash icon to remove it from the queue.

Logs

The log shows the status of previously shared posts. Use it to monitor whether your posts are being posted or not.

🛠 Basic Troubleshooting

Some basic troubleshooting steps for Revive Social are as follows:

1. Try disabling all plugins on your website then check if the issue you are experiencing still occurs. If it doesn't then start enabling each plugin again one by one to filter out the one which causes the problem.

2. If posts are not being posted to certain profiles then try creating a new profile and then connect it to Revive Social and try sharing it. Also, try sharing a sample post to see if that post goes through.

3. Disconnect the social profile and reconnect it, in the case of Facebook, LinkedIn, etc. Try creating a new Application and setting it up again as before.

🎥 Video - Connecting Social Accounts to Revive Social

If your problem still exists, submit a support ticket at: https://revive.social/support/. Be sure to let us know if you've tried all these steps while submitting your ticket to help us deduce possible issues quickly.