Open Graphite Pro

Control how your WordPress content is viewed when shared on social media.

"The best plugin of its kind"

Matthew Woods Tour Administrator & Web Developer
Perth Observatory

What does Open Graphite Pro do?

Open Graphite Pro lets you control how your WordPress content is viewed when shared on social media.

Typically when one of your pages is shared on social media (Facebook for example), the platform will use the first image and text it can find on the page. This is usually not ideal and often truncates the content into something nonsensical, resulting in the page being less likely to be engaged with.

Open Graphite Pro solves this problem, buy allowing you to customise the image, title and description of each of your pages that is shared on social media, and without compromising the original content.

Can I customise how each page or post is previewed when shared on social media?

Yes. You can either set the option to automatically use the existing title, text (or excerpt) and image, or specify them manually on each page or post in the Open Graphite metabox.

There appears to be duplicate sets of open graph tags.

Any other plug-in that inserts the open graph properties into the code of your website may cause Open Graphite to not work properly. Yoast is a plugin that comes to mind and can be easily fixed.

To test if you have a conflict, simply view the source code of your home page in your browser and search for any instances of og:title within. Typically a plug-in will output the meta tags into it’s own group. For this plug-in, they will be directly below the <!–/ Open Graphite /–> comment but other plug-ins will output something else (if at all).

If you see duplicate sets of the og:title tag, then another plugin (or possible your theme) is also trying to perform open graph duties.

The only solution to resolve a conflict is to disable the other plug-in or theme option (if available), or if you’re using Yoast, change a couple of settings.

How do I disable Yoast's built-in Open Graph support?

To avoid a situation where you have multiple sets of open graph tags, you will need to disable the Yoast Facebook function (SEO -> Social -> Facebook tab) and then disable the Yoast Twitter function (SEO -> Social -> Twitter tab).

Finally, you will need to make sure the organisation name and logo fields are empty (SEO -> Search Appearance -> General tab).

Facebook isn't showing the correct information when I share my page or post.

If you are using the Facebook Access Token feature, this should never happen. But if you want a quick fix, read on.

Facebook (and possibly other social networks) will cache the open graph properties of a post that has previously been shared for up to 24 hours (maybe longer). During this time, any changes you make to your open graph properties will not be picked up by Facebook immediately. But there is an easy fix.

Using the official Facebook Debugger, paste in the URL of your page or post and hit the Debug button. When it has finished, hit the Scrape Again button. This will force Facebook to fetch the latest open graph data from your post. Twitter has a similar tool called the Card Validator for this purpose as well.

Facebook might complain about the lack of an App ID when you pass your URL through their debugger, but this will not prevent anything from working correctly.

Do I need a Facebook App ID?

You probably do not need a Facebook App ID. That said, there may be instances where having one is helpful. Decide for yourself.

If you have a Facebook App, you can get the App ID from your developer dashboard.

If you do want to get a Facebook App ID, visit the Facebook developer page, click on My Apps, click Create App and follow the prompts.

Note: If you plan on using the Facebook Access Token feature (highly recommended) then you will absolutely need a Facebook App ID.

What does the Facebook Access Token do?

A Facebook Access Token allows Open Graphite to make your website to communicate directly with the Facebook API.

This is immensely helpful, as it means that any time you create or update a post, the open graph data is immediately pushed to the Facebook open graph API. In layman’s terms, this means Facebook will immediately show the latest thumbnail, title and text of your post when it is shared (without having to wait the mandatory 24hrs for Facebook to acknowledge the changes).

This also means you never have to bother using the Facebook Debugger again.

Get a Facebook Access Token now.

How to get a permanent Facebook Access Token

Requirements

You will need to have a Facebook App ID, and then generate an Access Token.

Caveats

While generating a Facebook Access Token is relatively easy, they are only valid for an hour. This makes them less than ideal for use in Open Graphite. To get around this limitation, you will need to generate a PermaToken.

A PermaToken, despite what it sounds like, is not really permanent. But it does last three months before you have to generate one again. Unfortunately this time period is mandated by Facebook and there is no way to extend it.

The following steps will help you get your PermaToken. This isn’t as complicated as it looks, as long as you follow these steps.

Step 1: Get a short-lived user access token

  • Create a Facebook App (skip this step if you already have one)
    Launch the Facebook Developer page, click on My Apps -> Create App and follow the instructions to create your app
  • Get your App ID and Secret Key
    Once your app has been created, go to the developer dashboard and make a note of your App ID and App Secret (Settings -> Basic and then click Show next to App Secret)
  • Generate your short-lived user access token
    Go to the Graph Explorer and look in right hand pane. In the Facebook App field select your app, then in the User or Page field select User Token, and finally in the Permissions field click on Event Group Pages and select manage_pages
  • Click the Generate Access Token

Step 2: Generate a PermaToken

  • Go to the FB Token Generator page
  • Enter your App ID, App Secret and the short-lived User Access Token you created earlier
  • Hit the Submit button and your PermaToken will be generated. Keep a copy of it somewhere safe
  • Copy/paste this token into the Facebook Access Token field of the Open Graphite settings page

Step 3: Check the status of your PermaToken 

This step is optional, but recommended to make sure everything worked as expected. To see if your PermaToken is valid:

  • Go to the Graph Explorer
  • Paste your PermaToken into the Access Token field and click the round blue info icon to reveal the Access Token Info window
  • Click the Open in Access Token Tool button

You should see a result something like this:

Note 1: Although it appears to be stable, this feature is beta.

Note 2: You can not enter your PermaToken until you have entered your Facebook App ID.

Note 3: Facebook still imposes an application rate limit. You can keep tabs on it from your developer dashboard.

How do I find the API version of my Facebook app?

Go to your Facebook app dashboard, then:

  • Click on your app
  • In the left pane, click on Settings -> Advanced

You should see your app API version.

You do not need to change the version number here, and you probably shouldn’t just in case you have other services running that rely on a specific API version number.

Debugging for Facebook

On occasion, changes you make to your open graph data might not immediately show when you share the page on social media. This is usually most likely the case with Facebook, which, if your page had already been shared earlier, will cache a ‘snapshot’ of what the open graph data was at the time. Obviously that’s not always ideal.

But Facebook have built a tool specifically to help solve this problem: The Facebook Debugger.

The Facebook Debugger will force Facebook to re-scrape the open graph data of your page right away. Simply enter your URL, hit the ‘scrape again’ button and you should see the correct information immediately with a result something like this:

Facebook Debugger

How the 'Always use the excerpt for the description' option works

By default, WordPress only offers except support for posts. If your website is not using any custom post types, it will not be a problem if you enable the Always use the excerpt for the description option.

But, if your site does rely on public facing custom post types, the Always use the excerpt for the description option will only work if said post types have excerpt support. If they do not, then you should disable this option.

Is there a use case for enabling this option?

Yes. If you already have existing excerpts, then enabling this option will save you from having to go back and manually add Open Graph descriptions to every post.

However, just bear in mind that those excerpts might not necessarily be optimal for sharing on social media (remember, Facebook only shows the first 70 characters of the description). If this is the case, it might be worth reviewing the most important ones.

Is there a way to enable excerpt support for my custom post types that don’t currently have it?

I most cases, yes. The easiest way is with the help of a plugin such as the Custom Post Type UI (free). It will let you easily add excerpt support for any registered custom post types.

Alternatively, your theme may already have a settings interface that lets you enable excerpts for custom post types.

Troubleshooting

If for some reason you are experiencing issues with the open graph meta tag values not being populated, you can try using the troubleshooting options.

The will attempt to change the priority of the open graphite functions so that they are not interfered with by other plugins or themes.

Only use these options if you are the experiencing issues mentioned above.

Is the price of this plugin once only or per year?

That’s up to you.

12 months after initial purchase you will have the option to renew your support license, but you don’t have to.

If you decide not to renew your license after 12 months, your product will continue to work as expected without any restriction, but it simply will not be able to receive updates or be entitled to support.

Is the free version of Open Graphite supported?

The free version of Open Graphite will continue to receive updates when necessary, but only Pro license holders are able to log a priority support ticket. If you are using the free version of Open Graphite, you can request support here.

How to install Open Graphite Pro

Once you have logged in and downloaded open-graphite-pro.zip, there are a couple of ways you can install the plugin.

  1. FTP
    Unzip the open-graphite-pro.zip file you downloaded, then, using an FTP client, upload the open-graphite-pro folder into the wp-content/plugins directory
  1. WordPress upload interface
    Login to WordPress admin, go to Plugins -> Add New and then click the Upload Plugin button. Then browse for the open-graphite-pro.zip file you downloaded and follow the remaining on-screen steps.

Don’t forget to deactivate the free version of Open Graphite if you are currently using it.

How many websites can I use Open Graphite Pro on?

A single site license allows Open Graphite Pro to be used on a single domain, although you can purchase a multiple site license if desired.

How can I move my license key to a different domain?

If you no longer wish to use your license key on your current domain, you can easily deactivate it for use elsewhere.

Simply login to the website where Open Graphite is currently activated, go to Open Graphite -> License and click on the Deactivate button.

Once you have done that, the license key will no longer be associated with the current domain name, and you’ll be able to activate Open Graphite on a different domain.

Open Graph Check tool

If you would like to use the Open Graph Check tool, you will need to get a free API key from opengraph.io. Once you’ve obtained your API key, enter it into the Open Graph Check API key field and save the settings.

The Open Graph Check tool allows you to check the open graph properties of absolutely any webpage, not just your own.

This might be handy for comparing the open graph content of your own page with another, which could help you gain a competitive advantage when sharing on social media.

The Open Graph Check tool is completely optional. If you have no interest in using it, then there’s no need to get an API key from opengraph.io.

Note: At time of writing, the free API key is limited to 100 requests per month. Rocket Apps is not affiliated with opengraph.io and consequently does not receive any commision if you sign up for their non-free plans.

Changelog

v1.9.1 (30th October 2020)

  • Minor presentation fix.

v1.9 (9th June 2019)

  • Added specific options for Pinterest.
  • Help topics now link to external website
  • Removed links to opengraphcheck.com (no longer exists)
  • Admin UI tweaks

v1.8.1 (29th September 2020)

  • Removed activated domains list from license details page.

v1.8 (16th September 2020)

  • Added new open graph web page check feature.

v1.7 (20th August 2020)

  • Added helpers to assist with license renewal.
  • Implemented latest version of update handling scripts.

v1.6 (11th August 2020)

  • Added option to disable quality indicators admin column.
  • Updated Facebook API version selections.

v1.5 (7th May 2020)

  • Fixed bug related to post not having excerpt when ‘Always use the excerpt’ option is enabled.
  • When ‘Always use the excerpt’ option is enabled, only show description field if post type supports excerpts.
  • Show text field or text area depending on character limit setting.
  • Added new troubleshooting option to get post ID with alternative method.
  • Added new WooCommerce options.
  • Output post ID in Open Graphite Start comment.
  • Added attribute to inputs to remove Lastpass icon.
  • Updated preview avatars.
  • Updated translation files.

v1.4.1 (11th April 2020)

  • Bug: Fixed issue that may have prevented Facebook Access Token field from showing under certain condition.

v1.4 (10th April 2020)

  • Added method (beta) to automatically push the open graph data of your post to Facebook as soon as it is created or when it is updated.

v1.3.4 (12th February 2020)

  • Added option to reset all Open Graphite settings.

v1.3.3 (12th February 2020)

  • Improved language and description consistency.
  • Minor UX and UI improvements.

v1.3.2 (20th January 2020)

  • Removed Rocket Apps plugin manager dependency for license activation.

v1.3.1 (16th January 2020)

  • Fixed issue where Jetpack conflict option was not being honoured.

v1.3 (11th October 2019)

  • Fixed issue where Woocommerce shop page was using product open graph data.
  • Removed Woocommerce post types from enabled post types list.

v1.2.9 (27th September 2019)

  • Added option to enable/disable locale.

v1.2.8 (7th September 2019)

  • Text domain function.

v1.2.7 (7th September 2019)

  • Added option to avoid Jetpack conflict.
  • Translation file updates.

v1.2.6 (31st August 2019)

  • Rocket Apps plugin manager support.

v1.2.5 (23rd July 2019)

  • Removed offer.

v1.2.4 (3rd July 2019)

  • Added troubleshooting option to potentially help solve issues with some themes.
  • Fixed issue where titles with quotes would not output.

v1.2.2 (30th June 2019)

  • Added new Force Required setting.

v1.2.1 (29th June 2019)

  • Changed twitter image markup to twitter:image.

v1.2 (26th June 2019)

  • Removed required attribute on object type selector.
  • Added resource links.
  • Moved position in admin nav.
  • Removed redundant query.

v1.1 (19th June 2019)

  • Minor presentation tweaks.

v1.0 (9th June 2019)

  • Initial release.