# Dokumentacja przycisku udostępniania

## Przegląd

Dokumentacja ta jest przeznaczona dla programistów, którzy chcą kontrolować sposób wyświetlania zawartości ich strony www w postach na Tumblrze utworzonych przy użyciu przycisku udostępniania zainstalowanego na ich stronie.

Aby zdobyć przyciski na swoją stronę, stwórz je za pomocą generatora przycisków udostępniania.

## Przycisk podstawowy

Na stronach zawierających JavaScript (poniżej) naszego przycisku udostępniania przycisk jest po prostu tagiem kotwicy o klasie `tumblr-share-button:`
    
    
    <a class="tumblr-share-button" href="https://www.tumblr.com/share"></a>  
    <script id="tumblr-js" async src="https://assets.tumblr.com/share-button.js"></script>

Uwaga: Jeśli masz na stronie wiele przycisków udostępniania, to wystarczy dodać JavaScript tylko raz, najlepiej przed tagiem zamykającym `</body>`

### **Domyślne ustawienia zawartości posta**

Przycisk tworzy domyślnie posty ze zdjęciem lub posty z linkiem, w zależności od znalezionych na stronie meta tagów Open Graph, lecz może zostać skonfigurowany do tworzenia dowolnego rodzaju postów (zobacz poniższe instrukcje). Oto opcje domyślne:

  * **Post ze zdjęciem.** Przycisk udostępniania utworzy post ze zdjęciem, jeśli znajdzie tag `og:image` dla obrazu o szerokości co najmniej 500px i proporcjach mniejszych niż 3:1. Do podpisu zdjęcia zostanie użyta treść tagu `og:description`.
  * **Post ze zdjęciem.** Przycisk udostępniania utworzy post z linkiem, jeśli nie znajdzie odpowiedniego obrazu do posta ze zdjęciem. W tytule zostanie użyty tag `og:title`, w opisie `og:description`, a kanoniczny adres URL zostanie użyty jako adres URL w poście.



## Konfiguracja zawartości posta

Jeśli chcesz, by przycisk udostępniania tworzył konkretny typ postów, możesz to zrobić za pomocą następujących opcji. Opcje te mogą zostać skonfigurowane jako atrybuty danych w tagu kotwicy przycisku lub jako parametr będący ciągiem zapytania w adresie URL w atrybucie przycisku `href`.

Opcja| Opis| Atrybut danych| Ciąg zapytania/parametr  
---|---|---|---  
Typ posta| Typ posta na Tumblrze. Prawidłowe opcje to: ext, photo, link, quote, chat lub video| `data-posttype`| `posttype`  
Tagi| Przedzielona przecinkami lista tagów| `data-tags`| `tags`  
Tytuł| Używany w postach tekstowych, postach z linkiem i dialogach| `data-title`| `title`  
Zawartość| Zawartość posta będzie zależała od typu tworzonego posta. W poście ze zdjęciem będzie to adres URL zdjęcia. W poście z cytatem będzie to sam cytat.  
  
Aby uzyskać szczegóły, przejrzyj informacje dla poszczególnych typów posta.| `data-content`| `content`  
Podpis| Używany w postach ze zdjęciem, z linkiem, wideo i z cytatem.| `data-caption`| `caption`  
Pokaż źródło| Wybór załączenia źródła w treści posta poprzedzonego wyrażeniem "via "| `data-show-via`| `show-via`  
  
## Zawartość postów różnego typu

**Tekstowy**   
data-title: Tytuł posta tekstowego   
data-content: Treść posta tekstowego

**Zdjęcie**   
data-content: Adres URL pojedynczego zdjęcia lub przedzielona przecinkami lista adresów URL zdjęć w zestawie zdjęć.   
data-caption: Podpis do posta ze zdjęciem.

**Cytat**   
data-content: Cytat.   
data-caption: Źródło cytatu (autor i przytoczenie).

**Link**   
data-title: Tytuł posta z linkiem.   
data-content: Docelowy adres URL linka.   
data-caption: Opis linka.

**Dialog**   
data-title: Tytuł posta z dialogiem.   
data-content: Treść dialogu (co powiedziały osoby).

**Wideo**   
data-content: Adres URL klipu wideo lub kod do osadzenia.   
data-caption: Podpis do posta wideo.

## Konfiguracja stylu przycisku

Poniższe atrybuty danych w tagu kotwicy przycisku pozwolą skonfigurować jego styl:

Opcja| Możliwe wartości| Domyślne  
---|---|---  
data-color| niebieski   
czarny   
biały| niebieski  
data-notes| u góry   
po prawej   
bez| bez  
  
## Kanoniczny adres URL

Aby licznik notek był wyświetlany i poprawnie aktualizowany, należy podać kanoniczny adres URL strony www. Przycisk udostępniania będzie szukał go w następujących miejscach i w tej kolejności:

Priorytet| Źródło danych  
---|---  
1| `data-href` atrybut w tagu kotwicy przycisku  
2| Element w linku kanonicznym  
3| `og:url` element meta  
4| Adres URL strony  
  
Jeśli tworzysz swój własny przycisk (zobacz poniżej), to oprócz dowolnej zawartości posta należy podać w ciągu zapytania kanoniczny adres URL. Na przykład:
    
    
    http://tumblr.com/widgets/share/tool?canonicalUrl=http://cats.com

## Tworzenie własnego przycisku

Jeśli chcesz całkowicie zmienić wygląd przycisku tak, aby pasował do projektu strony internetowej, to możesz utworzyć swój własny przycisk od podstaw. Skonfiguruj przycisk do otwierania wyskakującego okienka z tym adresem URL `https://www.tumblr.com/widgets/share/tool` i wprowadź informacje o zawartości posta w formie parametrów będących ciągiem zapytań, jak to opisano powyżej. Narzędzie udostępniania dostosuje swój rozmiar do zawartości posta, lecz zalecamy otwieranie okna o rozmiarze 540x600 pikseli.

## Licznik notek

W swoim własnym przycisku możesz nawet uwzględnić licznik notek. Przekaż adres URL swojej strony do punktu końcowego w naszym API statystyk udostępniania i pobierz liczbę notek w następujący sposób:
    
    
    http://api.tumblr.com/v2/share/stats?url=https://www.tumblr.com/buttons

Upewnij się, że otrzymywana przez Ciebie odpowiedź jest przechowywana w pamięci podręcznej i odświeżona dopiero po 10 minutach. Tumblr przechowuje w pamięci podręcznej liczbę notek dla udostępnianych adresów URL przez 10 minut.

## Język przycisku

Używając atrybutu `data-locale` w tagu kotwicy przycisku możesz zlokalizować swój przycisk. Tumblr obsługuje następujące języki:

Język| Wartość regionalna  
---|---  
angielski| en_US  
niemiecki| de_DE  
francuski| fr_FR  
włoski| it_IT  
japoński| ja_JP  
turecki| tr_TR  
hiszpański| es_ES  
rosyjski| ru_RU  
polski| pl_PL  
portugalski| pt_PT  
portugalski| pt_BR  
holenderski| nl_NL  
koreański| ko_KR  
chiński (uproszczony)| zh_CN  
chiński (tradycyjny)| zh_TW