Проект «MaSha»

Введение

В этой статье речь пойдет об утилите под «русским» названии MaSha, которая на самом деле скрывает за собой аббревиатуру. Информации о нем не так много в Интернете, в основном идет ссылка на официальный сайт, либо просто информация о том, что проект создан для сайта президента РФ. Итак, процитирую определение из официального источника.

MASHA (сокращение от Mark & Share) – утилита, позволяющая отметить интересные вам фрагменты текста на странице и получить уникальный url с размеченными фрагментами. Таким образом, любой желающий может, выделив в тексте нужные части (параграфы, предложения или слова), поделиться с кем-либо сгенерированной уникальной ссылкой. При переходе по такой ссылке пользователь попадет на страницу с исходным текстом и восстановленной маркировкой.

Наверное, многие уже слышали про эту утилиту, но не каждому удалось ею воспользоваться по тем или иным причинам. Сразу оговорюсь, что я новичок в области web-программирования, но тем не менее мои подсказки могут помочь другим. На официальном сайте MaSha есть ссылка на плагин для WordPress. Но, к сожалению, установив ее по инструкции мне не удалось получить результата на CMS WordPress 3.6.1. Далее решил изучить как она интегрирована на других сайтах, но утилита не работала. Оказалось, ответ был настолько близок, что я его не видел. На официальном сайте была ссылка на сервис github, где естественно была свежая версия скрипта, а также демонстрационные файлы. Итак, головоломка была решена.

Подключаем «Машу»

Перед продолжением удалите установленный плагин MaSha, во избежание конфликта. Рассмотрим вариант со всплывающей подсказкой, где можно поделиться выделенной ссылкой с друзьями в социальных сетях, а также просто скопировать ее. Для того, чтобы скрипт заработал отредактируем файлы header.php и footer.php через панель управления WordPress.
Шаг 1. Заливаете файлы из каталога «src» (скрипты, изображения и файл стилей) в директорию на вашем сервере.
Шаг 2. «Внешний вид» -> «Редактор» -> выбираете файл «header.php». Перед закрывающимся тегом </head> вставляете следующий код и нажимаете кнопку «Обновить»:
Не забудьте исправить относительные пути на ваши!!!

Шаг 3. «Внешний вид» -> «Редактор» -> выбираете файл «footer.php». Перед закрывающимся тегом </body> вставляете следующий код и нажимаете кнопку «Обновить»:
Не забудьте исправить относительные пути на ваши!!!

Заключение

Вот и все. Еще раз напомню — только не забудьте исправить относительные пути в файлах, в том числе и «masha.css» Эта инструкция годится не только для WordPress, таким образом можно устанавливать на любой сайт, тем более лицензия идет на скрипты «как есть».

ЛИЦЕНЗИЯ

MASHA распространяется по лицензии MIT (группа лицензий для свободного программного обеспечения). Данная лицензия позволяет безвозмездно использовать, изменять, распространять утилиту почти без ограничений.

Единственное, это надо будет заменить участок кода в файле «header.php»:

на следующий:

Если где-то допустил ошибку или есть хорошие предложения, пожалуйста, отпишитесь в комментариях.

UPD 15.01.2014:
Внимание! Обнаружена уязвимость в «Masha». Код исправления приведен на GitHub’е по ссылке https://github.com/SmartTeleMax/MaSha/issues/41. В тексте на текущей странице код уже изменен, т.е. можете не беспокоиться по этому поводу.

Строчка:

заменена на:
Выражаю благодарность Harut за оперативное оповещение!

С уважением, KingComp.

[show_yamoney]
[Всего голосов: 1    Средний: 5/5]
Ильдар Хайрисламов

Ильдар Хайрисламов

Если что-то не получается сделать из описания статьи или требуется помощь специалиста, пишите мне, вместе разберемся. Мои услуги: IDOBI.PRO