Описание

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

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

• Минималистичен и елегантен изглед, който се слива с вашата тема (тествано с последните теми по подразбиране на WordPress, а също и с някои други популярни теми).
• Минимално влияние на производителността на сайта – разширението зарежда единствено малък SVG файл, съдържащ иконите, по-малко от 1k CSS и 3.5к некомпресиран JavaScript – повечето за да направи възможно показването на SVG икони в стари браузъри.
• Не шпионира вашите потребители – разширението не зарежда ресурси от трети страни, които да проследяват активността на потребителите в сайта, не задава и не чете бисквитки.
• Sharing through the native share dialog on devices that support it.
• Безпроблемен от гледна точка на 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>

This filter allows changing the classes of the individual buttons. Two parameters are apssed to the filter functions: the array with classes and the social network / button slug.

Credits

• SVG Icons from (Font-Awesome-SVG-PNG)[https://github.com/encharm/Font-Awesome-SVG-PNG], MIT licence
• Banner image by (heinzremyschindler on pixbay)[https://pixabay.com/en/share-play-words-2482016/], (Creative Commons CC0)[https://creativecommons.org/publicdomain/zero/1.0/deed.en]
• Plugin icon based on (work by Nathan Diesel from the Noun Project)[https://thenounproject.com/term/share/107273/], (Creative Commons CC-BY)[http://creativecommons.org/licenses/by/3.0/us/]