.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../Includes.txt


.. _users-manual:

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.