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 Like 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.
Questo plugin non aggiunge direttamente plugin social alle tue pagine come Facebook Like Button (anche se sono piuttosto facili da aggiungere). Tuttavia fa sì che l’aspetto delle tue pagine sia ottimo quando vengono condivise usando questo tipo di strumenti.
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?
-
Ci sono due modi principali per fornire metadati Open Graph dal tuo plugin o tema. In primo luogo, puoi implementare il filtro per una specifica proprietà. Questi filtri hanno la forma
opengraph_{name}
dove {name} è il nome non qualificato della proprietà Open Graph. Per esempio, se hai un plugin che definisce un post type personalizzato chiamato “movie”, potresti sovrascrivere la proprietà Open Graph ‘type’ per quei post usando una funzione come:function my_og_type( $type ) { if ( get_post_type() == "movie" ) { $type = "movie"; } return $type; } add_filter( 'opengraph_type', 'my_og_type' );
Questo funzionerà per tutte le proprietà principali di Open Graph. Tuttavia, se vuoi aggiungere una proprietà personalizzata, come ‘fb:admin’, hai bisogno di agganciarti al filtro
opengraph_metadata
. A questo filtro viene passato un array associativo, le cui chiavi sono i nomi qualificati delle proprietà Open Graph. Per esempio:function my_og_metadata( $metadata ) { $metadata['fb:admin'] = '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
. -
Come abitare/disabilitare la “modalità rigorosa”
-
Il plugin popola l’attributo meta ‘name’ insieme all’attributo ‘property’ per impostazione predefinita. Poiché entrambi i nomi,
og:*
etwitter:*
, sono effettivamente registrati su https://wiki.whatwg.org/wiki/MetaExtensions, questo rimane conforme alle specifiche HTML5. Se vuoi usare comunque un modo più rigoroso, puoi abilitare la modalità rigorosa aggiungendo la seguente linea al tuo fileconfig.php
define( 'OPENGRAPH_STRICT_MODE', true );
Recensioni
Contributi e sviluppo
“Open Graph” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.
CollaboratoriTraduci “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.
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)
- fixed PHP warning issue: https://wordpress.org/support/topic/php-warning-count-parameter-must-be-an-array-or-an-object-that-implements-c/
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
andget_the_archive_description
(new in WordPress 4.1) - basic twitter cards support (thanks to elroyjetson)
- replace
$post->post_title
withget_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