DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Users manual

The plugin takes all img ressources in page and media configured on page and add them in og:image meta in head. The plugin checks if the user agent is a facebook or LinkedIn bot to add this tags, so you'll never see them in content pages. You'll have to use facebook debugger to see the result :

http://developers.facebook.com/tools/debug

LinkedIn has currently no debugger.

Customization

You can change or disable the page field used (media by default) to insert more pictures : plugin.tx_facebookogtags_pi1.data_page_field >

You can manually add images in typoscript like this :

images.1 = IMG_RESOURCE
        images.1.file = fileadmin/user_upload/file.jpg
        images.2 = IMG_RESOURCE
        images.2.file {
                import = uploads/my_directory/
                import.data = page:my_field
                import.listNum = 0
        }
}

FAQ

  • I've just installed the plugin and can't see opengraph tags in the source code of the website.

Tags are only added when facebook comes. So only facebook will see these tags. You can see what facebook see with their debugger :

http://developers.facebook.com/tools/debug

  • I try to like/recommend a page on facebook but there's still no picture detected.

Facebook puts each url in cache. So if the page was crawled before the plugin is installed, facebook won't come back. To solve the problem, you “just” have to pass the url to facebook debugger so it will force to re-download the page and so flush his cache :

http://developers.facebook.com/tools/debug

  • I try to share a page on LinkedInbut there's still no picture detected.

Like facebook does, LinkedIn store each url in cache. So if the page was crawled before the plugin is installed, LinkedIn won't come back. There's currently no debugger which allow you to clear LinkedIn cache.