OG

Opis

Protokół Open Graph umożliwia dowolnej stronie internetowej na uzupełnienie informacji, które są potem wykorzystywane przez media społecznościowe. Przede wszystkim pozwala to na używanie tych stron za pomocą przycisku Like i Graph API.

Wtyczka Open Graph wstawia metadane Open Graph do sekcji head strony i zapewnia filtry dla innych wtyczek i motywów, aby zmienić te dane lub dostarczyć dodatkowe dane Open Graph.

Brak konfiguracji, czysta moc.

Wtyczka pobiera dane z treści wpisu i jeżeli zawiera adres URL filmu YouTube, to próbuje użyć obrazka podglądu filmu dla tagu og:image.

Jeżeli wpis zawiera linki do filmów na YouTube lub Vimeo, wtyczka spróbuje zapisać meta dane wideo i dodać miniaturkę filmu jako og:images.

Bogata implementacja filtrów w celu łatwej zmiany danych.

Instalacja

Masz do wyboru trzy metody instalacji:

Bardzo łatwo

  1. Zaloguj się do panelu administratora swojego WordPressa.
  2. Przejdź do Wtyczki > Dodaj nową.
  3. Wpisz ‘OG’ w pole wyszukiwania wtyczek i naciśnij klawisz enter. Po znalezieniu można zapoznać się ze szczegółami takimi jak wydania, oceny oraz opis.
  4. Kliknij Zainstaluj. Po kliknięciu pojawi się pytanie, czy na pewno chcesz zainstalować tę wtyczkę.
  5. Kliknij Tak, a WordPress dokończy instalację.
  6. Aktywuj wtyczkę.
  7. To wszystko. Wtyczka nie ma żadnej konfiguracji.

Łatwa

  1. Pobierz wtyczkę (plik zip) z prawej kolumny na tej stronie.
  2. W panelu administratora idź do menu Wtyczki > Dodaj nową
  3. Wybierz przycisk Wyślij wtyczkę na serwer
  4. Wyślij właśnie pobranego zipa.
  5. Włącz wtyczkę
  6. To wszystko. Wtyczka nie ma żadnej konfiguracji.

Stary i niezawodny (FTP)

  1. Załaduj katalog OG do katalogu /wp-content/plugins/
  2. Aktywuj wtyczkę w WordPressie w menu ‚Wtyczki”
  3. To wszystko. Wtyczka nie ma żadnej konfiguracji.

FAQ

Jak skonfigurować wtyczkę Open Graph?

Nie musisz! Nie ma nic do konfigurowania i nie ma strony administratora. Domyślnie będzie używała wszelkich standardowych danych WordPressa, aby wypełnić dane Open Graph. Istnieją bardzo proste, ale potężne filtry, których możesz użyć do modyfikowania lub rozszerzania metadanych zwracanych przez wtyczkę. Więcej informacji poniżej.

Co wtyczka dodaje dla wszystkich typów treści?

  • og:locale – kod językowy
  • og:site_name – tytuł witryny
  • og:title – tytuł aktualnie wyświetlanej treści
  • og:url – stały odnośnik do wyświetlanej treści
  • og:type – „article” dla pojedynczej treści oraz „website” dla wszystkich pozsotałych
  • og:description – opis witryny
  • og:site_name – nazwa witryny

Co wtyczka dodaje dla pojedynczego wpisu?

  • og:image: z określonego własnego pola wpisu/strony lub jeśli nie jest ustawiony na podstawie obrazka wyróżniającego lub jeśli nie istnieje pierwszy obrazek w treści w treści postu lub nie zawiera dołączonego obrazka w galerii i jeśli nie istnieje w domyślny obrazek. Zostanie użyty ten sam wybrany ten sam obrazek, który jest wyświetlany dla kanalu RSS.
  • og:video – dodaje linki do filmów YouTube.
  • article:author – autor wpisu
  • article:published_time – data publikacji wpisu
  • article:modified_time – data ostatniej modyfikacji wpisu
  • article:tag – tagi użyte we wpisie
  • twitter:card – podsumowanie
  • twitter:title – to samo co og:title
  • twitter:description – to samo co og:description
  • twitter:image – to samo co og:image
  • twitter:player – to samo co og:video

Co wtyczka dodaje dla produktu WooCommerce?

  • og:price:amount – cena
  • og:price:currency – waluta ceny
  • og:availability – status magazynu

Zainstalowano OG i … nic się nie dzieje!

Proszę o cierpliwość, czasami aby zobaczyć wynik działania potrzeba więcej niż jednego dnia. Przyczyną takiego stanu jest cache Facebooka. Sprawdź też swoje wtyczki i jeżeli używasz wtyczek do cache, postaraj się go wyczyścić.

Możesz zmusić FB do odświeżenia danych OpenGraph na stronie: https://developers.facebook.com/tools/debug/sharing/. Użyj „Sharing Debuggera”, wprowadź adres URL naciśnij klawisz „Scrap Again”.

Jak filtrować wartości?

Użyj automatycznych filtrów, jeżeli masz takie wartości:

<meta property="og:title" content="WordPress Trunk" />

Automatyczne filtry tworzone są w ten sposób:

og_ + (słowo przed „:”) + _ + (słowo po „:”) + _value

W tym przypadku:

og_og_title_value

add_filter('og_og_title_value', 'my_og_og_title_value');
function my_og_og_title_value($title)
{
    if ( is_home() ) {
        return __('This is extra home title!', 'translate-domain');
    }
    return $title;
}

Jak filtrować cały meta tag?

Użyj automatycznych filtrów, jeżeli masz takie wartości:

<meta property="og:title" content="WordPress Trunk" />

Automatyczne filtry tworzone są w ten sposób:

og_ + (słowo przed „:”) + _ + (słowo po „:”) + _meta

W tym przypadku:

og_og_title_meta

add_filter('og_og_title_meta', 'my_og_og_title_meta');
function my_og_og_title_meta($title)
{
    if ( is_home() ) {
        return '<meta property="og:title" content="WordPress Title" />';
    }
    return $title;
}

Jak ustawić domyślny obrazek?

Użyj filtra „og_image_init”:

add_filter('og_image_init', 'my_og_image_init');
function my_og_image_init($images)
{
    if ( is_front_page() || is_home() ) {
        $images[] = 'http://wordpress/wp-content/uploads/2014/11/DSCN0570.jpg';
    }
    return $images;
}

Jak ustawić obrazek dla strony głównej?

Użyj filtra „og_image_init”:

add_filter('og_og_image_value', 'my_og_og_image_value');
function my_og_og_image_value($images)
{
    if ( empty($images) ) {
        $images[] = 'http://wordpress/wp-content/uploads/2014/11/DSCN0570.jpg';
    }
    return $images;
}

Jak dodać Facebook app_id?

Wtyczka OG jest super prosta i nie planujemy dodawać żadnej „strony opcji”, która byłaby potrzebna jeśli chcesz mieć dane takie jak „fb:app_id” lub „fb:pages”.

Ale jeśli naprawdę chcesz używać OG i wyświetlać tagi „FB” Open Graph, należy użyć filtru og_array, aby dodać (lub zmodyfikować) tagi OpenGraph.

add_filter( 'og_array', 'add_og_facebook_data' );
function add_og_facebook_data( $og ) {
    $og['fb'] = array(
        'app_id' => 'my-app-id',
        'pages' => 'foo, bar',
    );
    return $og;
}

Jak wyłączyć adres URL autora (article:author)?

Użyj filtra „og_article_author_value”, w celu zwrócenia pustej
wartości klucza „article:author”:

add_filter( 'og_article_author_value', '__return_empty_string' );

Recenzje

2 sierpnia 2020
It works, kind of. But it picks the Headlines and Images that I didn't want and there is no way to change it. If you're into sharing content on FB, you need fine controls.
31 lipca 2020
I create and share images on social media platforms. They work best when submitted with Open Graph settings. After installation and activation of the OG Plugin there was an immediately noticeable improvement over other solutions I had tried. This plugin is both a time saver and an efficiency gainer.
31 lipca 2020
Very simple and useful. The support is clear and easy to understand. Saves work, because it generates thumbnails of videos automatically. Perhaps, in the plugin page, there could be more availability of small lines of code to disable certain functions from functions.php file, such disabling the automatic thumbnails function of videos or hide the author url in meta tags for example.
Przeczytaj 114 recenzji

Kontrybutorzy i deweloperzy

„OG” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.

Zaangażowani

Wtyczka “OG” została przetłumaczona na 2 języki. Podziękuj tłumaczom za ich wkład.

Przetłumacz wtyczkę “OG” na swój język.

Interesuje cię rozwój wtyczki?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Log zmian

2.8.5 (2020-06-20)

  • Poprawiono drobne błędu w tagu og:type.

2.8.4 (2020-06-20)

  • Dodano tag Pinterestu og:see_also tag jeżeli wpis posiada powiązane uzyskane za pomocą wtyczki YARPP.
  • Poprawiono wartość tagu og:image:alt, od teraz najpierw sprawdzany jest ALT.
  • Ulepszono tag og:audio tag na stronie załącznika typu klip dzwiękowy.
  • Ulepszono tag og:video tag na stronie załącznika typu film.
  • Ulepszono użycie z wtyczka Sierotki.

2.8.3 (2020-06-03)

  • Poprawiono problem złego parametru w zapytaniu do bazy danych.

2.8.2 (2020-06-03)

  • Dodano wsparcie dla fimów Vimeo dla tagów og:image i og:video.
  • Ulepszono zapis obrazków z YouTube’a, teraz używany jest SSL.
  • Usunięto sumowanie tablic, co było nie kompatybilne ze starszymi wersjami PHP.

2.8.1 (2020-06-03)

  • Jeżeli to jest możliwe, to dodaje wymiary miniaturki filmu YouTube.
  • Dodano filtr og_twitter_creator w celu łatwego ustawiania Twitter @username autora wpisu.
  • Dodaje wielokrotne tagi og:image dla wszystkich użytych filmów YouTube.
  • Usuwa własne pole z wpisu, jeżeli wpis przestanie zawierać filmy YouTube.
  • Używa SSL dla obrazków YouTube’a jeżeli witryna używa SSL.

2.8.0 (2020-06-03)

  • Usunięto sprawdzanie dopuszczonych ustawień regionalnych dla Facebooka.
  • Poprawiono problem z Twitter summary_large_image.
  • Dodano filtr og_twitter_site w celu łatwego ustawiania Twitter @username właściciela witryny.

2.7.9 (2020-06-02)

  • Ulepszono budowanie klucza cache, teraz zawiera również wersję wtyczki, żeby uniknąć starszych danych.

2.7.8 (2020-06-02)

  • Poprawiono problem występujący dla wpisów bez obrazka wyróżniającego, ale za to z wieloma obrazkami w treści. Podziękowania dla anthonykung

2.7.7 (2020-06-01)

  • Dodano og:image:secure_url dla obrazków po https. Podziękowania dla mociofiletto
  • Ulepszono tagi OpenGraph na stronie załącznika.
  • Dla wpisów bez obrazka wyróżniającego zbiera kolekcję wszystkich z treści.

2.7.6 (2019-08-18)

  • Dodano filtr og_profile aby umożliwić zmiany wartości profile values. Podziękowania dla edmorrow

2.7.5 (2019-05-15)

  • Dla obrazka wyróżniającego dodano brakującą właściwość og:image:alt.

2.7.4 (2019-04-25)

  • Poprawiono problem z og:image dla fdokumentów z obrazkiem wyróżniającym oraz obrazkami w treści. Podziękowania dla sudoranger

2.7.3 (2019-04-23)

  • Dodano „summary_large_image” dla tagu „twitter:card” dla obrazków większych niż 520px. Podziękowania dla Bobby Eberle.

2.7.2 (2019-04-13)

  • Poprawiono problem z użyciem funkcji sprintf(). Podziękowania dla John Glynn

2.7.1 (2019-04-13)

  • Dodano do klucza cache kod języka. Podziękowania dla Oleksandr Omelchenko.
  • Dodano zapamiętywanie kodu języka w obiekcie klasy.

2.7.0 (2018-10-21)

  • Dodano prawidłowy og:url dla archiwum własnych typów treści.Podziękowania dla cabaltc.
  • Dodano prawidłowy og:url dla archiwum dnia, miesiąca oraz roku.
  • Dodano prawidłowy og:url dla wyników wyszukiwania.
  • Dodano prawidłowy og:url dla archiwum taksonomii.
  • Usunięto tagi OpenGraph ze strony 404.

2.6.2 (2018-10-11)

  • Poprawiono og:url dla strony z wpisami. Podziękowania dla cabaltc.

2.6.1 (2018-09-06)

  • Dodano esc_url dla źródła obrazków.
  • Usuwanie tagów HTML z tagów OG.

2.6.0 (2018-06-04)

  • Dodano listę dołączonych plików audio do tagu og:audio.
  • Dodano listę dołączonych filmów do tagu og:video.
  • Dodano tag og:update_time.
  • Dodano pamięć podręczną dla pojedynczych wpisów w celu zmniejszenia liczny zapytań do bazy danych.
  • Zaktualizowano listę ustawień regionalnych Facebooka.

2.5.3 (2018-05-09)

  • Usunięto funkcje debugujące, które psuły całą wtyczkę.

2.5.2 (2018-05-08)

  • Dodano filtr og_description_words który umożliwia zmianę długości treści tagu og:description.
  • Poprawiono błąd obcinania ostatniego wyrazu. Podziękowania dla intrex.
  • Wracamy do przycinania długości tagu og:description do 55 słów (domyślna wartość funkcji wp_trim_words()).

2.5.1 (2018-04-16)

  • Dodano og:image:width i og:image:height dla obrazka z treści o ile pochodzi on z naszej witryny.

2.5.0 (2018-04-14)

  • Dodano og:image:width i og:image:height dla obrazka wyróżniającego.

2.4.9 (2018-02-27)

  • Usunięto użycie filtra „the_content” w celu uniknięcia niekompatybilności z innymi wtyczkami.

2.4.8 (2018-02-19)

  • Jeżeli nie ustawiono obrazka wyróżniającego to pierwszy obrazek treści będzie dodany do og:image. Podziękowania dla andreyenkin.

2.4.7 (2017-09-26)

  • Dodano filtr „og_[og_name]_value”, który umożliwia zmianę wartości tagu.
  • Dodano og:type dla formatów „audio” oraz „video”.
  • Poprawiono og:type dla produktu WooCommerce. Podziękowania dla shaharsol.

2.4.6 (2017-09-13)

  • Usunięto limit z pola og:description.

2.4.5 (2017-06-13)

  • Dodano filtr „og_array”, który umożliwia zmianę wszystkich tagów przed ich wyświetleniem.

2.4.4 (2017-05-20)

  • Poprawiono błąd integracji z wtyczką WooCommerce. Podziękowania dla JLY.

2.4.3 (2017-05-09)

  • Zaktualizowano moduł „Rate” do wersji 1.0.1 – poprawiono błędny adres URL dla witryn z innym językiem niż angielski

2.4.2 (2017-05-03)

  • Dodano tagi „og:video” i „twitter:player” dla wpisów z osadzonym filmem z YouTube.
  • Dodano integrację z WooCommerce, tagi: „og:price:amount”, „og:price:currency” i „og:availability”.
  • Ulepszono tag opisu dla pustej treści zostanie użyty tytuł jako opis.

2.4.1 (2016-10-26)

  • Naprawiono problem dotyczący stron i innej pojedynczej treści. W tej chwili OG działa dla wpisów wszystkich typów treści.
  • Dodano prośbę o ocenę na stronie wtyczek.
  • Krótki opis dla twittera

2.4 (2016-04-10)

  • Poprawiono problem z przygotowaniem do lokalizacji.
  • Poprawiono pobieranie obrazka dla filmu z YouTube.
  • Wdrożono standard kodowania używany w WordPressie do wszystkich plików PHP wtyczki.

2.3 (2016-02-03)

  • Dodano kategorie jako og:section.
  • Dodano esc_attr do tagów w sekcji head.
  • Dodano msapplication-TileImage.
  • Dodano og:site_name.
  • Dodano pola profile:first_name, profile:last_name, profile:username. Podziękowania dla Arka Bibliotekarza.
  • Dodano tagi.
  • Dodano tagi twittera
  • Dodano użycie ikony witryny, jeżeli nie ma ikony – wszystkie przypadki.

2.2 (2015-08-19)

  • ULEPSZENIE: dodano ikonę witryny jako og:image dla strony głównej.

2.1 (2015-05-21)

  • ULEPSZENIE: dodano sprawdzanie czy ustawienia regionalne są obsługiwane przez Facebooka.

2.0 (2014-12-11)

  • ULEPSZENIE: dodano sprawdzanie czy CPT ma pole treści.
  • ULEPSZENIE: dodana odnośnik og:author
  • ULEPSZENIE: duża refaktoryzacja
  • Dodano filtry, zajrzy do sekcji FAQ

1.0 (2014-10-02)

Wersja początkowa.