Minimal Share Buttons

Описание

Добавете прости бутони за споделяне под вашите публикации или използвайте джаджата за споделяне, за да добавите бутони в някоя от зоните за джаджи във вашия сайт. Разширението използва изчистени SVG икони за логата на социалните мрежи и съвсем малко чист JavaScript, за да позволи на потребителите на сайта да споделят публикацията или страницата. Иконите за споделяне наследяват цветовете на връзките, за да съответстват на дизайна на сайта.

Защо да изберете Minimal Share Buttons пред другите подобни разширения?

• Минималистичен и елегантен изглед, който се слива с вашата тема (тествано с последните теми по подразбиране на WordPress, а също и с някои други популярни теми).
• Минимално влияние на производителността на сайта – разширението зарежда единствено малък SVG файл, съдържащ иконите, по-малко от 1k CSS и 3.5к некомпресиран JavaScript – повечето за да направи възможно показването на SVG икони в стари браузъри.
• Не шпионира вашите потребители – разширението не зарежда ресурси от трети страни, които да проследяват активността на потребителите в сайта, не задава и не чете бисквитки.
• Споделяне чрез основния диалогов прозорец за споделяне на устройства, които го поддържат.
• Безпроблемен от гледна точка на GDPR – тъй като разширението не споделя лични данни с трети страни, за собственика на сайта е по-лесно да осигури спазването на европейската регулация за защита на личните данни.
• Достъпност – връзките за споделяне имат етикети, които се четат от екранните четци и са видими за потребителите, използващи клавиатурата.
• Готов за Gutenberg и WordPress 5.0 – разширението добавя блок, който показва бутони за споделяне, така че авторите могат да ги поставят където искат в съдържанието.

Използване

Има пет начина за показване на бутоните за споделяне в публикация или страница:

1. Накарайте бутоните да се показват под съдържанието на публикацията като отбележите съответната отметка в настройките за показване на разширението.
2. Добавете джаджата за споделяне в страничната лента или друга зона за джаджи.
3. Използвайте блока за Gutenberg за да добавите бутоните където желаете в съдържанието.
4. Използвайте кратък код [msb_share title="Share this"] в класическия редактор.
5. Използвайте функцията msb_display_buttons(), за да покажете бутоните за споделяне в шаблоните на вашата тема.

Разработчици на теми

От версия 1.4 можете по-лесно да покажете джаджата за споделяне в шаблоните на темата чрез функцията msb_display_buttons(). Тя приема два аргумента – масив с параметри, подавани към джаджата, и булев параметър, указващ дали генерирания HTML да се изобрази или да се върне като резултат от функцията. Ето пример:

$args = [
  'before_widget' => '<div class="msb-container">',
  'after_widget'  => '</div>',
  'before_title'  => '<h2>',
  'after_title'   => '</h2>',
  'title'         => __( 'Share this article', 'mytextdomain' ),
];
msb_display_buttons( $args, true );

Ако вашата тема използва SVG икони, комбинирани в спрайт, и има икони за Фейсбук, Туитър, Гугъл Плюс и ЛинкдИн, има два филтъра, чрез които можете да замените иконите, добавени от това разширение, с вашите. Резултатите от двата филтъра се свързват със символа диез (#), и се прекарват през esc_url преди да се изведат в кода на страницата.

Друг филтър позволява промяна на масива със социални мрежи.

msb_sprite_url

Филтърът се прилага върху URL на файла, съдържащ спрайт с иконите и функцията трябва да връща URL (без знака диез (#)) на SVG файл, съдържащ икони в symbol елементи.

msb_icon_name

Филтърът се прилага към идентификатора на иконата преди той да се добави към адреса на SVG файла. Трябва да връща ID на symbol елемент в SVG файла с икони.

msb_socials

Този филтър се прилага към списъкът със социални мрежи и позволява добавянето или премахването на отделни мрежи. Списъкът се съхранява в асоциативен масив, ключът се използва като име на полето в настройките и идентификатор на иконата, а стойността е асоциативен масив с три елемента: field_label (етикет на полето в настройките), button_label (етикет на бутона за споделяне), и share_url (URL за споделяне). Стойността на share_url се прекарва през sprintf с два параметъра – URL на текущата страница и заглавието на страницата. Пример:

function my_add_xing( $socials ){

  $socials['xing'] = array(
    'field_label' => __( 'Xing', 'mytheme' ),
    'button_label' => __( 'Share on Xing', 'mytheme' ),
    'share_url' => 'https://www.xing.com/spi/shares/new?url=%1$s&title=%2$s'
  );

  return $socials;

}
add_filter( 'msb_socials', 'my_add_xing' );<h3>msb_button_classes</h3>

Този филтър позволява промяна на класовете на отделните бутони. Към функциите на филтъра се подават два параметъра: масивът с класове и социалната мрежа/слъг на бутона.

Благодарности

• SVG икони от FontAwesome, Creative Commons CC BY 4.0, MIT лиценз
• Изображение на банера от heinzremyschindler в pixbay, Creative Commons CC0
• Иконата на плъгина е базирана на работа на Нейтън Дизел от Noun Project, Creative Commons CC-BY