WordPress.org

Italia

Scarica WordPress
WordPress.org

Plugin Directory

Open Graph

Open Graph

Di Will Norris
Scarica

Descrizione

The Open Graph protocol enables any web page to become a rich object in a social graph. Most notably, this allows for these pages to be used with Facebook’s Share Button and Graph API as well as within Twitter posts.

Il plugin Open Graph inserisce i metadati Open Graph negli articoli e nelle pagine di WordPress e fornisce un semplice meccanismo di estensione per altri plugin e temi per sovrascrivere questi dati, o per fornire ulteriori dati Open Graph.

This plugin does not directly add social plugins like the Facebook Share Button to your pages (though they’re pretty simple to add). It will however make your pages look great when shared using those kinds of tools.

FAQ

Come faccio a configurare il plugin Open Graph?

Non lo fai; non c’è nulla da configurare e non c’è una pagina di amministrazione. Per impostazione predefinita userà qualsiasi dato standard di WordPress per popolare i dati di Open Graph. Ci sono dei filtri molto semplici ma potenti che puoi usare per modificare o estendere i metadati restituiti dal plugin, descritti di seguito.

Come faccio ad estendere il plugin Open Graph?

There are two main ways to provide Open Graph metadata from your plugin or theme. First, you can implement the filter for a specific property. These filters are of the form opengraph_{name} where {name} is the unqualified Open Graph property name. For example, if you have a plugin that defines a custom post type named “movie”, you could override the Open Graph type property for those posts using a function like:

function my_og_type( $type ) {
    if ( get_post_type() == "movie" ) {
        $type = "movie";
    }
    return $type;
}
add_filter( 'opengraph_type', 'my_og_type' );

This will work for all of the core Open Graph properties. However, if you want to add a custom property, such as fb:admins, then you would need to hook into the opengraph_metadata filter. This filter is passed an associative array, whose keys are the qualified Open Graph property names. For example:

function my_og_metadata( $metadata ) {
    $metadata['fb:admins'] = '12345,67890';
    return $metadata;
}
add_filter( 'opengraph_metadata', 'my_og_metadata' );

Nota che potresti aver bisogno di definire il prefisso RDFa per le tue proprietà. Usa il filtro opengraph_prefixes.

How does the plugin choose the images?

The plugin uses the featured image first, then the images in the post content, then the images attached to the post. If there is no image at all, it uses the site icon, the custom logo or the header image.

By default the plugin adds up to 3 images. You can change that by adding the following line to your wp-config.php

define( 'OPENGRAPH_MAX_IMAGES', 1 );

or with the opengraph_max_images filter. To add or remove image sources, use the opengraph_image_sources filter. Each source is a callable that gets the post ID and returns attachment IDs:

function my_og_image_sources( $sources ) {
    // Only use the featured image.
    return array( 'opengraph_thumbnail_image_ids' );
}
add_filter( 'opengraph_image_sources', 'my_og_image_sources' );

Does it work with Jetpack?

Yes. Jetpack also adds Open Graph metadata, so the plugin disables the Jetpack output to avoid duplicate tags. To get the Jetpack output back, deactivate this plugin.

Come abitare/disabilitare la “modalità rigorosa”

The plugin populates the meta ‘name’ attribute alongside the ‘property’ attribute by default. Because both, the og:* and twitter:* names, are actually registered at https://wiki.whatwg.org/wiki/MetaExtensions, this stays compliant with the HTML5 spec. If you want to use a more strict way anyways, you can enable the strict mode by adding the following line to your wp-config.php

define( 'OPENGRAPH_STRICT_MODE', true );

Recensioni

Works amazing!!

26 Luglio 2021
Wow thank you for making this plugin!!! I was so stressed about thumbnails errors but now I don't need to worry about it! Thanks!

worked on my website when others wouldn’t

29 Giugno 2021
Great plug-in! I just installed it last night and now the og:image (large image preview) is looking correct on my posts when shared to Facebook. I normally don't leave reviews but noticed this plug-in had very few. It worked like a charm on my website to show the big preview when others (including some well known ones) wouldn't. I was getting frustrated and wasting time googling plug-ins that didn't work on my site for some reason. Finally this one worked! It does what it says, and is very simple to use, no configuration needed.
Leggi tutte le recensioni di 13

Contributi e sviluppo

“Open Graph” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.

Collaboratori

Traduci “Open Graph” nella tua lingua.

Ti interessa lo sviluppo?

Esplora il codice segui il repository SVN, segui il log delle modifiche tramite RSS.

Changelog

Project maintained on github at pfefferle/wordpress-opengraph.

3.0.1 (Sep 25, 2026)

  • fixed a fatal error on ClassicPress, which does not ship the HTML API (#50)

3.0.0 (Sep 18, 2026)

  • simpler image handling: one pass over the post content, catches gallery, media & text and nested block images
  • new opengraph_image_sources filter to add or remove image sources
  • the property filters get the metadata collected so far as second argument
  • twitter card is summary_large_image whenever the post has an image, summary for the fallback images
  • use the current page of a multipage post and the <!--more--> teaser for the description (#9)
  • fixed merging into an existing prefix attribute
  • fixed a fatal error with The Events Calendar (#39)
  • breaking: removed opengraph_block_image, opengraph_parsed_image, opengraph_attached_image, opengraph_ensure_max_image and opengraph_site_supports_blocks (and its filter), use the opengraph_image_sources filter instead
  • minimum WordPress version is now 6.2
  • added phpunit tests

2.0.2 (Feb 25, 2025)

  • Add a constant to easily change the max number of images to be included in the OpenGraph meta tags.

2.0.1 (Dec 16, 2024)

  • Fixed a warning
  • Improved opengraph_max_images handling

2.0.0 (Dec 01, 2024)

  • complete rewrite of image handling
  • added support for block images
  • added parsing of HTML <img> tags
  • improved WordPress Coding Standards compliance

1.12.2 (Nov 17, 2024)

  • optimized readme and updated dependencies

1.12.1 (Jul 15, 2024)

  • fix fediverse account normalization

1.12.0 (Jul 3, 2024)

  • support <meta name="fediverse:creator" />

1.11.3 (Jun 4, 2024)

  • don’t return description for password protected posts

1.11.2 (Nov 13, 2023)

  • stript tags from title, site-name and description

1.11.1 (Apr 03, 2023)

  • fixed a typo

1.11.0 (Oct 21, 2021)

  • fixed attachment issue
  • fixed PHP 7.4 issue

1.10.0 (Apr 20, 2020)

  • basic video support
  • basic audio support

1.9.0 (Mai 14, 2019)

  • show only featured image if available
  • prefer header images over site-icon
  • use avatar for profile pages
  • fallback to description if title is empty
  • better twitter card handling

1.8.3 (Jan 27, 2019)

  • added escaping for the missing attributes

1.8.2 (Nov 21, 2018)

1.8.1 (Nov 19, 2016)

  • change og:image to use the full size of image (props @torenord)

1.8.0 (Jan 29, 2016)

  • fixed article:author property
  • added article:modified_time
  • added first category as article:section

1.7.0 (Jan 18, 2016)

  • added “strict mode” setting
  • better twitter:card handling
  • basic twitter:creator support
  • WordPress coding standard

1.6 (Dec 30, 2014)

  • implemented get_the_archive_title and get_the_archive_description (new in WordPress 4.1)
  • basic twitter cards support (thanks to elroyjetson)
  • replace $post->post_title with get_the_title() (see #17 for details)

1.5.1 (Nov 13, 2012)

  • fix duplicate opengraph markup when used with jetpack plugin (for real)

1.5 (Nov 13, 2012)

  • include descriptions on tag and category pages
  • include profile metadata on author pages
  • fix bug with 404 pages include extra og:image values
  • general code cleanup (including removal of dependency on global vars)
  • fix duplicate opengraph markup when used with jetpack plugin

1.4 (Aug 24, 2012)

  • better default description
  • include all images that are attached to a post, so that users can choose
    which to use when sharing the page. If the post has a post thumbnail, that
    is still used as the primary image.

1.3 (May 21, 2012)

  • add ‘opengraph_prefixes’ filter for defining additional prefixes
  • add new basic properties, and remove some old ones. This is a breaking
    change for anyone that was using the old properties, but they can always be
    added using the ‘opengraph_metadata’ filter. (see f476552 for details)
  • updates to many default values, particularly for individual posts and pages
    (thanks pfefferle)
  • add basic support for array values (see d987eb7)

1.2 (Feb 21, 2012)

  • switch to newer RDFa prefix syntax rather than XML namespaces (props
    pfefferle)

1.1 (Nov 7, 2011)

  • fix function undefined error when theme doesn’t support post thumbnails

1.0 (Apr 24, 2010)

  • initial public release

Plugin della Community

Questo plugin è sviluppato e supportato dalla Community. Contribuisci a questo plugin

Meta

Valutazioni

4.3 su 5 stelle.

La tua recensione

Vedi tutte le recensioni

Supporto

Problemi risolti negli ultimi due mesi:

0 su 1

Chiedi nel forum di supporto