Extension:OpenGraphMeta

From mediawiki.org
MediaWiki extensions manual
OpenGraphMeta
Release status: beta
Implementation Data extraction, Parser function
Description Provides OpenGraph meta tags providing data for 3rd parties like Facebook to extract
Author(s) Daniel Friesen (Dantmantalk)
Latest version 0.5.6
Compatibility policy Master maintains backward compatibility.
MediaWiki 1.39+
Database changes No
License GNU General Public License 2.0 or later
Download
Quarterly downloads 44 (Ranked 107th)
Public wikis using 5,841 (Ranked 42nd)
Translate the OpenGraphMeta extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The OpenGraphMeta extension provides OpenGraph protocol metadata for articles on the wiki for 3rd parties like Facebook to extract. The primary use for this extension is for any wiki that provides its users a button to "Like" pages on the wiki, especially if the wiki uses a custom default skin. As sometimes Facebook can extract undesirable parts from the page (known on some custom skins to potentially extract random images irrelevant to the content) providing this data gives Facebook clean data to display in likes, and cleans up the long title into a pair of clean site and page titles. A parser function {{#setmainimage:Filename.ext}} which also exports what it is passed so you can use it easily in a [[File:{{#setmainimage:Filename.ext}}|thumb|right|...]] format can be used to set the image in the article which you prefer Facebook to use when displaying information about the page on your wiki (hint: This works very nicely when you incorporate it into an infobox template making the infobox image the preferred image for 3rd parties to use).

This extension can also be paired with Extension:Description2 which extracts description information from articles, when both are installed OpenGraphMeta will make use of the information Description2 extracts.

We need to provide the ability to maximize the amount of information available of the shared content so that it is more descriptive, while still in compliance with our policy.

Installation[edit]

Try the development version, or choose the version that matches your version of MediaWiki if the trunk version breaks.
  • Download and move the extracted OpenGraphMeta folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/OpenGraphMeta
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'OpenGraphMeta' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.


Configuration[edit]

In order to use Facebook Insights you must add the app ID to your page. Insights lets you view analytics for traffic to your site from Facebook. Find the app ID in your App Dashboard.[1]

$egFacebookAppId = 'YOUR_FACEBOOK_APP_ID_HERE'; // Optional
$egFacebookAdmins = 'FACEBOOK_ADMINS'; // Optional

The site name exposed in OpenGraphMeta metadata can be adjusted with the Opengraphmeta-site-name system message, if editing $wgSitename is undesired.

See also[edit]

References[edit]