Плагин «Универсальный калькулятор процентов» для расчётов| SMIRNOVCODE.RU

Percent Calculator добавляет на страницу WordPress интерактивный калькулятор процентных расчётов с девятью режимами: от простого % от числа до сложных процентов и НДС. Вывод выполняется через шорткод, поэтому блок можно разместить в записи, странице или шаблоне с поддержкой шорткодов. Плагин содержит страницу настроек в разделе Настройки, где управляются контентные блоки под калькулятором (описание, инструкция, научное обоснование, FAQ, дисклаймер), а также цветовой пресет оформления. Это позволяет настраивать вывод без редактирования исходного кода. Для версии на продакшене реализована ручная проверка обновлений с сервера разработчика: плагин кэширует ответ, показывает бейдж доступной версии на странице плагинов и предоставляет ссылку «Проверить обновления».

Универсальный калькулятор процентов

Версия: 0.0.2

Обновлено: 2026-04-22

Требует WP: 6.0

Требует PHP: 8.0

Автор: Влад Смирнов

Распространяется: Бесплатно

Публичная оферта от «01» января 2026 г.

Скачать

Бесплатно

0.0.2
0.0.1

Девять режимов расчёта — отдельные вкладки для % от числа, обратного расчёта, соотношения, изменения, НДС и сложных процентов.
Шорткодный вывод — поддержка шорткодов [percent-calculator] и [mortgage-calculator] для встраивания на страницы.
Управление блоками контента — включение/скрытие description, instructions, scientific, faq, disclaimer через настройки и атрибуты шорткода.
Редактируемый FAQ — добавление, удаление, сортировка и восстановление списка вопросов/ответов из админки.
Цветовые пресеты — выбор схемы в настройках и автоматическая публикация CSS-переменных на фронтенде.
Ручная проверка обновлений — запрос JSON с кэшированием и отображение статуса новой версии в списке плагинов.

Параметр	Значение
Шорткод	`[percent-calculator]`, `[mortgage-calculator]`
Атрибуты шорткода	`theme`, `title`, `description`, `instructions`, `scientific`, `faq`, `disclaimer`
Ключ опции в БД	`percent_calculator_settings`
Группа настроек	`percent_calculator_settings_group`
Режимы калькулятора	`% от числа`, `Число по %`, `% соотношение`, `± % к числу`, `Было / Стало`, `% изменение`, `Сложные %`, `Доля`, `НДС`
Санитизация текста	`wp_kses_post()`
Санитизация FAQ-вопроса	`sanitize_text_field()`
Санитизация FAQ-ответа	`wp_kses_post()`
Проверка обновлений	`wp_remote_get()` по URL `https://smirnovcode.ru/updates/percent-calculator-smirnovcode.json`
Период проверки обновлений	`43200` секунд (12 часов), при ошибке сети — 5 минут

1. Установка и активация

Загрузите папку плагина в wp-content/plugins/percent-calculator-smirnovcode.
В админке WordPress откройте Плагины.
Активируйте плагин «Универсальный калькулятор процентов».

2. Настройка плагина

Перейдите в Настройки → Универсальный калькулятор процентов.
Выберите цветовой пресет.
При необходимости включите/отключите блоки Описание, Инструкция, Научное обоснование, FAQ, Дисклаймер.
Измените тексты блоков и сохраните настройки кнопкой «Сохранить настройки».

3. Вывод на странице

Добавьте шорткод в редактор страницы или записи:

[percent-calculator]

Альтернативный алиас:

[mortgage-calculator]

4. Параметры шорткода

theme — визуальная тема калькулятора (gradient или light).
title — заголовок блока калькулятора.
description — показать/скрыть описание (1/0).
instructions — показать/скрыть инструкцию (1/0).
scientific — показать/скрыть научный блок (1/0).
faq — показать/скрыть FAQ (1/0).
disclaimer — показать/скрыть дисклаймер (1/0).

Пример:

[percent-calculator title="Калькулятор для сайта" faq="0" disclaimer="0"]

5. Проверка обновлений

Откройте Плагины в админке.
Найдите плагин «Универсальный калькулятор процентов».
Нажмите ссылку Проверить обновления в строке действий.
Если на сервере доступна новая версия, в строке мета появится бейдж «Доступно обновление» с переходом на страницу плагина.

Версия 0.0.2

Обновлена версия плагина в заголовке и константе PERCENT_CALCULATOR_VERSION.
README приведён к единому стандарту структуры из 4_README_STANDARD.md.
Добавлены обязательные разделы метаданных, таблица характеристик и пошаговая инструкция с подпунктами.
Актуализированы описание шорткодов, атрибутов и механизма проверки обновлений по текущему коду.

Версия 0.0.1

Первый публичный релиз плагина.
Реализованы 9 режимов процентных расчётов.
Добавлены шорткоды [percent-calculator] и [mortgage-calculator].
Реализован механизм ручной проверки обновлений.
Добавлена страница настроек с текстовыми блоками и FAQ.

Страница настроек

Демонстрация

Этот калькулятор процентов помогает быстро решать повседневные задачи: скидки, наценки, НДС, доли, изменение в процентах и сложные проценты. Подходит для личных финансов, бизнеса, обучения и рабочих расчётов.

X% от числа Y. Пример: 13% от 70 000 = 9 100

Число (Y)

Процент (X)

Результат

Найти целое по части и проценту. Пример: 7 отличников = 20% класса → 35 учеников

Часть (число)

Процент

Целое

Сколько % составляет A от B. Пример: 80 от 50 = 160%

Число A

Число B (базис)

Процент

Прибавить или вычесть процент. Пример: 100 + 20% НДС = 120

Число

Процент

Операция

Прибавить Вычесть

Итог

Исходная цена до скидки/наценки. Пример: 850 после скидки 15% → было 1000

Стало (итог)

Процент скидки/наценки

Тип

Скидка (минус) Наценка (плюс)

Было

На сколько % изменилось. Пример: было 30000, стало 35000 → +16.67%

Старое значение

Новое значение

Изменение (%)

Сложные проценты. Пример: 1000 под 10% на 3 года = 1331

Начальная сумма

Процент

Периодов (лет/мес)

Тип

Рост (+) Падение (−)

Итог

Доля: какой % часть от целого. Пример: 200 г от 800 г = 25%

Целое

Часть

Процент

Выделить или начислить НДС. Ставки: 20%, 10%, 0%

Сумма

Ставка НДС (%)

Режим

Выделить НДС Начислить НДС

Сумма без НДС

Сумма НДС

Итого с НДС

Результаты калькулятора носят справочный характер и могут отличаться от итоговых значений в банковских, бухгалтерских и юридических документах. Для важных решений сверяйте расчёты с профильным специалистом.

Как пользоваться калькулятором

Как пользоваться: выберите нужную вкладку расчёта, введите исходные значения в поля и получите результат автоматически. Для задач со скидкой или наценкой используйте режим «Было / Стало», для НДС — вкладку «НДС», а для роста капитала — «Сложные %».

Основные правила расчёта

Основные правила расчёта: процент от числа вычисляется по формуле X% от Y = Y × X / 100. Процентное изменение определяется как (Новое − Старое) / Старое × 100%. При сложных процентах используется модель S = P × (1 ± r)^n, где r — ставка за период, n — число периодов.

Вопросы и ответы

Умножьте число на процент и разделите на 100.

Используйте формулу: (новое − старое) / старое × 100%.

Да, в отдельной вкладке доступны выделение и начисление НДС.

Она считает рост или падение по формуле сложных процентов за выбранное число периодов.