Shit Fan плагин для WordPress

Shit Fan плагин — Инструкция по использованию.

Плагин добавляет на страницу интерактивный виджет с крутящимся вентилятором. При нажатии на кнопку коричневые пятна разлетаются по всему экрану и постепенно исчезают. Чем чаще жать — тем быстрее крутится вентилятор и дальше летят пятна.

---

1. Установка плагина

Способ 1 — через админку WordPress (рекомендуется)

1. Войдите в административную панель WordPress.
2. Перейдите в раздел Плагины → Добавить новый → Загрузить плагин.
3. Нажмите кнопку «Выберите файл» и укажите файл shit-fan.zip.
4. Нажмите «Установить».
5. После установки нажмите «Активировать плагин».

Способ 2 — через FTP/SFTP

1. Распакуйте архив shit-fan.zip на своём компьютере.
2. Загрузите папку shit-fan/ на сервер в директорию:
   /wp-content/plugins/shit-fan/
3. В административной панели WordPress перейдите в Плагины, найдите Shit Fan и нажмите «Активировать».

---

2. Добавление виджета на страницу

После активации плагина используйте шорткод:

[shit_fan]

Шорткод можно вставить в любое место страницы или записи.

Редактор Gutenberg (блочный редактор)

1. Откройте нужную страницу или запись для редактирования.
2. Нажмите кнопку «+» для добавления нового блока.
3. В поиске введите «Шорткод» и выберите блок Шорткод.
4. В поле блока введите

   [shit_fan]

5. Нажмите «Обновить» или «Опубликовать».

Классический редактор

1. Откройте нужную страницу или запись.
2. Переключитесь на вкладку «Текст».
3. Вставьте

   [shit_fan]

   в нужном месте.

4. Нажмите «Обновить» или «Опубликовать».

---

3. Описание интерфейса виджета

Вентилятор

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

Индикатор скорости

Горизонтальная полоска под вентилятором показывает текущую скорость вращения. Цвет плавно меняется от синего (медленно) до красного (максимальная скорость).

Кнопка «💩 НАКИДАТЬ!»

Главная кнопка виджета. При каждом нажатии:

• от вентилятора во все стороны разлетаются коричневые пятна по всему экрану;
• вентилятор ускоряется;
• воспроизводится звуковой эффект;
• счётчик бросков увеличивается на 1.

Кнопка «🧹 Сброс»

Мгновенно убирает все пятна с экрана, обнуляет счётчик и сбрасывает скорость вентилятора до базовой.

Счётчик бросков

Отображает общее количество нажатий кнопки с момента последнего сброса.

---

4. Поведение пятен

Пятна появляются в центре вентилятора и разлетаются в случайных направлениях по всей площади экрана. Каждое пятно:

• имеет случайный размер, форму и оттенок коричневого;
• летит тем дальше, чем выше скорость вентилятора;
• остаётся на экране от 2 до 4 секунд;
• плавно исчезает и удаляется автоматически.

Пятна отображаются поверх всего содержимого страницы, включая меню, сайдбары и другие элементы.

---

5. Звуковой эффект

При каждом нажатии кнопки воспроизводится звук шлепка, сгенерированный через Web Audio API. Никаких внешних аудиофайлов плагин не использует.

Важно для iOS и Safari: браузер на устройствах Apple разрешает воспроизведение звука только после первого прикосновения пользователя к экрану. Это стандартное ограничение браузера, не связанное с плагином. Звук заработает с первого или второго нажатия.

---

6. Переводы

Плагин поддерживает стандартную систему переводов WordPress (i18n). В комплекте уже включён:

• Русский — язык по умолчанию
• Английский (en_US) — готовый перевод включён в папку languages/

WordPress автоматически выбирает нужный перевод в зависимости от языка сайта, настроенного в Настройки → Общие → Язык сайта. Никаких дополнительных действий не требуется.

Как добавить перевод на другой язык

1. Установите программу Poedit (бесплатно).
2. В Poedit откройте файл languages/shit-fan.pot через меню Файл → Создать из POT/PO-файла.
3. Выберите язык перевода.
4. Переведите все строки интерфейса.
5. Сохраните файл с именем вида shit-fan-de_DE.po в папку languages/ плагина. Poedit автоматически создаст рядом файл .mo.

Коды локалей: en_US — английский, de_DE — немецкий, fr_FR — французский, es_ES — испанский, pl_PL — польский.

---

7. Ограничения

• На одной странице поддерживается только один экземпляр виджета.
• Пятна отображаются поверх всего экрана — это нормальное поведение. Кнопка «Сброс» мгновенно их убирает.
• Плагин не сохраняет никаких данных в базе данных и не использует куки.

---

8. Деактивация и удаление

1. Перейдите в Плагины → Установленные.
2. Найдите Shit Fan.
3. Нажмите «Деактивировать» — виджет перестанет отображаться на сайте, но все файлы плагина останутся.
4. Для полного удаления нажмите «Удалить» после деактивации.

После удаления шорткод перестанет работать. Если он остался на страницах, WordPress просто не выведет ничего на его месте.

---

Shit Fan плагин v1.0.0