Extension:YaShareForWiki/ru

From MediaWiki.org
Jump to navigation Jump to search
Справка по расширениям MediaWiki
OOjs UI icon advanced.svg
YaShare for Wiki
Статус релиза: стабильный
Реализация Tag
Описание Позволяет вставлять кнопки социальных сетей.
Автор(ы) (SimonLitttalk)
Последняя версия 0.3.1 (2013-08-29)
MediaWiki 1.15.0+
Лицензия GPL
Загрузка Ссылка для скачивания
Журнал изменений
Параметры
$wgYaShare4WikiSidebar,
$wgYaShare4WikiServices,
$wgYaShare4WikiCntStType,
$wgYaShare4WikiBarStType,
$wgYaShare4WikiI10n,
$wgYaShare4WikiCntTheme,
$wgYaShare4WikiBarTheme,
$wgYaShare4WikiCntBorder,
$wgYaShare4WikiBarBorder
Тэги
<ys4w>
Использованные hook'и
ParserFirstCallInit
BeforePageDisplay
ParserAfterTidy
SkinTemplateOutputPageBeforeExec
Переведите расширение YaShareForWiki если оно доступно на translatewiki.net
Проверьте использование и версию.

Template:Extension/archived

Что делает это дополнение?[edit]

Позволяет вставлять кнопки социальных сетей. Это дополнение основано на Yandex Share API.

Установка[edit]

Загрузите последнюю версию и распакуйте её в папку extension. Затем добавьте следующую строку в файл LocalSettings.php (ближе к концу):

  • Разрешите использование дополнения добавлением следующей строки в файл LocalSettings.php:
    require_once('extensions/YaShare4Wiki/YaShare4Wiki.php');
    

Конфигурация[edit]

Существуют различные настройки для этого расширения, вы можете поместить их в ваш LocalSettings.php файл. Однако, дополнение будет работать даже без настроек.

Добавление кнопок на боковую панель[edit]

$wgYaShare4WikiSidebar
добавление кнопок на боковую панель. По умолчанию: false.

Если не задано, то кнопки на боковую панель не добавляются(по умолчанию). Эта возможность работает только со скинами основанными на SkinTemplate, такими как Modern, Monobook, Chick, Simple, и MySkin, но не Standard, Nostalgia или CologneBlue.

$wgYaShare4WikiSidebar = true;
#Integrating the share box in the sidebar

Вид блока вызова всплывающего меню[edit]

$wgYaShare4WikiCntStType
вид обычного блока вызова всплывающего меню. По умолчанию YAS4W_ST_BUTTON.

Вы можете использовать следующие стили блока:

кнопка
(константа настройки YAS4W_ST_BUTTON);
ссылка
(константа настройки YAS4W_ST_LINK);
значок без текста
(константа настройки YAS4W_ST_ICON);
без всплывающего меню
(константа настройки YAS4W_ST_NONE).
$wgYaShare4WikiCntStType = YAS4W_ST_NONE;
$wgYaShare4WikiBarStType
вид блока вызова всплывающего меню отображаемого на боковой панели. По умолчанию YAS4W_ST_LINK.

Вы можете использовать следующие стили блока:

кнопка
(константа настройки YAS4W_ST_BUTTON);
ссылка
(константа настройки YAS4W_ST_LINK);
значок без текста
(константа настройки YAS4W_ST_ICON).
$wgYaShare4WikiBarStType = YAS4W_ST_BUTTON;

Язык интерфейса[edit]

$wgYaShare4WikiI10n
язык интерфейса. По умолчанию: null.

Возможные значения:

az
азербайджанский;
be
белорусский;
en
английский;
hy
армянский;
ka
грузинский;
kk
казахский;
ro
румынский;
ru
русский;
tr
турецкий;
tt
татарский;
uk
украинский.

Если настройка не задана, то определяется автоматически на основании доменной зоны сайта, при этом по умолчанию используется русский язык.

$wgYaShare4WikiI10n = 'en';

Выбор темы оформления[edit]

$wgYaShare4WikiCntTheme
тема оформления обычного блока на странице. По умолчанию: YAS4W_THEME_DEFAULT.
$wgYaShare4WikiBarTheme
тема оформления блока отображаемого на боковой панели. По умолчанию: YAS4W_THEME_DEFAULT.

Вы можете использовать следующие темы оформления:

блок в темных тонах
(константа настройки YAS4W_THEME_DARK). Внимание: поддерживается ограниченное число сервисов, подробнее на странице документации http://api.yandex.ru/share/doc/dg/concepts/share-button-ov.xml;
кнопки со счетчиками
(константа настройки YAS4W_THEME_COUNTER). Внимание: отсутствует поддержка всплывающих окон и поддерживается ограниченное число сервисов, подробнее на странице документации http://api.yandex.ru/share/doc/dg/concepts/share-button-ov.xml;
блок в обычном виде
(константа настройки YAS4W_THEME_DEFAULT).
$wgYaShare4WikiCntTheme = 'YAS4W_THEME_COUNTER';
$wgYaShare4WikiBarTheme = 'YAS4W_THEME_DARK';

Рамка вокруг блока[edit]

$wgYaShare4WikiCntBorder
отображение рамки вокруг обычного блока. По умолчанию: false.
$wgYaShare4WikiBarBorder
отображение рамки вокруг блока отображаемого на боковой панели. По умолчанию: false.
$wgYaShare4WikiCntBorder = true;
$wgYaShare4WikiBarBorder = true;

Если включен режим отображения границ($wgYaShare4WikiCntBorder или $wgYaShare4WikiBarBorder), то с помощью вертикальной черты можно визуально отделить значки сервисов друг от друга:

$wgYaShare4WikiServices =array(
    'facebook'=>array('at-quick'=> true),
    '|',   
    'vkontakte' =>array('at-popup'=> true),
    '|', 
    'odnoklassniki'=>array('at-popup'=> true, 'at-quick'=> true),
    '|', 
    'myspace',
);

Поддерживаемые сервисы[edit]

$wgYaShare4WikiServices
список, определяющий поддерживаемые сервисы.

Ключём являются имена сервисов. Значение может быть или массивом настроек или быть вообще не заданным.

Сервисы по умолчанию(чтобы получить тот же результат ни какой настройки не требуется):

$wgYaShare4WikiServices =array(
	'vkontakte',
	'facebook',
	'odnoklassniki',
	'lj',
	'gplus',
	'twitter',
	'liveinternet',
	'moikrug',
	'moimir',
	'yaru',
	'myspace',
	'tutby',
	'blogger',
	'juick',
	'friendfeed',
	'linkedin',
	'digg',
	'evernote',
	'yazakladki',
	'delicious',
	'diary',
	'surfingbird',
);

При этом все поддерживаемые сервисы отобразятся и в виде кнопок и будут находиться во всплывающем меню.

Настройка ссылок:

$wgYaShare4WikiServices['vkontakte']['at-popup'] = true;
$wgYaShare4WikiServices['facebook']['at-quick']= true;
$wgYaShare4WikiServices['odnoklassniki']['at-popup'] = false;
$wgYaShare4WikiServices['odnoklassniki']['at-quick']= false;

После такой настройки в виде кнопок будут отображены все поддерживаемые сервисы кроме кнопок ВКонтакте(ключ vkontakte) и Однокласников(ключ odnoklassniki), а во всплывающем меню — все поддерживаемые кроме кнопок Facebook(ключ facebook) и Однокласников(ключ odnoklassniki).

Переопределение сервисов и их порядка:

$wgYaShare4WikiServices =array(
    'facebook'=>array('at-quick'=> true),    
    'vkontakte' =>array('at-popup'=> true),
    'odnoklassniki'=>array('at-popup'=> true, 'at-quick'=> true),
    'myspace',
);

После такой настройки в виде кнопок будут отображены только кнопки Facebook(ключ facebook), Однокласников(ключ odnoklassniki) и Myspace(ключ myspace), а во всплывающем меню — только ВКонтакте(ключ vkontakte), Однокласников(ключ odnoklassniki) и Myspace(ключ myspace).

Использование[edit]

Пользовательский тег называется <ys4w>. Например, если вы поместите <ys4w /> на вики-странице, он отобразит кнопки социальных сетей.

Cинтаксис:

<ys4w />

или

<ys4w></ys4w>

Смотри также[edit]

Другие языки: English  • русский